Applications use the methods of the IDirect3DRMAnimationSet interface to group Direct3DRMAnimation objects together, which can simplify the playback of complex animation sequences. This section is a reference to the methods of this interface. For a conceptual overview, see IDirect3DRMAnimation and IDirect3DRMAnimationSet Interfaces.
The methods of the IDirect3DRMAnimationSet interface can be organized into the following groups:
| Adding, loading, | AddAnimation |
| and removing | DeleteAnimation |
| Load | |
| Time | SetTime |
The IDirect3DRMAnimationSet interface, like all Component Object Model (COM) interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:
| AddRef |
| QueryInterface |
| Release |
In addition, the IDirect3DRMAnimationSet interface inherits the following methods from the IDirect3DRMObject interface:
| AddDestroyCallback |
| Clone |
| DeleteDestroyCallback |
| GetAppData |
| GetClassName |
| GetName |
| SetAppData |
| SetName |
The Direct3DRMAnimationSet object is obtained by calling the IDirect3DRM::CreateAnimationSet method.
Adds an animation to the animation set.
HRESULT AddAnimation(
LPDIRECT3DRMANIMATION lpD3DRMAnimation
);
Returns D3DRM_OK if successful, or an error otherwise. For a list of possible return codes, see Direct3D Retained Mode Return Values.
Removes a previously added animation from the animation set.
HRESULT DeleteAnimation(
LPDIRECT3DRMANIMATION lpD3DRMAnimation
);
Returns D3DRM_OK if successful, or an error otherwise. For a list of possible return codes, see Direct3D Retained Mode Return Values.
Loads an animation set.
HRESULT Load(
LPVOID lpvObjSource,
LPVOID lpvObjID,
D3DRMLOADOPTIONS d3drmLOFlags,
D3DRMLOADTEXTURECALLBACK d3drmLoadTextureProc,
LPVOID lpArgLTP,
LPDIRECT3DRMFRAME lpParentFrame
);
Returns D3DRM_OK if successful, or an error otherwise. For a list of possible return codes, see Direct3D Retained Mode Return Values.
By default, this method loads the first animation set in the file specified by the lpvObjSource parameter.
Sets the time for this animation set.
HRESULT SetTime(
D3DVALUE rvTime
);
Returns D3DRM_OK if successful, or an error otherwise. For a list of possible return codes, see Direct3D Retained Mode Return Values.
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.