Funktionen

Allgemeine Darstellung von Versionsinformationen
Darstellung von erweiterten Versionsinformationen
Funktionentabele
Menüsteuerung: Beispiele
Maussteuerung: Kurzübersicht
Tastatursteuerung: Kurzübersicht


Darstellung von Versionsinformationen

Das, was BranchView anzeigt, hängt eng damit zusammen, wie man BranchView konfiguriert.

Falls BranchView mit dem Parameter "-all" gestartet wurde, werden Informationen über sämtliche Versionen aus allen Branchen, die P4 Client zum eingegebener Datei/Verzeichnis bieten kann, geholt. Für die konstruierte Beispiel- Datei //depot/perforce/testroot/itest/Test.java sieht es dann so aus:

Bild 1: Darstellung nach dem Start mit dem Parameter "-all"

Wäre BranchView stattdessen ohne Parameter "-all" gestartet, wurde man folgendes Bild sehen:

Bild 2: Darstellung nach dem Start ohne den Parameter "-all"

Man sieht den Unterschied: es sind weniger Versionen Dargestellt, einige sind rot umrandet, andere orange und punktiert.

Schliesst man nun BranchView und startet es im "offline" - Mode, versucht das Programm die alte Logdatei zu laden und darszustellen. Da aber jetzt die Informationen nur aus "zweiter Hand" sind, zeichnet BranchView alle Versionen orange bzw. rot umrandet.

Bild 3: Darstellung nach dem Start mit dem Parameter "-offline"

Und im nächsten Bild sind sämtliche Arten der Vererbungsbeziehungen dargestellt, die BranchView kennt: branch, copy, ignored, merge, edit, integrate, delete.

 

Bild 4: Weitere Merkmale der Darstellung (nach dem Start mit dem Parameter "-all")

 

Darstellung von erweiterten Versionsinformationen

BranchView kann ausser den bereits gezeigten Informationen noch weitere darstellen. Geht man mit der Maus über eine der Versionen, zeichnet BranchView eine "ToolTip"- Hilfe, die weiterführende Informationen über die Version enthält:

Bild 5: Darstellung der erweiterten Informationen über eine "bekannte" Version

Wäre diese Version BranchView noch nicht "bekannt", würde man folgendes sehen:

Bild 6: Darstellung der erweiterten Informationen über eine "unbekannte" Version

Und so sieht ein Ausschnitt aus dem "Snapshot" von dem Public Depot von Perforce, wo aus einer Version gleich mehrmals integriert wurde (4 mal branch und ein mal copy):

Bild 7: Darstellung der erweiterten Informationen mit mehreren Integrate's im "offline" - Modus

Hier sieht man sehr schön, dass im BranchView durch scrollen weitere Bildauschnitte sichtbar gemacht werden können, wenn nicht alle Versionen in ein kleines Fenster passen.

 

Funktionentabelle

Es gibt viele Funktionen, die auf drei unterschiedlichen Wegen erreichbar sind: Per Maussteuerung, Tastatur oder zwei Menüs, die durch 1x rechts klicken auf der Oberfläche erscheinen. Für fast jede Funktion existiert ein entsprechender Menüeintrag.

BranchView bietet zwei unterschiedliche kontextsensitive Menüs: Eins für die allgemeine Operationen und eins, das versionsbezogen ist. Falls ein Menüpunkt z.Z. nicht aktiviert ist (leicht grau), bedeutet es, dass diese Operation im aktuellen Kontext nicht möglich ist.

Menüpunkt Beschreibung der Funktion Besonderheiten /
aktiv wenn
Tastatur- Kürzel oder Mausklick

Spezielles Version - Menü
get info's for this branch Fordert von Perforce Informationen über den ausgewählten Branch Eine als "unbekannt" dargestellte Version muss angeklickt sein 2x links klicken
get info's over all branches Fordert von Perforce Informationen über alle Branches, die z.Zt. nicht vollständig "bekannt" sind Eine Version muss angeklickt sein, und es muss mindestens eine Version als "unbekannt" dargestellt sein -
diff to...

Maussteuerung: durch Markierung der zwei Versionen naceinander wird automatisch ein vorkonfiguriertes Diff-Tool gestartet.

Menü: Zeigt ein Hinweis

Im "offline" - Modus nicht verfügbar.

Es kann keine "gelöschte" Version mit einer anderen verglichen werden.

1x "from" - Version links klicken und dann 1x "to" - Version links klicken
copy info to clipboard Kopiert Informationen über die ausgewählte Version in die Zwischenablage

Eine Version muss selektiert/angeklickt sein.

Ctrl + C
- Kopiert die gesamte Logdatei in die Zwischenablage Es darf keine Version selektiert sein. Ctrl + C

Allgemeines Menü
redo layout Strukturiert die Anzeige neu, dabei werden die Veränderungen an Positionen, die durch Benutzer durchgeführt wurden, verworfen   Ctrl + R
save as image... Bietet den Dialog zum speichern der Anzeige als ein GIF - Bild an   Ctrl + S
get/set properties... Öffnet ein Einstellungsdialog Die Einstellungen sind für alle zur Zeit geöffneten BranchView Fenster gültig Ctrl + P
view another file...

Menü: öffnet ein Dialog zum auswählen einer neuen Datei für die Anzeige. Dabei wird ein neues Fenster geöffnet.

Tastatur: die Pfadinformationen aus der Zwischenablage werden übernommen und die Anzeige wird mit diesem Pfad neu aufgebaut

Im "offline" - Modus nicht verfügbar.

Falls in der Zwischenablage ein ungültiger Pfad ist, und der Menüpunkt per Tastaturkürzel aktiviert wurde, wird ein Fehler angezeigt.

