Microsoft DirectX 9.0 SDK Update (October 2004)

CubeTexture.AddDirtyRectangle Method

Language:

Note: This documentation is preliminary and is subject to change.

Adds a dirty region to a cube texture resource.

Definition

Visual Basic .NET Public Sub AddDirtyRectangle( _
    ByVal faceType As CubeMapFace, _
    ByVal rect As Rectangle _
)
C# public void AddDirtyRectangle(
    CubeMapFace faceType,
    Rectangle rect
);
Managed C++ public: void AddDirtyRectangle(
    CubeMapFace faceType,
    Rectangle rect
);
JScript .NET public function AddDirtyRectangle(
    faceType : CubeMapFace,
    rect : Rectangle
);

Parameters

faceType Microsoft.DirectX.Direct3D.CubeMapFace. A CubeMapFace value that identifies the face where the dirty region will be added. Omitting the sig_CubeMapFace_Rectangle parameter indicates that the dirty region should expand to cover the full face.
rect System.Drawing.Rectangle. A Rectangle Leave Site that specifies the dirty region.

Remarks

For performance reasons, dirty regions are recorded only for level 0 of a texture. For sublevels, it is assumed that the corresponding (scaled) rectangle or box is also dirty. Dirty regions are automatically recorded when CubeTexture.LockRectangle is called without LockFlags.NoDirtyUpdate or LockFlags.ReadOnly.

Exceptions
InvalidCallException The method call is invalid. For example, a method's parameter might contain an invalid value.

See Also


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center