Pages traduites Pages à traduire Pages en cours de traduction
A propos
 

Fonctions et propriétés de la Souris (Mouse)

ChangeModeGraphic

(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


ChangeModeHotspot

(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


ChangeModeView

Mouse.ChangeModeView(CursorMode, int vue)
Utilise la vue numéro VUE pour le mode de curseur spécifié.

Vous pouvez donner la valeur -1 à vue pour cesser l'animation du curseur.

Ceci vous permet de changer dynamiquement la vue utilisée pour l'animation du curseur lorsque le jeu est lancé.

Exemple :
mouse.ChangeModeView(eModeLookAt, YEUXROULANT);

changera la vue du curseur Regarder pour la vue numéro YEUXROULANT.

Voir Aussi : Mouse.ChangeModeGraphic, Mouse.ChangeModeHotspot


DisableMode

(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


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


GetModeGraphic

static int Mouse.GetModeGraphic(CursorMode)
Retourne le numéro de l'image (sprite) utilisée pour le mode de curseur spécifié.

Cela peut être utile si vous voulez la changer manuellement avec ChangeModeGraphic tout en gardant en mémoire l'image précédente.

Exemple :
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


IsButtonDown

(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


SaveCursorUntilItLeaves

(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


SelectNextMode

(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


SetBounds

(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


SetPosition (mouse)

(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


Update

(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.


UseDefaultGraphic

(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


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


Mode propriété (mouse)

(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


Visible propriété (mouse)

(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

 
ags65.txt · Dernière modification: 28/04/2011 12:07 par kitai
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki