# Gnometris Manual

Gnometris is GNOME's version of Tetris, the classic game of interlocking four-piece blocks. As they fall from the top, the player must orient them to fit the other blocks at the bottom so that they form a complete horizontal line, in which case that line disappears and the player gains points.

2004
Angela Boyle
2009
Philip Withnall (philip@tecnocode.co.uk)
GNOME Documentation Project

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation Licence (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this link or in the file COPYING-DOCS distributed with this manual.

This manual is part of a collection of GNOME manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the licence to the manual, as described in section 6 of the licence.

Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and the members of the GNOME Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.

DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENCE WITH THE FURTHER UNDERSTANDING THAT:

1. DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENCE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS AUTHORISED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND

2. UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.

Angela
Boyle

     anjela@u.washington.edu

Gnometris Manual V2.8
June 2004

Angela Boyle anjela@u.washington.edu

GNOME Documentation Project

This manual describes version 2.12 of Gnometris.

## Feedback

To report a bug or make a suggestion regarding the Gnometris application or this manual, follow the directions in the GNOME Feedback Page.

## Introduction

Gnometris comes from the classic falling-block game, Tetris. The goal of the game is to create complete horizontal lines of blocks, which will disappear. The blocks come in seven different shapes made from four blocks each: one straight, two L-shaped, one square, and two S-shaped. The blocks fall from the top centre of the screen in a random order. You rotate the blocks and move them across the screen to drop them in complete lines. You score by dropping blocks fast and completing lines. As your score gets higher, you level up and the blocks fall faster.

To run Gnometris, select Applications Games Gnometris, or type `gnometris` in the command line.

Gnometris is included in the `gnome-games` package, which is part of the GNOME desktop environment. This document describes version 2.8 of Gnometris.

## Playing Gnometris

You can score through two actions: completing lines and dropping blocks quickly.

### Moving the Blocks

To play the game, you only need the four arrow keys.

- Left and Right move the block correspondingly across the screen.

- Up rotates the block. The default rotation is counterclockwise. You can change the rotation under Settings Preferences and deselecting Rotate blocks counterclockwise.

- Down and the Space bar move the block down the screen faster.Down moves the block down faster. Space bar moves the block directly to the bottom.

### Starting a New Game

To begin a new game, go to Game New Game. The game will begin dropping blocks from the centre of the top of the window. The default start-up of the game has no blocks in the game window and shows the next block that will fall in the upper right-hand corner. Score shows the number of points you have earned. Lines shows the number of lines you have completed. Level shows the level of difficulty you are on.

### Pausing the Game

To pause your game, go to Game Pause Game. You can only pause a game when you are playing. The time limit on pausing your game is unlimited. To unpause the game, go back to Game Pause Game.

### Ending the Game

Go to Game End Game to end your current game without quitting Gnometris.

### Quitting Gnometris

To completely quit Gnometris go to Game Quit. If you are in the middle of a game when you quit, you will end your game without saving your score.

### Scoring Points

You score points through two methods: dropping blocks faster and deleting complete lines of blocks. When you delete lines, you get more points, but dropping blocks faster will quickly add up. As you level up, the blocks will begin falling faster. The highest level is 10, at which point you will only have just over a second to manipulate each block.

### Viewing Past Scores

You can view the top ten scores played on your computer through Game Scores. The names of the users are shown next the their score and the date they played.

## Customising Gnometris

### Customising Game Start-up

By going to Settings Preferences, you can customise a variety of features for the start-up of each Gnometris game: number and density of pre-filled rows, and starting level. Pre-filled rows refers to how many rows will already have blocks in them when you start each new game.

#### Number of Pre-filled Rows

You can change the number of rows that already have blocks at the start-up of each new game by using the spin box. You can start with up to 19 rows pre-filled at the start-up of your game. The default number of pre-filled rows is zero.

#### Density of Pre-filled Rows

You can change the density of the blocks in the pre-filled rows at the start-up of each game. You can choose a density up to 10 blocks. You should first choose how many rows you want pre-filled under Number of Pre-filled Rows. The default density of blocks is three.

#### Level to Start On

You can adjust the level of difficulty you start on. The highest level you can start on is 10, which is the highest level you can play to. The default starting level is one.

### Customising the Blocks

From Settings Preferences, you can customise a variety of features related to the blocks: previewing the next block, block colours, and block rotation.

#### Enable sounds

Turn the sound effects on and off using this option. If you are playing this game in any area which you share with other people, you should probably select off.

#### Preview Next Block

Choose this option if you want to see the next block that is going to fall. This feature helps you plan the placement of your blocks.

#### Use Random Block Colours

Choose if you want the various block configurations to be colour coded or randomly coloured. If you use the colours to help you identify blocks, random colours will make the game more difficult.

#### Rotate Blocks Counterclockwise

Choose this option if you want the blocks to rotate counterclockwise or not.

#### Show where the block will land

If this feature is used a grey image of the block will show you where the block will land. This feature is very useful for beginning players, but experienced players will find it a distraction.

### Customising the Look of Gnometris

Under Settings Preferences, you can customise the look of Gnometris: images for the blocks.

#### Block Image

You can change the style of the blocks, including image and size. There are a variety of pre-made styles.

#### Background

If you drag your favourite image into the Gnometris window it will be used as the background. If you want a solid colour as the background, drag one in from either the colour picker or from Nautlilus' Backgrounds and Emblems dialogue (the reset item from that dialogue also works).

## Authors

Gnometris was written by J. Marcin Gorycki in 1999 and maintained by the GNOME Games Team since then. This manual was written by Angela Boyle. To report a bug or make a suggestion regarding this application or this manual, follow the directions in this document.

## Licence

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public Licence as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public Licence for more details.

A copy of the GNU General Public Licence is included as an appendix to the GNOME Users Guide. You may also obtain a copy of the GNU General Public Licence from the Free Software Foundation by visiting their Web site or by writing to

     Free Software Foundation, Inc. 59 Temple Place - Suite 330 Boston, MA02111-1307USA