콘텐츠로 이동

IGpuTextureSource interface

이 콘텐츠는 아직 번역되지 않았습니다.

Marker interface for raster sources whose pixels live primarily on the GPU, one tier above IRasterSource and below the per-backend marker interfaces defined in backend assemblies.

public interface IGpuTextureSource : IRasterSource
name description
GpuPixelHeight { get; } Gets the GPU texture height in texels, usually equal to PixelHeight.
GpuPixelWidth { get; } Gets the GPU texture width in texels, usually equal to PixelWidth.
YFlipped { get; } Gets whether texel row 0 is the bottom of the image (bottom-up storage); false for top-down storage.
ConfigureGpuTextureWrap(…) Configures the wrap mode of the underlying GPU texture for tiled or clamped sampling; a no-op by default.
GetTextureHandle() Returns the native GPU texture handle this source owns, or 0 when the resource has not been allocated yet.
ReleaseGpuHandle(…) Releases a reference taken via RetainGpuHandle, exactly once per successful retain; a no-op when the source does not support retaining.
RetainGpuHandle(…) Adds a reference to the underlying GPU handle so its lifetime extends past this source’s disposal; returns false when the source does not support retaining (the default).

Carries only backend-agnostic metadata. Backend identity and typed native handles are exposed by per-backend marker interfaces in their own assemblies, so:

  • Core has zero knowledge of any specific GPU backend.
  • A consumer that wants zero-copy interop with a particular backend casts to that backend’s marker; cross-backend sources can choose a CPU readback path separately when they also implement IPixelBufferSource.
  • Adding a new backend defines its own marker in its own assembly without modifying core.

CPU-side readback is intentionally not part of this contract. Implement IPixelBufferSource separately when CPU access is supported.