Applications use the methods of the IDirect3DRMTexture interface to work with textures, which are rectangular arrays of pixels. This section is a reference to the methods of this interface. For a conceptual overview, see IDirect3DRMTexture and IDirect3DRMTexture2 Interfaces.
To avoid unnecessary delays when creating textures, hold onto textures you want to use again, instead of creating them each time they're needed. For optimal performance, use a texture surface format that is supported by the device you are using. This will avoid a costly format conversion when the texture is created and any time it changes.
See the remarks in IDirect3DRM::LoadTexture for an example showing how to keep a reference to textures loaded in a texture callback through IDirect3DRM::LoadTexture.
The methods of the IDirect3DRMTexture interface can be organized into the following groups:
| Color | GetColors |
| SetColors | |
| Decals | GetDecalOrigin |
| GetDecalScale | |
| GetDecalSize | |
| GetDecalTransparency | |
| GetDecalTransparentColor | |
| SetDecalOrigin | |
| SetDecalScale | |
| SetDecalSize | |
| SetDecalTransparency | |
| SetDecalTransparentColor | |
| Images | GetImage |
| Initialization | InitFromFile |
| InitFromResource | |
| InitFromSurface | |
| Renderer notification | Changed |
| Shading | GetShades |
| SetShades |
The IDirect3DRMTexture interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:
AddRef
QueryInterface
Release
In addition, the IDirect3DRMTexture interface inherits the following methods from the IDirect3DRMObject interface:
The Direct3DRMTexture object is obtained by calling the IDirect3DRM::CreateTexture method.