How to launch a demo
Last update: 2018.08.14 by JeGX
>> Back <<
[ French version / Version française ]
Depending on the platform (Windows, Linux, macOS), the launching of a demo can vary. There are two main methods:
- launching a demo using a drag-and-drop
- launching a demo from the command line
The first method is available on all platforms (Windows, Linux et macOS) since GeeXLab 0.25.3.0. The second method is available on all platforms.
Method 1: Drag-and-Drop
It's the easiest method for launching a demo: just start GeeXLab and drag-and-drop any XML scene file from the file manager (Explorer on Windows, Finder on macOS, etc.) into GeeXLab. Here is the drag-and-drop in action on Raspberry Pi:
On Windows and macOS, you can also launch a demo from GeeXLab user interface: just go to Menu > File > Load scene file (keyboard shortcut CTRL+O).
If you have done changes in the demo source code, just reload it with the following shortcut: CTRL+R (or via the menu: File > Reload scene file).
Method 2: Command Line
The command line is not the easiest method but it's a powerful one. And this method is available on all platforms. Let's see how to use the command line for each platform.
For every platform, I suppose a terminal is open in GeeXLab root folder and that we want to run a demo called my_demo.xml stored in GeeXLab demos/ folder.
Windows
GeeXLab.exe /demofile="./demos/my_demo.xml"
macOS
open 'GeeXLab.app' --args '/demofile="./demos/my_demo.xml"'
Linux
Here the Linux platform can be the regular Linux (Ubuntu, Linux Mint, etc) as well as the Raspbian (Raspberry Pi) and Tinker OS (ASUS Tinker Board) platforms.
./GeeXLab /demofile=\"./demos/my_demo.xml\"
We can also store the command line in a .sh file. In that case for macOS and Linux, do not forget to add #!/bin/bash in the first line of the .sh file.
start_demo.sh file:
#!/bin/bash
./GeeXLab /demofile=\"./demos/my_demo.xml\"
You can launch this file from the command line with:
$ sh ./start_demo.sh