Functions | |
void | Insert_Grid (const char *type, const HC_POINT *origin, const HC_POINT *ref1, const HC_POINT *ref2, int count1, int count2) |
HC_KEY | KInsert_Grid (const char *type, const HC_POINT *origin, const HC_POINT *ref1, const HC_POINT *ref2, int count1, int count2) |
void | QInsert_Grid (const char *segment, const char *type, const HC_POINT *origin, const HC_POINT *ref1, const HC_POINT *ref2, int count1, int count2) |
HC_KEY | QKInsert_Grid (const char *segment, const char *type, const HC_POINT *origin, const HC_POINT *ref1, const HC_POINT *ref2, int count1, int count2) |
void | DInsert_Grid (const char *type, const HCD_POINT *origin, const HCD_POINT *ref1, const HCD_POINT *ref2, int count1, int count2) |
HC_KEY | DKInsert_Grid (const char *type, const HCD_POINT *origin, const HCD_POINT *ref1, const HCD_POINT *ref2, int count1, int count2) |
void | DQInsert_Grid (const char *segment, const char *type, const HCD_POINT *origin, const HCD_POINT *ref1, const HCD_POINT *ref2, int count1, int count2) |
HC_KEY | DQKInsert_Grid (const char *segment, const char *type, const HCD_POINT *origin, const HCD_POINT *ref1, const HCD_POINT *ref2, int count1, int count2) |
void Insert_Grid | ( | const char * | type, | |
const HC_POINT * | origin, | |||
const HC_POINT * | ref1, | |||
const HC_POINT * | ref2, | |||
int | count1, | |||
int | count2 | |||
) |
Generates a flat array of edges, faces, and/or markers.
type | - Special constant (see below). | |
origin | - An x-y-z triplet for the coordinates of the "start point" of the grid. (A simple array of three elements may also be used in most languages.) Passed by reference always. | |
ref1 | - An x-y-z triplet for the coordinates of the first point "to the right of" origin. See below for details. Passed by reference always. | |
ref2 | - An x-y-z triplet for the coordinates of the first point "above" origin. See below for details. Passed by reference always. | |
count1 | - The number of grid units along the ref1 dimension. | |
count2 | - The number of grid units along the ref2 dimension. |
quadrilateral
A quadrilateral unit is formed as (origin, ref1, ref1 + ref2 - origin, ref2). If count1 is positive, the number of units is laid down along the ref1 axis starting at origin. If it is negative, the number of units is laid down along the ref1 axis and an additional count1 number of units is laid down along the negative ref1 axis. The entire count1 assembly is duplicated along the ref2 axis. If count2 is negative, the repetitions go both ways from the origin.
If both count1 and count2 are zero, the quadrilateral grid is infinite in extent. The system will make the appropriate optimizations when the grid is seen in perspective.
radial
A "pie wedge" is formed as (origin, ref1, ref2). The pie wedge is drawn radially count1 times, and circumferentially count2 times.
If count1 is given as zero, the radial grid is infinite in extent. The system will make the appropriate optimizations when the grid is seen in perspective.
Grids are grouped with shells and meshes for rendering purposes. The rendition of the interior of the grid can be adjusted with changes to face Pattern. The edges can be adjusted with Edge Pattern and Weight. The vertices can be adjusted with Marker Size and Symbol. The faces, edges, and markers can all be controlled with Visibility and Selectability.
If you are not in 3-D "hidden surface" mode, the routine Bring_To_Front() can be helpful in forcing geometries to be drawn reliably on top of a grid.
HC_KEY KInsert_Grid | ( | const char * | type, | |
const HC_POINT * | origin, | |||
const HC_POINT * | ref1, | |||
const HC_POINT * | ref2, | |||
int | count1, | |||
int | count2 | |||
) |
Similar to Insert_Grid(), but returns an HC_KEY to the object.
type | - Special constant (see below). | |
origin | - An x-y-z triplet for the coordinates of the "start point" of the grid. (A simple array of three elements may also be used in most languages.) Passed by reference always. | |
ref1 | - An x-y-z triplet for the coordinates of the first point "to the right of" origin. See below for details. Passed by reference always. | |
ref2 | - An x-y-z triplet for the coordinates of the first point "above" origin. See below for details. Passed by reference always. | |
count1 | - The number of grid units along the ref1 dimension. | |
count2 | - The number of grid units along the ref2 dimension. |
void QInsert_Grid | ( | const char * | segment, | |
const char * | type, | |||
const HC_POINT * | origin, | |||
const HC_POINT * | ref1, | |||
const HC_POINT * | ref2, | |||
int | count1, | |||
int | count2 | |||
) |
Similar to Insert_Grid(), but operates on a given segment rather than the currently open one.
segment | - Segment(s) to be inserted into, if other than the currently- open segment. | |
type | - Special constant (see below). | |
origin | - An x-y-z triplet for the coordinates of the "start point" of the grid. (A simple array of three elements may also be used in most languages.) Passed by reference always. | |
ref1 | - An x-y-z triplet for the coordinates of the first point "to the right of" origin. See below for details. Passed by reference always. | |
ref2 | - An x-y-z triplet for the coordinates of the first point "above" origin. See below for details. Passed by reference always. | |
count1 | - The number of grid units along the ref1 dimension. | |
count2 | - The number of grid units along the ref2 dimension. |
HC_KEY QKInsert_Grid | ( | const char * | segment, | |
const char * | type, | |||
const HC_POINT * | origin, | |||
const HC_POINT * | ref1, | |||
const HC_POINT * | ref2, | |||
int | count1, | |||
int | count2 | |||
) |
Similar to Insert_Grid(), but operates on a given segment and returns an HC_KEY to the object.
segment | - Segment(s) to be inserted into, if other than the currently- open segment. | |
type | - Special constant (see below). | |
origin | - An x-y-z triplet for the coordinates of the "start point" of the grid. (A simple array of three elements may also be used in most languages.) Passed by reference always. | |
ref1 | - An x-y-z triplet for the coordinates of the first point "to the right of" origin. See below for details. Passed by reference always. | |
ref2 | - An x-y-z triplet for the coordinates of the first point "above" origin. See below for details. Passed by reference always. | |
count1 | - The number of grid units along the ref1 dimension. | |
count2 | - The number of grid units along the ref2 dimension. |
void DInsert_Grid | ( | const char * | type, | |
const HCD_POINT * | origin, | |||
const HCD_POINT * | ref1, | |||
const HCD_POINT * | ref2, | |||
int | count1, | |||
int | count2 | |||
) |
Similar to Insert_Grid() but accepts and/or returns double-precision values. This command can only be used when the application source includes the HOOPS double-precision header, hcd.h.
type | - Special constant (see below). | |
origin | - An x-y-z triplet for the coordinates of the "start point" of the grid. (A simple array of three elements may also be used in most languages.) Passed by reference always. | |
ref1 | - An x-y-z triplet for the coordinates of the first point "to the right of" origin. See below for details. Passed by reference always. | |
ref2 | - An x-y-z triplet for the coordinates of the first point "above" origin. See below for details. Passed by reference always. | |
count1 | - The number of grid units along the ref1 dimension. | |
count2 | - The number of grid units along the ref2 dimension. |
HC_KEY DKInsert_Grid | ( | const char * | type, | |
const HCD_POINT * | origin, | |||
const HCD_POINT * | ref1, | |||
const HCD_POINT * | ref2, | |||
int | count1, | |||
int | count2 | |||
) |
Similar to DInsert_Grid(), but returns an HC_KEY to the object.
type | - Special constant (see below). | |
origin | - An x-y-z triplet for the coordinates of the "start point" of the grid. (A simple array of three elements may also be used in most languages.) Passed by reference always. | |
ref1 | - An x-y-z triplet for the coordinates of the first point "to the right of" origin. See below for details. Passed by reference always. | |
ref2 | - An x-y-z triplet for the coordinates of the first point "above" origin. See below for details. Passed by reference always. | |
count1 | - The number of grid units along the ref1 dimension. | |
count2 | - The number of grid units along the ref2 dimension. |
void DQInsert_Grid | ( | const char * | segment, | |
const char * | type, | |||
const HCD_POINT * | origin, | |||
const HCD_POINT * | ref1, | |||
const HCD_POINT * | ref2, | |||
int | count1, | |||
int | count2 | |||
) |
Similar to DInsert_Grid(), but operates on a given segment rather than the currently open one.
segment | - Segment(s) to be inserted into, if other than the currently- open segment. | |
type | - Special constant (see below). | |
origin | - An x-y-z triplet for the coordinates of the "start point" of the grid. (A simple array of three elements may also be used in most languages.) Passed by reference always. | |
ref1 | - An x-y-z triplet for the coordinates of the first point "to the right of" origin. See below for details. Passed by reference always. | |
ref2 | - An x-y-z triplet for the coordinates of the first point "above" origin. See below for details. Passed by reference always. | |
count1 | - The number of grid units along the ref1 dimension. | |
count2 | - The number of grid units along the ref2 dimension. |
HC_KEY DQKInsert_Grid | ( | const char * | segment, | |
const char * | type, | |||
const HCD_POINT * | origin, | |||
const HCD_POINT * | ref1, | |||
const HCD_POINT * | ref2, | |||
int | count1, | |||
int | count2 | |||
) |
Similar to DInsert_Grid(), but operates on a given segment and returns an HC_KEY to the object.
segment | - Segment(s) to be inserted into, if other than the currently- open segment. | |
type | - Special constant (see below). | |
origin | - An x-y-z triplet for the coordinates of the "start point" of the grid. (A simple array of three elements may also be used in most languages.) Passed by reference always. | |
ref1 | - An x-y-z triplet for the coordinates of the first point "to the right of" origin. See below for details. Passed by reference always. | |
ref2 | - An x-y-z triplet for the coordinates of the first point "above" origin. See below for details. Passed by reference always. | |
count1 | - The number of grid units along the ref1 dimension. | |
count2 | - The number of grid units along the ref2 dimension. |