Geometry

Tutorial Toolkit Function Descriptions > Group > Geometry

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">

Geometry

Utilities for managing points, curves, surfaces, and solids in conjunction with groups.


db_count_orphan_curves	( count )


Description:
Returns the number of curves not in a group.
Input:
none
Output:
INTEGER	count	The number of curves not in a group.
INTEGER	<Return Value>	Returns the success or failure of the routine

Example:

Please see db_count_orphan_curves, 410 and db_count_orphan_curves (p. 412) in the MSC Acumen Toolkit - Code Examples.


db_get_orphan_curves	( count, label_id )


Description:
This function will return the label ids for curves that are not assigned to a group.
Input:
INTEGER	count	This value specifies the number of offsets defined for the output value label_id.
Output:
INTEGER	entity_id()	This value returns the label id values of the orphan curves.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.

Example:

See example for db_count_orphan_curves, 158 for more information. See also db_get_orphan_curves (p. 423) in the MSC Acumen Toolkit - Code Examples.


db_count_orphan_points	( count )


Description:
Returns the number of points not in a group.
Input:
none
Output:
INTEGER	count	The number of points not in a group.
INTEGER	<Return Value>	Returns the success or failure of the routine

Example:

Please see db_count_orphan_points (p. 416) in the MSC Acumen Toolkit - Code Examples.


db_get_orphan_points	( count, entity_id )


Description:
Returns the point entities not in a group.
Input:
INTEGER	count	Max number of entities returned.
Output:
INTEGER	entity_id()	Array of orphan eitity ids.
INTEGER	<Return Value>	Returns the success or failure of the routine.

Example:

See example for db_count_orphan_points, 159. See also db_get_orphan_points (p. 426) in the MSC Acumen Toolkit - Code Examples.


db_count_orphan_solids	( )


Description:
Returns the number of solids not in a group.
Input:
none
Output:
INTEGER	count	The number of solids not in a group.
INTEGER	<Return Value>	Returns the success or failure of the routine.

Example:

Please see db_count_orphan_solids (p. 417) in the MSC Acumen Toolkit - Code Examples.


db_get_orphan_solids	( count, entity_id )


Description:
Returns the solid entities not in a group.
Input:
INTEGER	count	Max number of entities returned.
Output:
INTEGER	entity_id()	Array of orphan entity ids.
INTEGER	<Return Value>	Returns the success or failure of the routine.

Example:

See example for db_count_orphan_solids, 159. See also db_get_orphan_solids (p. 427) in the MSC Acumen Toolkit - Code Examples.


db_count_orphan_surfaces	( count )


Description:
Returns the number of surfaces not in a group.
Input:
none
Output:
INTEGER	count	The number of surfaces not in a group.
INTEGER	<Return Value>	Returns the success or failure of the routine.

Example:

Please see db_count_orphan_surfaces (p. 418) in the MSC Acumen Toolkit - Code Examples.


db_get_orphan_surfaces	( count, entity_id )


Description:
Returns the surface entities not in a group.
Input:
INTEGER	count	Max number of entities returned.
Output:
INTEGER	entity_id()	Array of orphan entity ids.
INTEGER	<Return Value>	Returns the success or failure of the routine.

Example:

See example for db_count_orphan_surfaces, 160. Please see db_get_orphan_surfaces (p. 429) in the MSC Acumen Toolkit - Code Examples.


asm_db_count_asm_in_group	( groupId, count, status )


Description:
Counts all of the The MacNeal-Schwendler Corporation entities (grid, line, patch, hpat, coordinate frames, nodes, and elements) in a group.
Input:
INTEGER	groupId	The id of the group.
Output:
INTEGER	count(7)	The count for each of the entities: (1) - grid (2) - line (3) - patch (4) - hpat (5) - coordinate frames (6) - nodes (7) - elements
INTEGER	status	Success or an error code.

Example:

Please see asm_db_count_asm_in_group (p. 394) in the MSC Acumen Toolkit - Code Examples.


asm_db_get_grids_in_group	( groupId, gridLabels, xyzCoordinates, status )


Description:
Gets the labels and xyz coordinates of all the grids in a group.
Input:
INTEGER	groupId	The id of the group.
Output:
INTEGER	gridLabels()	The grid labels.
REAL	xyzCoordinates()	The xyz coordinates.
INTEGER	status	Success or an error code.
Error Conditions:
38000617	ERROR Retrieving geometric entity definition of type PDA %A% from the database.

Example:

Please see asm_db_get_grids_in_group (p. 395) in the MSC Acumen Toolkit - Code Examples.


asm_db_get_hpats_in_group	(groupid, hpatlabels, hpatvertexids, geometriccoeff, status)


