love.mouse.newCursor (Français)

Disponible depuis LÖVE 0.9.0
Ce-tte function n'est pas supporté-e par des versions plus anciennes.

Crée un nouvel objet Cursor matériel à partir d'un fichier image ou d'un ImageData.

Les curseurs matériels sont indépendants de la vitesse de rafraîchissement et fonctionnent de la même façon que les curseurs normaux des systèmes d'exploitation. Contrairement au dessin d'une image aux coordonnées actuelles de la souris, les curseurs matériels n'ont jamais de retards visibles entre le moment où la souris est déplacée et le moment ou la position du curseur est mise à jour, même à des taux de rafraîchissement bas.

Le « hot spot » est le point que le système d'exploitation utilise pour déterminer ce qui a été cliqué et à quelle position le curseur de la souris se situe. Par exemple, le pointeur en forme de flèche habituel à normalement son « hot spot » en haut à gauche de l'image, tandis-qu'une croix de viseur l'a en son milieu.


O.png Cette fonction peut être lente si elle est appelée de façon répétée, comme depuis love.update ou love.draw. Si vous devez utiliser souvent une ressource spécifique, créez la une seule fois, et conservez la quelque part, elle peut être réutilisée !  



Fonction

Synopsis

cursor = love.mouse.newCursor( imageData, hotx, hoty )

Arguments

ImageData (Français) imageData
L'ImageData à utiliser comme nouveau curseur.
number (Français) hotx (0)
La coordonnée x dans l'ImageData de l'hot spot du curseur.
number (Français) hoty (0)
La coordonnée y dans l'ImageData de l'hot spot du curseur.

Retourne

Cursor (Français) cursor
Le nouvel objet Cursor.

Fonction

Synopsis

cursor = love.mouse.newCursor( filename, hotx, hoty )

Arguments

string (Français) filename
Chemin de l'image à utiliser pour le nouveau curseur.
number (Français) hotx (0)
La coordonnée x dans l'image de l'hot spot du curseur.
number (Français) hoty (0)
La coordonnée y dans l'image de l'hot spot du curseur.

Retourne

Cursor (Français) cursor
Le nouvel objet Cursor.

Fonction

Synopsis

cursor = love.mouse.newCursor( fileData, hotx, hoty )

Arguments

FileData (Français) fileData
Données de l'image à utiliser pour le nouveau curseur.
number (Français) hotx (0)
La coordonnée x dans l'image de l'hot spot du curseur.
number (Français) hoty (0)
La coordonnée y dans l'image de l'hot spot du curseur.

Retourne

Cursor (Français) cursor
Le nouvel objet Cursor.

Voir également


Autres langues