BBBIKE(1)

NAME
bbbike - Informationssystem fuer Radfahrer in Berlin und Brandenburg

SYNOPSIS
  bbbike [options]

BESCHREIBUNG
BBBike ist ein Informationssystem fuer Radfahrer in Berlin und Brandenburg. Mit dem Programm koennen Routen, optimiert fuer Radfahrer, automatisch gesucht oder manuell erstellt werden. Bei der automatischen Suche wird die kuerzeste Strecke zwischen zwei angegebenen Punkten gesucht. Bei der manuellen Routenerstellung koennen abschnittsweise Zwischenpunkte eingegeben werden und zum Schluss die Gesamtlaenge abgelesen werden.

Eine einfache WWW-Version kann man unter der Adresse <http://www.bbbike.de> finden.

Wenn eine Verbindung zum Internet existiert, kann BBBike die aktuellen Wetterdaten von der FU Berlin (Dahlem) die Windstaerke und -richtung auswerten. Diese Daten koennen bei der Berechnung der Fahrzeit und Leistung verwendet werden.

Ein Teil von BBBike ist das perl-Modul BikePower. Mit diesem Modul kann (wie beim urspruenglichen bike_power-Programm von Ken Roberts - roberts@cs.columbia.edu ) anhand von Daten wie Gefaelle, Wind, Rollwiderstand der Reifen, Luftwiderstand, Masse von Rad und Fahrer die Leistung ermittelt werden.

BBBike liefert unter anderem die Antwort auf folgende Fragen:

•   Wie lang ist die Strecke von A nach B?

•   Wie lange brauche ich von A nach B, wenn ich durchschnittlich 15 km/h schnell fahre?

•   Wie lange brauche ich von A nach B, wenn ich mit 100 Watt Leistung fahre, mit Beruecksichtigung des aktuellen Windes und von Steigungen auf der Strecke?

•   Auf welchen Strassen muss ich fahren und wie muss ich abbiegen, wenn ich von A nach B kommen will?

•   Wo habe ich Gegenwind- und Rueckenwindstrecken?

•   Wo gibt es Steigungen und Gefaelle?

•   Kann ich Hauptstrassen und/oder Kopfsteinpflasterstrecken auf meiner Strecke vermeiden?

•   Kann ich "gruene" Wege auf meiner Strecke bevorzugen? Kann ich unbeleuchtete Strassen meiden?

  AUTOMATISCHE SUCHE
Start- und Zielpunkt einer Route setzt man, indem man mit der linken Maustaste auf eine Strasse klickt. Nach dem Setzen des Zielpunktes berechnet das Programm die kuerzeste Route und zeigt sie an. Danach kann die Route mit Klick verlaengert werden. Soll eine neue Route (mit neuem Start- und Zielpunkt) berechnet werden, kann die alte mit dem Kontextmenuepunkt "Route loeschen" oder mit Klick auf das Icon Route loeschen geloescht werden. Mit der Backspace-Taste kann der letzte Punkt der Route geloescht werden. Mit der Delete-Taste (Entf) kann die Route bis zum letzten Via-Punkt geloescht werden.

Die Route kann eingefaerbt werden (Menuepunkt Route > Einfaerben der Route), und zwar rot, schwarz, blau oder nach Windrichtung oder Leistung. Fuer das Einfaerben nach Windrichtung benoetigt man Winddaten (automatisch aus dem WWW geholt oder manuell eingegeben). Die Rueckenwindstrecken werden dann gruen und die Gegenwindstrecken rot dargestellt. Fuer das Einfaerben nach Leistung benoetigt man zusaetzlich die persoenlichen Daten des Fahrers (siehe Bikepower).

  MANUELLE ROUTENERSTELLUNG
Die manuelle Routenerstellung wird zum Beispiel bei der Erstellung einer Tourplanung verwendet, bei der nicht das Suchen einer kuerzesten Strecke im Vordergrund steht. Sie funktioniert prinzipiell wie die automatische Suche, nur wird der Benutzer mehrere Zwischenpunkte eingeben, um die Route festzulegen. Mit Klick auf Alt-Button1 oder Shift-Button1 (Klick auf die linke Maustaste und gleichzeitiges Druecken der Alt- oder Shift-Taste) kann ein beliebiger Punkt gekennzeichnet werden (also ein Punkt, der nicht auf einer Strasse liegt).

INFORMATIONSLEISTE
Im oberen Bereich des Fensters, unterhalb der Menueleiste (falls eingeblendet), befindet sich die Informationsleiste von BBBike.

Ort/Bahnhof
    Anzeige des Ortes bzw. der Haltestelle unter dem Mauscursor. Die Angabe ist nur gueltig, wenn sie in schwarzer Schrift (und nicht in grauer) erscheint. Mit einem Klick wird die Ort-Auswahl angezeigt.

Strasse/Strecke
    Anzeige der Strasse bzw. Bahnlinie unter dem Mauscursor. Auch hier ist die Angabe nur bei schwarzer Schrift gueltig. Mit einem Klick wird die Strassen-Auswahl angezeigt.

km  Laenge der aktuellen Route in Kilometern. Mit Klick auf den Schriftzug "km" kann zwischen der Angabe in Kilometern und Metern umgeschaltet werden. Falls englisch als Sprache eingestellt wurde, ist auch die Auswahl "Meilen" moeglich.

%   Angabe, wieviel % ueber der Ideallinie (Luftlinie) die aktuelle Route liegt. Bei offensichtlichen Rundfahrten bleibt die Angabe leer.

km/h
    Fahrzeit bei dieser durchschnittlichen Geschwindigkeit. Mit Klick auf das km/h-Feld kann eine andere Geschwindigkeit eingegeben werden. Mit Klick auf die Fahrzeit wird das Alarm-Fenster geoeffnet. Mit der rechten Maustaste kann die jeweilige Geschwindigkeit als "Referenzgeschwindigkeit" ausgewaehlt werden. Mit dem Ampel-Icon kann das Einbeziehen von Ampeln in die Fahrzeit ein-/ausgeschaltet werden. Mit dem Kopfsteinpflaster-Icon unterhalb des Ampel-Icons kann das Einbeziehen von Kopfsteinpflaster- und aehnlichen Strecken in die Fahrzeit ein-/ausgeschaltet werden.

