ID3D11DeviceContext::RSSetScissorRects method (d3d11.h)

Bind an array of scissor rectangles to the rasterizer stage.

Syntax

void RSSetScissorRects(
  [in]           UINT             NumRects,
  [in, optional] const D3D11_RECT *pRects
);

Parameters

[in] NumRects

Type: UINT

Number of scissor rectangles to bind.

[in, optional] pRects

Type: const D3D11_RECT*

An array of scissor rectangles (see D3D11_RECT).

Return value

None

Remarks

All scissor rects must be set atomically as one operation. Any scissor rects not defined by the call are disabled.

The scissor rectangles will only be used if ScissorEnable is set to true in the rasterizer state (see D3D11_RASTERIZER_DESC).

Which scissor rectangle to use is determined by the SV_ViewportArrayIndex semantic output by a geometry shader (see shader semantic syntax). If a geometry shader does not make use of the SV_ViewportArrayIndex semantic then Direct3D will use the first scissor rectangle in the array.

Each scissor rectangle in the array corresponds to a viewport in an array of viewports (see ID3D11DeviceContext::RSSetViewports).

Windows Phone 8: This API is supported.

Requirements

See also

ID3D11DeviceContext