Vektor (Engine Alpha)

java.lang.Object
- ea.Vektor

All Implemented Interfaces:

java.lang.Cloneable
```
public final class Vektor
extends java.lang.Object
implements java.lang.Cloneable
```
Ein Vektor bezeichnet eine relative Punktangabe, ansonsten unterscheidet er sich nicht weiter von einem Punkt.
Vektoren werden meist für die Beschreibung einer Bewegung benutzt.

Author:

Michael Andonie

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`KEINE_BEWEGUNG` Konstante, die widerspiegelt, dass keine Bewegung vollzogen wird.
`static Vektor`	`LINKS` Konstante für eine einfache Verschiebung nach links (-1, 0)
`static int`	`N` Die Konstante für die Richtung Norden
`static int`	`NO` Die Konstante für die Richtung Nordosten
`static Vektor`	`NULLVEKTOR` Konstante für einen "bewegungslosen" Vektor (0, 0)
`static int`	`NW` Die Konstante für die Richtung Nordwesten
`static int`	`O` Die Konstante für die Richtung Osten
`static Vektor`	`OBEN` Konstante für eine einfache Verschiebung nach oben (0, -1)
`static Vektor`	`RECHTS` Konstante für eine einfache Verschiebung nach rechts (1, 0)
`static int`	`S` Die Konstante für die Richtung Süden
`static int`	`SO` Die Konstante für die Richtung Südosten
`static int`	`SW` Die Konstante für die Richtung Südwesten
`static Vektor`	`UNTEN` Konstante für eine einfache Verschiebung nach unten (0, 1)
`static int`	`W` Die Konstante für die Richtung Westen
`float`	`x` Der kontinuierliche DeltaX-Wert des Punktes.
`float`	`y` Der kontinuierliche DeltaY-Wert des Punktes.

Constructor Summary

Constructors
Constructor and Description

Vektor(float x, float y)
Konstruktor.

Vektor(Punkt start, Punkt ziel)
Konstruktor.

