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

Ceci est une ancienne révision du document !



Fonctions et propriétés du système (System)

AudioChannelCount

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


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


CapsLock

readonly static bool System.CapsLock;
Retourne si Caps Lock (majuscules) est actif sur le système de l'utilisateur.

Vous pouvez l'utiliser par exemple pour empêcher le joueur de passer en majuscules avant de taper un mot de passe.

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


ColorDepth

(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


Gamma

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

System.SupportsGammaControl doit retourner true pour que cette propriété ait un effet.

Puisque chaque joueur possède un moniteur différent, vous devriez normalement lier cette propriété à un Slider GUI qui permettra au joueur de l'ajuster à son système.

Exemple :
if (System.SupportsGammaControl) {
  System.Gamma = 150;
}

définira la brillance de l'écran à 50% de plus que la normale.

Voir aussi : System.SupportsGammaControl


HardwareAcceleration

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

Support selon les plateformes

Windows: pilote Direct3D
MS-DOS: Non supporté
Linux: Non supporté
MacOS: Non supporté

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


NumLock

readonly static bool System.NumLock;
Retourne si Num Lock (touches numériques) est activé sur le système du joueur.

Vous pourrez par exemple utiliser cela pour empêcher le joueur de le désactiver avant d'utiliser les flèches d'un pavé numérique.

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


OperatingSystem

(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!");
}

ScreenHeight

(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


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


ScrollLock

readonly static bool System.ScrollLock;
Retourne si Arrêt Défilement (Scroll Lock) est actuellement activée sur le système du joueur.

Notez que lorsque vous exécutez le jeu en mode Debug, la touche Arrêt Défil. lancera le débogueur, il ne vaut donc mieux pas l'utiliser dans un autre but dans le jeu.

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


SupportsGammaControl

readonly static bool System.SupportsGammaControl;
Retourne si le PC du joueur supporte la reconfiguration du gamma.

Doit retourner true avant tout changement par la propriété System.Gamma. Les situations qui présentent ce support sont lisées ci-après.

Support selon les plateformes

Windows: Plein écran seulement MS-DOS: Non supporté Linux: Non supporté MacOS: Non supporté

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


Version

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


ViewportHeight

(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


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


VSync

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


Windowed

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

 
system.1417106131.txt.gz · Dernière modification: 27/11/2014 17:35 (édition externe)
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki