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


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


CapsLock property

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 property (system)

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

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 property

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 : AGS Graphics Drivers


NumLock property

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 property

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

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

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

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 property

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 property

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

(Anciennement system.viewport_height, désormais obsolète)

readonly static int System.ViewportHeight;

Retourne la hauteur actuelle de la fenêtre, en unités de résolution 320×200. 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 property

(Anciennement system.viewport_width, désormais obsolète)

readonly static int System.ViewportWidth;

Retourne la largeur actuelle de la fenêtre, en unités de résolution 320×200. 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 property

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

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

 
ags75.txt · Dernière modification: 27/04/2011 11:42 par kitai
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki