These settings refer to the command-line interface (CLI) version of RapidPBR, which is used for batch processing on local hardware or a virtual machine or via AWS.


-h, --help

Displays a help message and exits the program.


-i INPUTFOLDER, --inputFolder INPUTFOLDER

Root folder for input files.


We recommend that the output folder and the input folder should be completely separate directories - as in, one should not contain the other and vice versa.


If the input folder contains the output folder, any 3ds Max scene files contained in the output folder will be ignored during the input folder file gathering step of the process.


-o OUTPUTFOLDER, --outputFolder OUTPUTFOLDER

Root output folder for batch of converted files.


--additionalFormat

Adds more output formats. Possible formats: GLB, GLB-OPACITY, FBX, USDZ. Case insensitive. 


Output always consists of a glTF (a JSON file with references) and a Max file. Additional file types can be created if needed to help with importing into digital content creation (DCC) tools.  

  • GLB is the same as the glTF, except all references are packed into a single binary file. 
  • FBX will be output with a Physical Material. 
  • USDz will be saved with USDPreviewSurface material. 
  • GLB-Opacity is a binary glTF using Alpha instead of Transmission. 


It is important to note that outputs from RapidPBR can be very large, as these files are uncompressed to allow for manual editing and lossless importing into digital content creation (DCC) or compression tools. The files created by --additionalFormat are provided to help with importing into other tools. Files will need to be optimized for efficient end-user delivery and consumption; for that we recommend using a suitable tool like RapidCompact.


Multiple file formats can be provided to -f / --additionalFormat at once.

  • Example usage:
    • --additionalFormat usdz glb fbx
    • -f usdz glb fbx
    • If you want to generate additional glbs and FBXs, but no USDz files: -f glb fbx
    • If you only want to generate additional FBX files: -f fbx
  • **NOTE:**
    • glTF files in JSON text format are always generated, no matter the usage of this flag or not.
    • Providing the same format multiple times (e.g., -f fbx fbx or -f fbx -f fbx) has no additional effect.
    • Providing the flag multiple times (e.g., -f fbx -f glb) causes the last argument to prevail over all previous ones.


--bakeDisplacement

 VRayDisplacementMod can be converted into geometry. When disabled, displacement will be converted into normal maps. 


--benchmarkLevel {disabled,simplified,full}

 A spreadsheet can be generated of the time spent on each stage of conversion. 'Simplified' produces minimal measurements. 'Full' provides full benchmarking data. 


-c, --cleanUp

Cleans up output folder after every scene, leaving only final converted models.


--convertHair

Hair and Fur (WSM) modifier can be converted into geometry. When disabled, Hair and Fur (WSM) will be ignored.


--createMtlx

(Experimental, WIP) Creates MaterialX files, if provided and the dependency is installed.


--executablePath EXECUTABLEPATH

Override the DCC executable path. Recommended when multiple versions of a DCC are installed.


If you have multiple 3ds Max versions installed in your system, the use of the flag --executablePath is strongly encouraged both for the installation script and RapidPBR itself.


Note that, if multiple 3ds Max versions are identified and no executable path override was provided, RapidPBR will attempt to select the newest version.


If RapidPBR is attempted to be executed with a different 3ds Max version than the one it was installed for, either selected automatically or through the override, an exception will occur as there will be a mismatch in the virtual environment configuration.


If switching between different 3ds Max installations, you will need to rerun the RapidPBR installation script before executing with a different 3ds Max version.


--forceMaterialBaking

Forces material baking.


--generateOpacity

Generates additional outputs, converted if translated glTF originally has transmission, to a USDZ and a GLB with opacity.


--ignoreXRef

XRef meshes can be ignored. These are meshes being referenced in from other 3ds Max scene files.


--iorToMetalness

Generates a metalness map based on input material IOR.


When using this flag, RapidPBR will attempt to create base color and metalness textures from V-Ray reflection/refraction IOR values, depending on how each is set in the V-Ray material.

 

When a material provides a metalness map and this flag is set, RapidPBR will use the maximum value between the original metalness and the newly calculated one.

 

This flag is useful if materials are created with high IOR values to emulate the metallic effect, as is often seen in legacy workflows. 


A material with an IOR texture will automatically trigger this workflow, since glTF does not support textures for IOR. In this case, the flag does not need to be set. 


When the flag is not set, and there are some materials with IOR textures and other materials without them, the materials without IOR textures will not trigger this workflow. 


If assets follow the RapidPBR Material Guidelines, this flag is not needed. 


--logLevel {0,1,2,3,4}

Verbose level for logging messages from 0 (critical) to 4 (debug).


0 - CRITICAL: only fatal/program ending errors are shown

1 - ERRORS: only errors are shown

2 - WARNINGS: only errors and warnings are shown

3 - INFOS: errors, warnings and regular info messages are shown

4 - DEBUG: verbose mode, all information available is shown


--mergeByMaterial

Geometry nodes sharing the same material can be merged together. 


--prepareForCloud

Prepare the outputs for cloud consumption.


--renderPreview

Renders, through Rapid Compact, preview images of translated model.


--resolution RESOLUTION

Texture resolution can be overridden when baking materials. Possible values range from 256 up to 16384. If not set, RapidPBR will choose the resolution depending on the content, attempting to preserve details using the smallest possible resolution. 


-s RPDPSETTINGSFILE, --rpdpSettingsFile RPDPSETTINGSFILE

.JSON settings file for RapidPBR.


A valid JSON settings file of RapidPBR is a JSON file that contains five arrays: fileNameToIgnore, filePrefixToIgnore, fileSuffixToIgnore, nodesToIgnore, and materialsToIgnore. For example:

{
    "fileNameToIgnore":[
        "autobackup"
    ],
    "filePrefixToIgnore":[
        "recover"
    ],
    "fileSuffixToIgnore":[
        "lod"
    ],
    "nodesToIgnore": [
        "Shadow_Catcher"
    ],
    "materialsToIgnore": [
        "Stage",
    ]
}

In the example above:

  • Scenes with filenames containing the string "autobackup" will be skipped;
  • Scenes with filenames starting with the string "recover" will be skipped;
  • Scenes with filenames ending with the string "lod" will be skipped;

For the whole batch of scenes being executed, all nodes named "Shadow_Catcher" and all materials named "Stage" will be ignored/deleted from the scene.


Scenes with certain naming patterns can be ignored:

  • included in the middle of the name, "fileNameToIgnore"
  • included in the start of the name, "filePrefixToIgnore"
  • included in the end of the name, "fileSuffixToIgnore"

For example AutoBackup and Recovery scenes from 3dsMax, as well as duplicate scenes with different LODs, could be use cases for this feature.


Nodes with the exact names contained in "nodesToIgnore", and materials with the exact names contained in "materialsToIgnore", will be ignored by RapidPBR. This is useful, for example, if you have a recurring pattern of studio elements, such as a background, which you don't want to be included in your output files.


--verifyInstallation

Verify installation without processing any assets. Ends execution afterwards. 


When using the flag --verifyInstallation you may still provide the flags --logLevel, to define how much information you want to see, and --executablePath, to better define what 3ds Max executable you are using.