(Anciennement ChangeCursorGraphic, désormais obsolète)
Mouse.ChangeModeGraphic(CursorMode, int slot)
Change le graphique du mode de curseur spécifié pour celui contenu à l'emplacement
SLOT. Ceci change le graphique du mode de façon permanente. Cette fonction peut être
utile si vous avez besoin de plus de modes de curseurs qu'il n'en est prévu.
Exemple :
mouse.ChangeModeGraphic(eModeLookAt, 120);
changera le graphique du curseur en mode “Regarder” pour lui attribuer l'image importée à l'emplacement 120
du Sprite Manager.
Voir Aussi : Mouse.ChangeModeHotspot,
Mouse.ChangeModeView, Mouse.Mode,
Mouse.GetModeGraphic
(Anciennement ChangeCursorHotspot, désormais obsolète)
Mouse.ChangeModeHotspot(CursorMode, int x, int y)
Change de façon permanente le point de réaction du graphique du curseur pour le point
aux coordonnées (X,Y) de l'image. Cela correspond au décalage sur le graphique à partir
duquel le clic est considéré.
(0,0) est le coin haut gauche du graphique du curseur.
Exemple :
mouse.ChangeModeHotspot(eModeWalkto, 10, 10);
placera le point de réaction du curseur pour le mode Marcher aux coordonnées (10,10) de l'image utilisée.
Voir Aussi : Mouse.ChangeModeGraphic,
Mouse.ChangeModeView
Mouse.ChangeModeView(CursorMode, int vue)Utilise la vue numéro VUE pour le mode de curseur spécifié.
mouse.ChangeModeView(eModeLookAt, YEUXROULANT);
changera la vue du curseur Regarder pour la vue numéro YEUXROULANT.
Voir Aussi : Mouse.ChangeModeGraphic,
Mouse.ChangeModeHotspot
(Anciennement DisableCursorMode, désormais obsolète)
Mouse.DisableMode(int mode)
Désactive le mode de curseur MODE. Il ne sera plus possible d'attribuer ce mode
à la souris tant qu'il sera désactivé (en utilisant UseModeGraphic par exemple).
Cette fonction grise également et désactive tout bouton d'interface dont le clic
gauche est associé à la commande “Définit mode à X”, où X est égal à MODE.
Si le mode actuel du curseur est MODE, alors la machine passera le curseur dans
le prochain mode disponible.
Exemple :
mouse.DisableMode(eModeWalkto);
désactivera le mode Marcher jusqu'à ce qu'il soit réactivé.
Voir Aussi : Mouse.EnableMode
(Anciennement EnableCursorMode, désormais obsolète)
Mouse.EnableMode(int mode)
Réactive le mode de curseur MODE. Cette fonction active également tout
bouton d'interface qui avait été désactivé par la commande DisableMode.
Exemple :
mouse.EnableMode(eModeWalkto);
activera le mode de curseur Marcher qui au préalable avait été désactivé.
Voir Aussi : Mouse.DisableMode
static int Mouse.GetModeGraphic(CursorMode)Retourne le numéro de l'image (sprite) utilisée pour le mode de curseur spécifié.
Display("L'image actuelle du curseur de la souris est la %d.", mouse.GetModeGraphic(mouse.Mode));
affichera le numéro de l'image du curseur en cours d'utilisation.
Voir aussi : Mouse.ChangeModeGraphic
(Anciennement fonction globale IsButtonDown, désormais obsolète)
Mouse.IsButtonDown(MouseButton)
Vérifie si l'utilisateur maintient actuellement enfoncé le bouton de sa souris.
BUTTON sera soit eMouseLeft (bouton gauche), soit eMouseRight (bouton droit).
Le bouton du milieu n'est pas supporté par cette fonction.
Retourne 1 si le bouton est actuellement pressé, sinon 0. Ceci peut être utilisé
pour calculer la longueur d'un clic ou des effets similaires.
Exemple :
int timer = 0; // (en haut du fichier script) if (mouse.IsButtonDown(eMouseRight)) { if (timer == 40) { Display("Vous avez appuyé sur le bouton droit durant une seconde"); timer = 0; } else { timer++; } }
affichera le message si le joueur presse le bouton droit pendant 1 seconde.
Voir Aussi : IsKeyPressed
(Anciennement SaveCursorForLocationChange, désormais obsolète)
Mouse.SaveCursorUntilItLeaves()
Garde en mémoire le curseur actuel de la souris, et le restaure lorsque la souris quitte le hotspot,
l'objet ou le personnage actuel.
Ceci vous permet de changer temporairement le curseur de la souris lorsque celle-ci survole un hotspot,
et de lui redonner son ancien curseur automatiquement lorsque le joueur l'éloigne du hotspot.
NOTE : Vous devez appeler cette fonction AVANT d'appliquer le nouveau curseur temporaire,
sinon ce sera le nouveau curseur qui sera gardé en mémoire par cette commande.
Exemple :
mouse.SaveCursorUntilItLeaves(); mouse.Mode = eModeTalk;
utilisera le mode de curseur Parler tant que la souris survolera l'objet actuel.
Voir Aussi : Mouse.Mode
(Anciennement SetNextCursorMode, désormais obsolète)
Mouse.SelectNextMode()
Passe le curseur de la souris au prochain mode disponible. Ceci est utile pour gérer le clic
droit à la façon des jeux Sierra, où celui-ci permet de changer de mode. Cette fonction choisira
le prochain mode défini comme Standard Mode, et utilisera également le mode Utiliser Inventaire
(Use Inventory) si le joueur a un objet d'inventaire d'activé.
Voir Aussi : Mouse.Mode
(Anciennement SetMouseBounds, désormais obsolète)
Mouse.SetBounds(int gauche, int haut, int droite, int bas)
Restreint la zone d'écran dans laquelle la souris peut se déplacer. Les quatre
paramètres correspondent aux coordonnées définissant les bords du rectangle qui correspond
à la zone de déplacement de la souris. Ils sont compris entre les valeurs habituelles : (0,0) - (320,200).
Vous pouvez passer (0,0,0,0) pour désactiver la restriction et permettre à la souris de se déplacer sur tout
l'écran, de façon normale.
NOTE : L'effet de cette fonction dure jusqu'à ce que le joueur quitte la pièce,
après quoi la restriction n'aura plus lieu.
Exemple :
mouse.SetBounds(160, 100, 320, 200);
limitera la zone de déplacement du curseur au quart bas droit de l'écran.
Voir Aussi : Mouse.SetPosition
(Anciennement SetMousePosition, désormais obsolète)
Mouse.SetPosition(int x, int y)
Place le pointeur de la souris aux coordonnées d'écran (X,Y). Celles-ci sont comprises
dans l'ensemble habituel : 0,0 - (320,200/240). Les variables mouse.x et mouse.y seront mises
à jour de façon à correspondre à la nouvelle position.
NOTE : N'utilisez cette commande que lorsque c'est absolument nécessaire. Déplacer le curseur
de la souris à la place du joueur est la meilleure façon de l'énerver si vous le faîtes trop souvent
durant le jeu.
Exemple :
mouse.SetPosition(160, 100);
placera le curseur de la souris au centre de l'écran.
Voir Aussi : Mouse.SetBounds
(Anciennement RefreshMouse, désormais obsolète)
Mouse.Update();
Mettra à jour les variables globales “mouse.x” et “mouse.y” selon la position
actuelle de la souris. Normalement, ces variables sont définies avant tout appel
de fonction. Cependant, si vous avez écrit un très long script où la souris peut
avoir bougé depuis le début de son exécution, et que vous devez récupérer la position
exacte de la souris, alors cette commande mettra les variables à jour.
Exemple :
Display("La souris se trouvait aux coordonnées : %d, %d.", mouse.x, mouse.y); mouse.Update(); Display("La souris se trouve maintenant aux coordonnées : %d, %d.", mouse.x, mouse.y);
affichera la position à laquelle se trouve la souris avant l'affichage de chaque message.
(Anciennement SetDefaultCursor, désormais obsolète)
Mouse.UseDefaultGraphic()
Redonne son apparence normale au curseur de la souris, celle définie par défaut
pour le mode de curseur actuel. Utilisez ceci pour restaurer l'image du curseur
après l'avoir changée avec la fonction UseModeGraphic.
Voir Aussi : Mouse.UseModeGraphic
(Anciennement SetMouseCursor, désormais obsolète)
Mouse.UseModeGraphic(CursorMode)
Change l'apparence du curseur de la souris dans le mode de curseur spécifié.
Contrairement à la propriété Mouse.Mode, ceci ne change pas le mode considéré
lors d'un clic sur un élément interactif (hotspot, personnage, objet).
Ceci est utile pour afficher temporairement un curseur “Attente”.
Exemple :
mouse.UseModeGraphic(eModeWait);
utilisera le graphique du mode 'Wait' ('Attente') spécifié dans la fenêtre Cursors de l'Editeur.
Voir Aussi : Mouse.ChangeModeGraphic,
Mouse.Mode, Mouse.UseDefaultGraphic
(Anciennement GetCursorMode, désormais obsolète)
(Anciennement SetCursorMode, désormais obsolète)
int Mouse.Mode;
Retourne/Définit le mode actuel qu'utilise le curseur de la souris. La valeur est un des modes
de curseur définis dans la fenêtre Curseurs de l'Editeur (mais précédé de “eMode”). Par exemple,
un mode de curseur nommé “Walk to” dans la fenêtre Curseurs donnerait eModeWalkto .
Redéfinir cette propriété change et l'apparence du curseur, et le mode considéré lors d'un
clic sur une zone interactive (hotspot, personnage, objet).
Exemple :
if (mouse.Mode == eModeWalkto) { // code ici }
exécutera le code seulement si le mode de curseur actuel est le mode eModeWalkto (Marcher).
Voir Aussi : Mouse.SaveCursorUntilItLeaves,
Mouse.UseModeGraphic, Mouse.SelectNextMode
(Anciennement HideMouseCursor, désormais obsolète)
(Anciennement ShowMouseCursor, désormais obsolète)
bool Mouse.Visible;
Retourne/Définit si le curseur de la souris est visible. Cette propriété vaut initialement
true par défaut, mais la redéfinir à false est utile pour cacher le curseur
un certain moment dans des situations où vous ne voulez pas qu'il gêne.
Si vous désirez un style Lucasarts où le curseur de la souris n'est jamais visible durant
les scène cinématiques (cutscenes), alors une solution plus facile serait d'importer simplement
une image totalement transparente à utiliser comme graphique pour le curseur d'attente, de façon
à ce que ce curseur soit totalement invisible.
Exemple :
mouse.Visible = false; Wait(40); mouse.Visible = true;
cache la souris, attend une seconde, puis la montre à nouveau.
Voir Aussi : Mouse.UseModeGraphic