Constructors
Constructor and Description
`Vektor(float x, float y)` Konstruktor.
`Vektor(Punkt start, Punkt ziel)` Konstruktor.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Punkt`	`alsPunkt()` Gibt diesen Ortsvektor vom Ursprung der Zeichenebene als Punkt aus. Dieser hat die exakt selben `x`- / `y`-Komponenten.
`Vektor`	`clone()` Erstellt ein neues `Vektor`-Objekt mit demselben Zustan.
`Vektor`	`differenz(Vektor v)` Berechnet die Differenz zwischen diesem und einem weiteren Vektor.
`int`	`dX()` Gibt die `x`-Verschiebung dieses Vektors mit Ganzzahlen wider.
`int`	`dY()` Gibt die `y`-Verschiebung dieses Vektors mit Ganzzahlen wider.
`Vektor`	`einfacher()` Gibt einen einfachen Vektor zurück, dessen Richtungskomponenten nur `-1`, `0` oder `1` annehmen.
`boolean`	`equals(java.lang.Object o)` Prüft, ob ein beliebiges Objekt gleich diesem Vektor ist.
`Vektor`	`gegenrichtung()` Berechnet die Gegenrichtung des Vektors.
`boolean`	`istEchtGanzzahlig()` Gibt zurück, ob dieser Vektor echt ganzzahlig ist, also ob seine tatsächlichen Delta-Werte beide Ganzzahlen sind.
`float`	`laenge()` Gibt die Länge des Vektors aus.
`float`	`manhattanLength()` Gibt die Manhattan-Länge des Vektors zurück.
`Vektor`	`multiplizieren(float faktor)` Multipliziert die effektiven Längen beider Anteile des Vektors (`x` und `y`) mit einem festen Faktor.
`Vektor`	`normiert()` Gibt eine Normierung des Vektors aus.
`float`	`realX()` Gibt die `x`-Verschiebung dieses Vektors wider.
`float`	`realY()` Gibt die `y`-Verschiebung dieses Vektors wider.
`int`	`richtung()` Berechnet die Richtung des Vektors, in die er wirkt. Der Rückgabewert basiert auf den Konstanten der eigenen Klasse und sind entweder die Basiswerte (`N / S / O / W`) oder die Kombiwerte (`NO / NW / SO / SW`).
`float`	`skalarprodukt(Vektor v)` Berechnet das Skalarprodukt von diesem Vektor mit einem weiteren.
`Vektor`	`summe(Vektor v)` Berechnet die effektive Bewegung, die dieser Vektor und ein weiterer zusammen ausüben.
`Vektor`	`teilen(float divisor)` Teilt die effektive Länge des Vektors durch eine Zahl und kürzt dadurch seine Effektivität.
`java.lang.String`	`toString()` Gibt die String-Repräsentation dieses Objektes aus.
`boolean`	`unwirksam()` Berechnet, ob dieser Vektor keine Wirkung hat.
`static Vektor`	`vonKonstante(int konstante)` Berechnet einen einfachen Vektor (maximale Auslenkung bei jeder Achse 1 (positiv wie negativ)), der der entsprechenden Konstante dieser Klasse entspricht möglich sind: `N`, `S`, `O`, `W`, `NO`, `NW`, `SO`, `SW`

Methods inherited from class java.lang.Object
finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - NULLVEKTOR
```
public static final Vektor NULLVEKTOR
```
    Konstante für einen "bewegungslosen" Vektor (0, 0)
  - RECHTS
```
public static final Vektor RECHTS
```
    Konstante für eine einfache Verschiebung nach rechts (1, 0)
  - LINKS
```
public static final Vektor LINKS
```
    Konstante für eine einfache Verschiebung nach links (-1, 0)
  - OBEN
```
public static final Vektor OBEN
```
    Konstante für eine einfache Verschiebung nach oben (0, -1)
  - UNTEN
```
public static final Vektor UNTEN
```
    Konstante für eine einfache Verschiebung nach unten (0, 1)
  - KEINE_BEWEGUNG
```
public static final int KEINE_BEWEGUNG
```
    Konstante, die widerspiegelt, dass keine Bewegung vollzogen wird.
    
    See Also:
    
    Constant Field Values
  - W
```
public static final int W
```
    Die Konstante für die Richtung Westen
    
    See Also:
    
    Constant Field Values
  - O
```
public static final int O
```
    Die Konstante für die Richtung Osten
    
    See Also:
    
    Constant Field Values
  - N
```
public static final int N
```
    Die Konstante für die Richtung Norden
    
    See Also:
    
    Constant Field Values
  - S
```
public static final int S
```
    Die Konstante für die Richtung Süden
    
    See Also:
    
    Constant Field Values
  - NW
```
public static final int NW
```
    Die Konstante für die Richtung Nordwesten
    
    See Also:
    
    Constant Field Values
  - NO
```
public static final int NO
```
    Die Konstante für die Richtung Nordosten
    
    See Also:
    
    Constant Field Values
  - SW
```
public static final int SW
```
    Die Konstante für die Richtung Südwesten
    
    See Also:
    
    Constant Field Values
  - SO
```
public static final int SO
```
    Die Konstante für die Richtung Südosten
    
    See Also:
    
    Constant Field Values
  - x
```
public final float x
```
    Der kontinuierliche DeltaX-Wert des Punktes. Die anderen Koordinaten sind ggf. nur gerundet.
  - y
```
public final float y
```
    Der kontinuierliche DeltaY-Wert des Punktes. Die anderen Koordinaten sind ggf. nur gerundet.
- Constructor Detail
  - Vektor
```
public Vektor(float x,
              float y)
```
    Konstruktor.
    
    Parameters:
    
    x - Bewegungsanteil x.
    
    y - Bewegungsanteil y.
  - Vektor
```
public Vektor(Punkt start,
              Punkt ziel)
