ImageData
说明:
当前为Beta阶段。
ImageData对象可以存储canvas渲染的像素数据。
说明:
创建ImageData时,宽高不超过16384px,最大面积不超过16000px*16000px,超过最大面积则无法正常绘制。
导入模块
import kit.ArkUI.*
class ImageData
public class ImageData {
public init(width: ?Float64, height: ?Float64, data!: ?Array<UInt8>, unit!: ?LengthMetricsUnit = None)
public init(width: ?Float64, height: ?Float64, unit!: ?LengthMetricsUnit = None)
}
功能: ImageData对象可以存储canvas渲染的像素数据。
系统能力: SystemCapability.ArkUI.ArkUI.Full
起始版本: 22
prop width
public prop width: Int32
功能: 矩形区域宽度,默认单位为vp。
类型: Int32
读写能力: 只读
系统能力: SystemCapability.ArkUI.ArkUI.Full
起始版本: 22
prop height
public prop height: Int32
功能: 矩形区域高度,默认单位为vp。
类型: Int32
读写能力: 只读
系统能力: SystemCapability.ArkUI.ArkUI.Full
起始版本: 22
prop data
public prop data: Array<UInt8>
功能: 一维数组,保存了相应的颜色数据,数据值范围为0到255。
类型: Array<UInt8>
读写能力: 只读
系统能力: SystemCapability.ArkUI.ArkUI.Full
起始版本: 22
init(?Float64, ?Float64, ?Array<UInt8>, ?LengthMetricsUnit)
public init(width: ?Float64, height: ?Float64, data!: ?Array<UInt8>,
unit!: ?LengthMetricsUnit = None)
功能: 构造一个ImageData类型的对象。
系统能力: SystemCapability.ArkUI.ArkUI.Full
起始版本: 22
参数:
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| width | ?Float64 | 是 | - | 矩形区域宽度,默认单位为vp。 |
| height | ?Float64 | 是 | - | 矩形区域高度,默认单位为vp。 |
| data | ?Array<UInt8> | 是 | - | 命名参数。 一维数组,保存了相应的颜色数据,数据值范围为0到255。 |
| unit | ?LengthMetricsUnit | 否 | None | 命名参数。 用来配置ImageData对象的单位模式,配置后无法动态更改,配置方法同CanvasRenderingContext2D。 |
说明:
- width和height不能小于0.0,否则会有非预期的结果。
- data的长度必须等于4.0 * width * height,否则会有非预期的结果。
init(?Float64, ?Float64, ?LengthMetricsUnit)
public init(width: ?Float64, height: ?Float64, unit!: ?LengthMetricsUnit = None)
功能: 构造一个ImageData类型的对象。
系统能力: SystemCapability.ArkUI.ArkUI.Full
起始版本: 22
参数:
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| width | ?Float64 | 是 | - | 矩形区域宽度,默认单位为vp。 |
| height | ?Float64 | 是 | - | 矩形区域高度,默认单位为vp。 |
| unit | ?LengthMetricsUnit | 否 | None | 命名参数。 用来配置ImageData对象的单位模式,配置后无法动态更改,配置方法同CanvasRenderingContext2D。 |
说明:
width和height不能小于0.0,否则会有非预期的结果。