# &app; Manual V&manrevision;

2002
Nicholas Curran
GNOME Documentation Project

&legal;

Nicholas
Curran
GNOME Documentation Project

     quasar@austar.net.au

&app; Manual V&manrevision;
&date;

Nicholas Curran quasar@austar.net.au

GNOME Documentation Project

This manual describes version &appversion; of &app;.

## Feedback

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

## Introduction

The objective of &app; is to remove as many balls from the playing area in as few moves as possible.

The playing area contains three types of balls. Each type is a different color. Balls of the same type in squares that border each other are grouped together. If you click on one ball in a group, you remove all of the balls in that group. You cannot remove a ball that is not part of a group. There have two be two balls of the same type adjacent to each other before they can be removed.

You can tell which balls are in a group by moving your mouse over the playing area. Balls which are in the same group as the ball your mouse is over rotate.

The number of points you receive is based on how many balls you remove in one click. All balls move down when the balls beneath them are removed.

The game is over when you cannot remove any more balls.

## Getting Started

### To Start &app;

You can start &app; in the following ways:

Applications menu

  Choose Games &app; .

Command line

  To start &app; from a command line, type the following command, then press Return:

  `same-gnome`

### When You Start &app;

When you start &app;, the following window is displayed.

#### &app; Start Up Window

The &app; window contains the following elements:

Menubar.

  The menus on the menubar contain all of the commands you need to play &app;.

Statusbar.

  The status bar displays the following information:

  - The left panel shows information about menu items in &app;.

  - Your score is shown on the right.

## Playing Same GNOME

A new game is started when you start &app;. To start a new game manually, choose Game New game .

To remove a group of balls, click on a ball that is in that group. When your mouse is over a ball that is part of a group, the balls in that group rotate.

The game is over when no groups of balls remain. If there are no balls left, you receive a bonus 1000 points. At the end of the game, &app; will display the Scores dialog.

You can also view the high score list at any time by choosing Game Scores... .

## Settings

The Preferences dialog allows you to change the scenario. A scenario determines what the balls look like in &app;.

To open the Preferences dialog, choose Settings Preferences... . The Preferences dialog is shown in .

### &app; Preferences Dialog

To change the current scenario, select an option from the Select scenario drop-down list box. The balls in the playing area will change automatically. shows the main window using the planets.png scenario.

### &app; Main Window Using planets.png Scenario

## Creating Scenarios

Each scenario is a graphics file. Each graphics file contains frames of animation which are shown when the mouse is moved over a group of balls.

Every frame must measure 40 by 40 pixels. There must be three rows of frames in each graphics file. Each row represents one type of ball. The number of columns of frames depends on how many frames of animation you need.

The graphics files must be in Portable Network Graphics (PNG) format.

For &app; to be able to use your scenario, the scenario must be placed in `$prefix/share/pixmaps/same-gnome/` . $prefix is the directory in which GNOME is installed. $prefix is usually either `/usr/include` or `/usr/local/include`.

shows the graphics file used for the blink-sync.png scenario.

### Grapics File for Blink-Sync.png Scenario

## About &app;

&app; was written by the following people:

- Miguel de Icaza (miguel@nuclecu.unam.mx)

- Federico Mena (federico@nuclecu.unam.mx)

- Horacio J. Peañ (horape@compendium.com.ar)

To report a bug or make a suggestion regarding this application or this manual, follow the directions in this document.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this link, or in the file COPYING included with the source code of this program.