```
    Konstruktor.
    
    Vektor wird erzeugt als die nötige Bewegung von einem Punkt zu einem zweiten.
    
    Parameters:
    
    start - Ausgangspunkt
    
    ziel - Zielpunkt
- Method Detail
  - normiert
```
public Vektor normiert()
```
    Gibt eine Normierung des Vektors aus. Dies ist ein Vektor, der
  - in die selbe Richtung wie der ursprüngliche Vektor zeigt.
  - eine Länge von (möglichst) exakt 1 hat.

Returns:: Normierter Vektor zu diesem Vektor

teilen
```
public Vektor teilen(float divisor)
```
Teilt die effektive Länge des Vektors durch eine Zahl und kürzt dadurch seine Effektivität.

Parameters:

divisor - Hierdurch wird die Länge des Vektors auf der Zeichenebene geteilt.

Returns:

Vektor-Objekt, das eine Bewegung in dieselbe Richtung beschreibt, allerdings in der Länge gekürzt um den angegebenen Divisor.

Throws:

java.lang.ArithmeticException - Falls divisor 0 ist.

See Also:

multiplizieren(float)

laenge
```
public float laenge()
```
Gibt die Länge des Vektors aus.

Returns:

Länge des Vektors.

gegenrichtung
```
public Vektor gegenrichtung()
```
Berechnet die Gegenrichtung des Vektors.

Returns:

Neues Vektor-Objekt, das genau die Gegenbewegung zu dem eigenen beschreibt.

summe
```
public Vektor summe(Vektor v)
```
Berechnet die effektive Bewegung, die dieser Vektor und ein weiterer zusammen ausüben.

Parameters:

v - zweiter Vektor

Returns:

Neues Vektor-Objekt, das die Summe der beiden ursprünglichen Bewegungen darstellt.

differenz
```
public Vektor differenz(Vektor v)
```
Berechnet die Differenz zwischen diesem und einem weiteren Vektor.

Parameters:

v - zweiter Vektor

Returns:

Die Differenz der beiden Vektoren ("this - v")

multiplizieren
```
public Vektor multiplizieren(float faktor)
```
Multipliziert die effektiven Längen beider Anteile des Vektors (x und y) mit einem festen Faktor.
Dadurch entsteht ein neuer Vektor mit anderen Werten, welcher zurückgegeben wird.

Parameters:

faktor - Der Faktor, mit dem die x- und y-Werte des Vektors multipliziert werden

Returns:

Der Vektor mit den multiplizierten Werten

See Also:

teilen(float)

skalarprodukt
```
public float skalarprodukt(Vektor v)
```
Berechnet das Skalarprodukt von diesem Vektor mit einem weiteren. Das Skalarprodukt für zweidimensionale Vektoren ist: (a, b) o (c, d) = a * b + c * d

Parameters:

v - zweiter Vektor

Returns:

Skalarprodukt dieses Vektoren mit dem Vektor v.

unwirksam
```
public boolean unwirksam()
```
Berechnet, ob dieser Vektor keine Wirkung hat. Dies ist der Fall, wenn beide Komponenten (x und y) 0 sind.

Returns:

true, wenn dieser keine Auswirkungen macht, sonst false.

istEchtGanzzahlig
```
public boolean istEchtGanzzahlig()
```
Gibt zurück, ob dieser Vektor echt ganzzahlig ist, also ob seine tatsächlichen Delta-Werte beide Ganzzahlen sind.

Returns:

true, wenn beide Delta-Werte dieses Punktes ganzzahlig sind, sonst false.

realX
```
public float realX()
```
Gibt die x-Verschiebung dieses Vektors wider.

Returns:

x-Verschiebung dieses Vektors. Positive Werte verschieben nach rechts, negative Werte verschieben nach links.

See Also:

realY()

realY
```
public float realY()
```
Gibt die y-Verschiebung dieses Vektors wider.

Returns:

y-Verschiebung dieses Vektors. Positive Werte verschieben nach unten, negative Werte verschieben nach oben.

See Also:

realX()

einfacher
```
public Vektor einfacher()
```
Gibt einen einfachen Vektor zurück, dessen Richtungskomponenten nur -1, 0 oder 1 annehmen.
-1 bei Werten < 0
0 bei Werten = 0
1 bei Werten > 0

Class Vektor

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

NULLVEKTOR

RECHTS

LINKS

OBEN

UNTEN

KEINE_BEWEGUNG

W

O

N

S

NW

NO

SW

SO

x

y

Constructor Detail

Vektor

Vektor

Method Detail

normiert

teilen

laenge

gegenrichtung

summe

differenz

multiplizieren

skalarprodukt

unwirksam

istEchtGanzzahlig

realX

realY

einfacher

vonKonstante

richtung

equals

clone

toString

dX

dY

alsPunkt

manhattanLength