Functions
Insert_Grid

Functions

HC_KEY 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. More...
 
HC_KEY 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 parameters of type double for increased precision. More...
 

Detailed Description

Function Documentation

HC_KEY 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 parameters of type double for increased precision.

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
The key to the inserted geometry, or -1 if an error occurred.

DETAILS

No additional details. See Insert_Grid().

HC_KEY 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.
Returns
The key to the inserted geometry, or -1 if an error occurred.

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_Edge_Pattern, Set_Edge_Weight, Set_Marker_Symbol.