Description:
This function will get the labels, hpat vertex ids, and the xyz coordinates of all the hpats in a group.
Input:
INTEGER	groupid	This value specifies the id of the group.
Output:
INTEGER	hpatlabels()	This value returns the hpat label values. The number of offsets for this array should equal the number of solids defined for the group.
INTEGER	hpatvertexIds()	This value returns the hpat vertex ids. The number of offsets for this array should equal the number of solids defined for the group times 8.
REAL	geometriccoeff()	This value returns the xyz coordinates. The number of offsets for this array should equal the number of solids defined for the group times 192.
INTEGER	status	This value returns a value of 0 when the function executes successfully and a non zero value to indicate a change in status or an error.

Remarks:

The number of solids defined in a group can be found by calling the function db_count_entities_in_group, 150. with the entity type value set to 4.

Example:

Please see asm_db_get_hpats_in_group (p. 397) in the MSC Acumen Toolkit - Code Examples.


asm_db_get_lines_in_group	( groupid, linelabels, geometriccoefficients, status )


Description:
Gets the labels and xyz coordinates of all the lines in the model.
Input:
INTEGER	groupId	The id of the group.
Output:
INTEGER	linelabels()	The line labels.
REAL	geometriccoefficients()	The xyz coordinates.
INTEGER	status	Success or an error code.
Error Conditions:
38000617	ERROR Retrieving geometric entity definition of type PDA %A% from the database.

Example:

Please see asm_db_get_lines_in_group (p. 398) in the MSC Acumen Toolkit - Code Examples.


asm_db_get_patches_in_group	( groupid, patchlabels, geometriccoeff, status )


Description:
This function will get the labels and the xyz coordinates of all of the patches in a group.
Input:
INTEGER	groupid	This value specifies the id of the group.
Output:
INTEGER	patchlabels()	This value returns the patch label values. The number of offsets for this array should equal the number of surfaces defined for the group.
REAL	geometriccoeff()	This value returns the xyz coordinates. The number of offsets for this array should equal the number of surfaces defined for the group times 48.
INTEGER	status	This value returns a value of 0 when the function executes successfully and a non zero value to indicate a change in status or an error.

Remarks:

The number of surfaces defined in a group can be found by calling the function db_count_entities_in_group, 150 with the entity type value set to 3.

Example:

Please see asm_db_get_patches_in_group (p. 400) in the MSC Acumen Toolkit - Code Examples.


sgm_db_count_iges_in_group	( groupid, count )


Description:
Counts all the IGES entity types IN A GROUP.
Input:
INTEGER	groupId	The id of the group.
Output:
INTEGER	count (15)	The count for each of the entities: (1) - IGES_Nurb_Curve. (2) - IGES_Cubic_Spline. (3) - IGES_Arc. (4) - IGES_Composite_Curve. (5) - IGES_Line. (6) - IGES_Conic. (7) - IGES_PieceWise_Linear. (8) - IGES_Offset_Curve. (9) - IGES_Nurb_Surface. (10) - IGES_Trimmed_Surface. (11) - IGES_BiCubic_Patch_Network. (12) - IGES_Surface_Of_Revolution. (13) - IGES_Ruled_Surface. (14) - IGES_Tabulated_Cylinder. (15) - IGES_Offset_Surface.
INTEGER	<Return Value>	See error conditions.
Error Conditions:
1000025	Error attempting to allocate virtual memory.

Example:

Please see sgm_db_count_iges_in_group (p. 499) in the MSC Acumen Toolkit - Code Examples.


sgm_db_get_iges_in_group	( groupid, typecode, entityids, id_count )


Description:
This function will get all the IGES entity types in a group.
Input:
INTEGER	groupid	This value specifies the id of the group.
INTEGER	typecode	This value specifies the type code of the group. See the remarks below.
Output:
INTEGER	entityids()	This value returns the entity id values. This array must be allocated with enough offsets to list all of the entity id values assigned to the group. Use a call to the PCL function sgm_db_count_iges_in_group() to get a count of the number of offsets required.
INTEGER	id_count	This value returns the number of id values of the specified type returned by the value entityids.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
38000617	ERROR Retrieving geometric entity definition of type PDA %A% from the database.

Remarks:

The input value typecode can be assigned the following values:


Value:	Description:
102	IGES_Nurb_Curve
103	IGES_Cubic_Spline
104	IGES_Arc
105	IGES_Composite_Curve
106	IGES_Line
107	IGES_Conic
108	IGES_PieceWise_Linear
113	IGES_Offset_Curve
1001	IGES_Nurb_Surface
1002	IGES_Trimmed_Surface
1003	IGES_BiCubic_Patch_Network
1004	IGES_Surface_Of_Revolution
1005	IGES_Ruled_Surface
1006	IGES_Tabulated_Cylinder
1012	IGES_Offset_Surface

Example:

Please see sgm_db_get_iges_in_group (p. 500) in the MSC Acumen Toolkit - Code Examples.