qtkrparse.php

german

english

QTVR-Dateien für KRPano

aktuelle Version: 2.1

Funktion

qtkrparse.php hat zwei Funktionen: Der erste Teil liest aus einer Quicktime VR Datei die Parameter und Dateioffsets der Bilddaten und erzeugt daraus eine XML-Datei, eine Datei mit der Zugriffsinformation und ein Vorschaubild. Der zweite Teil lädt mit Hilfe dieser Information und der krpano-Nummerierung der Kacheln die Bilddaten direkt aus der QTVR-Datei in den Flash-Player.

Vorbedingungen

Außer den Bedingungen für KRPano muß der Server PHP-Skripte ausführen können. qtkrparse.php muß im gleichen Verzeichnis wie die QTVR-Datei(en) liegen (es ist möglich, qtkrparse.php per mod_rewrite einzublenden). In diesem Verzeichnis muß PHP Schreibrechte haben.

krpano.swf muß mindestens in Version 1.0.3 vorliegen.

In QTVR-Dateien sind nur Jpeg-komprimierte Bilder erlaubt, Headerkompression wird nicht unterstützt. krpano gibt entsprechende Fehlermeldungen aus, wenn eine solche Datei vorliegt.

Anwendung

qtkrparse.php wird mit der QTVR-Datei als GET-Parameter "mov" statt der XML-Datei an krpano.swf übergeben. Es empfiehlt sich hier die Methode mit Javascript per SWFObject zu verwenden, z.B.:

var so = new SWFObject("krpano.swf", "krpanoSWFObject", "100%", "100%", "9.0.28","#000000");
so.addVariable("pano", "qtkrparse.php?mov=mein.mov");

Details zum Einbetten von krpano siehe http://www.krpano.com/docu/html/
Auch der direkte Aufruf per GET-Parameter ist möglich:

krpano.swf?pano=qtkrparse.php%3Fmov=mein.mov

Da der doppelte GET-Trenner "?" einige Browser verwirren würde, ist es besser das zweite "?" als "%3F" zu maskieren.

Details

qtkrparse.php benutzt einen großen Teil des Codes von qtparser.php. Siehe http://fieldofview.com/spv-dev/projects/qtparser
qtkrparse.php bindet generell eine evtl. vorhandene Datei krpano.inc ein, die zusätzlichen XML-Code enthalten kann. qtkrparse.php erzeugt mit <krpano> nur das äußere Gerüst und das <view>-tag, so daß alle anderen tags mit Hilfe dieser Datei eingebunden werden müssen.
Die folgenden <view>-attribute werden aus der QTVR-Datei gelesen: hlookat, vlookat, fov, fovmin, fovmax, hlookatmin, hlookatmax, vlookatminundvlookatmax
Die folgenden <view>-attribute werden in qtkrparse.php vorbelegt: fisheye="0", fisheyefovlink="0.5", limitfov="true", camroll="0.0"
limitview wird entsprechend der min- und max-attribute gesetzt: Wenn hlookatmin - hlookatmax = 360° und vlookatmin - vlookatmax = 180° (also die gesamte Sphäre sichtbar ist) mit "lookat", sonst mit "range".
Alle diese <view>-Attribute können mittels Parameter im Javascript-code überschrieben werden, z.B. um in den Genuß der Fisheye-Funktion von krpano zu kommen:

so.addVariable("view.fisheye","0.35");
so.addVariable("view.fovmax","179");
qtkrparse.php schreibt beim ersten Aufruf zwei oder drei Dateien in das Verzeichnis in dem die QTVR-Datei liegt. Eine mit der Endung .xml, eine mit der Endung .ofs und ein optionales .jpg Vorschaubild. Die Namen aller Dateien werden aus Namen und Endung der QTVR-Datei konstruiert. Aus mein.mov wird z.B. mein_mov_kr.xml, mein_mov_kr.ofs.und mein_mov_prv.jpg. Bei allen folgenden Aufrufen werden diese Dateien nur noch gelesen, es sei denn ihr Dateidatum ist älter als das der QTVR-Datei oder von qtkrparse.php. In diesem Falle werden die Dateien auch erzeugt. Das läßt sich auch mit dem Parameter cache=reset erzwingen, z.B.

qtkrparse?mov=mein.mov&cache=reset
Wenn relative Pfade benutzt werden sollen (z.B. um eine einzelne Kopie von krpano.swf für mehrere Verzeichnisse zu benutzen) muß das im Aufruf von qtkrparse.php geschehen, nicht in der URL der QTVR-Datei:

