Gleis auf cAnlage. Mehr ...

#include <cSektion.h>

Signale
void	SignalBesetzt (int, int)
	Signal, welches emittiert wird, wenn ein Zug das Gleis besetzt oder nicht mehr besetzt. Die erste Zahl gibt die Richtung des Zugs an, die zweite Zahl, ob ein Zug vorhanden ist (1) oder nicht (0).
void	SignalBelegtOderBesetzt (int, int)
	Signal, welches emittiert wird, wenn ein Zug das Gleis besetzt/belegt oder nicht mehr besetzt/belegt. Die erste Zahl gibt die Richtung des Zugs an, die zweite Zahl, ob ein Zug vorhanden ist (1) oder nicht (0).
Öffentliche Methoden
	cSektion (int secidtemp, int connlinttemp, int connrinttemp)
	Initialisiert einen "Strich" auf dem angegebenen canvas mit der Nummer secidtemp, dem linken Konnektor mit der Nummer connlinttemp und dem rechten Konnektor mit der Nummer connrinttemp. Links und rechts muessen so orientiert sein, dass eine Lok bei Richtung 0 von links nach rechts faehrt.
	~cSektion (void)
	entfernt den "Strich" vom canvas
void	cDebug (int prioritaet, const QString &meldung)
	Gibt die Meldung "meldung" in eine der Klasse zugeordnete Logdatei aus. Dabei werden Meldungen mit der Prioritaet prioritaet 0 auch auf dem Bildschirm als Warnung ausgegeben. Meldungen mit Prioritaet >=2 (bzw. >=1) werden in aller Regel nicht in die Log-Datei ausgegeben, lassen sich aber durch Modifikation der Funktion cDebug zur Ausgabe hinzufuegen. Die zugeordnete Log-Datei ist log.cAnlage.
void	setParameter (QString parametertmp)
	Setzt den Parameter der Sektion.
void	setKonnektorL (cKonnektor *cconnltemp)
	Setzt den Zeiger auf den linken Konnektor.
void	setKonnektorR (cKonnektor *cconnrtemp)
	Setzt den Zeiger auf den rechten Konnektor.
void	setRegler (int Reglertemp)
	Setzt die Nummer des zugehoerigen Reglers auf der zugehoerigen Karte.
void	setTrain (int traintemp, int trainrichtungtemp=-1, int traintypetmp=-1, QString tooltip="")
	Legt den Zug und dessen Richtung fest. trainrichtungtemp = 0 (mit der Fahrtrichtung), = 1 (gegen die Fahrtrichtung), = 2 (beidseitige Nutzung)
void	setReserviert (int trainwaitingtemp, int trainrichtungtemp=-1)
	Legt den Zug fest, fuer den die Sektion vorgemerkt wird/ist.
void	setRichtungGeschwindigkeit (int richtungtemp, double geschwindigkeittemp)
	Legt Richtung und Geschwindigkeit fuer den Fahrregler fest. Ist die Geschwindigkeit von 0 verschieden, so wird der "Strich" entsprechend animiert.
void	adjustShape (void)
	Passt den "Strich" farblich an die momentane Situation an (d.h. Richtungspfeile fuer den Zug bzw. farbliche Markierungen fuer ihn oder eine Vormerkung werden dargestellt).
void	adjustrichtungspfeile (void)
	Berechnet die Koordinaten fuer die Pfeilspitzen.
void	updatePoints (void)
	Liesst die Koordinaten der angrenzenden Konnektoren aus und passt die Linie an die neuen Koordinaten an.
int	getL (void)
	Liefert die Nummer des linken Konnektors zurueck.
int	getR (void)
	Liefert die Nummer des rechten Konnektors zurueck.
int	getid (void)
	Liefert die Nummer der Sektion/des Strichs zurueck.
int	getTrain (void)
	Liefert die Nummer des Zugs auf dem Gleis zurueck.
int	getReserviert (void)
	Liefert die Nummer des ankommenden Zugs auf dem Gleis zurueck.
int	getRegler (void)
	Liefert die Nummer des zugehoerigen Reglers zurueck.
int	getTrainRichtung (void)
	Liefert die Richtung des Zugs zurueck, der auf dem Gleis steht.
void	setL (int connlinttmp)
	Setzt die Nummer des linken Konnektors zurueck.
void	setR (int connrinttmp)
	Setzt die Nummer des rechten Konnektors zurueck.
