ref_iface_IVDXAContext_CreateTexture2D

VirtualDub Plugin SDK 1.2

IVDXAContext interface

IVDXAContext:: CreateTexture2D

Creates a 2D texture.

uint32 CreateTexture2D(uint32 width, uint32 height, uint32 mipCount, VDXAFormat format, bool wrap, const VDXAInitData2D *initData);

Parameters

width	Width of texture, in pixels.
height	Height of texture, in pixels.
mipCount	Number of mipmaps in the texture.
format	Format of texels in the texture. kVDXAF_A8R8G8B8 32-bit RGB texture with 8-bit components, ordered B/G/R/A in memory.
wrap	True if the texture should be interpreted as repeating out to infinity beyond its borders (wrap addressing); false if the borders should be extended (clamp addressing).
initData	Pointer to array of initialization data structures to initialize the texture. One element is required per mipmap. The first structure corresponds to the largest mipmap and each successive structure points to an image that is half the width and height, rounding down.

Thread safety

This method is not thread-safe.

Return value

A handle for the texture, or zero on failure.

Remarks

This method is expensive and should be called in startProc, not in accelRunProc.

The allocated texture may be larger than requested to satisfy hardware restrictions. When this occurs, the texture image is extended to fill the remaining area to satisfy clamp semantics. For this reason, wrapping should be requested only when the texture dimensions are powers of two.

---

Copyright (C) 2007-2012 Avery Lee.