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:

  1. Download the installation file: CaveRenderPro_Setup.exe
  2. Double-click the .exe file
  3. If a Windows security warning appears:
    • Click on "More info"
    • Then click on "Run anyway"
  4. Follow the installation wizard
  5. Java and JavaFX are installed automatically
ℹ️ Important: A separate Java installation is not required. Java is located in the subdirectory CaveRenderPro\jdk.
Linux and macOS

On Linux and macOS you have to install Java and JavaFX manually:

  1. Download the ZIP file: CaveRenderPro.zip
  2. Extract the file into your directory
  3. Install Java:
    • Download the JDK from jdk.java.net
    • Extract it into: CaveRenderPro/jdk
  4. Install JavaFX:
    • Download JavaFX (SDK) from jdk.java.net
    • Extract it into: CaveRenderPro/javafx-sdk
  5. 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:

  1. Go to the PayPal link (€20)
  2. You receive the activation code in your PayPal account
  3. In the application: File → Properties → Settings
  4. Enter your user name and activation code
✓ Tip: The activation code is valid for all of your computers and remains valid permanently.

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

  1. Click on File → Files → New
  2. Save the file: File → Files → Save

Step 2: add a cave

  1. Click on the tab Caves
  2. Click on Caves → Caves → New (or right-click in the cave table)
  3. 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
  4. Save the cave

Step 3: enter the first survey data

  1. Click on the tab Data
  2. You see the datasheet with various columns
  3. 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

  1. Click on Data → Calculate → Calculate (or Ctrl+B) to process the survey shots
  2. Check the error check (red fields = errors)

Step 5: look at the visualization

  1. Click on the tab Visualization
  2. Choose a view:
    • Plan - top view
    • Extended profile - side view
    • Projected profile - cross-section view
    • Perspective - 3D view
  3. 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:

  1. Configure your view as you like
  2. Click on Caves → Worksheets → Update
  3. 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 datasheet
  • Ctrl+G - display visualization
  • Ctrl+W - display drawings
  • Ctrl+E - edit elements
  • Ctrl+P - print plan
💡 Tip: CaveRenderPro comes with sample files – open 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: