Arrière-plans

Les routines suivantes peuvent être utilisées pour créer de nouvels arrière-plans ou les supprimer.

background_duplicate(ind) Crée une copie de l'arrière-plan d'index ind. La commande retourne l'index du nouvel arrière-plan. Si une erreur survient, la valeur -1 sera retournée.
background_assign(ind, back) Affecte l'arrière-plan back indiqué à l'arrière-plan ind. Cette commande vous permet donc de faire une copie d'un arrière-plan.
background_add(fname, transparent, smooth, preload) Ajoute l'image stockée dans le fichier de nom fname dans la liste des ressources relatives aux arrière-plans. Seules les images de type BMP et JPG peuvent être manipulées. transparent indique si l'image doit être partiellement transparente. smooth précise si l'on doit arrondir les bords. preload indique si l'image doit être préchargée dans la mémoire de textures. La fonction retourne l'index du nouvel arrière-plan que vous pourrez ensuite utiliser pour l'afficher ou l'assigner à la variable background_index[0] afin de le rendre visible dans la room courante. Si une erreur survient, la valeur -1 sera retournée.
background_replace(ind, fname, transparent, smooth, preload) Identique à la fonction précédente sauf qu'ici, seul l'arrière-plan d'index ind sera remplacé. La fonction retourne un résultat précisant si celle-ci s'est bien déroulée. Dans le cas où l'arrière-plan était déjà visible dans la room, il sera également remplacé .
background_create_color(w, h, col, preload) Crée un arrière-plan de la dimension et de la couleur indiquées. Cette commande retourne l'index du nouvel arrière-plan. Si une erreur survient à ce stade, la valeur -1 sera retournée.
background_create_gradient(w, h, col1, col2, kind, preload) Crée un arrière-plan de type arc-en-ciel (gradient) avec les dimensions indiquées. col1 et col2 précisent les deux couleurs. kind est une nombre entre 0 et 5 indiquant le type d'arc-en-ciel : 0=horizontal 1=vertical, 2= rectangle, 3=ellipse, 4=double horizontal, 5=double vertical. La commande retourne l'index du nouvel arrière-plan. Si une erreur survient, la valeur -1 sera retournée.
background_create_from_screen(x, y, w, h, transparent, smooth, preload) Crée un arrière-plan en copiant la zone indiquée de l'écran. Ceci vous permettra de créer toute sorte d'arrière-plan. Affichez l'image à l'écran en utilisant les fonctions habituelles d'affichage puis créez un arrière-plan en utilisant cette fonction (si vous ne placez pas la fonction dans l'événement d'affichage, vous aurez la possibilité de créer un arrière-plan qui ne sera pas visible sur l'écran simplement en ne rafraîchissant pas l'écran). Les autres paramètres restent les mêmes que précédemment. La fonction retourne l'index du nouvel arrière-plan. Une précision importante est à faire ici. Lorsque nous parlons d'écran, il est fait référence à la zone d'affichage. Le fait qu'il y ait une fenêtre à l'écran et que l'image puisse être redimensionnée dans cette fenêtre n'a pas ici d'importance.
background_create_from_surface(id, x, y, w, h, transparent, smooth, preload) Crée un arrière-plan en copiant la zone indiquée de la surface d'ID id. Cela vous permet de créer tout arrière-plan souhaité. Afficher l'image sur la surface en utilisant les fonctions habituelles d'affichage puis créez un arrière-plan à l'aide de cette fonction. Veuillez noter que les valeurs alpha seront conservées dans l'arrière-plan.
background_delete(ind) Efface l'arrière-plan de la mémoire, libérant ainsi la mémoire allouée pour celui-ci.

La routine suivante permet de changer l'apparence d'un arrière-plan.

background_set_alpha_from_background(ind, back) Change les valeurs alpha (transparence) de l'arrière-plan d'index ind en utilisant les valeurs de tonalité de l'arrière-plan back. Cette opération ne peut être annulée.

<< Traduction française par Philippe Ragni - (2005) >>