This method of the Direct3dExecuteBuffer Class resets the status of the execute buffer.
public int setStatus(int flags, int status, int x1, int y1, int x2, int y2, int bufferindex);
Returns the number of 32-bit values added to the buffer.
flags | Specifies whether the status, extents, or both are being set.
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:
Combination of all CLIPINTERSECTION flags. Other CLIPINTERSECTION flags include D3DSTATUS_CLIPINTERSECTIONBACK, D3DSTATUS_CLIPINTERSECTIONBOTTOM, D3DSTATUS_CLIPINTERSECTIONFRONT, and D3DSTATUS_CLIPINTERSECTIONGEN0 through D3DSTATUS_CLIPINTERSECTIONGEN5. Combination of all CLIPUNION flags. Other CLIPUNION flags include D3DSTATUS_CLIPUNIONBOTTOM, D3DSTATUS_CLIPUNIONTOP, D3DSTATUS_CLIPUNIONLEFT, and D3DSTATUS_CLIPUNIONRIGHT. 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. |
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.