La Fenêtre

Les jeux actuels se déroulent habituellement dans des fenêtres. La fenêtre de jeu posséde un certain nombre de propriétés, comme la présence ou non d'une bordure ou encore un affichage en mode plein écran, etc. Normalement, ces propriétés seront réglées à partir de Game Settings. Mais vous pouvez les changer également pendant le jeu. A cet effet, les fonctions suivantes existent :

window_set_visible(visible) Indique si la fenêtre doit être visible ou non. Habituellement, vous souhaiterez que la fenêtre reste visible durant tout le jeu. Le programme ne recevra pas les événements clavier si la fenêtre est invisible.
window_get_visible() Retourne si la fenêtre de jeu est visible.
window_set_fullscreen(full) Indique que la fenêtre doit être affichée en mode plein écran.
window_get_fullscreen() Retourne si la fenêtre est affichée en plein écran.
window_set_showborder(show) Indique que l'on doit afficher la bordure autour de la fenêtre (la bordure ne sera jamais affichée en mode plein écran).
window_get_showborder() Retourne si la bordure autour de la fenêtre est affichée en mode fenêtré.
window_set_showicons(show) Indique que les icônes de bordure de fenêtre (icônification, maximisation et fermeture) doivent être affichées (ces icônes ne seront jamais affichées en mode plein écran).
window_get_showicons() Retourne si les icônes de bordure de fenêtre sont affichées en mode fenêtré.
window_set_stayontop(stay) Indique que la fenêtre doit toujours être affichée par dessus les autres fenêtres.
window_get_stayontop() Retourne si la fenêtre est toujours affichée par dessus les autres fenêtres.
window_set_sizeable(sizeable) Indique que la fenêtre est redimensionnable par le joueur (le joueur ne peut le faire que si la bordure de fenêtre est affichée et que la fenêtre ne soit pas en mode plein écran).
window_get_sizeable() Retourne si la fenêtre est redimensionnable par le joueur.
window_set_caption(caption) Renseigne la chaîne contenant le nom de la fenêtre. Habituellement, vous indiquerez ce nom lors de la conception de la room, nom qui pourra être changé grâce à la variable room_caption. Aussi, cette fonction ne sera pas généralement utile sauf si vous dessinez la room vous-même et ne laissez donc pas Game Maker le faire pour vous. Le titre de la fenêtre n'est visible que si celle-ci posséde une bordure et si on n'est pas en mode plein écran.
window_get_caption() Retourne le titre de la fenêtre.
window_set_cursor(curs) Indique le curseur de la souris à utiliser dans la fenêtre. Il vous est possible d'utiliser les constantes suivantes :

cr_default
cr_none
cr_arrow
cr_cross
cr_beam
cr_size_nesw
cr_size_ns
cr_size_nwse
cr_size_we
cr_uparrow
cr_hourglass
cr_drag
cr_nodrop
cr_hsplit
cr_vsplit
cr_multidrag
cr_sqlwait
cr_no
cr_appstart
cr_help
cr_handpoint
cr_size_all

En particulier, pour cacher le curseur de la souris, utiliez la valeur cr_none.
window_get_cursor() Retourne le curseur utilisé dans la fenêtre.
window_set_color(color) Fixe la couleur de la partie de la fenêtre non utilisée pour afficher la room.
window_get_color() Retourne la couleur de la fenêtre.
window_set_region_scale(scale, adaptwindow) Si la fenêtre est plus large que la room actuelle, la room sera normalement affichée dans une région centrée dans la fenêtre. Il est possible d'indiquer que la room doit être mise à l'échelle afin de remplir entièrement la fenêtre ou seulement une partie de celle-ci. Une valeur de 1 signifie pas de mise à l'échelle. Si vous mentionnez la valeur 0, la région sera mise à l'échelle afin de remplir complétement la fenêtre. Si vous indiquez une valeur négative, la room sera mise à l'échelle à une taille maximale à l'intérieur de la fenêtre tout en maintenant le ratio d'aspect (c'est ce que vous souhaiterez le plus souvent). adaptwindow indique si la taille de la fenêtre doit être adaptée dans le cas où la room ne tiendrait pas dans la fenêtre après mise à l'échelle. Le redimensionnement de la taille de la fenêtre ne sera possible que si le facteur d'échelle est positif.
window_get_region_scale() Retourne le facteur d'échelle pour l'affichage de la région.

La fenêtre a une position sur l'écran et une taille (lorsque nous parlons de position et de taille, nous voulons toujours indiquer la partie de la fenêtre sans les bordures). Vous pouvez modifier ceci bien que ce ne soit pas facile et souhaitable de le faire durant le jeu. Habituellement, ces paramétres sont déterminés automatiquement ou encore par le joueur. Les fonctions suivantes peuvent être employées pour modifier la position et la taille de la fenêtre. Veuillez noter que ces fonctions concernent uniquement le mode fenêtré. Si la fenêtre est en mode plein écran, on pourra toujours utiliser ces paramétres mais ils ne prendront effet que lorsque le mode plein écran sera désactivé.

window_set_position(x, y) Régle la position de la fenêtre (partie de la fenêtre sans bordure) à la position indiquée.
window_set_size(w, h) Régle la taille de la fenêtre (partie de la fenêtre sans bordure) selon la taille mentionnée. Si la taille indiquée est trop petite pour remplir la région d'affichage, elle sera élargie afin de remplir totalement cette région.
window_set_rectangle(x, y, w, h) Régle la position et la taille de la fenêtre rectangulaire. (effectue les 2 réglages précédents en une seule opération).
window_center() Centre la fenêtre sur l'écran.
window_default() Donne à la fenêtre la taille et la position (centrée) par défaut sur l'écran.
window_get_x() Retourne la valeur actuelle en x de la fenêtre.
window_get_y() Retourne la valeur actuelle en y de la fenêtre.
window_get_width() Retourne la largeur actuelle de la fenêtre.
window_get_height() Retourne la hauteur courante de la fenêtre.

Pour rappel, vous n'utiliserez probablement jamais aucune de ces fonctions de positionnement de fenêtre car Game Maker effectue ce travail de manière automatique.

Dans de rares cas, vous souhaiterez connaître la position de la souris par rapport à la fenêtre courante (normalement, vous utiliserez souvent la position de la souris par rapport à la room ou encore selon une vue). Les fonctions suivantes existent si besoin.

window_mouse_get_x() Retourne la valeur en x de la souris par rapport à la fenêtre.
window_mouse_get_y() Retourne la valeur en y de la souris par rapport à la fenêtre.
window_mouse_set(x, y) Régle la position de la souris par rapport à la fenêtre avec les valeurs indiquées.

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