Ctrl + V
- Öffnet ein neues Fenster mit der selben Ansicht   Ctrl + N
change logfile location...

"Online" - Modus: wechselt den Pfad zu der Datei, in der die von P4 empfangene Daten gespeichert werden sollen

"Offline" - Modus: wechselt den Pfad zu der Datei, von der die Daten für die Anzeige stammen sollen, baut dann die Anzeige im selben Fenster neu auf

  Strg + L
zoom Verkleinert/vergrössert den Zoom

Bei grösseren Bildausschnitten kann es lange dauern, bei zu grossen Werten kann bei vielen Versionen ( > 200 ) zum OutOfMemoryError führen

Ctrl + '+' zoom in
Ctrl + '-' zoom out
x space Verkleinert/vergrössert den Abstand zwischen den einzelnen Branchen in der Anzeige. Bei zu grossen Werten kann bei vielen Versionen ( > 200 ) zum OutOfMemoryError führen -
y space Verkleinert/vergrössert den Abstand zwischen den einzelnen Changes in der Anzeige. Bei zu grossen Werten kann bei vielen ( > 200 ) Versionen zum OutOfMemoryError führen -
help Zeigt eine kurze online - Hilfe   F1
about Zeigt einige Informationen über das System, Java- Laufzeitumgebung, Programmversion und Autor   Ctrl + A

 

Menüsteuerung: Beispiele

So z.B. kann man über eine "unbekannte" Version folgendes Menü bekommen, wenn man mit der Maus 1x rechts klickt:

Bild 8: Spezielles Menü bei nicht "bekannter" Version

 

Gleiches über eine "bekannte" Version erzeugt folgendes Menü (beachte den ersten Eintrag): hier sind die Informationen über die Branch ITEST bereits komplett und deswegen der Menüeintrag, der die Informationen über diese Branch holen soll, deaktiviert.

Bild 9: Spezielles Menü bei "bekannter" Version

 

Hier sind die Informationen über alle Branchen bereits komplett und daher sind beide Menüeintrage zum Anfordern der Daten von Perforce deaktiviert.

Bild 10: Spezielles Menü wenn alle Versionen "bekannt" sind

 

Hier sieht man die Wirkung des "redo layout" Menüeintrages: bevor ...

Bild 11: Darstellung vom Benutzer verändert

 

.. und danach.

Bild 12: Vom Benutzer veränderte Darstellung zurückgesetzt und neu strukturiert

 

BranchView bietet ausserdem die Möglichkeit, die Anzeige aktuellen Bedürfnissen anzupassen, indem die Abstände zwischen den Branchen und/oder Changes verändert werden ("x" bzw. "y space" -Schieber).
Verglichen mit dem Bild 8 ist die nächste Anzeige kompakter.

Bild 13: Veränderung der Abstände auf der X- Achse

 

Und nun auch die Y -Achse:

Bild 14: Veränderung der Abstände auf der Y- Achse

 

Hier wurden Zoom, x und y Abstände erhöht.

Bild 15: Veränderung des Zooms, X und Y Abstände

 

Falls man eine Version 1x links anklickt, wird diese "selektiert" Dargestellt, und eine dünne Linie verfolgt die Maus. Das bedeutet, dass die erste Version für den Diff -Tool ausgewählt wurde und nun eine zweite Version angeklickt werden muss.

Bild 16: Start der Auswahl von Versionen für das Diff - Tool

 

Nun ist die zweite Version selektiert, es wird automatisch ein vorkonfiguriertes Diff -Tool gestartet.
Um diese Markierung später zu löschen, reicht es, einfach mit der Maus irgendwo im lehrem Feld oder auf die Ausgangsversion 1x links zu klicken.

Bild 17: Ende der Auswahl von Versionen für das Diff - Tool

 

Im Konfigurationsdialog kann man sämtliche Laufzeitparameter von BranchView festlegen.

Bild 18: Konfigurationsdialog

 

 

Tastatursteuerung: Kurzübersicht

STRG + N öffnet ein neues Fenster

STRG + V öffnet ein neues Fenster, wenn im Clipboard ein P4 Pfad ist

STRG + C kopiert Informationen nur über die ausgewählte Version in die Zwischenablage

STRG + C kopiert gesamte P4 Ausgabe in in die Zwischenablage, wenn keine Version ausgewählt ist

STRG + S öffnet ein Dialog zum Speichern als GIF-Grafik

STRG + R strukturiert die Anzeige neu

STRG + P öffnet ein Dialog mit Einstellungen

STRG + L öffnet ein Dialog zum ändern der Logdatei

STRG + '+' vergrössert Zoom

STRG + '-' verkleinert Zoom

'Pos 1' springt nach ganz oben

'Ende' springt nach ganz unten

F1 zeigt diese Hilfe

 

Maussteuerung: Kurzübersicht

2x links klicken auf eine Version holt evt. fehlende Daten von Perforce.

1x links klicken markiert die erste Version für den Diff-Tool, (gelöschte Versionen können nicht verglichen werden!) jede andere Version, die dann 1x angeklickt wird, wird die zweite Version für den Diff-Tool.

1x klicken auf den Hintergrund löscht die aktuelle Markierung.

1x links klicken und ziehen auf eine Version verschiebt nur diese eine Version

1x links klicken und ziehen auf den Hintergrund scrollt die Ansicht

1x links klicken + CTRL + SHIFT halten und ziehen auf eine Version verschiebt ganzes Bild.

1x rechts klicken, (oder 1x links klicken + CTRL halten) und ziehen auf eine Version verschiebt ganzes Branch.

1x rechts klicken auf den Hintergrund öffnet ein allgemeines Menü.

1x rechts klicken auf eine Version öffnet ein Version-spezifisches Menü.