PCL Reference Manual > Geometry Functions > Disassociate Actions
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">   
Disassociate Actions
This section is used to describe some of the functions used to implement the “Disassociate” actions.
sgm_disassociate_point
(point_list, entity_list)
 
Description:
This function deletes all associations from a set of points.
Input:
STRING
point_list[]
This value specifies a set of point labels from which all associations will be removed.
Output:
STRING
entity_list[]
This value returns a list of the disassociated entities.
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:
1000025
Error attempting to allocate virtual memory.
1000053
No valid geometric entities of type %A% were used as input. Unable to process request.
1000054
An invalid geometric entity type was used as input. The valid entity type to use is %A%. Unable to process request.
Remarks:
The database is modified due to the deletion of the associations.
Associated points that are marked by a filled blue triangle are removed from the graphics window.
The viewport must be refreshed after this function is called to redisplay all entities.
Example:
Please see sgm_disassociate_point (p. 598) in the PCL Reference Manual Examples.
 
sgm_disassociate_curve
(curve_list, entity_list)
 
Description:
This function deletes all associations from a set of curves.
Input:
STRING
curve_list[]
This value specifies a set of curve labels from which all associations will be removed.
Output:
STRING
entity_list[]
This value returns a list of the disassociated entities.
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:
1000025
Error attempting to allocate virtual memory.
1000053
No valid geometric entities of type %A% were used as input. Unable to process request.
1000054
An invalid geometric entity type was used as input. The valid entity type to use is %A%. Unable to process request.
Remarks:
The database is modified due to the deletion of the associations.
Associated curves that are marked by a filled yellow triangle are removed from the graphics window.
The viewport must be refreshed after this function is called to redisplay all entities.
Example:
Please see sgm_disassociate_curve (p. 599) in the PCL Reference Manual Examples.
 
sgm_disassociate_surface
(surface_list, entity_list)
 
Description:
This function deletes all point and curve associations from a set of surfaces.
Input:
STRING
surface_list[]
This value specifies a set of surface labels from which all associations will be removed.
Output:
STRING
entity_list[]
This value returns a list of the disassociated entities.
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:
1000025
Error attempting to allocate virtual memory.
1000053
No valid geometric entities of type %A% were used as input. Unable to process request.
1000054
An invalid geometric entity type was used as input. The valid entity type to use is %A%. Unable to process request.
Remarks:
The database is modified due to the deletion of the associations.
Associated points and curves that are marked by a filled blue and yellow triangle, respectively, are removed from the graphics window.
The viewport must be refreshed after this function is called to redisplay all entities.
Example:
Please see sgm_disassociate_surface (p. 600) in the PCL Reference Manual Examples.