Wie bereits erwähnt, tauchte der Fehler völlig unregelmäßig auf und ließ sich nicht reproduzieren. In so einem Fall ist eine Fehlersuche nahezu unmöglich, da man den Code von Grund auf analysieren und überarbeiten müsste. Auch eine Suche über Google zu diesem Problem ergab keine hilfreichen Ergebnisse.

Nach mehreren gescheiterten Ansätzen, das Problem in der JavaScript-Datei zu suchen und zu beheben, stolperte ich auf die Vergabe der IDs, mit denen JavaScript die HTML-Objekte ansprechen und ein- und ausblenden kann. Diese Vergabe findet in der Datei tmenu_layers.php.inc statt und sieht (vereinfacht) so aus:

$this->WMid = substr(md5(microtime()),0,6);

Das bedeutet, dass für jedes Element eine ID aus der Micro-Time generiert wird und von dem Hash lediglich die ersten 6 Stellen als ID benutzt werden. Ich weiß nicht genau, ob es an der Kürze des Hashes oder an den Millisekunden als Grundlage lag, aber diese Vorgehensweise zur ID-Generierung erzeugte Kollisionen und vergab die IDs hin und wieder an mehrere HTML-Elemente gleichzeitig.

Um diese Kollisionen zu verhindern, änderte ich die ID-Vergabe um und nahm die PHP-Funktion uniqid() als Grundlage. Diese Funktion basiert zwar auch auf der aktuellen Micro-Time, lässt sich aber mit einen Parameter dazu bringen, die Rückgabe zusätzlich mit einem Zufallswert zu erweitern. Da dieser Zufallswert mit einem . angehängt wird, dies aber einen JavaScript-Fehler verursachen würde, habe ich anschließend noch alle Punkte aus der Rückgabe entfernt.

Die neue ID-Vergabe in der Datei tmenu_layers.php.inc sieht jetzt (vereinfacht) so aus:

$this->WMid = str_replace('.','',uniqid('',true));

Seit dieser Änderung ist der JavaScript-Fehler nicht mehr aufgetaucht. Ich gehe also davon aus, dass es die korrekte Lösung war.

Funktion beim Seitenwechsel automatisch aufrufen

Wenn von FPDF eine neue Seite erzeugt oder das Dokument geschlossen wird, wird automatisch die Funktion Footer() aufgerufen. Diese Funktion ist erstmal leer, da FPDF aber schön objektorientiert funktioniert, ist es kein Problem diese Funktion zu überschreiben und den eigenen Bedürfnissen anzupassen.

Anstatt FPDF direkt zu instanziieren, arbeiten wir also mit einer Unterklasse, die wir an unsere Bedürfnisse anpassen können.

<?php
// so wuerden wir eine Instanz von FPDF erzeugen
// $pdf = new FPDF();

// wir erzeugen aber eine eigene Klasse ...
class MyFPDF extends FPDF {

	function Footer() {
		// ... some stuff to do ...
	}
}

// ... um diese dann zu verwenden
$pdf = new MyFPDF();

?>

In dieser Footer()-Funktion können wir Text auf das PDF-Dokument schreiben.

function Footer() {
	$this->SetFont('Arial', 'B', 8);
	$this->Cell(0,10,'Seite A von B',0,0,'C');
}

Dynamische Seitenzahl

Die aktuelle Seitenzahl kann mit der Funktion PageNo() ausgelesen werden und für die Anzahl der Gesamtseiten verwenden wir den Platzhalter {nb} – dazu später mehr.

function Footer() {
	$this->SetFont('Arial', 'B', 8);
	$this->Cell(0,10,'Seite '.$this->PageNo().' von {nb}',0,0,'C');
}

Position der Anzeige

Als nächsten Schritt Positionieren wir die Anzeige auf der Seite dort, wo wir sie erwarten. Nämlich unten. Allerdings müssen wir dazu den Margin-Bereich auf 0 setzen, da wir mit FPDF eigentlich nicht außerhalb dieses Bereichs schreiben dürfen. Die fertige Footer()-Funktion sieht dann wie folgt aus:

