ATF Exporter Command Line Tool

Learn about the AtfToOsg converter options, how to set a path, as well as how to call the converter options.

Options List

Use -help to call up this list of AtfToOsg options:

  • --enable_invisible_instances=[true|false] - Enables the import of invisible instances/parts.

    Default: False

  • --enable_group_materials=[true|false] - Enables the import of materials applied to group nodes like part, assembly, or instance, If enabled, an additional MaterialGroup node is created for each of these materials. If disabled, simply discard these materials.

    Default: True

  • --enable_cameras=[true|false] - Enables the import of cameras.

    Default: False

  • --enable_lights=[true|false] - Enables the import of lights.

    Default: False

  • --enable_bookmarks=[true|false] - Enables the import of Alias bookmarks.

    Default: False

  • --enable_metadata=[true|false] - Enables the import of metadata.

    Default: True

  • --enable_colors=[true|false] - Enables the import of colors from 3D Manufacturing Format (3MF) files.

    Default: True

  • --enable_layer_folders=[true|false] - Enables the import of the Alias layer hierarchy.

    Default: True

  • --enable_empty_layers=[true|false] - Enables the import of empty layers.

    Default: False

  • --enable_assemblies=[true|false] - Enables the import of assemblies.

    Default: True

  • --enable_parts=[true|false] - Enables the import of parts.

    Default: True

  • --fix_surface_orientation=[true|false] - Enables the unification of surface normals.

    Default: True

  • --stitching_tolerance=<float value> - Sets the tolerance where two adjacent edges are considered to be touching and where they should be stitched together.

    Default: 0.1

  • --chord_deviation=<float value> - Provides the absolute chord deviation. This is the distance from the mid point on a tessellated edge to the geometry.

    Default: 0.1

  • --normal_tolerance=<float value> - Provides the normal tolerance in degrees. This is the allowed normal deviation between the normals on the ends of a tessellated edge.

    Default: 10.0

  • --max_chord_length=<float value> - Provides the absolute max chord length. This is the maximum length of a tessellated edge.

    Default: 200.0

  • --importer_version=<int value> - Sets the Dassault Systèmes Catia V5 importer version.

    0: Optimized lightweight importer

    1: Legacy importer

    Default: 0

Setting the Path

Save the following as a .bat file. Ensure that the Autodesk VRED license is pulled. The example below uses VREDPro-<internalVersion>; however, if you are running a different version, this will need to be changed to match your license. Also, the seiferp will need to be replaced with your user directory.

SET PATH=c:\Program Files\Autodesk\VREDPro-<internalVersion>\bin\WIN64;%PATH%
"C:\Program Files\Autodesk\VREDPro-<internalVersion>\Bin\WIN64\ATF\AtfToOsg.exe" -i C:\Users\seiferp\Desktop\AtfToOsg\AliasTruck.wire -o C:\Users\seiferp\Desktop\AtfToOsg\ConvertedTruck.osb

This is an example of how to run the command. When complete, your Autdesk VREDPro license is checked out.

  1. Open the Windows command shell cmd.exe

  2. Browse to the correct folders by doing the following: cd C:\Program Files\Autodesk\VREDPro-<internalVersion>\bin\WIN64

  3. Run this command: ATF\AtfToOsg.exe -i "C:\test\test.wire" -o "C:\test\test.osb", where:

    • -i is the definition of the input file

    • -o is the definition of the output file

    • .exe can write osg (Ascii) or osb (binary) files

      Note:

      As of Autodesk VRED 2015, OSGs are no longer supported.

Calling Converter Options with "-help"

Follow these instructions to run a command line file translation with the AtfToOsg.exe of Autodesk® VRED™. The most important thing to be able to use AtfToOsg.exe is setting the correct environment (=PATH).

SET PATH=<PathToVred>\VREDPro-<internalVersion>\bin\WIN64;%PATH%

Once this is done, AtfToOsg and VpbToCad can be used. For example, calling this to show the options for AtfToOsg, as in:

<PathToVred>\VREDPro-<internalVersion>\bin\WIN64\AtfToOsg.exe -help

The options can be used to define input files, output files, and options for converting the file, such as converting a file with/without metadata.

<pathToVred>\VREDPro-<internalVersion>\bin\WIN64\ATF\AtfToOsg.exe -i "<pathToInputFile>\InputFile.jt"-o "<pathToOutputFile>\OutputFileWithMetaData.vpb"--enable_metadata=true<pathToVred>\VREDPro-<internalVersion>\bin\WIN64\ATF\AtfToOsg.exe -i "<pathToInputFile>\InputFile.jt"-o "<pathToOutputFile>\OutputFileWithoutMetaData.vpb"--enable_metadata=false

For VpbToCad, a different approach is used to shorten/simplify the command line. A link must be passed to a .json file for the conversion settings. This means the documentation of the command line is simpler.

<pathToVred>\VREDPro-<internalVersion>\bin\WIN64\ATF\VpbToCad.exe -help

For exporting to Siemens Jupiter Tessellation (JT), the .json file has the following format:

{
    "ExportNativeMeshes": true,
    "ExportSurfaces": 0,
    "FileType": "JT",
    "version": 1
}

For exporting to 3D Manufacturing Format (3MF), the .json file has the following format and for the ExportSurfaces value, 0 = Keep surfaces, 1 = Convert Surfaces into meshes, 2 = Export Surfaces as surface and mesh, and 4 = Do not export surfaces.

{
    "ExportNativeMeshes": true,
    "ExportSurfaces": 0,
    "FileType": "3MF",
    "version": 1
}

To convert an Autodesk VRED VPB file, using VpbToCad, to an external format (at present, only Siemens Jupiter Tessellation (JT) and 3D Manufacturing Format (3MF) are supported), use the following command line:

\VREDPro-<internalVersion>\bin\WIN64\ATF\AtfToOsg.exe -i "<pathToInputFile>\InputFile.jt"-o "<pathToOutputFile>\OutputFileWithoutMetaData.vpb"--enable_metadata=false<pathToVred>\VREDPro-<internalVersion>\bin\WIN64\ATF\VpbToCad.exe -i "<pathToInputFile>\InputFile.vpb"-o"<pathToOutputFile>\OutputFile.jt"-c "<pathToJsonFile>\ConvertToJT.json"
Parent page: Python Documentation