void	setKurzschluss (int kurzschlusstmp)
	Setzt den Kurzschlussstatus der Sektion.
void	setLokStillstand (bool stillstandtmp)
	Setzt den Kurzschlussstatus der Sektion.
void	save (void)
	Speichert die Zugnummer und die Nummer des Zugs, fuer den vorgemerkt wird, in der Datennummer. Wenn allesspeichern TRUE ist, so weden nahezu alle Sektionsinformation abgespeichert (normalerweise nicht noetig!)
int	type () const
	Ueberladene Funktion fuer die Animation.
void	setBeschreibung (const QString &beschreibungtemp)
	Legt die Beschreibung der Sektion fest.
QString	getBeschreibung (void)
	Liefert die Beschreibung zurueck.
double	getLaenge (void)
	Liefert die Laenge des Gleisstuecks auf der Anlage zurueck (in cm).
void	setLaenge (double wirklicheLaengeTmp)
	Setzt die Laenge des Gleisstuecks (auf der Anlage in cm).
void	setDisplayInfo (bool displayInfo)
	Legt fest, ob Informationen zum Konnektor mit eingeblendet werden sollen.
cKonnektor *	DEBUGgetConnL (void)
	NUR ZU DEBUG-ZWECKEN: Liefert Zeiger auf linken Konnektor.
cKonnektor *	DEBUGgetConnR (void)
	NUR ZU DEBUG-ZWECKEN: Liefert Zeiger auf rechten Konnektor.
void	forceSignals (void)
Öffentliche Attribute
bool	an
	Ist die Sektion "an", so wird sie so stromfuehrend angezeigt.
Private Attribute
int	fahrregler
	Speichert den Fahrregler, zu dem die Sektion gehoert.
int	secid
	Speichert die Sektionsnummer.
cKonnektor *	cconnl
	Speichert den Zeiger auf den linken Konnektor/ =0, falls nicht gesetzt.
cKonnektor *	cconnr
	Speichert den Zeiger auf den rechten Konnektor/ =0, falls nicht gesetzt.
double	wirklicheLaenge
	Die Laenge des Gleisstuecks auf der Anlage (in cm).
QGraphicsLineItem *	LinieDrueber
	Der Canvas zu dem der Strich gehoert (der "parent").
QGraphicsPolygonItem *	pfeillinks
	Pfeil nach links (fuer Zugrichtung).
QGraphicsPolygonItem *	pfeilrechts
	Pfeil nach rechts (fuer Zugrichtung).
double	laenge
	Laenge des "Strichs" auf dem Bildschirm.
double	dirx
	Normierte x-Richtung vom linken Konnektor aus betrachtet.
double	diry
	Normierte y-Richtung vom linken Konnektor aus betrachtet.
int	richtung
	Richtung fuer Animation.
double	geschwindigkeit
	Geschwindigkeit fuer Animation.
int	connlint
	Temporaer-Variable fuer Animation.
int	connrint
int	train
	Nummern von Zug, Zugrichtung und vorgemerkten Zug. +Typ des Zugs.
int	trainwaiting
int	trainrichtung
int	traintype
QString	beschreibung
	Speichert die Beschreibung der Sektion (wichtig beim Lok aufsetzen)
QGraphicsTextItem *	TextOben
	Text oben.
QGraphicsTextItem *	TextUnten
	Text unten.
int	kurzschluss
	Kurzschluss-Status der Sektion.
QString	parameter
	Parameter der Sektion.
bool	hidden
	Gibt an, ob Sektion verdeckt, wird durch parameter gesetzt.
bool	stillstand
	Gibt an, ob Lok, die auf dem Gleis steht, Kontaktschwierigkeiten hat.
QColor	farbeFehler
	Farben der Sektion.
QColor	farbeNormalOben
QColor	farbeReserviertOben
QColor	farbeBeschriftung
QColor	farbeFallback
QColor	farbeZug1
QColor	farbeZugAus1
QColor	farbeZug2
QColor	farbeZugAus2
QColor	farbeZug3
QColor	farbeZugAus3
QColor	farbeReserviert
QColor	farbeReserviertAus
QColor	farbeNormal
QColor	farbeNormalAus
QColor	farbeRichtungUngewaehlt
QColor	farbePfeil
QColor	farbePfeilAus
double	groesseBeschriftung
double	groesseGleisOben
double	groesseNormal
double	groesseNormalAus
double	groesseZug
double	groesseZugAus
double	groesseReserviert
double	groesseReserviertAus
double	groesseRichtungUngewaehlt
double	groesseFehler
double	groesseFallback
double	groessePfeil
double	groessePfeilAus
QColor	myPfeilLinks
	Variablen, die die eigene Form speichern (und mit denen verglichen wird, um festzustellen, ob es Veraenderungen gab)
