Syntax

   @ExtractPointCloudProperties(
      [REJECTABLE],
      <attribute prefix>, 
      <existence component list>,
      <retrieve min/max component list>
      [, <update extents>
      [, <normalize color>]])

   @ExtractPointCloudProperties(
      [REJECTABLE],
      V2,
      <attribute prefix>, 
      <existence component list>,
      <property component list>,
      <retrieve min/max component list>
      [, <update extents>
      [, <extract transformation matrix>]])

   @ExtractPointCloudProperties(
      MODIFICATION_PROPERTIES)

Arguments

   REJECTABLE

      Specifies if the function will supply a rejection code and message
      to the invalid feature and output it to the rejected port, or will
      fail upon being supplied invalid features.

      A feature can be rejected for the following reasons:
         - The feature has invalid geometry

   <attribute prefix>   
   
      The prefix to add to attributes related to point cloud components.
   
      Range: String  
      
   <existence component list> 
   
      A space-delimited list of component names. An attribute indicating whether 
      the component exists in the point cloud will be added to the feature for 
      each component in the list.

   <property component list>

      A space-delimited list of component names. Attributes containing
      component properties will be added to the feature for each component
      in the list.
      
   <retrieve min/max component list>   
   
      A space-delimited list of component names. Attributes containing the 
      minimum and maximum values of the component will be added to the feature 
      for each component in the list.
      
   <update extents>  

      Whether to update the extents (x, y, z) of the point cloud.

      Range: UpdateExtents | DoNotUpdateExtents   

   <normalize color>

      Whether to normalize extracted color values.

      Range: NormalizeColor | DoNotNormalizeColor

   <extract transformation matrix>

      Whether to extract the transformation matrix of the point cloud. If enabled,
      attributes _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L will be added to
      the feature.

      Range: ExtractTransformationMatrix | DoNotExtractTransformationMatrix

Description

   The @ExtractPointCloudProperties function is used to expose the properties of 
   a point cloud as attributes on the feature.

   In the "normal" modes (i.e. "V1" or "V2"), the following attributes will
   always be added to the feature:

      _num_points

   For the "V1" version of this function (i.e. it does not start with the "V2"
   parameter), the following additional attributes will always be added:

      _min_x
      _min_y
      _min_z
      _max_x
      _max_y

   For each attribute listed in <existence component list>, a boolean attribute
   with the name _<component name> will be added to the feature with a value of
   TRUE if component exists in the point cloud and FALSE if it does not exist.

   For example, if the point cloud contains a classification component, the 
   _classification attribute will be added to the output feature with a value of 
   TRUE. If the point cloud does not contain a classification component, the 
   _classification attribute will be added to the output feature with a value of 
   FALSE. 

   Note that for all of the above attributes, if a value was specified for 
   <attribute prefix>, then this will be prepended to the name of the attribute. 
   For example, with an attribute prefix of "_pc", the attribute 
   _pc_classification would be added.

   For each attribute in the <property component list>, the following attributes
   will be added to the feature:

      _<component>_type
      _<component>_scale (numeric components only)
      _<component>_offset (numeric components only)
      _<component>_encoding (string components only)

   For each attribute listed in <retrieve min/max component list>, a pair of the 
   following attributes will be added to the feature. The value of the _min 
   attributes will be the minimum value for that component in the cloud. The 
   value of the _max_ attributes will be the maximum value for that component in 
   the cloud. The prefix specified in the Component Attribute Prefix parameter 
   will be inserted between the _min_ and the component name. If the specified 
   component does not exist in the cloud, the attribute will not be output.
   
      _min_<component> _max_<component>
   
   The <update extents> parameter controls whether the extents of the point 
   cloud will be updated to reflect the true values in the point cloud. That is, 
   the extents of a point cloud may change after certain operations (e.g. 
   clipping). When this happens, the extents are typically set to an 
   approximation of the true bounds (e.g. when clipping, the output point cloud 
   bounds are equal to the intersection of the input point cloud bounds and the 
   clipper bounds). When this option is set to UpdateExtents, all the points of 
   the point cloud will be read, and the point cloud extents will be updated to 
   their exact values.

   The <normalize color> parameter specifies whether extracted color values
   should be normalized (i.e. scaled to the range [0,1]). Valid values are
   NormalizeColor and DoNotNormalizeColor.

   The <extract transformation matrix> parameter specifies whether the transformation matrix values
   should be extracted as attributes. Valid values are ExtractTransformationMatrix and
   DoNotExtractTransformationMatrix. If enabled, attributes _A, _B, _C, _D, _E, _F, _G, _H, _I, _J,
   _K, _L will be added to the feature.

   In "MODIFICATION_PROPERTIES" mode, none of the above attributes are added.
   Instead, only the following attributes are added:

      _source_format
      _source_dataset
      _modified