Compile and run the tutorials in Envision Desktop

Getting your hands dirty right away!

In the Envision Desktop documentation you can find several tutorials that explains and shows how to use the SDK. Check it out here: Tutorials — CEETRON Envision for Desktop documentation

But did you know that these tutorials also are available to compile and run in the distribution?
This is a great way to get started learning and understanding the code. Start the tutorial, change parameters, add code and see what happens.

To make sure you can work in an environment that suits you, we offer the following frameworks:

  • Qt
  • MFC
  • wxWidgets

Download the latest distribution from the TechSoft 3D Developer Zone.

Once you’ve unzipped the distribution archive, you’ll find the tutorials in the Tutorial folder. Open the TutorialRunner of your chosen framework.

  • QtTutorialRunner (Qt pro file)
    (Use ‘qmake -tp vc’ to create a Visual Studio project)
  • MfcTutorialRunner (Visual Studio project file)
  • WxTutorialRunner (Visual Studio project file or Makefile)

Please compile them in-source to find necessary test data.

If this is your first time compiling Envision, you will need to add you own license file. You can create your license in the Developer Zone.

Put your license file hoops_license.h into the License folder in the Envision Desktop distribution.

image

Then just open the tutorial runner you want to use.
For instance, opening the MfcTutorialRunner project files gives you this:

The code for all tutorials found in the documentation are available and compilable. Under Tutorial Files in the solution tree, you will find all tutorial topics, each in its own file. Corresponding with the tutorials described in the documentation.

Compile and run!

Select one of the tutorials in the drop down menu. For instance “Isosurface”.

image

Now you can go into the code and play around!

For instance, try to change the code (Isosurface.cpp) to do the following:

  • Set the parts to be transparent instead of outlined
  • Show fringes on the model
  • Show displacements

Like this:

When you run again and select “Isosurface”, you’ll get this:

The tutorials are a convenient way of learning the different parts of the Envision Desktop SDK. The code is compressed and “to the bone” on the current topic. (Please note that the TutorialRunner framework is not meant to represent best-practice code, and only serves as a convenient way to demonstrate the code in the tutorials.)

If you’re missing any tutorials, shout out and we’ll see what we can do :+1:

3 Likes