Ceci est une ancienne révision du document !
readonly static int System.AudioChannelCount;
Retourne le nombre de Canaux Audio disponibles dans le jeu (8 dans la version actuelle d'AGS).
Ceci est utile si vous voulez parcourir tous les canaux audio pour vérifier ce qu'ils sont en train de jouer.
Exemple :
Display("Il y a %d canaux audio.", System.AudioChannelCount);
affichera un message avec le nombre de canaux audio.
Compatibilité : Supporté par AGS 3.2.0 et les versions ultérieures.
Voir aussi : System.AudioChannels
readonly static AudioChannel* System.AudioChannels[];
Retourne une instance AudioChannel correspondant au numéro de canal spécifié. Ceci vous permet d'interroger le canal pour trouver ce qu'il joue.
Exemple :
AudioChannel *canal = System.AudioChannels[2]; Display("Le volume du canal 2 vaut actuellement %d.", channel.Volume);
affichera un message avec le volume actuel du canal audio numéro 2.
Compatibilité : Supporté par AGS 3.2.0 et les versions ultérieures.
Voir aussi : Commandes Audio Channel, System.AudioChannelCount
readonly static bool System.CapsLock;Retourne si Caps Lock (majuscules) est actif sur le système de l'utilisateur.
if (System.CapsLock) { Display("La lumière CAPS LOCK est allumée."); }
affichera un message si les majuscules sont activées.
Compatibilité : Supporté par AGS 3.0.1 et les versions plus récentes.
Voir aussi : System.NumLock,
System.ScrollLock
(Anciennement system.color_depth, désormais obsolète)
readonly static int System.ColorDepth;
Retourne la profondeur de couleur à laquelle le jeu est exécuté. Correspond à la profondeur de couleur
générale, il est possible que des sprites ou des arrière-plans particuliers en aient une différente.
Exemple :
Display("Le jeu a l'aspect suivant : %d x %d, %d-bit colour", System.ScreenWidth, System.ScreenHeight, System.ColorDepth);
affichera la résolution actuelle et la profondeur de couleurs.
Voir aussi : System.ScreenHeight,
System.ScreenWidth
static int System.Gamma;Retourne/définit le niveau Gamma de l'écran en cours. Vaut 100 par défaut, et vous pouvez donner tout valeur entre 0 (noir complet) et 200 (brillance normale doublée).
if (System.SupportsGammaControl) { System.Gamma = 150; }
définira la brillance de l'écran à 50% de plus que la normale.
Voir aussi : System.SupportsGammaControl
readonly static bool System.HardwareAcceleration;Retourne si le jeu est en mode accélération matérielle (par exemple Direct3D). Si c'est le cas, alors les DrawingSurface risquent d'être ralenties, mais le canal alpha et les sprites larges devraient être traités plus rapidemen que lorsque le pilote non-accélérateur est utilisé.
Exemple :
if (System.HardwareAcceleration) { Display("Hourra, on peut dessiner des sprites avec canal alpha rapidement !"); }
affichera un message si le jeu est en mode accélération matérielle.
Voir aussi : Choix du pilote graphique
readonly static bool System.NumLock;Retourne si Num Lock (touches numériques) est activé sur le système du joueur.
if (System.NumLock) { Display("La lumière NUM LOCK est allumée."); }
affichera un message si Num Lock est activé.
Compatibilité : Supporté par AGS 3.0.1 et les versions plus récentes.
Voir aussi : System.CapsLock,
System.ScrollLock
(Anciennement system.os, désormais obsolète)
readonly static eOperatingSystem System.OperatingSystem;
Retourne le système d'exploitation (OS) sous lequel tourne le jeu actuellement. Peut prendre les valeurs suivantes :
eOSDOS eOSWindows eOSLinux eOSMacOS
Exemple :
if (System.OperatingSystem == eOSWindows) { Display("Exécution sous Windows!"); } else { Display("Exécution hors Windows!"); }
(Anciennement system.screen_height, désormais obsolète)
readonly static int System.ScreenHeight;
Retourne la hauteur véritable de l'écran du jeu. Peut valoir 200, 240, 400, 480 ou 600.
Notez que si un filtre graphique est actif, la résolution retournée correspondra à celle
précédant l'application de redimensionnement du filtre.
NOTE : Cette information est fournie pour permettre d'optimiser votre jeu, toutefois
ne forcez pas le joueur à exécuter le jeu dans une résolution spécifique.
AGS est conçu pour permettre aux joueurs de choisir différentes résolutions afin de faire
marcher le jeu sur leurs PC.
Exemple :
Display("Le jeu a l'aspect suivant : %d x %d, %d-bit colour", System.ScreenWidth, System.ScreenHeight, System.ColorDepth);
affichera la résolution actuelle et la profondeur de couleurs.
Voir aussi : System.ColorDepth,
System.ScreenWidth
(Anciennement system.screen_width, désormais obsolète)
readonly static int System.ScreenWidth;
Retourne la hauteur véritable de l'écran du jeu. Peut valoir 320, 640, ou 800.
Notez que si un filtre graphique est actif, la résolution retournée correspondra à celle
précédant l'application de redimensionnement du filtre.
NOTE : Cette information est fournie pour permettre d'optimiser votre jeu, toutefois
ne forcez pas le joueur à exécuter le jeu dans une résolution spécifique.
AGS est conçu pour permettre aux joueurs de choisir différentes résolutions afin de faire
marcher le jeu sur leurs PC.
Exemple :
Display("Le jeu a l'aspect suivant : %d x %d, %d-bit colour", System.ScreenWidth, System.ScreenHeight, System.ColorDepth);
affichera la résolution actuelle et la profondeur de couleurs.
Voir aussi : System.ColorDepth,
System.ScreenHeight
readonly static bool System.ScrollLock;Retourne si Arrêt Défilement (Scroll Lock) est actuellement activée sur le système du joueur.
if (System.ScrollLock) { Display("La lumière ARRET DEFIL est allumée."); }
affichera un message si Arrêt Défil. est activée.
Compatibilité : Supporté par AGS 3.0.1 et les versions plus récentes.
Voir aussi : System.CapsLock,
System.NumLock
readonly static bool System.SupportsGammaControl;Retourne si le PC du joueur supporte la reconfiguration du gamma.
if (System.SupportsGammaControl) { Display("Il est possible de changer le niveau de gamma du système !"); }
affichera un message si le système supporte la reconfiguration du gamma.
Voir aussi : System.Gamma
(Anciennement system.version, désormais obsolète)
readonly static String System.Version;
Retourne le numéro de version du moteur d'AGS. Peut être particulièrement utile pour les
modules de script, afin d'utiliser des aspects propres à certaines versions, ou pour gérer
d'éventuels bugs spécifiques.
La chaîne retournée correspond au numéro complet de version, par exemple “2.71.833
The string returned is the full version number, for example “2.71.833”.
Exemple :
Display("Version d'AGS : %s", System.Version);
affichera le numéro de la version d'AGS.
(Anciennement system.viewport_height, désormais obsolète)
readonly static int System.ViewportHeight;
Retourne la hauteur actuelle de la fenêtre, selon le systéme de coordonnées du jeu. Cela vous permet de déterminer
les coordonnées maximum que vous pouvez passer à des fonctions comme Mouse.SetPosition.
Exemple :
Display("Fenêtre du jeu : %d x %d", System.ViewportWidth, System.ViewportHeight);
affichera les dimensions actuelles de la fenêtre.
Voir aussi : System.ViewportWidth
(Anciennement system.viewport_width, désormais obsolète)
readonly static int System.ViewportWidth;
Retourne la largeur actuelle de la fenêtre, selon le systéme de coordonnées du jeu. Cela vous permet de déterminer
les coordonnées maximum que vous pouvez passer à des fonctions comme Mouse.SetPosition.
Exemple :
Display("Fenêtre du jeu : %d x %d", System.ViewportWidth, System.ViewportHeight);
affichera les dimensions actuelles de la fenêtre.
Voir aussi : System.ViewportHeight
(Anciennement system.vsync, désormais obsolète)
static bool System.VSync;
Retourne/définit si AGS attend le retraçage vertical avant d'afficher chaque image.
Désactivé par défaut.
Si vous l'activez, cela peut réduire l'effet “déchirure” parfois visible lorsque l'écran
défile. Toutefois, cela aura pour effet de limiter la fréquence d'affichage des images du jeu
à la fréquence de rafraîchissement du moniteur, ce qui signifie que vous ne pourrez pas définir
une vitesse de jeu supérieure à 60 fps.
NOTE : Cette propriété n'a aucun effet avec le pilote Direct3D.
Exemple :
if (System.VSync) { Display("La synchronisation du retraçage vertical est activée !"); }
affichera un message si vsync est activée.
(Anciennement system.windowed, désormais obsolète)
readonly static bool System.Windowed;
Retourne si le jeu tourne actuellement en mode fenêtré (true) ou en plein écran (false).
Exemple :
if (System.Windowed) { Display("Le jeu est fenêtré !"); }
affichera un message si le jeu tourne en mode fenêtré.