Debian Codegraph @

ipl/gpacks/htetris/editor.html

raw
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
2 <!--NewPage-->
3 <html>
4 <head>
5 <title>htetris documentation</title>
6 </head>
7 <body>
8 <h1>
9 <center>User Manual For htetris Version 1.0</center>
10 <center>Henrik Sandin 1999</center>
11 </h1>
12 <hr>
13 <a href="http://lww.CS.Arizona.EDU:80/~henriks/htetrisdoc.html">Main page</a>
14 <h2>The brick editor</h2><br>
15 <font size="5">
16 <b>htetris</b> includes a brick editor where the user can create his/hers own
17 bricks and include them when playing the game.
18 A brick consists of squares, or tiles, which is the basic unit of measurement
19 for a brick. A brick must be at least one square and at most ten by ten squares
20 in size. Any rectangular format in between is allowed.<br>
21 The editor interface consists of an area where bricks are edited, a menu bar
22 with three menus and two buttons as shown below.<br>
23 <br>
24 <img src="http://lww.CS.Arizona.EDU:80/~henriks/editscreen.gif" alt="Editor screenshot.">
25 <br>
26 <br>
27 To fill a square on the edit pane, the user points the mouse at that square
28 and clicks the left mouse button. The right mouse button is used to erase
29 a filled square. Only one color per brick can be used.<br>
30 The upper left corner of the currently edited brick resides in the upper left
31 corner of the edit pane. It is not possible to fill a square outside the
32 bounds of the current brick. There is a grid which shows the bounds when it
33 is shown. The grid can be switched on and off by pressing the
34 <b>Toggle grid</b> button on the interface. The <b>Clear</b> button clears
35 whatever filled squares there are but does not affect the grid.
36 A brick can take on any shape, even unconnected regions in the same brick.<br>
37 A brick can be saved to file and previously saved bricks can be opened and
38 re-edited. All features are described in detail below.
39 </font>
40
41 <h2>Menu items and features</h2><br>
42 <font size="5">
43 <ul type="square">
44 <li>The <b>File</b> menu<br><br>
45 <ul type="disc">
46 <li><b>New</b><br>
47 Lets the user start editing a new brick of the chosen size and color.
48 A brick must be at least one by one and at most ten by ten in size.<br>
49 Valid colors are: yellow, red, blue, green, orange, magenta, cyan and brown.<br>
50 When the user clicks <b>Okay</b> in the dialog box, an empty grid of the given
51 size shows up on the edit pane.
52 <li><b>Open</b><br>
53 If <b>Open</b> is selected, a dialog appears which prompts the user for the
54 filename of a previously saved brick. Brick files always have the extension
55 <b>.brk</b> but this is not necessary to include, although it is perfectly
56 alright to do so.<br>
57 If the file is valid and could be opened successfully, the editor resets itself
58 to the measurements and color of the loaded brick and the brick appears with
59 the grid on.
60 <li><b>Save</b><br>
61 The user enters a filename in the shown dialog box and the brick is saved
62 under that name. If the extension <b>.brk</b> is not added to the name, the
63 editor automaticly adds it before saving. If the user enter a name with
64 characters after <b>.brk</b>, those are discarded. Saving can not be performed
65 if there are no filled squares. If not all rows and columns are used for the
66 brick to be saved, the brick is stripped of such empty rows and columns before
67 it is saved. This does not apply to empty rows and columns between filled
68 squares, only "edge" rows and columns are stripped off.
69 <li><b>Quit</b><br>
70 This closes the brick editor and returns focus to the htetris application.
71 </ul>
72 <br>
73 <li>The <b>Brick</b> menu<br><br>
74 <ul type="disc">
75 <li><b>Change color</b><br>
76 This changes the color of the currently edited brick in place. From now on,
77 this color is used to fill squares unless color is changed again, a brick is
78 loaded from file or a new brick is started.<br>
79 The same colors as mentioned above under <b>New</b> are valid.
80 </ul>
81 <br>
82 <li>The <b>Help</b> menu<br><br>
83 <ul type="disc">
84 <li><b>How to edit</b><br>
85 This option basicly displays the same information as the first section of this
86 document.
87 <li><b>Menus</b><br>
88 This option basicly displays the same information as the this section of this
89 document.
90 </ul>
91 </ul>
92 </font>
93 </body>
94 </html>