W   Fahrzeit bei dieser durchschnittlichen Leistung, abhaengig von der Windgeschwindigkeit und von Steigungen. Die Berechnung wird mit dem Modul BikePower durchgefuehrt. Mit Klick auf das W-Feld kann eine andere Leistung (in Watt) eingegeben werden. Als Faustregel kann man 50W fuer eine gemuetliche Fahrweise annehmen. Mit Klick auf die Fahrzeit wird das Alarm-Fenster geoeffnet. Mit der rechten Maustaste kann die jeweilige Leistung als "Referenzleistung" (intern wird diese auf eine Geschwindigkeit umberechnet) ausgewaehlt werden. Auch hier kann man mit Ampel- und Kopfsteinpflaster-Icon zum Einbeziehen von Ampeln/Kopfsteinpflasterstrecken in die Fahrzeit einbeziehen.

Datum der Winddaten
    Falls aktuelle Winddaten vorhanden sind, stehen in diesem Feld das jeweilige Datum und die Uhrzeit. Bei einem Mausklick wird versucht, die aktuellen Daten ueber das WWW oder ueber eine lokale Datenbank zu holen. Mit der rechten Maustaste erscheint ein Menue mit folgenden Punkten:

    Wetterstation
        Hier kann ausgewaehlt werden, welche der Quellen im Internet (Meteorologisches Institut der FU oder ggfs. andere Quellen) verwendet werden soll. Mit "aktuellste" werden alle Quellen nach den aktuellsten Angaben ueberprueft.

    Quelle
        Hier kann angegeben werden, ob die Wetterdaten ueber das Internet direkt gezogen werden oder ob ein evtl. vorhandener lokaler Cache bzw eine lokale Datenbank vorgezogen wird.

    Auswahl aus Datenbank
        Falls eine lokale Datenbank vorhanden ist, koennen hiermit Wetterdaten zu einem bestimmten Tag ausgewaehlt werden.

    Wind ignorieren
        Normalerweise wird - falls Winddaten vorhanden sind - die Route anhand der Windrichtung gefaerbt: Rueckenwindabschnitte sind gruen, Gegenwindabschnitte rot und Seitenwindabschnitte von hellgruen bis orange.

        Falls der Menuepunkt "Wind ignorieren" angeklickt ist, wird die Windgeschwindigkeit und -richtung bei der Route und bei der Zeitberechnung ignoriert. Die Route wird dann in einer einzelnen Farbe (blau) gezeichnet.

    Aktualisierung
        Hiermit kann das Zeichnen der Gegenwind- und Rueckenwindstrecken der Route aktualisiert werden.

    automatische Aktualisierung
        Beim Aendern der Wetterstation bzw. der Quelle werden automatisch die neuen Wetterdaten geholt.

    automatische Routenaktualisierung
        Beim Aendern von Wetterdaten werden automatisch die Gegenwind- und Rueckenwindstrecken der Route aktualisiert.

Winddaten
    Hier wird, falls vorhanden, die aktuelle Windrichtung und die aktuelle Windgeschwindigkeit in m/s angezeigt. Mit einem Klick wird ein Fenster zur manuellen Eingabe der Windrichtung und -geschwindigkeit geoeffnet. Anmerkung: Zwar kann die maximale Windgeschwindigkeit eingegeben werden, das Programm verwendet aber nur die mittlere Windgeschwindigkeit fuer die Zeitberechnungen.

Temp
    Anzeige der aktuellen Temperatur. Die Temperatur wird sogar in die Leistungsberechnung einbezogen, die Auswirkungen darauf sind aber nur minimal.

ICONS
Unter manchen Icons befindet sich ein kleiner Pfeil, mit dem ein zugehoeriges Popup-Menue aufgeklappt werden kann. Das Menue kann auch mit Klick auf die rechte Maus-Taste, waehrend sich der Maus-Cursor ueber dem Icon befindet, aufgerufen werden.

Hier folgt die Beschreibung der Icons von links nach rechts.

  KARTENELEMENTE
Die erste Gruppe kontrolliert, welche Elemente auf der Kartenflaeche dargestellt werden sollen. In allen Menues dieser Icons kann mit oben, normal und unten angegeben werden, ob die Elemente ueber oder unter allen anderen Elementen gezeichnet werden sollen oder ob die normale Reihenfolge wiederhergestellt werden soll (die normale Reihenfolge lautet von unten nach oben: Flaechen, Gewaesser, Inseln, Grenzen, U-Bahnen, Regionalbahnen, S-Bahnen, Strassen, Landstrassen, Orte). Daneben besitzt jedes Menue einen Schalter zum Ein- und Ausschalten des Elements und einen Eintrag zum Auswaehlen einer bestimmten Strasse oder eines bestimmten Ortes ueber eine Listbox.

