Device.ClipStatus Property

Article
10/15/2009

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Gets or sets a ClipStatus structure.

Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Syntax

'Declaration
Public Property ClipStatus As ClipStatus
    Get
    Set
'Usage
Dim instance As Device
Dim value As ClipStatus

value = instance.ClipStatus

instance.ClipStatus = value

public ClipStatus ClipStatus { get; set; }

public:
property ClipStatus ClipStatus {
    ClipStatus get ();
    void set (ClipStatus value);
}

member ClipStatus : ClipStatus with get, set

Property Value

Type: Microsoft.WindowsMobile.DirectX.Direct3D.ClipStatus
A ClipStatus structure that describes the current clip status.

Exceptions

Exception	Condition
InvalidCallException	One of the arguments is invalid.

Remarks

The clip status is used during software vertex processing; therefore, this method is not supported on hardware processing devices, regardless of whether they are pure. For more information about pure devices, see CreateFlags.

When clipping is enabled during vertex processing (by ProcessVertices, DrawPrimitives, or other drawing functions), Direct3D computes a clip code for every vertex. The clip code is a combination of ClipStatusFlags values. When a vertex is outside a particular clipping plane, the corresponding bit is set in the clip code. Direct3D maintains the clip status using ClipStatus, which has ClipUnion and ClipIntersection members. ClipUnion is a bitwise OR of all vertex clip codes and has an initial value of 0; ClipIntersection is a bitwise AND of all vertex clip codes and has an initial value of 0xFFFFFFFF. When Clipping is set to false, ClipUnion and ClipIntersection are set to 0. Direct3D updates the clip status during drawing calls. To compute the clip status for a particular object, set ClipUnion and ClipIntersection to their initial values and continue drawing.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Platforms

Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Compact Framework

Supported in: 3.5, 2.0

Share via