Syntax

   FACTORY_DEF <ReaderKeyword> SurfaceDissolveFactory
   [FACTORY_NAME <factory name>]
   [INPUT FEATURE_TYPE <feature type>
      [<attribute name> <attribute value>]*
      [<feature function>]*]*
   [DISSOLVE_COUNT_ATTRIBUTE <attribute name>]
   [NORMAL_TOLERANCE <tolerance>]
   [OFFSET_TOLERANCE <tolerance>]
   [NON_OVERLAPPING_INPUT [(Yes|No)]]
   [MATCHING_APPS [(Yes|No)]]
   [SEPARATE_SURFACES [(Yes|No)]]
   [DEAGGREGATE_INPUT [(Yes|No)]]
   [ACCUM_INPUT_ATTRS (None|All|One)]
   [LIST_NAME <list name>]
   [LIST_ATTRS_TO_INCLUDE_MODE (ALL|SELECTED)]
   [LIST_ATTRS_TO_INCLUDE [<attrNameToIncludeInList>]*]
   [OUTPUT (SURFACE|REJECTED)
      FEATURE_TYPE <feature type>
      [<attribute name> <attribute value>]*
      [<feature function>]*]*

Overview

   Dissolves coplanar faces from input features.

Clauses

   [DISSOLVE_COUNT_ATTRIBUTE <attribute name>]

      This parameter specifies the name of an attribute that stores a value of 1 + the number of
      faces which have been dissolved into another.

   [NORMAL_TOLERANCE <tolerance>]

      This parameter determines the angular tolerance used when determining which surface parts are
      coplanar, prior to dissolving.

   [OFFSET_TOLERANCE <tolerance>]

      This parameter determines the thickness tolerance used when determining which surface parts
      are coplanar, prior to dissolving.

   [NON_OVERLAPPING_INPUT [(Yes|No)]

      Deprecated -- this parameter has no effect on the translation.

   [MATCHING_APPS [(Yes|No)]]

      If this parameter is specified with an argument of "No", then coplanar faces with different
      appearances will be dissolved and the resulting appearances will be chosen from one of the
      input faces. Texture coordinates will be interpolated from the texture coordinates on the
      chosen face.

   [SEPARATE_SURFACES [(Yes|No)]]

      If this parameter is specified with an argument of "No", then all input surfaces will be
      dissolved together and the results will be output as faces. Otherwise, each input surface will
      be dissolved individually and the results will be grouped to match the input surface type.

   [DEAGGREGATE_INPUT [(Yes|No)]]

      If this parameter is specified with an argument of "No" and input surfaces are being dissolved
      together, then all aggregate geometries will be rejected. Otherwise, aggregates will be
      traversed and surfaces will be processed if they are present. Aggregates which contain no
      surfaces will still be rejected.

   [ACCUM_INPUT_ATTRS (None|All|One)]

      This parameter specifies how attributes on input features are to be handled. If set to "No",
      no attributes from input polygons will be preserved. If set to "Yes", all attributes from
      input surfaces would be merged onto the resulting dissolved surface. When there are conflicts,
      one of the inputs will be chosen as a representative.

   [LIST_NAME <list name>]

      This parameter specifies the name of a list into which the attributes of the input features
      are stored. For example, if 3 input surfaces are dissolved into 1 surface, then that 1 surface
      would have a list with 3 entries, each containing a set of attributes from one of the 3 input
      surfaces.

   [LIST_ATTRS_TO_INCLUDE_MODE (ALL|SELECTED)]

      This parameter 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.

   [LIST_ATTRS_TO_INCLUDE [<attrNameToIncludeInList>]* ]

      This parameter specifies which attributes should be added to the list.

Output Tags

   The SurfaceDissolveFactory supports the following output tags.

   SURFACE

      Dissolved features are outputted here.

   REJECTED

      Rejected features are outputted here.