Strassen-Symbol
    Schaltet das Zeichnen von Strassen in Berlin ein oder aus (Tastatur: "s").

    Menue: Neben den Standardeintraegen sind noch folgende Eintraege vorhanden:

    Auswahl aus ...
        In diesem Untermenue kann eine Strasse aus alternativen Verzeichnissen ausgewaehlt werden:

        Komplette Strassenliste
            In der Strassen-Datenbank von BBBike sind nur ca. 2300 Strassen erfasst. Strassen, die hier nicht vorhanden sind, koennen in der umfangreicheren PLZ-Datenbank ausgewaehlt werden. Allerdings wird bei der Auswahl einer nicht vorhandenen Strasse nur der Postleitzahlbereich angezeigt.

        Telefonbuch-Datenbank (Strasse)
            Wenn eine Telefonbuch-CD-ROM 1998/99 oder 1999/2000 fuer Berlin vorhanden ist, kann diese Datenbank verwendet werden. Hier kann jede Strasse mit Hausnummer angegeben werden; die Position wird recht exakt angzeigt.

        Telefonbuch-Datenbank (Name)
            Mit diesem Formular kann nach Namen im Telefonbuch-Verzeichnis gesucht werden. Es muss mindestens der Nachname angegeben werden. Mit dem Schalter Exakt kann eingestellt werden, ob der Nachname exakt passen muss (ansonsten wird bei der Suche von "Wall" auch "Wallburg" etc. angezeigt). Nachdem mit Suchen die Ergebnisliste erstellt wurde, koennen mit << und >> weitere passende Datensaetze eingesehen werden. Mit Alle werden alle passenden Datensaetze auf der Karte markiert. Wenn ein "dial"-Programm vorhanden ist, erscheint noch ein Button Waehlen zum Waehlen der Telefonnummer.

    Untermenue Strassenkategorien
        In diesem Untermenue kann das Zeichnen von Hauptstrassen, Nebenstrassen und fuer Kfz gesperrte Strassen ein- und ausgeschaltet werden.

    Hoehenpunkte
        Hoehenpunkte werden in die Karte eingezeichnet.

    Radwege
        Radwege werden gezeichnet. Benutzungspflichtige Radwege sind dunkelblau, freiwillig zu nutzende Radwege blau, Radstreifen gruen und Busspuren orange. Fuer jede Richtung, in die ein Radweg existiert, wird auf der jeweiligen Strassenseite ein Radweg gezeichnet, auch wenn es sich eigentlich um einen Zwei-Richtungs-Radweg auf der falschen Strassenseite handelt.

    Untermenue Radwegekategorien
        In diesem Untermenue kann das Zeichnen von einigen Radwegekategorien ein- und ausgeschaltet werden.

    Einbahn-/gesperrte Strassen
        Kennzeichnung von Einbahnstrassen (blaue Pfeile, die in die Strassenrichtung zeigen), gesperrten Strassen (rote Kreuze) sowie Punkten, an denen das Fahrrad getragen werden muss (drei waagerechte Striche). Temporaere Sperrungen wegen Bauarbeiten werden mit einem Baustellen-Symbol gekennzeichnet.

    Faehren
        Zeichnen von Faehren. Um die Faehren auch in der Suche mit einzubeziehen, muss im Menue von Route suchen der Eintrag Faehren verwenden aktiviert sein.

    Ampeln
        Ampeln werden in die Karte eingezeichnet. Bei der Auswahl einer Route wird die Anzahl der durchgefahrenen Ampeln mit einer ungefaehren Verzoegerungszeit (15 Sekunden pro Ampel) im Feld rechts von den Icons angezeigt.

        Reine Fussgaengerampeln sind in der Datenbasis nur erfasst, wenn sie die Fahrt wesentlich verzoegern wuerden (hohe Fussgaengerfrequenz oder stark befahrene Querstrasse direkt vor oder hinter der Ampeln). Beschrankte Bahnuebergaenge sind ebenfalls unter den Ampeln zu finden.

    Outline zeichnen
        Die Strassen werden mit Umrandung gezeichnet.

    Strassennamen
        Die Strassen werden mit Strassennamen gezeichnet. Ist wesentlich langsamer, besonders wenn Font rotation eingeschaltet ist.

    Strassenqualitaet
        Die Qualitaet des Strassenbelags wird gezeichnet. Die Kategorisierung siegt wie folgt aus:

        dunkelgruen
            Sehr guter Belag (meist Asphalt). Da die meisten Strassen einen guten Belag haben, wurde auf eine Erfassung dieser Kategorie meist verzichtet.

        hellgruen
            Guter Belag, z.B. gutes Kopfsteinpflaster oder etwas schlechterer Asphalt.

        orange
            Maessiger Belag, z.B. die meisten Kopfsteinpflasterstrassen.

        rot Schlechter Belag (schlechtes Kopfsteinpflaster, unbefestigte Wege).

    Qualitaetskategorien
        Hiermit kann das Zeichnen der Qualitaetskategorien eingeschraenkt werden.

    Sonstige Behinderungen
        Zeichnen von sonstigen Behinderungen (z.B. Fussgaengerverkehr).

Landstrassen-Symbol
    Schaltet das Zeichnen von Landstrassen in Berlins Umgebung ein oder aus (Tastatur: "l").

    Menue: Neben den Standardeintraegen sind noch folgende Eintraege vorhanden:

    Outline zeichnen
        Gleiche Funktion wie beim Strassen-Symbol.

    Landstrassen jwd zeichnen
        Zeichnet auch Landstrassen ausserhalb Brandenburgs.

    Strassenqualitaet
        Gleiche Funktion wie beim Strassen-Symbol.

    Sonstige Behinderungen
        Gleiche Funktion wie beim Strassen-Symbol.

Ort-Symbol
    Schaltet das Zeichnen von Orten in Brandenburg ein oder aus (Tastatur: "o").

    Menue: Neben den Standardeintraegen sind noch folgende Eintraege vorhanden:

    Ortsnamen
        Anzeige von Ortsnamen ermoeglichen oder unterbinden.

    Kategorie
        In diesem Untermenue kann das Zeichnen von kleineren Orten unterdrueckt werden. Beispielorte fuer die Kategorisierung:

                6       Berlin
                5       Potsdam, Brandenburg
                4       Werder, Kyritz
                3       Ketzin, Lindow
                2       Caputh, Goettin
                1       Krummensee
                0       Ortsteile wie Wilhelmsdorf, Doethen,
                        Petzow

        Mit "Alle" werden alle Orte gezeichnet. Mit "Auto" werden die Orte abhaengig von der Zoom-Stufe gezeichnet.

    Schriftgroesse
        Untermenue zum Einstellen einer anderen Schriftgroesse fuer die Anzeige der Ortsnamen. Der Bereich geht von "klein" bis "sehr gross".

    Ueberlappungen vermeiden
        Hier wird mit einem sehr einfachen Algorithmus versucht, die Ortsbeschriftungen so zu setzen, dass sie sich nicht einander ueberlappen. Per Voreinstellung ist diese Option ausgeschaltet, weil das Zeichnen der Orte dadurch erheblich verlangsamt wird. Sinnvoll ist diese Option, wenn z.B. die Karte als Bilddatei abgespeichert werden soll.

