1 2NAME 3 xjig - the jigsaw puzzle 4 5SYNOPSIS 6 xjig <options> 7 8DESCRIPTION 9 XJig is a puzzle, that tries to replicate a jigsaw puzzle 10 on the screen as close as possible. As in every jigsaw 11 puzzle, the goal is to set all the pieces together. If you 12 like, you can watch the time that you spent for it. 13 14 Any image-file in gif-format can be used as the source for 15 the puzzle, which is then randomly created regarding the 16 sizes selected by the options. 17 18 The control should be as intuitive as possible in the way 19 that you will usually pull the freely rotatable pieces at 20 one edge, drag them to the desired destination and drop 21 them so they will snap together easily when close to an 22 neighboured tile. 23 24 25SPECIAL EFFECTS 26 Tiles are freely formed and rotatable with texture mapping 27 routines to give the appearance of a real mess on the 28 screen. 29 30 Tiles snap together very easy if they are dropped some- 31 where close to another matching tile, when turned in the 32 correct direction. 33 34 Puzzles can be doubled sided so you might have to flip the 35 tiles to the correct side to let them snap together. 36 37 If the Xserver supports the Shape-Extension, the tiles can 38 be opened directly on the desktop, which is a pretty show- 39 case, but you need a very fast machine for really getting 40 this playable. (Any ideas on how to add double buffering 41 to the shaped-window approach of the jigsaw are warmly 42 welcome!) 43 44 45CONTROLS 46 The usual way to move the pieces on the screen should be 47 to drag the piece with the left mouse button to their des- 48 tination by pulling them at on edge. The piece will auto- 49 matically rotate like if you pull or push them with your 50 fingertip on a table. 51 52 In addition, the following movements are possible: 53 54 click left: rotate 90 degrees left 55 click right: rotate 90 degrees right 56 click middle: flip tile to backside 57 drag left: rotator drag (as mentionned above) 58 +middle: pause rotator drag for a straight drag 59 drag middle: straight drag 60 +left: pause drag for a static rotation 61 +click left: rotate 90 degrees left during drag 62 +click right: rotate 90 degrees right during drag 63 CTRL+click left: same as click middle 64 65 The right button has actually the same functionality as 66 the middle button so that 2 button systems shouldn't have 67 problems. Only the "drag middle+click right" move will not 68 work in that mode, and the flipping has to be done with 69 the help of the CTRL-key. 70 71 72OPTIONS 73 Tile Selection 74 -file name use the specified file as the source image for 75 the puzzle 76 77 -side p select the side of the image to be on top, if 78 you don't like the mess with the double sided 79 tiles. 80 81 Size Selection 82 -w x Select number of tiles in horizontal direc- 83 tion. The Images are automatically rotated in 84 portrait orientation before they are sliced. 85 Therefore x usually should be smaller than y 86 of the next option. 87 88 -h y Select number of tiles in vertical direction 89 respectively. 90 91 -ts n Select average tile width. Instead of explic- 92 itly specifying the number of tiles by using 93 the previous options -w and -h, the average 94 tile width in pixels can be selected and the 95 values for x and y above are computed accord- 96 ing to to the selected size. 97 98 Image Options 99 -ww x Select width of image in pixels. This can be 100 used to scale the image before playing for the 101 case that a very large image is the source. 102 103 -wh h Select height of image in pixels. If only one 104 of -ww and -wh, the aspect ratio is kept con- 105 stant. 106 107 -no_crop The image is usually automatically cropped, 108 since many images are surrounded by frames or 109 textual comments. The cropping stops at a 110 reasonable amount of colors per line or row. 111 If this is not desired of if you want to puz- 112 zle with painted images with few color, you 113 should disable this feature. 114 115 -no_flip Before tiling takes place, a landscape image 116 is rotated to portrait mode, which effects 117 successive options like -w or -ww. If this is 118 not desired, you can switch this feature off. 119 120 121 X-Window options 122 -display name 123 Select the display to connect to. 124 125 -shapes If the SHAPE-extension is supported by your 126 display, you can use this option to let each 127 puzzle tile appear in its own shaped window. 128 The results might depend on the behaviour of 129 the window-manager. The manager is actually 130 advised by the override redirect attribute 131 flag of the puzzle shapes not to do anything 132 with them. But who knows ... 133 134 -no_shm When the program was build with support of the 135 MIT-SHM extension, it might crash when started 136 to display on a remote machine or X-terminal. 137 You can deselect the usage of the extension 138 with this option. 139 140 141 Miscellaneous 142 -no_anim Turns off animation of rotation and flipping, 143 for the case the machine isn't fast enough to 144 make it look nice. 145 146 147ZOOMING & PANNING 148 For not losing tiles at the window border and for getting 149 more workspace, the game has some zooming and panning fea- 150 tures to control the view on your desk. They are con- 151 trolled via the keyboard with the following functionality: 152 153 Cursor Keys: Pan View 154 Page-Up or Add: Zoom in 155 Page-Down or Sub: Zoom out 156 Home: Reset to original size 157 End: Set maximum zooming to view all tiles 158 159 The image quality usually suffers from zooming, since gif- 160 images are usually dithered to be viewed best in their 161 original size. This also applies to the size options -ww 162 and -wh. 163 164 165Color Allocation 166 The program was tested on PseudoColor- and TrueColor- 167 displays. On PseudoColor-displays the program might run 168 out of colors, since colors are very limited and it has to 169 share its colors with other clients. It tries to share 170 similar colors with other clients. But if too may color 171 consuming clients are running, the image-quality will suf- 172 fer. You should stop other clients in that case or you 173 might quantize the image to a fewer number of colors with 174 packages like ImageMagick, xv or netpbm. 175 176SEE ALSO 177 X(1), convert(1), xv(1), ppmquant(1) 178 179 180COPYRIGHT 181 Copyright 1996, Helmut Hoenig, Heiligenhaus 182 183 email (for any comments): 184 Helmut.Hoenig@hub.de 185 186 smail (for gifts): 187 Helmut Hoenig 188 Hopfenstrasse 8a 189 65520 Bad Camberg 190 GERMANY 191 192 ******************************************************** 193 194 By the way, I am collecting banknotes! If you want 195 to join into my collection, get any bill of your 196 country, sign it on the backside and send it to me 197 so I will pin it on my world map. 198 (Don't forget the exact location for the pin :-) 199 But you can also just send me a picture postcard ... 200 201 ******************************************************** 202 203 Permission to use, copy, modify, and distribute this soft- 204 ware for any purpose and without fee is hereby granted, 205 provided that the above copyright notice appear in all 206 copies. 207 208 209 other fancy things from the author 210 xcol (1990) - color selector for editing text-files 211 flying (94/95) - pool billard simulation 212 xdefmap (1995) - enhanced tool for setting up standard colormaps 213 xmemory (95/96)- memory with simultaneous multiplayer action 214 215 available at ftp.x.org and its mirrors 216