ref_iface_IVDXAContext_CreateRenderTexture

VirtualDub Plugin SDK 1.2

IVDXAContext interface

IVDXAContext:: CreateRenderTexture

Creates a renderable texture for off-screen rendering.

uint32 CreateRenderTexture(uint32 width, uint32 height, uint32 borderWidth, uint32 borderHeight, VDXAFormat format, bool wrap);

Parameters

width	Width of texture, in pixels.
height	Height of texture, in pixels.
borderWidth	Maximum number of pixels of border required horizontally.
borderHeight	Maximum number of pixels of border required vertically.
format	Pixel format to use for off-screen buffer. kVDXAF_A8R8G8B8 32-bit RGB texture with 8-bit components, ordered B/G/R/A in memory.
wrap	True if the texture should use wrap addressing; false if it should use clamping.

Thread safety

This method is not thread-safe.

Remarks

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

Wrapping is only available if the requested width and height are powers of two.

The border width and height are used to control rendering to the buffer so that any necessary borders are created to support sampling slightly outside of the texture bounds.

Renderable textures require persistent VRAM allocations and should be used sparingly. Using too many renderable textures increases VRAM pressure and can result in slow rendering or even allocation failure.

---

Copyright (C) 2007-2012 Avery Lee.