Getting started with CaveRenderPro
Welcome to CaveRenderPro! This page guides you through the basic steps of the installation and through your first steps with the application.
Installation
Windows
The installation on Windows is the easiest:
- Download the installation file: CaveRenderPro_Setup.exe
- Double-click the
.exefile - If a Windows security warning appears:
- Click on "More info"
- Then click on "Run anyway"
- Follow the installation wizard
- Java and JavaFX are installed automatically
CaveRenderPro\jdk.
Linux and macOS
On Linux and macOS you have to install Java and JavaFX manually:
- Download the ZIP file: CaveRenderPro.zip
- Extract the file into your directory
- Install Java:
- Download the JDK from jdk.java.net
- Extract it into:
CaveRenderPro/jdk
- Install JavaFX:
- Download JavaFX (SDK) from jdk.java.net
- Extract it into:
CaveRenderPro/javafx-sdk
- Start the application with:
./CaveRenderPro.sh
First steps after the installation
1. Starting the application
Windows: double-click CaveRenderPro.exe or use the start menu.
Linux/macOS: run CaveRenderPro.sh.
2. Activation code (optional, but recommended)
An activation is required for the following functions:
- Printing plans
- Exporting survey shots for Google Earth
- Exporting survey shots as GeoJSON
- Exporting drawings in PDF or SVG format
- Exporting drawings as an overlay for Google Earth
- Exporting 3D models in GLB format
Requesting an activation code:
- Go to the PayPal link (€20)
- You receive the activation code in your PayPal account
- In the application: File → Properties → Settings
- Enter your user name and activation code
Understanding the user interface
Main areas of the application
CaveRenderPro is divided into the following areas:
| Area | Description |
|---|---|
| Ribbon (top) | 10 main tabs for all functions: File, Caves, Data, Calculate, Visualization, Layout, Drawings, Elements, Plan, Info |
| Worksheets | Save different views and layouts as templates |
| Cave table | Overview of all caves in the project |
| Cave data | Management of cave data and coordinates |
| Drawings | Shows all drawings for selection |
| Datasheet | Table for entering and editing survey shots |
| Visualization area | Shows plan, extended profile, projected profile, 3D views, maps and drawings |
| Status bar (bottom) | Contextual information depending on the current view |
The status bar
Depending on the view, the status bar shows different information:
| View | Display |
|---|---|
| Cave table | Number of selected caves |
| Datasheet | Number of selected records |
| Symbols | Number of selected symbols |
| 3D views | Viewing direction |
| Drawings | Coordinates at the mouse position; drawing size of rectangles, straight lines and circles in cm (depending on the scale) |
| Sketches and elements | Rotation angle |
| Records | Register number, cave name, station, depth, calculated values of the survey shot (length, azimuth, inclination), adjustment |
| Distance measurement | Origin, destination, distance |
| Survey shot | Register number, cave name, RefStation, station |
| Copied coordinates | Latitude, longitude, elevation; for survey stations also the overburden (rock above the station according to the elevation model) |
Creating your first cave
Step 1: create a new file
- Click on File → Files → New
- Save the file: File → Files → Save
Step 2: add a cave
- Click on the tab Caves
- Click on Caves → Caves → New (or right-click in the cave table)
- Enter the following data:
- Cave number: e.g. "1"
- Name: e.g. "My first cave"
- Latitude/longitude: GPS coordinates of the entrance
- Elevation: height above sea level in metres
- Save the cave
Step 3: enter the first survey data
- Click on the tab Data
- You see the datasheet with various columns
- To enter survey data:
- Enter the data manually into the table
- Or import it from another program: Caves → Import → Survey
Step 4: calculate the data
- Click on Data → Calculate → Calculate (or
Ctrl+B) to process the survey shots - Check the error check (red fields = errors)
Step 5: look at the visualization
- Click on the tab Visualization
- Choose a view:
- Plan - top view
- Extended profile - side view
- Projected profile - cross-section view
- Perspective - 3D view
- Use the mouse to zoom and pan
Using worksheets
Worksheets are templates that store your current view:
- Different layouts for different tasks
- Row and column selection in the datasheet
- Visualization selection and rendering
- Selected caves and survey shots
Saving a worksheet:
- Configure your view as you like
- Click on Caves → Worksheets → Update
- The worksheet is saved
Frequently asked questions (FAQ)
Q: Do I have to install Java?
A: No. Windows users: Java is already included. Linux/macOS users: yes, you have to install the JDK.
Q: Can I import data from other programs?
A: Yes! CaveRenderPro supports the import of: Compass, PocketTopo, Qave, SexyTopo, Therion, TopoDroid, Toporobot, VisualTopo/CaveSurvey and Walls.
Q: Which views are available?
A: Go to the tab Visualization and choose different views under "View types": plan, extended profile, projected profile, perspective, as well as volumes and maps (OpenTopoMap, CyclOSM, Thunderforest, WorldImagery).
Q: Which keyboard shortcuts are available?
A: The most important ones are:
Ctrl+D- display datasheetCtrl+G- display visualizationCtrl+W- display drawingsCtrl+E- edit elementsCtrl+P- print plan
Demo CaveRenderPro.xml to get started. You can find more examples on the homepage.
Next steps
Now you are ready to start! Read the next chapters to learn more:
- Managing data - caves, survey instruments and survey data
- Calculation & quality - survey adjustment and error checking
- Visualization - different visualization types and views