This page describes how to get started with Ceetron Desktop Components. First, it covers how to install and set up your license. Then it covers how to integrate the 3D viewer into the UI toolkit of your choice and getting a minimal application up and running, how to get your data into Ceetron Desktop Components and then how to proceed to add features.
Ceetron Desktop Components is distributed as a .zip archive on Windows. On Linux, it is distributed as a .tar.gz archive.
After unzipping the compressed files, you will get the following structure in the installation folder:
Ceetron Desktop Components is a licensed software system. In order to use Ceetron Desktop Components within your application you will need a valid license from Ceetron AS. Ceetron AS provides free 30 days evaluation licenses. Evaluation licenses can be obtained by registering at www.ceetron.com. Should you need an extended evaluation beyond 30 days, please contact Ceetron at suppo. See rt@c eetro n.co mLicense system for more information.
For C++ users:
In order to render with OpenGL and Ceetron Desktop Components in your application, you will have to provide a Viewer that derives from ViewerUIFramework. If you are using Qt or wxWidgets, we have provided examples on how to do this. See Using Ceetron Desktop Components with Qt and Using Ceetron Desktop Components with wxWidgets for more information.
If you are using MFC or native Win32, you can use the built-in Viewers in the Win component. See Using Ceetron Desktop Components with MFC and Using Ceetron Desktop Components with Win32 for more information.
If you are using any other UI toolkit, please see the documentation of ViewerUIFramework in order to create your own wrapper. If you have any problems with this, do not hesitate to contact Support.
For .NET users:
For Windows Forms, you need to use the Win component (CeetronDesktopComponents.Win) and create a user control for the 3D rendering. Examples on how to do this are provided in the WinFormsMinimal and WinFormsDemoApp. See Using Ceetron Desktop Components with Windows Forms for more information.
The Windows Presentation Foundation can also integrate towards this user control. See Using Ceetron Desktop Components with WPF for more information. A couple of minimal apps for this support is provided (WpfMinimal/WpfWindowsFormsHostMinimal).
There are many ways to get your data into Ceetron Desktop Components depending on the nature of the data and the need for your application.
If you have analysis data (FEA, CFD, etc. with elements and results) you should use the UnstructGridModel. Here there are many ways of getting your data into Ceetron Desktop Components.
If you have geometry based data, you should use the GeometryModel. Here you will need to populate the model with data and effects manually. Please see the Geometry: Create a geometry model or Geometry: Create a geometry model with texture tutorials for examples on how to use the Geometry component.
Geometry examples:
Finally, please note that you can combine the different models in a view to create a rich visualization. A view can have as many models as you like of any type.
Based the Ceetron VTFx file format, your simulation data can be easily shared using Ceetron Cloud, the Report component and our free viewers.
Ceetron Cloud:
With Ceetron Desktop Components it is easy to add cloud export support to your application. With a single click of a button the users can share the 3D model they are currently showing in your app with the rest of the world. The model can be shown in any modern web browser without installing any software or plug-in.
See Ceetron Cloud - Add a Send-To-Cloud button to your app
Ceetron 3D Viewers:
The Export component adds easy sharing of simulation results using the Ceetron VTFx format. With a few lines of code, you can export exactly what you have on the screen to a compact file that can be shown on almost any platform. The Ceetron 3D Viewer is available on Windows, Linux, Mac, iPad and iPhone. The Ceetron 3D Plugin for Microsoft Office is our plugin to the Microsoft Office suite, which enables interactive 3D models with animation directly in PowerPoint and Word.
See Share Everywhere with VTFx files and Ceetron 3D Viewers
Report Component:
With the Report Component, 3D content, images and other simulation data can easily be included in MS Office documents. The engineer can explore the model and the results in full 3D, providing increased understanding and more data readily available. Including 3D content in the report reduces the need for multiple images and videos, adding flexibility and the ability to answer ad-hoc questions. Or just create a hyperlinked image in your report and go to the model in the cloud with one click. The Ceetron Report Component collects and organizes all data in one place, and creates reports in MS Word, MS PowerPoint and HTML from the same source.
See Create interactive reports directly from your application
The Tutorials and Examples and Topics are good places to look for specific information on how to implement a given feature. The Examples Tab gives more direct access to the code for easy overview and copy/paste.
A good starting point for FEA type data is the DemoApps provided for Qt and .NET. These are more complete apps that showcase one way of using Ceetron Desktop Components. You find these in the Examples/Qt/QtDemoApp and Examples/WinForms/WinFormsDemoApp folders in the distribution.