Microsoft DirectX 9.0 SDK Update (October 2004)

ClipPlane.SetSingleArray Method

Language:

Note: This documentation is preliminary and is subject to change.

Sets the coefficients of a user-defined clipping plane for the device.

Definition

Visual Basic .NET Public Sub SetSingleArray( _
    ByVal value() As Single _
)
C# public void SetSingleArray(
    float[] value
);
Managed C++ public: void SetSingleArray(
    float value __gc[]
);
JScript .NET public function SetSingleArray(
    value : float[]
);

Parameters

value System.Single[]. A four-element array of values that represent the clipping plane coefficients to set, in the form of the general plane equation. See Remarks.

Remarks

The coefficients that this method sets take the form of the general plane equation. If the values in the array are labeled A, B, C, and D in the order in which they appear in the array, they will fit into the general plane equation so that Ax + By + Cz + Dw = 0. A point with homogeneous coordinates (x, y, z, w) is visible in the half space of the plane if Ax + By + Cz + Dw > = 0. Points that exist behind the clipping plane are clipped from the scene.

When the fixed function pipeline is used, the plane equations are assumed to be in world space. When the programmable pipeline is used, the plane equations are assumed to be in the clipping space (the same space as output vertices).

This method does not enable the clipping plane equation to be set. To enable a clipping plane, set ClipPlane.Enabled to true.

Exceptions
ArgumentException Leave Site value cannot be null or 0.
IndexOutOfRangeException Leave Site value must be a four-element array.

See Also


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

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center