Tutorial Toolkit Function Descriptions > Geometry > Point/Curve Relation
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">   
Point/Curve Relation
  
db_count_curves_for_point
( id, count )
Description:
Counts all curves associated with a specified point in the database.
Input:
INTEGER
id
The id of the point to which the curves are associated.
Output:
INTEGER
count
The integer number of curves associated to the point in the database.
INTEGER
<Return Value>
Integer indicating success or failure of the routine. If the routine failed, this value contains an indication of the reason.
Error Conditions:
13000097
Curve input was not found.
Example:
Please see db_count_curves_for_point (p. 532) in the MSC Acumen Toolkit - Code Example.
  
db_get_curves_for_point
( ptid,count,crvid)
Description:
Finds the ids of all curves associated with a specified point in the database.
Input:
INTEGER
ptid
Id of the point to which the curves are associated.
INTEGER
count
The number of curves that the calling routine expects to receive from the database. This count should be the same as the number of curves to which the point is associated as it should have been fetched from the database prior to making this call.
Output:
INTEGER
crvid()
Ids of the various curves associated with the specified point.
Example:
See example for db_count_curves_for_point, 251. See also db_get_curves_for_point (p. 548) in the MSC Acumen Toolkit - Code Example.
 
sgm_db_get_edge_vertex_ids
( edgeid, vertexids )
 
Description:
This function returns the vertex id values foran edge.
Input:
INTEGER
edgeid
This value specifies the id of an edge.
Output:
INTEGER
vertexids ( )
This value returns the id values of the vertices of an edge.
INTEGER
<Return Value>
0 if the function was successful.
Example:
Please see sgm_db_get_edge_vertex_ids (p. 608) in the MSC Acumen Toolkit - Code Example.
  
sgm_nearest_point_on_curve
(location, curve_data, parameter, point_location)
Description:
This function gets the nearest point at a specific parametric location on a curve.
Input:
REAL ARRAY
location(3)
The xyz location of the point in space.
REAL ARRAY
curve_data()
The blob of the curve. The functions to be used for getting the blob are sgm_db_get_blob_size() followed by sgm_db_get_curve().
REAL
parameter
The parameter value along the curve where to look for the nearest point.
Output:
 
 
REAL ARRAY
point_location(3)
The xyz location of the nearest point in space.
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:
See the Status Messages (Ch. 11) for information on any error values returned by this function.
Example:
Please see sgm_nearest_point_on_curve (p. 658) in the MSC Acumen Toolkit - Code Example.
  
sgm_nearest_point_on_curve_aea
(location, curve_data, parameter, point_location)
Description:
This function gets the nearest point at a specific parametric location on a curve.
Input:
REAL ARRAY
location(3)
The xyz location of the point in space.
REAL ARRAY
curve_data()
The blob of the curve. The functions to be used for getting the blob are sgm_db_get_blob_size() followed by sgm_db_get_curve().
REAL
parameter
The parameter value where to look for the nearest point.
Output:
REAL ARRAY
point_location(3)
The xyz location of the nearest point in space.
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:
See the Status Messages (Ch. 11) for information on any error values returned by this function.
Example:
Please see sgm_nearest_point_on_curve_aea (p. 660) in the MSC Acumen Toolkit - Code Example.
  
xy_curve_num_points_get
(<curve_name>,<yonly>,<npoints>)
Description:
This function will get the number of points on the curve.
Input:
STRING
curve_name
Name of the curve.
Output:
LOGICAL
yonly
Flag which is TRUE if curve uses only y values and FALSE if curve uses both xy values.
INTEGER
npoints
Number of points on the curve.
INTEGER
<Return Value>
Returns 0 for success, otherwise returns the error code.
Error Conditions:
See the Status Message(Ch 11) for information on any error values returned by this function.
Example:
Please see xy_curve_num_points_get (p. 680) in the MSC Acumen Toolkit - Code Example.