Repräsentiert einen Punkt in einem zweidimensionalen Koordinatensystem. Mehr ...

Öffentliche Methoden
	Point ()
	Konstruktor mit Initialisierung auf (0/0) Mehr ...

	Point (int x, int y)
	Konstruktor mit Initialisierung auf die angegebenen Koordinaten. Mehr ...

	Point (const String &s)
	Konstruktor mit Initialisierung auf die im String angegebenen Koordinaten. Mehr ...

bool	isNull () const
	Liefert `true` zurück, wenn sowohl x als auch y 0 sind. Mehr ...

int	manhattanLength () const
	Länge des Vektors in "Manhattan Distance". Mehr ...

Point &	operator*= (double factor)
	Multiplikation mit einem Faktor. Mehr ...

Point &	operator+= (const Point &point)
	Addition mit einem anderen Point. Mehr ...

Point &	operator-= (const Point &point)
	Subtraktion mit einem anderen Point. Mehr ...

Point &	operator/= (double divisor)
	Division mit einem Divisor. Mehr ...

void	setPoint (int x, int y)
	X und Y-Koordinate gleichzeitig setzen. Mehr ...

void	setPoint (const Point &other)
	X und Y-Koordinate von einem anderen Point übernehmen. Mehr ...

void	setX (int x)
	X-Koordinate setzen. Mehr ...

void	setY (int y)
	Y-Koordinate setzen. Mehr ...

double	vectorLength () const
	Länge des Vektors. Mehr ...

Öffentliche Attribute
int	x
	Speichert die X-Koordinate des Punktes. Mehr ...

int	y
	Speichert die Y-Koordinate des Punktes. Mehr ...

Verwandte Funktionen
(Es handelt sich hierbei nicht um Elementfunktionen.)
double	Distance (const Point &p1, const Point &p2)
	Berechnet den Abstand zwischen zwei Punkten. Mehr ...

Ausführliche Beschreibung

Beschreibung:: Diese Klasse repräsentiert einen Punkt in einem zweidimensionalen Koordinatensystem. Zum Speichern der Koordinaten werden Integer (Ganzzahlen) verwendet.

: Ein Punkt wird durch seine X- und Y-Koordinate definiert, die mit den Funktionen setX() und setY() gesetzt und mit x() und y() ausgelesen werden können. Dir Funktionen rx() und ry() liefern Referenzen auf die Koordinaten und erlauben es so die Werte direkt zu manipulieren.

: Beispiele:
Point p1(4,12);

Point p2;

Point p3;

p2.setX(4);

p2.setY(12);

p3.rx()=4;

p3.ry()=12;

: Ein Punkt kann auch als Vektor benutzt werden. Bei Addition und Subtraktion wird jede Komponente separat berechnet. Ein Point-Object kann ausserdem mit einem Integer oder Double multipliziert oder geteilt werden.

Siehe auch: Die Klasse Point3D bietet die gleiche Funktionalität, repräsentiert jedoch einen Punkt in einem dreidimensionalen Koordinatensystem.

Beschreibung der Konstruktoren und Destruktoren

ppl7::grafix::Point::Point ( )

Beschreibung:: Durch Verwendung dieses Konstruktors wird der Punkt mit den Koordinaten (0/0) initialisiert.

ppl7::grafix::Point::Point	(	int	x,
		int	y
	)

Beschreibung:: Durch Verwendung dieses Konstruktors wird der Punkt mit den Koordinaten (x /y ) initialisiert.

Parameter

[in]	x	Die gewünschte X-Koordinate
[in]	y	Die gewünschte Y-Koordinate

ppl7::grafix::Point::Point ( const String & s )

Beschreibung:: Durch Verwendung dieses Konstruktors wird der Punkt mit den im String s vorhandenen Koordinaten initialisiert.

Parameter

[in] s String mit den Komma-getrennten Koordinaten

Dokumentation der Elementfunktionen

bool ppl7::grafix::Point::isNull ( ) const

Beschreibung:: Diese Funktion liefert true zurück, wenn der Punkt die Koordinaten (0/0) enthält.

Rückgabe: Liefert true zurück, wenn x und y 0 sind. Ist dies nicht der Fall, gibt die Funktion false zurück.

int ppl7::grafix::Point::manhattanLength ( ) const

Beschreibung:: Als "Manhattan Länge" bezeichnet man den Abstand zwischen zwei Punkten, berechnet anhand der Längen ihrer rechten Winkel. Auf einer Fläche mit p1=(x1/y1) und p2=(x2/y1) ist die Länge:

