Syntax

   FACTORY_DEF * GeometryBuilderFactory
   [FACTORY_NAME <factory name>]
   [INPUT FEATURE_TYPE <feature type>
      [<attribute name> <attribute value>]*
      [<feature function>]*]*
   [GROUP_BY [<attribute name>]+]*
   [FLUSH_WHEN_GROUPS_CHANGE (Yes|No)]
   [LIST_NAME <list_name>]
   [LIST_ATTRS_TO_INCLUDE [<attrNameToIncludeInList>]* ]
   [LIST_ATTRS_TO_INCLUDE_MODE (ALL|SELECTED)]
   [UNIFIED_LIST YES]
   [DROP_HOLES (YES|NO)]
   [HOLE_ATTR <attr_name>]
   [HOLE_LIST_NAME <hole_list_name>]
   [HOLE_LIST_ATTRS_TO_INCLUDE [<attrNameToIncludeInList>]* ]
   [HOLE_LIST_ATTRS_TO_INCLUDE_MODE (ALL|SELECTED)]
   [NORMAL_TOLERANCE <float>]
   [OFFSET_TOLERANCE <float>]
   [MODE (SOLID|SURFACE)]
   [OUTPUT (SURFACE|SOLID|UNUSED|<REJECTED>) 
      FEATURE_TYPE <feature type>
      [<attribute name> <attribute value>]*
      [<feature function>]*]* 

Overview

   GeometryBuilderFactory builds geometries based on input features which make up the 
   parts of the geometries built. For example, input surfaces can be used to build
   surface donuts and/or solids. Input solids can be used to build hollow solids, or solids 
   containing cavities.

Input Tags
   
   INPUT
   
      All input features.
      
Clauses
  
   GROUP_BY 
   
      Attributes used to group input features.

   FLUSH_WHEN_GROUPS_CHANGE

      If the GROUP_BY clause is specified, and FLUSH_WHEN_GROUPS_CHANGE is set to Yes,
      the factory will flush the current group whenever a feature from a different
      group is encountered.

   LIST_NAME

      Specifies the name of the list of attributes that contains attributes of
      participating input features.

      The optional LIST_ATTRS_TO_INCLUDE_MODE will specify if ALL attributes should be added to
      a list, or if only the SELECTED attributes (specified with the LIST_ATTRS_TO_INCLUDE clause)
      should be added to the list.  If this value is not specified, it defaults to ALL.

   UNIFIED_LIST
      
      YES specifies that the list should contain attributes from all inputs that 
      contribute to the solid.
      NO specifies that the list should only contain attributes from the inputs
      that contribute to the outer shell

   DROP_HOLES

      Determines whether interior hole representations are additionally
      output.

   HOLE_ATTR

      Specifies the name of an attribute that contains a yes/no value for whether
      an output features is a hole or not.

   HOLE_LIST_NAME

      Specifies the name of the list of attributes that contains the attributes
      of all of the participating hole features.

      The optional HOLE_LIST_ATTRS_TO_INCLUDE_MODE will specify if ALL attributes should be added to
      a list, or if only the SELECTED attributes (specified with the HOLE_LIST_ATTRS_TO_INCLUDE clause)
      should be added to the list.  If this value is not specified, it defaults to ALL.

   NORMAL_TOLERANCE

      If two planes are nearly co-planar, but their normals are slightly apart,
      use this clause to set a tolerance in degrees. 

   OFFSET_TOLERANCE

      If two planes are parallel, but slightly offset from one another, 
      use this clause to set a tolerance in ground units.

   MODE

      Specifies whether the input geometry should be build as surfaces
      or solids. 

Output Tags
   
   SURFACE
   
      Surface features that are constructed from input surfaces or lines.
   
   SOLID
   
      Solid features that are constructed from input surfaces and/or solids.

   UNUSED
   
      Input features that have supported geometries but were not used in geometry building.

   <REJECTED>
      
      Input features which have unsupported geometries.