API Reference › Globals › CommonInitData
# Interface: CommonInitData
Init data parameter which can be used in configurator AND planner
# Hierarchy
CommonInitData
# Implemented by
# Index
# Properties
- _measureTraffic
- autoQuality
- colors
- debug
- disableEnvMap
- id
- isItem
- meshSelection
- offset
- precisionCm
- precisionInch
- preloadHint
- preloadId
- showArButton
- startTag
- stats
- typeChangeTag
- unit
- unitStringType
- usePriceService
- useRoomlePrice
# Properties
# Optional _measureTraffic
• _measureTraffic? : boolean
Defined in packages/common-core/src/utils/shims.ts:169
internal
Enable service worker which tracks performance and request size (content, materials, etc)
# Optional autoQuality
• autoQuality? : boolean
Defined in packages/common-core/src/utils/shims.ts:70
If set to true the configurator will make sure every device has great user experience with fluid frame rate. If set to false the configurator will always show the highest quality possible. That could lead to stutter and other problems on low-end devices. We advise you to only turn off "autoQuality" if you really know what you are doing. default: true usage: autoQuality=false
# Optional colors
• colors? : typeof ROOMLE_COLORS
Defined in packages/common-core/src/utils/shims.ts:72
Can be used to personalize colors used in the 3D scene
# Optional debug
• debug? : boolean
Defined in packages/common-core/src/utils/shims.ts:175
This flag enables:
- Scripter debug logs (e.g. which parameter is not assigned to a parameter group)
- Free camera movement (no restrictions, camera stays after reload, panning using Shift key)
# Optional disableEnvMap
• disableEnvMap? : boolean
Defined in packages/common-core/src/utils/shims.ts:185
internal
If set to true, it will disable the environment map completely
# Optional id
• id? : RapiId
Defined in packages/common-core/src/utils/shims.ts:85
The item id or configuration id of the item which should be loaded. Examples: Configuration id: usm:frame:2449773A7F54278EBB61A67A10EF6A10E8BB6F38BE775B028AC050B438414507 Item id: usm:frame
# Optional isItem
• isItem? : boolean
Defined in packages/common-core/src/utils/shims.ts:78
deprecated
Set if the currently loaded id is an item or a configuration.
In the new configurator UI this is determined automatically based on the id.
# Optional meshSelection
• meshSelection? : boolean
Defined in packages/common-core/src/utils/shims.ts:162
When mesh selection is enabled, the meshes of the object are used directly for highlighting. Setting it to false could be useful for square/rectangular (shelf) items.
# Optional offset
• offset? : CanvasOffset
Defined in packages/common-core/src/utils/shims.ts:152
deprecated
Change the offset of the camera. For example if you add a margin left (0.1 means 10%) then
the item moves to the right.
This value is overridden in the new configurator UI.
# Optional precisionCm
• precisionCm? : string
Defined in packages/common-core/src/utils/shims.ts:122
Set how many positions after the decimal point should be shown. For example: 123,45 -> precisionCm=2 -> 123,45 123,45 -> precisionCm=1 -> 123,5 123,45 -> precisionCm=0 -> 124
# Optional precisionInch
• precisionInch? : string
Defined in packages/common-core/src/utils/shims.ts:114
Set how many positions after the decimal point should be shown. For example: 8' 1.68" -> precisionCm=2 -> 8' 1.68" 8' 1.68" -> precisionCm=1 -> 8' 1.7" 8' 1.68" -> precisionCm=0 -> 8' 2"
# Optional preloadHint
• preloadHint? : RapiId
Defined in packages/common-core/src/utils/shims.ts:145
deprecated
internal
Same as preloadId, both call getPreloadForItem or getPreloadForConfiguration to pre load things needed
for the configuration so that there are less XHR calls and the cache is pre-warmed
Will no longer be used in the new configurator UI.
# Optional preloadId
• preloadId? : RapiId
Defined in packages/common-core/src/utils/shims.ts:93
deprecated
internal
Same as preloadHint, both call getPreloadForItem or getPreloadForConfiguration to pre load things needed
for the configuration so that there are less XHR calls and the cache is pre-warmed
Will no longer be used in the new configurator UI.
# Optional showArButton
• showArButton? : boolean
Defined in packages/common-core/src/utils/shims.ts:99
deprecated
Set if the AR button should be shown.
In the new configurator UI this is in the configurator settings object called buttons.
# Optional startTag
• startTag? : RapiId
Defined in packages/common-core/src/utils/shims.ts:157
deprecated
Add a tag id which is used to show different variations when opening the configurator
# Optional stats
• stats? : boolean
Defined in packages/common-core/src/utils/shims.ts:164
if set to true it shows a little overlay with performance stats
# Optional typeChangeTag
• typeChangeTag? : RapiId
Defined in packages/common-core/src/utils/shims.ts:137
Add a tag id which is used to show different variations for the current item/configuration
# Optional unit
• unit? : string
Defined in packages/common-core/src/utils/shims.ts:127
Defines which unit should be used for measurements/dimensions Options: 'cm', 'mm', 'inchfeet'
# Optional unitStringType
• unitStringType? : string
Defined in packages/common-core/src/utils/shims.ts:135
How the current unit should be formatted Options: 'none': No unit string added, for example '200' 'long': Long unit string, for example '200 meters' 'short': Short unit string, for example '200 m'
# Optional usePriceService
• usePriceService? : boolean
Defined in packages/common-core/src/utils/shims.ts:180
If set to true, prices are calculated using the Roomle price service. For more information ask your Roomle contact.
# Optional useRoomlePrice
• useRoomlePrice? : boolean
Defined in packages/common-core/src/utils/shims.ts:106
internal
deprecated
Use prices which are hardcoded in the configuration script.
Only used for trade show demos.