: Der Name wurde tatsächlich in Anlehnung an den New Yorker Stadtteil Manhattan gewählt, aufgrund der schachbrettartig angeordneten Strassen.

Rückgabe: Die Länge zwischen dem Ursprung des Koordinatensystems (0/0) und dem Punkt als Integer.

Point & ppl7::grafix::Point::operator*= ( double factor )

Beschreibung:: Mit diesem Operator wird der aktuelle X- und Y-Wert des Punktes einzeln mit factor multipliziert.

Parameter

[in] factor Der Faktor, mit dem die Koordinate multipliziert werden soll

Rückgabe: Referenz auf den Point

Point & ppl7::grafix::Point::operator+= ( const Point & point )

Beschreibung:: Der aktuelle Wert des Punktes wird mit dem Parameter point addiert. Dabei werden die einzelnen Werte X und Y jeweils miteinander addiert.

Parameter

[in] point Referenz auf einen anderen Point

Rückgabe: Referenz auf den Point

Point & ppl7::grafix::Point::operator-= ( const Point & point )

Beschreibung:: Der aktuelle Wert des Punktes wird mit dem Parameter point subtrahiert. Dabei werden die einzelnen Werte X und Y jeweils voneinander abgezogen.

Parameter

[in] point Referenz auf einen anderen Point

Rückgabe: Referenz auf den Point

Point & ppl7::grafix::Point::operator/= ( double divisor )

Beschreibung:: Mit diesem Operator wird der aktuelle X- und Y-Wert des Punktes einzeln durch den divisor geteilt.

Parameter

[in] divisor Der Divisor, durch den die aktuelle Koordinate geteilt werden soll

Rückgabe: Referenz auf den Point

void ppl7::grafix::Point::setPoint	(	int	x,
		int	y
	)

Beschreibung:: Mit dieser Funktion kann die X- und Y-Koordinate des Punktes gleichzeitig gesetzt werden.

Parameter

[in]	x	X-Koordinate
[in]	y	Y-Koordinate

void ppl7::grafix::Point::setPoint ( const Point & other )

Beschreibung:: Mit dieser Funktion werden die Koordinaten des Punktes other übernommen.

Parameter

[in] other Ein anderer Punkt

void ppl7::grafix::Point::setX ( int x )

Beschreibung:: Mit dieser Funktion kann die X-Koordinate des Punktes gesetzt werden.

Parameter

[in] x X-Koordinate

void ppl7::grafix::Point::setY ( int y )

Beschreibung:: Mit dieser Funktion kann die Y-Koordinate des Punktes gesetzt werden.

Parameter

[in] y Y-Koordinate

double ppl7::grafix::Point::vectorLength ( ) const

Beschreibung:: Diese Funktion berechnet die Länge des Vektors, gerechnet vom Ursprung (0/0) bis zu den aktuellen Koordinaten anhand des "Satz des Pythagoras", und liefert diese als double zurück.

: Die Formel lautet: $length = \sqrt{x^2+y^2}$

Siehe auch: Siehe auch die verwandte Funktion Distance, die den Abstand zwischen zwei Punkten berechnet.

Freundbeziehungen und Funktionsdokumentation

double Distance	(	const Point &	p1,
		const Point &	p2
	)

Beschreibung:: Diese Funktion berechnet die Länge des Vektors zwischen den beiden Punkten p1 und p2 anhand des "Satz des Pythagoras", und liefert diese als double zurück.

: Die Formel lautet: $distance = \sqrt{(p2.x()-p1.x())^2+(p2.y()-p1.y())^2}$

Parameter

[in]	p1	Die Anfangskoordinate
[in]	p2	Die Endkoordinate

Rückgabe: Der Abstand zwischen den beiden Punkten als double.

Dokumentation der Datenelemente

ppl7::grafix::Point::x

ppl7::grafix::Point::y

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Dateien:

/jenkins/jobs/clang_ppl7/workspace/include/ppl7-grafix.h
/jenkins/jobs/clang_ppl7/workspace/src/grafix/Point.cpp

Öffentliche Methoden

Öffentliche Attribute

Verwandte Funktionen

Ausführliche Beschreibung

Beschreibung der Konstruktoren und Destruktoren

Dokumentation der Elementfunktionen

Freundbeziehungen und Funktionsdokumentation

Dokumentation der Datenelemente