APM configuration file (cfg_apm)
- Last UpdatedJan 20, 2025
- 4 minute read
The behaviors of the APM module and the interface look and feel can be customized by the fields exposed in its configuration file.
The cfg_apm configuration file is divided into sections. Each section is dedicated to a specific area.
apm

|
Parameter |
Type |
Description |
|---|---|---|
|
apm |
group |
This file is designed to enable configuration of most of the application settings. |
|
graphicContext |
sstring |
Graphic context to load. |
general

|
Parameter |
Type |
Description |
|---|---|---|
|
general |
group |
This section contains the main application scope configuration settings. |
|
assetKeys |
sstring |
List of supported asset names. Entries in the list must match the content configured in the project. |
|
defaultAssetKey |
sstring |
Name of the asset to display as default. |
|
defaultType |
sint |
Defines which mode is selected at startup. Index refers to buttons list. |
|
defaultUserName |
sstring |
Default user name. |
|
showSplashScreen |
sbool |
Show initial splashscreen. |
|
splashScreenImage |
sstring |
Name of image with relative path and extension (example: user/myImage.png where the PNG is placed inside Menutexture/user/ folder). This image displays in full-screen at application launch. The file must be in PNG format and placed in GameData/Menutexture or GameData/Textures folder. |
|
cameraNear |
sfloat |
The default camera near. If set to zero, the value is inherited from each camera node. |
|
showGrid |
sbool |
Shows the grid. |
|
showCompass |
sbool |
Shows the compass. |
interaction

|
Parameter |
Type |
Description |
|---|---|---|
|
interaction |
group |
This section is used to calibrate application gesture sensitivity and selection behavior. |
|
dragSensitivity |
sfloat |
Drag sensitivity. |
|
zoomSensitivity |
sfloat |
Zoom sensitivity. |
|
selection |
group |
This section is used to configure the selection behavior of the Discover functionality. |
|
style |
senum |
Specifies the style of overlaid markers for selected meshes:
Filler and silhouette_noZ can be combined together as silhouette_noZ_filler. |
|
silhouette |
This section is used to configure the silhouette aspect. |
|
|
color |
Color of the silhouette. |
|
|
alpha |
Transparency of the silhouette, where 0 is completely transparent and 1 is totally opaque. |
|
|
fill |
This section is used to configure the fill aspect. |
|
|
color |
Color of the fill. |
|
|
alpha |
Transparency of the fill, where 0 is completely transparent and 1 is totally opaque. |
blink

|
Parameter |
Type |
Description |
|---|---|---|
|
blink |
group |
This section is used to configure the mesh blinking effect. |
|
style |
senum |
Makes fill and silhouette blink with the blink color, according to selection.style setting. Note that fill and silhouette will display only if the interaction.selection.style enables them. Available options are:
|
|
intensity |
sfloat |
Blink intensity. Represents the blink oscillation height. |
|
intensityBase |
sfloat |
The base value for the blink intensity. The value must be equal or higher than value of intensity. |
|
length |
sfloat |
This parameter represents the blink oscillation time. |
|
color |
scolor3 |
Blink color. This color is overwritten to the selection silhouette and/or fill colors if they blink. |
menu

|
Parameter |
Type |
Description |
|---|---|---|
|
menu |
group |
This section is used to configure the menu toolbar. |
|
buttonNumber |
sint |
Number of supported buttons. |
|
hOffset |
sint |
Button horizontal offset. |
|
brandImage |
sstring |
To brand the application, you can provide an image to the project and set its name here. |
colorPalette

|
Parameter |
Type |
Description |
|---|---|---|
|
colorPalette |
group |
This section is used to change the color palette of the application. |
|
bgColor |
scolor3 |
Main background color. |
|
secondaryBgColor |
scolor3 |
Secondary background color. |
|
labelColor |
scolor3 |
Back color used for mesh labels. |
|
highlightColor |
scolor3 |
Color used for highlighted and selected elements. |
|
buttonColor |
scolor3 |
Settings for object selection outlines. |
|
secondaryButtonColor |
scolor3 |
Color used for discovery items. |
|
scrollbarColor |
scolor3 |
Scrollbar color. |
|
textColor |
scolor3 |
Color used for the text. |
|
arrowpointerColor |
scolor3 |
Color used for the AR arrow pointer. |
2Dpointer

|
Parameter |
Type |
Description |
|---|---|---|
|
2Dpointer |
group |
Arrow pointing at selected object in Discover. |
|
disappearingDistance |
sfloat |
Cosine of the angle between camera forward and selected object under which the arrow will display. When the camera points at the object, cos of the angle will be 1, lowering down as the camera diverges from that direction. |