Settings
Adapt CaveRenderPro to your needs! In the properties you can configure survey instruments, define colours and symbols, and much more.
Opening the properties
Go to File → Properties to open the settings dialogs.
Settings
User settings
- Username: your name for the activation
- Activation Code: activation code for all functions – see Getting started
Program behaviour
- Language: German, English, French, Czech
- Format: number format
- Date format: how dates are displayed
- Dark Mode: dark program interface
Updates
- Search for updates at startup: updates can also be searched for at any time under Info
- Zip file instead of windows setup: download the zip file instead of the Windows setup when updating
Survey data import
Default values for imported survey shots (PocketTopo, Compass, Therion and other formats):
- Survey Instrument Degrees / Gon: instrument number depending on the angular unit of the file
- Survey Colour: colour number of the imported survey shots
- Survey Hull: value of the field Hull — auto, LRUD, convex hull or concave hull
- UTM Zone for the import of new caves: longitude zone (1–60) and latitude zone (C–X); they are calculated when latitude and longitude are entered for the first time
LRUD and adjustment
- Critical angle vertical: with a smaller inclination, cross-sections are shown upright (degrees)
- Critical angle acute angle: with a smaller angle between two lines, cross-sections are shown at the acute angle, otherwise by bisection (degrees)
- Critical angle junction: with a smaller angle at junctions, cross-sections are taken over from the branching passage (degrees)
- LRUD perpendicular: show cross-sections perpendicular to the survey shot
- Cone angle splays: angle of the cones for selecting the splays used to calculate the LRUD values (degrees)
- Station adjustment: linear adjustment of the survey stations without taking the length into account (deprecated), see adjustment
- Show loop closure: show the button for the loop closure by loop numbers in the ribbon (deprecated), see adjustment
Station adjustment and Show loop closure are stored in the file.
Example for the critical angle vertical (0°–90°):
- 0°: no change to the cross-sections
- 30°: cross-sections with an inclination of -30° to +30° are shown upright
- 90°: all cross-sections upright
Individual survey stations can be overridden with the column LRUD in the datasheet – see Calculation & quality.
Volume rendering
- Gloss effect: switch the highlights in the volume rendering on or off
- Ambient Light: an ambient brightness and a fixed point light give the volumes a three-dimensional shading; when the model is rotated, the shading moves and emphasizes the shape of the space
- Surfaces Volumes: surfaces in the volume rendering
- Diameter of volumes: default diameter in metres if no LRUD values are given
- Frames Lines / Frames Volumes: frames per second for the line and the volume rendering
- Animation time: time between two animation positions in seconds
Miscellaneous
- OnlineTopoMap API Key: API key for the OnlineTopoMap map
- Thunderforest API Key: API key for the Thunderforest map
- Print Resolution: resolution for printing and bitmaps — reduce it if pages stay empty
- Omega Symbol: omega symbol for Google Earth
- Open exported files: open exported files automatically (
*.svg,*.pdf,*.kml,*.kmz,*.png,*.glb) - HTTP Proxy with Host and Port – for internet connections via a proxy; takes effect the next time the program starts
Survey instruments
Define as many survey instruments as you like. Every instrument gets an instrument number that is used in the survey shots.
Adding a new instrument
- Go to File → Properties → Instruments
- Right mouse button → New
- Enter the instrument information
Instrument parameters
- Instrument number: unique ID (e.g. 1, 2, 360, 400)
- Title: name of the instrument (e.g. "Compass 360", "Clinometer")
- Divisor: length factor (for a Topofil: length = (end - start) / divisor). Default: 0 (no calculation)
- Sag: sag of the measuring thread in per cent (e.g. 1%, 2%, 5%). The length is corrected with the catenary function
- Angular system: degrees (360°) or gon (400g)
Example of sag corrections:
- 1% → survey shot up to 0.3% shorter
- 2% → 0.6% shorter
- 5% → 1.6% shorter
- 10% → 3.2% shorter
Levels
Levels are filters for survey shots. You can filter survey shots by level and calculate them separately.
Defining a new level
- Go to File → Properties → Levels
- Right mouse button → New
- Level: enter the level number (e.g. 1, 2, 10, 100)
- Title: name of the level (e.g. "Upper system", "Lower system")
- Comment: optional note
Use: in the datasheet you can assign a level to every survey shot. Afterwards you can filter by level.
Surveyors
Define the names of the surveyors in your team:
- Go to File → Properties → Surveyors
- Right mouse button → New
- Surveyor: enter the surveyor number (e.g. 1, 2, 3)
- Name: name of the surveyor
- Comment: optional note
Use: you can enter a surveyor in every survey shot. This helps with analysing the data and tracking down measurement errors.
Maps
Here you define which maps are offered in the Map selection of the map view. Besides the maps that are included, you can add your own tile maps – you find an overview of the maps that are included under Visualization → map views.
Managing maps
- Go to File → Properties → Maps
- The overview table shows all maps with Map, Description, Zoom, HD and Selectable
Management options (right-click on a map):
- New: create a new map
- Delete: remove the selected maps
- Export: save the selected maps as an XML file
- Import: load maps from an XML file (inserted at the current position)
- Drag & drop: change the order of the maps – they appear in the map selection in this order
Map properties:
- Map: name of the map for the map selection. The map you choose is stored in the file under this name, and the cache directory is named after it too
- Description: short description of the map
- Selectable: determines whether the map is offered in the map selection
- URL: address of the map tiles with the placeholders
{z}(zoom level),{x}and{y}(tile numbers) in the Web Mercator grid, or a WMS GetMap or ArcGIS export URL - Attribution: attribution shown at the bottom right of the map
- Zoom: maximum zoom level of the map tiles (12 to 22, a default per map, e.g. 17 for OpenTopoMap and 19 for WorldImagery) – if you zoom in further, the tiles of this level are enlarged
- HD: for maps with high-resolution tiles: CaveRenderPro loads one zoom level higher and displays the tiles at half the size, which makes text and lines sharper. HD is preset for OnlineTopoMap, WorldImagery and swisstopo, for example
With the button URL test you check the URL: CaveRenderPro loads a test tile and displays it. For worldwide maps this is the world tile, for basemap.at a tile with the whole of Austria, for swisstopo a tile with the whole of Switzerland, and for Plan IGN a tile with the south and east of France. For WMS and ArcGIS maps, CaveRenderPro loads a tile in the middle of the map area that the service reports, and shows error messages from the server.
With the button Clear cache you delete the map cache of the selected map for all recently opened files, without a confirmation. You delete the cache of all maps with File → Tools → Clear cache.
If the map view is active, the map selected in the table is taken over into the map selection straight away – and vice versa.
thunderforest.com and top-o-map.com, CaveRenderPro automatically appends your API key from File → Properties → Settings to the URL. For the display without a watermark, request an API key at thunderforest.com or onlinetopomap.com.
Supported map types
For tile maps, CaveRenderPro replaces the placeholders {z}, {x} and {y} with the zoom level and the tile numbers; for WMS and ArcGIS maps it adds the tile extent (BBOX), the image size and any missing parameters automatically.
| Map type | Example | Supported |
|---|---|---|
Tile maps with {z}, {x}, {y} |
OpenStreetMap, OpenTopoMap, WorldImagery | ✔ |
WMTS with a URL with {z}, {x}, {y} |
basemap.at, swisstopo | ✔ |
| WMS with EPSG:3857 or EPSG:900913 | Aerial images of the German federal states | ✔ |
| WMS with EPSG:4326 or CRS:84 | ✔ | |
| ArcGIS REST export | …/MapServer/export, e.g. the geological map of Hesse 1:25,000 |
✔ |
| WMS with UTM or Gauss-Krüger only | EPSG:25832, EPSG:25833, EPSG:31467 | ✘ |
WMTS without {z}/{x}/{y} |
✘ | |
| Vector tiles | MVT, PBF | ✘ |
Importing maps
CaveRenderPro is delivered with predefined map files:
- Map Import DE.xml – German descriptions
- Map Import EN.xml – English descriptions
- Map Import FR.xml – French descriptions
- Map Import CS.xml – Czech descriptions
New files are automatically preset with the maps of the matching language. This is how you import them: right-click on the map table → Import, and choose the file.
Colours
Define colours for the various elements:
Colour management
- Go to File → Properties → Colours
- Choose an element or a symbol
- Click on the colour to change it
Survey shot colour
Colour 1 to Colour 16 – you enter the colour number in the datasheet in the column Colour; you activate the colouring with Layout → Colours/Textures → Lines.
Default colour
Colours of the default depiction (Layout → Colours/Textures → Default):
- Survey shots
- LRUD
- Splays
- Areas
- Left / Right – colouring by direction
Drawing colour
Default colours for the drawing elements:
- Default
- Waters
- Survey shots
- Stones, Sand
- Contour
- Snow, Ice
- Mud
- Sinter
- Grid
Filling colour
- Passages
- Stones
Gradient
The Gradient applies to the colouring by depth, date and adjustment – see Visualization → colours.
Symbols
CaveRenderPro has a UIS-compatible symbol database with predefined cave symbols. You can define and manage additional symbols.
Managing symbols
- Go to File → Properties → Symbols
- The overview table shows all available symbols
Management options (right-click on a symbol):
- New: create a new user-defined symbol
- Delete: remove a symbol (only if it is not in use)
- Export: save symbols as an XML file
- Import: load symbols from an XML file (inserted at the current position)
- Drag & drop: change the order of the symbols
Symbol properties:
- Symbol: symbol name for the drawing – a unique ID (do not change it once it is in use!)
- Title: title for the symbol selection (can be adapted)
- Selectable: determines whether the symbol is offered in the selection
Defining a new symbol
- Go to File → Properties → Symbols
- Right-click → New
- Enter the following parameters:
- Symbol: symbol name for the drawing, a unique ID
- Title: title for the symbol selection
- SVG Path: the path code in SVG format (preview in the field Display 72x36 pt)
- Size: scaling to 1 pt
- Symbol X / Symbol Y: symbol size
- Fill: fill the symbol
- Rotatable: the symbol can be drawn rotated
- Colour / Filling colour: symbol colour and symbol filling colour
SVG path format: see MDN SVG Paths for the exact syntax.
Example: M10 10 L90 90 L10 90 Z draws a triangle.
Symbols as patterns
Symbols can also be used as a fill pattern for areas:
- Go to File → Properties → Symbols
- Choose your symbol
- Tick the checkbox Pattern
- Set the following parameters:
- Pattern X: pattern size horizontally
- Pattern Y: pattern size vertically
- Random X: random pattern horizontally (0 = no randomness)
- Random Y: random pattern vertically (0 = no randomness)
- Random Rotate: rotate the symbols randomly
- With Display you show the symbol size (blue) and the pattern size (red) for checking
This is how you draw a pattern: go to Elements → Symbols/Patterns → Pattern and draw the area that should be filled with the pattern.
UIS symbols (standard database)
CaveRenderPro has the following UIS-compatible symbols predefined:
| Category | Symbols |
|---|---|
| Surface form | Snow, ice, sand, debris (fine, medium, coarse) |
| Water | Source, flow direction, sink, palaeo flow direction, scallops, flow facets |
| Air & wind | Draught (light, moderate, strong) |
| Sinter | Stalactite, stalagmite, column, curtain, helictite, straw, cauliflower sinter, floor sinter, wall sinter, disc |
| Rock surface | Crystals, karren |
| Biological | Bones, guano |
| Human | Human artefacts, entrance, bivouac, excavation |
| Surveying | Survey station, elevation, slope, squeeze, collapse, mud |
Importing symbols
CaveRenderPro is delivered with predefined symbol files:
- Symbol Import DE.xml – German labels
- Symbol Import EN.xml – English labels
- Symbol Import FR.xml – French labels
- Symbol Import CS.xml – Czech labels
This is how you import them: right-click on the symbol table → Import, and choose the file.
Fonts
Define three fonts for the texts in your drawings:
- Go to File → Properties → Fonts
- Choose a font for every position:
- Position 1: e.g. Arial (default)
- Position 2: e.g. Courier (monospace)
- Position 3: e.g. Times New Roman (serif)
In the tab Elements you can choose these positions when drawing text.
Loading properties from another file
With File → Properties → Load you take over the properties from another CaveRenderPro file. In the dialog you choose which areas should be loaded:
- Settings
- Instruments
- Levels
- Surveyors
- Maps
- Colours
- Symbols
This is how you quickly set up a new file with the instruments, levels, symbols and maps you are used to – or align the settings within the team.
Managing worksheets
Worksheets store layout, visualization and data settings:
Creating a new worksheet
- Set up your visualization, your layout and your data selection
- Go to Caves → Worksheets → New
- Enter a name (e.g. "Plan with survey shots")
- Your current view is saved
Worksheet settings
A worksheet stores:
- Row and column selection of the datasheet
- Visualization selection and settings including the animation
- Layout and plan configuration
- Selected caves
Worksheet management
- Update (
Ctrl+U): stores the current view in the selected worksheets - Delete: removes the selected worksheets
- Changing the order: drag & drop the worksheets
Tips for the configuration
- Several instruments: if you use different survey instruments, define all of them as instrument numbers 1, 2, 3, etc.
- Planning levels: think about which levels you need while you are still surveying (e.g. upper system, lower system, shafts)
- Team instruments: define the names of the surveyors in order to monitor the data quality
- Consistent colours: use the same colours for similar structures (e.g. always brown for mud)
- Testing symbols: create new symbols and test them before using them
- Worksheets save time: create worksheets for different kinds of analysis (surveying, drawing, presentation)
Frequently asked questions
Q: Where do I find the properties?
A: Go to File → Properties. There are several settings dialogs for the different areas.
Q: Can I delete an instrument number?
A: Yes, but only if it is no longer used in any survey shots. Select the instrument and click "Delete".
Q: How do I add my own symbols?
A: Go to File → Properties → Symbols and define new symbols in the SVG path format. You need some technical knowledge of SVG.
Q: Can I save and pass on my settings?
A: The settings are stored in the CaveRenderPro file. If you pass the file on, the settings go with it. Individual areas can be taken over from another CaveRenderPro file with File → Properties → Load.
Q: What is the sag?
A: The sag is the bending of a measuring thread or tape under its own weight. With a larger sag the actual length is corrected (it becomes shorter).
Next steps
Now you know all the important settings! The last chapter is your reference for everyday questions:
- Reference & help – keyboard shortcuts, data fields, mathematical concepts, tips & tricks