FloorplanConfig

class Communicator.FloorplanConfig()

Allows customization of the FloorplanManager user interface and functionality.

Methods


Properties

Communicator.FloorplanConfig.autoActivate

Determines the conditions under which the floorplan will be auto-activated. (default: FloorplanAutoActivation.BimWalk

Communicator.FloorplanConfig.avatarColor

Determines the primary color of the avatar shown in the overlay. (default: Color(255,0,255))

Communicator.FloorplanConfig.avatarOpacity

Determines the opacity of the avatar. Valid values must be in the range [0, 1]. (default: 1.0)

Communicator.FloorplanConfig.avatarOutlineColor

Determines the outline color of the avatar shown in the overlay. (default: black)

Communicator.FloorplanConfig.avatarScale

Determines the scale-factor of the avatar. Valid values must be in the range [0.1, 10]. (default: 1.0)

Communicator.FloorplanConfig.backgroundColor

Determines the background color of the overlay window. (default: white)

Communicator.FloorplanConfig.backgroundOpacity

Determines the opacity of the overlay background. Valid values must be in the range [0, 1]. (default: 0.25)

Communicator.FloorplanConfig.borderColor

Determines the color of the overlay window border. (default: black)

Communicator.FloorplanConfig.borderOpacity

Determines the opacity of the overlay window border. Valid values must be in the range [0, 1]. (default: 1.0)

Communicator.FloorplanConfig.customAvatar

Setting this to a valid NodeId will allow for a custom avatar. To use a custom avatar, consider the following:

  • The overlay always draws in orthographic mode with the camera pointing down the Z axis from + to -. The avatar geometry is therefore assumed to be defined in the X/Y plane, with forward pointing in the positive Y direction.

  • The avatar is scaled under the assumption that its units are in feet and the actual camera-eye will correspond to 0,0,0 within the avatar geometry.

  • The FloorplanManager will take ownership of the custom node. The caller should not try to delete it, ever.

  • The custom node will survive across model changes.

  • The custom node will survive across any calls to deactivate

  • Any previous custom avatar node will be deleted when a new custom avatar is set.

  • Setting this to null will restore the default avatar.

  • The avatar background and outline colors/opacities will not be applied to a custom avatar. The user must set these manually as needed for any custom avatar. The custom avatar NodeId will not change and can thus be maintained by the user for setting node properties as needed.

(default: null)

Communicator.FloorplanConfig.fixedAvatarScale

When this is false, the avatar size will scale with the floorplan size. For large floorplans, the avatar may appear small. When this is true, the avatar will be the same size for all floorplans. (default: true)

Communicator.FloorplanConfig.floorplanOrientation

Determines the drawing orientation of floorplan and avatar. (default: FloorplanOrientation.NorthUp

Communicator.FloorplanConfig.overlayAnchor

The OverlayAnchor for the floorplan overlay window. See OverlayManager.setViewport (default: OverlayAnchor.LowerRightCorner

Communicator.FloorplanConfig.overlayFeetPerPixel

Determines the scale of the floorplan within the overlay window in terms of feet-per-pixel. This value is combined with zoomLevel to determine the overall display scaling. The intent is for this value to stay fixed after being set initially, while zoomLevel is used to easily change the zoom-level of the overlay

Communicator.FloorplanConfig.overlayHeightUnit

The OverlayUnit type for the overlaySize height. (default: OverlayUnit.ProportionOfOtherDimension

Communicator.FloorplanConfig.overlayOffset

The X/Y values used with OverlayManager.setViewport (default: 0, 0)

Communicator.FloorplanConfig.overlayOffsetXUnit

The OverlayUnit type for the overlayOffset x coordinate. (default: OverlayUnit.Pixels

Communicator.FloorplanConfig.overlayOffsetYUnit

The OverlayUnit type for the overlayOffset y coordinate. (default: OverlayUnit.Pixels

Communicator.FloorplanConfig.overlaySize

Determines the size of the overlay. See OverlayManager.setViewport for an understanding of how the size and OverlayUnit values are used. (default: 0.25, 1.0)

Communicator.FloorplanConfig.overlayWidthUnit

The OverlayUnit type for the overlaySize width. (default: OverlayUnit.ProportionOfCanvas

Communicator.FloorplanConfig.trackCameraEnabled

Setting this to true will move the floorplan with the camera to keep the avatar centered. When this is false, the floorplan will stay fixed in place, and the avatar will move.

Communicator.FloorplanConfig.zoomLevel

Sets the zoom level for the floorplan display. A value of 1.0 is the standard view. Values greater will zoom-in, while smaller values will zoom-out. Valid values must be in the range [0.1, 10]. (default: 1.0)

Methods

copy

Communicator.FloorplanConfig.copy()

Per-floor information.

Return type

Communicator.FloorplanConfig

Returns

Copy of this configuration object.