Image

constructor

• new Image(): Image

  创建没有像素的空图像。

  返回值

  Image

  源码与继承
• new Image(source: Image): Image

  深复制图像的 RGBA 像素。

  参数

  source

  Image

  返回值

  Image

  源码与继承
• new Image(
      size: Readonly<Vector2u>,
      colorOrPixels?: Uint8Array | ReadonlyValue<Color>,
  ): Image

  创建指定像素尺寸的图像；使用颜色填充或复制 RGBA8 字节，默认黑色。

  参数

  size

  Readonly<Vector2u>

  colorOrPixels可选

  Uint8Array | ReadonlyValue<Color>

  返回值

  Image

  源码与继承

pixels

• get pixels(): Uint8Array

  可写扩展；调整尺寸或加载后，旧视图仍保留旧图像。

  返回值

  Uint8Array

  源码与继承

copy

• copy(
      source: Image,
      dest: Readonly<Vector2u>,
      sourceRect?: ReadonlyValue<IntRect>,
      applyAlpha?: boolean,
  ): boolean

  复制 sourceRect（默认整个源图）到 dest；applyAlpha 启用透明度混合，返回是否成功。

  参数

  source

  Image

  dest

  Readonly<Vector2u>

  sourceRect可选

  ReadonlyValue<IntRect>

  applyAlpha

  boolean = false

  返回值

  boolean

  源码与继承

createMaskFromColor

• createMaskFromColor(color: ReadonlyValue<Color>, alpha?: number): void

  将与 color 完全匹配的像素透明度设为 alpha（默认 0），保留 RGB。

  参数

  color

  ReadonlyValue<Color>

  alpha

  number = 0

  返回值

  void

  源码与继承

flipHorizontally

• flipHorizontally(): void

  原地左右翻转像素。

  返回值

  void

  源码与继承

flipVertically

• flipVertically(): void

  原地上下翻转像素。

  返回值

  void

  源码与继承

getPixel

• getPixel(coords: Readonly<Vector2u>): Color

  返回指定像素的颜色副本；坐标越界抛出 RangeError。

  参数

  coords

  Readonly<Vector2u>

  返回值

  Color

  源码与继承

getPixelsPtr

• getPixelsPtr(): | undefined
  | Readonly<
      Pick<
          Uint8Array,
          | number
          | typeof iterator
          | "length"
          | "slice"
          | "entries"
          | "keys"
          | "values"
          | "byteLength"
          | "byteOffset",
      >,
  >

  空图像没有像素指针。只读约束由 TypeScript 保证。

  返回值

  
      | undefined
      | Readonly<
          Pick<
              Uint8Array,
              | number
              | typeof iterator
              | "length"
              | "slice"
              | "entries"
              | "keys"
              | "values"
              | "byteLength"
              | "byteOffset",
          >,
      >

  源码与继承

getSize

• getSize(): Vector2u

  返回图像像素宽度和高度的副本。

  返回值

  Vector2u

  源码与继承

loadFromFile

• loadFromFile(filename: string): Promise<boolean>

  异步读取并解码图像文件，成功后替换像素存储，返回是否成功。

  参数

  filename

  string

  返回值

  Promise<boolean>

  源码与继承

loadFromMemory

• loadFromMemory(data: Uint8Array): Promise<boolean>

  异步解码 PNG/JPEG 等编码图像字节，返回是否成功。

  参数

  data

  Uint8Array

  返回值

  Promise<boolean>

  源码与继承

loadFromStream

• loadFromStream(stream: InputStream): Promise<boolean>

  从可寻址输入流异步解码图像；流异常会拒绝 Promise。

  参数

  stream

  InputStream

  返回值

  Promise<boolean>

  源码与继承

resize

• resize(
      size: Readonly<Vector2u>,
      colorOrPixels?: Uint8Array | ReadonlyValue<Color>,
  ): void

  重建像素存储并填充颜色或复制 RGBA8 数据；之前的 pixels 视图保留旧存储。

  参数

  size

  Readonly<Vector2u>

  colorOrPixels

  Uint8Array | ReadonlyValue<Color> = Color.Black

  返回值

  void

  源码与继承

saveToFile

• saveToFile(filename: string): Promise<boolean>

  按文件扩展名异步编码并保存图像，返回是否成功。

  参数

  filename

  string

  返回值

  Promise<boolean>

  源码与继承

saveToMemory

• saveToMemory(format: string): Promise<undefined | Uint8Array>

  异步编码为 format（如 png）指定的格式，返回字节；编码失败返回 undefined。

  参数

  format

  string

  返回值

  Promise<undefined | Uint8Array>

  源码与继承

setPixel

• setPixel(coords: Readonly<Vector2u>, color: ReadonlyValue<Color>): void

  复制颜色到指定像素；坐标越界抛出 RangeError。

  参数

  coords

  Readonly<Vector2u>

  color

  ReadonlyValue<Color>

  返回值

  void

  源码与继承

只读[graphicsNative]