class HT_Linestrip

class HT_Linestrip

This is a descriptor of a linestrip with color values, normal vectors, or texture parameters which are possibly attached to each vertex or segment. The HT_Linestrip class is derived from HT_Linestrip, HT_Segment_Set, HT_Vertex_Set and HT_Point_Set. To manipulate HT_Linestrip objects, reference these classes for additional member functions.

For an example of a linestrip, see HT_Renderer::draw_3d_linestrip.

See Also HT_Segment_Set, HT_Vertex_Set, HT_Point_Set, HT_Renderer::draw_3d_linestrip Access Methods

line_colors

Allows access to the segment colors of the linestrip.

line_color_count

Returns the number of line colors in this linestrip.

line_normal_count

Returns the number of line normals in this linestrip.

line_normals

Allows access to the segment normals of the linestrip. Constructor

HT_Linestrip

Creates a linestrip object.

HT_Linestrip::line_colors

Purpose

Allows access to the segment colors of the linestrip. Synopsis

void set_line_colors (int count, HT_RGB32 const * colors, HT_Boolean copy)

HT_RGB32 const * line_colors (void)

void set_line_colors (void * dummy)

Details This method allows access to the array of colors by segment for this linestrip.

The first method sets the segment colors in this linestrip according to the colors passed in the parameter colors. If the copy parameter is HK_True, then count colors are copied from the colors array into the linestrip object. If the copy parameter is HK_False, the linestrip object color array refers directly to the array of colors in the colors array. In this case, the application must ensure that the array and linestrip object are deleted in correct order.

The second method returns a pointer to the internal array of line colors.

The third method resets line_colors to an empty pointer and dummy has to be a null pointer.

HT_Linestrip::line_color_count

Purpose

Returns the number of line colors in this linestrip. Synopsis

int line_color_count (void)

Details The number of line colors in the linestrip is returned.

HT_Linestrip::line_normal_count

Purpose

Returns the number of line normals in this linestrip. Synopsis

int line_normal_count (void)

Details The number of line normals in the linestrip is returned.

HT_Linestrip::line_normals

Purpose

Allows access to the segment normals of the linestrip. Synopsis

void set_line_normals (int count, HT_Vector const * normals, 
    HT_Boolean copy)

HT_Vector const * line_normals (void)

void set_line_normals (void * dummy)

Details This method allows access to the array of normals by segment for this linestrip.

The first method sets the segment normals in this linestrip according to the normals passed in the parameter normals. If the copy parameter is HK_True, then count normals are copied from the normals array into the linestrip object. If the copy parameter is HK_False, the linestrip object normal array refers directly to the array of normals in the normals array.

The second method returns a pointer to the internal array of line normals.

The third method resets line_normals to an empty pointer and dummy has to be a null pointer.

HT_Linestrip::HT_Linestrip

Purpose

Creates a line strip object. Synopsis

HT_Linestrip (void)

HT_Linestrip(int count, HT_Point const * points)
    : HT_Segment_Set(count, points)

HT_Linestrip(int count, HT_Point const * points, HT_Boolean copy)
    : HT_Segment_Set(count, points, copy)

Details The linestrip is created. To add vertices, colors, normals, or texture parameters reference the base classes for HT_Linestrip, which are HT_Segment_Set, HT_Vertex_Set, and HT_Point_Set. If the copy parameter is HK_True, then count points are copied from the points array into the linestrip object. If the copy parameter is HK_False, the linestrip object point array refers directly to the array of points in the points array.