BlitzG15 - Logitech G15 LCD API for Blitz3D
-------------------------------------------

Die BlitzG15.dll erlaubt den Zugriff auf das Display der Logitech G15 Tastatur.
Bitte kopiere die BlitzG15.decls in Deinen Blitz3D/userlibs Ordner.


Core Funktionen
---------------

G15_Begin( titel$ )
	titel$ - Name der Anwendung, der im Display angezeigt wird
	
	Fgt das Programm in die Liste aller aktiven LCD-Programme ein.

G15_End( )
	Entfernt das Programm aus der Liste der LCD-Programme.

G15_Activate( )
	Bringt das Programm auf dem LCD in den Vordergrund.

G15_GetWidth( )
	Gibt die Breite des Displays zurck.

G15_GetHeight( )
	Gibt die Hhe des Displays zurck.

G15_Clear( )
	Lscht den Inhalt des Displays.

G15_Update( )
	Aktualisiert das Display und macht alle nderungen seit dem letzten
	Aufruf von G15_Update( ) sichtbar.

G15_SetPixel( x%, y%, value% )
	x% - x-Koordinate des Pixels
	y% - y-Koordinate des Pixels
	value% -  Neuer Wert fr den Pixel

	ndert die Sichtbarkeit eines Pixels auf dem Display. value% = 0 macht
	den Pixel unsichtbar, value% = 1 macht ihn sichtbar.

G15_SetPixelBank( bank% )
	bank% - Speicherbank in der Gre des Displays, die alle Pixelwerte enthlt

	Statt jeden Pixel einzeln mit G15_SetPixel( ) zu ndern,
	kann eine komplette Bank mit den Pixelwerten gesetzt werden.
	Die Pixel mssen mit PokeByte( ) gendert werden und die Werte
	0 ( unsichtbar ) oder 255 ( sichtbar ) enthalten.

G15_KeyDown( key% )
	key% - ID der zu prfenden Taste, muss ein Wert zwischen 1 und 4 sein
	
	Gibt 1 zurck, wenn die Taste gedrckt wird, ansonsten 0.


Grafik Funktionen
-----------------

G15_DrawText( text$, x%, y% )
	text$ - Zu zeichnender String
	x% - x-Koordinate der linken, oberen Ecke
	y% - y-Koordinate der linken, oberen Ecke
	
	Zeichnet Text an der angegebenen Position mit der zuletzt gesetzten
	Schriftart.

G15_DrawRect( x%, y%, width%, height% )
	Zeichnet ein Rechteck an der Position x%, y% mit der Breite width%
	und der Hhe height%.

G15_DrawOval( x%, y%, width%, height% )
	Zeichnet eine Ellipse an der Position x%, y% mit der Breite width%
	und der Hhe height%.

G15_DrawLine( x%, y%, x2%, y2% )
	Zeichnet eine Linie vom Punkt x%, y% bis zum Punkt x2%, y2%.

G15_LoadBitmap( filename$ )
	filename$ - Dateiname der Bitmap
	
	Ldt ein Bild ( .bmp-Format ) und gibt ein Handle zurck, 
	das fr G15_DrawImage( ) verwendet werden kann.

	Achtung: Weie Pixel in der Bitmap sind beim Zeichnen auf dem
	Display sichtbar ( = schwarz ), whrend schwarze Pixel unsichtbar sind.

G15_FreeBitmap( bitmap% )
	bitmap% - Handle eines Bildes, das mit G15_LoadBitmap( ) geladen wurde
	
	Lscht bitmap% aus dem Speicher.

G15_DrawBitmap( bitmap%, x%, y% )
	Zeichnet bitmap% an der Position x%, y%.

G15_LoadFont( name$, size%, bold%, italic%, underline% )
	name$ - Name der Schriftart ( z.B. "Arial ), muss im Windows Font-Ordner vorhanden sein
	size% - Hhe der Schriftart in Pixeln
	bold% - Fett ( True oder False )
	italic% - Kursiv ( True oder False )
	underline% - Unterstrichen ( True oder False )

	Ldt eine Schriftart und gibt ein Handle zurck, 
	das fr G15_SetFont( ) verwendet werden kann.

G15_FreeFont( font% )
	font% - Handle einer Schriftart, die mit G15_LoadFont( ) geladen wurde.
	
	Lscht font% aus dem Speicher.

G15_SetFont( font% )
	Setzt font% als aktuelle Schriftart fr G15_DrawText( ).

G15_SetColor( color% )
	Setzt die aktuelle Farbe ( = Sichtbarkeit der Pixel ) fr alle Zeichenoperationen.
	color% = 0 macht die Pixel unsichtbar, color% = 1 macht sie sichtbar.


Media Funktionen
----------------

G15_BeginMedia( )
	Startet die Abfrage der Medien-Tasten.
	Diese Funktion ist unabhngig von G15_Begin( ).

G15_EndMedia( )
	Beendet die Abfrage der Medien-Tasten.

G15_MediaKey( )
	Gibt die Nummer der zuletzt gedrckten Medien-Taste zurck.

	1 - Play / Pause
	2 - Stop
	3 - Next Track
	4 - Prev Track

	5 - Volume Up
	6 - Volume Down


Konfigurations Funktionen
-------------------------

G15_Configure( )
	Gibt True zurck, wenn im GamePanel Manager auf 'Konfigurieren' geklickt wurde.
	Dieser Wert sollte in jedem Schleifendurchlauf abgefragt werden.


Copyright
---------

Copyright  Christian Klaussner, 2007 - christiank.net

Ich bernehme keine Haftung fr Schden, die eventuell durch
die Nutzung dieser Software entstehen knnen.
