fmeobjects.FMEMultiSurface.setAppearanceReference

FMEMultiSurface.setAppearanceReference(appearanceRef, front)

This method associates an appearance within the Library with this multisurface. This is done by passing in the unique appearance reference for this appearance. Subsequent calls to this method on the same side, will override the previous appearance used with the new appearance passed in.

An appearance reference of ‘0’ represents the default appearance. Interpretation of the default appearance is left to the consumer of this geometry. When set at this FMESurface level, the appearance represents the default appearance to apply when the contained multisurfaces use the default appearance instead of a specific appearance. Contained multisurfaces may be found within nested multisurfaces, geometry instances that reference geometries containing multisurfaces, or as multisurfaces or multi-multisurfaces.

The second parameter controls whether this action should take place on the front of the contained multisurfaces or the back. Both can be set independently. The appearanceRef should be a valid reference to a definition stored in the FMELibrary. If the reference was not found in the library, it will still attach the reference to the instance, but will throw a FMEException. This is an unhealthy situation as it represents a ‘dangling reference’.

Parameters:

• appearanceRef (int) – The unique appearance reference for this appearance.

• front (bool) – Boolean indicting whether the appearance reference should be set for the front or back of the multisurface.

Return type:

None

Raises:

FMEException – An exception is raised if an error occurred or the reference was not found in the library and a dangling reference was attached.