qtkrparse.php

german

english

QTVR-Dateien für KRPano

aktuelle Version: 3.0.2

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 KRPano-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 muß mindestens in Version 1.1.8 vorliegen.

In QTVR-Dateien sind nur Jpeg-komprimierte Bilder erlaubt, Headerkompression wird nicht unterstützt. qtkrparse gibt via krpano 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 embedpano übergeben:

Details zum Einbetten von krpano siehe http://www.krpano.com/docu/html/

Die Flash-Version kann auch direkt per GET-Parameter aufgerufen werden:

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

Das zweite "?" muss als "%3F" maskiert werden.

Details

qtkrparse.php benutzt einen großen Teil des Codes von qtparser.php von Aldo Hoeben: http://fieldofview.com
qtkrparse.php bindet generell eine evtl. vorhandene Datei krpano.inc ein, die zusätzlichen XML-Code enthalten kann. qtkrparse.php erzeugt mit <krpano> und optionalem <preview>-tag nur das äußere Gerüst und das <view>- und <image>-tag (mit untergeordnetem <level>-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, vlookatmin undvlookatmax
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:

var so = document.getElementById("krpanoSWFObject"); so.set("view.fisheye","0.35"); so.set("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 für mehrere Verzeichnisse zu benutzen) muß das im Aufruf von qtkrparse.php geschehen, nicht in der URL der QTVR-Datei:

embedpano({swf:"krpano.swf", xml:"../meinpfad/qtkrparse.php?mov=mein.mov", target:"krpano-div-id", html5:"auto"});
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...)
v3.0: 11.11.2016: - Unterstützung für krpano HTML5 viewer (und damit für tablets und smartphones)
v3.0.1: 12.11.2016: - Kontextmenü mit krpano Projektionen hinzugefügt (in krpano.inc)
v3.0.2: 22.08.2017: - PHP 7 kompatibel

Beispiele / Debugging

Alle Kugelpanoramen auf http://pano.erik-krause.de werden mit Hilfe von qtkrparse dargestellt. Die Aufrufe sind allerdings hinter ein paar Rewrite-Regeln versteckt. Man kann die Panoramen aber 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 (für 3x3 Subtiles).

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, liegt convert2.php bei (ursprünglich aus dem Birdcap-Paket von Bernhard Vogl). 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">interaktives Panorama</a>

convert2.php ersetzt das <object> und <embed> tag von Quicktime durch einen entsprechenden Aufruf von embedpano.

.htaccess Beispiel für qtkrparse

Wenn die .htm-Dateien mit QTVR Panoramen mittels eines bestimmten Musters erkennbar sind, kann die Arbeit von wenigen Umleitungsregeln erledigt werde.

# Umleitung einschalten RewriteEngine on # angenommen der Ordner, der krpano, qtkrparse.php und convert2.php enthält ist /tools # alle Aufrufe von convert2.php nach /tools umleiten RewriteRule (^|/)convert2\.php$ tools/convert2.php [L] # alle Aufrufe von qtkrparse.php nach /tools umleiten RewriteRule (^|/)qtkrparse\.php(.*)$ tools/qtkrparse.php$2 [L] # alle Aufrufe von krpano nach /tools umleiten RewriteRule (^|/)krpano\.(.*)$ tools/krpano.$2 [L] # angenommen alle htm-Dateien mit QTVR Panoramen können mit *_qt.htm gefunden werden # convert2.php mit dem Dateinamen als Parameter aufrufen RewriteRule ^(.*)/([^./]+_qt)\.htm$ /$1/convert2.php?file=$2.htm [L]

qtkrparse.zip herunterladen

Fragen, Anregungen, Kommentare und Korrekturen bitta an mich

QTVR-files for KRPano

current version: 3.0.2

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 must be at least version 1.1.8.

The QTVR-files must contain only Jpeg-compressed images. Header compression is not supported. qtkrparse issues an error message via krpano 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 embedpano:

For details on how to embed krpano please see: http://www.krpano.com/docu/html/

The flash version can be called directly by GET parameter:

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

The second GET-delimiter "?" must be masked as "%3F".

Details

qtkrparse.php uses a good deal of code from qtparser.php by Aldo Hoeben: http://fieldofview.com
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>, <preview>, <view>- and <image> tag (with <level> sub-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, vlookatmin and 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 javascript code, f.e. to know the promise of the fisheye function of krpano:

var so = document.getElementById("krpanoSWFObject"); so.set("view.fisheye","0.35"); so.set("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 for multiple directories) they must be specified in the qtkrparse.php call, not in the QTVR file URL:

embedpano({swf:"krpano.swf", xml:"../mypath/qtkrparse.php?mov=my.mov", target:"krpano-div-id", html5:"auto"});
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.

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 (2x2, 4x4, 6x6,...)
v3.0: 2016-11-11: - Support of krpano HTML5 viewer (and hence for tablets und smartphones)
v3.0.1: 2016-12-11: - added krpano projections context menu (in krpano.inc)
v3.0.2: 2017-08-22: - PHP 7 compatibility

Examples / Debugging

All Sphericals on http://pano.erik-krause.de are displayed with the help of qtkrparse.php. 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.
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 (for 3x3 subtiles).

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

HTML-Converter

In order to use existing HTML pages with embedded QTVR without the need to create them again convert2.php is enclosed (originally from the Birdcap-package by Bernhard Vogl) 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">interactive panorama</a>

convert2.php replaces the <object> and <embed> Quicktime tag by an apprpropriate call of embedpano.

.htaccess example for qtkrparse

If your .htm files containing QTVR panoramas can be recognized with a certain pattern the work can be done by some rewrite rules.

# switch rewriting on RewriteEngine on # assuming your folder containing krpano, qtkrparse.php and convert2.php is /tools # redirect all calls to convert2.php into /tools RewriteRule (^|/)convert2\.php$ tools/convert2.php [L] # redirect all calls to qtkrparse.php into /tools RewriteRule (^|/)qtkrparse\.php(.*)$ tools/qtkrparse.php$2 [L] # redirect all calls to krpano into /tools RewriteRule (^|/)krpano\.(.*)$ tools/krpano.$2 [L] # assuming all of your htm files containing QTVR panoramas are named *_qt.htm # call convert2.php with the file name as parameter RewriteRule ^(.*)/([^./]+_qt)\.htm$ /$1/convert2.php?file=$2.htm [L]

download qtkrparse.zip

For questions, suggestions, comments and corrections please contact me

Erik Krause 2016