U-Bahn-Symbol
    Schaltet das Zeichnen von U-Bahnlinien ein oder aus (Tastatur: "u").

    Menue: Zusaetzlich zum Ein-/Ausschalten und Auswaehlen der U-Bahnlinien koennen auch U-Bahnhoefe ein-/ausgeschaltet und ausgewaehlt werden.

    Wenn der Punkt U-Bhf-Namen angeklickt wird, werden die jeweiligen Namen zum U-Bahnhof auf der Karte eingezeichnet. Mit Ueberlappungen vermeiden wird versucht, die Namen so zu setzen, dass sie sich nicht einander ueberlappen. Siehe auch die Bemerkung zu Ueberlappungen vermeiden im Menuepunkt Ort-Symbol.

    Mit VBB-Zone A, VBB-Zone B und in Bau kann das U-Bahn-Netz zusaetzlich auf die jeweilige Zone eingeschraenkt werden.

S-Bahn-Symbol
    Schaltet das Zeichnen von S-Bahnlinien ein oder aus (Tastatur: "b").

    Menue: Wie beim U-Bahn-Symbol.

RB-Symbol
    Schaltet das Zeichnen von Regionalbahnlinien ein oder aus (Tastatur: "r").

    Menue: Wie beim U-Bahn-Symbol.

Gewaesser-Symbol
    Schaltet das Zeichnen von Fluessen, Kanaelen und Seen ein oder aus (Tastatur: "w").

    Menue: Neben den Standardeintraegen sind noch folgende Eintraege vorhanden:

    Outline zeichnen
        Wie beim gleichnamigen Eintrag beim Strassen-Symbol.

    Namen der Gewaesser
        Schaltet das Zeichnen der Gewaessernamen ein oder aus.

    Gewaesser im Umland zeichnen
        Schaltet das Zeichnen der Gewaesser im Umland von Berlin ein oder aus.

    Gewaesser in der Stadt zeichnen
        Schaltet das Zeichnen der Gewaesser in Berlin ein oder aus.

Flaechen-Symbol
    Schaltet das Zeichnen von sonstigen Flaechen (Parks, Waelder, Flughaefen) ein oder aus (Tastatur: "f").

    Menue: Neben den Standardeintraegen sind noch folgende Eintraege vorhanden:

    PLZ-Gebiete
        Schaltet das Zeichnen der Berliner Postleitzahlgrenzen ein oder aus. Die PLZ-Datenbank ist noch im Aufbau.

    PLZ-Gebiet auswaehlen
        Zeigt eine Listbox zum Auswaehlen einer Berliner Postleitzahl an.

    Grenzen von Berlin
        Schaltet das Zeichnen der Berliner Stadtgrenze ein oder aus.

Sehenswuerdigkeiten-Symbol
    Schaltet das Zeichnen von Sehenswuerdigkeiten und anderen wichtigen Gebaeuden ein oder aus. Im Menue gibt es die weiteren Punkte:

    Sehenswuerdigkeiten
        Schaltet das Zeichnen von Sehenswuerdigkeiten und anderen markanten Gebaeuden in Berlin und Brandenburg ein oder aus.

    Sehenswuerdigkeit auswaehlen
        Zeigt eine Listbox zum Auswaehlen einer Sehenswuerdigkeit an.

    Kneipen
        Zeichnet genau wie die Schaltflaeche Kneipen in Berlin.

    Kneipe auswaehlen
        Zeigt eine Listbox zum Auswaehlen einer Kneipe an.

    Persoenliche Orte
        Zeigt eine Listbox mit persoenlich eingetragenen Orten ein. Die Punkte muessen im "bbd"-Format in der Datei "$HOME/.bbbike/personal.bbd" vorhanden sein.

    Obst
        Zeichnet Stellen mit oeffentlich zugaenglichen Obstbaeumen.

Zusaetzliche Kartenebenen-Symbol
    Im Menue gibt es die Punkte:

    Strassen-Layer zeichnen
        Zeichnet bbd- und andere GPS/GIS-Dateien als Strassen/Strecken/Flaechen.

    Sperrungen-Layer zeichnen
        Zeichnet bbd-Dateien als "Sperrungen" (gesperrte Strassen, Einbahnstrassen etc.). Das Strassennetz wird entsprechend der Sperrungen aktualisiert.

    Punkte-Layer zeichnen
        Zeichnet bbd- und andere GPS/GIS-Dateien als Punkte.

    Strassen/Punkte auswaehlen
        Auswahl eines Objekts aus einer neu gezeichneten Kartenebene anhand des Namens.

    Letzte geoeffnete Layer
        Zeigt ein Menue der zuletzt geoeffneten Kartenebenen/Layer.

    Umordnen
        Zeigt einen Dialog, in dem die Kartenebenen umgeordnet werden koennen. Zurzeit nur unter Unix/X11 moeglich.

    Layer loeschen
        Loeschen einer zusaetzlich gezeichneten Kartenebene.

    Ausschnitt an Layer anpassen
        Der sichtbare Ausschnitt wird so geaendert, dass die gesamte neue Kartenebene sichtbar ist.

    Scrollregion an Layer anpassen
        Der Scrollbereich wird auf die Bounding Box der neuen Kartenebene gesetzt.

    Scrollregion fuer Layer vergroessern.
        Der Scrollbereich wird, falls notwendig, so vergroessert, dass die neue Kartenebene vollstaendig enthalten ist. Dieser Menuepunkt ist bevorzugt von den Scrollregion/Ausschnitt-Menuepunkten zu verwenden.

    Linienbreite 1 Punkt
        Die Linienbreite bei neuen Strecken wird auf einen Punkt gesetzt.

    WWW-Klickmodus
        Falls in den Namen der neuen Kartenobjekte URLs enthalten sind, koennen diese beim Klicken im Web-Browser geladen werden.

    Gpsman-Daten zeichnen
        Spezielles Zeichnen von Daten, die im gpsman-Format vorliegen.

    GPS-Track-Animation
        Animation von zuvor mit dem im Menuepunkt "Gpsman-Daten zeichnen" Tracks.

  NAVIGATION
In der naechsten Gruppe sind die Navigations-Icons:

Vergroessern-Symbol (+)
    Es wird ein kleinerer Ausschnitt angezeigt (mehr Details). Tastatur: "+".

