GuIrit, - A Graphics User Interface to IRIT

(c) Copyright, Gershon Elber, 2008-2013

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 capabilities of GuIrit:

Shadows and Reflections:


This example shows simple display of shadows and reflections of an existing object by altering its rendered properties.

Grids and Shadows:


This example shows how to handle the different grids and optional shadows on these grids.

Transformations:


Shows how one can translate/rotate/scale geometry. Also presents shadows on the possible grids the system offers.

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. Objects' dependency is demonsrtated here by modifying a primitive, after the Booleans were conducted, only to immediately update the result. This demo uses GuIrit DLL extensions GuIritDllPrims.dll and GuIritDllBoolOp.dll

Curve Sketching and MR Editing:


Ability to sketch a curve and then multiresolution (MR) editing of curves. This demo uses GuIrit DLL extensions GuIritDllCrvSketch.dll and GuIritDllMRCrv.dll

Construction of an Extruded Surface:


Shows 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, via dependencies. 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.

Trivariate fitted through Surfaces:


Building a trivariate volume that is fitted through a sequence of surfaces. This demo uses GuIrit DLL extensions GuIritDllSurfaces.dll and GuIritDllTrivars.dll

Volumetric Displacement Deformation Mapping Curves:


(Symbolicaly) compose three orthogonal cylinders multiple times inside a trivariate (constructed in previous demo, fitted through surfaces). This demo uses GuIrit DLL extensions GuIritDllSurfaces.dll and GuIritDllTrivars.dll.

Simple Image Import utility:


A simple DLL (GuIritDllImportImage.dll) exemplifying a simple interface to import images into Guirit.

3D Deformation Example:


Exemplifies freeform deformation abilities. This demo uses GuIrit DLL extensions GuIritDllDeformations.dll.

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

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,