Reader Directives

The directives processed by the OBJ reader are listed below. The suffixes shown are prefixed by the current <ReaderKeyword> in a mapping file. By default, the <ReaderKeyword> for the Obj reader is OBJ.

DATASET

Required/Optional: Required

The value for this directive is the path to the obj file.

OBJ_DATASET /usr/data/obj/teapot.obj

Workbench Parameter: Source Wavefront OBJ File

MOVE_TO_WORLD_COORDSYS

Required/Optional: Optional

Possible values are 'Yes' and 'No' with default value being 'No'. If the value is 'Yes', the companion ‘.prj’ and ‘.wld’ files (having the same name as the ‘.obj’ file) will be read in order to acquire the coordinate system and the data necessary in order to convert points to the world coordinate system. Note that in the absence of a companion ‘.wld’ file with the same name as the ‘.obj’ file, a file named ‘global.wld’ will be looked for in the same folder. Similarly for the companion ‘.prj’ file, only in that case we will only look for a file named ‘global.prj’.

Workbench Parameter: Move to World Coordinate System

MERGE_MESH_PARTS

If the value is Yes, the group name, object name, and smoothing group information will be lost for each face in the source file, and the corresponding FME feature will contain only one mesh that contains all of the faces from the source file. This results in a more efficient representation of the data if the user does not wish to keep the additional face information.

The OBJ writer will maintain this information so it is recommended to leave this option set to "No" for OBJ to OBJ translations. If the value is set to 'No', in the case that multiple group names, object names or smoothing groups are used, this information will be preserved as traits on multiple meshes containing faces that have been grouped by these values.

Values

Yes | No (default)

Workbench Parameter

Merge Mesh Parts

SEARCH_ENVELOPE

Using the minimum and maximum x and y parameters, define a bounding box that will be used to filter the input features. Only features that interact with the bounding box are returned.

If all four coordinates of the search envelope are specified as 0, the search envelope will be disabled.

Mapping File Syntax

<ReaderKeyword>_SEARCH_ENVELOPE <minX> <minY> <maxX> <maxY>

Note: If all four coordinates of the search envelope are specified as zero, the search envelope will be disabled.

Required/Optional

Optional

Workbench Parameter

Minimum X, Minimum Y, Maximum X, Maximum Y

SEARCH_ENVELOPE_COORDINATE_SYSTEM

This directive specifies the coordinate system of the search envelope if it is different than the coordinate system of the data.

The COORDINATE_SYSTEM directive, which specifies the coordinate system associated with the data to be read, must always be set if the SEARCH_ENVELOPE_COORDINATE_SYSTEM directive is set.

If this directive is set, the minimum and maximum points of the search envelope are reprojected from the SEARCH_ENVELOPE_COORDINATE_SYSTEM to the reader COORDINATE_SYSTEM prior to applying the envelope.

Required/Optional

Optional

Mapping File Syntax

<ReaderKeyword>_SEARCH_ENVELOPE_COORDINATE_SYSTEM <coordinate system>

Workbench Parameter

Search Envelope Coordinate System

CLIP_TO_ENVELOPE

This directive specifies whether or not FME should clip features to the envelope specified in the SEARCH_ENVELOPE directive.

Values

YES | NO (default)

Mapping File Syntax

<ReaderKeyword>_CLIP_TO_ENVELOPE [yes | no]

Workbench Parameter

Clip To Envelope