Class Texture

constructor

• new Texture(): Texture

  创建未分配像素的空纹理。

  Returns Texture
• new Texture(size: Readonly<Vector2u>, sRgb?: boolean): Texture

  分配指定像素尺寸的 GPU 纹理；sRgb 默认 false。

  Parameters

  • size: Readonly<Vector2u>
  • OptionalsRgb: boolean

  Returns Texture
• new Texture(source: Readonly): Texture

  深复制纹理像素和配置。

  Parameters

  • source: Readonly

  Returns Texture
• new Texture(
      image: Image,
      sRgb?: boolean,
      area?: ReadonlyValue<IntRect>,
  ): Texture

  从图像像素区域创建纹理，省略 area 时使用整张图像；失败抛出 SFMLError。

  Parameters

  • image: Image
  • OptionalsRgb: boolean
  • Optionalarea: ReadonlyValue<IntRect>

  Returns Texture

Readonly[graphicsNative]

Readonly[textureId]

Optional Readonly[textureOwner]

assign

• assign(source: Readonly): this

  同步深复制 source 到当前纹理，保留当前包装对象身份并返回 this。

  Parameters

  • source: Readonly

  Returns this

copyToImage

• copyToImage(): Image

  Synchronous GPU readback into an independent, native-owned Image.

  Returns Image

generateMipmap

• generateMipmap(): boolean

  生成缩小采样用的 mipmap 层级，返回是否成功；更新像素后需要重新生成。

  Returns boolean

getNativeHandle

• getNativeHandle(): number

  返回 OpenGL 纹理标识，空纹理为 0；使用期间需保留纹理对象。

  Returns number

getSize

• getSize(): Vector2u

  返回纹理像素宽高的副本。

  Returns Vector2u

isRepeated

• isRepeated(): boolean

  返回是否启用重复平铺。

  Returns boolean

isSmooth

• isSmooth(): boolean

  返回是否启用平滑过滤。

  Returns boolean

isSrgb

• isSrgb(): boolean

  返回纹理是否使用 sRGB 格式。

  Returns boolean

loadFromFile

• loadFromFile(
      filename: string,
      sRgb?: boolean,
      area?: ReadonlyValue<IntRect>,
  ): Promise<boolean>

  异步解码文件后上传像素，返回是否成功；area 使用像素坐标，默认整张图像。

  Parameters

  • filename: string
  • sRgb: boolean = false
  • Optionalarea: ReadonlyValue<IntRect>

  Returns Promise<boolean>

loadFromImage

• loadFromImage(
      image: Image,
      sRgb?: boolean,
      area?: ReadonlyValue<IntRect>,
  ): boolean

  同步上传 Image 的指定像素区域，默认完整图像，返回是否成功。

  Parameters

  • image: Image
  • sRgb: boolean = false
  • Optionalarea: ReadonlyValue<IntRect>

  Returns boolean

loadFromMemory

• loadFromMemory(
      data: Uint8Array,
      sRgb?: boolean,
      area?: ReadonlyValue<IntRect>,
  ): Promise<boolean>

  异步解码编码图像字节后上传像素，返回是否成功；sRgb 默认 false。

  Parameters

  • data: Uint8Array
  • sRgb: boolean = false
  • Optionalarea: ReadonlyValue<IntRect>

  Returns Promise<boolean>

loadFromStream

• loadFromStream(
      stream: InputStream,
      sRgb?: boolean,
      area?: ReadonlyValue<IntRect>,
  ): Promise<boolean>

  从可寻址流异步解码并上传图像，返回是否成功；流异常会拒绝 Promise。

  Parameters

  • stream: InputStream
  • sRgb: boolean = false
  • Optionalarea: ReadonlyValue<IntRect>

  Returns Promise<boolean>

resize

• resize(size: Readonly<Vector2u>, sRgb?: boolean): boolean

  Successful resize leaves pixel contents undefined, as in SFML.

  Parameters

  • size: Readonly<Vector2u>
  • sRgb: boolean = false

  Returns boolean

setRepeated

• setRepeated(repeated: boolean): void

  设置超出纹理范围的坐标是否重复平铺；false 使用边缘像素。

  Parameters

  • repeated: boolean

  Returns void

setSmooth

• setSmooth(smooth: boolean): void

  启用或关闭纹理平滑过滤。

  Parameters

  • smooth: boolean

  Returns void

swap

• swap(other: Texture): void

  同步交换像素和配置，先提交已录制绘制；不可用于借用的纹理视图。

  Parameters

  • other: Texture

  Returns void

update

• update(pixels: Uint8Array): void

  同步更新整个纹理；pixels 必须恰好包含宽×高×4 个 RGBA8 字节。

  Parameters

  • pixels: Uint8Array

  Returns void
• update(
      pixels: Uint8Array,
      size: Readonly<Vector2u>,
      dest: Readonly<Vector2u>,
  ): void

  将 size 大小的 RGBA8 像素块上传到 dest；所有坐标和尺寸均以像素计。

  Parameters

  • pixels: Uint8Array
  • size: Readonly<Vector2u>
  • dest: Readonly<Vector2u>

  Returns void
• update(
      source:
          | Image
          | Readonly<
              Pick<
                  Texture,
                  | "getSize"
                  | typeof graphicsNative
                  | typeof textureId
                  | typeof textureOwner
                  | "copyToImage"
                  | "isSmooth"
                  | "isRepeated"
                  | "isSrgb"
                  | "getNativeHandle",
              >,
          >
          | Window,
      dest?: Readonly<Vector2u>,
  ): void

  将图像、纹理或窗口内容复制到 dest（默认原点），目标区域必须容纳整个源。

  Parameters

  • source:
        | Image
        | Readonly<
            Pick<
                Texture,
                | "getSize"
                | typeof graphicsNative
                | typeof textureId
                | typeof textureOwner
                | "copyToImage"
                | "isSmooth"
                | "isRepeated"
                | "isSrgb"
                | "getNativeHandle",
            >,
        >
        | Window
  • Optionaldest: Readonly<Vector2u>

  Returns void

Staticbind

• bind(
      texture:
          | null
          | Readonly<
              Pick<
                  Texture,
                  | "getSize"
                  | typeof graphicsNative
                  | typeof textureId
                  | typeof textureOwner
                  | "copyToImage"
                  | "isSmooth"
                  | "isRepeated"
                  | "isSrgb"
                  | "getNativeHandle",
              >,
          >,
      coordinateType?: CoordinateType,
  ): void

  Bind in the current GL context; retain the texture while using its ID.

  Parameters

  • texture:
        | null
        | Readonly<
            Pick<
                Texture,
                | "getSize"
                | typeof graphicsNative
                | typeof textureId
                | typeof textureOwner
                | "copyToImage"
                | "isSmooth"
                | "isRepeated"
                | "isSrgb"
                | "getNativeHandle",
            >,
        >
  • coordinateType: CoordinateType = CoordinateType.Normalized

  Returns void

StaticgetMaximumSize

• getMaximumSize(): number

  返回当前显卡支持的最大纹理边长，单位为像素。

  Returns number