------------------------------------------------------------------------------------------

EasyPrinter - Drucken mit Blitz3D
Copyright  Christian Klaussner, 2008

------------------------------------------------------------------------------------------

EP_Initialize( )
	Initialisiert EasyPrinter und ermittelt Drucker-Informationen, die mit
	EP_PrinterCount und EP_PrinterName abgerufen werden knnen.
	Diese Funktion muss vor allen anderen EasyPrinter-Funktionen
	aufgerufen werden.
	
	Rckgabewert: 1, wenn erfolgreich, ansonsten 0.

EP_PrinterCount( )
	Ruft die Anzahl der installierten Drucker ab. Drucker knnen sowohl
	Hardware-Drucker, als auch virtuelle Drucker sein, die nur Dateien
	erzeugen.
	
	Rckgabewert: Anzahl der installierten Drucker.

EP_PrinterName( index )
	Ruft den Namen des Druckers mit dem angegebenen Index ab. Der Index
	kann ein Wert zwischen 0 und EP_PrinterCount( ) sein.
	
	Rckgabewert: String, der den Namen des Druckers enthlt.

EP_BeginPrint( index, document$, orientation, size, quality )
	Startet einen neuen Druckvorgang. Es kann immer nur ein Druckvorgang
	gleichzeitig ausgefhrt werden.
	
	index		- Gibt den Index des Druckers an, mit dem gedruckt werden soll.
	
	document$	- Muss den Namen des Dokumentes enthalten.
	
	orientation	- 1 fr Hochformat
			  2 fr Querformat
	
	size		- 1 fr A2
			  2 fr A3
			  3 fr A4
			  4 fr A5
	
	quality		- 1 fr Entwurf
			  2 fr Niedrig
			  3 fr Normal
			  4 fr Hoch
	
	Fr orientation, size und quality kann auch 0 bergeben werden. In diesem Fall
	werden Standardwerte verwendet.
	
	Rckgabewert: 1, wenn erfolgreich, ansonsten 0.

EP_EndPrint( )
	Beendet den Druckvorgang und schickt die Daten an den Drucker-Treiber.
	
	Rckgabewert: 1, wenn erfolgreich, ansonsten 0.

EP_BeginPage( )
	Beginnt eine neue Seite, auf die gedruckt werden kann.
	
	Rckgabewert: 1, wenn erfolgreich, ansonsten 0.

EP_EndPage( )
	Beendet die aktuelle Seite.
	
	Rckgabewert: 1, wenn erfolgreich, ansonsten 0.

EP_PageWidth( )
	Gibt die Breite einer Seite in Pixeln zurck. Diese Funktion muss nach
	EP_BeginPrint aufgerufen werden, da die Breite vom gewhlten Drucker
	und dem Format abhngig ist.
	
	Rckgabewert: Breite einer Seite in Pixeln.

EP_PageHeight( )
	Gibt die Hhe einer Seite in Pixeln zurck. Diese Funktion muss nach
	EP_BeginPrint aufgerufen werden, da die Hhe vom gewhlten Drucker
	und dem Format abhngig ist.
	
	Rckgabewert: Hhe einer Seite in Pixeln.

EP_LoadFont( name$, height, bold, italic, underline )
	Ldt eine Schriftart in den Speicher.
	
	name$		- Name der Schriftart
	
	height		- Hhe der Schriftart in Pixeln
	
	bold		- 1 fr eine fette Schrift, ansonsten 0
	
	italic		- 1 fr eine kursive Schrift, ansonsten 0
	
	underline	- 1 fr eine unterstrichene Schrift, ansonsten 0
	
	Rckgabewert: Handle der Schriftart, das bei EP_DrawText verwendet werden kann.

EP_FreeFont( font )
	Entfernt die Schriftart font aus dem Speicher.
	
	Rckgabewert: 1, wenn erfolgreich, ansonsten 0.

EP_TextColor( red, green, blue )
	Setzt die Zeichenfarbe fr alle nachfolgenden Aufrufe von EP_DrawText.
	Die Standardfarbe ist Schwarz ( 0, 0, 0 ).
	
	Rckgabewert: 1, wenn erfolgreich, ansonsten 0.

EP_DrawText( text$, x, y, font )
	Zeichnet den angegebenen Text an der Position x, y mit der Schriftart font.
	
	Rckgabewert: 1, wenn erfolgreich, ansonsten 0.

EP_DrawBuffer( buffer, x, y )
	Zeichnet den angegebenen Buffer an der Position x, y.
	Als Buffer kann ein beliebiger Blitz-Buffer angebenen werden ( ImageBuffer, 
	TextureBuffer, FrontBuffer, BackBuffer ).
	
	Rckgabewert: 1, wenn erfolgreich, ansonsten 0.

------------------------------------------------------------------------------------------

EasyPrinter ist Freeware und darf frei verbreitet werden, solange keine Datei des Pakets
verndert wird.

------------------------------------------------------------------------------------------