var so = new SWFObject("../krpano/krpano.swf", "krpanoSWFObject", "100%", "100%", "9.0.28","#000000");
so.addVariable("pano", "../meinpfad/qtkrparse.php?mov=mein.mov");
Die Erzeugung und Verwendung von Vorschaubildern kann in qtkrparse.php abgeschaltet werden, indem man die Variable $UsePreview = false; setzt.
Vorschaubilder werden erst beim zweiten Laden des Panoramas angezeigt.

Versionsgeschichte

v1.0: 12.6.2008
        - erste öffentliche Version
v1.1: 22.6.2008
        - "Expires" und "Last-Modified" header gesetzt um caching zu ermöglichen
v1.2: 24.7.2008
        - kompatible mit den neuesten php versionen
v2.0: 18.8.2008
        - benutzt das QTVR Vorschaubild (falls vorhanden).
        - Der interne Fehler-Mechanismus berücksichtigt jetzt die aktuelle Einstellung von error_reporting
v2.0.1: 9.9.2008
        - bugfix: apache_request_headers erzeugte Fehler wenn nicht existent.
v2.1: 14.9.2008
        - Unterteilung der Würfelflächen (subtiling) wird jetzt auch für eine gerade Anzahl pro Seite unterstützt (2x2, 4x4, 6x6...)

Beispiele / Debugging

Alle Kugelpanoramaen auf http://pano.erik-krause.de werden mit Hilfe von qtkrparse dargestellt wenn man Flash als Fullscreen-Viewer wählt. Die Aufrufe sind allerdings hinter ein paar Rewrite-Regeln versteckt. Man kann die Panoramen allerdings auch manuell aufrufen:

http://pano.erik-krause.de/turm/convert2.php?file=turm_qt.htm&format=krpano konvertiert die Seite turm_qt.htm welche im Original das QTVR zeigt.
http://pano.erik-krause.de/turm/krpano.swf?pano=qtkrparse.php%3Fmov=turm.mov z.B. lädt das Panorama direkt.
http://pano.erik-krause.de/turm/qtkrparse.php?mov=turm.mov zeigt die erzeugte XML-Datei.
Nimmt man aus dieser eine beliebigen Aufruf von qtkrparse und ersetzt die Platzhalter für x_ofs und y_ofs kann man ein einzelnes Subtile anschauen: http://pano.erik-krause.de/turm/qtkrparse.php/tile.jpg?mov=turm.mov&action=tile&face=up&x_ofs=0&y_ofs=0 Die Offsets der Subtiles werden übrigens mit 0,0 für das mittlere Element gespeichert. -1,-1 bezeichnet das Elemet links oben, 1,1 das rechts unten.

Diese Art des Aufrufs kann u.a. verwendet werden, um herauszufinden, warum ein Panorama nicht lädt.

HTML-Konverter

Um bestehende HTML-Seiten die QTVR einbinden nicht neu erstellen zu müssen, gibt es convert2.php als Teil des Birdcap-Pakets von Bernhard Vogl . Die für qtkrparse erweiterte Version liegt bei. Um eine bestehende Seite zu für krpano zu ändern wird sie in einem link an convert2.php als Parameter übergeben, z.B.:

<a href="convert2.php?file=panorama.html&format=krpano">Flash-Version</a>

convert2.php ersetzt das

<object>

und <embed> tag von Quicktime durch einen entsprechenden Aufruf von

SWFObject

mit krpano.swf.

qtkrparse.zip herunterladen

Fragen, Anregungen, Kommentare und Korrekturen bitta an mich

QTVR-files for KRPano

current version: 2.1

Function

qtkrparse.php has two functions: The first part reads parameters and offsets of images from a Quicktime VR file and creates from this a XML file, a file with the offset info and a preview image. The second part loads the image data directly from the QTVR-file into the flash player with help from the krpano numbering and the offsets file.

Prerequisites

The server must be suitable for KRPano of course and must be able to execute PHP scripts. qtkrparse.php must reside in the same directory as the QTVR file(s) (it is possible to mirror qtkrparse.php by mod_rewrite). PHP must have write rights in this directory.

krpano.swf must be at least version 1.0.3.

The QTVR-files must contain only Jpeg-compressed images. Header compression is not supported.krpano issues an error message if such a file is found.

Usage

qtkrparse.php must be used with the QTVR file as GET parameter "mov" instead of the XML file by krpano.swf. It is advisable to use SWFObject and javascript to do this, f.e.:

var so = new SWFObject("krpano.swf", "krpanoSWFObject", "100%", "100%", "9.0.28","#000000");
so.addVariable("pano", "qtkrparse.php?mov=my.mov");

For details on how to embed krpano please see: http://www.krpano.com/docu/html/
Even the direct call with GET parameter is possible:

