LÖVE 0.10.2 Reference

Die Quelle, welche pausiert werden soll.

love.audio.play

Spielt eine Quelle ab.

love.audio.play( source )

source

Die Quelle, welche abgespielt werden soll.

love.audio.resume

Setzt alle Audiodaten fort.

love.audio.resume()

love.audio.resume( source )

source

Die Quelle, die fortgesetzt werden soll.

love.audio.rewind

Spult alle Audiodaten zurück.

love.audio.rewind()

love.audio.rewind( source )

source

love.audio.setDistanceModel

Die Quelle, die zurückgespult werden soll.

Setzt das Abstandsdämpfungsmodell.

love.audio.setDistanceModel( model )

model

DistanceModel

Das neue Distanzmodell.

love.audio.setDopplerScale

Setzt einen globalen Skalenfaktor für geschwindigkeitsabhängige Doppler-Effekte. Der Standard-Skalenwert ist 1.

love.audio.setDopplerScale( scale )

scale

number

Der neue Doppler-Skalenfaktor. Die Waage muss größer als 0 sein.

love.audio.setOrientation

Stellt die Ausrichtung des Zuhörers ein.

love.audio.setOrientation( fx, fy, fz, ux, uy, uz )

fx	number	Die X-Komponente des Vorwärtsvektors der Listenerorientierung.
fy	number	Die Y-Komponente des Vorwärtsvektors der Hörerorientierung.
fz	number	Die Z-Komponente des Vorwärtsvektors der Hörerorientierung.
ux	number	Die X-Komponente des up-Vektors der Listener-Orientierung.
uy	number	Die Y-Komponente des Up-Vektors der Hörerorientierung.
uz	number	Die Z-Komponente des up-Vektors der Hörerorientierung.

love.audio.setPosition

Setzt die Position des Zuhörers, die bestimmt, wie Klänge spielen.

love.audio.setPosition( x, y, z )

x	number	Die X-Position des Zuhörers.
y	number	Die Y-Position des Zuhörers.
z	number	Die Z-Position des Zuhörers.

love.audio.setVelocity

Stellt die Geschwindigkeit des Zuhörers ein.

love.audio.setVelocity( x, y, z )

x	number	Die X-Geschwindigkeit des Zuhörers.
y	number	Die Y-Geschwindigkeit des Zuhörers.
z	number	Die Z-Geschwindigkeit des Zuhörers.

love.audio.setVolume

Bestimmt die Gesamtlautstärke.

love.audio.setVolume( volume )

volume

number

1.0 ist der Maximal- und 0.0 der Minimalwert.

love.audio.stop

Stoppt abgespielte Quellen.

love.audio.stop()

Diese Funktion stoppt alle aktiven Quellen.

love.audio.stop( source )

Diese Funktion stoppt eine bestimmte Quelle.

source

Die Quelle, welche gestoppt werden soll.

DistanceModel

none

Quellen werden nicht gedämpft

inverse

Inverse Distanzdämpfung

inverseclamped

Inverse Distanzdämpfung Gewinn wird geklemmt In Version 0.9.2 und älter heißt das invers geklemmt.

linear

Lineare Dämpfung.

linearclamped

Lineare Dämpfung. Gewinn wird geklemmt In Version 0.9.2 und älter wird dies als linear geklemmt bezeichnet.

exponent

Exponentielle Dämpfung.

exponentclamped

Exponentielle Dämpfung. Gewinn wird geklemmt In Version 0.9.2 und älter heißt das Exponent geklemmt.

SourceType

static

Die komplette Quelle wird auf einmal dekodiert.

stream

Die Quelle wird schrittweise während des Abspielens dekodiert.

TimeUnit

seconds

Reguläre Sekunden.

samples

Audio Samples.

Eine Geräuschquelle (engl.: Source) stellt einen Ton dar, welcher abgespielt und bearbeitet werden kann.

Es lassen sich interessante Dinge mit Geräuschquellen anstellen. So kann zum Beispiel die Lautstärke, die Tonhöhe oder die Position des Tons in der Spielewelt verändert werden.

Der Zustand einer Quelle kann wie folgt kontrolliert werden.

Constructors

love.audio.newSource Erstellt aus einer Datei eine neue Source, entweder SoundData oder Decoder.

Functions

Source:play Spielt eine Quelle ab.

Source:stop Stoppt eine Quelle.

Source:pause Pausiert die Quelle.

Source:resume Setzt eine angehaltene Quelle fort.

Source:rewind Zurückspulen einer Quelle.

Source:tell/seek Legt die Spielposition der Quelle fest.

Source:is/setLooping Bestimmt ob sich die Quelle wiederholen soll.

Source:get/setPitch Setzt die Tonhöhe der Quelle.

Source:get/setVolume Stellt die Lautstärke der Quelle ein.

Source:isPlaying Ermittelt, ob die Quelle spielt.

Source:isStopped Gibt zurück, ob die Quelle gestoppt ist.

Source:isPaused Gibt zurück, ob die Quelle pausiert ist.

Source:get/setPosition Setzt die Position der Quelle.

Source:get/setDirection Setzt den Richtungsvektor der Quelle.

Source:get/setRolloff Setzt den Rolloff-Faktor, der die Stärke der verwendeten Distanzdämpfung beeinflusst.

Source:get/setVelocity Setzt die Geschwindigkeit der Quelle.

Source:get/setCone Setzt die Richtungs-Zapfen der Quelle.

Source:get/setAttenuationDistances Setzt die Referenz und den maximalen Abstand der Quelle.

Source:get/setVolumeLimits Legt die Lautstärke der Quelle fest.

Source:getType Ruft den Typ (statisch oder stream) der Quelle ab.

Source:getChannels Ruft die Anzahl der Kanäle in der Quelle ab.

Source:getDuration Ruft die Dauer der Quelle auf.

Source:clone Erstellt eine identische Kopie einer Geräuschquelle.

Supertypes

Object Die Superklasse aller LÖVE-Typen.

Source:clone

Erstellt eine identische Kopie einer Geräuschquelle.

source = Source:clone()

source

Source:getAttenuationDistances

Die neue identische Kopie dieser Quelle.

Ruft die Referenz und den maximalen Abstand der Quelle ab.

ref, max = Source:getAttenuationDistances()

ref	number	Der Referenzabstand.
max	number	Die maximale Entfernung.

Source:getChannels

Ruft die Anzahl der Kanäle in der Quelle ab. Nur 1-Kanal (Mono) Quellen können Richtungs- und Positionseffekte verwenden.

channels = Source:getChannels()

channels

number

1 für mono, 2 für stereo.

Source:getCone

Erhält die Richtungs-Zapfen der Quelle. Zusammen mit Source: setDirection erlauben die Kegelwinkel, dass das Quellvolumen je nach seiner Richtung variiert.

innerAngle, outerAngle, outerVolume = Source:getCone()

innerAngle	number	Der innere Winkel aus der Richtung der Quelle, im Bogenmaß. Die Quelle wird bei normaler Lautstärke abgespielt, wenn der Zuhörer sich innerhalb des durch diesen Winkel definierten Kegels befindet.
outerAngle	number	Der äußere Winkel aus der Richtung der Quelle, im Bogenmaß. Die Quelle wird bei einem Volumen zwischen den normalen und äußeren Volumina spielen, wenn der Zuhörer zwischen den Kegeln zwischen den inneren und äußeren Winkeln liegt.
outerVolume	number	Das Volumen der Quelle, wenn der Zuhörer außerhalb des inneren und äußeren Kegelwinkels liegt.

Source:getDirection

Gibt die Richtung der Quelle zurück.

x, y, z = Source:getDirection()

x	number	Der X-Wer des Richtungsvektors.
y	number	Der Y-Wer des Richtungsvektors.
z	number	Der Z-Wer des Richtungsvektors.

Source:getDuration

Ruft die Dauer der Quelle auf. Für Streaming-Quellen kann es nicht immer Stichprobengenau sein und kann -1 zurückgeben, wenn die Dauer überhaupt nicht bestimmt werden kann.

duration = Source:getDuration( unit )

duration	number	Die Dauer der Quelle oder -1, wenn sie nicht bestimmt werden kann.
unit ("seconds")	TimeUnit	Die Zeiteinheit für den Rückgabewert.

Source:getPitch

Gibt die aktuelle Tonhöhe der Quelle zurück.

pitch = Source:getPitch()

pitch

number

Die Tonhöhe, wobei 1.0 normal ist.

Source:getPosition

Ruft die Position der Quelle ab.

x, y, z = Source:getPosition()

x	number	Die X-Position der Quelle.
y	number	Die Y-Position der Quelle.
z	number	Die Z-Position der Quelle.

Source:getRolloff

Ruft den Rolloff-Faktor der Quelle ab.

rolloff = Source:getRolloff()

rolloff

number

Der Rolloff-Faktor.

Source:getType

Ruft den Typ (statisch oder stream) der Quelle ab.

sourcetype = Source:getType()

sourcetype

SourceType

Der Typ der Quelle.

Source:getVelocity

Erreicht die Geschwindigkeit der Quelle.

x, y, z = Source:getVelocity()

x	number	Der X-Teil des Geschwindigkeitsvektors
y	number	Der Y-Teil des Geschwindigkeitsvektors.
z	number	Der Z-Teil des Geschwindigkeitsvektors

Source:getVolume

Ruft das aktuelle Volumen der Quelle ab.

volume = Source:getVolume()

volume

number

Das Volumen der Quelle, wobei 1,0 normales Volumen ist.

Source:getVolumeLimits

Ruft die Lautstärke der Quelle ab.

min, max = Source:getVolumeLimits()

min	number	Die minimale Lautstärke.
max	number	Die maximale Lautstärke.

Source:isLooping

Gibt zurück, ob die Quelle sich wiederholt.

loop = Source:isLooping()

loop

boolean

Wahr, wenn die Quelle Schleife, falsch anders.

Source:isPaused

Gibt zurück, ob die Quelle pausiert ist.

paused = Source:isPaused()

paused

boolean

Wahr, wenn die Quelle pausiert ist, falsch anders.

Source:isPlaying

Ermittelt, ob die Quelle spielt.

playing = Source:isPlaying()

playing

boolean

Wahr, wenn die Quelle spielt, falsch anders.

Source:isStopped

Gibt zurück, ob die Quelle gestoppt ist.

stopped = Source:isStopped()

stopped

boolean

Wahr, wenn die Quelle gestoppt ist.

Source:pause

Pausiert die Quelle.

Source:pause()

Source:play

Spielt eine Quelle ab.

success = Source:play()

success

boolean

Wahr wenn die Quelle erfolgreich abgespielt werden konnte.

Source:resume

Setzt eine angehaltene Quelle fort.

Source:resume()

Source:rewind

Zurückspulen einer Quelle.

Source:rewind()

Source:seek

Legt die Spielposition der Quelle fest.

Source:seek( position, unit )

position	number	Die Position zu suchen.
unit ("seconds")	TimeUnit	Die Einheit des Positionswertes.

Source:setDirection

Setzt den Richtungsvektor der Quelle. Ein Nullvektor macht die Quelle ungerichtet.

Source:setDirection( x, y, z )

x	number	Der X-Teil des Richtungsvektors
y	number	Der Y-Teil des Richtungsvektors
z	number	Der Z-Teil des Richtungsvektors

Source:setAttenuationDistances

Setzt die Referenz und den maximalen Abstand der Quelle.

Source:setAttenuationDistances( ref, max )

ref	number	Der neue Referenzabstand.
max	number	Die neue maximale Entfernung.

Source:setCone

Setzt die Richtungs-Zapfen der Quelle. Zusammen mit Source: setDirection erlauben die Kegelwinkel, dass das Quellvolumen je nach seiner Richtung variiert.

Source:setCone( innerAngle, outerAngle, outerVolume )

innerAngle	number	Der innere Winkel aus der Richtung der Quelle, im Bogenmaß. Die Quelle wird bei normaler Lautstärke abgespielt, wenn der Zuhörer sich innerhalb des durch diesen Winkel definierten Kegels befindet.
outerAngle	number	Der äußere Winkel aus der Richtung der Quelle, im Bogenmaß. Die Quelle wird bei einem Volumen zwischen den normalen und äußeren Volumina spielen, wenn der Zuhörer zwischen den Kegeln zwischen den inneren und äußeren Winkeln liegt.
outerVolume (0)	number	Das Volumen der Quelle, wenn der Zuhörer außerhalb des inneren und äußeren Kegelwinkels liegt.

Source:setLooping

Bestimmt ob sich die Quelle wiederholen soll.

Source:setLooping( loop )

loop

boolean

True wenn sich die Quelle wiederholen soll, false wenn nicht.

Source:setPitch

Setzt die Tonhöhe der Quelle.

Source:setPitch( pitch )

pitch

number

Berechnet in Bezug auf 1 ist die Grundtonhöhe. Jede Reduktion um 50 Prozent entspricht einer Tonhöhenverschiebung von -12 Halbtönen (eine Oktavreduktion). Jede Verdopplung entspricht einer Tonhöhenverschiebung von 12 Halbtönen (eine Oktavzunahme). Null ist kein gesetzlicher Wert.

Source:setPosition

Setzt die Position der Quelle.

Source:setPosition( x, y, z )

x	number	Die X-Position der Quelle.
y	number	Die Y-Position der Quelle.
z	number	Die Z-Position der Quelle.

Source:setRolloff

Setzt den Rolloff-Faktor, der die Stärke der verwendeten Distanzdämpfung beeinflusst.

Weitere Informationen und detaillierte Formeln finden Sie im Kapitel "3.4. Dämpfung nach Entfernung" der OpenAL 1.1 Spezifikation.

Source:setRolloff( rolloff )

rolloff

number

Der neue Rolloff-Faktor.

Source:setVelocity

Setzt die Geschwindigkeit der Quelle.

Dies ändert nicht die Position der Quelle, sondern wird verwendet, um den Doppler-Effekt zu berechnen.

Source:setVelocity( x, y, z )

x	number	Der X-Teil des Geschwindigkeitsvektors
y	number	Der Y-Teil des Geschwindigkeitsvektors.
z	number	Der Z-Teil des Geschwindigkeitsvektors

Source:setVolume

Stellt die Lautstärke der Quelle ein.

Source:setVolume( volume )

volume

number

Die Lautstärke der Quelle, wobei 1.0 die standart Lautstärke ist.

Source:setVolumeLimits

Legt die Lautstärke der Quelle fest. Die Grenzen müssen Zahlen von 0 bis 1 sein.

Source:setVolumeLimits( min, max )

min	number	Die minimale Lautstärke.
max	number	Die maximale Lautstärke.

Source:stop

Stoppt eine Quelle.

Source:stop()

Source:tell

Ruft die aktuell abgespielte Position der Quelle ab.

position = Source:tell( unit )

position	number	Die aktuell laufende Position der Quelle.
unit ("seconds")	TimeUnit	Die Art der Einheit für den Rückgabewert.

love.event

Functions

love.event.clear Leert die Ereigniswarteschleife.

love.event.poll Gibt einen Iterator für Nachrichten in der Ereigniswarteschleife wider.

love.event.pump Fügt Events in die Ereigniswarteschleife ein.

love.event.push Fügt ein Ereignis der Ereignis-Warteschleife hinzu.

love.event.quit Fügt das Warteschlange-Ereignis zur Warteschlange hinzu.

love.event.wait Wie love.event.poll, blockiert allerdings alles, bis ein Element in der Ereigniswarteschleife ist.

Enums

Event Mögliche Argumente für love.event.push und dergleichen.

love.event.clear

Leert die Ereigniswarteschleife.

love.event.clear()

love.event.poll

Gibt einen Iterator für Nachrichten in der Ereigniswarteschleife wider.

i = love.event.poll()

function

Iteratorfunktion, welche in einer Schleife benutzt werden kann.

love.event.pump

Fügt Events in die Ereigniswarteschleife ein.

love.event.pump ist eine "lowlevel"-Funktion und wird normalerweise nicht explizit durch den Nutzer, sondern von love.run aufgerufen.

love.event.pump()

love.event.push

Fügt ein Ereignis der Ereignis-Warteschleife hinzu.

love.event.push( e, a, b, c, d )

e	Event	Der Name der Veranstaltung.
a (nil)	Variant	Erstes Ereignisargument
b (nil)	Variant	Zweites Ereignisargument
c (nil)	Variant	Drittes Ereignisargument
d (nil)	Variant	Viertes Ereignisargument

love.event.quit

Fügt das Warteschlange-Ereignis zur Warteschlange hinzu.

Das Quit-Event ist ein Signal für den Event-Handler, um LÖVE zu schließen. Es ist möglich, den Ausstieg mit dem love.quit Rückruf abzubrechen.

love.event.quit()

love.event.quit( exitstatus )

exitstatus (0)

number

Der Programm-Exit-Status, der beim Schließen der Anwendung verwendet werden soll.

love.event.quit( "restart" )

"restart"

string

Startet das Spiel neu, ohne die ausführbare Datei neu zu starten. Das schaltet die Haupt-Lua-Staats-Instanz sauber ab und schafft eine neue.

love.event.wait

Wie love.event.poll, blockiert allerdings alles, bis ein Element in der Ereigniswarteschleife ist.

e, a, b, c, d = love.event.wait()

e	Event	Die Art des Ereignisses.
a	Variant	Erstes Ereignisargument
b	Variant	Zweites Ereignisargument
c	Variant	Drittes Ereignisargument
d	Variant	Viertes Ereignisargument

Event

focus

Fensterfokus gewonnen oder verloren

joystickaxis

Joystick-Achsbewegung

joystickhat

Joystick Hut gedrückt

joystickpressed

Joystick gedrückt

joystickreleased

Joystick veröffentlicht

keypressed

Taste gedrückt

keyreleased

Schlüssel freigegeben

mousefocus

Fenster Mausfokus gewonnen oder verloren

mousepressed

Maus gedrückt

mousereleased

Maus freigegeben

resize

Fenstergröße durch den Benutzer geändert

threaderror

Ein Lua-Fehler ist in einem Thread aufgetreten.

quit

Verlassen

visible

Das Fenster wird vom Benutzer minimiert oder nicht minimiert

love.filesystem

Types

File Repräsentiert eine Datei im Dateisystem.

FileData Ein Datum welches den Inhalt einer Datei repräsentiert.

Functions

love.filesystem.append Hängt ein Datum an eine bereits existierende Datei an.

love.filesystem.createDirectory Erstellt einen neuen Ordner.

love.filesystem.exists Überprüft ob eine Datei oder ein Verzeichnis existiert.

love.filesystem.getAppdataDirectory Ruft das Anwendungsdatenverzeichnis ab (könnte das gleiche wie getUserDirectory sein)

love.filesystem.getDirectoryItems Ruft eine Tabelle mit den Namen der Dateien und Unterverzeichnisse im angegebenen Pfad ab.

love.filesystem.getLastModified Ruft die letzte Änderungszeit einer Datei ab.

love.filesystem.getRealDirectory Ruft den plattformspezifischen absoluten Pfad des Verzeichnisses mit einem Dateipfad ab.

love.filesystem.getSaveDirectory Ruft den vollständigen Pfad zum designierten Speicherverzeichnis ab.

love.filesystem.getSize Ruft die Größe in Bytes einer Datei ab.

love.filesystem.getSourceBaseDirectory Ruft den vollständigen Pfad zu dem Verzeichnis ab, das die .love-Datei enthält.

love.filesystem.getUserDirectory Ruft den Pfad des Benutzerverzeichnisses ab.

love.filesystem.getWorkingDirectory Ruft das aktuelle Arbeitsverzeichnis ab.

love.filesystem.init Initialisiert love.filesystem, wird intern genannt, also sollte nicht explizit verwendet werden.

love.filesystem.isDirectory Gibt zurück ob etwas ein Ordner ist.

love.filesystem.isFile Gibt zurück ob etwas eine Datei ist.

love.filesystem.isFused Ermittelt, ob das Spiel im Fused-Modus ist oder nicht.

love.filesystem.isSymlink Ermittelt, ob ein Dateipfad eigentlich eine symbolische Verknüpfung ist.

love.filesystem.lines Iterate über die Zeilen in einer Datei.

love.filesystem.load Lädt eine Lua-Datei (läuft aber nicht).

love.filesystem.mount Bereitet eine Zip-Datei oder einen Ordner in das Spiel-Verzeichnis des Spiels zum Lesen.

love.filesystem.read Lesen Sie den Inhalt einer Datei.

love.filesystem.remove Entfernt eine Datei oder ein Verzeichnis.

love.filesystem.get/setIdentity Bestimmt das Schreib-Verzeichnis für das jeweilige Spiel.

love.filesystem.get/setRequirePath Legt die Dateisystempfade fest, die bei Bedarf aufgerufen werden.

love.filesystem.get/setSource Setzt die Quelle des Spiels, wo der Code vorhanden ist.

love.filesystem.are/setSymlinksEnabled Legt fest, ob love.filesystem den symbolischen Links folgt.

love.filesystem.unmount Entfernt eine Zip-Datei oder einen Ordner, der zuvor für das Lesen mit love.filesystem.mount installiert wurde.

love.filesystem.write Schreibt Daten in eine Datei im Speicherordner.

Enums

BufferMode Puffermodi für Dateiobjekte.

FileDecoder Wie man eine gegebene FileData decodiert.

FileMode Die verschiedenen Modi mit welchen eine Datei geöffnet werden kann.

love.filesystem.append

Hängt ein Datum an eine bereits existierende Datei an.

success, errormsg = love.filesystem.append( name, data, size )

success	boolean	Wahr, wenn die Operation erfolgreich war. Falsch, wenn nicht.
errormsg	string	Eine Fehlernachricht, falls ein Fehler aufgetreten ist.
name	string	Der Name (und Pfad) der Datei.
data	string	Das Datum in Form eines String welches an die Datei angehängt werden soll.
size (all)	number	Wieviele Bytes geschrieben werden sollen.

love.filesystem.areSymlinksEnabled

Ruft, ob love.filesystem symbolische Links folgt.

enable = love.filesystem.areSymlinksEnabled()

enable

boolean

Ob love.filesystem folgt symbolischen Links.

love.filesystem.createDirectory

Erstellt einen neuen Ordner.

Wenn ein Pfad an die Funktion übergeben wird (z.B.: "ordner1/ordner2"), werden beide Ordner erstellt falls sie noch nicht existieren.

success = love.filesystem.createDirectory( name )

success	boolean	Wahr, wenn der Ordner erstellt wurde. Falsch, wenn nicht.
name	string	Der Ordner welcher erstellt werden soll.

love.filesystem.exists

Überprüft ob eine Datei oder ein Verzeichnis existiert.

exists = love.filesystem.exists( filename )

exists	boolean	Wahr wenn die Datei oder der Ordner existiert.
filename	string	Der Pfad der Datei welche, bzw. des Ordners welcher überprüft werden soll.

love.filesystem.getAppdataDirectory

Ruft das Anwendungsdatenverzeichnis ab (könnte das gleiche wie getUserDirectory sein)

path = love.filesystem.getAppdataDirectory()

path

string

Der Pfad des Anwendungsdatenverzeichnisses.

love.filesystem.getDirectoryItems

Ruft eine Tabelle mit den Namen der Dateien und Unterverzeichnisse im angegebenen Pfad ab. Der Tisch ist nicht in irgendeiner Weise sortiert; die Bestellung ist undefiniert.

Wenn der Pfad, der an die Funktion übergeben wird, im Spiel und im Sicherungsverzeichnis existiert, werden die Dateien und Verzeichnisse von beiden Orten aufgelistet.

items = love.filesystem.getDirectoryItems( dir )

items	table	Eine Sequenz mit den Namen aller Dateien und Unterverzeichnisse als Strings.
dir	string	Das Verzeichnis.

love.filesystem.getIdentity

Gibt das Schreib-Verzeichnis des Spiels zurück.

Hierbei wird nur der Name des Ordners, aber nicht der gesamte Pfad zurückgegeben.

love.filesystem.getIdentity( name )

name

string

Die Identität, die als Schreibverzeichnis verwendet wird.

love.filesystem.getLastModified

Ruft die letzte Änderungszeit einer Datei ab.

modtime, errormsg = love.filesystem.getLastModified( filename )

modtime	number	Die letzte Änderungszeit in Sekunden seit der Unix-Epoche oder Nil bei Ausfall.
errormsg	string	Die Fehlermeldung beim Ausfall
filename	string	Der Pfad und der Name einer Datei.

love.filesystem.getRealDirectory

Ruft den plattformspezifischen absoluten Pfad des Verzeichnisses mit einem Dateipfad ab.

Dies kann verwendet werden, um festzustellen, ob sich eine Datei im Speicherverzeichnis befindet oder die Quelle des Spiels .love.

realdir = love.filesystem.getRealDirectory( filepath )

realdir	string	Der plattformspezifische Vollpfad des Verzeichnisses mit dem Dateipfad.
filepath	string	Der Dateipfad, um das Verzeichnis zu erhalten.

love.filesystem.getRequirePath

Ruft die Dateisystempfade ab, die bei Bedarf aufgerufen werden.

Die von dieser Funktion zurückgegebene Pfadfolge ist eine Folge von Pfadvorlagen, die durch Semikolons getrennt sind. Das anforderte Argument wird anstelle eines beliebigen Fragezeichen-Zeichens ("?") In jeder Vorlage eingefügt (nachdem die Punktzeichen im Argument, die an das Erfordernis übergeben wurden, durch Verzeichnistrennzeichen ersetzt werden).

Die Pfade sind relativ zu der Quelle des Spiels und speichern Verzeichnisse, sowie alle Pfade mit love.filesystem.mount montiert.

paths = love.filesystem.getRequirePath()

paths

string

Die Pfade, die die Erforderungsfunktion im Liebes-Dateisystem überprüfen wird.

love.filesystem.getSaveDirectory

Ruft den vollständigen Pfad zum designierten Speicherverzeichnis ab. Dies kann nützlich sein, wenn Sie die Standard-io-Bibliothek (oder etwas anderes) zum Lesen oder Schreiben im Speicherverzeichnis verwenden möchten.

