GuIrit, - A Graphics User Interface to IRIT

(c) Copyright, Gershon Elber, 2008-2011

GuIrit is an ever-evolving GUI (Graphical User Interface) to IRIT. It is under ever-going development but is certainly in a usable form. It includes:
  1. A graphically based user interface to create, display, manipulate and process geometry.
  2. Access to most of the functions in the IRIT interpreter (Irit.exe) and build above the IRIT package. Any other IRIT (or arbitrary) function could be easily exposed as well using DLL extensions (See below).
  3. Fully configurables menus (Via guirit.cfg).
  4. Fully configurables keyboard/mouse/gesture event bindings (Via guirit.cfg).
  5. Programmable extension interface. Many of the existing functions in GuIrit are built using this extension interfaces that allows one to create external extension as DLLs (or shared libraries on non windows platforms) without resorting to rebuilding guirit.exe.
  6. Using wxWidgets, and hence it is suppose to be relatively simple to port to other environments. So far, GuIrit was tested on Windows XP/Vista/7 and Linux Fedora, and to a lesser extent on MAC OSX. Herein, we provide executables for Windows XP/Vista/7 as well as the C/C++ sources.

Some examples

Here are some short movie examples of the capabililies of GuIrit (You will need the DivX, http://www.divx.com, codec to see these movies):
  1. Display 1: A first example of display control over the geometry. Show how to change different display modes, like wireframe/shaded display and shadows and refelctions. In all examples you can watch the Ctrl/Atl/Shift modifiers state at the bottom right corner. For example "C LM" denotes Control-Left-Mouse button.
  2. Display 2: A second example of more display control over the geometry. Show the use of three shadows on the three pricipal planes.
  3. Transformations: Shows how one can translate/rotate/scale geometry.
  4. Primitives and Booleans: A simple example of primitive object creation using the interactive update option of (numeric) parameters, using right-mouse click-and-drag over numeric widgets. This example also shows a simple Boolean operation - with its geometric parameter selection performed via the GUI combo or by object-select-and-drag. This demo uses GuIrit DLL extensions GuIritDllPrims.dll and GuIritDllBoolOp.dll
  5. Curve drawing and editing: Ability to sketch a curve and then multiresolution editing of curves. This demo uses GuIrit DLL extensions GuIritDllCrvSketch.dll and GuIritDllMRCrv.dll
  6. Construction an extruded surface: Show one surface constructor (extrusion) by selecting a circle costructor as its curve parameter which allows interactive update of all parameters of both the circle and the extrusion constructors. This demo uses GuIrit DLL extensions GuIritDllSurfaces.dll (for the extrusion) and GuIritDllCurves.dll (for the circle). Again, right-mouse click-and-drag is used to modify numeric widgets.
  7. Dependencies: Building a circular plate with two conical holes, that are computed as Boolean subtraction. Using (active) dependencies, any change in the parameters of the circular plate (a cylinder) or the two (truncated) cones is immediately reflected in the final result.
  8. Malfatti: An example of using the multivariate solver of Irit to solve the Malfatti problem in real time - find the three largest (actually not the largest) circles tangent to each other within a triangle (solution of 9 quadratic equations in 9 variables).
  9. Surface From Curves: Fit a surface through curves while editing the curves (and surface). Operation also known as skinning.
  10. Simple Animation Creation: Transform a truncated cone (including non-uniform scale) and then apply the transformatio nto the cone, only to animate it in both motion and color.

Manual Installation of the Windows version

  1. If you use Windows XP and unless you have MS Visual Studio 2008 (9.0 .net) SP1 installed on your system you will also be required to install (once only) the run time env. of this compiler from Microsoft.
  2. Download the compiled-for-windows GuIrit zip file and open it in a directory of your selection.
  3. Go into the directory in 2, and run GuIritInstallGuiCfg.cmd (once only). This creates a directory "%USERPROFILE%\Application Data\GuIrit" and place there a default GUI configuration file.
  4. Run GuIrit.exe. If everything worked out fine, you should see something like in the "1st Run" section below.
  5. The installation also includes some minimal documentation and a few models as an example, in the Docs and Models sub directories.

Automatic Installation of the Windows version

  1. If you use Windows XP, you can also download GuIritInstall.exe and execute it for an automated installation
  2. Run GuIrit.exe. If everything worked out fine, you should see something like in the "1st Run" section below.
  3. The installation also includes some minimal documentation and a few models as an example, in the Docs and Models sub directories.

A comment in Windows 7. In Windows 7 the %USERPROFILE% expansion is different and hence you will have to text-edit the cfg files and GuIritInstallGuiCfg.cmd to the proper directory.

1st Run

Click on the image for an enlarged view.

Make sure, when you run GuIrit, that the messages that appear in the bottom left window are not in the red color, meaning everything loaded/initialized fine.


The sources

GuIrit is a graphical user interface for the IRIT modeling package and is built using wxWidgets. This means you will have to download these two packages and build them before you can built GuIrit. These tasks are NOT trivial and unless you consider yourself knowledgeable, please do not attempt this. I cannot provide support and/or answer compilation questions. Yet, some 'readme' information could be found in the Docs subdirectory of the Guirit Distribution. For latest (alpha version) GuIrit sources, see here.


Enjoy

Gershon Elber,