CheckInstanceConsistency

This function returns information about the consistency of the instance and indirectly referenced instances.

The mask defined what type of information can be retrieved from this call, the mask is a bitwise definition.

  bit 0:   Check Design Tree Consistency
  bit 1:   Check Consistency for Triangle Output (through API)
  bit 2:   Check Consistency for Line Output (through API)
  bit 3:   Check Consistency for Point Output (through API)
  bit 4:   Check Consistency for Generated Surfaces (through API)
  bit 5:   Check Consistency for Generated Surfaces (internal)
  bit 6:   Check Consistency for Generated Solids (through API)
  bit 7:   Check Consistency for Generated Solids (internal)
  bit 8:   Check Consistency for BoundingBox's
  bit 9:   Check Consistency for Triangulation
  bit 10:  Check Consistency for Relations (through API)

  bit 16:   Contains (Closed) Solid(s)
  bit 18:   Contains (Closed) Infinite Solid(s)
  bit 20:   Contains Closed Surface(s)
  bit 21:   Contains Open Surface(s)
  bit 22:   Contains Closed Infinite Surface(s)
  bit 23:   Contains Open Infinite Surface(s)
  bit 24:   Contains Closed Line(s)
  bit 25:   Contains Open Line(s)
  bit 26:   Contains Closed Infinite Line(s) [i.e. both ends in infinity]
  bit 27:   Contains Open Infinite Line(s) [i.e. one end in infinity]
  bit 28:   Contains (Closed) Point(s)

If a bit in the mask is set and the result of the check has an issue, the resulting value will have this bit set. i.e. any non-zero return value in Check Consistency is an indication that something is wrong or unexpected regarding the given instance; a zero return value in Contains is an indication that this type of geometry is expected regarding the given instance;

Syntax

public const string EngineDLL = @"engine.dll";[DllImport(EngineDLL, EntryPoint = "CheckInstanceConsistency")]
public static extern Int64 CheckInstanceConsistency(Int64 owlInstance, Int64 mask);    

Property owlInstance

Size: 64 bit / 8 byte (value)
The handle to the specific instance in the design tree. The instance handle is static within one open model but is most probably different when the same instance is opened in another model. The instance is always exactly of one unique class.

Property mask

Size: 64 bit / 8 byte (value)
This mask or bitmask is data that is used for bitwise operations, i.e. the bits set in the mask are the bits affected in the setting or return value.