• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Class (SamplingOptions)
2
3<!--Kit: ArkGraphics 2D-->
4<!--Subsystem: Graphics-->
5<!--Owner: @hangmengxin-->
6<!--Designer: @wangyanglan-->
7<!--Tester: @nobuggers-->
8<!--Adviser: @ge-yafang-->
9
10> **说明：**
11>
12> - 本模块首批接口从API version 11开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
13>
14> - 本Class首批接口从API version 12开始支持。
15>
16> - 本模块使用屏幕物理像素单位px。
17>
18> - 本模块为单线程模型策略，需要调用方自行管理线程安全和上下文状态的切换。
19
20采样选项对象。
21
22## 导入模块
23
24```ts
25import { drawing } from '@kit.ArkGraphics2D';
26```
27
28## constructor<sup>12+</sup>
29
30constructor()
31
32构造一个新的采样选项对象，[FilterMode](arkts-apis-graphics-drawing-e.md#filtermode12)的默认值为FILTER_MODE_NEAREST。
33
34**系统能力：** SystemCapability.Graphics.Drawing
35
36**示例：**
37
38```ts
39import { RenderNode } from '@kit.ArkUI';
40import { common2D, drawing } from '@kit.ArkGraphics2D';
41
42class DrawingRenderNode extends RenderNode {
43  draw(context : DrawContext) {
44    const canvas = context.canvas;
45    const pen = new drawing.Pen();
46    let samplingOptions = new drawing.SamplingOptions();
47  }
48}
49```
50
51## constructor<sup>12+</sup>
52
53constructor(filterMode: FilterMode)
54
55构造一个新的采样选项对象。
56
57**系统能力：** SystemCapability.Graphics.Drawing
58
59**参数：**
60
61| 参数名     | 类型                   | 必填 | 说明                                 |
62| ---------- | --------------------- | ---- | ----------------------------------- |
63| filterMode | [FilterMode](arkts-apis-graphics-drawing-e.md#filtermode12)    | 是   | 过滤模式。                    |
64
65**错误码：**
66
67以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。
68
69| 错误码ID | 错误信息 |
70| ------- | --------------------------------------------|
71| 401 | Parameter error.Possible causes:1.Mandatory parameters are left unspecified;2.Incorrect parameter types. |
72
73**示例：**
74
75```ts
76import { RenderNode } from '@kit.ArkUI';
77import { common2D, drawing } from '@kit.ArkGraphics2D';
78
79class DrawingRenderNode extends RenderNode {
80  draw(context : DrawContext) {
81    const canvas = context.canvas;
82    let samplingOptions = new drawing.SamplingOptions(drawing.FilterMode.FILTER_MODE_NEAREST);
83  }
84}
85```