PCL Reference Manual > Geometry Functions > Disassemble Actions
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">   
Disassemble Actions
This section is used to describe some of the functions used to implement the “Disassemble” actions.
  
sgm_disassemble_chain
(chain_list, delete_original)
 
Description:
This function disassembles a set of chains into constituent curves.
Input:
STRING
chain_list[]
This value specifies the set of chains to be disassembled.
LOGICAL
delete_original
This value is set to TRUE if the original chains are to be deleted. If this value is set to FALSE, the original entities will not be deleted.
Output:
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:
-1
This is an internal status condition. There is no corresponding status message in the message database.
Remarks:
This function displays a message listing the number of curves created and their IDs.
The number of curves created from each chain is a function of how the chain was created. Each curve will be displayed in the graphics window as it is created.
This function can display a fatal popup message form with the following messages:
 
1000201
%A% is not a recognized syntax for a Curve List.
38000470
Unable to load the curve into the database.
38000471
Curve %I% is not a chain.
38000805
Unable to acquire %I% words of virtual memory.
Example:
Please see sgm_disassemble_chain (p. 589) in the PCL Reference Manual Examples.
  
sgm_disassemble_tsurf
(surface_list, delete_original)
 
Description:
This function disassembles a set of trimmed surfaces into parent surfaces and edge curves.
Input:
STRING
surface_list[]
This value specifies the set of trimmed surfaces.
LOGICAL
delete_original
This value is set to TRUE if the original trimmed surfaces are to be deleted. If this value is set to FALSE, the original entities will not be deleted.
Output:
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:
-1
This is an internal status condition. There is no corresponding status message in the message database.
Remarks:
This function displays a message listing the number of surfaces and curves created and their IDs.
Each trimmed surface will be disassembled into a single surface and a number of curves that is a function of how the trimmed surface was created. Each surface and curve will be displayed in the graphics window as it is created.
This function can display a fatal popup message form with the following messages:
 
38000468
Surface %I% is not a general trimmed surface.
38000805
Unable to acquire %I% words of virtual memory.
Example:
Please see sgm_disassemble_tsurf (p. 590) in the PCL Reference Manual Examples.
 
sgm_disassemble_solid
(solid_list, delete_original, created_labels)
 
Description:
This function disassembles a set of solids into subordinate surface faces.
Input:
STRING
solid_list[]
This value specifies the list of solids to be disassembled.
LOGICAL
delete_original
This value is set to TRUE if the original solids are to be deleted. If this value is set to FALSE, the original entities will not be deleted.
Output:
STRING
created_labels[]
This value returns the a list of the labels for the created 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.
8107002
Last command aborted.
Remarks:
This function displays a message listing the number of surfaces created and their IDs.
The number of surfaces created from each depends on the geometry of the solid. Each surface will be displayed in the graphics window as it is created.
Example:
Please see sgm_disassemble_solid (p. 592) in the PCL Reference Manual Examples.