Sprites

Die folgenden Routinen sind für das Manipulieren von Sprite-Eigenschaften vorhanden.:

sprite_set_offset(ind, xoff, yoff) Setzt das Offset des Sprites mit dem angegebenen Index.
sprite_set_bbox_mode(ind, mode) Setzt den Begrenzungsrahmen des Sprites (0=automatisch, 1=gesamtes Bild, 2=manuell).
sprite_set_bbox(ind, left, top, right, bottom) Setzt den Begrenzungsrahmen des Sprites mit dem angegebenen Index. Funktioniert nur, wenn dieser als manuell eingestellt wurde.
sprite_set_precise(ind, mode) Soll das Sprite mit dem angegebenen Index präzise Kollisionserkennung benützen (true oder false).

Die folgenden Routinen können für das Erstellen oder Entfernen neuer Sprites verwendet werden.

sprite_duplicate(ind) Erstellt ein Duplikat des Sprites mit dem angegebenen Index. Es gibt den Index des neuen Sprites zurück. Wenn ein Fehler passiert, wird �1 zurückgegeben.
sprite_assign(ind, spr) Verbindet das angegebene Sprite mit dem Sprite ind. Dies macht einfach eine Kopie des aktuellen Sprites. Auf diese Weise kannst du ein existierendes Sprite einem andere zuweisen, z.B. einem neuen Sprite.
sprite_merge(ind1, ind2) Vermischt die Bilder vom Sprite ind2 in den Sprite ind1, fügt ihm am Ende hinzu. Wenn die Größe nicht mit dem Sprite übereinstimmt, wird dieser verändert. Sprite ind2 wird nicht gelöscht!
sprite_add(fname, imgnumb, precise, transparent, smooth, preload, xorig, yorig) Fügt ein Bild aus einer Datei den Sprite-Ressourcen hinzu. Nur bmp, jpg und gif Bilder können geladen werden. Wenn das Bild bmp oder jpg ist kann es als Animationsstreifen mit verschiedenen Subimages nebeneinander geladen werden. imgnumb gibt deren Zahl an (1 für ein einzelnes Bild). Für (animierte) gifs wird dieses Argument ignoriert; die Zahl der Bilder in der gif Datei wird genutzt. precise gibt an, ob präzise Kollisionsüberprüfung genutzt werden soll. transparent gibt an, ob das Bild teiltransparent sein soll. smooth gibt an, ob die Ecken geglättet werden sollen. preload gibt an, ob die Textur in der Speicher vorgeladen werden soll. xorig und yorig geben die Position des Bezugspunktes an. Die Funktion gibt den Index des neuen Sprites zurück um es zu zeichnen oder es über die Variable sprite_index einer Instanz zuzuweusen. Falls ein Fehler auftritt wird -1 zurückgegeben.
sprite_replace(ind, fname, imgnumb, precise, transparent, smooth, preload, xorig, yorig) Dasselbe wie oben, aber das Sprite ind wird damit ersetzt. Es wird zurückgegeben, ob es erfolgreich war.
sprite_create_from_screen(x, y, w, h, precise, transparent, smooth, preload, xorig, yorig) Erstellt ein Sprite von der angegebenen Bildfläche. Dies macht es möglich, ein beliebiges Sprite zu erstellen. Zeichne mit den Zeichenfunktionen ein Bild auf dem Bildschirm und mache dann ein Sprite davon. (Wenn du es nicht im Draw Event machst wird dies sogar nicht auf dem Bildschirm angezeigt.) Die anderen Parameter sind wie oben. Die Funktion gibt den Index des neuen Sprites wider. Vorsicht ist hier geboten. Auch wenn wir hier über den Bildschirm reden, ist es die Zeichenregion die zählt. Das dort möglicherweise ein Fenster ist und dies skaliert wird wird nicht beachtet.
sprite_add_from_screen(ind, x, y, w, h) Fügt ein Feld am Bildschirm als nächstes Einzelbild eine Sprites mit dem index ind.
sprite_create_from_surface(id, x, y, w, h, precise, transparent, smooth, preload, xorig, yorig) Erzeugt ein Sprite von der Oberfläche mit der angegebenen ID. Dies macht es möglich jede Art von Sprite zu erstellen, in dem du das was du willst auf eine Oberfläche zeichnest und daraus ein Sprite machst. Die Funktion gibt den Index des neuen Sprites zurück. Beachte das die Alphawerte im Sprite beibehalten werden.
sprite_add_from_surface(ind, id, x, y, w, h) Fügt einen Bereich der Oberfläche id dem Sprite ind als neues Subimage hinzu.
sprite_delete(ind) Löscht das Sprites aus dem Speicher, gibt den Speicher frei.

Die folgenden Routinen existieren, um das Aussehen eines Sprites zu ändern.

sprite_set_alpha_from_sprite(ind, spr) Ändert die Alpha (Transparenz) Werte des Sprites mit dem Index ind mit den Werten des Sprites spr. Dies kann nicht rückgängig gemacht werden.