PCL Reference Manual > Geometry Functions > Verify Actions
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">   
Verify Actions
This section is used to describe some of the functions used to implement the “Verify” actions
 
sgm_verify_surface_boundary
(surface_list, verify_tolerance, verify_type)
 
Description:
This function will verify a list of surfaces for the existence of free edges between adjacent surfaces.
Input:
STRING
surface_list[]
This value specifies the surface list.
REAL
verify_tolerance
This value specifies the tolerance used to determine existence of free edges between adjacent surfaces.
INTEGER
verify_type
This value specifies the verification type: 1 =the surface edge topology in the database will be used to check for free edges, and 2 = the surface edges will be extracted from adjacent surface boundaries and will be geometrically compared within the value defined by the input value verify tolerance to determine if free edges exist.
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 the information whether or not free edges exist.
Surface normals may be reversed.
Each free edge will be highlighted and a diamond symbol placed at its centroid.
This function can display an information popup message form with the following message:
 
38000491
There are no free surface edges.
This function can display a warning popup message form with the following message:
 
38000054
Free edges and/or non-manifold edges exist. Free edges may be due to edges not matching directly or a missing face. Non-manifold edges are due to more than two surfaces connecting at the same edges. Edges are highlighted and marked with primary markers for free edges and secondary markers for non-manifold edges.
This function can display a fatal popup message form with the following messages:
 
1000025
Error attempting to allocate virtual memory.
38000484
There must be at least two surfaces in the surface list. The number input was %I%.
38000485
The verification tolerance value of %G% must be less than or equal to the Geometric Modeling Tolerance value of %G%.
Example:
Please see sgm_verify_surface_boundary (p. 531) in the PCL Reference Manual Examples.
 
sgm_verify_surface_duplicates
(delete_surfaces, delete_high)
Description:
Check the entire database for duplicate surfaces and optionally delete them.
Input:
LOGICAL
delete_surfaces
This value specifies, when set to TRUE, that any duplicate surfaces will be deleted. When this value is set to FALSE, duplicate surfaces will not be deleted.
LOGICAL
delete_high
This value specifies, when set to TRUE, that the surfaces with the higher identifier values will be deleted from sets of duplicate surfaces. If this value is set to FALSE, the duplicate surfaces with the lower identifier values will be deleted from sets of duplicate surfaces. Duplicate surfaces will be deleted only when the input value delete_surfaces is set to TRUE.
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:
None.
Remarks:
This function is used in the implementation of the “Geometry” switch bar form that is displayed when the action is set to “Verify”, the object is set to “Surface”, and the test is set to “Duplicates”.
Example: