ID3DXLine::DrawTransform Method

Draws a line strip in screen space with a specified input transformation matrix.

Syntax

HRESULT DrawTransform(      

    CONST D3DXVECTOR3* pVertexList,
    DWORD dwVertexListCount,
    CONST D3DXMATRIX* pTransform,
    D3DCOLOR Color
);

Parameters

pVertexList

[in] Array of vertices that make up the line. See D3DXVECTOR3.

dwVertexListCount

[in] Number of vertices in the vertex list.

pTransform

[in] A scale, rotate, and translate (SRT) matrix for transforming the points. See D3DXMATRIX. If this matrix is a projection matrix, any stippled lines will be drawn with a perspective-correct stippling pattern. Or, you can transform the vertices and use ID3DXLine::Draw to draw the line with a nonperspective-correct stipple pattern.

Color

[in] Color of the line. See D3DCOLOR.

Return Value

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be one of the following values.

D3DERR_INVALIDCALL	The method call is invalid. For example, a method's parameter may have an invalid value.
D3DXERR_INVALIDDATA	The data is invalid.