Brief Index      Full Index      I.M. Reference

Insert_Grid


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)

Function Documentation

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.

Parameters:
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.

DETAILS

A flat grid of faces, edges, and markers is added to the current segment. Type controls the layout. It may have either of the following values:

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.

NOTES

In this release, grids can not be given "local" attribute values ( Open_Edge() , etc., will not work.) You can obtain some of the effect of local attributes by locally turning off hidden surfaces ( Set_Heuristics() ) and using Bring_To_Front() to lay a coarser grid with different attributes directly on top of a finer grid.

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.

RESTRICTIONS

See also:
Bring_To_Front, Insert_Marker, Insert_Polyline, Insert_Polygon, Insert_Shell, Insert_Mesh, Set_Visibility, Set_Edge_Pattern, Set_Edge_Weight, Set_Face_Pattern, Set_Marker_Symbol, Set_Color.

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.

Parameters:
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.
Returns:
key

DETAILS

No additional details. See Insert_Grid()

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.

Parameters:
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.

DETAILS

No additional details. See Insert_Grid()

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.

Parameters:
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.
Returns:
key

DETAILS

No additional details. See Insert_Grid()

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.

Parameters:
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.

DETAILS

No additional details. See Insert_Grid().

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.

Parameters:
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.
Returns:
key

DETAILS

No additional details. See Insert_Grid()

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.

Parameters:
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.

DETAILS

No additional details. See Insert_Grid()

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.

Parameters:
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.
Returns:
key

DETAILS

No additional details. See Insert_Grid()

Main Index
Brief Index      Full Index      I.M. Functions