love.graphics (Deutsch)

Die Hauptaufgabe von love.graphics besteht darin Linien, Geometrische Formen, Texte, Bilder und andere Drawable-Objekte auf den Bildschirm zu zeichnen. Außerdem ist das Modul noch dafür zuständig externe Dateien (Images und Fonts) in den RAM zu laden und spezielle Objekte wie ein ParticleSystem oder einen Framebuffer zu erstellen.

Das Koordinatensystem von LÖVE hat seinen Ursprung oben-links im Fenster mit der Koordinate 0/0. Die x-Achse ist horizontal und verläuft nach links positiv. Die y-Achse ist vertikal und verläuft nach unten positiv.

Das Koordinatensystem von LÖVE

In den meisten Fällen wird die Position eines Bildes oder Form über die oben-linke Ecke bestimmt (Siehe obere Abbildung).

Viele Funktionen werden außerdem dazu benutzt das grafische Koordinatensystem zu manipulieren. So ist es möglich Positionen und Größen von Objekten zu verändern oder sogar deren Rotation zu beeinflussen.

Typen

Canvas (Deutsch) Ein Offscreen-Buffer welcher für das sogenannte "Off-screen Rendering" verwendet wird. Added since 0.8.0
Drawable (Deutsch) Die Superklasse für alle Dinge, die auf den Bildschirm gezeichnet werden können.
Font (Deutsch) Definiert das Aussehen von Charakteren welche auf den Bildschirm gezeichnet werden.
Framebuffer (Deutsch) Offscreen-Buffer. Added since 0.7.0 Removed in 0.8.0
Image (Deutsch) Ein Bild, welches gezeichnet werden kann.
Mesh (Deutsch) Ein zweidimensionales Polygonnetz zum Zeichnen von beliebig geformten Texturobjekten. Added since 0.9.0
ParticleSystem (Deutsch) Ein Partikelsystem zur Erzeugung von Effekten wie Feuer und Rauch.
Quad (Deutsch) Ein Viereck mit Texturkoordinaten.
Shader (Deutsch) Ein Shadereffekt zur Pixel- oder Vertexmanipulation. Added since 0.9.0
SpriteBatch (Deutsch) Speichert Bildpositionen in einem Buffer und zeichnet diese mit einem einzigen Funktionsaufruf.
Texture (Deutsch) Die Superklasse für alle zeichenbaren Objekte welche eine Textur repräsentieren. Added since 0.9.1

Funktionen

Zeichnen

love.graphics.arc (Deutsch) Zeichnet einen Bogen. Added since 0.8.0
love.graphics.circle (Deutsch) Zeichnet einen Kreis.
love.graphics.clear (Deutsch) Löscht den aktuellen Bildschirminhalt und füllt ihn mit der Hintergrundfarbe.
love.graphics.draw (Deutsch) Zeichnet Objekte auf den Bildschirm.
love.graphics.line (Deutsch) Zeichnet eine Linie zwischen zwei oder mehr Punkten.
love.graphics.point (Deutsch) Zeichnet einen Punkt.
love.graphics.polygon (Deutsch) Zeichnet ein Polygon. Added since 0.4.0
love.graphics.present (Deutsch) Zeigt das Ergebnis der bisherigen Zeichenoperationen auf dem Bildschirm.
love.graphics.print (Deutsch) Zeichnet einen Text auf den Bildschirm.
love.graphics.printf (Deutsch) Zeichnet formatierten Text mit Zeilenumbrüchen und Textausrichtung.
love.graphics.quad (Deutsch) Zeichnet eine quadratische Form. Removed in 0.9.0
love.graphics.rectangle (Deutsch) Zeichnet ein Rechteck. Added since 0.3.2
love.graphics.triangle (Deutsch) Zeichnet ein Dreieck. Removed in 0.9.0

Objekterstellung

love.graphics.newCanvas (Deutsch) Erstellt einen neuen Offscreen-Buffer. Added since 0.8.0
love.graphics.newFont (Deutsch) Erstellt ein neues Font Objekt.
love.graphics.newFramebuffer (Deutsch) Erstellt einen neuen Framebuffer. Added since 0.7.0 Removed in 0.8.0
love.graphics.newImage (Deutsch) Erstellt ein neues Bild.
love.graphics.newParticleSystem (Deutsch) Erstellt ein neues Partikelsystem.
love.graphics.newQuad (Deutsch) Erstellt ein neues Quad.
love.graphics.newSpriteBatch (Deutsch) Erstellt einen neuen SpriteBatch.

Status

love.graphics.getBackgroundColor (Deutsch) Gibt die derzeitige Hintergrundfarbe zurück.
love.graphics.getBlendMode (Deutsch) Gibt den Mischungsmodus für Transparente Objekte zurück. Added since 0.2.0
love.graphics.getMaxPointSize (Deutsch) Gibt die maximale Größe für Punkte zurück.
love.graphics.getPixelEffect (Deutsch) Gibt den aktuellen PixelEffect zurück. Added since 0.8.0 Removed in 0.9.0
love.graphics.getPointSize (Deutsch) Gibt die aktuelle Größe mit welche Punkte gezeichnet werden zurück.
love.graphics.getPointStyle (Deutsch) Gibt den aktuellen Stil in dem Punkte gezeichnet werden zurück.
love.graphics.getShader (Deutsch) Gibt den aktuellen Shader zurück. Added since 0.9.0
love.graphics.getSystemLimit (Deutsch) Gibt den systemabhängigen Maximalwert für bestimmte love-graphics Funktionen zurück. Added since 0.9.1
love.graphics.setBackgroundColor (Deutsch) Bestimmt die Hintergrundfarbe.
love.graphics.setCanvas (Deutsch) Bestimmt ein neues Renderziel. Added since 0.8.0
love.graphics.setLine (Deutsch) Bestimmt den Stil und die Breite mit der Linien gezeichnet werden. Removed in 0.9.0
love.graphics.setLineStyle (Deutsch) Bestimmt den Stil in dem Linien gezeichnet werden.
love.graphics.setLineWidth (Deutsch) Bestimmt die Breite mit der Linien gezeichnet werden sollen.
love.graphics.setPointSize (Deutsch) Bestimmt die Größe mit welcher Punkte gezeichnet werden.
love.graphics.setPointStyle (Deutsch) Bestimmt den Stil in dem Punkte gezeichnet werden sollen.

Koordinatensystem

Fenster

love.graphics.getDimensions (Deutsch) Gibt die Breite und Höhe des Fensters in Pixeln zurück. Added since 0.9.0
love.graphics.getHeight (Deutsch) Gibt die Höhe des Fensters in Pixeln zurück. Added since 0.2.1
love.graphics.getWidth (Deutsch) Gibt die Breite des Fensters in Pixeln zurück. Added since 0.2.1
love.graphics.toggleFullscreen (Deutsch) Schaltet zwischen Vollbild- und Fenstermodus um. Removed in 0.9.0

Enums

AlignMode (Deutsch) Bestimmt wie Text auf dem Bildschirm ausgerichtet werden soll.
BlendMode (Deutsch) Unterschiedliche Arten des Alpha-Blendings. Added since 0.2.0
DrawMode (Deutsch) Bestimmt ob nur die Umrisse einer Form gezeichnet, oder diese ausgefüllt werden soll.
FilterMode (Deutsch) Die Arten von Filtern welche beim Skalieren von Bildern verwendet werden können.
PointStyle (Deutsch) Bestimmt wie Punkte gezeichnet werden sollen.
SpriteBatchUsage (Deutsch) Nutzungshinweise für SpriteBatches. Added since 0.8.0


Siehe auch


Andere Sprachen