Texture

constructor

• new Texture(): Texture

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

  返回值

  Texture

  源码与继承
• new Texture(size: Readonly<Vector2u>, sRgb?: boolean): Texture

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

  参数

  size

  Readonly<Vector2u>

  sRgb可选

  boolean

  返回值

  Texture

  源码与继承
• new Texture(source: Readonly): Texture

  深复制纹理像素和配置。

  参数

  source

  Readonly

  返回值

  Texture

  源码与继承
• new Texture(
      image: Image,
      sRgb?: boolean,
      area?: ReadonlyValue<IntRect>,
  ): Texture

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

  参数

  image

  Image

  sRgb可选

  boolean

  area可选

  ReadonlyValue<IntRect>

  返回值

  Texture

  源码与继承

assign

• assign(source: Readonly): this

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

  参数

  source

  Readonly

  返回值

  this

  源码与继承

copyToImage

• copyToImage(): Image

  同步从 GPU 回读到独立的、由原生层拥有的 Image。

  返回值

  Image

  源码与继承

generateMipmap

• generateMipmap(): boolean

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

  返回值

  boolean

  源码与继承

getNativeHandle

• getNativeHandle(): number

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

  返回值

  number

  源码与继承

getSize

• getSize(): Vector2u

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

  返回值

  Vector2u

  源码与继承

isRepeated

• isRepeated(): boolean

  返回是否启用重复平铺。

  返回值

  boolean

  源码与继承

isSmooth

• isSmooth(): boolean

  返回是否启用平滑过滤。

  返回值

  boolean

  源码与继承

isSrgb

• isSrgb(): boolean

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

  返回值

  boolean

  源码与继承

loadFromFile

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

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

  参数

  filename

  string

  sRgb

  boolean = false

  area可选

  ReadonlyValue<IntRect>

  返回值

  Promise<boolean>

  源码与继承

loadFromImage

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

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

  参数

  image

  Image

  sRgb

  boolean = false

  area可选

  ReadonlyValue<IntRect>

  返回值

  boolean

  源码与继承

loadFromMemory

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

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

  参数

  data

  Uint8Array

  sRgb

  boolean = false

  area可选

  ReadonlyValue<IntRect>

  返回值

  Promise<boolean>

  源码与继承

loadFromStream

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

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

  参数

  stream

  InputStream

  sRgb

  boolean = false

  area可选

  ReadonlyValue<IntRect>

  返回值

  Promise<boolean>

  源码与继承

resize

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

  与 SFML 一致，调整尺寸成功后像素内容未定义。

  参数

  size

  Readonly<Vector2u>

  sRgb

  boolean = false

  返回值

  boolean

  源码与继承

setRepeated

• setRepeated(repeated: boolean): void

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

  参数

  repeated

  boolean

  返回值

  void

  源码与继承

setSmooth

• setSmooth(smooth: boolean): void

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

  参数

  smooth

  boolean

  返回值

  void

  源码与继承

swap

• swap(other: Texture): void

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

  参数

  other

  Texture

  返回值

  void

  源码与继承

update

• update(pixels: Uint8Array): void

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

  参数

  pixels

  Uint8Array

  返回值

  void

  源码与继承
• update(
      pixels: Uint8Array,
      size: Readonly<Vector2u>,
      dest: Readonly<Vector2u>,
  ): void

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

  参数

  pixels

  Uint8Array

  size

  Readonly<Vector2u>

  dest

  Readonly<Vector2u>

  返回值

  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（默认原点），目标区域必须容纳整个源。

  参数

  source

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

  dest可选

  Readonly<Vector2u>

  返回值

  void

  源码与继承

静态bind

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

  在当前 GL 上下文中绑定；使用其 ID 期间须保留纹理。

  参数

  texture

  
      | null
      | Readonly<
          Pick<
              Texture,
              | "getSize"
              | typeof graphicsNative
              | typeof textureId
              | typeof textureOwner
              | "copyToImage"
              | "isSmooth"
              | "isRepeated"
              | "isSrgb"
              | "getNativeHandle",
          >,
      >

  coordinateType

  CoordinateType = CoordinateType.Normalized

  返回值

  void

  源码与继承

静态getMaximumSize

• getMaximumSize(): number

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

  返回值

  number

  源码与继承

只读[graphicsNative]

只读[textureId]

可选 只读[textureOwner]