Table of contents
GDI
TOC
Collapse the table of content
Expand the table of content

Reporting Support for Point Sprites

Last Updated: 2/14/2017

A driver notifies the runtime of its support for point sprites by setting the MaxPointSize field of the D3DCAPS8 structure to a floating-point number greater than one (reporting a value of one is part of the requirement to indicate a DX8 level HAL). This value specifies the maximum point width and height in render target pixels. Devices that do not support point sprites can set this value to 1.0.

The size of a point sprite can be specified either by a new per-vertex element or by a new render state. If the driver and hardware combination supports the interleaving of point size information with other vertex data (rather than simply through the point size render state D3DRS_POINTSIZE), it should set the D3DFVFCAPS_PSIZE flag in the FVFCaps field of the D3DCAPS8 structure.

The absence of D3DFVFCAPS_PSIZE indicates that the device does not support a vertex format specified in point size (indicated by the D3DFVF_PSIZE flag); therefore, the base point size is always specified with the D3DRS_POINTSIZE render state.

DX8 drivers for which the D3DFVFCAPS_PSIZE flag is not set are still required to accept D3DFVF_PSIZE and must ignore any point size data passed through the flexible vertex format (FVF). Note that the D3DUSAGE_POINTS flag must be set for vertex buffers that are to be used for rendering point sprites. If this flag is set, the driver can avoid allocating these vertex buffers in memory types that are slow for reads into the CPU.

Point sprites present a challenge when user clip planes are being used. It is possible that a particular hardware implementation of point sprites will clip only the actual vertex position of the point sprite against the user clip plane, rather than the expanded quad actually rendered. If the driver and hardware combination can support clipping of point sprites by their actual computed size rather than simple vertex position then the D3DPMISCCAPS_CLIPPLANESCALEDPOINTS capability bit should be set in the PrimitiveMiscCaps field of D3DCAPS8.

DX8 drivers that perform transform and lighting (that is, offer hardware vertex processing) are responsible for a correct point sprite implementation. No emulation is performed by the DirectX 8.0 runtime. This means that even if the hardware is used with software vertex processing, point sprites are the DX8 driver's responsibility. However, in DirectX 8.1 and later, if the hardware is used with software vertex processing, the runtime can provide emulation.

Send comments about this topic to Microsoft

© 2017 Microsoft