fmeobjects.FMEMultiSolid.setAppearanceReference

FMEMultiSolid.setAppearanceReference(appearanceRef, front)

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

An appearance reference of ‘0’ represents the default appearance. Intepretation of the default appearance if left to the consumer of this geometry. When set at this FMEMultiSolid level, the appearance to apply when the contained solids and surfaces use the default appearance instead of a specific appearance.

The second parameter controls whether this action should take place on the front of the contained surfaces or the back. Both can be set independently. This method returns true if the reference was found on the Library. If the reference was not found in the library, it will still attach the reference to the solid, but will return false. This is an unhealthy situation, as it represents a “dangling reference” and the user should decide to remedy this by either adding an Appearance with that exact reference to the Library, or else remove from this solid.

Parameters:

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

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

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.