rdla_filter

rdla_filter is a command line tool that parses an rdla file using various options and writes out a new one. Its main use is in debugging complex scenes where it can be used to reduce the scene to a minimal reproducable case of a bug.

Command-line options

Use the -h flag to display the full list of command-line options.

Usage: rdla_filter [options] <input rdla file> <output rdla file>

   Required arguments:

           <input rdla file>   - Input rdla file to read and filter

           <output rdla file>  - Output filtered rdla file


Filters the assets in an rdla file.   Keeps only selected assets and their
dependents grouping them together in a logical and easy to follow ordering.
The scene variables, camera, layer, are retained in the output.   Other object
types are also retained based on the selected options.

Options:
  -h, --help            show this help message and exit
  --assets-to-keep=ASSETSTOKEEP
                        Space separated list of asset names to keep.  Use
                        quotes for multiple assets.  The asset names should be
                        the names of the geometry objects assigned in the
                        Layer of the input rdla file.  The full path can be
                        used, just a portion of it, or a regular expression
                        which could match multiple objects.
  --binary-split=BINARYSPLIT
                        Keep only half of the layer assignments.  A value of 0
                        keeps the first half and a value of 1 keeps the second
                        half
  --skip-identity       Skips writing node_xform parameter if its value is
                        identity
  --skip-default        Skips writing parameter if its value is the same as
                        the default value
  --replace-enums       If parameter is an enumerated list, replace integer
                        value with string
  --add-param-comments  Add help comments under parameters
  --add-reference-comments
                        Add comments above objects showing which objects
                        reference them
  --remove-xform-blur   Removes use of the blur() function on the node_xform
                        and keeps only the first motion step
  --round-values=ROUNDVALUES
                        Round float, Vec2, Vec3, and Rgb types to the
                        specified decimal place
  --use-variable-names  Assigns each object to a variable and refers to this
                        instead of the full name
  --replace-materials   Replaces all materials with DwaEmissiveMaterial
  --skip-metadata       Skips writing the MetaData object
  --skip-lights         Skips writing out lights
  --skip-render-outputs
                        Skips writing render outputs
  --skip-user-data      Skips writing user data
  --split-data=SPLITDATA
                        Splits data lines (i.e. Vec3, Vec2, Rgb vectors)
                        longer than the specified length
  --nice-and-clean      Applies the following options: --skip-identity,
                        --skip-default, --replace-enums, --round-values 5
  --minimal             Applies the following options: --nice-and-clean,
                        --replace-materials, --skip-lights, --skip-render-
                        outputs, --skip-user-data, --skip-metadata