Verkleinern-Symbol (-)
    Es wird ein groesserer Ausschnitt angezeigt (weniger Details). Tastatur: "-".

Massstab-Feld
    Dieses Feld zeigt den aktuellen Massstab, bezogen auf den Bildschirm, an. Die Zahl stimmt nur, wenn die DPI-Zahl des X-Servers korrekt eingetragen wurde (beim X-Server von XFree86 kann die DPI-Zahl mit der Option -dpi veraendert werden). Mit Klick auf das Feld kann ein anderer Massstab angegeben werden und so der Kartenausschnit vergroessert oder verkleinert werden.

Uebersichtskarten-Symbol
    Mit diesem Symbol kann die Uebersichtskarte von Berlin und Brandenburg ein- und ausgeschaltet werden. In der Uebersichtskarte wird der aktuelle Ausschnitt durch ein schwarzes Rechteck gekennzeichnet. Durch Verschieben dieses Rechtecks wird auch der aktuelle Ausschnitt verschoben.

Windrosen-Symbol
    Mit dem Windrosen-Symbol kann man die Karte in die vier Himmelsrichtungen scrollen. Mit der linken Maustaste sind dabei die Schritte kleiner, mit der mittleren groesser. Wenn man laenger auf die Mitte der Windrose klickt (ca. 2 Sekunden), wird wieder zurueck auf die Mitte zentriert. Scrollen kann man auch mit den Scrollbars oder mit den Tasten Pos1 (links), Ende (rechts), Bild nach oben und Bild nach unten (jeweils immer seitenweise) bzw. mit den Cursortasten (feinere Abstufung).

  ROUTEN
Die folgenden Icons kontrollieren die Suche von Routen:

Route suchen
    Mit diesem Schalter kann man den Suchmodus ein- oder ausschalten. Normalerweise ist dieser Schalter nicht aktiviert und es ist immer der Suchmodus eingeschaltet (kann mit der Kommandozeilen-Option -advanced geaendert werden).

    Menue:

    Route loeschen
        Die aktuelle Route wird geloescht. Gleiche Funktion wie Druecken auf "Shift-Backspace".

        Der letzte Punkt der Route wird mit der Backspace-Taste geloescht.

    Route wiederherstellen (Undo)
        Die zuletzt geloeschte Route wird wiederhergestellt.

    gesperrte Strassen beachten
        Wenn dieser Schalter eingeschaltet ist, werden gesperrte Strassen und Einbahnstrassen nicht in die Suche einbezogen.

    Tragen vermeiden
        Stellen, an denen das Rad getragen werden muss, werden nicht in die Suche einbezogen.

    Faehren verwenden
        Faehren werden bei der Suche beruecksichtigt.

    Steigungen berechnen
        Hoehenangaben werden eingelesen und bei der Berechnung der Leistung werden die Hoehenangaben fuer Steigungen und Gefaelle verwendet.

    Ampel-Optimierung
        Bei der Suche einer Route wird fuer jede Ampel 25m, 50m oder 100m auf die entsprechende Strecke aufgeschlagen (nur fuer den Suchalgorithmus). Abhaengig von der Geschwindigkeit bekommt man fuer die Verzoegerungszeit pro Ampel folgende Tabelle:

        Zu lesen ist die Tabelle wie folgt: wenn man mit 25km/h unterwegs ist und als Aufschlag 100m gewaehlt hat, wuerde dies einer Verzoegerung von durchschnittlich 14s pro Ampel entsprechen.

    Steigungen/Gefaelle zeigen
        Auf der Route liegende Gefaelle oder Steigungen ueber 1% werden angezeigt.

    Startflagge
        Schaltet das Zeichnen einer Startflagge am Routenanfangspunkt ein oder aus.

    Zielflagge
        Schaltet das Zeichnen einer Zielflagge am Routenendpunkt ein oder aus.

Sucheinstellungen
    Einbahn-/gesperrte Strassen beachten
        Einbahnstrassen und gesperrte Strassen werden bei der Suche gemieden.

    Einbahn-/gesperrte Strassen *strikt* beachten
        Einige Einbahnstrassen sind als fuer Radfahrer in der Gegenrichtung befahrbar gekennzeichnet, obwohl sie es offiziell nicht sind. Mit dieser Option werden alle Einbahnstrassen gemieden (ausser fuer Radfahrer offiziell geoeffnete).

    Benutzerdefinierte Sperrungen
        In diesem Menue kann man private Sperrungen definieren, laden und speichern. Wenn der "Definieren"-Modus eingeschaltet wird, kann mit einem Klick auf eine Strasse diese als "gesperrt" gekennzeichnet werden. Ein nochmaliger Klick auf eine Sperrungen hebt diese auf.

        Weiterhin koennen "Aktive Sperrungen" geladen werden. Diese werden ca. woechenlich (falls man Internet-Updates macht) oder taeglich (falls man Updates per git macht) aktualisiert und enthalten beispielsweise Baustellen, Brueckensperrungen oder Veranstaltungen, die auch Radfahrer betreffen koennten.

    Tragen strikt vermeiden
        Bei der normalen Suche werden Abschnitte, in denen getragen werden muss (Treppen) mit einer hohen Penalty versehen. Wenn "strikt vermeiden" gesetzt ist, dann werden solche Strecken komplett gemieden.

    Schlechte Wege vermeiden
        (Q3 strikt meiden? XXX)

    Faehren verwenden
        Erlaubt die Benutzung von Faehren bei der Suche. Eine Pruefung, ob die Faehre zum jeweiligen Zeitpunkt ueberhaupt faehrt bzw. ob die Route dadurch schneller ist, wird nicht gemacht.

    Strassenqualitaet-Optimierung
        Optimiert nach der Strassenqualitaet (Asphalt, Kopfsteinpflaster etc.). Einstellungen werden unter "Optimierungsparameter einstellen" gesetzt.

    Strassenkategorie-Optimierung
        Optimiert nach der Strassenkategorie (Nebenstrasse, Hauptstrasse etc.). Einstellungen werden unter "Optimierungsparameter einstellen" gesetzt.

    Optimierung der sonstigen Behinderungen
        Optimiert nach sonstigen Behinderungen (Fussgaenger auf der Strasse, Bordsteine, sehr kurvige Strecken etc.). Einstellungen werden unter "Optimierungsparameter einstellen" gesetzt.

    Ampel-Optimierung
        Optimiert nach Anzahl der Ampeln. Einstellungen werden unter "Optimierungsparameter einstellen" gesetzt.

    Radwege-Optimierung
        Optimiert nach Vorhandensein von Radwegen. Einstellungen werden unter "Optimierungsparameter einstellen" gesetzt.

    Hauptstrassen ohne Radwege/Busspuren meiden
    Gruene Wege
    Unbeleuchtete Strassen meiden
    Steigungsoptimierung
        Hierbei werden die BikePower-Daten zur Berechnung verwendet.

    Abbiege-Optimierung
        Noch nicht implementiert.

    Optimierungsparameter einstellen
    Penalty
