PHost - PVCR Benutzerhandbuch

Inhalt

• Einleitung
• PVCR aufrufen
  • Kommandozeilen-Optionen
• Interaktive Benutzung
  • Spielauswahl
  • Kampfauswahl
  • Kampf anschauen
• Ergebnisse vom PVCR abfragen

Einleitung

PHost-Kampf muss mut PVCR abgespielt werden, dem PHost-Kampf-Recorder. Die eingebauten Recorder in planets.exe und Winplan können PHost-Kampf nicht wiedergeben, sie zeigen Fehler an oder stürzen ab.

Informationen zur Installation von PVCR für deinen Client findest du im Abschnitt Kampf des Dokumentes Das Erste Mal mit PHost. Dieses Dokument beschreibt die Benutzung von PHost.

PVCR ist ein 16-bit-DOS-Programm. PVCR kann alle Kämpfe wiedergeben, die mit einer öffentlichen PHost-Version erzeugt wurden, daher ist es nicht nötig, alte Versionen aufzuheben.

Nach oben

PVCR aufrufen

Die Aufrufsyntax für PVCR ist ähnlich der des PHosts:

pvcr [-v|-h] [-pspieler] [-s|-rprogramm] [-bN] [-f] [-F] [-tzeit] [-Xseg:ofs] [Spielverz [Hauptverz]]

Wenn du DOS-Planets benutzt, ist PVCR üblicherweise als vcr.exe installiert.

PVCR ist so konzipiert dass du, wenn du ihn für deine planets.exe oder dein VPA korrekt eingerichtet hast, die normale VCR-Funktion deines Clients nutzen kannst. Wenn du PVCR für Winplan eingerichtet hast, kannst du ihn normal starten, ohne größere Verrenkungen anstellen zu müssen.

Wenn du keine Option angibst, die etwas anderes besagt, macht PVCR folgendes, wenn er gestartet wird:

• wenn eine Datei vcrinit.tmp existiert, liest PVCR die Anweisungen aus dieser Datei. Diese Datei wird von planets.exe erzeugt. PVCR lässt den Anwender dann Kämpfe auswählen und ansehen, solange er mag. Wenn PVCR beendet wird, wird wieder planets.exe gestartet. Wenn die Kämpfe nicht von PHost erzeugt wurden, übergibt PVCR sie an den normalen VCR (vcr.exe).
• (v4.0f:) sonst, wenn eine Datei gamestat.dat existiert, bietet PVCR ein Menü aller darin definierten Spiele an. Das trifft zu, wenn du PVCR aus dem Winplan-Verzeichnis heraus startest.
• wenn keiner dieser Fälle zutrifft, lädt PVCR planets.exe, genau wie Tims VCR.

Kommandozeilen-Optionen

Nach oben

Interaktive Benutzung

Spielauswahl

Die Spielauswahl gibt es in Version 4.0e und später.

In der Spielauswahl werden zwei Menüs angezeigt. Links stehen die verfügbaren Spiele (entsprechend den 8 Spiel-Slots von Winplan), rechts stehen alle Spieler, die in diesem Zug Kämpfe sehen.

• Nutze die Pfeiltasten für die Bewegung.
• Im linken Panel wählt Enter das entsprechende Spiel aus und platziert den Cursor auf dem rechten Panel (mit der Cursortaste "links" kommst du zurück). Im rechten Panel wählt Enter ein Volk aus und wechselt zur Kampfauswahl.
• ESC beendet PVCR (auch, wenn -r angegeben wurde, wird kein Programm geladen!).

Kampfauswahl

Du siehst Informationen über einen Kampf. Du kannst durch die Kämpfe blättern und sie abspielen. Nach jedem Kampf gelangst du in die Kampfauswahl zurück.

• Die Pfeiltasten blättern zum nächsten/vorigen Kampf.
• Enter zeigt den aktuellen Kampf an.
• ESC beendet PVCR und lädt planets.exe bzw. das mit -s/-r eingestellte Programm.
• F1 zeigt den Abspann an.

Kampf anschauen

Der Kampf wird in der oberen Hälfte des Bildschirmes angezeigt: die Schiffe als Rechtecke, Raumjäger als Dreiecke usw. In der unteren Hälfte stehen laufende Daten zu den Einheiten, wie der aktuelle Schaden, Ladezustand der Waffen, und so weiter.

• Die Leertaste startet/unterbricht die Wiedergabe.
• "+" und "-" verändern die Geschwindigkeit der Wiedergabe.
• ESC kehrt in die Kampfauswahl zurück.

Nach oben

Ergebnisse vom PVCR abfragen

Dieser Abschnitt ist nur für Programmierer von Interesse.

Diese Schnittstelle ist vermutlich nicht besonders nützlich, aber sie existiert und wird daher hier beschrieben. Wenn du Kämpfe simulieren möchtest, ist es vermutlich einfacher, das PDK oder die Datei combat.log zu verwenden.

Wenn du die Option -Xseg:ofs angibst, liefert PVCR Informationen über die angesehenen Kämpfe an das aufrufende Programm. Die Adresse wird im üblichen hexadezimalen Format für Real-Mode-Adressen (also z.B. 12CF:038E) angegeben.

Der Ergebnisbereich muss mit den folgenden zwei Elementen beginnen:

long      Signature
word      Number of Results

Das erste Feld muss auf den Wert 1033FE51h gesetzt werden; damit prüft PVCR, dass er nicht versehentlich uninitialisierten Speicher überschreibt.

Der Header wird von einer Anzahl Ergebnis-Strukturen gefolgt. Die Anzahl ist im Header angegeben. PVCR speichert nicht mehr Ergebnisse als angegeben im Ergebnis-Bereich.

Die Ergebnis-Strukturen haben folgendes Format:

word      Valid
word[2]   Shields
word[2]   Damage
word[2]   Fighters
word[2]   Torps
word[2]   Crew
word[2]   Outcome

Das erste Feld wird von PVCR auf 1 gesetzt, wenn die folgenden Werte gültig sind (also den korrekten Ausgang des Kampfes wiedergeben). PVCR speichert die Ergebnisse nur, wenn der Kampf tatsächlich angesehen wurde. Es werden die Ergebnisse zu dem Zeitpunkt gespeichert, zu dem die Wiedergabe beendet wurde. Wenn der Kampf also bis zu Ende angeschaut wurde, steht hier der korrekte Kampfausgang. Wenn der Nutzer vorzeitig abgebrochen hat, wird der Zustand zum Zeitpunkt des Abbruchs gespeichert.

Die restlichen Felder sollten selbsterklärend sein. Das Feld Outcome ist das gleiche wie in util.dat:

Sobald PVCR beendet wird, wird das Feld Valid auf den Wert 51FE3310h. Damit wird verhindert, dass der Übergabe-Bereich versehentlich noch einmal verwendet wird; außerdem wird dem Aufrufer damit signalisiert, dass die Ergebnisse korrekt ausgefüllt wurden (PVCR also ohne Fehler beendet wurde).

Nach oben

Letzte Aktualisierung 31 May 2015.