krpano.swf?pano=qtkrparse.php%3Fmov=my.mov

The double GET-delimiter "?" does not work with some browsers hence it is better to mask the second "?" as "%3F".

Details

qtkrparse.php uses a good deal of code from qtparser.php. See http://fieldofview.com/spv-dev/projects/qtparser
qtkrparse.php includes a file krpano.inc if present. This file can contain additional XML code since qtkrparse.php creates only a basic file containing <krpano> and the <view> tag. All other tags must be included through this file.
The following <view> attributes are read from the QTVR file: hlookat, vlookat, fov, fovmin, fovmax, hlookatmin, hlookatmax, vlookatminand vlookatmax
The following <view> attributes are preset by qtkrparse.php: fisheye="0", fisheyefovlink="0.5", limitfov="true", camroll="0.0"
If hlookatmin - hlookatmax = 360° and vlookatmin - vlookatmax = 180° (wich displays the whole sphere) limitview is set to "lookat" else to "range".
All these <view> attributes can be overwritten in the SWFObjects javascript code, f.e. to know the promise of the fisheye function of krpano:

so.addVariable("view.fisheye","0.35");
so.addVariable("view.fovmax","179");
if called the first time with a particular QTVR qtkrparse.php writes two or three files to the directory of the QTVR file. One with the extension of .xml, one with .ofs and the optional .jpg preview image. The names of all files are made up from name und extension of the QTVR file. my.mov f.e. results in my_mov_kr.xml, my_mov_kr.ofs and my_mov_prv.jpg. All subsequent calls read those files, except their creation date is older than the QTVR file or qtkrparse.php. In this case new files are written. This can be forced with the parameter cache=reset, f.e.:

qtkrparse?mov=mein.mov&cache=reset
If relative path should be used (f.e. to use a single copy of krpano.swf for multiple directories) they must be specified in the qtkrparse.php call, not in the QTVR file URL:

var so = new SWFObject("../krpano/krpano.swf", "krpanoSWFObject", "100%", "100%", "9.0.28","#000000");
so.addVariable("pano", "../mypath/qtkrparse.php?mov=my.mov");
The creation and usage of preview images can be switched off in qtkrparse.php by setting $UsePreview = false;
Preview images will be displayed the second time a panorama is viewed.

HTML-Converter

In order to use existing HTML pages with embedded QTVR without the need to create them again there is convert2.php as a part of the Birdcap-package by Bernhard Vogl . A version extended for qtkrparse is enclosed in the download. To display an existing page with krpano pass it as a parameter to convert2.php in a link, f.e.:

<a href="convert2.php?file=panorama.html&format=krpano">Flash version</a>

convert2.php replaces the

<object>

and <embed> Quicktime tag by an apprpropriate call of SWFObject with krpano.swf. You need SWFObject 1.5, of course. For details see

Version History

v1.0: 2008-6-12
        - first public Version
v1.1: 2008-6-22
        - "Expires" and "Last-Modified" header set in order to allow caching
v1.2: 2008-7-24
        - compatible with recent php versions
v2.0: 2008-8-18
        - uses an optional QTVR preview image
        - internal error mechanism now uses current error_reporting setting.
v2.0.1: 2008-9-9
        - bugfix: apache_request_headers caused error if not defined.
v2.1: 2008-9-16
        - Subtiled cube faces can now contain an even number of subtiles along one side, too (3x3, 4x4, 6x6,...)

Examples / Debugging

All Sphericals on http://pano.erik-krause.de are displayed with the help of qtkrparse.php if you choose Flash als fullscreen viewer. The calls are hidden behind some rewrite rules. But you can call the panoramas manually, too:

http://pano.erik-krause.de/turm/convert2.php?file=turm_qt.htm&format=krpano converts the page turm_qt.htm which originally shows the QTVR.
http://pano.erik-krause.de/turm/krpano.swf?pano=qtkrparse.php%3Fmov=turm.mov loads the panorama directly.
http://pano.erik-krause.de/turm/qtkrparse.php?mov=turm.mov shows the created XML file.
If you take an arbitrary qtkrparse call from the XML file and substitute the placeholders for x_ofs and y_ofs you can see a cube face or subtile: http://pano.erik-krause.de/turm/qtkrparse.php/tile.jpg?mov=turm.mov&action=tile&face=up&x_ofs=0&y_ofs=0 BTW: The offsets of the subtiles are stored with 0,0 for the middle element. -1,-1 identifies the elemet top left, 1,1 the one bottom right.

These kind of calls can be used f.e. to determine the reason why a panorama won't display.

download qtkrparse.zip

For questions, suggestions, comments and corrections please contact me

Erik Krause 2008