Beschreibung der aktuellen Route
    Es wird eine Routenbeschreibung in der folgenden Form angezeigt:

    Diese Beschreibung kann in eine Datei geschrieben, ausgedruckt oder als Mail verschickt werden.

    Routenbeschreibung in den Palm laden

    Folgendes gilt nur fuer Unix-aehnliche Betriebssysteme.

    In $PATH muss sich mindestens eins der folgenden Programme befinden: "iSiloBSD", "iSiloLinux" oder "pilot_makedoc".

    Die Sourcen zu "pilot_makedoc" bekommt man z.B. bei

    •   <ftp://ftp.forth.org/pub/PalmOS/>

    •   ftp://ftp.cs.tu-berlin.de/pub/palmtops/pilot/ <ftp://ftp.cs.tu-berlin.de/pub/palmtops/pilot/>

    •   <ftp://ftp.cso.uiuc.edu/pub/systems/PalmOS/>

    "iSilo" ist ein anderes Format, das einen speziellen Palm-Viewer braucht, der allerdings Hypertextfaehig ist. Die Binaries fuer die Umwandlung findet man unter <ftp://ftp.iSilo.com/pub/>. Hinweise zum PalmViewer befinden sich auf der Homepage von iSilo <http://www.iSilo.com/>.

    Die Uebertragung erfolgt automatisch, wenn "pilot-xfer" installiert ist, welches man auf folgenden FTP-Servern bekommt:

    •   <ftp://ryeham.ee.ryerson.ca/pub/PalmOS>

    •   <ftp://ftp.forth.org/pub/PalmOS/ryerson/>

Route loeschen
    Mit Klick auf dieses Icon wird die aktuelle Route geloescht.

Rueckweg-Symbol
    Start- und Zielpunkt der aktuellen Route werden vertauscht.

Koordinaten-Symbol
    Dieses Menue ist normalerweise nicht aktiviert und wird nur zum Editieren der Koordinatendateien benoetigt.

Info-Symbol
    Hiermit kann im Informationsmodus umgeschaltet werden. Beim Klick auf Kartenelemente wird jeweils ein Informationsfenster geoeffnet.

    Mit der "i"-Taste kann das Informationsfenster fuer das Kartenelement unter der Maus geoeffnet werden.

    Im Informationsfenster befinden sich Informationen zu: berechnete Laenge oder Flaeche, Koordinaten in verschiedenen Koordinatensystemen (WGS, GKK, UTM ...), Links zu der Web-Version von BBBike, BBBike/Mapserver, Google Maps, Berliner Stadtplan (und weitere Links, die durch Plugins bereitgestellt werden, z.B. durch das LuiseBerlin-Plugin), Sonnenauf/untergang (benoetigt das Perl-Modul Astro::Sunrise).

Karte verschieben
    Verschieben der Karte durch Ziehen der Maus

Salesman-Symbol
    (Dieses Symbol ist nur sichtbar, wenn das Salesman-Plugin geladen wurde)

    In diesem Modus kann die kuerzeste Rundreise berechnet werden. Dazu klickt man erst einmal in diesen Modus und waehlt alle gewuenschten Stationen der Rundreise an. Der erste und letzte Punkt werden fest als Start- und Zielpunkt markiert; alle anderen Punkte werden in ihrer Reihenfolge frei gewaehlt. Wenn man alle Stationen ausgewaehlt hat, muss man noch einmal auf das Salesman-Symbol klicken, um die Berechnung zu starten. Es wird darauf hingewiesen, dass bei einer grossen Anzahl von Stationen (mehr als acht) die Berechnung sehr lange dauert (der geneigte Leser kann sich die Problematik in der Literatur zum Thema "Problem des Handlungsreisenden" bzw. "Traveling salesman problem" aneignen). Wenn die Berechnung zu lange dauern wuerde, kann sie mit der Esc-Taste abgebrochen werden (wenn die Berechnung bereits mehr als zu 50% durchgefuehrt wurde, bekommt man dann noch ein Ergebnis, auch wenn es nicht das optimalste ist).

  DATEIOPERATIONEN

Oeffnen-Symbol
    Hiermit kann eine bereits gespeicherte Route wiedergeladen werden. Eine Liste der zuletzt geladenen Routen kann man mit Klick auf die rechte Maustaste erhalten.

    Zusaetzlich zum bbbike-Format kann auch eine Track-Datei von GPS-Navigationsgeraeten eingeladen werden. Die Datei muss aus Zeilen im folgenden Format bestehen:

      TRK N52 29.072278 E13 15.879650 1998/06/21-08:47:20 1

