Direct3DCubeTexture8.AddDirtyRect

Adds a dirty region to a cube map resource.

object.AddDirtyRect( _ 
    FaceType  As CONST_D3DCUBEMAP_FACES, _ 
    DirtyRect As Any)

Parts

object

Object expression that resolves to a Direct3DCubeTexture8 object.

FaceType

Member of the CONST_D3DCUBEMAP_FACES enumeration, identifying the cube map face.

DirtyRect

A RECT type, specifying the dirty region. Specifying ByVal 0 expands the dirty region to cover the entire cube texture.

Error Codes

If the method fails, an error is raised and Err.Number can be set to D3DERR_INVALIDCALL.

For information on trapping errors, see the Microsoft® Visual Basic® Error Handling topic.

Remarks

For performance reasons, dirty regions are only recorded for level zero of a texture. For sublevels, it is assumed that the corresponding (scaled) rectangle or box is also dirty. Dirty regions are automatically recorded when LockRect or LockBox is called without D3DLOCK_NO_DIRTY_UPDATE or D3DLOCK_READONLY. Also, the destination surface of a CopyRects call is marked dirty.

See Also

Direct3DCubeTexture8.GetLevelDesc, Direct3DCubeTexture8.LockRect, Direct3DCubeTexture8.UnlockRect