Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
giram(1)		      Giram manual pages		      giram(1)

       giram - Giram Is	Really A Modeller

       giram [options]

       giram  is  a simple volumic (as opposed as meshed) 3D modeller.	It al-
       lows you	to create a 3D scene which you can save	as  a  POV-Ray	source
       file or AutoCAD DXF.

       When Giram starts, only the Giram Toolbox is open.  Choosing File, then
       New View	presents a dialog box offering to display several viewports.

       View X-Y
	      "Front View", with the X and Y axis of the  frame	 corresponding
	      to the X and Y axis of the monitor.  Allows you to adjust	an ob-
	      ject's horizontal	and vertical position.

       View X-Z
	      "Top View", with the frame's Z axis placed along the monitor's Y
	      axis.  Allows you	to move	an object left/right and forward/back-

       View Z-Y
	      "Side View", with	the Z axis of the frame	 placed	 along	the  X
	      axis of the monitor, and the Y axis placed normally.  Allows you
	      to change	the depth and height of	objects.

       Camera View
	      Shows the	frame in 3 dimensions.	Unlike the  other  views,  ob-
	      jects  cannot be translated, rotated, or scaled using the	mouse.
	      The position and direction of the	camera can be adjusted.

       If you leave the	drop-down list at its default setting  of  New	Frame,
       the  viewports will show	a newly	created, empty Frame.  Other currently
       open frames are also available.	When a frame is	first opened, all  the
       views are shown.

       To  pan in any of the viewports (except the camera), use	the scrollbars
       along both sides	of the window.	Zooming	can be done by	right-clicking
       within the window and selecting View, then Zoom in or Zoom out.	Fit to
       Selection and Fit to Scene will pan and	zoom  the  viewport  appropri-

       Before you can modify a scene, you have to tell Giram which objects are
       going to	be modified. This is what the Selection	Tool is	for.  With  it
       you can select an object	or group of objects, or	change the contents of
       the current selection.  Once selected, objects can be a translated, ro-
       tated or	scaled.

       To  select  an object, just click on it.	 By default, all objects under
       the cursor are selected.	As scenes can get quite	complicated when  dis-
       played  in  2D,	and  shapes are	displayed stacked up on	top of one an-
       other, this may not be what you want. So	with Giram you can modify  the
       way  objects  are selected with the [Shift], the	[Ctrl] and [Alt] Modi-
       fier keys.

       No Modifier
	      All the objects under the	cursor are selected.  Previous	selec-
	      tions are	forgotten.

	      All the objects under the	cursor are added to the	selection.

       [Ctrl] All  the	objects	under the cursor are removed from the	selec-

	      Select only the objects that are under the cursor	 AND  were  in
	      the previous selection.

       [Alt]  The  selection  is made by the 'first' object under the cursor -
	      the 'first' object being the one that is higher up  in  the  CSG
	      heiracy  (basically  the one that	was created first).  Following
	      clicks in	the same spot, with the	[Alt]  modifier,  will	select
	      the next object under the	cursor and so on...

	      The  'first' object under	the cursor is added to the current se-
	      lection.	 Following  clicks  in	the  same   spot,   with   the
	      [Alt]+[Shift]  modifier, will add	the next object	under the cur-
	      sor to what were the selection before the	first  click,  and  so

	      The  'first' object under	the cursor is removed from the current
	      selection.   Following  clicks  in  the  same  spot,  with   the
	      [Alt]+[Ctrl]  modifier,  will  removed the next object under the
	      cursor from the selection	as it was before the first click,  and
	      so on...

	      The  'first'  object under the cursor will become	the new	selec-
	      tion, but	only if	it was already in the previous selection, oth-
	      erwise  nothing is selected.  Following clicks in	the same spot,
	      with the [Alt]+[Ctrl]+[Shift] modifer, will do  the  same	 thing
	      but with the 'next' object.

       The  toolbox  is	 the first window to open when Giram starts.  Items in
       its dropdown menu apply to the program as a whole, though some commands
       will  affect the	most recently opened file.  Giram's toolbox can	be set
       to either static	or dynamic mode; to change between them	choose Prefer-
       ences from the File menu.

       The  "Static Toolbox" shows all the icons in one	large block. The prob-
       lem is that there are quite a few tools to pick from, and  the  toolbox
       can take	up quite a bit of screen real estate.

       The  "Dynamic Toolbox" tries to use as little screen space as possible.
       It puts the tools into categories. The selection	tool and the transfor-
       mations (i.e. move, rotate, and scale) remain in	place.	The shapes are
       grouped into categories:	3D  shapes,  2D	 shapes,  lathes,  lights  and
       patches.	  To  pick a shape from	the Dynamic Toolbox which is not visi-
       ble, right-click	on an icon that	is in the same class  and  select  the
       desired	shape.	A  small  black	triangle in the	top-right corner of an
       icon indicates that it contains shapes other than the one visible.

       To align	shapes preciscely, use the Snap	option located in  the	pop-up
       menu's  Edit submenu.  A	grid with the specified	sizes can be displayed
       and objects can be set to "snap"	to it.

       When the	Rotate Tool or Scale Tool is active, a green cross will	appear
       near  the currently selected object.  This indicates the	whereabouts of
       the 'pivot point' or 'scale centre point' of an object or group of  ob-

       Move   To  move	the  current selection,	simply drag and	drop it	to the
	      desired location.	 Translations can also be performed non-inter-
	      activly using the	choosing Operations, Translate from the	pop-up

       Rotate To rotate	the current selection, press and hold the  left	 mouse
	      button while moving the mouse.  The selection will rotate	around
	      the pivot	point in the plane of the active view.	To adjust  the
	      pivot  point, hold [Ctrl]	and click at the new pivot point while
	      the Rotate Tool is active.  Choosing Operations, Rotate from the
	      pop-up menu allows rotating a specific number of degrees.

       Scale  To  grow or shrink an object, press and hold the left mouse but-
	      ton while	moving the mouse.  The center (i.e. the	  point	 which
	      does  not	 move  while scaling) can be set by holding [Ctrl] and
	      clicking.	 It is also possible to	scale an  object  by  choosing
	      Operations,  Scale  from	the pop-up menu	and entering the scale

       Box    To create	a new rectangular prism,  click	 the  left  button  to
	      place  the first corner, move the	cursor,	and release the	button
	      to place the second corner.

	      To create	a new cylinder,	click  to  place  the  center  of  the
	      cylinder's  base,	 and  drag the mouse pointer vertically	to set
	      the length and horizontally to set the radius.

       Plane  To create	a new infinite	plane,	click  anywhere	 the  viewport
	      which  resembles	the desired plane. For example,	a click	in the
	      X-Y view will create an infinite X-Y plane (i.e. with  a	normal
	      toward the Z vector).

       Sphere To create	a new sphere, click to place the center	of the sphere,
	      then drag	to choose the radius.

	      Left click to choose the center of the SuperEllipsoid.  A	dialog
	      box  appears asking for two exponents of the superellipsoid. Ex-
	      ponents near zero	lead to	sharp edge, and	exponents greater than
	      two lead to pinchy objects.

       Sor    Left  click to place the Surface of Revolution, and a dialog box
	      appears, allowing	modification of	the key	points and a choice of
	      splines connecting them rather than straight lines.

       The CSG Tree is a window	gives you an insight as	to how the objects are
       connected and related. Clicking on an object's name in the CSG Tree se-
       lects  or deselects the object.	Currently its only other use is	to al-
       low you to make specific	objects	invisible by clicking on  the  eye  at
       the  left of each object's row in the "Visible" column. Note that it is
       possible	to have	an object invisible but	selected. If  you  modify  the
       selected	shapes at this point, the invisible ones will be affected too.
       The objects dimensions are in the far right column marked  "Info",  and
       the  centre  "Tree"  shows  the graphic artist's	version	of a directory
       tree, and you will find that it works a lot like	a File	Manager	 util-
       ity.  Logical  branches	of a complex object can	be individually	opened
       and closed much as directories are on a hard disk.

       Eventually this will be a powerful tool showing the structure  of  your
       model  and allowing you to assign portions of models to specific	groups
       and boolean operations.

       giram accepts the following options:

	-h, --help
	      Display this list	of commandline options.

       -v, --version
	      Output version information.

       -g, --giramrc giramrc
	      Use an alternate giramrc file.

       --system-gimprc gimprc
	      Use an alternate system gimprc file.

	      Show startup messages.

       -c, --console-messages
	      Display warnings to console instead of a dialog box.

	      Enable non-fatal debugging signal	handlers.

       --enable-stack-trace [never | query | always_
	      Debugging	mode for fatal signals.

       --display display
	      Use the designated X display.


       Copyright (C)  2001 DindinX

       Permission to use, copy,	modify,	and distribute this software  and  its
       documentation  for  any purpose and without fee is hereby granted, pro-
       vided that the above copyright notice appear in	all  copies  and  that
       both  that  copyright  notice and this permission notice	appear in sup-
       porting documentation.

       povray(1), x-povray(1), giramrc(5)

       The primary author of Giram is

	 David Odin, a.k.a. DindinX, who can  be  reached  at  David.Odin@big-

Version	0.3.5			11 October 2001			      giram(1)


Want to link to this manual page? Use this URL:

home | help