# Agave Manual

## Einleitung

Agave is an application for the GNOME desktop that allows you to select an initial color and generate a variety of different colorschemes from that color. The primary audience of this application is graphic designers (and particularly web designers) though it can be used for anything where you might need to pick several colors that go well together, such as painting rooms in your house.

## Der Anfang

Dieses Kapitel erklärt, wie Agave gestartet wird und gibt eine grundlegende Übersicht über dieses Programm.

### Agave starten

Agave kann auf folgende Arten gestartet werden:

Applications menu

- Choose Graphics Agave .

Kommandozeile

- Type `agave`, then press Return.

### Das Agave Fenster

When you start Agave, you will see a window that looks very much like the following:

#### Agave Window

Shows Agave main window.

The Agave window contains the following elements:

Menüleiste

- The menus on the menubar contain all of the commands you need to use Agave.

Werkzeugleiste

- Die Werkzeugleiste beinhaltet einen Teil der Befehle, auf die mit der Menüleiste zugegriffen werden kann.

Schema Darstellungsbereich

- Die Schema Darstellungsbox beinhaltet verschiedene umfangreiche Farbmuster welche ein Farbschema darstellen, die auf den aktuellen Einstellungen basieren. Es beinhaltet auch die Möglichkeit, eine neue Basisfarbe und Schema auszuwählen.

Palette

- The palette offers a selection of color presets that you can click in order to change the current base color. You can choose from several built-in palettes and you can also create and add your own palettes. See sect-palettes for more information.

Favoriten

- Die Favoriten Liste stellt eine Liste von Farben dar, die gespeichert wurden, sowie eine kleine Toolbar, die es erlaubt die Liste zu bearbeiten.

Statusleiste

- Die Statusleite ist so ziemlich unbrauchbar. Ich sollte sie loswerden.

## Agave verwenden

### Eine Basisfarbe wählen

Es gibt viele verschiedene Wege eine Farbe auszuwählen, die als Basis für das Farbschema verwendet wird.

#### Der Knopf Farbauswahl

Der einfachste Weg, eine Farbe auszuwählen, ist über den Knopf Farbwauswahl. Ein Klick auf diesen Knopf öffnet folgenden Dialog aus:

##### Color Selection Dialog

Color Selection Dialog

Der Dialog Farbauswahl ermöglicht es, eine Basisfarbe auf verschiedene Arten zu wählen:

- Angabe von Farbton, Sättigung und Wert

- Angabe der Komponenten Rot, Grün und Blau

- Auswahl aus einem Farbkreis

- Wahl einer Farbe von einem beliebigen Punkt auf dem Bildschirm (Werkzeug Pipette)

Das Verwenden des Knopfes Farbauswahl ist wahrscheinlich die beste Art, wenn bekannt ist, welche Farbe als Basisfarbe verwenden werden soll.

#### Paletten

Ein anderer Weg eine Basisfarbe auszuwählen ist eine der Farbpaletten im unteren Bereich des Programmfensters auszuwählen. Diese Paletten stellen eine Vielzahl von voreingestellten Farben dar, die als Startpunkt verwendet werden können. Eine der Farben kann als Basisfarbe ausgewählt werden, indem man einfach darauf klickt.

You can add your own custom palettes to Agave so that they will show up in the palettes selector. To do so, you must first create a palette file. A palette file is a file in the gimp palette format. An trivial example file follows:

    GIMP Palette
    Name: MyPalette
    #
      0   0   0 Black
    255   0   0 Red
      0 255   0 Green
      0   0 255 Blue
    255 255 255 White

All palette files must start with the `GIMP Palette` header and a palette name. You can optionally include a comment starting with a `#`. The remaining lines define individual colors' red, green, and blue components ranging from 0 to 255.

Your palette file should be saved with a `.gpl` extension and saved in home home directory at `.local/share/agave/palettes/`. If your file is well-formed, Agave will load your custom palette next time you restart the application.

#### Favoriten

Wenn vorher bereits Farben als Favoriten in der Favoritenliste gespeichert wurden, kann eine dieser Farben als Basisfarbe für das Farbschema verwenden, indem es in der Liste ausgewählt wird.

#### Zufällig

If you're really stuck and need some inspiration, you can also have Agave generate a random base color for you. You can do this by clicking the Random button on the toolbar. Alternately, you can select Ctrl R Edit Random from the menu.

### Wahl eines Schema Typs

Agave allows you choose from several different types of color schemes. These color schemes are explained below. In addition, a diagram is provided for each scheme which shows the relationships between the generated colors on a color wheel.

Komplementare Farbe

- Erzeugt ein 2-farbiges Schema bestehend aus der Basisfarbe und einer Farbe im Farbkreis direkt gegenüber der Basisfarbe

  #### Komplementare Farbe

  Shows complementary color scheme

zwei halb-komplementäre Farben

- Erzeugt ein 3-farbiges Schema bestehend aus der Basisfarbe und zwei Farben die ein bisschen versetzt von der Komplementärfarbe sind

  #### Split Complements

  Shows split-complementary color scheme

Dreiergruppe

- Erzeugt ein 3-farbiges Schema bestehend aus der Basisfarbe und zwei anderen Farben mit gleichem Abstand auf dem Farbkreis

  #### Dreiergruppe

  Shows triads color scheme

Vierergruppe

- Erzeugt ein 4-farbiges Schema bestehend aus der Basisfarbe und drei weiteren Farben mit gleichem Abstand auf dem Farbkreis

  #### Vierergruppe

  Shows tetrads color scheme

sinngemässe Farben

- Erzeugt ein 3-farbiges Schema bestehend aus der Basisfarbe und zwei weiteren Farben mit ein wenig Abstand

  #### sinngemässe Farben

  Shows analogous color scheme

Einfarbig

- Erzeugt ein 3-farbiges Schema bestehend aus der Basisfarbe und zwei weiteren Farben mit dem gleichen Farbton, aber mit abweichender Sättigung

## Über Agave

Agave was written by Jonathon Jongsma. To find more information about Agave, please visit the Agave project website.

To report a bug or make a suggestion regarding this application or this manual, see the Feedback section of the GNOME User Guide.

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.