path = love.filesystem.getSaveDirectory()

path

string

Der absolute Pfad zum Speicherverzeichnis.

love.filesystem.getSize

Ruft die Größe in Bytes einer Datei ab.

size, errormsg = love.filesystem.getSize( filename )

size	number	Die Größe in Bytes der Datei oder nil beim Ausfall.
errormsg	string	Die Fehlermeldung beim Ausfall
filename	string	Der Pfad und der Name einer Datei.

love.filesystem.getSource

Ruft den vollständigen Pfad zu der .love-Datei oder dem Verzeichnis ab. Wenn das Spiel mit der ausführbaren Datei von LÖVE verschmolzen ist, wird die ausführbare Datei zurückgegeben.

path = love.filesystem.getSource()

path

string

Der vollständige plattformabhängige Pfad der .love Datei oder des Verzeichnisses.

love.filesystem.getSourceBaseDirectory

Ruft den vollständigen Pfad zu dem Verzeichnis ab, das die .love-Datei enthält. Wenn das Spiel mit der ausführbaren Datei von LÖVE verschmolzen ist, wird das Verzeichnis mit der ausführbaren Datei zurückgegeben.

Wenn love.filesystem.isFused wahr ist, kann der von dieser Funktion zurückgegebene Pfad an love.filesystem.mount übergeben werden, der das Verzeichnis mit dem von love.filesystem lesbaren Hauptspiel verknüpft.

path = love.filesystem.getSourceBaseDirectory()

path

string

Der vollständige plattformabhängige Pfad des Verzeichnisses mit der .love-Datei.

love.filesystem.getUserDirectory

Ruft den Pfad des Benutzerverzeichnisses ab.

path = love.filesystem.getUserDirectory()

path

string

Der Pfad des Benutzer-Verzeichnisses.

love.filesystem.getWorkingDirectory

Ruft das aktuelle Arbeitsverzeichnis ab.

path = love.filesystem.getWorkingDirectory()

path

string

Das aktuelle Arbeitsverzeichnis.

love.filesystem.init

Initialisiert love.filesystem, wird intern genannt, also sollte nicht explizit verwendet werden.

love.filesystem.init( appname )

appname

string

Der Name der Anwendung binär, in der Regel lieben.

love.filesystem.isDirectory

Gibt zurück ob etwas ein Ordner ist.

isDir = love.filesystem.isDirectory( path )

isDir	boolean	Wahr wenn ein Ordner mit dem angegebenen Namen existiert. Falsch, wenn nicht.
path	string	Der Pfad zu einem potenziellen Ordner.

love.filesystem.isFile

Gibt zurück ob etwas eine Datei ist.

isFile = love.filesystem.isFile( path )

isFile	boolean	Wahr, wenn eine Datei mit dem angegebenen Namen existiert. Falsch, wenn nicht.
path	string	Der Pfad zu einer potenziellen Datei.

love.filesystem.isFused

Ermittelt, ob das Spiel im Fused-Modus ist oder nicht.

Wenn sich ein Spiel im Fused-Modus befindet, befindet sich sein Speicherverzeichnis direkt im Appdata-Verzeichnis anstelle von Appdata / LOVE /. Das Spiel wird auch in der Lage sein, C Lua dynamische Bibliotheken zu laden, die sich im Speicherverzeichnis befinden.

Ein Spiel ist im verschmolzenen Modus, wenn die Quelle .love mit der ausführbaren Datei verschmolzen wurde (siehe Game Distribution), oder wenn "- fused" als Befehlszeilenargument beim Start des Spiels angegeben wurde.

fused = love.filesystem.isFused()

fused

boolean

True, wenn das Spiel im Fused-Modus ist, false anders.

love.filesystem.isSymlink

Ermittelt, ob ein Dateipfad eigentlich eine symbolische Verknüpfung ist.

Wenn symbolische Links nicht aktiviert sind (über love.filesystem.setSymlinksEnabled), wird diese Funktion immer false zurückgeben.

symlink = love.filesystem.isSymlink( path )

symlink	boolean	True, wenn der Pfad eine symbolische Verknüpfung ist, sonst false.
path	string	Die Datei oder den Verzeichnispfad zu überprüfen.

love.filesystem.lines

Iterate über die Zeilen in einer Datei.

iterator = love.filesystem.lines( name )

iterator	function	Eine Funktion, die über alle Zeilen in der Datei iteriert.
name	string	Der Name (und Pfad) der Datei.

love.filesystem.load

Lädt eine Lua-Datei (läuft aber nicht).

chunk = love.filesystem.load( name, errormsg )

chunk	function	Das geladene Stück.
name	string	Der Name (und Pfad) der Datei.
errormsg (nil)	string	Die Fehlermeldung, wenn Datei nicht geöffnet werden konnte.

love.filesystem.mount

Bereitet eine Zip-Datei oder einen Ordner in das Spiel-Verzeichnis des Spiels zum Lesen.

success = love.filesystem.mount( archive, mountpoint, appendToPath )

success	boolean	True, wenn das Archiv erfolgreich montiert wurde, sonst false.
archive	string	Der Ordner oder die Zip-Datei in das Spiel-Verzeichnis des Spiels zu montieren.
mountpoint	string	Der neue Pfad des Archivs wird montiert.
appendToPath (false)	string	Ob das Archiv beim Lesen eines Dateipfads vor oder nach dem bereits vorhandenen Archiv durchsucht wird. Dies beinhaltet die Quelle des Spiels und speichern Verzeichnisse.

love.filesystem.newFile

Erstellt ein neues Dateiobjekt. Es muss geöffnet werden, bevor es zugegriffen werden kann.

file, errorstr = love.filesystem.newFile( filename, mode )

file	File	Das neue File-Objekt oder nil, wenn ein Fehler aufgetreten ist.
errorstr	string	Die Fehlerfolge, wenn ein Fehler aufgetreten ist.
filename	string	Der Dateiname der Datei zum Lesen.
mode ("c")	FileMode	Der Modus zum Öffnen der Datei in.

love.filesystem.newFileData

Erstellt ein neues FileData-Objekt.

data = love.filesystem.newFileData( contents, name, decoder )

data	FileData	Das neue FileData-Objekt.
contents	string	Der Inhalt der Datei.
name	string	Der Name der Datei.
decoder ("file")	FileDecoder	Die Methode, welche zum Dekodieren des Inhalts benutzt werden soll.

data, err = love.filesystem.newFileData( filepath )

Erstellt ein neues FileData-Objekt von einer Datei auf der Festplatte.

data	FileData	Das neue FileData-Objekt oder nil, wenn ein Fehler aufgetreten ist.
err	string	Ein String, welcher die Fehlernachricht beinhaltet, falls ein Fehler aufgetreten ist.
filepath	string	Der Pfad zur Datei.

love.filesystem.read

Lesen Sie den Inhalt einer Datei.

contents, size = love.filesystem.read( name, bytes )

contents	string	Der Inhalt der Datei.
size	number	Wie viele Bytes wurden gelesen.
name	string	Der Name (und Pfad) der Datei.
bytes (all)	number	Wie viele Bytes zu lesen.

love.filesystem.remove

Entfernt eine Datei oder ein Verzeichnis.

success = love.filesystem.remove( name )

success	boolean	True, wenn die Datei / das Verzeichnis entfernt wurde, false anders.
name	string	Die Datei oder das Verzeichnis zu entfernen.

love.filesystem.setIdentity

Bestimmt das Schreib-Verzeichnis für das jeweilige Spiel.

Zu Beachten ist hierbei, dass lediglich der Name des Ordners bestimmt wird, nicht aber der Ort an dem die Dateien gespeichert werden.

love.filesystem.setIdentity( name, appendToPath )

name	string	Die neue Identität, die als Schreibverzeichnis verwendet wird.
appendToPath (false)	boolean	Ob das Identitätsverzeichnis beim Lesen eines Dateipfads vor oder nach dem Quellverzeichnis des Spiels und allen aktuell installierten Archiven durchsucht wird.

love.filesystem.setRequirePath

Legt die Dateisystempfade fest, die bei Bedarf aufgerufen werden.

Der Pfadstring, der dieser Funktion gegeben wird, ist eine Folge von Pfadvorlagen, die durch Semikolons getrennt sind. Das anforderte Argument wird anstelle eines beliebigen Fragezeichen-Zeichens ("?") In jeder Vorlage eingefügt (nachdem die Punktzeichen im Argument, die an das Erfordernis übergeben wurden, durch Verzeichnistrennzeichen ersetzt werden).

Die Pfade sind relativ zu der Quelle des Spiels und speichern Verzeichnisse, sowie alle Pfade mit love.filesystem.mount montiert.

love.filesystem.setRequirePath( paths )

paths

string

Die Pfade, die die Erforderungsfunktion im Liebes-Dateisystem überprüfen wird.

love.filesystem.setSource

Setzt die Quelle des Spiels, wo der Code vorhanden ist. Diese Funktion kann nur einmal aufgerufen werden und wird normalerweise automatisch von LÖVE durchgeführt.

love.filesystem.setSource( path )

path

string

Absoluter Pfad zum Quellordner des Spiels.

love.filesystem.setSymlinksEnabled

Legt fest, ob love.filesystem den symbolischen Links folgt. Es ist standardmäßig in Version 0.10.0 und neuer aktiviert und standardmäßig in 0.9.2 deaktiviert.

love.filesystem.setSymlinksEnabled( enable )

enable

boolean

Ob love.filesystem den symbolischen Links folgen sollte.

love.filesystem.unmount

Entfernt eine Zip-Datei oder einen Ordner, der zuvor für das Lesen mit love.filesystem.mount installiert wurde.

success = love.filesystem.unmount( archive )

success	boolean	True, wenn das Archiv erfolgreich unmontiert wurde, sonst false.
archive	string	Der Ordner oder die Zip-Datei im Spiel-Verzeichnis, das derzeit montiert ist.

love.filesystem.write

Schreibt Daten in eine Datei im Speicherordner. Wenn die Datei bereits existiert, wird sie komplett mit dem neuen Inhalt überschrieben.

success, message = love.filesystem.write( name, data, size )

success	boolean	Wenn die Operation erfolgreich war.
message	string	Fehlermeldung, wenn die Operation nicht erfolgreich war.
name	string	Der Name (und Pfad) der Datei.
data	string	Die String-Daten zum Schreiben in die Datei.
size (all)	number	Wie viele Bytes zu schreiben.

success, message = love.filesystem.write( name, data, size )

success	boolean	Wenn die Operation erfolgreich war.
message	string	Fehlermeldung, wenn die Operation nicht erfolgreich war.
name	string	Der Name (und Pfad) der Datei.
data	Data	Das Datenobjekt zum Schreiben in die Datei.
size (all)	number	Wie viele Bytes zu schreiben.

BufferMode

none

Keine Pufferung Das Ergebnis von Schreib- und Anhängevorgängen erscheint sofort.

line

Zeilenpufferung Schreib- und Anhängevorgänge werden gepuffert, bis ein Zeilenumbruch ausgegeben wird oder die Puffergrßengrenze erreicht ist.

full

Vollpufferung Schreib- und Anhängevorgänge werden immer gepuffert, bis die Puffergrßengrenze erreicht ist.

FileDecoder

file

Die Daten sind nicht codiert.

base64

Die Daten sind base64-codiert.

FileMode

Öffnet eine Datei zum Lesen.

Öffnet eine Datei zum Schreiben.

Öffnet eine Datei zum Anhängen von Daten.

Öffnet die Datei nicht. Repräsentiert eine geschlossene Datei.

File

Repräsentiert eine Datei im Dateisystem.

Constructors

love.filesystem.newFile Erstellt ein neues Dateiobjekt.

Functions

File:open Öffnen Sie die Datei zum Schreiben, Lesen oder Anhängen.

File:close Schließt eine Datei.

File:read Lesen Sie eine Anzahl von Bytes aus einer Datei.

File:lines Iteriert über alle Zeilen einer Datei.

File:write Schreiben Sie Daten in eine Datei.

File:get/setBuffer Setzt den Puffer-Modus für eine Datei zum Schreiben oder Anhängen geöffnet.

File:flush Spült alle gepufferten geschriebenen Daten in der Datei auf die Festplatte.

File:getMode Gibt den Modus zurück mit welchem die Datei geöffnet wurde.

File:isOpen Gibt zurück ob eine Datei geöffnet ist.

File:isEOF Gibt an, ob End-of-Datei erreicht wurde.

File:getFilename Ruft den Dateinamen ab, mit dem das File-Objekt erstellt wurde.

File:getSize Gibt die Größe einer Datei zurück.

File:tell/seek Suchen Sie eine Position in einer Datei.

Supertypes

Object Die Superklasse aller LÖVE-Typen.

File:close

Schließt eine Datei.

success = File:close()

success

boolean

Gibt zurück, ob die Datei erfolgreich geschlossen wurde.

File:flush

Spült alle gepufferten geschriebenen Daten in der Datei auf die Festplatte.

success, err = File:flush()

success	boolean	Ob die Datei erfolgreich gepufferte Daten auf den Datenträger gelöscht hat.
err	string	Die Fehlerzeichenfolge, wenn ein Fehler aufgetreten ist und die Datei nicht gelöscht werden konnte.

File:getBuffer

Gibt den Buffer-Modus einer Datei zurück.

mode, size = File:getBuffer()

mode	BufferMode	Der aktuelle Buffer-Modus einer Datei.
size	number	Die maximale Größe des Buffers in Bytes.

File:getFilename

Ruft den Dateinamen ab, mit dem das File-Objekt erstellt wurde. Wenn das Dateiobjekt aus dem love.filedropped Callback stammt, ist der Dateiname der vollständige plattformabhängige Dateipfad.

filename = File:getFilename()

filename

string

Der Dateiname der Datei.

File:getMode

Gibt den Modus zurück mit welchem die Datei geöffnet wurde.

mode = File:getMode()

mode

FileMode

Der Modus mit welchem die Datei geöffnet wurde.

File:getSize

Gibt die Größe einer Datei zurück.

size = File:getSize()

size

number

Die Größe der Datei.

File:isEOF

Gibt an, ob End-of-Datei erreicht wurde.

eof = File:isEOF()

eof

boolean

Ob EOF erreicht ist.

File:isOpen

Gibt zurück ob eine Datei geöffnet ist.

open = File:isOpen()

open

boolean

Wahr wenn die Datei gerade geöffnet ist, falsch wenn nicht.

File:lines

Iteriert über alle Zeilen einer Datei.

iterator = File:lines()

iterator

function

Der Iterator (kann in for-Schleifen genutzt werden).

File:open

Öffnen Sie die Datei zum Schreiben, Lesen oder Anhängen.

Wenn Sie die Fehlermeldung "Konnte nicht schreiben Schreibverzeichnis", versuchen Sie die Einstellung der Speicher-Verzeichnis. Dies geschieht entweder mit love.filesystem.setIdentity oder durch das Festlegen des Identitätsfeldes in love.conf.

success = File:open( mode )

success	boolean	True auf Erfolg, falsch anders.
mode	FileMode	Der Modus zum Öffnen der Datei in.

File:read

Lesen Sie eine Anzahl von Bytes aus einer Datei.

contents, size = File:read( bytes )

contents	string	Der Inhalt der gelesenen Bytes.
size	number	Wie viele Bytes wurden gelesen.
bytes (all)	number	Die Anzahl der zu lesenden Bytes

File:seek

Suchen Sie eine Position in einer Datei.

success = File:seek( position )

success	boolean	Ob der Betrieb erfolgreich war.
position	number	Die Position zu suchen.

File:setBuffer

Setzt den Puffer-Modus für eine Datei zum Schreiben oder Anhängen geöffnet. Dateien mit Pufferung aktiviert wird keine Daten auf die Festplatte schreiben, bis die Puffergrßengrenze erreicht ist, abhängig vom Puffermodus.

success, errorstr = File:setBuffer( mode, size )

success	boolean	Ob der Puffer-Modus erfolgreich eingestellt wurde.
errorstr	string	Die Fehlerzeichenfolge, wenn der Puffermodus nicht gesetzt werden konnte und ein Fehler aufgetreten ist.
mode	BufferMode	Der Puffer-Modus zu verwenden.
size (0)	number	Die maximale Größe in Bytes des Puffers der Datei.

File:tell

Ruft die Position in der Datei ab.

pos = File:tell()

pos

number

Die aktuelle Position.

File:write

Schreiben Sie Daten in eine Datei.

success = File:write( data, size )

success	boolean	Ob der Betrieb erfolgreich war.
data	string	Die zu schreibenden Daten
size (all)	number	Wie viele Bytes zu schreiben.

FileData

Ein Datum welches den Inhalt einer Datei repräsentiert.

Constructors

love.filesystem.newFileData Erstellt ein neues FileData-Objekt.

Functions

FileData:getFilename Ruft den Dateinamen der FileData ab.

FileData:getExtension Gibt die Dateiendung des FileData-Objekts zurück.

Supertypes

Data Die Superklasse aller Datentypen.

Object Die Superklasse aller LÖVE-Typen.

FileData:getExtension

Gibt die Dateiendung des FileData-Objekts zurück.

ext = FileData:getExtension()

ext

string

Die Dateiendung der Datei, welche das FileData-Objekts repräsentiert.

FileData:getFilename

Ruft den Dateinamen der FileData ab.

name = FileData:getFilename()

name

string

Der Name der Datei, die die FileData repräsentiert.

love.graphics

Types

Canvas Ein Offscreen-Buffer welcher für das sogenannte "Off-screen Rendering" verwendet wird.

Font Definiert das Aussehen von Charakteren welche auf den Bildschirm gezeichnet werden.

Mesh Ein zweidimensionales Polygonnetz zum Zeichnen von beliebig geformten Texturobjekten.

Image Ein Bild, welches gezeichnet werden kann.

ParticleSystem Partikelsysteme können dazu benutzt werden viele verschiedene Effekte wie Feuer oder Rauch zu erzeugen.

Quad Ein Viereck (ein Polygon mit vier Seiten und vier Ecken) mit Texturkoordinaten.

Shader Ein Shader wird für fortgeschrittene hardware-beschleunigte Pixel oder Vertex Manipulationen genutzt.

SpriteBatch Mit Hilfe eines SpriteBatch können beliebig viele Kopien eines Bildes mit einem einzigen Aufruf von love.graphics.draw auf den Bildschirm gezeichnet werden.

Text Zeichnungstext.

Texture Die Superklasse für alle zeichenbaren Objekte welche eine Textur repräsentieren.

Video Ein ziehbares Video.

Functions

