![]() | ![]() | ![]() | Gtk 3d Canvas (libgtk3dcanvas) Reference Manual | ![]() |
---|
#include <gtk-3dcanvas.h> struct Gtk3dcanvas; Gtk3dcanvasGroup* gtk_3dcanvas_root (Gtk3dcanvas *canvas); void gtk_3dcanvas_clear (Gtk3dcanvas *canvas); void gtk_3dcanvas_draw (Gtk3dcanvas *canvas);
Gtk3dCanvas is the 3D counterpart of the classical GnomeCanvas. It is a powerful and extensible object-oriented 3D display engine. The widget itself cannot be displayed, you have to declare camera on it, which are visual rendering of the canvas content. For now, the only available camera is Gtk3dCanvasCameraGl, which use OpenGl.
You can place Gtk3dCanvasItem on the canvas. A GnomeCanvasItem is a GtkObject representing some element of the display, such as a ball, a stick, a cube or a polygone.
You can refer to this architecture as structured graphics; the canvas lets you deal with graphics in terms of items, rather than an undifferentiated grid of pixels. Since a Gtk3dCanvasItem is a GtkObject, you can create your own subclasses to supplement those that come with this library. This gives you quite a bit of flexibility. Using custom canvas items, the canvas can render almost anything.
struct Gtk3dcanvas;
The fields of the Gtk3dcanvas are private, and should be accessed only through the properties and functions below.
Gtk3dcanvasGroup* gtk_3dcanvas_root (Gtk3dcanvas *canvas);
Queries the root group of a canvas.
canvas : | A Gtk3dcanvas. |
Returns : | The root group of the specified canvas. |
void gtk_3dcanvas_clear (Gtk3dcanvas *canvas);
empties the world of all objects
canvas : | A Gtk3dcanvas. |
void gtk_3dcanvas_draw (Gtk3dcanvas *canvas);
Ask for a redraw of the scene.
canvas : | A Gtk3dcanvas. |
<<< Common types | Gtk3dcanvasItem >>> |