QColor	myPfeilRechts
QPen	myPen
QPen	myPenDrueber
bool	myVisibleDrueber
double	myZ
bool	myPfeilVisibleLinks
bool	myPfeilVisibleRechts
bool	myVisible

Ausführliche Beschreibung

Gleis auf cAnlage.

Ein "Strich" auf dem Gleisplan, welcher zwei Konnektoren (cKonnektor) verbindet. Dieser "Strich" verwaltet alle Informationen ueber den entsprechenden Gleisabschnitt (Besetzt/Reserviert/Geschwindigkeit/...).

Definiert in Zeile 15 der Datei cSektion.h.

Beschreibung der Konstruktoren und Destruktoren

cSektion::cSektion	(	int	secidtemp,
		int	connlinttemp,
		int	connrinttemp
	)

Initialisiert einen "Strich" auf dem angegebenen canvas mit der Nummer secidtemp, dem linken Konnektor mit der Nummer connlinttemp und dem rechten Konnektor mit der Nummer connrinttemp. Links und rechts muessen so orientiert sein, dass eine Lok bei Richtung 0 von links nach rechts faehrt.

cSektion::~cSektion ( void )

entfernt den "Strich" vom canvas

Dokumentation der Elementfunktionen

void cSektion::adjustrichtungspfeile ( void )

Berechnet die Koordinaten fuer die Pfeilspitzen.

void cSektion::adjustShape ( void )

Passt den "Strich" farblich an die momentane Situation an (d.h. Richtungspfeile fuer den Zug bzw. farbliche Markierungen fuer ihn oder eine Vormerkung werden dargestellt).

Wird benutzt von setKurzschluss() und setLokStillstand().

void cSektion::cDebug	(	int	prioritaet,
		const QString &	meldung
	)

Gibt die Meldung "meldung" in eine der Klasse zugeordnete Logdatei aus. Dabei werden Meldungen mit der Prioritaet prioritaet 0 auch auf dem Bildschirm als Warnung ausgegeben. Meldungen mit Prioritaet >=2 (bzw. >=1) werden in aller Regel nicht in die Log-Datei ausgegeben, lassen sich aber durch Modifikation der Funktion cDebug zur Ausgabe hinzufuegen. Die zugeordnete Log-Datei ist log.cAnlage.

cKonnektor* cSektion::DEBUGgetConnL ( void ) [inline]

NUR ZU DEBUG-ZWECKEN: Liefert Zeiger auf linken Konnektor.

Definiert in Zeile 113 der Datei cSektion.h.

Benutzt cconnl.

{ return(cconnl); };

cKonnektor* cSektion::DEBUGgetConnR ( void ) [inline]

NUR ZU DEBUG-ZWECKEN: Liefert Zeiger auf rechten Konnektor.

Definiert in Zeile 115 der Datei cSektion.h.

Benutzt cconnr.

{ return(cconnr); };

void cSektion::forceSignals ( void ) [inline]

Definiert in Zeile 119 der Datei cSektion.h.

Benutzt SignalBelegtOderBesetzt(), SignalBesetzt(), train, trainrichtung und trainwaiting.

                          { 
    emit SignalBesetzt(trainrichtung,(train>0)); 
    emit SignalBelegtOderBesetzt(trainrichtung,(trainwaiting>0)||(train>0));
  };

QString cSektion::getBeschreibung ( void ) [inline]

Liefert die Beschreibung zurueck.

Definiert in Zeile 96 der Datei cSektion.h.

Benutzt beschreibung.

{ return beschreibung; };

int cSektion::getid ( void ) [inline]

Liefert die Nummer der Sektion/des Strichs zurueck.

Definiert in Zeile 57 der Datei cSektion.h.

Benutzt secid.

{ return secid; };

int cSektion::getL ( void ) [inline]

Liefert die Nummer des linken Konnektors zurueck.

Definiert in Zeile 53 der Datei cSektion.h.

Benutzt connlint.

{ return connlint; };

