TKE_PolyCylinder

Opcode

ASCII

Q

Hexadecimal

51

Decimal

81

Operands

Long count, (count)xPoint points,
Long radius_count, (radius_count)xFloat radii,
Byte flags,
[(3)xFloat start_orientation], [(3)xFloat end_orientation],
[Variable attributes]

count

number of points defining the polycylinder axis

points

count triplets of x, y, z data

radius_count

number of radii associated with the points

radii

radius_count floats

flags

a bitmask indicating options for the cylinder

start_orientation

vector describing the direction of the polycylinder at the start point. Present if the appropriate flags bit is set.

end_orientation

Vector describing the direction of the polycylinder at the start point. Present if the appropriate flags bit is set.

attributes

Colors specified at the vertices of the polycylinder. Present if the appropriate flags bit is set. See attributes.html. Note: Only options OPT_ALL_VFCOLORS, OPT_VERTEX_FCOLORS, OPT_ALL_VECOLORS, and OPT_VERTEX_ECOLORS are relevant.

Notes

A PolyCylinder is a series of cylindrical (or conical) pieces connected in series to resemble pipes or ducts.

Options settings for the polycylinder are as follows.

Flags

0x01

Capping disk at the start point is visible

0x02

Capping disk at the end point is visible

0x04

Orientation normal for the start point is specified

0x08

Orientation normal for at the end point is specified

0x10

Attributes (vertex colors) are specified

PolyCylinders are meant to be rendered according to the resolution set in TKE_Rendering_Options.

If radius_count is less then count, the radii should be repeated as needed to pair up a radius with each point.

PolyCylinder support was added in HSF format 7.05. End orientations and vertex colors were added in 8.05.