Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

C4DtoA lets you save scenes to ASS or USD files. The scene export dialog can be accessed from the Arnold > Scene Export menu.

Center

 


The dialog shows Arnold related options and frame settings described below.

...

Scene Export from command line

Besides the above dialog, scene export can be executed from the command line as well via the -arnoldSceneExport parameter followed by the export options. Note that you have also use the -nogui parameter to disable the user interface.

For example, the following command exports frame range 10-20 of myscene.c4d to myscene.ass on Window:

Code Block
languagecpp
c:\Program Files\MAXON\CINEMA 4D R16\CINEMA 4D.exe -nogui -arnoldSceneExport "scene=c:\path\to\myscene.c4d;format=ASS;filename=c:\path\to\myscene.ass;startFrame=10;endFrame=20"

Note that the export runs in the background, therefore, you have no output in the console. You can redirect the output of the call to a file using the > directive:

Code Block
languagecpp
c:\Program Files\MAXON\CINEMA 4D R16\CINEMA 4D.exe -nogui -arnoldSceneExport "scene=c:\path\to\myscene.c4d;format=ASS;filename=c:\path\to\myscene.ass;startFrame=10;endFrame=20" > export.log 2>&1

The following options are available by the arnoldSceneExport parameter:

  • scene: path to the C4D scene file to export. This parameter is mandatory.
  • format: output file format, ASS or USD. If not specified, the plugin guesses the format from the file extension.
  • filename: path of the output .ass file. If not given .ass file is exported next to the c4d scene file.
  • compressed: if given the scene is exported directly to gzip-compressed files (.ass.gz).
  • asciiAss: if given values exported to a standard text format, if not given (default) binary encoding is used.
  • expandProcedurals: if given procedurals will be expanded before exporting the scene.
  • exportObjectHierarchy: if given the whole hierarchy (children) of the selected objects is exported.
  • mask: specifies which Arnold node types are included in the .ass export. See the AtNodeEntry page of the Arnold API for the available node types.
  • exportType: specifies which objects are exported. Possible values are:
    • 0: all
    • 1: selected
    • 2: selected individually
  • startFrame: specifies the start frame to be exported. When not given scene's render settings will be used.
  • endFrame: specifies the end frame to be exported. When not given scene's render settings will be used.
  • frameStep: specifies the increment between frames. When not given scene's render settings will be used.
  • camera: you can override active scene camera by this option by specifying the name of the camera. Note that camera names must be unique otherwise always the first camera with the same name is used. 

Multiexcerpt include
SpaceWithExcerptA5AFCUG
MultiExcerptNamescene_export
PageWithExcerptCommand line
 

Scene Export from script

Scene export is implemented as a command which means it can be called from scripts as well. using the CallCommand() function with id of 1029993. Export options can be defined via a document setting.

...

  • 0 (Filename) filename: path of the output .ass file. If not given .ass file is exported next to the c4d scene file.
  • 1 (Bool) | compressed: if true the scene is exported directly to gzip-compressed files (.ass.gz).
  • 2 (Bool) | bounding box: if true bounding box of the scene are added to the ASS meta data.
  • 3 (Bool) | binary: if true binary encoding is used.
  • 4 (Bool) | expand procedurals: if true procedurals will be expanded before exporting the scene.
  • 5 (Int32) | mask: specifies which Arnold node types are included in the .ass export. See the AtNodeEntry page of the Arnold API for the available node types.
  • 6 (Int32) | start frame: specifies the start frame to be exported. When not given scene's render settings will be used.
  • 7 (Int32) | end frame: specifies the end frame to be exported. When not given scene's render settings will be used.
  • 8 (Int32) | step frame: specifies the increment between frames. When not given scene's render settings will be used.
  • 11 (Int32) | export objects: specifies which objects are exported. Possible values are:
    • 0: all
    • 1: selected
    • 2: selected individually
  • 12 (Bool) | replace with Arnold Procedural: replaces the exported objects with an Arnold Procedural pointing to the ASS file.
  • 13 (Bool) | export object hierarchy: exports the whole hierarchy (children) of the selected objects.
  • 14 (Int32) | format: format of the output file. If not specified, the plugin guesses the format from the file extension. Available values are: 
    • 193450604: ASS
    • 193472369: USD

...