Preset/Mode Settings

The Settings files describe a set of preset-specific parameters and/or overwrite the ones defined in GlobalSettings. Files settings_0-9 correspond to 10 presets available at keys 0-9 on a keyboard/keypad. When touchscreen control is activated, the application loads settings_mode_0-3 files. Those correspond to the four modes of the app.

Values in bold are recommended ones and can be used as a reference. They are set in the files by default. Values in [brackets] describe the possible range.

Parameters that are by default defined in the GlobalSettings file are described in the previous article. They will be listed here with a right annotation.

Description:

“UseGlobal”: true, – This lane states that the global value of a parameter is used [true, false]; change to ‘false’ to overwrite;

“Value”: 0 – Default when using global values; enter the right value here when overwriting; value range for individual parameters can be found in the previous article;


“Mode”: 0 – Application module [0 – Interactive Map, 1 – GraviBall, 2 – MagicWorlds, 3 – DigQuest, 4 – SandscapeSecrets]; in a setup with touchscreen there will be 4 settings_mode_ files, each for a different module; in a setup without touchscreen you can freely assing the 4 modules to the 10 available preset settings_ files;


“TargetFPS”:By default in GlobalSettings;

“RefreshRate”:By default in GlobalSettings;

“TerrainBottomLevel”:By default in GlobalSettings;

“TerrainTopLevel”:By default in GlobalSettings;

“TerrainMinLevel”:By default in GlobalSettings;

“TerrainMaxLevel”:By default in GlobalSettings;

“Walls”: {
“Right”: ,
“Left”: ,
“Top”: ,
“Bottom”:
}
By default in GlobalSettings;

“WaterDropOffset”: By default in GlobalSettings;

“SandboxTopLevel”: By default in GlobalSettings;

“SandboxBottomLevel”: By default in GlobalSettings;


INTERACTIVE MAP

Parameters listed below apply to the Interactive Map module; they should be defined in settings_mode_0 file;

“ColorsPalette”: “1_complex/00_colors_realhipso.txt” – Colour scale palette – name of the file from folder: KinectSandbox\KinectSandbox_Data\ StreamingAssets\Colors; the default colour palette ‘1_complex/00_colors_realhipso.txt‘ is the hypsometric scale; you can create your own files according to the pattern;

“TerrainTopoLines”: true – Contour lines on/off [true, false];

“TerrainSmoothColors”: false – Colours blending on/off [true, false]; when set to ‘true’ the transitions between colour regions become smoother – in combination with contour lines switched off this can help achieve a more natural look;

“OverlayImage”: “0_maps/00_castles.png”, – Transparent image projected on top of the map – name of the file from folder: KinectSandbox\KinectSandbox_Data\ StreamingAssets\OverlayImages; you can upload your own images – they will be scaled to the size of your sandbox, so try to keep the same resolution (1920×1080 all models except Large Standalone – 1920×1200; your projector native resolution)to avoid quality losses and distortions; mind the naming pattern;

“OverlayImageActiveByDefault”: false – Turns on/off the overlay image visibility [true, false];

“WaterSettings”: {
“DrainMin”: 0.0, – Speed at which liquid is drained into the surface – minimum value available on the touchscreen control;
“DrainMax”: 150, – Speed at which liquid is drained into the surface – maximum value available on the touchscreen control;
“DrainValue”: 0.0, – Actual value of the speed at which liquid is draining into the surface;
“DropSizeMin”: 0.0, – Minimum value available on the touch screen;
“DropSizeMax”: 10.0, – Maximum value available on the touch screen;
“DropSizeValue”: 10.0, – Actual value of the amount of liquid dropped by waving the hand over the sandpit;
“WaterMaterialIndex”: 0, – Type of the fluid [0..6];
“WaterActiveByDefault”: true, – Is water activated by default on application start [true,false];
“WaterStaticLevel”: 4.80000114440918, – The amount of water dropped using the flood button [0..10];
“SetStaticLevelOnStart”: false – Flood area on start [true,false];
},


GRAVIBALL

“GameSettings”: Parameters listed below apply to the GraviBall mode; they should be defined in settings_mode_1 file;

“ElementsScaleFactor”: 1.0 – Scale models for the best experience

“LevelScaleFactor”: 1.0; – Scale game size to match sandpit size


MAGIC WORLDS

“ParadiseIslandSettings”: – Parameters listed below apply to the Magic Worlds mode; they should be defined in settings_mode_2 file;

“NormalizedWaterLevel”: 0.40 – Absolute water level [0.00-1.00]; independent from ‘TerrainBottom/TopLevels’; value 0.00 results in no water, value 1.00 results in water all over land;

“WaterSoft”: 0.47 – Water texture visibility [0.00-2.00]; also affects water colour;

“MinWaterColor”: 0.11 – Water clarity, or ‘blueness’ [0.00-2.00]; lower numbers give a more transparent look of shallow waters, higher numbers give an impression of deep abyss;

“WindDirection”: 60.0 – Direction the wind blows in; value is based on a 360 degree scale [0.0-360.0];

“WindPower”: 0.20 – Force of the wind [0.00-2.00];

“VolcanoEnabled”: false, – Activate volcano mode, when you make a hill and dig a hole on top of it, a volcano crater with lava should appear.

“CrabsEnabled”: false, – Enable mini crab game, stones appear – when you grab stone little crab is running

“CrabLifetime”: 10.0, – Time the crab runs on the ground before hiding in the sand

“CrabStoneLifeTime”: 15.0, – Time of stone existence

“CrabStoneDisappearDelay”: 3.0,

“ScaleFactor”: 1.0 – Scale models for the best experience


DIGQUEST

“ArcheologySettings”: – Parameters listed below apply to the DigQuest mode; they should be defined in settings_mode_3 file;

“LevelingPrecision”: 0.005 – States how precisely the terrain has to be levelled [0.001-0.010]; lower numbers mean higher precision;

“LevelingTarget”: 0.70 – Portion of terrain that has to be levelled to start digging process [0.01-1.00];

“DiggingPrecision”: 0.002 – States how precisely the item has to be excavated [0.001-0.010]; lower numbers mean higher precision;

“DiggingTarget”: 0.80 Portion of item that has to be excavated to finish the task [0.01-1.00];

“DiggingAreaOffset”: 4.00, – The parameter describes the amount of sand above the model (how deep you have to dig to see the model);

“ElementsScaleFactor”: 1.00 – Allows for scaling the hidden objects to match the size of the sandpit [0.01-3.00];

“ThicknessScaleFactor”: 1.00 – Allows for changing the thickness or ‘depth’ of the hidden object to match the depth of the sandpit [ [0.01-3.00];


SANDSCAPE SECRETS

“FadeSettings”: – Parameters listed below apply to the Sandscape Secrets mode; they should be defined in settings_mode_4 file;

DefaultLayers“: “3_Faces”, – Name of the folder that contains the default images;
Size“: 36.880027770996097, – Scale of the texture;
OffsetX“: 0.9500000476837158, – Texture offset X;
OffsetY“: 0.5199999809265137 – Texture offset Y;