| 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> |