Final Project: 3D Graphic Editor

July 2015

New:

July 24, 2015

We have uploaded the executable file for the 0.1.0 version. Make sure you copy the files into the

platforms/qt/

directory of your modified S3D api installation to work.

What is it ?

It is a program to create funny 3D scenes based on spheres, cones and cylinders (hopefully more primitives in future versions) in a very intuitive and easy way. It has a easy-to-use graphic editor for such purpose.

Here a screenshot of the program in its alpha 0.1.0 version:

and here some images I made using it. As mentioned, this alpha version has a bunch of bugs and missing features yet, but I hope to be releasing more mature versions when possible.

How do I use it ?

The first thing to look at are the buttons at the left. You add canonic primitives to the scene with them. You have four canonic primitives by now:

  • A canonic sphere with center at (0,0,0) and radius 1,
  • A canonic cone with height 1 and radius 1,
  • An open cylinder with center at (0,0,0) and height 2,
  • A solid cylinder with center at (0,0,0) and height 2,
  • and a button to restart the scene (it erases all the work you have done).

    This is what happens after clicking on the "sphere" button:

    Now you have the panel behind wich is all about performing transformations to the object you have just added to the scene. By default, it always appear in the center of the last object added before so to make creation easier. But you can rotate, scale and move the new object as you want. If the sliders feel to short for your creativity, just press the "OK" button to set them to default position.

    Now you have the object selector. Yes, it means you can select any object you have added to transform it any time you want. To do that, keep in mind that any object you add to the scene comes with a "id" number, starting with 0 for the first. So you can just use the number box to select the object using its id. It shows the type and position of the object you are selecting to make things easier. But if you just don't remember the id you want, you should make use of the free text area in the right corner to write the things you don't want to forget.

    By now, you are able to create some beatiful images. But we know that ellaborating complex objects needs different points of view. To help with that, you have the view transformation panel, which is aimed to help you see your scene from every point you want to. Specially useful are the ones that rotate the scene respectly of the center of the current selected object. Those are highlighted with green color in the picture below.

    To finish, you just have to click on the "paint view" button to get a picture of your scene. The generated "salida.png" file can be found in the executable directory or debug compilation directory. The picture will be just on black/white color, but I hope to change that in future versions of the software.

    Download the software

    Here the source code of the software. It relies on the S3D api developed by Luiz Velho (the version v60). Here the "prim" directory to replace the "/core/prim" and the Qt project.