Speichern-Symbol
    Hiermit kann die aktuelle Route gespeichert werden.

    Menue:

    Mit den Menuepunkten kann man den aktuellen Ausschnitt der Karte als Bilddatei im Postscript-, GIF-, JPEG- oder PPM-Format speichern speichern. GIF-Dateien sind in der Regel am kleinsten. Postscript-Dateien sind vektororientiert und koennen somit beliebig ohne Qualitaetsverluste vergroessert werden. Das Erzeugen von JPEG- und PPM-Dateien ist normalerweise nicht empfehlenswert.

    Folgende Programme muessen fuer die verschiedenen Formate installiert sein:

                 |Postscript|  GIF  |  JPEG  |  PPM  |
      -----------+----------+-------+--------+-------+
      Ghostscript|    -     |   x   |    x   |   x   |
      pnmrotate  |    -     |   o   |    o   |   o   |
      ppmtogif   |    -     |   x   |    -   |   -   |
      cjpeg      |    -     |   -   |    x   |   -   |

    (x = erforderlich, o = optional, - = nicht erforderlich)

    Da der Postscript-Treiber, der fuer jede Konvertierung aufgerufen wird, die Schriften sehr klein darstellt, sollte im Orte-Menue der Punkt Sehr grosse Schrift gesetzt sein. Bessere Ergebnisse erhaelt man, wenn man die Option -usexwd (xwd als Screengrabber im Sonstiges-Teil des Optionseditors) einschaltet oder direkt mit einem Screengrabber (z.B. xwd oder xv) arbeitet.

Drucken-Symbol
    Ausdruck des angezeigten Kartenausschnitts. Der Ausdruck wird nicht direkt vorgenommen, sondern es wird eine Postscript-Datei erstellt und ein Postscript-Viewer (z.B. gv oder ghostview) aufgerufen, aus dem heraus gedruckt werden kann. Ist kein Postscript-Viewer vorhanden, wird in eine temporaere Datei geschrieben.

    Menue:

    Farbe, Graustufen, Schwarz-Weiss
        Diese Schalter kontrollieren die Farbausgabe des Drucks.

    Landscape, Portrait
        Diese Schalter geben an, ob im Landscape- oder im Portrait-Modus gedruckt werden soll. Im Portait-Modus erscheint die Karte verzerrt.

    auf A4 skalieren
        Wenn dieser Schalter aktiviert ist, wird die Karte so vergroessert, dass ein A4-Blatt vollkommen ausgefuellt ist.

    Legende
        Eine Legende mit Nordpfeil wird mit ausgedruckt.

    Legende rechts statt links
        Die Position der Legende wird geaendert.

  WEITERE ICONS

Fahrrad-Symbol (Bikepower)
    Aufruf des Bikepower-Moduls, z.B. zum Eintragen der persoenlichen und Fahrrad-Daten. Siehe BikePower.

Options-Symbol (O)
    Hiermit kann der Options-Editor aufgerufen werden.

    Menue:

    Ausgabe sofort aktualisieren
        Einige Kommandos wie Outline zeichnen oder Strassennamen werden nicht sofort ausgefuehrt, sondern beim nochmaligen Anwaehlen des jeweiligen Icons. Um die sofortige Aktualisierung zu erzwingen, kann dieser Schalter gesetzt werden.

    Netz sofort aktualisieren
        Hiermit wird die interne Darstellung des Strassennetzes aktualisiert.

    Alles aktualisieren
        Alle ausstehenden Kommandos werden ausgefuehrt.

    gedrehte Zeichensaetze
        Beim Zeichnen von Strassen- und Gewaessernamen werden gedrehte Zeichensaetze verwendet. Das Zeichnen wird dadurch verlangsamt, ausserdem wird der X-Server zusaetzlich belastet.

        Gedrehte Zeichensaetze koennen nicht gedruckt werden.

    Landscape
        Die Karte wird im "Landscape"-Modus angezeigt.

    Portrait
        Die Karte wird im "Portrait"-Modus angezeigt.

    Canvas balloon
        Einschalten eines Balloons (Tooltip-Hilfe) fuer den Kartenbereich. Im Untermenue kann zwischen kein (kein Balloon), nur Route (Balloon wird nur ueber einer Route angezeigt) und ueberall (Balloon wird ueber allen Kartenelementen angezeigt) ausgewaehlt werden.

    Farben aendern
        Mit diesem Menuepunkt koennen die Farben von bbbike geaendert werden. Die Aenderungen sind nicht permanent.

    Schriftart aendern
        Mit diesem Menuepunkt kann die Schriftart geaendert werden. Die Aenderung ist nicht permanent.

    Staendige Markierung
        Wenn dieser Punkt eingeschaltet ist, bleibt die Markierung nach einer Auswahl stehen, ansonsten blinkt die Markierung einige Male und wird dann geloescht.

    Markierung loeschen
        Falls Staendige Markierung eingeschaltet ist, kann eine Markierung mit diesem Menuepunkt geloescht werden.

    Status nach STDERR
        Statusmeldungen werden nicht in der Statuszeile angezeigt, sondern nach stderr umgelenkt.

    Wortreich (verbose)
        Es werden zusaetzliche Meldungen nach stderr ausgegeben.

Hilfe-Symbol (?)
    Anzeige der Online-Dokumentation (ueber Tk::Pod oder einen WWW-Browser).

    Menue:

    Legende
        Hiermit wird die Legende ein- und ausgeschaltet. In der Legende werden nur die gerade angezeigten Kartenelemente erklaert. Tastatur: "F1".

    Maushilfe
        Ein Fenster mit den wichtigsten Mausbefehlen wird angezeigt.

    Kontexthilfe
        Schaltet die Kontexthilfe ein.

    Netscape bbbike.html
        Zeigt die BBBike-Dokumentation in Netscape an.

    Ueber...
        Zeigt die Version von BBBike, perl und Tk an.

    Busy-Zeiger zuruecksetzen
        Es kann vorkommen, dass nach einem Fehler der Busy-Zeiger (Uhr oder Sandglas) nicht zurueckgesetzt wurde. Dies kann hiermit nachgeholt werden.

Kontexthilfe-Symbol
    Mit der Kontexthilfe kann die Hilfe fuer einen Button direkt angefordert werden.

Ende-Symbol
    Hiermit wird BBBike beendet. Temporaere Dateien werden geloescht und die Liste der zuletzt geoeffnet Routen-Dateien in "~/.bbbike/last" gespeichert. Tastatur: "Ctrl-q" oder "Ctrl-C".

