Brief Index      Full Index      Events Index      I.M. Reference

Show_Mesh


Functions

void Show_Mesh (HC_KEY key, int *rows, int *columns, HC_POINT *points)
void DShow_Mesh (HC_KEY key, int *rows, int *columns, HC_DPOINT *points)
void Show_Mesh_Size (HC_KEY key, int *rows, int *columns)
void Show_Partial_Mesh (HC_KEY key, int row_offset, int col_offset, int row_count, int col_count, HC_POINT *points)

Function Documentation

void Show_Mesh ( HC_KEY  key,
int *  rows,
int *  columns,
HC_POINT *  points 
)

Returns the previous definition of a mesh, as referenced by a key.

Parameters:
key - Unique numeric identifier pointing to a mesh in the database.
rows - Number of rows of vertices in the mesh. Returned to caller. Passed by reference always.
columns - Number of columns of vertices in the mesh. Returned to caller. Passed by reference always.
points - A rows x columns array of x-y-z triplets of the coordinates of the vertices of the mesh. You can also use a simple rows x 3 array of floats. A one-dimensional vector (with the entries packed row by row) may be used in place of the full 2-D/ 3-D array. Returned to caller. Passed by reference always.

DETAILS

Show_Mesh() reads back the x-y-z's currently stored in a mesh. This is useful if your program is not storing its own copy of the mesh data. The key for the mesh might come from Show_Selection_Element() or Find_Contents() , or it might have been saved by your program when the mesh was created.

Use Show_Mesh_Size() to determine how large the points array is going to need to be, before you call Show_Mesh() .

Show_Partial_Mesh() is useful for looking at a portion of a mesh.

NOTES

RESTRICTIONS

See also:
Insert_Mesh, Get_Selection, Begin_Contents_Search, Compute_Coordinates.

void DShow_Mesh ( HC_KEY  key,
int *  rows,
int *  columns,
HC_DPOINT *  points 
)

Similar to Show_Mesh(), but returns double-precision values.

Parameters:
key - Unique numeric identifier pointing to a mesh in the database.
rows - Number of rows of vertices in the mesh. Returned to caller. Passed by reference always.
columns - Number of columns of vertices in the mesh. Returned to caller. Passed by reference always.
points - A rows x columns array of x-y-z triplets of the coordinates of the vertices of the mesh. You can also use a simple rows x 3 array of floats. A one-dimensional vector (with the entries packed row by row) may be used in place of the full 2-D/ 3-D array. Returned to caller. Passed by reference always.

DETAILS

No additional details. See Show_Mesh().

void Show_Mesh_Size ( HC_KEY  key,
int *  rows,
int *  columns 
)

Finds the size of a given mesh. This is usefule in determining the size of the data structure that must hold points.

Parameters:
key - Unique numeric identifier pointing to a mesh in the database.
rows - Number of rows of vertices in the mesh. Returned to caller. Passed by reference always.
columns - Number of columns of vertices in the mesh. Returned to caller. Passed by reference always.

DETAILS

No additional details. See Show_Mesh()

void Show_Partial_Mesh ( HC_KEY  key,
int  row_offset,
int  col_offset,
int  row_count,
int  col_count,
HC_POINT *  points 
)

Returns a portion of the previous definition of a mesh, as referenced by a key.

Parameters:
key - Unique numeric identifier pointing to a mesh in the database.
row_offset - Row offset of the first point to be returned.
col_offset - Column offset of the first point to be returned.
row_count - Number of rows of vertices requested to be returned in the points array
col_count - Number of columns of vertices requested to be returned in the points array.
points - A rows x columns array of x-y-z triplets of the coordinates of the vertices of the mesh. You can also use a simple rows x 3 array of floats. A one-dimensional vector (with the entries packed row by row) may be used in place of the full 2-D/ 3-D array. Returned to caller. Passed by reference always.

DETAILS

No additional details. See Show_Mesh()

Brief Index      Full Index      Events Index      I.M. Reference