FME Augmented Reality (AR) Reader/Writer

The FME Augmented Reality (AR) Reader/Writer enables FME to access FME AR files. These files can be loaded into the FME Augmented Reality app on certain iOS and Android devices.

Overview

An FME AR file consists of a package of several OBJ and Material files that define a collection of 3D geometries that can be displayed using the FME Augmented Reality (AR) app.

FME AR files always contain three-dimensional geometry. Two-dimensional data will be represented with one of the coordinates (usually y or z) being 0.0 for all geometry.

Reader Overview

The FME AR reader produces FME features for geometry data in an FME AR file. The FME AR reader extracts all the geometry in an FME AR archive and then presents the elements one at a time to FME for further processing. Each .obj asset in the file will create an FME feature type and produce a single feature.

The value for the Reader Dataset is the path to the FME AR file.

Writer Overview

The writer creates and writes feature data to an .fmear file.

An existing .fmear file in the folder is overwritten with the new .fmear file with the same name. If the .fmear file cannot be written, the translation fails.

The value for the Writer Dataset is the path to the output file.

Each feature type written to an FME AR writer will create a separate asset within the output .fmear file. Texture and material information will be combined into a single material library, and all texture sources will also be packaged into the .fmear.

Feature type fanout is supported.

Coordinate System Projection

If the FME AR writer receives features with coordinate systems, it reprojects the data into the azimuthal equidistant projection (AZMED). The writer reprojects the entire model – not feature by feature or feature type by feature type.

Note: The AZMED projection ensures that all points on the map are at proportionally correct distances from the center point, and all points on the map are at the correct azimuth from the center point. In an AZMED projection, the Y axis points to the north, and the X axis points to the east. If the model rotation is important when loading in the FME AR app, you should ensure that the axes are correct.

If the FME AR writer receives data that does not have a coordinate system, it first assumes the data is in meters, and then also reprojects the data into AZMED (which means the model is shifted so that 0,0 is in the center of the model).

Terminology in this Chapter

Term

Definition or FME Representation

Anchor feature

Feature that contains an fmear_anchor_feature attribute.

FME AR file

A package of several OBJ and Material files that define a collection of 3D geometries that can be displayed using the FME Augmented Reality app.

Reader Dataset

The path to the FME AR file.

Writer Dataset

The path to the output file.