double cSektion::getLaenge ( void ) [inline]

Liefert die Laenge des Gleisstuecks auf der Anlage zurueck (in cm).

Definiert in Zeile 98 der Datei cSektion.h.

Benutzt wirklicheLaenge.

{ return wirklicheLaenge; };

int cSektion::getR ( void ) [inline]

Liefert die Nummer des rechten Konnektors zurueck.

Definiert in Zeile 55 der Datei cSektion.h.

Benutzt connrint.

{ return connrint; };

int cSektion::getRegler ( void ) [inline]

Liefert die Nummer des zugehoerigen Reglers zurueck.

Definiert in Zeile 63 der Datei cSektion.h.

Benutzt fahrregler.

{ return fahrregler; };

int cSektion::getReserviert ( void ) [inline]

Liefert die Nummer des ankommenden Zugs auf dem Gleis zurueck.

Definiert in Zeile 61 der Datei cSektion.h.

Benutzt trainwaiting.

{ return trainwaiting; };

int cSektion::getTrain ( void ) [inline]

Liefert die Nummer des Zugs auf dem Gleis zurueck.

Definiert in Zeile 59 der Datei cSektion.h.

Benutzt train.

{ return train; };

int cSektion::getTrainRichtung ( void ) [inline]

Liefert die Richtung des Zugs zurueck, der auf dem Gleis steht.

Definiert in Zeile 65 der Datei cSektion.h.

Benutzt trainrichtung.

{ return trainrichtung; };

void cSektion::save ( void )

Speichert die Zugnummer und die Nummer des Zugs, fuer den vorgemerkt wird, in der Datennummer. Wenn allesspeichern TRUE ist, so weden nahezu alle Sektionsinformation abgespeichert (normalerweise nicht noetig!)

void cSektion::setBeschreibung ( const QString & beschreibungtemp )

Legt die Beschreibung der Sektion fest.

void cSektion::setDisplayInfo ( bool displayInfo ) [inline]

Legt fest, ob Informationen zum Konnektor mit eingeblendet werden sollen.

Definiert in Zeile 102 der Datei cSektion.h.

Benutzt TextOben und TextUnten.

                                        {
    if (displayInfo) {
      TextOben->show();
      TextUnten->show();
    } else {
      TextOben->hide();
      TextUnten->hide();
    }
  };

void cSektion::setKonnektorL ( cKonnektor * cconnltemp )

Setzt den Zeiger auf den linken Konnektor.

void cSektion::setKonnektorR ( cKonnektor * cconnrtemp )

Setzt den Zeiger auf den rechten Konnektor.

void cSektion::setKurzschluss ( int kurzschlusstmp ) [inline]

Setzt den Kurzschlussstatus der Sektion.

Definiert in Zeile 71 der Datei cSektion.h.

Benutzt adjustShape() und kurzschluss.

                                          { 
      if (kurzschluss!=kurzschlusstmp) {
          kurzschluss=kurzschlusstmp; 
          adjustShape();
      }
  };

void cSektion::setL ( int connlinttmp ) [inline]

Setzt die Nummer des linken Konnektors zurueck.

Definiert in Zeile 67 der Datei cSektion.h.

Benutzt connlint.

{ connlint=connlinttmp; };

void cSektion::setLaenge ( double wirklicheLaengeTmp ) [inline]

Setzt die Laenge des Gleisstuecks (auf der Anlage in cm).

Definiert in Zeile 100 der Datei cSektion.h.

Benutzt wirklicheLaenge.

{ wirklicheLaenge=wirklicheLaengeTmp; };

void cSektion::setLokStillstand ( bool stillstandtmp ) [inline]

Setzt den Kurzschlussstatus der Sektion.

Definiert in Zeile 78 der Datei cSektion.h.

Benutzt adjustShape() und stillstand.

                                            { 
      if (stillstand!=stillstandtmp) {
          stillstand=stillstandtmp;
          adjustShape();
      }
  };

void cSektion::setParameter ( QString parametertmp ) [inline]

Setzt den Parameter der Sektion.

Definiert in Zeile 28 der Datei cSektion.h.

Benutzt hidden und parameter.

                                          { 
      parameter=parametertmp; 
      if (parameter.find("hidden",0,FALSE)>=0) hidden=TRUE; else hidden=FALSE; 
  };

void cSektion::setR ( int connrinttmp ) [inline]

