THERION(1) General Commands Manual THERION(1)NAME
loch -- Therion model viewer
SYNOPSIS
loch
DESCRIPTION
This manual page documents loch, which is part of the therion-viewer package.
loch is a 3D viewer which displays .lox files produced by therion and allows them to be examined.
OPTIONS
loch takes no options.
BASIC CONTROL
Key and Mouse Controls
Function Mouse action Key
Zoom & Rotate Left click + drag
Zoom only Left click + drag up/down, then hold left and click right Ctrl + Up/Down
Rotate only Left click + drag left/right, then hold left and click right Left/Right
Pan Right click + drag Shift + Arrows
Tilt Middle (wheel) click + drag or wheel rotate Up/Down
Full screen Left double click F11
Context menu Right click
If continuous rotation is turned on, then rotation mouse movements change the speed or direction of rotation. If rotation is locked, then
rotation mouse movements have no effect.
OFF SCREEN RENDERING
Loch is able to render large bitmaps that can be afterwards post processed and printed. Bitmaps can be exported in PDF, PNG or BMP formats.
Configuration of export is done via the Rendering setup dialog. You can set the following features:
Size and Scaling
Screen shot: Screen copy will be saved into a file with no other changes.
Image width: The screen image will be exported with the specified width.
Image height: The screen image will be exported with the specified height.
Scale: The screen image will be exported with the specified scale.
Image options
Rendering resolution: Resolution of the image file used when image size or scale are specified.
Image size: Image size in pixels and uncompressed bytes calculated from previous settings.
White background: Force white background in exported image.
KNOWN BUGS
Sometimes empty rectangles appear in off screen rendered file. Changing the window size usually helps.
* Crashes have been observed on intel graphics cards unless the
texture initialisations are removed in the code.
* Stereo mode does not work correctly on some graphics adapters.
* This help does not work.
SEE ALSO
therion (1), xtherion (1).
For full information see the Therion Manual in /usr/doc/therion/thbook which describes therion-viewer and its use in detail.
AUTHOR
This manual page was adapted from existing docs by Wookey wookey@debian.org for the Debian system (but may be used by others). Permission
is granted to copy, distribute and/or modify this document under the terms of the GNU General Public Licence, Version 2 or any later ver-
sion published by the Free Software Foundation.
THERION(1)
Check Out this Related Man Page
xjig(6) Games Manual xjig(6)NAME
xjig - the jigsaw puzzle
SYNOPSIS
xjig <options>
DESCRIPTION
XJig is a puzzle, that tries to replicate a jigsaw puzzle on the screen as close as possible. As in every jigsaw puzzle, the goal is to set
all the pieces together. If you like, you can watch the time that you spent for it.
Any image-file in GIF, JPEG, or PPM format can be used as the source for the puzzle, which is then randomly created regarding the sizes
selected by the options.
The control should be as intuitive as possible in the way that you will usually pull the freely rotatable pieces at one edge, drag them to
the desired destination and drop them so they will snap together easily when close to an neighboured tile.
SPECIAL EFFECTS
Tiles are freely formed and rotatable with texture mapping routines to give the appearance of a real mess on the screen.
Tiles snap together very easy if they are dropped somewhere close to another matching tile, when turned in the correct direction.
Puzzles can be doubled sided so you might have to flip the tiles to the correct side to let them snap together.
If the Xserver supports the Shape-Extension, the tiles can be opened directly on the desktop, which is a pretty showcase, but you need a
very fast machine for really getting this playable. (Any ideas on how to add double buffering to the shaped-window approach of the jigsaw
are warmly welcome!)
CONTROLS
The usual way to move the pieces on the screen should be to drag the piece with the left mouse button to their destination by pulling them
at on edge. The piece will automatically rotate like if you pull or push them with your fingertip on a table.
In addition, the following movements are possible:
click left: rotate 90 degrees left
click right: rotate 90 degrees right
click middle: flip tile to backside
drag left: rotator drag (as mentionned above)
+middle: pause rotator drag for a straight drag
drag middle: straight drag
+left: pause drag for a static rotation
+click left: rotate 90 degrees left during drag
+click right: rotate 90 degrees right during drag
CTRL+click left: same as click middle
The right button has actually the same functionality as the middle button so that 2 button systems shouldn't have problems. Only the "drag
middle+click right" move will not work in that mode, and the flipping has to be done with the help of the CTRL-key.
OPTIONS
Tile Selection
-file name use the specified file as the source image for the puzzle
-side p select the side of the image to be on top, if you don't like the mess with the double sided tiles.
Size Selection
-w x Select number of tiles in horizontal direction. The Images are automatically rotated in portrait orientation before they are
sliced. Therefore x usually should be smaller than y of the next option. The default is four.
-h y Select number of tiles in vertical direction respectively. The default is six.
-ts n Select average tile width. Instead of explicitly specifying the number of tiles by using the previous options -w and -h, the
average tile width in pixels can be selected and the values for x and y above are computed according to to the selected size.
Image Options
-ww x Select width of image in pixels. This can be used to scale the image before playing for the case that a very large image is the
source.
-wh h Select height of image in pixels. If only one of -ww and -wh, the aspect ratio is kept constant.
-no_crop The image is usually automatically cropped, since many images are surrounded by frames or textual comments. The cropping stops
at a reasonable amount of colors per line or row. If this is not desired of if you want to puzzle with painted images with few
color, you should disable this feature.
-no_flip Before tiling takes place, a landscape image is rotated to portrait mode, which effects successive options like -w or -ww. If
this is not desired, you can switch this feature off.
X-Window options
-display name
Select the display to connect to.
-shapes If the SHAPE-extension is supported by your display, you can use this option to let each puzzle tile appear in its own shaped
window. The results might depend on the behaviour of the window-manager. The manager is actually advised by the override redi-
rect attribute flag of the puzzle shapes not to do anything with them. But who knows ...
-no_shm When the program was build with support of the MIT-SHM extension, it might crash when started to display on a remote machine or
X-terminal. You can deselect the usage of the extension with this option.
Miscellaneous
-no_anim Turns off animation of rotation and flipping, for the case the machine isn't fast enough to make it look nice.
ZOOMING &; PANNING
For not losing tiles at the window border and for getting more workspace, the game has some zooming and panning features to control the
view on your desk. They are controlled via the keyboard with the following functionality:
Cursor Keys: Pan View
Page-Up or Add: Zoom in
Page-Down or Sub: Zoom out
Home: Reset to original size
End: Set maximum zooming to view all tiles
The image quality usually suffers from zooming, since gif-images are usually dithered to be viewed best in their original size. This also
applies to the size options -ww and -wh.
Color Allocation
The program was tested on PseudoColor- and TrueColor-displays. On PseudoColor-displays the program might run out of colors, since colors
are very limited and it has to share its colors with other clients. It tries to share similar colors with other clients. But if too may
color consuming clients are running, the image-quality will suffer. You should stop other clients in that case or you might quantize the
image to a fewer number of colors with packages like ImageMagick, xv or netpbm.
SEE ALSO X(1), convert(1), xv(1), ppmquant(1)COPYRIGHT
Copyright 1996, Helmut Hoenig, Heiligenhaus
email (for any comments):
Helmut.Hoenig@hub.de
smail (for gifts):
Helmut Hoenig
Hopfenstrasse 8a
65520 Bad Camberg
GERMANY
********************************************************
By the way, I am collecting banknotes! If you want
to join into my collection, get any bill of your
country, sign it on the backside and send it to me
so I will pin it on my world map.
(Don't forget the exact location for the pin :-)
But you can also just send me a picture postcard ...
********************************************************
Permission to use, copy, modify, and distribute this software for any purpose and without fee is hereby granted, provided that the above
copyright notice appear in all copies.
other fancy things from the author
xcol (1990) - color selector for editing text-files
flying (94/95) - pool billard simulation
xdefmap (1995) - enhanced tool for setting up standard colormaps
xmemory (95/96)- memory with simultaneous multiplayer action
available at ftp.x.org and its mirrors
X Version 11 July-23-1996 xjig(6)