Wavefront OBJ Writer Parameters

Note that not all formats offer all the options described below.

• Yes: Coordinates of all the points in the written features will be normalized to the interval [-0.5, 0.5] on the largest side of their XYZ-bounding cube. The other dimensions will be scaled proportionally.

Additionally, the transformation matrix required to scale the model back to world coordinates will be written to a companion .fwt file. This can be used to improve precision of the written coordinates. The companion .fwt file will have the same name as the primary data file and will be written in the same folder. For folder-based formats, the file global.fwt will be written instead.

• No: The original coordinates will be written as provided. Coordinates will not be projected; .fwt world and .prj files will not be generated.
• Create Projection File Only: A companion .prj file containing the coordinate system and having the same name as the primary data file will be written in the same folder. For folder-based formats, the file global.prj will be written instead. Coordinates will not be projected and a world file will not be generated.
• Transform Coordinates Only: Transforms the coordinates as in the Yes option, but companion .prj and .fwt world files will not be generated.

This option forces faces and lines to be written in a reverse order. This option is useful when faces are all back-faced when rendering only the front side, and you need to reverse all faces.

This option forces faces to be broken into triangles. This option is useful when faces are required to be triangles or convex for a particular OBJ viewing application.

Donuts and concave faces are always triangulated, regardless of this parameter's setting.

Note: Some obj viewer applications do not correctly handle concave faces.

Controls whether the writer includes points and lines when writing to the output file. When this is set to 'No', point and line features will be silently dropped. Some applications do not render points and lines and others do no accept the file if it contains them (for example, Autodesk 3ds Max).

Check this box to enable material library file handling.

When Handle Material File is checked, this option specifies a full path to an .mtl file to use as the Material Library (mtllib) when creating an .obj file during writing. Leave this blank if you do not have an existing material library or do not use materials in your obj model.

Note: Some obj viewer applications have been known to require that there are no spaces in the material file name.

When Handle Material File is selected, this parameter specifies how the material library (.mtl) file is referenced during writing:

Relative: References the .mtl file relative to the obj file. In this case, the mtl file will need to be placed in a folder that is relative to the obj file being created. The mtllib directive in the obj file will reference the mtl file using a relative path.

Copy: Makes a copy of the .mtl file and places it in the same folder with the .obj file. The mtllib directive in the obj file will reference this copy with no folder in the .mtl path reference.

Note: This option will copy the .mtl file. However, if there are additional files referenced from the .mtl file such as texture files, they will not be copied and will need to be manually copied.

Absolute: References the mtl file using a absolute location. The mtllib directive in the obj file will reference the template file using an absolute path.

Note: The Absolute reference will use the mtl file name as specified in the Material Library File field above, which should itself specify an absolute path to the .mtl file.

Specifies the preferred format for associated texture files. This preference will be used as long as the specified format supports the properties of the texture raster; if not, it will be overridden.

In the default Auto mode, the writer chooses the best representation based on the incoming texture raster.

If the preferred format is ignored, a message is added to the log file. Possible reasons that the preference will be ignored include a lack of raster palette support, alpha channel support, or color depth support in the selected format.

When set to Yes (the default), the writer creates a comment line specifying the FME version that was used to create the resulting output .obj file.

Setting this parameter to No is useful for supporting regression tests.