Setzt die Nummer des rechten Konnektors zurueck.

Definiert in Zeile 69 der Datei cSektion.h.

Benutzt connrint.

{ connrint=connrinttmp; };

void cSektion::setRegler ( int Reglertemp )

Setzt die Nummer des zugehoerigen Reglers auf der zugehoerigen Karte.

void cSektion::setReserviert	(	int	trainwaitingtemp,
		int	trainrichtungtemp = `-1`
	)

Legt den Zug fest, fuer den die Sektion vorgemerkt wird/ist.

void cSektion::setRichtungGeschwindigkeit	(	int	richtungtemp,
		double	geschwindigkeittemp
	)

Legt Richtung und Geschwindigkeit fuer den Fahrregler fest. Ist die Geschwindigkeit von 0 verschieden, so wird der "Strich" entsprechend animiert.

void cSektion::setTrain	(	int	traintemp,
		int	trainrichtungtemp = `-1`,
		int	traintypetmp = `-1`,
		QString	tooltip = `""`
	)

Legt den Zug und dessen Richtung fest. trainrichtungtemp = 0 (mit der Fahrtrichtung), = 1 (gegen die Fahrtrichtung), = 2 (beidseitige Nutzung)

void cSektion::SignalBelegtOderBesetzt	(	int	,
		int
	)		`[signal]`

Signal, welches emittiert wird, wenn ein Zug das Gleis besetzt/belegt oder nicht mehr besetzt/belegt. Die erste Zahl gibt die Richtung des Zugs an, die zweite Zahl, ob ein Zug vorhanden ist (1) oder nicht (0).

Wird benutzt von forceSignals().

void cSektion::SignalBesetzt	(	int	,
		int
	)		`[signal]`

Signal, welches emittiert wird, wenn ein Zug das Gleis besetzt oder nicht mehr besetzt. Die erste Zahl gibt die Richtung des Zugs an, die zweite Zahl, ob ein Zug vorhanden ist (1) oder nicht (0).

Wird benutzt von forceSignals().

int cSektion::type ( ) const [inline]

Ueberladene Funktion fuer die Animation.

Ueberladene Funktion, die die eindeutige canvasID dieses "Striches" zurueckliefert.

Definiert in Zeile 91 der Datei cSektion.h.

Benutzt secid und signalssectionsStart.

{ return (signalssectionsStart+secid); };

void cSektion::updatePoints ( void )

Liesst die Koordinaten der angrenzenden Konnektoren aus und passt die Linie an die neuen Koordinaten an.

Dokumentation der Datenelemente

bool cSektion::an

Ist die Sektion "an", so wird sie so stromfuehrend angezeigt.

Definiert in Zeile 115 der Datei cSektion.h.

QString cSektion::beschreibung [private]

Speichert die Beschreibung der Sektion (wichtig beim Lok aufsetzen)

Definiert in Zeile 164 der Datei cSektion.h.

Wird benutzt von getBeschreibung().

cKonnektor* cSektion::cconnl [private]

Speichert den Zeiger auf den linken Konnektor/ =0, falls nicht gesetzt.

Definiert in Zeile 134 der Datei cSektion.h.

Wird benutzt von DEBUGgetConnL().

cKonnektor* cSektion::cconnr [private]

Speichert den Zeiger auf den rechten Konnektor/ =0, falls nicht gesetzt.

Definiert in Zeile 136 der Datei cSektion.h.

Wird benutzt von DEBUGgetConnR().

int cSektion::connlint [private]

Temporaer-Variable fuer Animation.

Nummern des linken/rechten Konnektors.

Definiert in Zeile 160 der Datei cSektion.h.

Wird benutzt von getL() und setL().

int cSektion::connrint [private]

Definiert in Zeile 160 der Datei cSektion.h.

Wird benutzt von getR() und setR().

double cSektion::dirx [private]

Normierte x-Richtung vom linken Konnektor aus betrachtet.

Definiert in Zeile 150 der Datei cSektion.h.

double cSektion::diry [private]

Normierte y-Richtung vom linken Konnektor aus betrachtet.

Definiert in Zeile 152 der Datei cSektion.h.

int cSektion::fahrregler [private]

Speichert den Fahrregler, zu dem die Sektion gehoert.

Definiert in Zeile 130 der Datei cSektion.h.

Wird benutzt von getRegler().

QColor cSektion::farbeBeschriftung [private]