D3DLINEPATTERN

The D3DLINEPATTERN structure describes a line pattern. These values are used by the D3DRENDERSTATE_LINEPATTERN render state in the D3DRENDERSTATETYPE enumerated type.

typedef struct _D3DLINEPATTERN { 
    WORD wRepeatFactor; 
    WORD wLinePattern; 
} D3DLINEPATTERN; 
 

Members

wRepeatFactor

Number of times to duplicate each series of 1s and 0s specified in the wLinePattern member. This repeat factor allows an application to "stretch" the line pattern.

wLinePattern

Bits specifying the line pattern. For example, the following value would produce a dotted line: 1100110011001100.

Remarks

A line pattern specifies how a line is drawn. The line pattern is always the same, no matter where it is started. (This is as opposed to stippling, which affects how objects are rendered; that is, to imitate transparency.)

The line pattern specifies up to a 16-pixel pattern of on and off pixels along the line. The wRepeatFactor member specifies how many pixels are repeated for each entry in wLinePattern.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in d3dtypes.h.