Microsoft SDK for Java

setStatus

This method of the Direct3dExecuteBuffer Class resets the status of the execute buffer.

Syntax

public int setStatus(int flags, int status, int x1, int y1, int x2, int y2, int bufferindex);

Return Value

Returns the number of 32-bit values added to the buffer.

Parameters

flags Specifies whether the status, extents, or both are being set.

D3DSETSTATUS_STATUS

Sets the status.

D3DSETSTATUS_EXTENTS

Sets the extents specified by a given bounding box (x1,y1,x2,y2).

D3DSETSTATUS_ALL

Sets both the status and the extents.

status The clipping flags. This parameter can be one or more of the following flags:

D3DSTATUS_CLIPINTERSECTIONALL

Combination of all CLIPINTERSECTION flags.

Other CLIPINTERSECTION flags include D3DSTATUS_CLIPINTERSECTIONBACK, D3DSTATUS_CLIPINTERSECTIONBOTTOM, D3DSTATUS_CLIPINTERSECTIONFRONT, and D3DSTATUS_CLIPINTERSECTIONGEN0 through D3DSTATUS_CLIPINTERSECTIONGEN5.

D3DSTATUS_CLIPUNIONALL

Combination of all CLIPUNION flags.

Other CLIPUNION flags include D3DSTATUS_CLIPUNIONBOTTOM, D3DSTATUS_CLIPUNIONTOP, D3DSTATUS_CLIPUNIONLEFT, and D3DSTATUS_CLIPUNIONRIGHT.

D3DSTATUS_DEFAULT

the default is a combination of D3DSTATUS_CLIPINTERSECTION and D3DSTATUS_ZNOTVISIBLE flags.

Basic clipping flags include D3DCLIP_BACK, D3DCLIP_LEFT, and D3DCLIP_TOP.

x1 Defines a bounding box for all relevant vertices. The x-coordinate of the bounding box's upper-left corner.
x2 The y-coordinate of the bounding box's upper-left corner.
y1 The x-coordinate of the bounding box's lower-right corner.
y2 The y-coordinate of the bounding box's lower-right corner.
bufferindex The position in the execute buffer to place the instruction.

Remarks

The status is a rolling status and is updated during each execution. The bounding box specified can grow with each execution, but it does not shrink. It can be reset by calling this method again.

The execute buffer is treated as an array of 32-bit values, which is a collection of floats and ints that describe vertices and instructions. It is up to the user to manage the position of each item added to the buffer.

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