Compact Scene Tree

Use

The “Compact Scene Tree” import option is specifically for CATIA files. It collapses and manages the complex Scene Tree from CATIA assemblies and parts, and is active by default.

“Compact Scene Tree” is filtered via an XML file compactscenetree.xml that is located in the Plug-Ins folder. The file applies a set of rules that determine the degree to which the Scene Tree is collapsed. It can be adjusted to collapse only certain nodes, or objects of the Scene Tree.

Further Information

In the example below, the root node is called collapserule, and has three children. These are operationenums, entitytypes, and operationrules.

operationenums

Three operations are supported in operationenums. Those are: “Remove”, “Exclude”, and “Include”.

  • Remove: Removes nodes that match entity types defined in entitytypes

  • Exclude: Ignores nodes that match entity types defined in entitytypes

  • Include: Collapses nodes that match entity types defined in entitytypes

entitytypes

In the entitytypes, the following entities are supported:

  • CAD_PMI = 1

  • CAD_SHEETBODY = 2

  • CAD_HIDDEN = 4

  • CAD_WIREFRAME = 8

  • CAD_CONSTRUCTION_GEOMETRY = 16

  • CAD_COLLAPSE = 32

  • CAD_POINT = 64

  • CAD_PLANE = 128

  • CAD_REFIT_BBOX = 256

  • CAD_GLOBAL_HIDDEN = 512

  • CAD_AXIS_SYSTEM = 1024

  • CAD_PMI_GLOBAL_HIDDEN = 2048

  • CAD_PMI_CONSTRUCTION = 4096

  • CAD_SECTION_NODE = 8192

For example:

<entity name="hidden" value="4" operationenum="0" comment="Hidden entity type (Hidden by node itself)"/>

This means for the entity that is marked as hidden with value 4, it will be applied with the operation defined as 0, which is remove.

operationrules

operationrules is a set of rules that will be applied globally in the scene. The following options are supported:

  • name =respectcapture: If set to 1, geometry referenced by Captures is ignored regardless of the nodes entity type and operations defined for the node

  • name='generatereport': If set to 1, a collapse report is generated such as which node has been collapsed, removed

  • name='keepmetadata': If set to 1, create a metadata tree that represents the original metadata hierarchy before collapsing is created

  • name='keepsolid': If set to 1, solid geometry in the scene, if there is any, is retained. Otherwise, all solids are converted into a mesh

For example:

<entity name="hidden" value="4" operationenum="0" comment="Hidden entity type (Hidden by node itself)"/<entity name="wireframe" value="8" operationenum="1" comment="Wireframe entity type"/>

If an entity has both hidden and wireframe attributes, the collapse rule picks the last defined rule above- exclude (leave it as it is in the tree), rather than deleting it as defined for hidden entity types. A warning message is generated if generatereport is active.

Example

This is an extract from the XML file with comments and short descriptions of each section.