love.graphics.draw Zeichnet ein zeichenbares Objekt (z.B.

love.graphics.print Zeichnet einen Text auf den Bildschirm.

love.graphics.printf Zeichnet formatierten Text mit Zeilenumbrüchen und Textausrichtung.

love.graphics.line Zeichnet eine Linie zwischen zwei oder mehr Punkten.

love.graphics.polygon Zeichnet ein Vieleck (Polygon).

love.graphics.rectangle Zeichnet ein Rechteck.

love.graphics.circle Zeichnet einen Kreis.

love.graphics.ellipse Zeichnet eine Ellipse.

love.graphics.arc Zeichnet einen gefüllten oder ungefüllten Bogen an der Position (x, y).

love.graphics.points Zeichnet einen oder mehrere Punkte.

love.graphics.stencil Zeichnet die Geometrie als Schablone.

love.graphics.get/setStencilTest Konfiguriert oder deaktiviert die Schablonentests.

love.graphics.push Kopiert und schiebt die aktuelle Koordinatentransformation in den Transformationsstapel.

love.graphics.pop Zieht die aktuelle Koordinatentransformation aus dem Transformationsstapel.

love.graphics.reset Setzt die aktuellen Grafikeinstellungen zurück.

love.graphics.get/setFont Setzen Sie eine bereits geladene Schriftart als die aktuelle Schriftart oder erstellen Sie eine neue aus der Datei und Größe.

love.graphics.get/setBackgroundColor Bestimmt die Hintergrundfarbe.

love.graphics.get/setBlendMode Setzt den Mischmodus.

love.graphics.get/setCanvas Bestimmt ein neues Renderziel.

love.graphics.get/setColor Legt die für das Zeichnen verwendete Farbe fest.

love.graphics.get/setColorMask Setzt die Farbmaske.

love.graphics.get/setDefaultFilter Legt die Standard-Skalierungsfilter fest, die mit Bildern, Leinwänden und Schriftarten verwendet werden.

love.graphics.get/setLineJoin Setzt den Linienverknüpfungsstil.

love.graphics.get/setLineStyle Bestimmt den Stil in dem Linien gezeichnet werden.

love.graphics.get/setLineWidth Bestimmt die Breite mit der Linien gezeichnet werden sollen.

love.graphics.get/setShader Setzt oder setzt einen Shader als den aktuellen Pixeleffekt oder die Vertex-Shader zurück.

love.graphics.get/setPointSize Bestimmt die Größe mit welcher Punkte gezeichnet werden.

love.graphics.get/setScissor Setzt oder deaktiviert Schere.

love.graphics.intersectScissor Setzt die Schere auf das Rechteck, das durch den Schnittpunkt des angegebenen Rechtecks mit der vorhandenen Schere erzeugt wird.

love.graphics.origin Setzt die aktuelle Koordinatentransformation zurück.

love.graphics.rotate Dreht das Koordinatensystem in zwei Dimensionen.

love.graphics.scale Skaliert das Koordinatensystem in zwei Dimensionen.

love.graphics.shear Schneidet das Koordinatensystem.

love.graphics.translate Übersetzt das Koordinatensystem in zwei Dimensionen.

love.graphics.getDimensions Gibt die Breite und Höhe des Fensters in Pixeln zurück.

love.graphics.getHeight Gibt die Höhe des Fensters in Pixeln zurück.

love.graphics.getWidth Gibt die Breite des Fensters in Pixeln zurück.

love.graphics.getCanvasFormats Ruft die verfügbaren Canvas-Formate ab und ob jeder unterstützt wird.

love.graphics.getCompressedImageFormats Erhält die verfügbaren komprimierten Bildformate und ob jeder unterstützt wird.

love.graphics.getStats Erzielt leistungsbezogene Rendering-Statistiken.

love.graphics.getSystemLimits Ruft die systemabhängigen Maximalwerte für love.graphics-Features ab.

love.graphics.getRendererInfo Ermittelt Informationen über die Grafikkarte und die Treiber des Systems.

love.graphics.getSupported Erhält die optionalen Grafikfunktionen und ob sie auf dem System unterstützt werden.

love.graphics.isGammaCorrect Ermittelt, ob gamma-korrektes Rendering unterstützt und aktiviert ist.

love.graphics.newScreenshot Erstellt einen Screenshot und gibt die Bilddaten zurück.

love.graphics.is/setWireframe Legt fest, ob Drahtgitterlinien beim Zeichnen verwendet werden.

love.graphics.clear Löscht den aktuellen Bildschirminhalt und füllt ihn mit der Hintergrundfarbe.

love.graphics.discard Verwirft den Inhalt des Bildschirms oder der aktiven Leinwand.

love.graphics.present Zeigt das Ergebnis der bisherigen Zeichenoperationen auf dem Bildschirm.

Enums

AlignMode Bestimmt wie Text auf dem Bildschirm ausgerichtet werden soll.

ArcType Verschiedene Arten von Bögen, die gezogen werden können.

AreaSpreadDistribution Verschiedene Arten der Partikeldistribution im Raum.

BlendAlphaMode Verschiedene Möglichkeiten Alpha beeinflusst Farbmischung.

BlendMode Unterschiedliche Arten des Alpha-Blendings.

CanvasFormat Leinwandformate.

CompareMode Verschiedene Arten von Per-Pixel-Schablonen-Testvergleichen.

DrawMode Bestimmt ob nur die Umrisse einer Form gezeichnet, oder diese ausgefüllt werden soll.

FilterMode Die Arten von Filtern welche beim Skalieren von Bildern verwendet werden können.

GraphicsFeature Grafikfunktionen, die mit love.graphics.getSupported überprüft werden können.

GraphicsLimit Arten von systemabhängigen Grafikgrenzen für die Verwendung von love.graphics.getSystemLimits überprüft.

LineJoin Line-Join-Stil.

LineStyle Der Stil in dem Linien gezeichnet werden sollen.

MeshDrawMode Wie ein Mesh-Scheitel beim Zeichnen verwendet wird.

ParticleInsertMode Bestimmt wie neu erstellte Partikel zum Partikelsystem hinzugefügt werden.

SpriteBatchUsage Nutzungshinweise für SpriteBatches um die Speichernutzung im Grafikprozessor zu optimieren.

StackType Grafik-Stack-Typen mit love.graphics.push verwendet.

StencilAction Wie eine Schablonenfunktion die Schablonenwerte von Pixeln modifiziert, die sie berührt.

WrapMode Wie das Bild in einem Quad mit einer größeren Quad Größe als Bildgröße verpackt.

love.graphics.arc

Zeichnet einen gefüllten oder ungefüllten Bogen an der Position (x, y). Der Boden wird von winkel1 zu winkel2 gezeichnet (die verwendete Winkeleinheit wird dabei in Radianten angegeben). Das segmente Parameter bestimmte wieviele Segmente beim Zeichnen genutzt werden sollen. Je mehr Segmente der Bogen hat, desto runder / glatter wird er gezeichnet.

love.graphics.arc( drawmode, arctype, x, y, radius, angle1, angle2, segments )

drawmode	DrawMode	Wie man den Bogen zieht.
arctype ("pie")	ArcType	Die Art des Bogens zu zeichnen.
x	number	Die Position des Zentrums entlang der x-Achse.
y	number	Die Position des Zentrums entlang der y-Achse.
radius	number	Radius des Bogens
angle1	number	Der Winkel, bei dem der Bogen beginnt.
angle2	number	Der Winkel, bei dem der Lichtbogen endet.
segments (10)	number	Die Anzahl der zum Zeichnen des Bogens verwendeten Segmente

love.graphics.circle

Zeichnet einen Kreis.

love.graphics.circle( mode, x, y, radius )

mode	DrawMode	Wie zeichne ich den Kreis.
x	number	Die Position des Zentrums entlang der x-Achse.
y	number	Die Position des Zentrums entlang der y-Achse.
radius	number	Der Radius des Kreises.

love.graphics.circle( mode, x, y, radius, segments )

mode	DrawMode	Bestimmt den Zeichenmodus.
x	number	Die Position des Kreismittelpunkts auf der x-Achse.
y	number	Die Position des Kreismittelpunkts auf der y-Achse.
radius	number	Der Radius der Kreises.
segments	number	Die Anzahl der einzelnen Segmente welche zum zeichnen des Kreises verwendet werden sollen (je höher die Anzahl, desto "runder" wird der Kreis.

love.graphics.clear

Löscht den aktuellen Bildschirminhalt und füllt ihn mit der Hintergrundfarbe. Das Koordinatensystem wird ebenfalls zurückgesetzt.

Die Funktion wird automatisch von love.run aufgerufen bevor love.draw läuft.

Zu Beachten ist, dass die zu löschende Fläche durch love.graphics.setScissor gesteuert werden kann.

love.graphics.clear()

Clears the screen to the background color in 0.9.2 and earlier, or to transparent black (0, 0, 0, 0) in LÖVE 0.10.0 and newer.

love.graphics.clear( r, g, b, a )

Löscht den Bildschirm bzw. aktive Canvas auf die angegebene Farbe.

r	number	Der rote Kanal der Farbe, um den Bildschirm zu löschen.
g	number	Der grüne Kanal der Farbe, um den Bildschirm zu löschen.
b	number	Der blaue Kanal der Farbe, um den Bildschirm zu löschen.
a (255)	number	Der Alphakanal der Farbe, um den Bildschirm zu löschen.

love.graphics.clear( color, ... )

Löscht mehr aktive Canvases zu verschiedenen Farben, wenn mehrere Canvases sind aktiv sofort über love.graphics.setCanvas.

color	table	Ein Tisch in Form von {r, g, b, a} mit der Farbe, um die erste aktive Leinwand zu löschen.
...	table	Zusätzliche Tabellen für jede aktive Leinwand.

love.graphics.discard

Verwirft den Inhalt des Bildschirms oder der aktiven Leinwand. Dies ist eine Performance-Optimierung mit Nischen-Use-Fällen.

Wenn das aktive Canvas gerade geändert wurde und der "replace" BlendMode verwendet wird, um etwas zu zeichnen, das den gesamten Bildschirm abdeckt, ruft love.graphics.discard an, anstatt love.graphics.clear anzurufen oder nichts zu tun, kann die Leistung auf dem Handy verbessern geräte

Auf einigen Desktop-Systemen kann diese Funktion nichts machen.

love.graphics.discard( discardcolor, discardstencil )

discardcolor (true)	boolean	Ob die Textur (en) des aktiven Canvas (es) verwerfen (der Inhalt des Bildschirms, wenn kein Canvas aktiv ist).
discardstencil (true)	boolean	Ob der Inhalt des Schablonenpuffers des Bildschirms / aktives Canvas verwerfen soll.

love.graphics.discard( discardcolors, discardstencil )

discardcolors	table	Ein Array mit booleschen Werten, die angeben, ob die Textur jedes aktiven Canvas verwerfen soll, wenn mehrere gleichzeitige Leinwände aktiv sind.
discardstencil (true)	boolean	Ob der Inhalt des Schablonenpuffers des Bildschirms / aktives Canvas verwerfen soll.

love.graphics.draw

Zeichnet ein zeichenbares Objekt (z.B. ein Bild) auf den Bildschirm, wobei sich Größe, Rotation und Scherung anpassen lassen.

Objekte werden dabei relativ zu ihrem lokalen Koordinatensystem gezeichnet. Der Ursprung ist standardmäßig die obere linke Ecke bei Bildern und Leinwänden. Alle Skalierungs-, Rotations- und Verformungsoperationen werden daher relativ zu diesem Punkt durchgeführt.

Um ein Objekt um seine eigene Mitte zu rotieren, muss der Ursprung in die Mitte des Objekts verschoben werden. Das Objekt kann durch Verwendung negativer Skalierungswerte gespiegelt werden.

Verschiebungen werden angewendet bevor das Objekt rotiert, skaliert oder deformiert wird. Skalierung und Scherung laufen dabei vor der Rotation ab.

love.graphics.draw( drawable, x, y, r, sx, sy, ox, oy, kx, ky )

drawable	Drawable	Ein zeichenbares Objekt.
x (0)	number	Die Position auf der x-Achse an der das Objekt gezeichnet werden soll.
y (0)	number	Die Position auf der y-Achse an der das Objekt gezeichnet werden soll.
r (0)	number	Die Rotation in Radianten.
sx (1)	number	Der Skalierungsfaktor in x-Richtung.
sy (sx)	number	Der Skalierungsfaktor in y-Richtung.
ox (0)	number	Verschiebung vom Urpsrung auf der x-Achse.
oy (0)	number	Verschiebung vom Urpsrung auf der y-Achse.
kx (0)	number	Der Scherfaktor in x-Richtung.
ky (0)	number	Der Scherfaktor in y-Richtung.

love.graphics.draw( texture, quad, x, y, r, sx, sy, ox, oy, kx, ky )

texture	Texture	Eine Beschaffenheit (Bild oder Leinwand), um die Quad mit zu beschriften.
quad	Quad	Die Quad auf dem Bildschirm zu zeichnen.
x (0)	number	Die Position, um das Objekt (x-Achse) zu zeichnen.
y (0)	number	Die Position, um das Objekt (y-Achse) zu zeichnen.
r (0)	number	Orientierung (Bogenmaß).
sx (1)	number	Skalenfaktor (x-Achse). Kann negativ sein
sy (sx)	number	Skalenfaktor (y-Achse). Kann negativ sein
ox (0)	number	Ursprungsversatz (x-Achse).
oy (0)	number	Ursprungsversatz (y-Achse)
kx (0)	number	Scherfaktor (x-Achse).
ky (0)	number	Scherfaktor (y-Achse).

love.graphics.ellipse

Zeichnet eine Ellipse.

love.graphics.ellipse( mode, x, y, radiusx, radiusy, segments )

mode	DrawMode	Wie zeichne die Ellipse.
x	number	Die Position des Zentrums entlang der x-Achse.
y	number	Die Position des Zentrums entlang der y-Achse.
radiusx	number	Der Radius der Ellipse entlang der x-Achse (die Hälfte der Breite der Ellipse).
radiusy	number	Der Radius der Ellipse entlang der y-Achse (die Hälfte der Ellipsenhöhe).
segments (based on size)	number	Die Anzahl der Segmente, die zum Zeichnen der Ellipse verwendet werden.

love.graphics.getBackgroundColor

Gibt die derzeitige Hintergrundfarbe zurück.

r, g, b, a = love.graphics.getBackgroundColor()

r	number	Der rote Farbanteil (0-255).
g	number	Der grüne Farbanteil (0-255).
b	number	Der blaue Farbanteil (0-255).
a	number	Die Transparenz (0-255).

love.graphics.getBlendMode

Gibt den Mischungsmodus für transparente Objekte zurück.

mode, alphamode = love.graphics.getBlendMode()

mode	BlendMode	Der aktuelle Mischmodus.
alphamode	BlendAlphaMode	Der aktuelle Blend Alpha-Modus - es bestimmt, wie das Alpha von gezeichneten Objekten das Blending beeinflusst.

love.graphics.getCanvas

Ruft das aktuelle Ziel Canvas ab.

canvas = love.graphics.getCanvas()

canvas

Canvas

Die Leinwand von setCanvas gesetzt. Rückkehr nil beim Zeichnen auf den realen Bildschirm.

love.graphics.getCanvasFormats

Ruft die verfügbaren Canvas-Formate ab und ob jeder unterstützt wird.

formats = love.graphics.getCanvasFormats()

formats

table

Eine Tabelle mit CanvasFormats als Schlüssel und ein Boolescher Wert, ob das Format als Werte unterstützt wird. Nicht alle Systeme unterstützen alle Formate.

love.graphics.getColor

Ruft die aktuelle Farbe ab.

r, g, b, a = love.graphics.getColor()

r	number	Die rote Komponente (0-255).
g	number	Die rote Komponente (0-255).
b	number	Die blaue Komponente (0-255).
a	number	Die Alphakomponente (0-255).

love.graphics.getColorMask

Ruft die beim Zeichnen verwendeten aktiven Farbkomponenten ab. Normalerweise sind alle 4 Komponenten aktiv, wenn love.graphics.setColorMask verwendet wurde.

Die Farbmaske bestimmt, ob einzelne Komponenten der Farben von gezeichneten Objekten die Farbe des Bildschirms beeinflussen. Sie beeinflussen love.graphics.clear und Canvas: klar auch.

r, g, b, a = love.graphics.getColorMask()

r	boolean	Ob die rote Farbkomponente beim Rendern aktiv ist.
g	boolean	Ob die grüne Farbkomponente beim Rendern aktiv ist.
b	boolean	Ob die blaue Farbkomponente beim Rendern aktiv ist.
a	boolean	Ob die Alpha-Farbkomponente beim Rendern aktiv ist.

love.graphics.getCompressedImageFormats

Erhält die verfügbaren komprimierten Bildformate und ob jeder unterstützt wird.

formats = love.graphics.getCompressedImageFormats()

formats

table

Eine Tabelle mit CompressedFormats als Schlüssel und ein Boolescher Wert, ob das Format als Werte unterstützt wird. Nicht alle Systeme unterstützen alle Formate.

love.graphics.getDefaultFilter

Ruft die Standard-Skalierungsfilter ab, die mit Bildern, Leinwänden und Schriftarten verwendet werden.

min, mag, anisotropy = love.graphics.getDefaultFilter()

min	FilterMode	Filtermodus, der beim Skalieren des Bildes verwendet wird.
mag	FilterMode	Filtermodus, der beim Skalieren des Bildes verwendet wird.
anisotropy	number	Maximale Menge an anisotroper Filterung verwendet.

love.graphics.getDimensions

Gibt die Breite und Höhe des Fensters in Pixeln zurück.

width, height = love.graphics.getDimensions()

width	number	Die Breite des Fensters in Pixeln.
height	number	Die Höhe des Fensters in Pixeln.

love.graphics.getFont

Ruft das aktuelle Font-Objekt ab.

font = love.graphics.getFont()

font

love.graphics.getLineJoin

Die aktuelle Schriftart, oder nil wenn keine gesetzt ist.

love.graphics.getHeight

Gibt die Höhe des Fensters in Pixeln zurück.

height = love.graphics.getHeight()

height

number

Die Höhe des Fensters in Pixeln.

Ruft den Linien-Join-Stil ab.

join = love.graphics.getLineJoin()

join

LineJoin

Der LineJoin-Stil.

love.graphics.getLineStyle

Ruft den Linienstil ab.

style = love.graphics.getLineStyle()

style

LineStyle

Der aktuelle Linienstil.

love.graphics.getLineWidth

Ruft die aktuelle Zeilenbreite ab.

width = love.graphics.getLineWidth()

width

number

Die aktuelle Zeilenbreite.

love.graphics.getShader

Gibt den aktuellen Shader zurück.

shader = love.graphics.getShader()

shader

Shader

Der aktive Shader. Wenn kein Shader aktiv ist, so wird nil zurückgegeben.

love.graphics.getStats

Erzielt leistungsbezogene Rendering-Statistiken.

stats = love.graphics.getStats()

stats	table	Eine Tabelle mit folgenden Feldern:
stats.drawcalls	number	Die Anzahl der Anrufe, die während des aktuellen Rahmens so weit gemacht wurden.
stats.canvasswitches	number	Die Anzahl, wie oft die aktive Leinwand im laufenden Rahmen umgeschaltet wurde.
stats.texturememory	number	Die geschätzte Gesamtgröße in Bytes des Videospeichers, die von allen geladenen Bildern, Leinwänden und Schriftarten verwendet werden.
stats.images	number	Die Anzahl der aktuell geladenen Bildobjekte
stats.canvases	number	Die Anzahl der aktuell geladenen Canvas-Objekte
stats.fonts	number	Die Anzahl der aktuell geladenen Font-Objekte
stats.shaderswitches	number	Die Anzahl, wie oft der aktive Shader während des aktuellen Rahmens geändert wurde.

love.graphics.getStencilTest

Ermittelt, ob die Schablonentests aktiviert sind.

Wenn die Schablonentests aktiviert sind, wird die Geometrie von allem, was gezeichnet wird, abgeschnitten, indem sie sich darauf beschränken, ob sie mit dem, was zuvor auf den Schablonenpuffer gezeichnet wurde, schneidet.

Jeder Canvas hat seinen eigenen Schablonenpuffer.

enabled, inverted = love.graphics.getStencilTest()

enabled	boolean	Ob Schablonentests aktiviert sind.
inverted	boolean	Ob der Schablonentest invertiert ist oder nicht.

love.graphics.getSupported

Erhält die optionalen Grafikfunktionen und ob sie auf dem System unterstützt werden.

Einige ältere oder Low-End-Systeme unterstützen nicht immer alle Grafikfunktionen.

features = love.graphics.getSupported()

features

table

Eine Tabelle mit GraphicsFeature-Schlüsseln und booleschen Werten, die angeben, ob jede Funktion unterstützt wird.

love.graphics.getSystemLimits

Ruft die systemabhängigen Maximalwerte für love.graphics-Features ab.

limits = love.graphics.getSystemLimits()

limits

table

Eine Tabelle mit GraphicsLimit-Schlüsseln und Zahlenwerten.

love.graphics.getPointSize

Gibt die aktuelle Größe mit welcher Punkte gezeichnet werden zurück.

size = love.graphics.getPointSize()

size

number

Die aktuelle Größe.

love.graphics.getRendererInfo

Ermittelt Informationen über die Grafikkarte und die Treiber des Systems.

name, version, vendor, device = love.graphics.getRendererInfo()

name	string	Der Name des Renderers, z.B. "OpenGL" oder "OpenGL ES".
version	string	Die Version des Renderers mit einigen zusätzlichen Treiber-abhängigen Versionsinformationen, z.B. "2.1 INTEL-8.10.44".
vendor	string	Der Name des Grafikkartenherstellers, z.B. "Intel Inc".
device	string	Der Name der Grafikkarte, z.B. "Intel HD Graphics 3000 OpenGL Engine".

love.graphics.getScissor

Erhält die aktuelle Scherenbox.

x, y, width, height = love.graphics.getScissor()

x	number	Die x-Komponente des oberen linken Punktes der Box.
y	number	Die y-Komponente des oberen linken Punktes der Box.
width	number	Die Breite der Box.
height	number	Die Höhe der Schachtel.

love.graphics.getWidth

Gibt die Breite des Fensters in Pixeln zurück.

width = love.graphics.getWidth()

width

number

Die Breite des Fensters in Pixeln.

love.graphics.intersectScissor

Setzt die Schere auf das Rechteck, das durch den Schnittpunkt des angegebenen Rechtecks mit der vorhandenen Schere erzeugt wird. Wenn noch keine Schere aktiv ist, verhält es sich wie love.graphics.setScissor.

Die Schere begrenzt den Zeichenbereich auf ein bestimmtes Rechteck. Dies betrifft alle grafischen Anrufe, einschließlich love.graphics.clear.

Die Dimensionen der Schere werden durch grafische Transformationen (translate, scale, ...) nicht beeinflusst.

love.graphics.intersectScissor( x, y, width, height )

Limits the drawing area to a specified rectangle.

x	number	Die x-Koordinate der oberen linken Ecke des Rechtecks, um mit dem vorhandenen Scheren-Rechteck zu schneiden.
y	number	Die y-Koordinate der oberen linken Ecke des Rechtecks, um das vorhandene Scheren-Rechteck zu schneiden.
width	number	Die Breite des Rechtecks, um sich mit dem vorhandenen Scherenrechteck zu schneiden.
height	number	Die Höhe des Rechtecks, um das vorhandene Scherenrechteck zu schneiden.

love.graphics.intersectScissor()

Disables scissor.

love.graphics.isGammaCorrect

Ermittelt, ob gamma-korrektes Rendering unterstützt und aktiviert ist. Es kann aktiviert werden, indem man t.gammacorrect = true in love.conf setzt.

Nicht alle Geräte unterstützen gamma-korrektes Rendering, in diesem Fall wird es automatisch deaktiviert und diese Funktion wird false zurückgeben. Es wird auf Desktopsystemen unterstützt, die Grafikkarten haben, die in der Lage sind, OpenGL 3 / DirectX 10 und iOS Geräte zu verwenden, die OpenGL ES 3 verwenden können.

gammacorrect = love.graphics.isGammaCorrect()

gammacorrect

boolean

True Wenn gamma-korrektes Rendering unterstützt und in love.conf aktiviert wurde, false anders.

love.graphics.isWireframe

Ermittelt, ob der Drahtmodell beim Zeichnen verwendet wird.

wireframe = love.graphics.isWireframe()

wireframe

boolean

True, wenn Wireframe-Linien beim Zeichnen verwendet werden, false, wenn es nicht ist.

love.graphics.line

Zeichnet eine Linie zwischen zwei oder mehr Punkten.

love.graphics.line( x1, y1, x2, y2, ... )

x1	number	Die Position des ersten Punkts auf der x-Achse.
y1	number	Die Position des ersten Punkts auf der y-Achse.
x2	number	Die Position des zweiten Punkts auf der x-Achse.
y2	number	Die Position des zweiten Punkts auf der y-Achse.
...	number	Weitere Punkte (x, y) um eine Polylinie zu zeichnen.

love.graphics.line( points )

points

table

Ein Table mit Punktkoordinaten.

love.graphics.newCanvas

Erstellt einen neuen Offscreen-Buffer.

canvas = love.graphics.newCanvas( width, height, format, msaa )

canvas	Canvas	Ein neues Leinwandobjekt.
width (window width)	number	Die Breite der Leinwand.
height (window height)	number	Die Höhe der Leinwand.
format ("normal")	CanvasFormat	Der gewünschte Texturmodus der Leinwand.
msaa (0)	number	Die gewünschte Anzahl von Antialiasing-Proben, die beim Zeichnen auf die Leinwand verwendet werden.

love.graphics.newFont

Erstellt ein neues Font Objekt.

font = love.graphics.newFont( file, size )

font	Font	Ein Schriftartobjekt, das verwendet werden kann, um Text auf dem Bildschirm zu zeichnen.
file	string / File / FileData	Die Datei / Datei / DateiData der TrueType-Schriftartdatei.
size (12)	number	Die Größe der Schriftart in Pixel.

font = love.graphics.newFont( file, imagefilename )

font	Font	Ein Schriftartobjekt, das verwendet werden kann, um Text auf dem Bildschirm zu zeichnen.
file	string / File / FileData	Der Pfad / Datei / FileData der BMFont-Datei.
imagefilename (path inside BMFont file)	string / File / FileData	Der Pfad / Datei / FileData der Bilddatei des BMFont.

font = love.graphics.newFont( size )

Diese Variante nutzt den Standard-Font (Vera Sans) mit einer benutzerdefinierten Größe.

font	Font	Ein Font-Objekt welches dazu benutzt werden kann, Text auf den Bildschirm zu zeichnen.
size	number	Die Größe des Font in Pixeln.

love.graphics.newMesh

Erstellt ein neues Mesh.

Verwenden Sie Mesh: setTexture, wenn das Mesh mit einem Bild oder Leinwand strukturiert werden soll, wenn es gezeichnet ist.

mesh = love.graphics.newMesh( vertexformat, vertices, mode, usage )

Creates a Mesh with custom vertex attributes and the specified vertex data.

mesh	Mesh	Das neue Mesh.
vertexformat (none)	table	Eine Tabelle in Form von {attribute, ...}. Jedes Attribut ist eine Tabelle, die ein benutzerdefiniertes Scheitelattribut angibt, das für jeden Scheitelpunkt verwendet wird.
vertexformat.attribute	table	Eine Tabelle, die den Namen des Attributs, den Datentyp und die Anzahl der Komponenten im Attribut enthält, in Form von {name, datatype, components}.
vertexformat....	table	Zusätzliche Vertexattributformattabellen.
vertices	table	Die Tabelle gefüllt mit Scheitelpunkttabellen für jeden Scheitelpunkt, in Form von {Scheitelpunkt, ...} wobei jeder Scheitelpunkt eine Tabelle in Form von {attributecomponent, ...} ist.
vertices.attributecomponent	number	Die erste Komponente des ersten Scheitelattributs im Scheitelpunkt.
vertices....	number	Zusätzliche Komponenten aller Scheitelattribute im Scheitelpunkt.
mode ("fan")	MeshDrawMode	Wie die Ecken beim Zeichnen verwendet werden. Der Standardmodus "Lüfter" reicht für einfache konvexe Polygone aus.
usage ("dynamic")	SpriteBatchUsage	Der erwartete Gebrauch des Mesh. Der angegebene Nutzungsmodus wirkt sich auf den Speicherverbrauch und die Leistung des Mesh aus.

mesh = love.graphics.newMesh( vertexformat, vertexcount, mode, usage )

Creates a Mesh with custom vertex attributes and the specified number of vertices.

mesh	Mesh	Das neue Mesh.
vertexformat (none)	table	Eine Tabelle in Form von {attribute, ...}. Jedes Attribut ist eine Tabelle, die ein benutzerdefiniertes Scheitelattribut angibt, das für jeden Scheitelpunkt verwendet wird.
vertexformat.attribute	table	Eine Tabelle, die den Namen des Attributs, den Datentyp und die Anzahl der Komponenten im Attribut enthält, in Form von {name, datatype, components}.
vertexformat....	table	Zusätzliche Vertexattributformattabellen.
vertexcount	number	Die Gesamtzahl der Ecken, die das Netz benutzen wird.
mode ("fan")	MeshDrawMode	Wie die Ecken beim Zeichnen verwendet werden. Der Standardmodus "Lüfter" reicht für einfache konvexe Polygone aus.
usage ("dynamic")	SpriteBatchUsage	Der erwartete Gebrauch des Mesh. Der angegebene Nutzungsmodus wirkt sich auf den Speicherverbrauch und die Leistung des Mesh aus.

love.graphics.newImage

Erstellt ein neues Image aus einem Dateipfad, einer FileData oder aus einer ImageData

image = love.graphics.newImage( file, flags )

image	Image	Ein Bildobjekt, das auf dem Bildschirm gezeichnet werden kann.
file	path / File / FileData / ImageData / CompressedImageData	Der Dateipfad / Datei / FileData / ImageData / CompressedImageData des Bildes.
flags	table	Eine Tabelle mit folgenden Feldern:
flags.linear (false)	boolean	True, wenn die Pixel des Bildes als lineares RGB interpretiert werden sollen, anstatt sRGB-codiert, wenn gamma-korrektes Rendering aktiviert ist. Hat sonst nichts anderes
flags.mipmaps (false)	boolean or table	Wenn es wahr ist, werden mipmaps für das Bild automatisch generiert (oder aus der Bilderdatei genommen, wenn möglich, wenn das Bild aus einer CompressedImageData stammt). Wenn dieser Wert eine Tabelle ist, sollte er eine Liste von anderen Dateinamen von Bildern des gleichen Formats enthalten, die schrittweise halbformatige Dimensionen haben, bis hin zu 1x1. Diese Bilder werden als Mipmap-Level dieses Bildes verwendet.

love.graphics.newImageFont

Erstellt eine neue Schriftart, indem ein speziell formatiertes Bild geladen wird.

In Versionen vor 0.9.0 erwartet LÖVE ISO 8859-1 Kodierung für die Glyphen-String.

font = love.graphics.newImageFont( file, glyphs, extraspacing )

font	Font	Ein Schriftartobjekt, das verwendet werden kann, um Text auf dem Bildschirm zu zeichnen.
file	path / File / FileData	Der Dateipfad / Datei / DateiData der Bilddatei.
glyphs	string	Eine Zeichenkette der Zeichen im Bild von links nach rechts.
extraspacing (0)	number	Zusätzlicher Abstand (positiv oder negativ) für jede Glyphe in der Schriftart anzuwenden.

love.graphics.newParticleSystem

Erstellt ein neues Partikelsystem.

system = love.graphics.newParticleSystem( texture, buffer )

system	ParticleSystem	Ein neues Partikelsystem.
texture	Texture	Das Bild oder die Leinwand verwenden.
buffer (1000)	number	Die maximale Anzahl der Partikel zur gleichen Zeit.

love.graphics.newShader

Erstellt ein neues Shader-Objekt für hardwarebeschleunigte Vertex- und Pixeleffekte. Ein Shader enthält entweder Vertex-Shader-Code, Pixel-Shader-Code oder beide.

Vertex-Shader-Code muss mindestens eine Funktion, benannte Position enthalten, die die Funktion ist, die transformierte Scheitelpositionen von gezeichneten Objekten im Bildschirmraum erzeugt.

Pixel-Shader-Code muss mindestens eine Funktion, benannter Effekt enthalten, die die Funktion ist, die die Farbe erzeugt, die auf dem Bildschirm für jedes Pixel gemischt wird, das ein gezeichnetes Objekt berührt.

shader = love.graphics.newShader( code )

shader	Shader	Ein Shader-Objekt zur Verwendung in Zeichnungsvorgängen.
code	string / File / FileData	Der Pixel-Shader- oder Vertex-Shader-Code oder eine Datei mit dem Code.

shader = love.graphics.newShader( pixelcode, vertexcode )

shader	Shader	Ein Shader-Objekt zur Verwendung in Zeichnungsvorgängen.
pixelcode	string / File / FileData	Der Pixel-Shader-Code oder eine Datei mit dem Code.
vertexcode	string / File / FileData	Der Vertex-Shader-Code oder eine Datei mit dem Code.

love.graphics.newText

Erstellt eine neue Schriftart.

text = love.graphics.newText( font, textstring )

text	Text	Das neue ziehbare Textobjekt.
font	Font	Die Schriftart für den Text zu verwenden.
textstring (nil)	string	Die erste Textfolge, die das neue Textobjekt enthält. Kann nil sein

love.graphics.newQuad

Erstellt ein neues Quad.

quad = love.graphics.newQuad( x, y, width, height, sw, sh )

quad	Quad	Das neue Quad.
x	number	Die obere linke Position des Quads auf der x-Achse.
y	number	Die obere linke Position des Quads auf der y-Achse.
width	number	Die Breite des Quads.
height	number	Die Höhe des Quads.
sw	number	Die Breite des Bildes.
sh	number	Die Höhe des Bildes.

love.graphics.newScreenshot

Erstellt einen Screenshot und gibt die Bilddaten zurück.

screenshot = love.graphics.newScreenshot( copyAlpha )

screenshot	ImageData	Die Bilddaten des Screenshots.
copyAlpha (false)	boolean	Ob der Alpha-Kanal des Bildschirms in der ImageData enthalten ist. Wenn false, ist der Screenshot völlig undurchsichtig.

love.graphics.newSpriteBatch

Erstellt einen neuen SpriteBatch.

spriteBatch = love.graphics.newSpriteBatch( texture, maxsprites, usage )

spriteBatch	SpriteBatch	Der neue SpriteBatch.
texture	Texture	Das Bild oder Canvas welches für die Sprites verwendet werden soll.
maxsprites (1000)	number	Die maximale Anzahl an Sprites.
usage ("dynamic")	SpriteBatchUsage	Der erwartete Verwendungszweck für den SpriteBatch.

love.graphics.newVideo

Erstellt ein neues ziehbares Video. Derzeit werden nur Ogg Theora Videodateien unterstützt.

video = love.graphics.newVideo( file, loadaudio )

video	Video	Ein neues Video.
file	string / File	Der Dateipfad / Datei der Ogg Theora Videodatei.
loadaudio (nil)	boolean	Ob Sie versuchen, das Video-Audio in eine Audio-Quelle zu laden. Wenn nicht explizit auf true oder false gesetzt, wird es versuchen, ohne einen Fehler zu verursachen, wenn das Video kein Audio hat.

love.graphics.origin

Setzt die aktuelle Koordinatentransformation zurück.

Diese Funktion wird immer verwendet, um alle vorherigen Anrufe an love.graphics.rotate, love.graphics.scale, love.graphics.shear oder love.graphics.translate umzukehren. Es gibt den aktuellen Transformationszustand auf seine Vorgaben zurück.

love.graphics.origin()

love.graphics.points

Zeichnet einen oder mehrere Punkte.

love.graphics.points( x, y, ... )

x	number	Die Position des ersten Punktes auf der x-Achse.
y	number	Die Position des ersten Punktes auf der y-Achse.
...	number	Die x- und y-Koordinaten von zusätzlichen Punkten.

love.graphics.points( points )

points	table	Eine Tabelle mit mehreren Punktpositionen in Form von {x, y, ...}.
points.x	number	Die Position des ersten Punktes auf der x-Achse.
points.y	number	Die Position des ersten Punktes auf der y-Achse.
points....	number	Die x- und y-Koordinaten von zusätzlichen Punkten.

love.graphics.points( points )

points	table	Eine Tabelle mit mehreren einzeln farbigen Punkten, in Form von {point, ...}. Jede Tabelle enthält die Position und die Farbe eines Punktes in Form von {x, y, r, g, b, a}. Die Farbkomponenten sind optional.
points.point	table	Eine Tabelle, die die Position und die Farbe des ersten Punktes enthält, in Form von {x, y, r, g, b, a}. Die Farbkomponenten sind optional.
points....	table	Zusätzliche Tabellen, die die Position und Farbe von mehr Punkten enthalten, in Form von {x, y, r, g, b, a}. Die Farbkomponenten sind optional.

love.graphics.polygon

Zeichnet ein Vieleck (Polygon).

Diese Funktion nimmt nach dem Zeichenmodus-Argument weitere numerische Argumente oder einen Table mit numerischen Werten entgegen. Diese Werte werden sodann zum Zeichnen des Polygons genutzt, wobei immer von wechselnden x und y Werten ausgegangen wird.

Wenn der "gefüllte" Zeichenmodus verwendet wird, dann muss das Polygon sowohl convex als auch einfach sein. Ansonsten können Renderartifakte entstehen. Seit love.math.triangulate und love.math.isConvex verwendet werden.

love.graphics.polygon( mode, ... )

mode	DrawMode	Bestimmt wie das Polygon gezeichnet werden soll.
...	number	Die Vertices des Polygons.

love.graphics.polygon( mode, vertices )

mode	DrawMode	Bestimmt wie das Polygon gezeichnet werden soll.
vertices	table	Die Vertices des Polygons in einem Table.

love.graphics.pop

Zieht die aktuelle Koordinatentransformation aus dem Transformationsstapel.

Diese Funktion wird immer verwendet, um einen vorherigen Push-Vorgang umzukehren. Es gibt den aktuellen Transformationszustand an das, was es vor dem letzten vorhergehenden Push war. Ein Beispiel finden Sie in der Beschreibung von love.graphics.push.

love.graphics.pop()

love.graphics.present

Zeigt das Ergebnis der bisherigen Zeichenoperationen auf dem Bildschirm.

Diese Funktion wird nur relevant, wenn man eine benutzerdefinierte love.run-Funktion schreiben möchte. Sie präsentiert das Ergebnis aller Zeichenoperationen auf dem Bildschirm. Ein Beispiel zur Verwendung dieser Funktion findet sich in der vorgegebenen love.run-Funktion.

love.graphics.present()

love.graphics.print

Zeichnet einen Text auf den Bildschirm. Wenn kein Font spezifiziert ist, wird ein Standard-Font erstellt und verwendet.

Verschiebungen und Skalierungen des Koordinatensystems, werden seit LÖVE 0.7.1 beim Zeichnen des Textes berücksichtigt. Dies sollte man beachten, da es sonst vorkommen kann, dass der Text an der falschen Stelle oder gar nicht auf dem Bildschirm gezeichnet wird.

Sowohl love.graphics.print als auch love.graphics.printf unterstützen beide UTF-8 Encoding. Für Spezialcharaktere wird ein passender Font benötigt.

love.graphics.print( text, x, y, r, sx, sy, ox, oy, kx, ky )

text	string	Der Text der gezeichnet werden soll.
x	number	Die x-Position an der gezeichnet werden soll.
y	number	Die y-Position an der gezeichnet werden soll.
r (0)	number	Die Ausrichtung in Radianten.
sx (1)	number	Skalierungsfaktor (x-Achse).
sy (sx)	number	Skalierungsfaktor (y-Achse).
ox (0)	number	Ursprungsverschiebung (x-Achse).
oy (0)	number	Ursprungsverschiebung (y-Achse).
kx (0)	number	Scherungsfaktor (x-Achse).
ky (0)	number	Scherungsfaktor (y-Achse).

love.graphics.print( coloredtext, x, y, angle, sx, sy, ox, oy, kx, ky )

coloredtext	table	Eine Tabelle mit Farben und Strings, um das Objekt hinzuzufügen, in Form von {color1, string1, color2, string2, ...}.
coloredtext.color1	table	Eine Tabelle mit roten, grünen, blauen und optionalen Alpha-Komponenten, die als Farbe für den nächsten String in der Tabelle verwendet werden sollen, in Form von {rot, grün, blau, alpha}.
coloredtext.string1	string	Eine Zeichenfolge, die eine von der vorherigen Farbe angegebene Farbe hat.
coloredtext.color2	table	Eine Tabelle mit roten, grünen, blauen und optionalen Alpha-Komponenten, die als Farbe für den nächsten String in der Tabelle verwendet werden sollen, in Form von {rot, grün, blau, alpha}.
coloredtext.string2	string	Eine Zeichenfolge, die eine von der vorherigen Farbe angegebene Farbe hat.
coloredtext....	tables and strings	Zusätzliche Farben und Saiten.
x	number	Die Position des neuen Textes auf der x-Achse.
y	number	Die Position des neuen Textes auf der y-Achse.
angle (0)	number	Die Orientierung des Objekts im Bogenmaß.
sx (1)	number	Skalenfaktor auf der x-Achse.
sy (sx)	number	Skalenfaktor auf der y-Achse.
ox (0)	number	Ursprungsversatz auf der x-Achse.
oy (0)	number	Origin-Offset auf der y-Achse.
kx (0)	number	Scher- / Schrägfaktor auf der x-Achse.
ky (0)	number	Scher- / Schrägfaktor auf der y-Achse.

love.graphics.printf

Zeichnet formatierten Text mit Zeilenumbrüchen und Textausrichtung.

love.graphics.printf( text, x, y, limit, align, r, sx, sy, ox, oy, kx, ky )

text	string	Ein String.
x	number	Die Position auf der x-Achse.
y	number	Die Position auf der y-Achse.
limit	number	Bestimmt nach wievielen Pixeln die Zeile umgebrochen werden soll.
align ("left")	AlignMode	Der Modus zur Ausrichtung des Strings.
r (0)	number	Ausrichtung (Radianten).
sx (1)	number	Skalierungsfaktor (x-Achse).
sy (sx)	number	Skalierungsfaktor (y-Achse).
ox (0)	number	Verschiebung des Ursprungs in Pixeln (x-Achse).
oy (0)	number	Verschiebung des Ursprungs in Pixeln (y-Achse).
kx (0)	number	Scherfaktor (x-Achse).
ky (0)	number	Scherfaktor (y-Achse).

love.graphics.printf( coloredtext, x, y, wraplimit, align, angle, sx, sy, ox, oy, kx, ky )

coloredtext	table	Eine Tabelle mit Farben und Strings, um das Objekt hinzuzufügen, in Form von {color1, string1, color2, string2, ...}.
coloredtext.color1	table	Eine Tabelle mit roten, grünen, blauen und optionalen Alpha-Komponenten, die als Farbe für den nächsten String in der Tabelle verwendet werden sollen, in Form von {rot, grün, blau, alpha}.
coloredtext.string1	string	Eine Zeichenfolge, die eine von der vorherigen Farbe angegebene Farbe hat.
coloredtext.color2	table	Eine Tabelle mit roten, grünen, blauen und optionalen Alpha-Komponenten, die als Farbe für den nächsten String in der Tabelle verwendet werden sollen, in Form von {rot, grün, blau, alpha}.
coloredtext.string2	string	Eine Zeichenfolge, die eine von der vorherigen Farbe angegebene Farbe hat.
coloredtext....	tables and strings	Zusätzliche Farben und Saiten.
x	number	Die Position des neuen Textes auf der x-Achse.
y	number	Die Position des neuen Textes auf der y-Achse.
wraplimit	number	Die maximale Breite in Pixeln des Textes, bevor er automatisch in eine neue Zeile eingehüllt wird.
align	AlignMode	Die Ausrichtung des Textes.
angle (0)	number	Die Orientierung des Objekts im Bogenmaß.
sx (1)	number	Skalenfaktor auf der x-Achse.
sy (sx)	number	Skalenfaktor auf der y-Achse.
ox (0)	number	Ursprungsversatz auf der x-Achse.
oy (0)	number	Origin-Offset auf der y-Achse.
kx (0)	number	Scher- / Schrägfaktor auf der x-Achse.
ky (0)	number	Scher- / Schrägfaktor auf der y-Achse.

love.graphics.push

Kopiert und schiebt die aktuelle Koordinatentransformation in den Transformationsstapel.

Diese Funktion wird immer verwendet, um eine entsprechende Pop-Operation später vorzubereiten. Es speichert den aktuellen Koordinatentransformationszustand in den Transformationsstapel und hält ihn aktiv. Spätere Änderungen an der Transformation können rückgängig gemacht werden, indem die Pop-Operation verwendet wird, die die Koordinaten-Transformation in den Zustand zurückgibt, in dem sie sich vor dem Aufruf von Push war.

love.graphics.push( stack )

stack ("transform")

StackType

Die Art des Stapels zu drücken (z. B. nur Transformation Zustand, oder alle love.graphics Zustand).

love.graphics.rectangle

Zeichnet ein Rechteck.

love.graphics.rectangle( mode, x, y, width, height, rx, ry, segments )

Zeichnet ein Rechteck mit abgerundeten Ecken.

mode	DrawMode	Wie zeichne das Rechteck.
x	number	Die Position der oberen linken Ecke entlang der x-Achse.
y	number	Die Position der oberen linken Ecke entlang der y-Achse.
width	number	Breite des Rechtecks
height	number	Höhe des Rechtecks
rx (0)	number	Der x-Achsen-Radius jeder runden Ecke. Kann nicht größer sein als die Hälfte des Rechtecks.
ry (rx)	number	Der y-Achsenradius jeder runden Ecke. Kann nicht größer sein als die Hälfte des Rechtecks.
segments (based on size)	number	Die Anzahl der Segmente, die zum Zeichnen der runden Ecken verwendet wurden.

love.graphics.reset

Setzt die aktuellen Grafikeinstellungen zurück.

Das Aufrufen von Reset macht die aktuelle Zeichnungsfarbe weiß, die aktuelle Hintergrundfarbe schwarz, setzt alle aktiven Canvas oder Shader zurück und entfernt alle Schereneinstellungen. Es setzt den BlendMode auf alpha. Es setzt auch die Punkt- und Linienzeichnungsmodi zu glätten und ihre Größen auf 1,0.

love.graphics.reset()

love.graphics.rotate

Dreht das Koordinatensystem in zwei Dimensionen.

Das Aufrufen dieser Funktion wirkt sich auf alle zukünftigen Zeichnungsvorgänge aus, indem das Koordinatensystem um den Ursprung um die vorgegebene Anzahl von Bogenmaß gedreht wird. Diese Änderung dauert, bis love.draw ausgibt.

love.graphics.rotate( angle )

angle

number

Die Menge, um das Koordinatensystem im Bogenmaß zu drehen.

love.graphics.scale

Skaliert das Koordinatensystem in zwei Dimensionen.

Das Koordinatensystem in LÖVE entspricht standardmäßig den Anzeigepixeln in horizontaler und vertikaler Richtung eins zu eins und die x-Achse nimmt nach rechts zu, während die y-Achse nach unten zunimmt. Das Skalieren des Koordinatensystems ändert diese Relation.

Nach der Skalierung von sx und sy werden alle Koordinaten so behandelt, als ob sie mit sx und sy multipliziert würden. Jedes Ergebnis eines Zeichnungsvorgangs wird ebenfalls entsprechend skaliert, so dass die Skalierung durch (2, 2) zum Beispiel alles, was doppelt so groß ist, sowohl in x- als auch in y-Richtungen bedeutet. Die Skalierung durch einen negativen Wert umwandelt das Koordinatensystem in die entsprechende Richtung, was bedeutet, dass alles gezeichnet wird, umgedreht oder umgekehrt oder beides. Skalierung durch Null ist keine nützliche Operation.

Maßstab und übersetzen sind keine kommutativen Operationen, daher rufen sie in verschiedenen Aufträgen wird das Ergebnis ändern.

Skalierung dauert, bis love.draw beendet ist.

love.graphics.scale( sx, sy )

sx	number	Die Skalierung in Richtung der x-Achse.
sy (sx)	number	Die Skalierung in Richtung der y-Achse. Wenn es weggelassen wird, wird es standardmäßig auf den Parameter sx gesetzt.

love.graphics.setBackgroundColor

Bestimmt die Hintergrundfarbe.

love.graphics.setBackgroundColor( r, g, b, a )

r	number	Der rote Farbanteil (0-255).
g	number	Der grüne Farbanteil (0-255).
b	number	Der blaue Farbanteil (0-255).
a (255)	number	Die Transparenz (0-255).

love.graphics.setBackgroundColor( rgba )

rgba

table

Ein numerisch indizierter Table mit drei Nummern welche die roten, grünen und blauen Farbanteile sowie die Transparenz der Farbe bestimmen.

love.graphics.setBlendMode

Setzt den Mischmodus.

love.graphics.setBlendMode( mode, alphamode )

mode	BlendMode	Der Mischmodus zu verwenden.
alphamode ("alphamultiply")	BlendAlphaMode	Was mit dem Alpha von gezeichneten Objekten beim Mischen zu tun ist.

love.graphics.setCanvas

Bestimmt ein neues Renderziel.

love.graphics.setCanvas( canvas )

Alle Zeichenoperationen, welche nach love.graphics.setCanvas ausgeführt werden, erscheinen nicht auf dem Bildschirm sondern werden auf das Canvas umgeleitet.

canvas

Canvas

Das neue Renderziel.

love.graphics.setCanvas()

Setzt das Renderziel zurück. Alle Zeichenoperationen werden nun wieder direkt auf den Bildschirm gezeichnet.

love.graphics.setCanvas( canvas1, canvas2, ... )

Bestimmt gleichzeitig mehrere Offscreen-Buffer als Renderziele.

Normalerweise würde auf all diese Buff der gleiche Inhalt geschrieben werden. Dies kann sich jedoch ändern, wenn sogenannte pixel shader eingesetzt werden.

Die Canvas Argumente müssen alle die gleiche Breite und Höhe, sowie den gleichen TextureMode haben. Nicht alle Computer unterstützen multiple Renderziele. Dies kann per love.graphics.isSupported überprüft werden.

canvas1	Canvas	Das erste Renderziel.
canvas2	Canvas	Das zweite Renderziel.
...	Canvas	Weitere Ziele.

love.graphics.setColor

Legt die für das Zeichnen verwendete Farbe fest.

love.graphics.setColor( red, green, blue, alpha )

red	number	Die Menge an Rot.
green	number	Die Menge an Grün.
blue	number	Die Menge an Blau.
alpha	number	Die Menge an Alpha. Der Alpha-Wert wird auf alle nachfolgenden Zeichnungsoperationen angewendet, auch die Zeichnung eines Bildes.

love.graphics.setColor( rgba )

rgba

table

Eine numerisch indizierte Tabelle mit den roten, grünen, blauen und alpha-Werten als Zahlen. Das Alpha ist optional und standardmäßig auf 255, wenn es ausgelassen wird.

love.graphics.setColorMask

Setzt die Farbmaske. Aktiviert oder deaktiviert bestimmte Farbkomponenten beim Rendern und Löschen des Bildschirms. Wenn z. B. rot auf false gesetzt ist, werden keine weiteren Änderungen an der roten Komponente aller Pixel vorgenommen.

Ermöglicht alle Farbkomponenten, wenn sie ohne Argumente aufgerufen werden.

love.graphics.setColorMask( red, green, blue, alpha )

Ermöglicht Farbmaskierung für die angegebenen Farbkomponenten.

red	boolean	Render-Rot-Komponente.
green	boolean	Render grüne Komponente.
blue	boolean	Render blaue Komponente.
alpha	boolean	Alpha-Komponente abgeben.

love.graphics.setColorMask()

Deaktiviert Farbmaskierung.

- 1.760

Legt die Standard - Skalierungsfilter verwendet mit Images, Canvases und Fonts.

Diese Funktion gilt nicht rückwirkend auf geladene Bilder.

love.graphics.setDefaultFilter

Legt die Standard-Skalierungsfilter fest, die mit Bildern, Leinwänden und Schriftarten verwendet werden.

Diese Funktion gilt nicht rückwirkend für geladene Bilder.

love.graphics.setDefaultFilter( min, mag, anisotropy )

min	FilterMode	Filtermodus, der beim Skalieren des Bildes verwendet wird.
mag (min)	FilterMode	Filtermodus, der beim Skalieren des Bildes verwendet wird.
anisotropy (1)	number	Maximale Menge an anisotroper Filterung verwendet.

love.graphics.setFont

Setzen Sie eine bereits geladene Schriftart als die aktuelle Schriftart oder erstellen Sie eine neue aus der Datei und Größe.

Es wird empfohlen, dass Font-Objekte mit love.graphics.newFont in der Ladephase erstellt und dann in der Zeichnungsphase an diese Funktion übergeben werden.

love.graphics.setFont( font )

font

love.graphics.setLineJoin

Das zu verwendende Font-Objekt.

Setzt den Linienverknüpfungsstil.

love.graphics.setLineJoin( join )

join

LineJoin

Das LineJoin zu benutzen.

love.graphics.setLineStyle

Bestimmt den Stil in dem Linien gezeichnet werden.

love.graphics.setLineStyle( style )

style

LineStyle

Der Linienstil welcher benutzt werden soll.

love.graphics.setLineWidth

Bestimmt die Breite mit der Linien gezeichnet werden sollen.

love.graphics.setLineWidth( width )

width

number

Die Breite der Linie.

love.graphics.setNewFont

Erstellt und setzt eine neue Schriftart.

font = love.graphics.setNewFont( filename, size )

font	Font	Die neue Schriftart.
filename	string / File / FileData	Der Dateipfad / Datei / FileData der Schriftart.
size (12)	number	Die Größe der Schriftart.

love.graphics.setShader

Setzt oder setzt einen Shader als den aktuellen Pixeleffekt oder die Vertex-Shader zurück. Alle Zeichnungsoperationen bis zum nächsten love.graphics.setShader werden mit dem angegebenen Shader-Objekt gezeichnet.

Deaktiviert die Shader, wenn sie ohne Argumente aufgerufen werden.

love.graphics.setShader()

love.graphics.setShader( shader )

shader

Shader

Der neue Shader.

love.graphics.setPointSize

Bestimmt die Größe mit welcher Punkte gezeichnet werden.

love.graphics.setPointSize( size )

size

number

Die neue Größe.

love.graphics.setScissor

Setzt oder deaktiviert Schere.

Die Schere begrenzt den Zeichenbereich auf ein bestimmtes Rechteck. Dies betrifft alle grafischen Anrufe, einschließlich love.graphics.clear.

love.graphics.setScissor( x, y, width, height )

Limits the drawing area to a specified rectangle.

x	number	Die X-Koordinate der oberen linken Ecke.
y	number	Die Y-Koordinate der oberen linken Ecke.
width	number	Die Breite des Clipping-Rechtecks.
height	number	Die Höhe des Clipping-Rechtecks.

love.graphics.setScissor()

Sperrt Schere.

love.graphics.setStencilTest

Konfiguriert oder deaktiviert die Schablonentests.

Wenn die Schablonentests aktiviert sind, wird die Geometrie von allem, was danach gezeichnet wird, auf der Grundlage eines Vergleichs zwischen den Argumenten dieser Funktion und dem Schablonenwert jedes Pixels, das die Geometrie berührt, abgeschnitten / geschert. Die Schablonenwerte von Pixeln werden über love.graphics.stencil beeinflusst.

Jeder Canvas hat seine eigenen Per-Pixel-Schablonenwerte.

love.graphics.setStencilTest( comparemode, comparevalue )

comparemode	CompareMode	Die Art des Vergleichs für jedes Pixel zu machen.
comparevalue	number	Der Wert, der beim Vergleich mit dem Schablonenwert jedes Pixels verwendet werden soll. Muss zwischen 0 und 255 liegen.

love.graphics.setStencilTest()

Schablone Tests deaktiviert.

love.graphics.setWireframe

Legt fest, ob Drahtgitterlinien beim Zeichnen verwendet werden.

Wireframe-Modus sollte nur zum Debuggen verwendet werden. Die Zeilen, die mit ihm gezeichnet wurden, verhalten sich nicht wie normale love.graphics Linien: ihre Breiten skalieren nicht mit den Koordinatentransformationen oder mit love.graphics.setLineWidth, und sie verwenden nicht die glatte LineStyle.

love.graphics.setWireframe( enable )

enable

boolean

True, um den Wireframe-Modus beim Zeichnen zu aktivieren, false, um ihn zu deaktivieren.

love.graphics.shear

Schneidet das Koordinatensystem.

love.graphics.shear( kx, ky )

kx	number	Der Scherfaktor auf der x-Achse.
ky	number	Der Scherfaktor auf der y-Achse.

love.graphics.stencil

Zeichnet die Geometrie als Schablone.

Die Geometrie, die von der mitgelieferten Funktion gezeichnet wird, setzt unsichtbare Schablonenwerte von Pixeln ein, anstatt Pixelfarben einzustellen. Die Schablonenwerte von Pixeln können wie eine Maske / Schablone fungieren - love.graphics.setStencilTest kann danach verwendet werden, um zu bestimmen, wie das weitere Rendering von den Schablonenwerten in jedem Pixel beeinflusst wird.

Jeder Canvas hat seine eigenen Per-Pixel-Schablonenwerte. Schablonenwerte liegen im Bereich von {0, 255}.

love.graphics.stencil( stencilfunction, action, value, keepvalues )

stencilfunction	function	Funktion, die Geometrie zeichnet. Die Schablonenwerte von Pixeln und nicht die Farbe jedes Pixels werden von der Geometrie beeinflusst.
action ("replace")	StencilAction	So ändern Sie alle Schablonenwerte von Pixeln, die von dem, was in der Schablonenfunktion gezeichnet wird, berührt werden.
value (1)	number	Der neue Schablonenwert, der für Pixel verwendet werden soll, wenn die "ersetzen" Schablonenaktion verwendet wird. Hat keine Wirkung mit anderen Schablonenaktionen. Muss zwischen 0 und 255 liegen.
keepvalues (false)	boolean	Es ist wahr, alte Schablonenwerte von Pixeln zu bewahren, falsch, um den Schablonenwert jedes Pixels auf 0 zu setzen, bevor die Schablonenfunktion ausgeführt wird. love.graphics.clear wird auch alle Schablonenwerte neu einstellen.

love.graphics.translate

Übersetzt das Koordinatensystem in zwei Dimensionen.

Wenn diese Funktion mit zwei Ziffern dx und dy aufgerufen wird, wirken alle nachfolgenden Zeichnungsvorgänge so ein, als seien ihre x- und y-Koordinaten x + dx und y + dy.

Maßstab und übersetzen sind keine kommutativen Operationen, daher rufen sie in verschiedenen Aufträgen wird das Ergebnis ändern.

Diese Änderung dauert, bis love.graphics.clear aufgerufen wird (was heißt automatisch vor love.draw in der default love.run-Funktion) oder ein love.graphics.pop kehrt zu einem vorherigen Koordinatensystemzustand zurück.

Das Übersetzen mit ganzen Zahlen verhindert das Reißen / Verschwimmen von Bildern und Zeichensätzen nach dem Übersetzen.

love.graphics.translate( dx, dy )

dx	number	Die Übersetzung relativ zur x-Achse.
dy	number	Die Übersetzung relativ zur y-Achse.

AlignMode

center

Text mittig ausrichten.

left

Text links ausrichten.

right

Text rechts ausrichten.

justify

Text links oder rechts ausrichten.

ArcType

pie

Der Bogen ist wie ein Stück Kuchen gezeichnet, wobei der Bogenkreis mit dem Zentrum an seinen Endpunkten verbunden ist.

open

Die beiden Endpunkte des Bogenkreises sind nicht verbunden, wenn der Bogen als Linie gezeichnet wird. Behaves wie der "geschlossene" Bogen-Typ, wenn der Bogen im gefüllten Modus gezeichnet wird.

closed

Die beiden Endpunkte des Bogenkreises sind miteinander verbunden.

AreaSpreadDistribution

uniform

Uniforme Distribution.

normal

Normale (gauß'sche) Distribution.

ellipse

Einheitliche Verteilung in einer Ellipse.

none

Keine Distribution - Die Verteilung von Partikeln ist deaktiviert.

BlendAlphaMode

alphamultiply

Die RGB-Werte von dem, was gezeichnet wird, werden mit den Alpha-Werten dieser Farben beim Mischen multipliziert. Dies ist der Standard-Alpha-Modus.

premultiplied

Die RGB-Werte von dem, was gezeichnet wird, werden nicht mit den Alpha-Werten dieser Farben beim Mischen multipliziert. Für die meisten Blend-Modi, die mit diesem Alpha-Modus korrekt arbeiten, müssen die Farben eines gezeichneten Objekts ihre RGB-Werte mit ihren Alpha-Werten an einem gewissen Punkt ("premultiplied alpha") multipliziert haben.

BlendMode

alpha

Alpha-Modus ('normal').

replace

Ersetzender Modus.

screen

Bildschirm-Modus.

add

Die Pixelfarben von dem, was gezeichnet wird, werden den Pixelfarben hinzugefügt, die bereits auf dem Bildschirm sind. Das Alpha des Bildschirms wird nicht geändert.

subtract

Die Pixelfarben von dem, was gezeichnet wird, werden von den bereits auf dem Bildschirm befindlichen Pixelfarben subtrahiert. Das Alpha des Bildschirms wird nicht geändert.

multiply

Die Pixelfarben von dem, was gezeichnet wird, werden mit den Pixelfarben auf dem Bildschirm multipliziert (verdunkeln sie). Das Alpha der gezeichneten Objekte wird mit dem Alpha des Bildschirms multipliziert, anstatt zu bestimmen, wieviel die Farben auf dem Bildschirm betroffen sind, auch wenn der "Alphamultiply" BlendAlphaMode verwendet wird.

lighten

Die Pixelfarben von dem, was gezeichnet wird, werden mit den vorhandenen Pixelfarben verglichen, und der größere der beiden Werte für jede Farbkomponente wird verwendet. Funktioniert nur, wenn der "premultiplied" BlendAlphaMode in love.graphics.setBlendMode verwendet wird.

darken

Die Pixelfarben von dem, was gezeichnet wird, werden mit den vorhandenen Pixelfarben verglichen, und der kleinere der beiden Werte für jede Farbkomponente wird verwendet. Funktioniert nur, wenn der "premultiplied" BlendAlphaMode in love.graphics.setBlendMode verwendet wird.

CanvasFormat

normal

Das Standard-Canvas-Format - in der Regel ein Alias für das rgba8-Format oder das srgb-Format, wenn das Gamma-korrekte Rendering in LÖVE 0.10.0 und neuer aktiviert ist.

hdr

Ein Format, das für einen hohen Dynamikbereich geeignet ist - ein Alias für das rgba16f-Format, normalerweise.

rgba8

8 Bits pro Kanal (32 bpp) RGBA. Farbkanalwerte reichen von 0-255 (0-1 bei Shader).

rgba4

4 Bits pro Kanal (16 bpp) RGBA.

rgb5a1

RGB mit jeweils 5 Bits und einem 1-Bit-Alphakanal (16 bpp).

rgb565

RGB mit jeweils 5, 6 und 5 Bits (16 bpp). In diesem Format gibt es keinen Alphakanal.

rgb10a2

RGB mit 10 Bits pro Kanal und einem 2-Bit-Alphakanal (32 bpp).

rgba16f

Fließkomma RGBA mit 16 Bits pro Kanal (64 bpp). Farbwerte können von {-65504, +65504} reichen.

rgba32f

Fließkomma RGBA mit 32 Bits pro Kanal (128 bpp).

rg11b10f

Gleitpunkt RGB mit 11 Bits in den roten und grünen Kanälen und 10 Bits im blauen Kanal (32 bpp). Es gibt keinen Alphakanal. Farbwerte können von {0, +65024} reichen.

srgb

Das gleiche wie rgba8, aber das Canvas wird als im sRGB-Farbraum interpretiert. Alles, was auf die Leinwand gezogen wird, wird von linearem RGB zu sRGB umgewandelt. Wenn das Canvas gezeichnet wird (oder in einem Shader verwendet wird), wird es von sRGB zu linearem RGB decodiert. Dies reduziert die Farbbanding bei der gamma-korrekten Wiedergabe, da die sRGB-Codierung mehr Präzision als lineare RGB für dunklere Farben hat.

Einkanaliges (rotes) Format (8 bpp).

rg8

Zwei Kanäle (rote und grüne Komponenten) mit 8 Bits pro Kanal (16 bpp).

r16f

Gleitkomma-Einkanalformat (16 bpp). Farbwerte können von {-65504, +65504} reichen.

rg16f

Gleitkomma-Zweikanal-Format mit 16 Bits pro Kanal (32 bpp). Farbwerte können von {-65504, +65504} reichen.

r32f

Gleitkomma-Einkanal-Format (32 bpp).

rg32f

Gleitkomma-Zweikanalformat mit 32 Bits pro Kanal (64 bpp).

CompareMode

equal

Der Schablonenwert des Pixels muss gleich dem gelieferten Wert sein.

notequal

Der Schablonenwert des Pixels darf nicht gleich dem gelieferten Wert sein.

less

Der Schablonenwert des Pixels muss kleiner sein als der angegebene Wert.

lequal

Der Schablonenwert des Pixels muss kleiner oder gleich dem gelieferten Wert sein.

gequal

Der Schablonenwert des Pixels muss größer oder gleich dem zugeführten Wert sein.

greater

Der Schablonenwert des Pixels muss größer sein als der angegebene Wert.

DrawMode

fill

Die Form ausfüllen.

line

Die Form als Umriss darstellen.

FilterMode

linear

Das Bild wird mit Linearer Interpolation skaliert.

nearest

Das Bild wird mit Nearest-Neighbor-Interpolation skaliert.

GraphicsFeature

clampzero

Ob der "clampzero" WrapMode unterstützt wird.

lighten

Ob die "Aufhellen" und "Dunkeln" BlendModes unterstützt werden.

multicanvasformats

Ob mehrere Canvases mit unterschiedlichen Formaten in demselben love.graphics.setCanvas-Aufruf verwendet werden können.

GraphicsLimit

pointsize

Die maximale Größe der Punkte.

texturesize

Die maximale Breite oder Höhe von Bildern und Leinwänden.

multicanvas

Die maximale Anzahl der gleichzeitig aktiven Leinwände (via love.graphics.setCanvas).

canvasmsaa

Die maximale Anzahl von Antialiasing-Samples für eine Leinwand.

LineJoin

miter

Die Enden der Liniensegmente sind schräg abgeschrägt, so dass sie sich nahtlos verbinden.

bevel

Keine Kappe auf die Enden der Liniensegmente angewendet.

none

Abflacht den Punkt, an dem sich Liniensegmente verbinden.

LineStyle

rough

Grobe Linien zeichnen.

smooth

Glatte Linien zeichnen.

MeshDrawMode

fan

Die Eckpunkte erzeugen eine "Fan" -Form, wobei der erste Eckpunkt als Hubpunkt fungiert. Kann leicht verwendet werden, um einfache konvexe Polygone zu zeichnen.

strip

Die Ecken bilden eine Reihe von verbundenen Dreiecken unter Verwendung der Ecken 1, 2, 3, dann 3, 2, 4 (beachten Sie die Reihenfolge), dann 3, 4, 5 und so weiter.

triangles

Die Ecken schaffen unverbundene Dreiecke.

points

Die Ecken werden als unverbundene Punkte gezeichnet (siehe love.graphics.setPointSize.)

ParticleInsertMode

top

Partikel werden an oberster Stelle auf die Liste der Partikel gesetzt.

bottom

Partikel werden an unterster Stelle auf die Liste der Partikel gesetzt.

random

Partikel werden an einer zufälligen Stelle in die Liste der Partikel eingefügt.

SpriteBatchUsage

dynamic

Der SpriteBatch wird sich mehrfach verändern.

static

Der SpriteBatch wird sich nicht verändern.

stream

Der SpriteBatch wird sich zwischen jedem Frame verändern.

StackType

transform

Der Transformationsstapel (love.graphics.translate, love.graphics.rotate, etc.)

all

Alle love.graphics Zustand, einschließlich Transformation Zustand.

StencilAction

replace

Der Schablonenwert eines Pixels wird durch den in love.graphics.stencil angegebenen Wert ersetzt, falls ein Objekt das Pixel berührt.

increment

Der Schablonenwert eines Pixels wird für jedes Objekt, das das Pixel berührt, um 1 erhöht. Wenn der Schablonenwert 255 erreicht, bleibt er bei 255.

decrement

Der Schablonenwert eines Pixels wird für jedes Objekt, das das Pixel berührt, um 1 dekrementiert. Wenn der Schablonenwert 0 erreicht, bleibt er bei 0.

incrementwrap

Der Schablonenwert eines Pixels wird für jedes Objekt, das das Pixel berührt, um 1 erhöht. Wenn ein Schablonenwert von 255 inkrementiert wird, wird er auf 0 gesetzt.

decrementwrap

Der Schablonenwert eines Pixels wird für jedes Objekt, das das Pixel berührt, um 1 dekrementiert. Wenn der Schablonenwert von 0 dekrementiert wird, wird er auf 255 gesetzt.

invert

Der Schablonenwert eines Pixels wird für jedes Objekt, das das Pixel berührt, bitweise invertiert. Wenn ein Schablonenwert von 0 invertiert wird, wird er 255.

WrapMode

clamp

Wie das Bild in einem Quad mit einer größeren Quad Größe als Bildgröße verpackt. Dies wirkt sich auch darauf aus, wie Meshes mit Texturkoordinaten, die außerhalb des Bereichs von {0, 1} liegen, gezeichnet werden und die von der Texel Shader-Funktion zurückgegebene Farbe bei der Verwendung von Texturkoordinaten außerhalb des Bereichs von {0, 1} verwendet wird.

repeat

Wiederholen Sie das Bild. Füllt das gesamte verfügbare Ausmaß.

mirroredrepeat

Wiederholen Sie die Textur und spiegeln sie jedes Mal, wenn es wiederholt. Kann bessere visuelle Ergebnisse erzielen als der Wiederholungsmodus, wenn die Textur nicht nahtlos kachelt.

clampzero

Klemme die Textur. Füllt den Bereich außerhalb des Normalbereichs der Textur mit transparentem schwarzem (oder opakem Schwarz für Texturen ohne Alphakanal).

Canvas

Ein Offscreen-Buffer welcher für das sogenannte "Off-screen Rendering" verwendet wird.

Ein Offscreen-Buffer ist ein Speicher, in dem Bildschirminhalt aufgebaut werden kann ohne diesen sofort dem Nutzer zu zeigen. Der gleichbedeutende Begriff "Canvas" (dt.: Leinwand) ist treffend gewählt. Vorstellen kann man sich das Ganze als Arbeitsfläche auf der man abseits des eigentlichen Bildschirminhalts den nächsten Inhalt vorbereiten kann. Ist diese Leinwand schließlich fertig bemalt, schickt man sie komplett an den Bildschirm.

Der Vorteil ist, dass man komplexe statische Szenen wie zum Beispiel Hintergründe, welche sich aus vielen einzelnen Bildern zusammensetzen zunächst in den Offscreen-Buffer schreiben und diesen dann schließlich komplett als eigene Einheit zeichnen kann. Das bedeutet, dass man anstatt vieler kleiner Zeichenoperationen nur noch eine einzige durchführen muss, was insbesondere die Performance deutlich positiv beeinflusst.

Ein Nachteil von Canvases ist, dass sie anfällig für das sogenannte power of 2 syndrome sind. Dies betrifft jedoch vor allem ältere Grafikkarten. Die meisten moderneren Grafikkarten, welche Offscreen-Buffer unterstützen, sollten auch non-PO2 Texturen unterstützen. Um sicher zu gehen, kann man dies aber auch mit love.graphics.isSupported("npot") überprüfen und den Nutzer gegebenenfalls mit einer Fehlermeldung informieren.

Constructors

love.graphics.newCanvas Erstellt einen neuen Offscreen-Buffer.

Functions

Canvas:getFormat Ruft das Texturformat der Leinwand ab.

Canvas:getMSAA Ruft die Anzahl der Multisample Antialiasing (MSAA) Samples ab, die beim Zeichnen auf die Leinwand verwendet werden.

Canvas:get/setFilter Bestimmt den Filtermodus für ein Canvas.

Canvas:get/setWrap Legt die Wrapping-Eigenschaften eines Canvas fest.

Canvas:newImageData Generiert ImageData aus dem Inhalt der Leinwand.

Canvas:renderTo Zeichnet mit Hilfe einer Funktion in einen Offscreen-Buffer.

Canvas:getDimensions Gibt die Breite und Höhe des Canvas zurück.

Canvas:getWidth Gibt die Breite des Canvas zurück.

Canvas:getHeight Gibt die Höhe des Canvas zurück.

Supertypes

Object Die Superklasse aller LÖVE-Typen.

Drawable Die Superklasse für alle Dinge, die auf den Bildschirm gezeichnet werden können.

Texture Die Superklasse für alle zeichenbaren Objekte welche eine Textur repräsentieren.

Canvas:getDimensions

Gibt die Breite und Höhe des Canvas zurück.

width, height = Canvas:getDimensions()

width	number	Die Breite des Canvas in Pixeln.
height	number	Die Höhe des Canvas in Pixeln.

Canvas:getFilter

Gibt den Filtermodus des Canvas zurück.

min, mag, anisotropy = Canvas:getFilter()

min	FilterMode	Der Filter welcher beim Verkleinern des Canvas benutzt wird.
mag	FilterMode	Der Filter welcher beim Vergrößern des Canvas benutzt wird.
anisotropy	number	Der Maximalwert welcher zum anisotropen Filtern benutzt wird.

Canvas:getFormat

Ruft das Texturformat der Leinwand ab.

format = Canvas:getFormat()

format

CanvasFormat

Das Format der Leinwand.

Canvas:getHeight

Gibt die Höhe des Canvas zurück.

height = Canvas:getHeight()

height

number

Die Höhe des Canvas in Pixeln.

Canvas:getMSAA

Ruft die Anzahl der Multisample Antialiasing (MSAA) Samples ab, die beim Zeichnen auf die Leinwand verwendet werden.

Dies kann anders sein als die Nummer, die als Argument für love.graphics.newCanvas verwendet wird, wenn das System, das LÖVE läuft, diese Nummer nicht unterstützt.

samples = Canvas:getMSAA()

samples

number

Die Anzahl der Multisample-Antialiasing-Samples, die von der Leinwand beim Zeichnen verwendet werden.

Canvas:getWidth

Gibt die Breite des Canvas zurück.

width = Canvas:getWidth()

width

number

Die Breite des Canvas in Pixeln.

Canvas:getWrap

Gibt die Zeilenumbrucheigenschaften eines Canvas zurück.

Diese Funktion gibt die aktuellen horizontalen und vertikalen Zeilenumbruch-Modi für ein Canvas zurück.

horizontal, vertical = Canvas:getWrap()

horizontal	WrapMode	Der horizontale Zeilenumbruchmodus des Canvas.
vertical	WrapMode	Der vertikale Zeilenumbruchmodus des Canvas.

Canvas:newImageData

Generiert ImageData aus dem Inhalt der Leinwand.

data = Canvas:newImageData()

data

ImageData

Die im Canvas gespeicherten Bilddaten.

data = Canvas:newImageData( x, y, width, height )

data	ImageData	Die neue ImageData aus dem Canvas-Inhalt.
x	number	Die x-Achse der oberen linken Ecke des Bereichs innerhalb der Leinwand zu erfassen.
y	number	Die y-Achse der oberen linken Ecke des Bereichs innerhalb der Leinwand zu erfassen.
width	number	Die Breite des Bereichs innerhalb der Leinwand zu erfassen.
height	number	Die Höhe des Bereichs innerhalb der Leinwand zu erfassen.

Canvas:renderTo

Zeichnet mit Hilfe einer Funktion in einen Offscreen-Buffer.

Canvas:renderTo( func )

func

function

Eine Funktion welche die erforderlichen Zeichenoperationen übernimmt.

Canvas:setFilter

Bestimmt den Filtermodus für ein Canvas.

Canvas:setFilter( min, mag, anisotropy )

min	FilterMode	Der Filter welcher beim Verkleinern des Canvas benutzt werden soll.
mag (min)	FilterMode	Der Filter welcher beim Vergrößern des Canvas benutzt werden soll.
anisotropy (1)	number	Der Maximalwert welcher zum anisotropen Filtern benutzt werden soll.

Canvas:setWrap

Legt die Wrapping-Eigenschaften eines Canvas fest.

Diese Funktion legt fest, wie die Kanten eines Canvas behandelt werden, wenn es skaliert oder gedreht wird. Wenn der WrapMode auf "clamp" gesetzt ist, wird die Flanke nicht interpoliert. Wenn auf "Wiederholung" eingestellt ist, wird die Flanke mit den Pixeln auf der gegenüberliegenden Seite des Framebuffers interpoliert.

Canvas:setWrap( horizontal, vertical )

horizontal	WrapMode	Horizontaler Wickelmodus der Leinwand.
vertical (horizontal)	WrapMode	Vertikaler Wickelmodus der Leinwand.

Definiert das Aussehen von Charakteren welche auf den Bildschirm gezeichnet werden.

Constructors

love.graphics.newFont Erstellt ein neues Font Objekt.

love.graphics.newImageFont Erstellt eine neue Schriftart, indem ein speziell formatiertes Bild geladen wird.

love.graphics.setNewFont Erstellt und setzt eine neue Schriftart.

Functions

Font:get/setFilter Setzt den Filtermodus auf eine Schriftart.

Font:hasGlyphs Ermittelt, ob die Schriftart ein bestimmtes Zeichen darstellen kann.

Font:setFallbacks Setzt die Fallback-Schriften.

Font:getWrap Ruft die Formatierungsinformationen für Text ab, bei einer Umschlaggrenze.

Font:get/setLineHeight Bestimmt die Zeilenhöhe des Font.

Font:getWidth Bestimmt die horizontale Größe einer Textzeile.

Font:getHeight Ruft die Höhe der Schriftart ab.

Font:getBaseline Ruft die Grundlinie der Schriftart ab.

Font:getAscent Ruft den Aufstieg der Schriftart auf.

Font:getDescent Ruft den Abstieg der Schriftart ab.

Supertypes

Object Die Superklasse aller LÖVE-Typen.

Font:getAscent

Ruft den Aufstieg der Schriftart auf. Der Aufstieg überspannt den Abstand zwischen der Grundlinie und der Oberseite der Glyphe, die am weitesten von der Grundlinie entfernt ist.

ascent = Font:getAscent()

ascent

number

Der Aufstieg der Schrift in Pixel.

Font:getBaseline

Ruft die Grundlinie der Schriftart ab. Die meisten Skripte teilen sich den Begriff einer Grundlinie: eine imaginäre horizontale Linie, auf der sich Zeichen befinden. In einigen Skripten liegen Teile von Glyphen unterhalb der Grundlinie.

baseline = Font:getBaseline()

baseline

number

Die Grundlinie der Schrift in Pixel.

Font:getDescent

Ruft den Abstieg der Schriftart ab. Der Abstieg überspannt den Abstand zwischen der Grundlinie und der tiefsten absteigenden Glyphe in einer Schrift.

descent = Font:getDescent()

descent

number

Der Abstieg der Schrift in Pixeln.

Font:getFilter

Ruft den Filtermodus für eine Schriftart ab.

min, mag, anisotropy = Font:getFilter()

min	FilterMode	Filtermodus, der beim Minifizieren der Schriftart verwendet wird.
mag	FilterMode	Filtermodus, der beim Vergrößern der Schriftart verwendet wird.
anisotropy	number	Maximale Menge an anisotroper Filterung.

Font:getHeight

Ruft die Höhe der Schriftart ab. Die Höhe der Schriftart ist die Größe einschließlich beliebiger Abstand; die Höhe, die es braucht.

height = Font:getHeight()

height

number

Die Höhe der Schrift in Pixel.

Font:getLineHeight

Gibt die Zeilenhöhe zurück.

Dies wird der Wert sein, welcher vorher mit Font:setLineHeight gesetzt wurde, ansonsten 1.0.

height = Font:getLineHeight()

height

number

Die aktuelle Zeilenhöhe.

Font:getWidth

Bestimmt die horizontale Größe einer Textzeile. Unterstützt keine Zeilenumbrüche.

width = Font:getWidth( line )

width	number	Die Breite der Linie.
line	string	Eine Textzeile.

Font:getWrap

Ruft die Formatierungsinformationen für Text ab, bei einer Umschlaggrenze.

Diese Funktion berücksichtigt die Zeilenumbrüche korrekt (d.h. \ n).

width, wrappedtext = Font:getWrap( text, wraplimit )

width	number	Die maximale Breite des eingewickelten Textes.
wrappedtext	table	Eine Sequenz, die jede Textzeile enthält, die eingepackt wurde.
text	string	Der Text, der eingepackt werden soll.
wraplimit	number	Die maximale Breite in Pixeln jeder Zeile, die Text vor dem Wrappen erlaubt ist.

Font:hasGlyphs

Ermittelt, ob die Schriftart ein bestimmtes Zeichen darstellen kann.

hasglyph = Font:hasGlyphs( character )

hasglyph	boolean	Ob die Schriftart die Glyphe durch das Zeichen darstellen kann.
character	string	Ein Unicode-Zeichen.

hasglyph = Font:hasGlyphs( codepoint )

hasglyph	boolean	Ob die Schriftart die Glyphe durch die Codepoint-Nummer darstellen kann.
codepoint	number	Eine Unicode-Codepoint-Nummer.

Font:setFallbacks

Setzt die Fallback-Schriften. Wenn die Schrift keine Glyphe enthält, ersetzt sie die Glyphe aus den nächsten nachfolgenden Fallback-Schriften. Dies ist verwandt mit der Einstellung eines "font stack" in Cascading Style Sheets (CSS).

Font:setFallbacks( fallbackfont1, ... )

fallbackfont1	Font	Die erste Fallback-Schriftart.
...	Font	Zusätzliche Fallback-Schriften.

Font:setFilter

Setzt den Filtermodus auf eine Schriftart.

Font:setFilter( min, mag, anisotropy )

min	FilterMode	Wie skaliere ich eine Schriftart.
mag (min)	FilterMode	Wie man eine Schriftart skaliert.
anisotropy (1)	number	Maximale Menge an anisotroper Filterung.

Font:setLineHeight

Bestimmt die Zeilenhöhe des Font.

Wenn der Font gerendert wird, wird die tatsächliche Höhe von der Zeilenhöhe multipliziert mit der Höhe des Font bestimmt.

Der Standardwert für die Zeilenhöhe ist 1.0.

Font:setLineHeight( height )

height

number

Die neue Zeilenhöhe.

Mesh

Ein zweidimensionales Polygonnetz zum Zeichnen von beliebig geformten Texturobjekten.

Constructors

love.graphics.newMesh Erstellt ein neues Mesh.

Functions

Mesh:attachAttribute Bringt ein Scheitelattribut von einem anderen Mesh auf dieses Mesh, für die Verwendung beim Zeichnen.

Mesh:getVertexCount Erhält die Gesamtzahl der Ecken im Mesh.

Mesh:getVertexFormat Ruft das Scheitelformat ab, mit dem das Mesh erstellt wurde.

Mesh:is/setAttributeEnabled Aktiviert oder deaktiviert ein bestimmtes Scheitelattribut im Mesh.

Mesh:get/setDrawMode Setzt den Modus, der beim Zeichnen des Mesh verwendet wird.

Mesh:get/setDrawRange Beschränkt die gezeichneten Ecken des Mesh auf eine Teilmenge der Summe.

Mesh:get/setTexture Legt die Textur (Bild oder Leinwand) fest, die beim Zeichnen des Netzes verwendet wird.

Mesh:get/setVertex Setzt die Eigenschaften eines Scheitelpunktes im Mesh.

Mesh:get/setVertexAttribute Setzt die Eigenschaften eines bestimmten Attributs innerhalb eines Scheitelpunktes im Mesh.

Mesh:get/setVertexMap Setzt die Scheitelkarte für das Mesh.

Mesh:setVertices Ersetzt eine Reihe von Ecken im Mesh mit neuen.

Supertypes

Drawable Die Superklasse für alle Dinge, die auf den Bildschirm gezeichnet werden können.

Object Die Superklasse aller LÖVE-Typen.

Mesh:attachAttribute

Bringt ein Scheitelattribut von einem anderen Mesh auf dieses Mesh, für die Verwendung beim Zeichnen. Dies kann verwendet werden, um Vertex-Attributdaten zwischen mehreren verschiedenen Meshes zu teilen.

Mesh:attachAttribute( name, mesh )

name	string	Der Name des Scheitelattributs zum Anhängen.
mesh	Mesh	Das Mesh, um das Scheitelattribut zu erhalten.

Mesh:getDrawMode

Ruft den Modus ab, der beim Zeichnen des Netzes verwendet wird.

mode = Mesh:getDrawMode()

mode

MeshDrawMode

Der Modus, der beim Zeichnen des Netzes verwendet wird.

Mesh:getDrawRange

Erhält den Bereich der Ecken, die beim Zeichnen des Netzes verwendet werden.

Wenn der Streckbereich des Mesh nicht zuvor mit Mesh: setDrawRange gesetzt wurde, wird diese Funktion nil zurückgeben.

min, max = Mesh:getDrawRange()

min	number	Der Index des ersten Scheitelpunktes, der beim Zeichnen verwendet wird, oder der Index des ersten Wertes in der Vertex-Map, der verwendet wird, wenn einer für dieses Mesh gesetzt ist.
max	number	Der Index des letzten Scheitelpunktes, der beim Zeichnen verwendet wird, oder der Index des letzten Wertes in der Vertex-Map, der verwendet wird, wenn einer für dieses Mesh gesetzt ist.

Mesh:getTexture

Erhält die Textur (Bild oder Leinwand), die beim Zeichnen des Netzes verwendet wird.

texture = Mesh:getTexture()

texture

Das Bild oder die Leinwand, um das Mesh mit dem Zeichnen zu beschriften, oder nil, wenn keines gesetzt ist.

Mesh:getVertex

Ruft die Eigenschaften eines Scheitelpunktes im Mesh ab.

attributecomponent, ... = Mesh:getVertex( index )

attributecomponent	number	Die erste Komponente des ersten Scheitelattributs im angegebenen Scheitelpunkt.
...	number	Zusätzliche Komponenten aller Scheitelattribute im angegebenen Scheitelpunkt.
index	number	Der Index des Scheitelpunktes, den du die Informationen abrufen möchtest.

x, y, u, v, r, g, b, a = Mesh:getVertex( index )

x	number	Die Position des Scheitelpunktes auf der x-Achse.
y	number	Die Position des Scheitelpunktes auf der y-Achse.
u	number	Die horizontale Komponente der Texturkoordinate.
v	number	Die vertikale Komponente der Texturkoordinate.
r	number	Die rote Komponente der Farbe des Scheitels.
g	number	Die grüne Komponente der Farbe des Scheitels.
b	number	Die blaue Komponente der Farbe des Scheitels.
a	number	Die Alpha-Komponente der Farbe des Scheitelpunktes.
index	number	Der Index des Scheitelpunktes, den du die Informationen abrufen möchtest.

Mesh:getVertexAttribute

Ruft die Eigenschaften eines bestimmten Attributs innerhalb eines Scheitelpunktes im Mesh ab.

Meshes ohne ein benutzerdefiniertes Scheitelformat, das in love.graphics.newMesh angegeben ist, haben Position als ihr erstes Attribut, Texturkoordinaten als ihr zweites Attribut und Farbe als ihr drittes Attribut.

value1, value2, ... = Mesh:getVertexAttribute( vertexindex, attributeindex )

value1	number	Der Wert der ersten Komponente des Attributs.
value2	number	Der Wert der zweiten Komponente des Attributs.
...	number	Alle zusätzlichen Scheitelattributkomponenten.
vertexindex	number	Der Index des zu modellen Scheitelpunktes
attributeindex	number	Der Index des Attributs innerhalb des Vertexs wird geändert.

Mesh:getVertexCount

Erhält die Gesamtzahl der Ecken im Mesh.

num = Mesh:getVertexCount()

num

number

Die Gesamtzahl der Ecken in diesem Mesh.

Mesh:getVertexFormat

Ruft das Scheitelformat ab, mit dem das Mesh erstellt wurde.

format = Mesh:getVertexFormat()

format	table	Das Scheitelformat des Mesh, das eine Tabelle mit Tabellen für jedes Scheitelattribut des Mesh ist, wurde mit in Form von {attribute, ...} erstellt.
format.attribute	table	Eine Tabelle, die den Namen des Attributs, den Datentyp und die Anzahl der Komponenten im Attribut enthält, in Form von {name, datatype, components}.
format....	table	Zusätzliche Scheitelattribute im Mesh.

Mesh:getVertexMap

Ruft die Scheitelkarte für das Mesh ab. Die Vertex-Karte beschreibt die Reihenfolge, in der die Ecken verwendet werden, wenn das Mesh gezeichnet wird. Die Eckpunkte, die Vertex-Karte und der Mesh-Draw-Modus arbeiten zusammen, um festzustellen, was genau auf dem Bildschirm angezeigt wird.

Wenn bisher keine Vertex-Map über Mesh gesetzt wurde: setVertexMap, dann wird diese Funktion nil in LÖVE 0.10.0+ oder eine leere Tabelle in 0.9.2 und älter zurückgeben.

map = Mesh:getVertexMap()

map

table

Eine Tabelle mit einer Liste von Scheitelindizes, die beim Zeichnen verwendet werden.

Mesh:isAttributeEnabled

Ermittelt, ob ein bestimmtes Scheitelattribut im Mesh aktiviert ist. Vertex-Daten aus deaktivierten Attributen werden beim Zeichnen des Mesh nicht verwendet.

enabled = Mesh:isAttributeEnabled( name )

enabled	boolean	Ob das Scheitelattribut beim Zeichnen dieses Mesh verwendet wird.
name	string	Der Name des Scheitelattributs zum Aktivieren oder Deaktivieren.

Mesh:setAttributeEnabled

Aktiviert oder deaktiviert ein bestimmtes Scheitelattribut im Mesh. Vertex-Daten aus deaktivierten Attributen werden beim Zeichnen des Mesh nicht verwendet.

Mesh:setAttributeEnabled( name, enable )

name	string	Der Name des Scheitelattributs zum Aktivieren oder Deaktivieren.
enable	boolean	Ob das Scheitelattribut beim Zeichnen dieses Mesh verwendet wird.

Mesh:setDrawMode

Setzt den Modus, der beim Zeichnen des Mesh verwendet wird.

Mesh:setDrawMode( mode )

mode

MeshDrawMode

Der Modus, der beim Zeichnen des Mesh verwendet wird.

Mesh:setDrawRange

Beschränkt die gezeichneten Ecken des Mesh auf eine Teilmenge der Summe.

Wenn eine Vertex-Map mit dem Mesh verwendet wird, setzt diese Methode eine Untermenge der Werte in dem Vertex-Map-Array, um anstelle einer Teilmenge der gesamten Eckpunkte im Mesh zu verwenden.

Wenn z. B. Mesh: setVertexMap (1, 2, 3, 1, 3, 4) und Mesh: setDrawRange (4, 6) aufgerufen werden, werden die Ecken 1, 3 und 4 gezeichnet.

Mesh:setDrawRange( min, max )

min	number	Der Index des ersten Scheitelpunktes, der beim Zeichnen verwendet wird, oder der Index des ersten Wertes in der Vertex-Map, die verwendet werden soll, wenn man für dieses Mesh gesetzt ist.
max	number	Der Index des letzten Scheitelpunktes, der beim Zeichnen verwendet wird, oder der Index des letzten Wertes in der Vertex-Map, der verwendet werden soll, wenn man für dieses Mesh gesetzt ist.

Mesh:setDrawRange()

Allows all vertices in the Mesh to be drawn.

Mesh:setTexture

Legt die Textur (Bild oder Leinwand) fest, die beim Zeichnen des Netzes verwendet wird.

Wenn Sie ohne Argument aufgerufen werden, wird die Textur deaktiviert. Untexturierte Maschen haben standardmäßig eine weiße Farbe.

Mesh:setTexture()

Mesh:setTexture( texture )

texture

ParticleSystem:getAreaSpread

Das Bild oder Canvas, um das Mesh mit dem Zeichnen zu beschriften.

Mesh:setVertex

Setzt die Eigenschaften eines Scheitelpunktes im Mesh.

Mesh:setVertex( index, attributecomponent, ... )

index	number	Der Index des Scheitelpunktes, den du ändern möchtest.
attributecomponent	number	Die erste Komponente des ersten Scheitelattributs im angegebenen Scheitelpunkt.
...	number	Zusätzliche Komponenten aller Scheitelattribute im angegebenen Scheitelpunkt.

Mesh:setVertex( index, vertex )

index	number	Der Index des Scheitelpunktes, den du ändern möchtest.
vertex	table	Eine Tabelle mit Vertex-Informationen, in Form von {attributecomponent, ...}.
vertex.attributecomponent	number	Die erste Komponente des ersten Scheitelattributs im angegebenen Scheitelpunkt.
vertex....	number	Zusätzliche Komponenten aller Scheitelattribute im angegebenen Scheitelpunkt.

Mesh:setVertex( index, x, y, u, v, r, g, b, a )

Legt die Vertex - Bestandteile a Mesh, der nicht mit einem entstanden benutzerdefinierte Vertex - Format.

index	number	Der Index des Scheitelpunktes, den du ändern möchtest.
x	number	Die Position des Scheitelpunktes auf der x-Achse.
y	number	Die Position des Scheitelpunktes auf der y-Achse.
u	number	Die horizontale Komponente der Texturkoordinate.
v	number	Die vertikale Komponente der Texturkoordinate.
r (255)	number	Die rote Komponente der Farbe des Scheitels.
g (255)	number	Die grüne Komponente der Farbe des Scheitels.
b (255)	number	Die blaue Komponente der Farbe des Scheitels.
a (255)	number	Die Alpha-Komponente der Farbe des Scheitelpunktes.

Mesh:setVertex( index, vertex )

Sets the vertex components of a Mesh that wasn't created with a custom vertex format.

index	number	Der Index des Scheitelpunktes, den du ändern möchtest.
vertex	table	Eine Tabelle mit Scheitelpunktinformationen.
vertex.[1]	number	Die Position des Scheitelpunktes auf der x-Achse.
vertex.[2]	number	Die Position des Scheitelpunktes auf der y-Achse.
vertex.[3]	number	Die horizontale Komponente der Texturkoordinate.
vertex.[4]	number	Die vertikale Komponente der Texturkoordinate.
vertex.[5] (255)	number	Die rote Komponente der Farbe des Scheitels.
vertex.[6] (255)	number	Die grüne Komponente der Farbe des Scheitels.
vertex.[7] (255)	number	Die blaue Komponente der Farbe des Scheitels.
vertex.[8] (255)	number	Die Alpha-Komponente der Farbe des Scheitelpunktes.

Mesh:setVertexAttribute

Setzt die Eigenschaften eines bestimmten Attributs innerhalb eines Scheitelpunktes im Mesh.

Meshes ohne ein benutzerdefiniertes Scheitelformat, das in love.graphics.newMesh angegeben ist, haben Position als ihr erstes Attribut, Texturkoordinaten als ihr zweites Attribut und Farbe als ihr drittes Attribut.

Mesh:setVertexAttribute( vertexindex, attributeindex, value1, value2, ... )

vertexindex	number	Der Index des zu modellen Scheitelpunktes
attributeindex	number	Der Index des Attributs innerhalb des Vertexs wird geändert.
value1	number	Der Wert der ersten Komponente des Attributs.
value2	number	Der Wert der zweiten Komponente des Attributs.
...	number	Alle zusätzlichen Scheitelattributkomponenten.

Mesh:setVertexMap

Setzt die Scheitelkarte für das Mesh. Die Vertex-Karte beschreibt die Reihenfolge, in der die Ecken verwendet werden, wenn das Mesh gezeichnet wird. Die Eckpunkte, die Vertex-Karte und der Mesh-Draw-Modus arbeiten zusammen, um festzustellen, was genau auf dem Bildschirm angezeigt wird.

Die Vertex-Karte ermöglicht es Ihnen, Eckpunkte beim Zeichnen neu zu ordnen oder wiederzuverwenden, ohne die tatsächlichen Scheitelparameter zu ändern oder die Eckpunkte zu duplizieren. Es ist besonders nützlich, wenn es mit verschiedenen Mesh Draw Modes kombiniert wird.

Mesh:setVertexMap( map )

map

table

Eine Tabelle, die eine Liste von Vertex-Indizes enthält, die beim Zeichnen verwendet werden sollen. Die Werte müssen im Bereich von {1, Mesh: getVertexCount ()} liegen.

Mesh:setVertexMap( vi1, vi2, vi3 )

vi1	number	Der Index des ersten Scheitelpunktes, der beim Zeichnen verwendet wird. Muss im Bereich von {1, Mesh: getVertexCount ()} sein.
vi2	number	Der Index des zweiten Scheitelpunktes, der beim Zeichnen verwendet wird.
vi3	number	Der Index des dritten Scheitelpunktes, der beim Zeichnen verwendet wird.

Mesh:setVertices

Ersetzt eine Reihe von Ecken im Mesh mit neuen. Die Gesamtzahl der Ecken in einem Mesh kann nach der Erstellung nicht geändert werden.

Mesh:setVertices( vertices )

vertices	table	Die Tabelle gefüllt mit Scheitelpunkttabellen für jeden Scheitelpunkt, in Form von {Scheitelpunkt, ...} wobei jeder Scheitelpunkt eine Tabelle in Form von {attributecomponent, ...} ist.
vertices.attributecomponent	number	Die erste Komponente des ersten Scheitelattributs im Scheitelpunkt.
vertices....	number	Zusätzliche Komponenten aller Scheitelattribute im Scheitelpunkt.
vertices.startvertex (1)	number	Der Index des ersten Scheitelpunktes zu ersetzen.

Mesh:setVertices( vertices )

Sets the vertex components of a Mesh that wasn't created with a custom vertex format.

vertices	table	Die Tabelle gefüllt mit Scheitel-Informationstabellen für jeden Scheitel wie folgt:
vertices.[1]	number	Die Position des Scheitelpunktes auf der x-Achse.
vertices.[2]	number	Die Position des Scheitelpunktes auf der y-Achse.
vertices.[3]	number	Die horizontale Komponente der Texturkoordinate. Texture-Koordinaten liegen normalerweise im Bereich von {0, 1}, können aber größer oder kleiner sein (siehe WrapMode).
vertices.[4]	number	Die vertikale Komponente der Texturkoordinate. Texture-Koordinaten liegen normalerweise im Bereich von {0, 1}, können aber größer oder kleiner sein (siehe WrapMode).
vertices.[5] (255)	number	Die rote Farbkomponente.
vertices.[6] (255)	number	Die grüne Farbkomponente.
vertices.[7] (255)	number	Die blaue Farbkomponente.
vertices.[8] (255)	number	Die Alpha-Farbkomponente.

Image

Ein Bild, welches gezeichnet werden kann.

Constructors

love.graphics.newImage Erstellt ein neues Image aus einem Dateipfad, einer FileData oder aus einer ImageData

Functions

Image:getData Ruft die ursprüngliche ImageData oder CompressedImageData ab, die zum Erstellen des Bildes verwendet wird.

Image:getDimensions Ruft die Breite und Höhe des Bildes ab.

Image:getFlags Ruft die Flags ab, die beim Erstellen des Bildes verwendet wurden.

Image:getHeight Ruft die Höhe des Bildes ab.

Image:getWidth Ruft die Breite des Bildes ab.

Image:refresh Aktualisiert den Inhalt des Bildes aus der ImageData oder CompressedImageData, die zum Erstellen des Bildes verwendet wird.

Image:get/setFilter Setzt den Filtermodus auf ein Bild.

Image:get/setMipmapFilter Setzt den Mipmap-Filtermodus für ein Bild.

Image:get/setWrap Legt die Wrapping-Eigenschaften eines Bildes fest.

Supertypes

Object Die Superklasse aller LÖVE-Typen.

Drawable Die Superklasse für alle Dinge, die auf den Bildschirm gezeichnet werden können.

Texture Die Superklasse für alle zeichenbaren Objekte welche eine Textur repräsentieren.

Image:getData

Ruft die ursprüngliche ImageData oder CompressedImageData ab, die zum Erstellen des Bildes verwendet wird.

Alle Bilder verweisen auf die Daten, die zum Erstellen des Bildes verwendet wurden. Die Daten werden verwendet, um das Bild zu aktualisieren, wenn love.window.setMode oder Image: Refresh aufgerufen wird.

data = Image:getData()

data

ImageData

Die ursprüngliche ImageData verwendet, um das Bild zu erstellen, wenn das Bild nicht komprimiert ist.

data = Image:getData()

data

CompressedImageData

Die ursprüngliche CompressedImageData verwendet, um das Bild zu erstellen, wenn das Bild komprimiert ist.

Image:getDimensions

Ruft die Breite und Höhe des Bildes ab.

width, height = Image:getDimensions()

width	number	Die Breite des Bildes in Pixel.
height	number	Die Höhe des Bildes in Pixel.

Image:getFilter

Gibt den Filtermodus eines Bildes zurück.

min, mag = Image:getFilter()

min	FilterMode	Benutzter Filtermodus beim Verkleinern eines Bildes.
mag	FilterMode	Benutzter Filtermodus beim Vergrößern eines Bildes.

Image:getFlags

Ruft die Flags ab, die beim Erstellen des Bildes verwendet wurden.

flags = Image:getFlags()

flags

table

Ein Tisch mit ImageFlag-Tasten.

Image:getHeight

Ruft die Höhe des Bildes ab.

height = Image:getHeight()

height

number

Die Höhe des Bildes in Pixel.

Image:getMipmapFilter

Ruft den Mipmap-Filtermodus für ein Bild ab.

mode, sharpness = Image:getMipmapFilter()

mode	FilterMode	Der Filtermodus wird zwischen den Mipmap-Ebenen verwendet. Wenn die Mipmap-Filterung nicht aktiviert ist.
sharpness	number	Wert, der verwendet wird, um festzustellen, ob das Bild mehr oder weniger detaillierte Mipmap-Ebenen verwenden sollte als normal beim Zeichnen.

Image:getWidth

Ruft die Breite des Bildes ab.

width = Image:getWidth()

width

number

Die Breite des Bildes in Pixel.

Image:getWrap

Ruft die Wrapping-Eigenschaften eines Bildes ab.

Diese Funktion gibt die aktuell eingestellten horizontalen und vertikalen Wickelmodi für das Bild zurück.

horizontal, vertical = Image:getWrap()

horizontal	WrapMode	Horizontaler Wickelmodus des Bildes.
vertical	WrapMode	Vertikaler Wickelmodus des Bildes.

Image:refresh

Aktualisiert den Inhalt des Bildes aus der ImageData oder CompressedImageData, die zum Erstellen des Bildes verwendet wird.

Image:refresh()

Image:refresh( x, y, width, height )

x	number	Die x-Achse der oberen linken Ecke des Bereichs innerhalb des Bildes zum erneuten Laden.
y	number	Die y-Achse der oberen linken Ecke des Bereichs innerhalb des Bildes zum erneuten Laden.
width	number	Die Breite des Bereichs innerhalb des Bildes zum erneuten Laden.
height	number	Die Höhe des Bereichs innerhalb des Bildes zum erneuten Laden.

Image:setFilter

Setzt den Filtermodus auf ein Bild.

Image:setFilter( min, mag )

min	FilterMode	So skaliere ich ein Bild ab.
mag (min)	FilterMode	Wie man ein Bild skaliert.

Image:setMipmapFilter

Setzt den Mipmap-Filtermodus für ein Bild.

Mipmapping ist nützlich, wenn ein Bild in einem reduzierten Maßstab gezeichnet wird. Es kann die Leistung verbessern und Aliasing-Probleme reduzieren.

In 0.10.0 und neuer muss das Image mit dem mipmaps-Flag erstellt werden, das für den mipmap-Filter aktiviert ist.

Image:setMipmapFilter( filtermode, sharpness )

filtermode	FilterMode	Der Filter-Modus, der zwischen den Mipmap-Ebenen verwendet wird. "nächstes" wird oft bessere Leistung geben.
sharpness (0)	number	Ein positiver Schärfewert macht das Bild bei der Zeichnung auf eine detailliertere Mipmap-Ebene, auf Kosten der Leistung. Ein negativer Wert ist umgekehrt.

Image:setMipmapFilter()

Deaktiviert Mipmap - Filterung.

Image:setWrap

Legt die Wrapping-Eigenschaften eines Bildes fest.

Diese Funktion setzt die Art und Weise, wie ein Bild wiederholt wird, wenn es mit einem Quad gezeichnet wird, das größer ist als das Ausmaß des Bildes. Ein Bild kann in horizontaler und vertikaler Richtung geklemmt oder eingestellt werden. Klemmte Bilder erscheinen nur einmal, aber wiederholte wiederholen so viele Male wie es Platz im Quad gibt.

Wenn Sie eine Quad verwenden, die größer ist als die Bildausdehnung und verwenden Sie keine wiederholte Fliesen, kann es eine unerwünschte visuelle Wirkung des Bildes Stretching den ganzen Weg, um die Quad zu füllen. Wenn dies der Fall ist, setzen Sie Image: getWrap ("repeat", "repeat") für alle zu wiederholenden Bilder und die Verwendung von Quad mit entsprechender Größe führt zum besten visuellen Erscheinungsbild.

Image:setWrap( horizontal, vertical )

horizontal	WrapMode	Horizontaler Wickelmodus des Bildes.
vertical (horizontal)	WrapMode	Vertikaler Wickelmodus des Bildes.

ParticleSystem

Partikelsysteme können dazu benutzt werden viele verschiedene Effekte wie Feuer oder Rauch zu erzeugen.

Constructors

love.graphics.newParticleSystem Erstellt ein neues Partikelsystem.

Functions

ParticleSystem:clone Erstellt eine identische Kopie eines bereits existierenden Partikelsystems.

ParticleSystem:emit Stößt einen Partikelhaufen aus.

ParticleSystem:getCount Gibt die Anzahl von Partikeln zurück, welche gerade im System sind.

ParticleSystem:isActive Überprüft, ob das Partikelsystem aktiv Partikel emittiert.

ParticleSystem:isPaused Überprüft, ob das Partikelsystem pausiert ist.

ParticleSystem:isStopped Überprüft, ob das Partikelsystem gestoppt wird.

ParticleSystem:moveTo Bewegt die Position des Emitters.

ParticleSystem:pause Pausiert den Partikel-Emitter.

ParticleSystem:reset Setzt den Partikel-Emitter zurück, entfernt alle vorhandenen Partikel und setzt den Lebensdauer-Zähler zurück.

ParticleSystem:get/setAreaSpread Setzt flächenbasierte Spawn-Parameter für die Partikel.

ParticleSystem:get/setBufferSize Setzt die Größe des Puffers (die maximal zulässige Partikelmenge im System).

ParticleSystem:get/setColors Setzt eine Reihe von Farben, um sich auf das Partikel-Sprite zu bewerben.

ParticleSystem:get/setDirection Setzt die Richtung, in die die Partikel ausgegeben werden.

ParticleSystem:get/setEmissionRate Setzt die Menge der pro Sekunde emittierten Partikel.

ParticleSystem:get/setEmitterLifetime Legt fest, wie lange das Partikelsystem Partikel emittieren muss (wenn -1 dann emittiert es Partikel für immer).

ParticleSystem:get/setInsertMode Setzt den Modus, der verwendet werden soll, wenn das ParticleSystem neue Partikel hinzufügt.

ParticleSystem:get/setLinearAcceleration Stellt die lineare Beschleunigung (Beschleunigung entlang der x- und y-Achse) für Partikel ein.

ParticleSystem:get/setLinearDamping Stellt den Betrag der linearen Dämpfung (konstante Verzögerung) für Partikel ein.

ParticleSystem:get/setOffset Setzen Sie die Offset-Position, die das Partikel-Sprite umgedreht wird.

ParticleSystem:get/setParticleLifetime Setzt die Lebensdauer der Partikel.

ParticleSystem:get/setPosition Stellt die Position des Emitters ein.

ParticleSystem:get/setQuads Setzt eine Reihe von Quads für die Partikel-Sprites zu verwenden.

ParticleSystem:get/setRadialAcceleration Stellen Sie die radiale Beschleunigung (weg vom Emitter) ein.

ParticleSystem:has/setRelativeRotation Stellt fest, ob Teilchenwinkel und Rotationen relativ zu ihren Geschwindigkeiten sind.

ParticleSystem:get/setRotation Setzt die Rotation des Bildes auf die Partikelbildung (im Bogenmaß).

ParticleSystem:get/setSizes Setzt eine Reihe von Größen, um eine Teilchen-Sprite zu skalieren.

ParticleSystem:get/setSizeVariation Setzt den Grad der Variation (0 bedeutet keine Variation und 1 bedeutet volle Variation zwischen Start und Ende).

ParticleSystem:get/setSpeed Stellt die Geschwindigkeit der Partikel ein.

ParticleSystem:get/setSpin Setzt den Spin des Sprites.

ParticleSystem:get/setSpinVariation Setzt den Grad der Variation (0 bedeutet keine Variation und 1 bedeutet volle Variation zwischen Start und Ende).

ParticleSystem:get/setSpread Setzt den Betrag der Ausbreitung für das System.

ParticleSystem:get/setTexture Setzt das Bild oder die Leinwand, das ausgegeben werden soll.

ParticleSystem:get/setTangentialAcceleration Stellt die tangentiale Beschleunigung ein (Beschleunigung senkrecht zur Teilchenrichtung).

ParticleSystem:start Startet den Partikel-Emitter.

ParticleSystem:stop Stoppt den Partikel-Emitter und setzt den Lebensdauer-Zähler zurück.

ParticleSystem:update Aktualisiert das Partikelsystem; Bewegen, Schaffen und Töten von Partikeln.

Supertypes

Drawable Die Superklasse für alle Dinge, die auf den Bildschirm gezeichnet werden können.

Object Die Superklasse aller LÖVE-Typen.

ParticleSystem:clone

Erstellt eine identische Kopie eines bereits existierenden Partikelsystems.

particlesystem = ParticleSystem:clone()

particlesystem

ParticleSystem

Eine neue identische Kopie des Partikelsystems.

ParticleSystem:emit

Stößt einen Partikelhaufen aus.

ParticleSystem:emit( numparticles )

numparticles

number

Die Anzahl von Partikeln welche ausgestoßen werden sollen. Die Nummer wird automatisch verringert, wenn sie die erlaubte Anzahl übersteigt.

ParticleSystem:getCount

Gibt die Anzahl von Partikeln zurück, welche gerade im System sind.

count = ParticleSystem:getCount()

count

number

Die Anzahl der "lebenden" Partikel.

Ruft die flächenbasierten Spawn-Parameter für die Partikel ab.

distribution, dx, dy = ParticleSystem:getAreaSpread()

distribution	AreaSpreadDistribution	Die Art der Verteilung für neue Partikel.
dx	number	Der maximale Laichabstand vom Emitter entlang der x-Achse zur gleichmäßigen Verteilung oder die Standardabweichung entlang der x-Achse zur Normalverteilung.
dy	number	Der maximale Laichabstand vom Emitter entlang der y-Achse zur gleichmäßigen Verteilung oder die Standardabweichung entlang der y-Achse zur Normalverteilung.

ParticleSystem:getBufferSize

Ruft die Größe des Puffers ab (die maximal zulässige Partikelmenge im System).

buffer = ParticleSystem:getBufferSize()

buffer

number

Die Puffergröße.

ParticleSystem:getColors

Erhält eine Reihe von Farben, um sich auf das Partikel-Sprite zu bewerben. Das Partikelsystem wird zwischen jeder Farbe gleichmäßig über die Lebensdauer des Teilchens interpolieren. Die Farbmodulation muss für diese Funktion aktiviert werden.

Argumente werden in Gruppen von vier übergeben, die die Komponenten des gewünschten RGBA-Werts darstellen. Es muss mindestens eine Farbe angegeben werden. Es können maximal acht verwendet werden.

r1, g1, b1, a1, r2, g2, b2, a2, ... = ParticleSystem:getColors()

r1	number	Erste Farbe, rote Komponente (0-255).
g1	number	Erste Farbe, grüne Komponente (0-255).
b1	number	Erste Farbe, blaue Komponente (0-255).
a1	number	Erste Farbe, Alphakomponente (0-255).
r2	number	Zweite Farbe, rote Komponente (0-255).
g2	number	Zweite Farbe, grüne Komponente (0-255).
b2	number	Zweite Farbe, blaue Komponente (0-255).
a2	number	Zweite Farbe, Alphakomponente (0-255).
...	number	Etc.

ParticleSystem:getDirection

Ermittelt die Richtung, in die die Partikel ausgegeben werden.

direction = ParticleSystem:getDirection()

direction

number

Die Richtung der Teilchen (im Bogenmaß).

ParticleSystem:getEmissionRate

Erhält die Menge der pro Sekunde emittierten Partikel.

rate = ParticleSystem:getEmissionRate()

rate

number

Die Menge der Teilchen pro Sekunde.

ParticleSystem:getInsertMode

Ruft den Modus auf, wenn das ParticleSystem neue Partikel hinzufügt.

mode = ParticleSystem:getInsertMode()

mode

ParticleInsertMode

Der Modus, der verwendet werden soll, wenn das Partikelsystem neue Partikel hinzufügt.

ParticleSystem:getLinearAcceleration

Ruft die lineare Beschleunigung (Beschleunigung entlang der x- und y-Achsen) für Partikel auf.

Jedes erzeugte Partikel beschleunigt sich entlang der x- und y-Achsen zwischen xmin, ymin und xmax, ymax.

xmin, ymin, xmax, ymax = ParticleSystem:getLinearAcceleration()

xmin	number	Die minimale Beschleunigung entlang der x-Achse
ymin	number	Die minimale Beschleunigung entlang der y-Achse.
xmax	number	Die maximale Beschleunigung entlang der x-Achse
ymax	number	Die maximale Beschleunigung entlang der y-Achse

ParticleSystem:getLinearDamping

Ermittelt die Menge der linearen Dämpfung (konstante Verzögerung) für Partikel.

min, max = ParticleSystem:getLinearDamping()

min	number	Die minimale lineare Dämpfung, die auf Partikel angewendet wird.
max	number	Die maximale Menge der linearen Dämpfung auf Partikel angewendet.

ParticleSystem:getEmitterLifetime

Erreicht, wie lange das Partikelsystem Partikel emittieren sollte (wenn -1 dann emittiert es Partikel für immer).

life = ParticleSystem:getEmitterLifetime()

life

number

Die Lebensdauer des Emitters (in Sekunden).

ParticleSystem:getOffset

Holen Sie sich die Offback-Position, die das Partikel-Sprite umgedreht wird. Wenn diese Funktion nicht verwendet wird, drehen sich die Partikel um ihre Mitte.

x, y = ParticleSystem:getOffset()

x	number	Die x-Koordinate des Rotations-Offens.
y	number	Die y-Koordinate des Rotations-Offens.

ParticleSystem:getParticleLifetime

Erhält das Leben der Partikel.

min, max = ParticleSystem:getParticleLifetime()

min	number	Die Mindestlebensdauer der Partikel (Sekunden).
max (min)	number	Die maximale Lebensdauer der Partikel (Sekunden).

ParticleSystem:getQuads

Ruft die Reihe der Quads für die Partikel-Sprites verwendet.

quads = ParticleSystem:getQuads()

quads

table

Eine Tabelle mit den verwendeten Quads.

ParticleSystem:getPosition

Ruft die Position des Emitters ab.

x, y = ParticleSystem:getPosition()

x	number	Position entlang der x-Achse.
y	number	Position auf y-Achse.

ParticleSystem:getRadialAcceleration

Holen Sie sich die radiale Beschleunigung (weg vom Emitter).

min, max = ParticleSystem:getRadialAcceleration()

min	number	Die minimale beschleunigung
max (min)	number	Die maximale Beschleunigung.

ParticleSystem:getRotation

Erhält die Rotation des Bildes bei der Teilchenbildung (im Bogenmaß).

min, max = ParticleSystem:getRotation()

min	number	Der minimale Anfangswinkel (Bogenmaß).
max (min)	number	Der maximale Anfangswinkel (Bogenmaß).

ParticleSystem:getSizes

Erhält eine Reihe von Größen, mit denen ein Partikel-Sprite skaliert werden kann. 1,0 ist normale Größe. Das Partikelsystem wird zwischen jeder Größe gleichmäßig über die Lebensdauer des Teilchens interpolieren.

Mindestens eine Größe muss angegeben werden. Es können maximal acht verwendet werden.

size1, size2, ... = ParticleSystem:getSizes()

size1	number	Die erste Größe.
size2	number	Die zweite Größe.
...	number	Etc.

ParticleSystem:getSizeVariation

Erhält den Grad der Variation (0 bedeutet keine Variation und 1 bedeutet volle Variation zwischen Anfang und Ende).

variation = ParticleSystem:getSizeVariation()

variation

number

Der Grad der Variation (0 bedeutet keine Variation und 1 bedeutet volle Variation zwischen Anfang und Ende).

ParticleSystem:getSpeed

Erreicht die Geschwindigkeit der Partikel.

min, max = ParticleSystem:getSpeed()

min	number	Die minimale lineare Geschwindigkeit der Partikel.
max (min)	number	Die maximale lineare Geschwindigkeit der Partikel.

ParticleSystem:getSpin

Erhält den Spin des Sprites.

min, max = ParticleSystem:getSpin()

min	number	Der minimale Spin (Bogenmaß pro Sekunde).
max (min)	number	Der maximale Spin (Bogenmaß pro Sekunde).

ParticleSystem:getSpinVariation

Erhält den Grad der Variation (0 bedeutet keine Variation und 1 bedeutet volle Variation zwischen Anfang und Ende).

variation = ParticleSystem:getSpinVariation()

variation

number

Der Grad der Variation (0 bedeutet keine Variation und 1 bedeutet volle Variation zwischen Anfang und Ende).

ParticleSystem:getSpread

Ermittelt die Menge der Ausbreitung für das System.

spread = ParticleSystem:getSpread()

spread

number

Die Menge der Ausbreitung (Bogenmaß).

ParticleSystem:getTexture

Ruft das Bild oder die Leinwand ab, das ausgegeben werden soll.

texture = ParticleSystem:getTexture()

texture

ParticleSystem:getTangentialAcceleration

Ein Bild oder Leinwand für das Teilchen zu verwenden.

Ermittelt die tangentiale Beschleunigung (Beschleunigung senkrecht zur Partikelrichtung).

min, max = ParticleSystem:getTangentialAcceleration()

min	number	Die minimale beschleunigung
max (min)	number	Die maximale Beschleunigung.

ParticleSystem:hasRelativeRotation

Ermittelt, ob Teilchenwinkel und Rotationen relativ zu ihren Geschwindigkeiten sind. Wenn sie aktiviert sind, werden die Teilchen auf den Winkel ihrer Geschwindigkeiten ausgerichtet und drehen sich relativ zu diesem Winkel.

enabled = ParticleSystem:hasRelativeRotation()

enabled

boolean

True, wenn die relative Partikelrotation aktiviert ist, false, wenn sie deaktiviert ist.

ParticleSystem:isActive

Überprüft, ob das Partikelsystem aktiv Partikel emittiert.

active = ParticleSystem:isActive()

active

boolean

True, wenn das System aktiv ist, false anders.

ParticleSystem:isPaused

Überprüft, ob das Partikelsystem pausiert ist.

paused = ParticleSystem:isPaused()

paused

boolean

Wahr, wenn das System pausiert ist, sonst false.

ParticleSystem:isStopped

Überprüft, ob das Partikelsystem gestoppt wird.

stopped = ParticleSystem:isStopped()

stopped

boolean

Wahr, wenn das System gestoppt wird, falsch anders.

ParticleSystem:moveTo

Bewegt die Position des Emitters. Dies führt zu einem glatteren Partikel-Laichverhalten, als wenn ParticleSystem: setPosition jedes Frame verwendet wird.

ParticleSystem:moveTo( x, y )

x	number	Position entlang der x-Achse.
y	number	Position auf y-Achse.

ParticleSystem:pause

Pausiert den Partikel-Emitter.

ParticleSystem:pause()

ParticleSystem:reset

Setzt den Partikel-Emitter zurück, entfernt alle vorhandenen Partikel und setzt den Lebensdauer-Zähler zurück.

ParticleSystem:reset()

ParticleSystem:setAreaSpread

Setzt flächenbasierte Spawn-Parameter für die Partikel. Neu erzeugte Partikel werden in einem Bereich um den Emitter auf der Grundlage der Parameter zu dieser Funktion entstehen.

ParticleSystem:setAreaSpread( distribution, dx, dy )

distribution	AreaSpreadDistribution	Die Art der Verteilung für neue Partikel.
dx	number	Der maximale Laichabstand vom Emitter entlang der x-Achse zur gleichmäßigen Verteilung oder die Standardabweichung entlang der x-Achse zur Normalverteilung.
dy	number	Der maximale Laichabstand vom Emitter entlang der y-Achse zur gleichmäßigen Verteilung oder die Standardabweichung entlang der y-Achse zur Normalverteilung.

ParticleSystem:setBufferSize

Setzt die Größe des Puffers (die maximal zulässige Partikelmenge im System).

ParticleSystem:setBufferSize( buffer )

buffer

number

Die Puffergröße.

ParticleSystem:setColors

Setzt eine Reihe von Farben, um sich auf das Partikel-Sprite zu bewerben. Das Partikelsystem wird zwischen jeder Farbe gleichmäßig über die Lebensdauer des Teilchens interpolieren. Die Farbmodulation muss für diese Funktion aktiviert werden.

Argumente werden in Gruppen von vier übergeben, die die Komponenten des gewünschten RGBA-Werts darstellen. Es muss mindestens eine Farbe angegeben werden. Es können maximal acht verwendet werden.

ParticleSystem:setColors( r1, g1, b1, a1, r2, g2, b2, a2, ... )

r1	number	Erste Farbe, rote Komponente (0-255).
g1	number	Erste Farbe, grüne Komponente (0-255).
b1	number	Erste Farbe, blaue Komponente (0-255).
a1	number	Erste Farbe, Alphakomponente (0-255).
r2	number	Zweite Farbe, rote Komponente (0-255).
g2	number	Zweite Farbe, grüne Komponente (0-255).
b2	number	Zweite Farbe, blaue Komponente (0-255).
a2	number	Zweite Farbe, Alphakomponente (0-255).
...	number	Etc.

ParticleSystem:setDirection

Setzt die Richtung, in die die Partikel ausgegeben werden.

ParticleSystem:setDirection( direction )

direction

number

Die Richtung der Teilchen (im Bogenmaß).

ParticleSystem:setEmissionRate

Setzt die Menge der pro Sekunde emittierten Partikel.

ParticleSystem:setEmissionRate( rate )

rate

number

Die Menge der Teilchen pro Sekunde.

ParticleSystem:setEmitterLifetime

Legt fest, wie lange das Partikelsystem Partikel emittieren muss (wenn -1 dann emittiert es Partikel für immer).

ParticleSystem:setEmitterLifetime( life )

life

number

Die Lebensdauer des Emitters (in Sekunden).

ParticleSystem:setInsertMode

Setzt den Modus, der verwendet werden soll, wenn das ParticleSystem neue Partikel hinzufügt.

ParticleSystem:setInsertMode( mode )

mode

ParticleInsertMode

Der Modus, der verwendet werden soll, wenn das Partikelsystem neue Partikel hinzufügt.

ParticleSystem:setLinearAcceleration

Stellt die lineare Beschleunigung (Beschleunigung entlang der x- und y-Achse) für Partikel ein.

Jedes erzeugte Partikel beschleunigt sich entlang der x- und y-Achsen zwischen xmin, ymin und xmax, ymax.

ParticleSystem:setLinearAcceleration( xmin, ymin, xmax, ymax )

xmin	number	Die minimale Beschleunigung entlang der x-Achse
ymin (0)	number	Die minimale Beschleunigung entlang der y-Achse.
xmax (xmin)	number	Die maximale Beschleunigung entlang der x-Achse
ymax (ymin)	number	Die maximale Beschleunigung entlang der y-Achse

ParticleSystem:setLinearDamping

Stellt den Betrag der linearen Dämpfung (konstante Verzögerung) für Partikel ein.

ParticleSystem:setLinearDamping( min, max )

min	number	Die minimale lineare Dämpfung, die auf Partikel angewendet wird.
max	number	Die maximale Menge der linearen Dämpfung auf Partikel angewendet.

ParticleSystem:setOffset

Setzen Sie die Offset-Position, die das Partikel-Sprite umgedreht wird. Wenn diese Funktion nicht verwendet wird, drehen sich die Partikel um ihre Mitte.

ParticleSystem:setOffset( x, y )

x	number	Die x-Koordinate des Rotationsversatzes
y	number	Die y-Koordinate des Rotationsversatzes

ParticleSystem:setParticleLifetime

Setzt die Lebensdauer der Partikel.

ParticleSystem:setParticleLifetime( min, max )

min	number	Die Mindestlebensdauer der Partikel (Sekunden).
max (min)	number	Die maximale Lebensdauer der Partikel (Sekunden).

ParticleSystem:setPosition

Stellt die Position des Emitters ein.

ParticleSystem:setPosition( x, y )

x	number	Position entlang der x-Achse.
y	number	Position auf y-Achse.

ParticleSystem:setQuads

Setzt eine Reihe von Quads für die Partikel-Sprites zu verwenden. Partikel wählen aus der Liste ein Quad aus der Liste, das auf der aktuellen Lebensdauer des Partikels basiert und die Verwendung von animierten Sprite-Blättern mit ParticleSystems ermöglicht.

ParticleSystem:setQuads( quad1, quad2 )

quad1	Quad	Die erste Quad zu verwenden.
quad2	Quad	Die zweite Quad zu verwenden.

ParticleSystem:setQuads( quads )

quads

table

Eine Tabelle mit den Quads zu verwenden.

ParticleSystem:setRadialAcceleration

Stellen Sie die radiale Beschleunigung (weg vom Emitter) ein.

ParticleSystem:setRadialAcceleration( min, max )

min	number	Die minimale beschleunigung
max (min)	number	Die maximale Beschleunigung.

ParticleSystem:setRelativeRotation

Stellt fest, ob Teilchenwinkel und Rotationen relativ zu ihren Geschwindigkeiten sind. Wenn sie aktiviert sind, werden die Teilchen auf den Winkel ihrer Geschwindigkeiten ausgerichtet und drehen sich relativ zu diesem Winkel.

ParticleSystem:setRelativeRotation( enable )

enable

boolean

True, um die relative Partikelrotation zu aktivieren, false, um sie zu deaktivieren.

ParticleSystem:setRotation

Setzt die Rotation des Bildes auf die Partikelbildung (im Bogenmaß).

ParticleSystem:setRotation( min, max )

min	number	Der minimale Anfangswinkel (Bogenmaß).
max (min)	number	Der maximale Anfangswinkel (Bogenmaß).

ParticleSystem:setSizes

Setzt eine Reihe von Größen, um eine Teilchen-Sprite zu skalieren. 1,0 ist normale Größe. Das Partikelsystem wird zwischen jeder Größe gleichmäßig über die Lebensdauer des Teilchens interpolieren.

Mindestens eine Größe muss angegeben werden. Es können maximal acht verwendet werden.

ParticleSystem:setSizes( size1, size2, ... )

size1	number	Die erste Größe.
size2	number	Die zweite Größe.
...	number	Etc.

ParticleSystem:setSizeVariation

Setzt den Grad der Variation (0 bedeutet keine Variation und 1 bedeutet volle Variation zwischen Start und Ende).

ParticleSystem:setSizeVariation( variation )

variation

number

Der Grad der Variation (0 bedeutet keine Variation und 1 bedeutet volle Variation zwischen Anfang und Ende).

ParticleSystem:setSpeed

Stellt die Geschwindigkeit der Partikel ein.

ParticleSystem:setSpeed( min, max )

min	number	Die minimale lineare Geschwindigkeit der Partikel.
max (min)	number	Die maximale lineare Geschwindigkeit der Partikel.

ParticleSystem:setSpin

Setzt den Spin des Sprites.

ParticleSystem:setSpin( min, max )

min	number	Der minimale Spin (Bogenmaß pro Sekunde).
max (min)	number	Der maximale Spin (Bogenmaß pro Sekunde).

ParticleSystem:setSpinVariation

Setzt den Grad der Variation (0 bedeutet keine Variation und 1 bedeutet volle Variation zwischen Start und Ende).

ParticleSystem:setSpinVariation( variation )

variation

number

Der Grad der Variation (0 bedeutet keine Variation und 1 bedeutet volle Variation zwischen Anfang und Ende).

ParticleSystem:setSpread

Setzt den Betrag der Ausbreitung für das System.

ParticleSystem:setSpread( spread )

spread

number

Die Menge der Ausbreitung (Bogenmaß).

ParticleSystem:setTexture

Setzt das Bild oder die Leinwand, das ausgegeben werden soll.

ParticleSystem:setTexture( texture )

texture

ParticleSystem:setTangentialAcceleration

Ein Bild oder Leinwand für das Teilchen zu verwenden.

Stellt die tangentiale Beschleunigung ein (Beschleunigung senkrecht zur Teilchenrichtung).

ParticleSystem:setTangentialAcceleration( min, max )

min	number	Die minimale beschleunigung
max (min)	number	Die maximale Beschleunigung.

ParticleSystem:start

Startet den Partikel-Emitter.

ParticleSystem:start()

ParticleSystem:stop

Stoppt den Partikel-Emitter und setzt den Lebensdauer-Zähler zurück.

ParticleSystem:stop()

ParticleSystem:update

Aktualisiert das Partikelsystem; Bewegen, Schaffen und Töten von Partikeln.

ParticleSystem:update( dt )

number

Die Zeit (Sekunden) seit dem letzten Rahmen.

Quad

Ein Viereck (ein Polygon mit vier Seiten und vier Ecken) mit Texturkoordinaten.

Ein Quad kann dazu genutzt werden, nur einen bestimmten Teil einer Textur zu zeichnen. Auf diesem Weg, kann ein großer

Texturen-Atlas geladen werden und schließlich durch Quads in kleinere Unterbilder aufgeteilt werden.

Constructors

love.graphics.newQuad Erstellt ein neues Quad.

Functions

Quad:getTextureDimensions Ruft Referenz-Textur-Dimensionen zunächst in love.graphics.newQuad angegeben.

Quad:get/setViewport Bestimmt die Texturkoordinaten anhand eines bestimmten Ansichtsfensters.

Supertypes

Object Die Superklasse aller LÖVE-Typen.

Quad:getTextureDimensions

Ruft Referenz-Textur-Dimensionen zunächst in love.graphics.newQuad angegeben.

sw, sh = Quad:getTextureDimensions()

sw	number	Die Texturbreite, die von der Quad verwendet wird.
sh	number	Die Texturhöhe, die von der Quad verwendet wird.

Quad:getViewport

Gibt das Ansichtsfenster zurück.

x, y, w, h = Quad:getViewport()

x	number	Die obere linke Ecke entlang der x-Achse.
y	number	Die obere rechte Ecke entlang der y-Achse.
w	number	Die Breite des Fensters.
h	number	Die Höhe des Fensters.

Quad:setViewport

Bestimmt die Texturkoordinaten anhand eines bestimmten Ansichtsfensters.

Quad:setViewport( x, y, w, h )

x	number	Die obere linke Ecke entlang der x-Achse.
y	number	Die obere rechte Ecke entlang der y-Achse.
w	number	Die Breite des Fensters.
h	number	Die Höhe des Fensters.

Shader

Ein Shader wird für fortgeschrittene hardware-beschleunigte Pixel oder Vertex Manipulationen genutzt.

Diese Effekte werden in einer Sprache geschrieben, welche auf der OpenGL Shading Language (GLSL) basiert.

Die Anwendungsmöglichkeiten von Shadern sind beinahe unbegrenzt. So sind zum Beispiel HDR/bloom, Bewegungsunschärfe, Schwarz/Weiß, Reflektionen, Bump Mapping und Lichteffekte nur einige wenige Anwendungsbereiche.

Constructors

love.graphics.newShader Erstellt ein neues Shader-Objekt für hardwarebeschleunigte Vertex- und Pixeleffekte.

Functions

Shader:send Sendet einen oder mehrere Werte an eine spezielle (einheitliche) Variable innerhalb des Shaders.

Shader:sendColor Sendet eine oder mehrere Farben an eine spezielle (extern / einheitliche) vec3- oder vec4-Variable innerhalb des Shaders.

Shader:getExternVariable Ermittelt Informationen über eine "extern" ("Uniform") Variable im Shader.

Shader:getWarnings Ruft alle Warn- und Fehlermeldungen ab, um den Shader-Code zu kompilieren.

Supertypes

Object Die Superklasse aller LÖVE-Typen.

Shader:getExternVariable

Ermittelt Informationen über eine "extern" ("Uniform") Variable im Shader.

type, components, arrayelements = Shader:getExternVariable( name )

type	ShaderVariableType	Der Basistyp der Variablen.
components	number	Die Anzahl der Komponenten in der Variablen (z. B. 2 für eine vec2 oder mat2)
arrayelements	number	Die Anzahl der Elemente im Array, wenn die Variable ein Array ist, oder 1 wenn nicht.
name	string	Der Name der externen Variablen.

Shader:getWarnings

Ruft alle Warn- und Fehlermeldungen ab, um den Shader-Code zu kompilieren. Dies kann für das Debuggen Ihrer Shader verwendet werden, wenn es irgendetwas gibt, das die Grafikhardware nicht mag.

warnings = Shader:getWarnings()

warnings

string

Warnmeldungen (falls vorhanden).

Shader:send

Sendet einen oder mehrere Werte an eine spezielle (einheitliche) Variable innerhalb des Shaders. Einheitliche Variablen müssen mit dem einheitlichen oder externen Schlüsselwort markiert werden.

Shader:send( name, number, ... )

name	string	Name der Nummer, die an den Shader gesendet werden soll.
number	number	Anzahl zu senden, um in der einheitlichen Variable zu speichern.
...	number	Zusätzliche Nummern zu senden, wenn die einheitliche Variable ein Array ist.

Shader:send( name, vector, ... )

name	string	Name des zu sendenden Vektors an den Shader.
vector	table	Zahlen, um die einheitliche Variable als Vektor zu senden. Die Anzahl der Elemente in der Tabelle bestimmt den Typ des Vektors (z. B. zwei Zahlen -> vec2). Mindestens zwei und höchstens vier Zahlen können verwendet werden.
...	table	Zusätzliche Vektoren zu senden, wenn die einheitliche Variable ein Array ist. Alle Vektoren müssen von der gleichen Größe sein (z. B. nur vec3).

Shader:send( name, matrix, ... )

name	string	Name der Matrix zum Senden an den Shader.
matrix	table	2x2, 3x3 oder 4x4 Matrix, um an die einheitliche Variable zu senden. Mit Tabellenform: {{a, b, c, d}, {e, f, g, h}, ...}.
...	table	Zusätzliche Matrizen des gleichen Typs wie Matrix in einem einheitlichen Array zu speichern.

Shader:send( name, texture )

name	string	Name der Textur zum Senden an den Shader.
texture	Texture	Textur (Bild oder Leinwand), um an die einheitliche Variable zu senden.

Shader:send( name, boolean, ... )

name	string	Name des Booleschen an den Shader zu senden.
boolean	boolean	Boolean zu senden, um in der einheitlichen Variable zu speichern.
...	boolean	Zusätzliche Booleans zu senden, wenn die einheitliche Variable ein Array ist.

Shader:sendColor

Sendet eine oder mehrere Farben an eine spezielle (extern / einheitliche) vec3- oder vec4-Variable innerhalb des Shaders. Die Farbkomponenten müssen im Bereich von {0, 255} liegen, im Gegensatz zu Shader: senden. Die Farben werden gamma-korrigiert, wenn die globale Gamma-Korrektur aktiviert ist.

Shader:sendColor( name, color, ... )

name	string	Der Name der Farbe extern Variable, um in den Shader zu senden.
color	table	Eine Tabelle mit roten, grünen, blauen und optionalen Alpha-Farbkomponenten im Bereich von {0, 255}, um an den externen als Vektor zu senden.
...	table	Zusätzliche Farben zu senden, falls das externe ein Array ist. Alle Farben müssen von der gleichen Größe sein (z. B. nur vec3).

SpriteBatch

Mit Hilfe eines SpriteBatch können beliebig viele Kopien eines Bildes mit einem einzigen Aufruf von love.graphics.draw auf den Bildschirm gezeichnet werden. Hierdurch kann zum Beispiel ein sich ständig wiederholendes Hintergrundbild mit hoher Performanz gezeichnet werden.

Ein SpriteBatch ist sogar noch nützlicher, wenn sich der zu zeichnende Sprite in einem Texturatlas befindet. Durch das Hinzufügen von Quads zu einem SpriteBatch, können verschiedene Teile dieses Atlas zum Zeichnen benutzt werden.

Constructors

love.graphics.newSpriteBatch Erstellt einen neuen SpriteBatch.

Functions

SpriteBatch:add Fügt einen Sprite zum SpriteBatch hinzu.

SpriteBatch:attachAttribute Bietet ein Per-Scheitel-Attribut von einem Mesh auf dieses SpriteBatch, für die Verwendung beim Zeichnen.

SpriteBatch:clear Entfernt alle Sprites aus dem Puffer.

SpriteBatch:flush Sofort sendet alle neuen und modifizierten Sprite-Daten im Batch auf die Grafikkarte.

SpriteBatch:getCount Ruft die Menge der Sprites in der SpriteBatch.

SpriteBatch:set Ändert ein Sprite in der Charge.

SpriteBatch:get/setBufferSize Legt die maximale Anzahl von Sprites fest, die der SpriteBatch halten kann.

SpriteBatch:get/setColor Legt die Farbe fest, die für die nächsten Add- und Set-Operationen verwendet wird.

SpriteBatch:get/setTexture Ersetzt das Bild oder die Leinwand für die Sprites.

Supertypes

Drawable Die Superklasse für alle Dinge, die auf den Bildschirm gezeichnet werden können.

Object Die Superklasse aller LÖVE-Typen.

SpriteBatch:add

Fügt einen Sprite zum SpriteBatch hinzu. Sprites werden in der Reihenfolge auf den Bildschirm gezeichnet, in der sie zum SpriteBatch hinzugefügt wurden.

id = SpriteBatch:add( x, y, r, sx, sy, ox, oy, kx, ky )

id	number	An identifier for the added sprite.
x	number	Die Position des Sprites auf der x-Achse.
y	number	Die Position des Sprites auf der y-Achse.
r (0)	number	Die Ausrichtung in Radianten.
sx (1)	number	Der Skalierungsfaktor in x-Richtung.
sy (sx)	number	Der Skalierungsfaktor in y-Richtung.
ox (0)	number	Die Verschiebung von den Ursprungskoordinaten auf der x-Achse.
oy (0)	number	Die Verschiebung von den Ursprungskoordinaten auf der y-Achse.
kx (0)	number	Der Scherfaktor in x-Richtung.
ky (0)	number	Der Scherfaktor in y-Richtung.

id = SpriteBatch:add( quad, x, y, r, sx, sy, ox, oy, kx, ky )

id	number	An identifier for the added sprite.
quad	Quad	Das Quad welches hinzugefügt werden soll.
x	number	Die Position des Sprites auf der x-Achse.
y	number	Die Position des Sprites auf der y-Achse.
r (0)	number	Die Ausrichtung in Radianten.
sx (1)	number	Der Skalierungsfaktor in x-Richtung.
sy (sx)	number	Der Skalierungsfaktor in y-Richtung.
ox (0)	number	Die Verschiebung von den Ursprungskoordinaten auf der x-Achse.
oy (0)	number	Die Verschiebung von den Ursprungskoordinaten auf der y-Achse.
kx (0)	number	Der Scherfaktor in x-Richtung.
ky (0)	number	Der Scherfaktor in y-Richtung.

SpriteBatch:attachAttribute

Bietet ein Per-Scheitel-Attribut von einem Mesh auf dieses SpriteBatch, für die Verwendung beim Zeichnen. Dies kann mit einem Shader kombiniert werden, um ein SpriteBatch mit per-Scheitel oder zusätzlichen Per-Sprite-Informationen zu verstärken, anstatt nur per-Sprite-Farben zu haben.

Jeder Sprite in einem SpriteBatch hat 4 Ecken in der folgenden Reihenfolge: oben links, unten links, oben rechts rechts unten. Der von SpriteBatch zurückgegebene Index: add (und von SpriteBatch verwendet: set) kann mit 4 multipliziert werden, um den ersten Scheitelpunkt in einem bestimmten Sprite zu bestimmen.

SpriteBatch:attachAttribute( name, mesh )

name	string	Der Name des Scheitelattributs zum Anhängen.
mesh	Mesh	Das Mesh, um das Scheitelattribut zu erhalten.

SpriteBatch:clear

Entfernt alle Sprites aus dem Puffer.

SpriteBatch:clear()

SpriteBatch:flush

Sofort sendet alle neuen und modifizierten Sprite-Daten im Batch auf die Grafikkarte.

SpriteBatch:flush()

SpriteBatch:getBufferSize

Ruft die maximale Anzahl von Sprites ab, die SpriteBatch halten kann.

size = SpriteBatch:getBufferSize()

size

number

Die maximale Anzahl von Sprites, die die Charge halten kann.

SpriteBatch:getColor

Ruft die Farbe ab, die für die nächsten Add- und Set-Operationen verwendet wird.

Wenn keine Farbe mit SpriteBatch gesetzt wurde: setColor oder die aktuelle SpriteBatch-Farbe wurde gelöscht, diese Methode wird nil zurückgeben.

r, g, b, a = SpriteBatch:getColor()

r	number	Die rote Komponente (0-255).
g	number	Die grüne Komponente (0-255).
b	number	Die blaue Komponente (0-255).
a	number	Die Alphakomponente (0-255).

SpriteBatch:getCount

Ruft die Menge der Sprites in der SpriteBatch.

count = SpriteBatch:getCount()

count

number

Die Menge der Sprites derzeit in der Charge.

SpriteBatch:getTexture

Ruft das von der SpriteBatch verwendete Bild oder Leinwand ab.

texture = SpriteBatch:getTexture()

texture

SpriteBatch:setBufferSize

Das Bild oder Leinwand für die Sprites.

SpriteBatch:set

Ändert ein Sprite in der Charge. Dies erfordert die Kennung, die durch add und addq zurückgegeben wird.

SpriteBatch:set( id, x, y, r, sx, sy, ox, oy, kx, ky )

id	number	Die Kennung des Sprites, die geändert wird.
x	number	Die Position, um das Objekt (x-Achse) zu zeichnen.
y	number	Die Position, um das Objekt (y-Achse) zu zeichnen.
r (0)	number	Orientierung (Bogenmaß).
sx (1)	number	Skalenfaktor (x-Achse).
sy (sx)	number	Skalenfaktor (y-Achse).
ox (0)	number	Ursprungsversatz (x-Achse).
oy (0)	number	Ursprungsversatz (y-Achse).
kx (0)	number	Scherfaktor (x-Achse).
ky (0)	number	Scherfaktor (y-Achse).

SpriteBatch:set( id, quad, x, y, r, sx, sy, ox, oy, kx, ky )

id	number	Die Kennung des Sprites, die geändert wird.
quad	Quad	Das Quad auf dem Bild der Charge verwendet.
x	number	Die Position, um das Objekt (x-Achse) zu zeichnen.
y	number	Die Position, um das Objekt (y-Achse) zu zeichnen.
r (0)	number	Orientierung (Bogenmaß).
sx (1)	number	Skalenfaktor (x-Achse).
sy (sx)	number	Skalenfaktor (y-Achse).
ox (0)	number	Ursprungsversatz (x-Achse).
oy (0)	number	Ursprungsversatz (y-Achse).
kx (0)	number	Scherfaktor (x-Achse).
ky (0)	number	Scherfaktor (y-Achse).

Legt die maximale Anzahl von Sprites fest, die der SpriteBatch halten kann. Bestehende Sprites im Batch (bis zum neuen Maximum) wird nicht gelöscht, wenn diese Funktion aufgerufen wird.

SpriteBatch:setBufferSize( size )

size

number

Die neue maximale Anzahl von Sprites, die die Charge halten kann.

SpriteBatch:setColor

Legt die Farbe fest, die für die nächsten Add- und Set-Operationen verwendet wird. Wenn Sie die Funktion ohne Argumente aufrufen, wird die Farbe gelöscht.

In der Version {{0.9.2}} und älter ist die globale Farbe, die mit love.graphics.setColor gesetzt wird, nicht auf dem SpriteBatch arbeiten, wenn irgendeines der Sprites seine eigene Farbe hat.

SpriteBatch:setColor( r, g, b, a )

r	number	Die Menge an Rot.
g	number	Die Menge an Grün.
b	number	Die Menge an Blau.
a (255)	number	Die Menge an Alpha.

SpriteBatch:setColor()

Deaktiviert alle pro-Sprite - Farben für diese SpriteBatch.

SpriteBatch:setTexture

Ersetzt das Bild oder die Leinwand für die Sprites.

SpriteBatch:setTexture( texture )

texture

Das neue Bild oder die Leinwand für die Sprites verwenden.

Text

Zeichnungstext.

Constructors

love.graphics.newText Erstellt eine neue Schriftart.

Functions

Text:add Fügt dem Textobjekt an der angegebenen Position zusätzlichen farbigen Text hinzu.

Text:addf Fügt dem Textobjekt an der angegebenen Position zusätzlichen formatierten / farbigen Text hinzu.

Text:set Ersetzt den Inhalt des Textobjekts durch einen neuen, unformatierten String.

Text:setf Ersetzt den Inhalt des Textobjekts durch einen neuen formatierten String.

Text:clear Löscht den Inhalt des Textobjekts.

Text:get/setFont Ersetzt die mit dem Text verwendete Schriftart.

Text:getDimensions Ruft die Breite und Höhe des Textes in Pixeln ab.

Text:getWidth Ruft die Breite des Textes in Pixel ab.

Text:getHeight Ruft die Höhe des Textes in Pixel ab.

Supertypes

Drawable Die Superklasse für alle Dinge, die auf den Bildschirm gezeichnet werden können.

Object Die Superklasse aller LÖVE-Typen.

Text:add

Fügt dem Textobjekt an der angegebenen Position zusätzlichen farbigen Text hinzu.

index = Text:add( textstring, x, y, angle, sx, sy, ox, oy, kx, ky )

index	number	Eine Indexnummer, die mit Text verwendet werden kann: getWidth oder Text: getHeight.
textstring	string	Der Text zum Hinzufügen zum Objekt.
x (0)	number	Die Position des neuen Textes auf der x-Achse.
y (0)	number	Die Position des neuen Textes auf der y-Achse.
angle (0)	number	Die Orientierung des neuen Textes im Bogenmaß
sx (1)	number	Skalenfaktor auf der x-Achse.
sy (sx)	number	Skalenfaktor auf der y-Achse.
ox (0)	number	Ursprungsversatz auf der x-Achse.
oy (0)	number	Origin-Offset auf der y-Achse.
kx (0)	number	Scher- / Schrägfaktor auf der x-Achse.
ky (0)	number	Scher- / Schrägfaktor auf der y-Achse.

index = Text:add( coloredtext, x, y, angle, sx, sy, ox, oy, kx, ky )

index	number	Eine Indexnummer, die mit Text verwendet werden kann: getWidth oder Text: getHeight.
coloredtext	table	Eine Tabelle mit Farben und Zeichenketten als neuer Text verwenden, in Form von {color1, string1, color2, string2, ...}.
coloredtext.color1	table	Eine Tabelle mit roten, grünen, blauen und optionalen Alpha-Komponenten, die als Farbe für den nächsten String in der Tabelle verwendet werden sollen, in Form von {rot, grün, blau, alpha}.
coloredtext.string1	string	Eine Zeichenfolge, die eine von der vorherigen Farbe angegebene Farbe hat.
coloredtext.color2	table	Eine Tabelle mit roten, grünen, blauen und optionalen Alpha-Komponenten, die als Farbe für den nächsten String in der Tabelle verwendet werden sollen, in Form von {rot, grün, blau, alpha}.
coloredtext.string2	string	Eine Zeichenfolge, die eine von der vorherigen Farbe angegebene Farbe hat.
coloredtext....	tables and strings	Zusätzliche Farben und Saiten.
x (0)	number	Die Position des neuen Textes auf der x-Achse.
y (0)	number	Die Position des neuen Textes auf der y-Achse.
angle (0)	number	Die Orientierung des neuen Textes im Bogenmaß
sx (1)	number	Skalenfaktor auf der x-Achse.
sy (sx)	number	Skalenfaktor auf der y-Achse.
ox (0)	number	Ursprungsversatz auf der x-Achse.
oy (0)	number	Origin-Offset auf der y-Achse.
kx (0)	number	Scher- / Schrägfaktor auf der x-Achse.
ky (0)	number	Scher- / Schrägfaktor auf der y-Achse.

Text:addf

Fügt dem Textobjekt an der angegebenen Position zusätzlichen formatierten / farbigen Text hinzu.

index = Text:addf( textstring, wraplimit, align, x, y, angle, sx, sy, ox, oy, kx, ky )

index	number	Eine Indexnummer, die mit Text verwendet werden kann: getWidth oder Text: getHeight.
textstring	string	Der Text zum Hinzufügen zum Objekt.
wraplimit	number	Die maximale Breite in Pixeln des Textes, bevor er automatisch in eine neue Zeile eingehüllt wird.
align	AlignMode	Die Ausrichtung des Textes.
x	number	Die Position des neuen Textes auf der x-Achse.
y	number	Die Position des neuen Textes auf der y-Achse.
angle (0)	number	Die Orientierung des Objekts im Bogenmaß.
sx (1)	number	Skalenfaktor auf der x-Achse.
sy (sx)	number	Skalenfaktor auf der y-Achse.
ox (0)	number	Ursprungsversatz auf der x-Achse.
oy (0)	number	Origin-Offset auf der y-Achse.
kx (0)	number	Scher- / Schrägfaktor auf der x-Achse.
ky (0)	number	Scher- / Schrägfaktor auf der y-Achse.

index = Text:addf( coloredtext, wraplimit, align, x, y, angle, sx, sy, ox, oy, kx, ky )

index	number	Eine Indexnummer, die mit Text verwendet werden kann: getWidth oder Text: getHeight.
coloredtext	table	Eine Tabelle mit Farben und Zeichenketten als neuer Text verwenden, in Form von {color1, string1, color2, string2, ...}.
coloredtext.color1	table	Eine Tabelle mit roten, grünen, blauen und optionalen Alpha-Komponenten, die als Farbe für den nächsten String in der Tabelle verwendet werden sollen, in Form von {rot, grün, blau, alpha}.
coloredtext.string1	string	Eine Zeichenfolge, die eine von der vorherigen Farbe angegebene Farbe hat.
coloredtext.color2	table	Eine Tabelle mit roten, grünen, blauen und optionalen Alpha-Komponenten, die als Farbe für den nächsten String in der Tabelle verwendet werden sollen, in Form von {rot, grün, blau, alpha}.
coloredtext.string2	string	Eine Zeichenfolge, die eine von der vorherigen Farbe angegebene Farbe hat.
coloredtext....	tables and strings	Zusätzliche Farben und Saiten.
wraplimit	number	Die maximale Breite in Pixeln des Textes, bevor er automatisch in eine neue Zeile eingehüllt wird.
align	AlignMode	Die Ausrichtung des Textes.
x	number	Die Position des neuen Textes auf der x-Achse.
y	number	Die Position des neuen Textes auf der y-Achse.
angle (0)	number	Die Orientierung des Objekts im Bogenmaß.
sx (1)	number	Skalenfaktor auf der x-Achse.
sy (sx)	number	Skalenfaktor auf der y-Achse.
ox (0)	number	Ursprungsversatz auf der x-Achse.
oy (0)	number	Origin-Offset auf der y-Achse.
kx (0)	number	Scher- / Schrägfaktor auf der x-Achse.
ky (0)	number	Scher- / Schrägfaktor auf der y-Achse.

Text:clear

Löscht den Inhalt des Textobjekts.

Text:clear()

Text:getDimensions

Ruft die Breite und Höhe des Textes in Pixeln ab.

width, height = Text:getDimensions()

width	number	Die Breite des Textes. Wenn mehrere Substrings mit Text hinzugefügt wurden, wird die Breite des letzten Substrings zurückgegeben.
height	number	Die Höhe des Textes. Wenn mehrere Substrings mit Text hinzugefügt wurden, wird die Höhe des letzten Substrings zurückgegeben.

width, height = Text:getDimensions( index )

Liefert die Breite und die Höhe von einem spezifischen Sub-String , die vorher aufgenommen , um das Text Objekt.

width	number	Die Breite des Substrings (vor Skalierung und anderen Transformationen).
height	number	Die Höhe der Sub-String (vor Skalierung und andere Transformationen).
index	number	Eine Indexzahl, die von Text zurückgegeben wird: add oder Text: addf.

Text:getFont

Ruft die mit dem Textobjekt verwendete Schriftart ab.

font = Text:getFont()

font

Die Schriftart, die mit diesem Textobjekt verwendet wird.

Text:getHeight

Ruft die Höhe des Textes in Pixel ab.

height = Text:getHeight()

height

number

Die Höhe des Textes. Wenn mehrere Substrings mit Text hinzugefügt wurden, wird die Höhe des letzten Substrings zurückgegeben.

height = Text:getHeight( index )

Ruft die Höhe eines bestimmten Sub-String, der die zuvor hinzugefügt wurde Text Objekt.

height	number	Die Höhe der Sub-String (vor Skalierung und andere Transformationen).
index	number	Eine Indexzahl, die von Text zurückgegeben wird: add oder Text: addf.

Text:getWidth

Ruft die Breite des Textes in Pixel ab.

width = Text:getWidth()

width

number

Die Breite des Textes. Wenn mehrere Substrings mit Text hinzugefügt wurden, wird die Breite des letzten Substrings zurückgegeben.

width = Text:getWidth( index )

Ruft die Breite einer bestimmten Sub-Zeichenkette, die die vorher aufgenommen Text -Objekt.

width	number	Die Breite des Substrings (vor Skalierung und anderen Transformationen).
index	number	Eine Indexzahl, die von Text zurückgegeben wird: add oder Text: addf.

Text:set

Ersetzt den Inhalt des Textobjekts durch einen neuen, unformatierten String.

Text:set( textstring )

textstring

string

Die neue Textfolge, die verwendet werden soll.

Text:set( coloredtext )

coloredtext	table	Eine Tabelle mit Farben und Zeichenketten als neuer Text verwenden, in Form von {color1, string1, color2, string2, ...}.
coloredtext.color1	table	Eine Tabelle mit roten, grünen, blauen und optionalen Alpha-Komponenten, die als Farbe für den nächsten String in der Tabelle verwendet werden sollen, in Form von {rot, grün, blau, alpha}.
coloredtext.string1	string	Eine Zeichenfolge, die eine von der vorherigen Farbe angegebene Farbe hat.
coloredtext.color2	table	Eine Tabelle mit roten, grünen, blauen und optionalen Alpha-Komponenten, die als Farbe für den nächsten String in der Tabelle verwendet werden sollen, in Form von {rot, grün, blau, alpha}.
coloredtext.string2	string	Eine Zeichenfolge, die eine von der vorherigen Farbe angegebene Farbe hat.
coloredtext....	tables and strings	Zusätzliche Farben und Saiten.

Text:set()

Löscht den Inhalt der Text Objekt.

Text:setf

Ersetzt den Inhalt des Textobjekts durch einen neuen formatierten String.

Text:setf( textstring, wraplimit, align )

textstring	string	Die neue Textfolge, die verwendet werden soll.
wraplimit	number	Die maximale Breite in Pixeln des Textes, bevor er automatisch in eine neue Zeile eingehüllt wird.
align ("left")	AlignMode	Die Ausrichtung des Textes.

Text:setf( coloredtext, wraplimit, align )

coloredtext	table	Eine Tabelle mit Farben und Zeichenketten als neuer Text verwenden, in Form von {color1, string1, color2, string2, ...}.
coloredtext.color1	table	Eine Tabelle mit roten, grünen, blauen und optionalen Alpha-Komponenten, die als Farbe für den nächsten String in der Tabelle verwendet werden sollen, in Form von {rot, grün, blau, alpha}.
coloredtext.string1	string	Eine Zeichenfolge, die eine von der vorherigen Farbe angegebene Farbe hat.
coloredtext.color2	table	Eine Tabelle mit roten, grünen, blauen und optionalen Alpha-Komponenten, die als Farbe für den nächsten String in der Tabelle verwendet werden sollen, in Form von {rot, grün, blau, alpha}.
coloredtext.string2	string	Eine Zeichenfolge, die eine von der vorherigen Farbe angegebene Farbe hat.
coloredtext....	tables and strings	Zusätzliche Farben und Saiten.
wraplimit	number	Die maximale Breite in Pixeln des Textes, bevor er automatisch in eine neue Zeile eingehüllt wird.
align ("left")	AlignMode	Die Ausrichtung des Textes.

Text:setf()

Clears the contents of the Text object.

Text:setFont

Ersetzt die mit dem Text verwendete Schriftart.

Text:setFont( font )

font

Die neue Schriftart, die mit diesem Textobjekt verwendet werden soll.

Die Superklasse für alle zeichenbaren Objekte welche eine Textur repräsentieren.

Alle Texturen können mit Quads gezeichnet werden. Texture ist ein abstrakter Datentyp und kann daher nicht direkt erstellt werden.

Supertypes

Drawable Die Superklasse für alle Dinge, die auf den Bildschirm gezeichnet werden können.

Object Die Superklasse aller LÖVE-Typen.

Subtypes

Canvas Ein Offscreen-Buffer welcher für das sogenannte "Off-screen Rendering" verwendet wird.

Image Ein Bild, welches gezeichnet werden kann.

Video

Ein ziehbares Video.

Constructors

love.graphics.newVideo Erstellt ein neues ziehbares Video.

Functions

Video:play Startet das Video.

Video:isPlaying Ermittelt, ob das Video gerade abgespielt wird.

Video:pause Pausiert das Video.

Video:tell/seek Stellt die aktuelle Wiedergabeposition des Videos ein.

Video:rewind Das Video wird zum Anfang zurückgespult.

Video:get/setSource Setzt die Audioquelle, die für die Wiedergabe des Videos verwendet wird.

Video:get/setFilter Legt die beim Zeichnen des Videos verwendeten Skalierungsfilter fest.

Video:getDimensions Erhält die Breite und Höhe des Videos in Pixeln.

Video:getWidth Ruft die Breite des Videos in Pixeln ab.

Video:getHeight Ermittelt die Höhe des Videos in Pixeln.

Supertypes

Drawable Die Superklasse für alle Dinge, die auf den Bildschirm gezeichnet werden können.

Object Die Superklasse aller LÖVE-Typen.

Video:getDimensions

Erhält die Breite und Höhe des Videos in Pixeln.

width, height = Video:getDimensions()

width	number	Die Breite des Videos.
height	number	Die Höhe des Videos.

Video:getFilter

Ruft die Skalierungsfilter ab, die beim Zeichnen des Videos verwendet wurden.

min, mag, anisotropy = Video:getFilter()

min	FilterMode	Der Filtermodus, der beim Skalieren des Video-Down verwendet wird.
mag	FilterMode	Der Filtermodus, der beim Skalieren des Videos verwendet wird.
anisotropy (1)	number	Maximale Menge an anisotroper Filterung.

Video:getHeight

Ermittelt die Höhe des Videos in Pixeln.

height = Video:getHeight()

height

number

Die Höhe des Videos.

Video:getSource

Ruft die Audioquelle ab, die für die Wiedergabe des Videos verwendet wird. Kann nil zurückkehren, wenn das Video kein Audio hat oder wenn Video: setSource mit einem nil-Argument aufgerufen wird.

source = Video:getSource()

source

Die Audioquelle, die für die Audiowiedergabe verwendet wird, oder nil, wenn das Video kein Audio hat.

Video:getWidth

Ruft die Breite des Videos in Pixeln ab.

width = Video:getWidth()

width

number

Die Breite des Videos.

Video:isPlaying

Ermittelt, ob das Video gerade abgespielt wird.

playing = Video:isPlaying()

playing

boolean

Ob das Video spielt.

Video:pause

Pausiert das Video.

Video:pause()

Video:play

Startet das Video. Damit das Video auf dem Bildschirm erscheinen kann, muss es mit love.graphics.draw gezeichnet werden.

Video:play()

Video:rewind

Das Video wird zum Anfang zurückgespult.

Video:rewind()

Video:seek

Stellt die aktuelle Wiedergabeposition des Videos ein.

Video:seek( offset )

offset

number

Die Zeit in Sekunden seit Beginn des Videos.

Video:setFilter

Legt die beim Zeichnen des Videos verwendeten Skalierungsfilter fest.

Video:setFilter( min, mag, anisotropy )

min	FilterMode	Der Filtermodus, der beim Skalieren des Video-Down verwendet wird.
mag	FilterMode	Der Filtermodus, der beim Skalieren des Videos verwendet wird.
anisotropy (1)	number	Maximale Menge an anisotroper Filterung.

Video:setSource

Setzt die Audioquelle, die für die Wiedergabe des Videos verwendet wird. Die Audio-Quelle steuert auch die Wiedergabegeschwindigkeit und die Synchronisation.

Video:setSource( source )

source (nil)