OPTIONEN
Folgende Kommandozeilenoptionen sind definiert:

    Usage: ./bbbike [options] --[no]str --[no]landstr --[no]sbahn
        --[no]sbahnhof --[no]ubahn --[no]ubahnhof --[no]rbahn --[no]rbahnhof
        --[no]wasser --[no]wasserumland --[no]wasserstadt --[no]faehre
        --[no]flaeche --[no]ort --[no]hs --[no]pp --outline --[no]ampel
        --lsamaybe --[no]plothoehe --[no]showgrade --[no]strname --[no]ortname
        --ortkategorie --[no]wassername --rbahnnetz --usbahnnetz
        --faraway --fast --turbo --lowmem --[no]diplom --[no]mldbm --center
        --centerc --edit --[no]qualitaetoptimierung --[no]qualitaetwerte
        --[no]kategorieoptimierung --[no]kategoriewerte --[no]sperre
        --[no]nichttragen --[no]ampeloptimierung --beschleunigung --[no]wind
        --[no]bikepwr --resetpower --power --resetspeed --speed --[no]www
        --[no]wwwmap --[no]wwwcache --cachedir --proxy
        --[no]fontrot --fontfamily --fixedfontfamily --fontheight --fontweight
        --[no]balloon --[no]cballoon --cballoonwait --[no]contexthelp
        --[no]smoothscroll --[no]followmouse --[no]dialog --mapcolor
        --geometry --visual --scale --[no]overviewwasser --[no]flat
        --[no]transient --[no]autoscroll --autoscrollspeed --[no]audio
        --audiotype --coordout --printcmd --[no]gvreuse --[no]server
        --[no]autosave --[no]stderr --[no]advanced --[no]public -v --version
        -h

(Auswahl aus den Optionen:)

--center strasse
    Beim Starten wird auf die angegebene Strasse zentriert. Beispiel: "--center Dudenstr"

--centerc koord
    Beim Starten wird auf die angegebenen Koordinaten (Format "x,y") zentriert.

--proxy httpproxy
    Angabe eines Proxies fuer WWW-Verbindungen im Format "http://hostname:port/". Beispiel: "http://www.cs.tu-berlin.de:80/"

routefile
    Beim Starten wird die Routendatei geladen und angezeigt.

ANFORDERUNGEN
Fuer das Zeichnen der realen Karten sind folgende Programme aus dem pbmplus- bzw. netpbm-Paket notwendig:

•   giftoppm

•   pnmscale

•   djpeg (aus libjpeg)

Eine komplette Liste der optionalen perl-Module findet man in Bundle::BBBike.

INSTALLATION

  Allgemein
Die Installationsbeschreibung befindet sich in der Datei README bzw. README.html.

  fvwm2
Bei der Verwendung von fvwm2 koennen folgende Zeilen in .fvwm2rc oder .fvwmrc eingefuegt werden:

 Style "Bbbike*"        MiniIcon srtbike_mini.xpm
 Style "BbbikePassive"  GrabFocusOff, GrabFocusTransientOff

Die erste Zeile laesst das BBBike-Icon in der Titelleiste erscheinen. Dazu sollte die Datei srtbike_mini.xpm in ein Verzeichnis eingefuegt werden, wo sich die sonstigen fvwm-Icons befinden (siehe Direktive PixmapPath). Die zweite Zeile sorgt dafuer, dass "unwichtige" zusaetzliche Fenster nicht (unnoetigerweise) den Fokus erhalten.

BUGS
Zu viele...

•   Entfernungen von manuell erzeugten Strecken werden bei der Wegbeschreibung nicht beruecksichtigt, wenn eine Neuberechnung oder Rueckweg angewaehlt wurde.

•   Suche: Das Anwaehlen eines Punktes innerhalb einer gesperrten Strasse ist faelschlicherweise erlaubt. => Loesung: mit inaccessible_streets feststellen, ob der Punkt (oder beide Nachbarnpunkte) nicht erreicht werden kann und das Anwaehlen verhindern.

•   optionadd...*search hat auch Auswirkungen auf den Menuepunkt in Tk::Pod ... wie kann das begrenzt werden? Vielleicht MainWindow statt Toplevel fuer das Pod-Widget benutzen?

•   Beim Anzeigen einer Routenbeschreibung, die Landstrassen enthaelt, wird nichts ausgegeben, wenn Landstrassen nicht gezeichnet sind. => in nearest_points evtl. Landstrassen bei Bedarf nachladen (wie feststellen???).

•   Vias verschieben etc.: wenn eine Via-Flagge sich unterhalb eines anderen Symbol befindet, kann es nicht angeklickt werden => Loesung: Start,Via,Zielflagge bekommen ein zusaetzliches Tag, das relativ weit hinten in stack_order steht.

•   Ab und zu, besonders beim Wechseln zwischen Kartenmodi, reagiert bbbike beim Setzen eines Startpunktes nicht. Aushilfe: einmal "Route loeschen" auswaehlen, danach geht es wieder. => scheint behoben zu sein (siehe set_route_point, "XXX activating").

LIMITATIONS

•   Der Canvas-Postscript-Treiber kann mit rotierten Fonts nichts anfangen.

KOMPATIBILITAeT
BBBike wird zur Zeit unter FreeBSD 9.0 mit perl 5.12.4 und den neuesten Perl/Tk-Versionen (z.Zt. 804.030) entwickelt.

Testlaeufe werden von Zeit zu Zeit auf Windows XP/Vista/7, Mac OS X und Linux (Debian/squeeze, CentOS5) gefahren.

Es wird versucht, auch zu der aelteren perl-Version 5.00503 kompatibel zu bleiben. Dabei koennten aber einige Features auf der Strecke bleiben. Die Grundfunktionalitaet ist aber vorhanden.

perl 5.004 und aelter sowie Tk 400 und aelter wird nicht mehr unterstuetzt. Fuer diese Versionen sollte ein aelteres BBBike (Version 2.xx) verwendet werden.

ANERKENNUNG
TBD

AUTOR
Slaven Rezic - slaven@rezic.de <mailto:slaven@rezic.de>

PREREQUISITES
Tk.

COREQUISITES
Tk::FireButton, Tk::Pod, LWP::UserAgent, Mail::Send and many others. See Makefile.PL or Bundle/BBBike.pm in the distribution for a full list.

SEE ALSO
BikePower(3), Tk(3), perl(1).