function Footer() {
	$this->SetAutoPageBreak(true, 0); // set bottom margin to 0 mm
	$this->SetXY(10,277); // set position
	$this->SetFont('Arial', 'B', 7.98);
	$this->Cell(0,10,'Seite '.$this->PageNo().' von {nb}',0,0,'C');
	$this->SetAutoPageBreak(true, 20); // set bottom margin to 20 mm
}

Zunächst wir der Margin-Bereich auf 0 gesetzt. Dann die Position für das Textfeld bestimmt, anschließend die Schriftart, -schnitt und -größe. Daraufhin wird das Textfeld mit Inhalt und einigen weiteren Parametern erzeugt. Und zum Schluss wird der Margin-Bereich wieder zurück gesetzt.

Update

Die Manipulation mit dem Margin-Bereich ist nicht nötig, wenn die Aktion in der Funktion Footer() erfolgt. Von dieser Funktion aus kann auch unterhalb des Bottom-Margins geschrieben werden.

Gesamt-Anzahl der Seiten anzeigen

Bis jetzt steht in der Ausgabe noch immer der Platzhalter {nb} anstatt der Gesamtzahl der Seiten. Um diesen Alias zu ersetzen muss die Funktion AliasNbPages([string alias]) aufgerufen werden. Über den optionalen Parameter kann dabei der Name des Platzhalters definiert werden. Bleibt der Parameter leer, wird automatisch {nb} verwendet.

Hier also der Komplette Code:

<?php
// wir erzeugen eine eigene Klasse ...
class MyFPDF extends FPDF {

	function Footer() {
		$this->SetAutoPageBreak(true, 0); // set bottom margin to 0 mm
		$this->SetXY(10,277); // set position
		$this->SetFont('Arial', 'B', 7.98);
		$this->Cell(0,10,'Seite '.$this->PageNo().' von {nb}',0,0,'C');
		$this->SetAutoPageBreak(true, 20); // set bottom margin to 20 mm
	}
}

// ... um diese dann zu verwenden
$pdf = new MyFPDF();
$pdf->AliasNbPages();

?>

Weitere Informationen zu FPDF und den jeweiligen Funktionen gibt es auf der offiziellen Webseite: www.fpdf.org

Zunächst werden die Bilddaten in ein BitmapData-Object gezeichnet, welches den Abmessungen des Screenshots entspricht. Adobe hat mit seinen Klassen JPGEncoder und PNGEncoder zwei Klassen bereitgestellt, welche die Umrechnung in die jeweiligen Formate erledigt. Dazu übergibt man der encode()-Methode der jeweiligen Klasse das erstellte BitmapData-Objekt als Parameter und bekommt als Rückgabewert einen ByteArray.

Der nächste Schritt, um den ByteArray zu einem Bild zu wandeln, ist die Kodierung des ByteArrays als String, um diesen an PHP als POST-Daten senden zu können. Mit Hilfe der Klasse Base64 as dem Package com.dynamicflash.util wird der erstellte ByteArray in einen solchen String gewandelt. Das ganze geschieht mit der encodeByteArray-Methode, welche als Parameter eben diesen ByteArray bekommt und den dazu passenden String zurück liefert.

Als letzten Schritt dieser Prozedur wird nun der erstellte Bilddaten-String mittels PHP gesichert. Dazu wird ein neuer URLRequest erstellt welcher als method POST bekommt. Des weiteren ist eine URLVariable nötig, welche das Format (JPG, PNG), die Action (Load, Save, open in Browser), den Dateinamen sowie den Bilddaten-String enthält. Diese wird dem URLRequest zugewiesen. Sollte das Bild wieder in Flash geladen werden, ist hier ein Loader nötig, andernfalls reicht ein einfaches navigateToURL(urlRequest, ‘_blank’) um das Bild zu sichern oder in einen Browser zu laden.

Mit dieser Möglichkeit kann man direkt verschiedene Ansichten, Videos oder Animationen aus Flash heraus sichern. Einfache Grafikprogramme auf Flashbasis wären so möglich, aber auch Spiele in denen der User zu jedem beliebigen Zeitpunkt einen Screenshot der Szene machen kann. Auch kann das Bild wiederum über z.B. eine Matrix transformiert oder darauf verschiedenste Filter angewendet werden.