GroIMP wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== Modify object in the scene =====


{{3d-guide:panels.png}} 

**Figure 1**

The currently selected object can also be modified by 3D tools. GroIMP has three tools for modifying a selected object in the scene:
  - **The translation tool**: in //Figure 1//, you can see three arrows which are the handles for GroIMP's 3D translation tool. By dragging the arrows with the mouse, the object is moved along the arrow direction. If you use the middle mouse button for dragging, the movement is in a plane perpendicular to the arrow direction.
  - **The rotation tool**: It is activated in the toolbar by clicking on the rotation icon. As handles, it displays three circles which can be dragged to rotate the selected object.
  - **The scaling tool**: It change the scale of an object toward one axis. 

Pressing the ''del'' key will delete the selected objects.

===== Navigate in the scene ===== 

Navigation in the view panel is possible with the navigation buttons in the view panel's upper right corner or with the mouse. To navigate using the buttons, press a button and drag with the mouse while keeping the button pressed. To navigate using the mouse only, press the **Shift** button and drag with the mouse over the view panel: The left mouse button rotates the view, the middle mouse button moves the viewpoint in the viewing plane, and the right mouse button makes a dolly movement along the viewing direction (or a zoom for a view camera with parallel projection). The mouse wheel works similarly to the right mouse button.

The Camera menu of GroIMP's 3D view allows the selection of different cameras. Some cameras are predefined, among them the common orthographic projections. You can add user-defined cameras to your project in the Camera Explorer (the menu item Panels/Object Explorers/3D/Cameras brings it up); these cameras can be selected as current camera in the Camera menu, too. They can be edited through the navigation facilities or in the Attribute Editor.

Change the navigation:

{{:3d-guide:3dview_navigators.png?200|}}

See more:
  * [[:dev-guide:add-navigation|Add a navigation]]

===== Select objects =====

You can select object in the 2d and 3d view by clicking on them.

In the 3d view it is also possible to hold ''shift'' and drag the cursor with the left button pressed to draw a box, after releasing the mouse all object in the box are selected.

It is possible to hold ''CTRL'' to combine multiple selections.




See more:
  * [[https://gitlab.com/grogra/groimp-plugins/AdvancedSelection/|Plugin for additional selection tools]]

===== Add objects =====

It is possible to add objects in the scene by clicking on ''Objects'', then, one of:
  - From file
  - Primitives
  - NURBS
  - Polygonal
  - Scene objects

See more:
  * [[:user-manual:objects|Availalbe objects in GroIMP]]
  * [[:user-manual:ch02#import_and_export_data|How to import object in GroIMP]]
  * [[:tutorials:import-object-in-groimp|Tutorial on importing object in the scene]]

===== Change the default display =====


GroIMP features OpenGL-accelerated display of the scene. The OpenGL-based display may be selected if the //Java Binding for the OpenGL API// (JOGL) is installed. The menu View/Display of GroIMP's 3D view brings up the selection for the different supported display modes. These are:

  * **Wireframe (AWT)**: A wireframe view of the scene. Will run on all systems.
  * **OpenGL**: OpenGL-based view. Will run on all systems with OpenGL 1.1 support. This mode will display colors and simple textures.
  * **OpenGL (Proteus)**: OpenGL-based view. Requires a OpenGL 2.1 compatible GPU. This mode will preview the output of the internal raytracer Twilight in realtime. It features:
    * Preview of most materials including procedurally calculated shaders using the OpenGL Shading Language (GLSL)
    * Per pixel lighting
    * Rendering of shadows
    * Preview of Sky-Nodes as background 
    * Rendering of transparent materials


Change the Display:

{{:3d-guide:3dview_display.png?200|}}

Navigation and control is the same for the Wireframe and both OpenGL-based modes as explained in [[ :3d-guide:view_manipulations#navigate_in_the_scene|how to navigate in the scene]]. A comparison of all three modes for an example scene is shown in figure 2.

**Figure 2 Comparison of GroIMP's 3D view modes**

{{:3d-guide:3d_view_comp.png}}


See more:
  * [[3d-guide:opengl_options|All options for OpenGL views]]
===== Render the scene =====

You can render the current scene with the ''Render View'' menu item. 

GroIMP embed two default renderer:
  - Twilight, based on the main Ray tracer (see [[user-guide:raytracing#default_renderer| this page]] for more details)
  - Fluxrenderer, based on GPUFlux (see [[user-guide:raytracing#flux_renderer| this page]] for more details)

Additionally it is possible to add external renderer in GroIMP. Currently the only external renderer is:
  - POV-Ray, a free ray-tracer, which can be used to render 3D scenes in high quality (see [[POV:index |here]] for more info)

See more: 
  * [[:user-guide:raytracing#custom_renderers|How to add external renderers]]