A3DTess3DWireData

struct A3DTess3DWireData

3D wire data structure

2.0

The A3DTess3DWireentity includes data stored in the A3DTessBaseDatastructure.

The A3DTessBaseData::m_pdCoordsmember represents point coordinates, which are interpreted in groups of three (X, Y, Z) to represent 3D vectors. A3DTess3DWireDataenables you to organize these coordinates as wires. The A3DTess3DWireDatastructure uses the A3DTessBaseData::m_pdCoordsarray to retrieve the point coordinates. The m_puiSizesWiresmember contains indexes referencing the array of points in A3DTessBaseData::m_pdCoords. The index for each point is a multiple of 3 and refers to the first coordinate in the 3D point. As an example, for a single 4-point wire the m_puiSizesWiresarray would contain the following elements, with the first element representing the number of points in the wire and subsequent elements representing point indexes in A3DTessBaseData::m_pdCoords: {number of indexes, indexes of the wire edge} = {4, 0, 3, 6, 9}. The m_uiSizesWiresSizemember represents the exact number of elements in the m_puiSizesWiresarray. Our single 4-point wire contains 5 elements {4, 0, 3, 6, 9}, so m_uiSizesWiresSizewould be set to 5. If m_uiSizesWiresSizeis set to zero, the tessellation is given as a single wire edge with the array of point indexes contained in A3DTessBaseData::m_pdCoords. If m_uiSizesWiresSizecontains multiple wires, then the array referenced by m_puiSizesWiresdescribes the edges as follows:

Wire IndexesWire IndexesWire IndexesWire IndexesWire Indexes

If m_uiSizesWiresSizeis non-zero, m_puiSizesWirescan include the flags described in Flags for Specifying Wire Characteristicsas follows: [number of indexes | flag, indexes 1, indexes 2, …] m_bIsRGBAindicates the color format used is RGBA. A value of true indicates the use of RGBA, while a value of false indicates the use of RGB. m_bIsSegmentColor: A value of true indicates the colors are for the entire segment. m_pucRGBAVerticesspecifies the color channels for each vertex / segment. m_uiRGBAVerticesSizespecifies the size of the m_pucRGBAVertices. When the colors are for points (m_bIsSegmentColor= false), the number of colors needed must be equal to the number of points.When the colors are for segments (m_bIsSegmentColor= true), the number of colors needed must be equal to the number of segments. So if a wire has 3 points, it will need 2 colors. If this 3-point wire is closed or continuous with a previous wire, it will need 3 colors.The number of colors needed can be calculated:

A3Duns32iNumberColorNeeded=0;

if(sTess3DWireData.m_bIsSegmentColor&&!bIsWireClosed&&!bIsWireContinuous)
{
iNumberOfColorsNeeded=sData->m_uiSize-1;
}
else
{
iNumberOfColorsNeeded=sData->m_uiSize;
}

The member m_uiRGBAVerticesSizeis 3 times the number of colors needed for RGB, 4 times the number of colors needed for RGBA.

sTess3DWireData.m_uiRGBAVerticesSize=(sTess3DWireData.m_bIsRGBA?4:3)*iNumberOfColorsNeeded;

Example: Consider the following example of two wires: one defined by 3 points, and another wire defined by 4 points.

Wire SegmentsWire SegmentsWire SegmentsWire SegmentsWire Segments

<style>.WireList {padding-bottom:7px;}</style>

Variables

A3DUns32 A3DTess3DWireData.m_uiSizesWiresSize
A3DUns32

The size of m_puiSizesWires.

A3DUns32 *A3DTess3DWireData.m_puiSizesWires
A3DUns32*

See explanations in Detailed Description.

A3DBool A3DTess3DWireData.m_bIsRGBA
A3DBool

See explanations in Detailed Description.

A3DBool A3DTess3DWireData.m_bIsSegmentColor
A3DBool

See explanations in Detailed Description.

A3DUns32 A3DTess3DWireData.m_uiRGBAVerticesSize
A3DUns32

The size of m_pucRGBAVertices.

A3DUns8 *A3DTess3DWireData.m_pucRGBAVertices
A3DUns8*

See explanations above.