Table of Contents
0. Quick-Start Guide

1. Introduction

2. How to...
2.1 Run atris
2.2 Play
2.3 Use the keyboard
2.4 Navigate the menus
2.5 Game types

3. Configuration
3.1 Color styles
3.2 Sound styles
3.3 Shape styles
3.4 Special options

4. Game concepts
4.1 Color gravity
4.2 Multiplayer interference
4.3 Power pieces
4.4 Scoring
4.5 Level progression

5. Troubleshooting
5.1 Under Windows
5.2 Under Linux
5.3 Under Macintosh

Appendix A. Create your own styles
Atris: Alizarin Tetris
Documentation

 0. Quick-Start Guide

If you are already familiar with Tetris-like games, just read the sections on color gravity and power pieces, then run the game.

1. Introduction


Atris Opening Screen
In this shot of the opening screen, all of the default options are active.

Alizarin Tetris generally responds to both the mouse and the keyboard. When you start the game you should see a tetris demo in the center of the screen and the Main Menu to the left. You can use the arrow keys to navigate up and down. Pressing enter or clicking with the mouse on one of the options will either bring up a selection submenu, start an actual game, or quit the program, as appropriate.

The submenus allow you to modify your playing environment. Currently, you can select from different Color Styles, Sound Styles, Piece Styles, and Game Types. The current value for each option is displayed in the main menu.

You can also select the Special Options submenu, which contains a set of toggles for special effects.

Each time you modify one of these options, the demo game will restart using your new preferences (so you can get a preview of what they look like without actually playing a game). Also, every time the demo game restarts it will choose a new computer "personality" (AI player).

Table of Contents

2. How to...

This section describes how to perform basic atris actions (like running the game and controlling falling pieces).

2.1 Run atris

Under Linux, you can usually run atris from the command prompt: 

	your_machine$ atris
If you installed atris (via "rpm -i" or "make install"), that should work (atris will probably be in "/usr/bin/"). If you downloaded the source and just compiled it, you must change to the top-level directory of the source distribution to run it: 
	your_machine$ cd /usr/src/atris-1.0.5
	your_machine$ ./atris
The RPM version of atris claims to add links for Gnome and KDE desktops, but we haven't tested them.

Under Windows, you can also run atris from the command prompt: 

	C:\Program Files\atris\> atris.exe
... or by clicking on it via Windows Explorer or somesuch. Note that in any event, atris looks for its game files both in the current directory and in a distribution directory (usually /usr/games/atris/ or C:\Program Files\atris\). If it exits shortly after starting up, make sure those game files are available to it and try running it by hand in the right directory.

2.2 Play

The object of the game is to clear all of the initial "garbage" from the bottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. One at a time, randomly chosen pieces will fall from the top center of the board. You can guide them left and right and also rotate them. Eventually they will settle near the bottom. Whenever you completely fill an entire row (that'ctiottom of the screen. O