ApiThreeDotOne: Contents
  Introduction
  Notes du traducteur
    Clavier
    Types de variables
  API
    Variables
    Les fonctions et leur tableau
      L’écran
      Couleurs
      Contrôles
      Images
      Timers (chronomètres)
      Sprites
      Déboguage
      Système
      Polices
      Cartes
      Cartes défilantes
      Canevas
      Rumble
      Motion (détection de mouvement)
      Date et heure
      Wifi
      Sons
      Fichiers INI

Api Three Dot One

3.1 API.

Introduction

Les variables et les fonctions que vous trouverez ici peuvent aussi bien être définies dans les bibliothèques écrites en Lua (tag libs) ou dans le code C (tag nds).

Notes du traducteur

Clavier

Il n’est plus fait mention du clavier, celui-ci ayant été enlevé des bibliothèques de base de MicroLua. Vous pouvez toujours trouver une version traduite et opérationnelle sur le forum.

Types de variables

Les types de variables n'ont pas été traduits pour des raisons de compréhension générale. En programmation, on parlera plus facilement de « string » que de « chaîne de caractères ». Voici les correspondances françaises des types employés ici:

  • VoidVoid: « vide » (utilisé par une fonction qui ne renvoie rien) * : « vide » (utilisé par une fonction qui ne renvoie rien)
  • NumberNumber: nombre * : nombre
  • StringString: chaîne de caractères * : chaîne de caractères
  • ColorColor: couleur * : couleur
  • ImageImage: image * : image
  • FontFont: police d'écriture * : police d'écriture
  • TableTable: table (ou tableau) * : table (ou tableau)
  • MapMap & & ScrollMapScrollMap: carte et carte défilante * : carte et carte défilante
  • CanvasCanvas & & CanvasObjectCanvasObject: canevas & objet de canevas * : canevas & objet de canevas
  • ConstantConstant: constante * : constante
  • BooleanBoolean: booléen (: booléen (truetrue – vrai, ou – vrai, ou falsefalse – faux) * – faux)
  • DateTimeDateTime: objet représentant une date * : objet représentant une date
  • HandleHandle: référence d’un objet pour le gérer = API = == Variables == * : référence d’un objet pour le gérer

API

Variables

  • MICROLUA_VERSIONMICROLUA_VERSION (_libs_): version de Micro Lua (sous forme d’un String) * (libs): version de Micro Lua (sous forme d’un String)
  • SCREEN_WIDTHSCREEN_WIDTH, , SCREEN_HEIGHTSCREEN_HEIGHT (_libs_): largeur et hauteur des écrans * (libs): largeur et hauteur des écrans
  • NB_FPSNB_FPS (_libs_): nombre de _frames_ (images) par seconde, automatiquement mis à jour chaque seconde. Vous pouvez l’afficher grâce à un (libs): nombre de frames (images) par seconde, automatiquement mis à jour chaque seconde. Vous pouvez l’afficher grâce à un screen.print()screen.print(). Ne pas afficher dans la console de déboguage. * . Ne pas afficher dans la console de déboguage.
  • SCREEN_UPSCREEN_UP, , SCREEN_DOWNSCREEN_DOWN (_libs_): numéro de l’écran sur lequel afficher les éléments. Voir les exemples pour de plus amples détails. * (libs): numéro de l’écran sur lequel afficher les éléments. Voir les exemples pour de plus amples détails.
  • RAMRAM, , VRAMVRAM (_libs_): destination du chargement de certains objets. Voir les exemples pour de plus amples détails. * (libs): destination du chargement de certains objets. Voir les exemples pour de plus amples détails.
  • ATTR_X1ATTR_X1, , ATTR_Y1ATTR_Y1, , ATTR_X2ATTR_X2, , ATTR_Y1ATTR_Y1, , ATTR_X3ATTR_X3, , ATTR_Y3ATTR_Y3, , ATTR_COLORATTR_COLOR, , ATTR_COLOR1ATTR_COLOR1, , ATTR_COLOR2ATTR_COLOR2, , ATTR_COLOR3ATTR_COLOR3, , ATTR_COLOR4ATTR_COLOR4, , ATTR_TEXTATTR_TEXT, , ATTR_VISIBLEATTR_VISIBLE, , ATTR_FONTATTR_FONT, , ATTR_IMAGEATTR_IMAGE (_libs_): attributs utilisés par les canevas. == Les fonctions et leur tableau == === L’écran === * (libs): attributs utilisés par les canevas.

Les fonctions et leur tableau

L’écran

Void render()Void render()* (_libs_) Actualise l’écran. * (libs)

Actualise l’écran.

Void startDrawing()Void startDrawing()* & * & Void stopDrawing()Void stopDrawing()* (_libs_, _deprecated_) Toutes vos opérations graphiques doivent être placées entre ces deux fonctions. * (libs, deprecated)

Toutes vos opérations graphiques doivent être placées entre ces deux fonctions.

Void screen.switch()Void screen.switch()* (_nds_) Intervertit l’affichage des écrans. * (nds)

Intervertit l’affichage des écrans.

Void screen.print(ecran, x, y, texte [, couleur])Void screen.print(ecran, x, y, texte [, couleur])* (_nds_) Affiche un texte à l’écran. * *ecran* (Number) : écran sur lequel dessiner ( (nds)
Affiche un texte à l’écran.
  • ecran (Number) : écran sur lequel dessiner (SCREEN_UPSCREEN_UP ou ou SCREEN_DOWNSCREEN_DOWN) * *x* (Number) : abscisse du coin haut-gauche du texte * *y* (Number) : ordonnée du coin haut-gauche du texte * *texte* (String) : texte à afficher * *couleur* (Color) : couleur du texte *)
  • x (Number) : abscisse du coin haut-gauche du texte
  • y (Number) : ordonnée du coin haut-gauche du texte
  • texte (String) : texte à afficher
  • couleur (Color) : couleur du texte
Void screen.printFont(ecran, x, y, texte, couleur, police)Void screen.printFont(ecran, x, y, texte, couleur, police)* (_nds_) Affiche un texte à l’écran dans une police spéciale. * *ecran* (Number) : écran sur lequel dessiner ( (nds)

Affiche un texte à l’écran dans une police spéciale.
  • ecran (Number) : écran sur lequel dessiner (SCREEN_UPSCREEN_UP ou ou SCREEN_DOWNSCREEN_DOWN) * *x* (Number) : abscisse du coin haut-gauche du texte * *y* (Number) : ordonnée du coin haut-gauche du texte * *texte* (String) : texte à afficher * *couleur* (Color) : couleur du texte * *police* (Font) : police spéciale *)
  • x (Number) : abscisse du coin haut-gauche du texte
  • y (Number) : ordonnée du coin haut-gauche du texte
  • texte (String) : texte à afficher
  • couleur (Color) : couleur du texte
  • police (Font) : police spéciale
Void screen.blit(ecran, x, y, image [,sourceX, sourceY] [, largeur, hauteur])Void screen.blit(ecran, x, y, image [,sourceX, sourceY] [, largeur, hauteur])* (_nds_) _Blitte_ (affiche) une image à l’écran. * *ecran* (Number) : écran sur lequel afficher l'image ( (nds)

Blitte (affiche) une image à l’écran.
  • ecran (Number) : écran sur lequel afficher l'image (SCREEN_UPSCREEN_UP ou ou SCREEN_DOWNSCREEN_DOWN) * *x* (Number) : abscisse du coin haut-gauche de l’image * *y* (Number) : ordonnée du coin haut-gauche de l’image * *image* (Image) : image à blitter * *sourceX*, *sourceY* (Number) : coordonnées de la partie de l’image source à blitter * *largeur*, *hauteur* (Number): dimensions de la partie de l’image source à blitter *)
  • x (Number) : abscisse du coin haut-gauche de l’image
  • y (Number) : ordonnée du coin haut-gauche de l’image
  • image (Image) : image à blitter
  • sourceX, sourceY (Number) : coordonnées de la partie de l’image source à blitter
  • largeur, hauteur (Number): dimensions de la partie de l’image source à blitter
Void screen.drawLine(ecran, x0, y0, x1, y1, couleur)Void screen.drawLine(ecran, x0, y0, x1, y1, couleur)* (_nds_) Dessine une ligne à l’écran. * *ecran* (Number) : écran sur lequel dessiner ( (nds)

Dessine une ligne à l’écran.
  • ecran (Number) : écran sur lequel dessiner (SCREEN_UPSCREEN_UP ou ou SCREEN_DOWNSCREEN_DOWN) * *x0*, *y0*, *x1*, *y1* (Number) : coordonnées de la ligne * *couleur* (Color) : couleur de la ligne *)
  • x0, y0, x1, y1 (Number) : coordonnées de la ligne
  • couleur (Color) : couleur de la ligne
Void screen.drawRect(ecran, x0, y0, x1, y1, couleur)Void screen.drawRect(ecran, x0, y0, x1, y1, couleur)* (_nds_) Dessine un rectangle à l’écran. * *ecran* (Number) : écran sur lequel dessiner ( (nds)

Dessine un rectangle à l’écran.
  • ecran (Number) : écran sur lequel dessiner (SCREEN_UPSCREEN_UP ou ou SCREEN_DOWNSCREEN_DOWN) * *x0*, *y0*, *x1*, *y1* (Number) : coordonnées du rectangle * *couleur* (Color) : couleur du rectangle *)
  • x0, y0, x1, y1 (Number) : coordonnées du rectangle
  • couleur (Color) : couleur du rectangle
Void screen.drawFillRect(ecran, x0, y0, x1, y1, couleur)Void screen.drawFillRect(ecran, x0, y0, x1, y1, couleur)* (_nds_) Dessine un rectangle plein à l’écran. * *ecran* (Number) : écran sur lequel dessiner ( (nds)

Dessine un rectangle plein à l’écran.
  • ecran (Number) : écran sur lequel dessiner (SCREEN_UPSCREEN_UP ou ou SCREEN_DOWNSCREEN_DOWN) * *x0*, *y0*, *x1*, *y1* (Number) : coordonnées du rectangle plein * *couleur* (Color) : couleur du rectangle plein *)
  • x0, y0, x1, y1 (Number) : coordonnées du rectangle plein
  • couleur (Color) : couleur du rectangle plein
Void screen.drawGradientRect(ecran, *x0*, *y0*, *x1*, *y1*, couleur1, couleur2, couleur3, couleur4)Void screen.drawGradientRect(ecran, x0, y0, x1, y1, couleur1, couleur2, couleur3, couleur4)* (_nds_) Dessine un rectangle dégradé à l’écran. * *ecran* (Number) : écran sur lequel dessiner ( (nds)

Dessine un rectangle dégradé à l’écran.
  • ecran (Number) : écran sur lequel dessiner (SCREEN_UPSCREEN_UP ou ou SCREEN_DOWNSCREEN_DOWN) * *x0*, *y0*, *x1*, *y1* (Number) : coordonnées du rectangle dégradé * *couleur1*, *couleur2*, *couleur3*, *couleur4* (Color) : couleurs du rectangle dégradé *)
  • x0, y0, x1, y1 (Number) : coordonnées du rectangle dégradé
  • couleur1, couleur2, couleur3, couleur4 (Color) : couleurs du rectangle dégradé
Void screen.drawTextBox(ecran, x0, y0, x1, y1, texte [, couleur])Void screen.drawTextBox(ecran, x0, y0, x1, y1, texte [, couleur])* (_nds_) Affiche une zone de texte à l’écran. * *ecran* (Number) : écran sur lequel dessiner ( (nds)

Affiche une zone de texte à l’écran.
  • ecran (Number) : écran sur lequel dessiner (SCREEN_UPSCREEN_UP ou ou SCREEN_DOWNSCREEN_DOWN) * *x0*, *y0*, *x1*, *y1* (Number) : coordonnées de la zone de texte * *texte* (String) : texte à afficher * *couleur* (Color) : couleur de la zone de texte === Couleurs === *)
  • x0, y0, x1, y1 (Number) : coordonnées de la zone de texte
  • texte (String) : texte à afficher
  • couleur (Color) : couleur de la zone de texte

Couleurs

Color Color.new(r, v, b)Color Color.new(r, v, b)* (_nds_) Crée une nouvelle couleur. * *r* (Number): masque rouge (de 0 à 31 inclus) * *v* (Number): masque vert (de 0 à 31 inclus) * *b* (Number): masque bleu (de 0 à 31 inclus) === Contrôles === * (nds)

Crée une nouvelle couleur.
  • r (Number): masque rouge (de 0 à 31 inclus)
  • v (Number): masque vert (de 0 à 31 inclus)
  • b (Number): masque bleu (de 0 à 31 inclus)

Contrôles

Void Controls.read()Void Controls.read()* (_libs_) Met à jour les commandes. ==== Stylet ==== Ce sont des nombres ou des booléens, tous définis dans les _libs_. * (libs)

Met à jour les commandes.

Stylet

Ce sont des nombres ou des booléens, tous définis dans les libs.

Stylus.XStylus.X*: abscisse du stylet *: abscisse du stylet

Stylus.YStylus.Y*: ordonnée du stylet *: ordonnée du stylet

Stylus.heldStylus.held*: état appuyé sur l'écran du stylet *: état appuyé sur l'écran du stylet

Stylus.releasedStylus.released*: état relâché du stylet *: état relâché du stylet

Stylus.doubleClickStylus.doubleClick: vaut : vaut truetrue* si le stylet effectue un double-clic * si le stylet effectue un double-clic

Stylus.deltaXStylus.deltaX*: delta X (accroissement de X) du mouvement du stylet *: delta X (accroissement de X) du mouvement du stylet

Stylus.deltaYStylus.deltaY*: delta Y (accroissement de Y) du mouvement du stylet *: delta Y (accroissement de Y) du mouvement du stylet

Stylus.newPressStylus.newPress: vaut : vaut truetrue* si le stylet effectue une nouvelle pression ==== Boutons ==== Voici des booléens. Toute cette section est définie dans les _libs_. ( si le stylet effectue une nouvelle pression

Boutons

Voici des booléens. Toute cette section est définie dans les libs.

([KEY]KEY peut prendre une des valeurs suivantes: * peut prendre une des valeurs suivantes: AA, , BB, , XX, , YY, , LL, , RR, , StartStart, , SelectSelect, , UpUp, , DownDown, , LeftLeft, , RightRight*) *)

Keys.held.[KEY]Keys.held.KEY*: état enfoncé du bouton *: état enfoncé du bouton

Keys.released.[KEY]Keys.released.KEY*: état relâché du bouton *: état relâché du bouton

Keys.newPress.[KEY]Keys.newPress.KEY: vaut : vaut truetrue* si le bouton effectue une nouvelle pression === Images === * si le bouton effectue une nouvelle pression

Images

Image Image.load(chemin, destination)Image Image.load(chemin, destination)* (_nds_) Crée une nouvelle image depuis un fichier image (PNG, JPG – JPEG ou GIF). * *chemin* (String): chemin d'accès du fichier image à charger * *destination* (Number): destination de l'image dans la mémoire ( (nds)

Crée une nouvelle image depuis un fichier image (PNG, JPG – JPEG ou GIF).
  • chemin (String): chemin d'accès du fichier image à charger
  • destination (Number): destination de l'image dans la mémoire (RAMRAM ou ou VRAMVRAM) *)
Void Image.destroy(image)Void Image.destroy(image)* (_nds_) Détruit une image. * *image* (Image): image à détruire Pour détruire complètement l'image, faire {{{ Image.destroy(monImage) monImage = nil }}} * (nds)

Détruit une image.
  • image (Image): image à détruire
Pour détruire complètement l'image, faire
Image.destroy(monImage)
monImage = nil
Image.destroy(monImage) monImage = nil }}}

Number Image.width(image)Number Image.width(image)* (_nds_) Obtient la longueur d'une image. * *image* (Image): image à utiliser * (nds)

Obtient la longueur d'une image.
  • image (Image): image à utiliser
Number Image.height(image)Number Image.height(image)* (_nds_) Obtient la largeur d'une image. * *image* (Image): image à utiliser * (nds)

Obtient la largeur d'une image.
  • image (Image): image à utiliser
Void Image.scale(image, longueur, largeur)Void Image.scale(image, longueur, largeur)* (_nds_) * *Agrandit* (ou réduit) l'image. * *image* (Image): image à modifier * *longueur* (Number): nouvelle longueur de l'image * *largeur* (Number): nouvelle largeur de l'image * (nds)
  • Agrandit (ou réduit) l'image.
  • image (Image): image à modifier
  • longueur (Number): nouvelle longueur de l'image
  • largeur (Number): nouvelle largeur de l'image
Void Image.rotate(image, angle [, xCentre, yCentre])Void Image.rotate(image, angle [, xCentre, yCentre])* (_nds_) Fait pivoter l'image autour du centre de rotation indiqué. * *image* (Image): image à modifier * *angle* (Number): angle de rotation (entre 0 et 511) * *xCentre* (Number): abscisse du centre de rotation * *yCentre* (Number): ordonnée du centre de rotation * (nds)

Fait pivoter l'image autour du centre de rotation indiqué.
  • image (Image): image à modifier
  • angle (Number): angle de rotation (entre 0 et 511)
  • xCentre (Number): abscisse du centre de rotation
  • yCentre (Number): ordonnée du centre de rotation
Void Image.rotateDegree(image, angle [, xCentre, yCentre])Void Image.rotateDegree(image, angle [, xCentre, yCentre])* (_nds_) Fait pivoter l’image autour du centre de rotation indiqué. L’angle est en degrés. * *image* (Image) : image à modifier * *angle* (Number) : angle de rotation, en degrés (entre 0 et 360) * *xCentre* (Number) : abscisse du centre de rotation * *yCentre* (Number) : ordonnée du centre de rotation * (nds)

Fait pivoter l’image autour du centre de rotation indiqué. L’angle est en degrés.
  • image (Image) : image à modifier
  • angle (Number) : angle de rotation, en degrés (entre 0 et 360)
  • xCentre (Number) : abscisse du centre de rotation
  • yCentre (Number) : ordonnée du centre de rotation
Void Image.mirrorH(image)Void Image.mirrorH(image)* (_nds_) Réalise une symétrie horizontale de l'image. * *image* (Image): image à modifier * (nds)

Réalise une symétrie horizontale de l'image.
  • image (Image): image à modifier
Void Image.mirrorV(image)Void Image.mirrorV(image)* (_nds_) Réalise une symétrie verticale de l'image. * *image* (Image): image à modifier * (nds)

Réalise une symétrie verticale de l'image.
  • image (Image): image à modifier
Void Image.setTint(image, couleur)Void Image.setTint(image, couleur)* (_nds_) Définit la teinte de l'image. * *image* (Image): image à modifier * *couleur* (Color): couleur de l'image === Timers (chronomètres) === L'unité est la milliseconde. * (nds)

Définit la teinte de l'image.
  • image (Image): image à modifier
  • couleur (Color): couleur de l'image

Timers (chronomètres)

L'unité est la milliseconde.

Timer Timer.new()Timer Timer.new()* (_libs_) Crée un nouveau timer ; vous pouvez le démarrer. * (libs)

Crée un nouveau timer ; vous pouvez le démarrer.

Number timer:time()Number timer:time()* (_libs_) Renvoie le temps d'un timer. * (libs)

Renvoie le temps d'un timer.

Void Timer:start()Void Timer:start()* (_libs_) Démarre un timer. * (libs)

Démarre un timer.

Void Timer:stop()Void Timer:stop()* (_libs_) Arrête un timer. * (libs)

Arrête un timer.

Void timer:reset()Void timer:reset()* (_libs_) Réinitialise un timer. === Sprites === (succession d'images – les frames – pour créer une animation) * (libs)

Réinitialise un timer.

Sprites

(succession d'images – les frames – pour créer une animation)
Sprite Sprite.new(chemin, longueurFrame, largeurFrame, destination)Sprite Sprite.new(chemin, longueurFrame, largeurFrame, destination)* (_libs_) Crée un sprite depuis un fichier image. * *chemin* (String): chemin d'accès du fichier qui contient le sprite * *longueurImage* (Number): longueur d'une frame * *largeurImage* (Number): largeur d'une frame * *destination* (Number): destination en mémoire ( (libs)

Crée un sprite depuis un fichier image.
  • chemin (String): chemin d'accès du fichier qui contient le sprite
  • longueurImage (Number): longueur d'une frame
  • largeurImage (Number): largeur d'une frame
  • destination (Number): destination en mémoire (RAMRAM ou ou VRAMVRAM) *)
Void sprite:drawFrame(ecran, x, y, numFrame)Void sprite:drawFrame(ecran, x, y, numFrame)* (_libs_) Affiche une frame du sprite. * *ecran* (Nombre) : écran sur lequel afficher ( (libs)

Affiche une frame du sprite.
  • ecran (Nombre) : écran sur lequel afficher (SCREEN_UPSCREEN_UP ou ou SCREEN_DOWNSCREEN_DOWN) * *x* (Nombre) : abscisse du coin haut-gauche de la frame * *y* (Nombre) : ordonnée du coin haut-gauche de la frame * *numFrame* (Number): numéro de la frame à afficher *)
  • x (Nombre) : abscisse du coin haut-gauche de la frame
  • y (Nombre) : ordonnée du coin haut-gauche de la frame
  • numFrame (Number): numéro de la frame à afficher
Void sprite:addAnimation(tabAnim, delais)Void sprite:addAnimation(tabAnim, delais)* (_libs_) Crée une animation. * *tabAnim* (Table): table des frames de l'animation * *delais* (Number): délais entre chaque frame * (libs)

Crée une animation.
  • tabAnim (Table): table des frames de l'animation
  • delais (Number): délais entre chaque frame
Void sprite:playAnimation(ecran, x, y, numAnim)Void sprite:playAnimation(ecran, x, y, numAnim)* (_libs_) Joue une animation à l'écran. * *ecran* (Number): écran sur lequel afficher ( (libs)

Joue une animation à l'écran.
  • ecran (Number): écran sur lequel afficher (SCREEN_UPSCREEN_UP ou ou SCREEN_DOWNSCREEN_DOWN) * * x* (Number): abscisse du coin haut-gauche de l'animation * *y* (Number): ordonnée du coin haut-gauche de l'animation * *numAnim* (Number): numéro de l'animation à jouer *)
  • x (Number): abscisse du coin haut-gauche de l'animation
  • y (Number): ordonnée du coin haut-gauche de l'animation
  • numAnim (Number): numéro de l'animation à jouer
Void sprite:resetAnimation(numAnim)Void sprite:resetAnimation(numAnim)* (_libs_) Réinitialise une animation. * *numAnim* (Number): numéro de l'animation à réinitialiser. * (libs)

Réinitialise une animation.
  • numAnim (Number): numéro de l'animation à réinitialiser.
Void sprite:startAnimation(numAnim)Void sprite:startAnimation(numAnim)* (_libs_) Démarre une animation. * *numAnim* (Number): numéro de l'animation à démarrer * (libs)

Démarre une animation.
  • numAnim (Number): numéro de l'animation à démarrer
Void sprite:stopAnimation(numAnimation)Void sprite:stopAnimation(numAnimation)* (_libs_) Arrête une animation. * *numAnim* (Number ): numéro de l'animation à arrêter * (libs)

Arrête une animation.
  • numAnim (Number ): numéro de l'animation à arrêter
Boolean sprite:isAnimationAtEnd(numAnim)Boolean sprite:isAnimationAtEnd(numAnim)* (_libs_) Renvoie (libs)

Renvoie truetrue si l'animation a affiché la dernière frame. * *numAnim* (Number): numéro de l'animation === Déboguage === * si l'animation a affiché la dernière frame.
  • numAnim (Number): numéro de l'animation

Déboguage

Void Debug.ON()Void Debug.ON()* (_libs_) Active le mode de déboguage. * (libs)

Active le mode de déboguage. Void Debug.OFF()Void Debug.OFF()* (_libs_) Désactive le mode déboguage. * (libs)

Désactive le mode déboguage.

Void Debug.print(texte)Void Debug.print(texte)* (_libs_) Affiche une ligne de déboguage. * *texte* (String): texte à afficher * (libs)

Affiche une ligne de déboguage.
  • texte (String): texte à afficher
Void Debug.clear()Void Debug.clear()* (_libs_) Efface la console de déboguage. * (libs)

Efface la console de déboguage.

Void Debug.setColor(couleur)Void Debug.setColor(couleur)* (_libs_) Définit la couleur du texte de déboguage. * *couleur* (Color): couleur du texte === Système === * (libs)

Définit la couleur du texte de déboguage.
  • couleur (Color): couleur du texte

Système

String System.currentDirectory()String System.currentDirectory()* (_libs_) Obtient le répertoire actuel. * (libs)

Obtient le répertoire actuel.

Void System.changeDirectory(chemin)Void System.changeDirectory(chemin)* (_libs_) Change le répertoire actuel. * *chemin* (String): chemin du dossier * (libs)

Change le répertoire actuel.
  • chemin (String): chemin du dossier
Void System.remove(nom)Void System.remove(nom)* (_libs_) Supprime un fichier ou un répertoire vide. * *nom* (String): nom du fichier ou du dossier à supprimer * (libs)

Supprime un fichier ou un répertoire vide.
  • nom (String): nom du fichier ou du dossier à supprimer
Void System.rename(ancienNom, nouveauNom)Void System.rename(ancienNom, nouveauNom)* (_libs_) Renomme un fichier ou un répertoire vide. * *ancienNom* (String): nom du fichier ou du dossier à renommer * *nouveauNom* (String): nouveau nom du fichier ou du dossier * (libs)

Renomme un fichier ou un répertoire vide.
  • ancienNom (String): nom du fichier ou du dossier à renommer
  • nouveauNom (String): nouveau nom du fichier ou du dossier
Void System.makeDirectory(nom)Void System.makeDirectory(nom)* (_libs_) Crée un nouveau répertoire. * *nom* (String): chemin d'accès et nom du dossier * (libs)

Crée un nouveau répertoire.
  • nom (String): chemin d'accès et nom du dossier
Table System.listDirectory(chemin)Table System.listDirectory(chemin)* (_libs_) Liste tous les fichiers et répertoires d'un dossier. * *chemin* (String): chemin d'accès du dossier à lister * *NOTE*: Voir les exemples pour plus de détails. === Polices === * (libs)

Liste tous les fichiers et répertoires d'un dossier.
  • chemin (String): chemin d'accès du dossier à lister
  • NOTE: Voir les exemples pour plus de détails.

Polices

Font Font.load(chemin)Font Font.load(chemin)* (_nds_) Crée une nouvelle police depuis un fichier de police (au format oslib et µLibrairy). * *chemin* (String): chemin d'accès du fichier police à charger * (nds)

Crée une nouvelle police depuis un fichier de police (au format oslib et µLibrairy).
  • chemin (String): chemin d'accès du fichier police à charger
Number Font.getCharHeight(police)Number Font.getCharHeight(police)* (_nds_) Obtient la hauteur des caractères d'une police. * *police* (Font): police à utiliser * (nds)

Obtient la hauteur des caractères d'une police.
  • police (Font): police à utiliser
Number Font.getStringWidth(police, texte)Number Font.getStringWidth(police, texte)* (_nds_) Obtient la largeur d’un texte avec une police spéciale. * *police* (Font) : police à utiliser * *texte* (String) : texte === Cartes === * (nds)

Obtient la largeur d’un texte avec une police spéciale.
  • police (Font) : police à utiliser
  • texte (String) : texte

Cartes

Map Map.new(image, fichierCarte, longueur, largeur, longueurTuile, largeurTuile)Map Map.new(image, fichierCarte, longueur, largeur, longueurTuile, largeurTuile)* (_nds_) Crée une nouvelle carte à partir d'un fichier carte. * *image* (Image): image qui contient les tuiles * *fichierCarte* (String): chemin d'accès au fichier carte ( (nds)

Crée une nouvelle carte à partir d'un fichier carte.
  • image (Image): image qui contient les tuiles
  • fichierCarte (String): chemin d'accès au fichier carte (.map.map) * *longueur* (Number): longueur de la carte en tuile * *largeur* (Number): largeur de la carte en tuile * *longueurTuile* (Number): longueur d'une tuile en pixel * *largeurTuile* (Number): largeur d'une tuile en pixel *)
  • longueur (Number): longueur de la carte en tuile
  • largeur (Number): largeur de la carte en tuile
  • longueurTuile (Number): longueur d'une tuile en pixel
  • largeurTuile (Number): largeur d'une tuile en pixel
Void Map.destroy(carte)Void Map.destroy(carte)* (_nds_) Détruit une carte. * *carte* (Map): carte à détruire * (nds)

Détruit une carte.
  • carte (Map): carte à détruire
Void Map.draw(ecran, carte, x, y, longueur, largeur)Void Map.draw(ecran, carte, x, y, longueur, largeur)* (_nds_) Affiche une carte. * *ecran* (Number): écran sur lequel afficher la carte (peut être (nds)

Affiche une carte.
  • ecran (Number): écran sur lequel afficher la carte (peut être SCREEN_UPSCREEN_UP ou ou SCREEN_DOWNSCREEN_DOWN) * *carte* (Map): carte à afficher * *x* (Number): abscisse du coin haut-gauche de la carte * *y* (Number): ordonnée du coin haut-gauche de la carte * *longueur* (Number): nombre de tuiles à afficher sur la longueur * *largeur* (Number): nombre de tuiles à afficher sur la largeur *)
  • carte (Map): carte à afficher
  • x (Number): abscisse du coin haut-gauche de la carte
  • y (Number): ordonnée du coin haut-gauche de la carte
  • longueur (Number): nombre de tuiles à afficher sur la longueur
  • largeur (Number): nombre de tuiles à afficher sur la largeur
Void Map.scroll(carte, x, y)Void Map.scroll(carte, x, y)* (_nds_) Fait défiler une carte. * *carte* (Map): carte à faire défiler * *x* (Number): nombre de tuiles à faire défiler sur la longueur * *y* (Number): nombre de tuiles à faire défiler sur la largeur * (nds)

Fait défiler une carte.
  • carte (Map): carte à faire défiler
  • x (Number): nombre de tuiles à faire défiler sur la longueur
  • y (Number): nombre de tuiles à faire défiler sur la largeur
Void Map.space(carte, x, y)Void Map.space(carte, x, y)* (_nds_) Définit l'espace entre chaque tuile de la carte. * *carte* (Map): carte à modifier * *x* (Number): espace sur la longueur entre chaque tuile * *y* (Number): espace sur la largeur entre chaque tuile * (nds)

Définit l'espace entre chaque tuile de la carte.
  • carte (Map): carte à modifier
  • x (Number): espace sur la longueur entre chaque tuile
  • y (Number): espace sur la largeur entre chaque tuile
Void Map.setTile(carte, x, y, tuile)Void Map.setTile(carte, x, y, tuile)* (_nds_) Change la valeur d'une tuile. * *carte* (Map): carte à modifier * *x* (Number): numéro de la colonne de la tuile à changer dans la carte * *y* (Number): numéro de la ligne de la tuile à changer dans la carte * *tuile* (Number): nouvelle valeur de tuile * (nds)

Change la valeur d'une tuile.
  • carte (Map): carte à modifier
  • x (Number): numéro de la colonne de la tuile à changer dans la carte
  • y (Number): numéro de la ligne de la tuile à changer dans la carte
  • tuile (Number): nouvelle valeur de tuile
Number Map.getTile(carte, x ,y)Number Map.getTile(carte, x ,y)* (_nds_) Obtient une valeur de tuile. * *carte* (Map): carte qui contient la tuile voulue * *x* (Number): numéro de la colonne de la tuile à obtenir * *y* (Number): numéro de la ligne de la tuile à obtenir === Cartes défilantes === * (nds)

Obtient une valeur de tuile.
  • carte (Map): carte qui contient la tuile voulue
  • x (Number): numéro de la colonne de la tuile à obtenir
  • y (Number): numéro de la ligne de la tuile à obtenir

Cartes défilantes

ScrollMap ScrollMap.new(image, fichierCarte, longueur, largeur, longueurTuile, largeurTuile)ScrollMap ScrollMap.new(image, fichierCarte, longueur, largeur, longueurTuile, largeurTuile)* (_nds_) Crée une nouvelle carte défilante. * *image* (Image): image qui contient les tuiles * *fichierCarte* (String): chemin d'accès du fichier carte (.map) * *longueur* (Number): longueur de la carte en tuile * *largeur* (Number): largeur de la carte en tuile * *longueurTuile* (Number): longueur d'une tuile en pixel * *largeurTuile* (Number): largeur d'une tuile en pixel * (nds)

Crée une nouvelle carte défilante.
  • image (Image): image qui contient les tuiles
  • fichierCarte (String): chemin d'accès du fichier carte (.map)
  • longueur (Number): longueur de la carte en tuile
  • largeur (Number): largeur de la carte en tuile
  • longueurTuile (Number): longueur d'une tuile en pixel
  • largeurTuile (Number): largeur d'une tuile en pixel
Void ScrollMap.destroy(carteDefilante)Void ScrollMap.destroy(carteDefilante)* (_nds_) Détruit une carte défilante. * *carteDéfilante* (ScrollMap): carte défilante à détruire * (nds)

Détruit une carte défilante.
  • carteDéfilante (ScrollMap): carte défilante à détruire
Void ScrollMap.draw(carteDefilante)Void ScrollMap.draw(carteDefilante)* (_nds_) Affiche une carte défilante. * *carteDéfilante* (ScrollMap): carte défilante à afficher * (nds)

Affiche une carte défilante.
  • carteDéfilante (ScrollMap): carte défilante à afficher
Void ScrollMap.scroll(carteDefilante, x, y)Void ScrollMap.scroll(carteDefilante, x, y)* (_nds_) Fait défiler une carte défilante. * *carteDefilante* (ScrollMap): carte défilante à faire défiler * *x* (Number): défilement horizontal en pixel * *y* (Number): défilement horizontal en pixel * (nds)

Fait défiler une carte défilante.
  • carteDefilante (ScrollMap): carte défilante à faire défiler
  • x (Number): défilement horizontal en pixel
  • y (Number): défilement horizontal en pixel
Void ScrollMap.setTile(carteDefilante, x, y, tuile)Void ScrollMap.setTile(carteDefilante, x, y, tuile)* (_nds_) Change la valeur d'une tuile. * *carteDefilante* (ScrollMap): carte défilante à modifier * *x* (Number): numéro de la colonne de la tuile à changer dans la carte * *y* (Number): numéro de la ligne de la tuile à changer dans la carte * *tuile* (Number): nouvelle valeur de tuile * (nds)

Change la valeur d'une tuile.
  • carteDefilante (ScrollMap): carte défilante à modifier
  • x (Number): numéro de la colonne de la tuile à changer dans la carte
  • y (Number): numéro de la ligne de la tuile à changer dans la carte
  • tuile (Number): nouvelle valeur de tuile
Number ScrollMap.getTile(carteDefilante, x ,y)Number ScrollMap.getTile(carteDefilante, x ,y)* (_nds_) Obtient une valeur de tuile. * *carteDefilante* (ScrollMap): carte défilante qui contient la tuile voulue * *x* (Number): numéro de la colonne de la tuile à obtenir * *y* (Number): numéro de la ligne de la tuile à obtenir === Canevas === * (nds)

Obtient une valeur de tuile.
  • carteDefilante (ScrollMap): carte défilante qui contient la tuile voulue
  • x (Number): numéro de la colonne de la tuile à obtenir
  • y (Number): numéro de la ligne de la tuile à obtenir

Canevas

Canvas Canvas.new()Canvas Canvas.new()* (_nds_) Crée un nouveau canevas. * (nds)

Crée un nouveau canevas.

Void Canvas.destroy(canevas)Void Canvas.destroy(canevas)* (_nds_) Détruit un canevas. Doit être suivi de canevas = nil. * *canevas* (Canvas): canevas à détruire * (nds)

Détruit un canevas. Doit être suivi de canevas = nil.
  • canevas (Canvas): canevas à détruire
CanvasObject Canvas.newLine(x1, y1, x2, y2, couleur)CanvasObject Canvas.newLine(x1, y1, x2, y2, couleur)* (_nds_) Crée une nouvelle ligne. * *x1*, *y1*, *x2*, *y2* (Number): coordonnées de la ligne * *couleur* (Color): couleur de la ligne * (nds)

Crée une nouvelle ligne.
  • x1, y1, x2, y2 (Number): coordonnées de la ligne
  • couleur (Color): couleur de la ligne
CanvasObject Canvas.newPoint(x1, y1, couleur)CanvasObject Canvas.newPoint(x1, y1, couleur)* (_nds_) Crée un nouveau point. * *x1*, *y1* (Number): coordonnées du point * *couleur* (Color): couleur du point * (nds)

Crée un nouveau point.
  • x1, y1 (Number): coordonnées du point
  • couleur (Color): couleur du point
CanvasObject Canvas.newRect(x1, y1, x2, y2, couleur)CanvasObject Canvas.newRect(x1, y1, x2, y2, couleur)* (_nds_) Crée un nouveau rectangle. * *x1*, *y1*, *x2*, *y2* (Number): coordonnées du rectangle * *couleur* (Color): couleur du rectangle * (nds)

Crée un nouveau rectangle.
  • x1, y1, x2, y2 (Number): coordonnées du rectangle
  • couleur (Color): couleur du rectangle
CanvasObject Canvas.newFillRect(x1, y1, x2, y2, couleur)CanvasObject Canvas.newFillRect(x1, y1, x2, y2, couleur)* (_nds_) Crée un nouveau rectangle plein. * *x1*, *y1*, *x2*, *y2* (Number): coordonnées du rectangle * *couleur* (Color): couleur du rectangle * (nds)

Crée un nouveau rectangle plein.
  • x1, y1, x2, y2 (Number): coordonnées du rectangle
  • couleur (Color): couleur du rectangle
CanvasObject Canvas.newGradientRect(x1, y1, x2, y2, couleur1, couleur2, couleur3, couleur4)CanvasObject Canvas.newGradientRect(x1, y1, x2, y2, couleur1, couleur2, couleur3, couleur4)* (_nds_) Crée un nouveau rectangle dégradé. * *x1*, *y1*, *x2*, *y2* (Number): coordonnées du rectangle * *couleur1*, *couleur2*, *couleur3*, *couleur4* (Color): couleurs du rectangle * (nds)

Crée un nouveau rectangle dégradé.
  • x1, y1, x2, y2 (Number): coordonnées du rectangle
  • couleur1, couleur2, couleur3, couleur4 (Color): couleurs du rectangle
CanvasObject Canvas.newText(x, y, texte [, couleur])CanvasObject Canvas.newText(x, y, texte [, couleur])* (_nds_) Crée un nouveau texte. * *x* (Nombre) : abscisse du coin haut-gauche du texte * *y* (Nombre) : ordonnée du coin haut-gauche du texte * *texte* (String): texte * *couleur* (Color): couleur du texte * (nds)

Crée un nouveau texte.
  • x (Nombre) : abscisse du coin haut-gauche du texte
  • y (Nombre) : ordonnée du coin haut-gauche du texte
  • texte (String): texte
  • couleur (Color): couleur du texte
CanvasObject Canvas.newTextFont(x, y, texte, couleur, police)CanvasObject Canvas.newTextFont(x, y, texte, couleur, police)* (_nds_) Crée un nouveau texte avec une police spéciale. * *x* (Nombre) : abscisse du coin haut-gauche du texte * *y* (Nombre) : ordonnée du coin haut-gauche du texte * *texte* (String): texte * *couleur* (Color): couleur du texte * *police* (Font): police spéciale du texte * (nds)

Crée un nouveau texte avec une police spéciale.
  • x (Nombre) : abscisse du coin haut-gauche du texte
  • y (Nombre) : ordonnée du coin haut-gauche du texte
  • texte (String): texte
  • couleur (Color): couleur du texte
  • police (Font): police spéciale du texte
CanvasObject Canvas.newTextBox(x1, y1, x2 , y2, texte [, couleur])CanvasObject Canvas.newTextBox(x1, y1, x2 , y2, texte [, couleur])* (_nds_) Crée une nouvelle zone de texte. * *x1*, *y1*, x1, y2 (Number): coordonnées de la zone de texte * *texte* (String): texte de la zone de texte * *couleur* (Color): couleur de la zone de texte * (nds)

Crée une nouvelle zone de texte.
  • x1, y1, x1, y2 (Number): coordonnées de la zone de texte
  • texte (String): texte de la zone de texte
  • couleur (Color): couleur de la zone de texte
CanvasObject Canvas.newImage(x1, y1, image [, x2, y2][, x3, y3])CanvasObject Canvas.newImage(x1, y1, image [, x2, y2][, x3, y3])* (_nds_) Crée une nouvelle image. * *x1*, *y1* (Number): coordonnées du coin haut-gauche de l’image * *image* (Image): image * *x2*, *y2* (Number): coordonnées du coin haut-gauche du rectangle à prendre dans l'image source * *x3*, *y3* (Number): longueur et largeur du rectangle à prendre dans l’image source * (nds)

Crée une nouvelle image.
  • x1, y1 (Number): coordonnées du coin haut-gauche de l’image
  • image (Image): image
  • x2, y2 (Number): coordonnées du coin haut-gauche du rectangle à prendre dans l'image source
  • x3, y3 (Number): longueur et largeur du rectangle à prendre dans l’image source
Void Canvas.add(canevas, objet)Void Canvas.add(canevas, objet)* (_nds_) Ajoute un CanvasObject dans un canevas. * *canevas* (Canvas): canevas à modifier * *objet* (CanvasObject): objet à ajouter * (nds)

Ajoute un CanvasObject dans un canevas.
  • canevas (Canvas): canevas à modifier
  • objet (CanvasObject): objet à ajouter
Void Canvas.draw(ecran, canevas, x, y,)Void Canvas.draw(ecran, canevas, x, y,)* (_nds_) Affiche un canevas à l'écran. * *ecran* (Number): écran sur lequel dessiner ( (nds)

Affiche un canevas à l'écran.
  • ecran (Number): écran sur lequel dessiner (SCREEN_UPSCREEN_UP ou ou SCREEN_DOWNSCREEN_DOWN) * *canevas* (Canvas): canevas à afficher * *x* (Number): abscisse du coin haut-gauche de l'image * *y* (Number): ordonnée du coin haut-gauche de l'image *)
  • canevas (Canvas): canevas à afficher
  • x (Number): abscisse du coin haut-gauche de l'image
  • y (Number): ordonnée du coin haut-gauche de l'image
Void Canvas.setAttr(objet, nomAttr, valeurAttr)Void Canvas.setAttr(objet, nomAttr, valeurAttr)* (_nds_) Définit la valeur d'un attribut d'un CanvasObject. * *objet* (CanvasObject): objet à modifier * *nomAttr* (Constant): attribut à modifier. Doit être soir la forme ATTR_XXX. Voir « Quelques variables utiles » pour de plus amples informations. * *valeurAttr* (?): nouvelle valeur de l'attribut. Le type doit être le même que celui de l'attribut. * (nds)

Définit la valeur d'un attribut d'un CanvasObject.
  • objet (CanvasObject): objet à modifier
  • nomAttr (Constant): attribut à modifier. Doit être soir la forme ATTR_XXX. Voir « Quelques variables utiles » pour de plus amples informations.
  • valeurAttr (?): nouvelle valeur de l'attribut. Le type doit être le même que celui de l'attribut.
? Canvas.getAttr(objet, nomAttr)? Canvas.getAttr(objet, nomAttr)* (_nds_) Obtient la valeur d'un attribut. Le type de retour dépend de l'attribut demandé. * *objet* (CanvasObject): objet à utiliser * *nomAttr* (Constant): attribut dont la valeur est demandée. Doit être sous la forme ATTR_XXX. Voir « Quelques variables utiles » pour de plus amples informations === Rumble === * (nds)

Obtient la valeur d'un attribut. Le type de retour dépend de l'attribut demandé.
  • objet (CanvasObject): objet à utiliser
  • nomAttr (Constant): attribut dont la valeur est demandée. Doit être sous la forme ATTR_XXX. Voir « Quelques variables utiles » pour de plus amples informations

Rumble

Boolean Rumble.isInserted()Boolean Rumble.isInserted()* (_nds_) Vérifie qu’un pack rumble (vibration) soit inséré. * (nds)

Vérifie qu’un pack rumble (vibration) soit inséré.

Void Rumble.set(statut)Void Rumble.set(statut)* (_nds_) Définit le statut du rumble. * *statut* (Boolean) : statut du rumble ( (nds)

Définit le statut du rumble.
  • statut (Boolean) : statut du rumble (truetrue : marche ;  : marche ; falsefalse : arrêt) === Motion (détection de mouvement) === * : arrêt)

Motion (détection de mouvement)

Boolean Motion.init()Boolean Motion.init()* (_nds_) Initialise le système Motion si un périphérique Motion est détecté. Renvoie (nds)

Initialise le système Motion si un périphérique Motion est détecté. Renvoie truetrue si un périphérique Motion est détecté. * si un périphérique Motion est détecté.

Void Motion.calibrate()Void Motion.calibrate()* (_nds_) Effectue le calibrage du système Motion. * (nds)

Effectue le calibrage du système Motion.

Number Motion.readX()Number Motion.readX()* (_nds_) Renvoie l’inclinaison X du système Motion. * (nds)

Renvoie l’inclinaison X du système Motion.

Number Motion.readY()Number Motion.readY()* (_nds_) Renvoie l’inclinaison Y du système Motion. * (nds)

Renvoie l’inclinaison Y du système Motion.

Number Motion.readZ()Number Motion.readZ()* (_nds_) Renvoie l’inclinaison Z du système Motion. * (nds)

Renvoie l’inclinaison Z du système Motion.

Number Motion.accelerationX()Number Motion.accelerationX()* (_nds_) Retourne l’accélération X du système Motion. * (nds)

Retourne l’accélération X du système Motion.

Number Motion.accelerationY()Number Motion.accelerationY()* (_nds_) Retourne l’accélération Y du système Motion. * (nds)

Retourne l’accélération Y du système Motion.

Number Motion.accelerationZ()Number Motion.accelerationZ()* (_nds_) Retourne l’accélération Z du système Motion. * (nds)

Retourne l’accélération Z du système Motion.

Number Motion.readGyro()Number Motion.readGyro()* (_nds_) Retourne la valeur de gyro du système Motion. * (nds)

Retourne la valeur de gyro du système Motion.

Number Motion.rotation()Number Motion.rotation()* (_nds_) Retourne la valeur de rotation du système Motion. === Date et heure === Ce tableau sera bientôt obsolète, puisqu'il y a déjà la fonction Lua (nds)

Retourne la valeur de rotation du système Motion.

Date et heure

Ce tableau sera bientôt obsolète, puisqu'il y a déjà la fonction Lua os.date()os.date(). *.

DateTime DateTime.new()DateTime DateTime.new()* (_libs_) Crée un nouvel objet DateTime. * (libs)

Crée un nouvel objet DateTime.

DateTime DateTime.getCurrentTime()DateTime DateTime.getCurrentTime()* (_libs_) Crée un nouvel objet DateTime avec l’heure et la date courantes. * *Attributs* (nombres): * (libs)

Crée un nouvel objet DateTime avec l’heure et la date courantes.
  • Attributs (nombres):
yearyear (an), (an), monthmonth (mois), (mois), dayday (jour), (jour), hourhour (heure), (heure), minuteminute, , secondsecond* (seconde) * *NOTE*: Voir les exemples pour plus de détails. === Wifi === * (seconde)

  • NOTE: Voir les exemples pour plus de détails.

Wifi

Void Wifi.connectWFC()Void Wifi.connectWFC()* (_nds_) Connecte la DS à la connexion Wifi. Utilise la configuration du firmware. Par conséquent, vous devez configurer votre connexion avec un jeu DS officiel. * (nds)

Connecte la DS à la connexion Wifi. Utilise la configuration du firmware. Par conséquent, vous devez configurer votre connexion avec un jeu DS officiel.

Void Wifi.disconnect()Void Wifi.disconnect()* (_nds_) Déconnecte la DS de la connexion Wifi. * (nds)

Déconnecte la DS de la connexion Wifi.

Socket Wifi.createTCPSocket(hote, port)Socket Wifi.createTCPSocket(hote, port)* (_nds_) Crée un socket TCP vers un serveur. * *hote* (String) : nom de domaine ou adresse IP du serveur * *port* (Number) : port à utiliser * (nds)

Crée un socket TCP vers un serveur.
  • hote (String) : nom de domaine ou adresse IP du serveur
  • port (Number) : port à utiliser
Socket Wifi.createUDPSocket(hote, port)Socket Wifi.createUDPSocket(hote, port)* (_nds_) Crée un socket UDP vers un serveur. * *hote* (String) : nom de domaine ou adresse IP du serveur * *port* (Number) : port à utiliser * (nds)

Crée un socket UDP vers un serveur.
  • hote (String) : nom de domaine ou adresse IP du serveur
  • port (Number) : port à utiliser
Void Wifi.closeSocket(socket)Void Wifi.closeSocket(socket)* (_nds_) Ferme un socket (TCP comme UDP). * *socket* (Socket) : socket à fermer * (nds)

Ferme un socket (TCP comme UDP).
  • socket (Socket) : socket à fermer
Void Wifi.send(socket, donnees)Void Wifi.send(socket, donnees)* (_nds_) Envoie des données à un serveur en passant par un socket. * *socket* (Socket) : socket à utiliser * *donnees* (String) : données à envoyer * (nds)

Envoie des données à un serveur en passant par un socket.
  • socket (Socket) : socket à utiliser
  • donnees (String) : données à envoyer
String Wifi.receive(socket, longueur)String Wifi.receive(socket, longueur)* (_nds_) Reçoit des données depuis un serveur en passant par un socket. * *socket* (Socket) : socket à utiliser * *longueur* (Number) : taille des données à recevoir === Sons === ==== Banques de son ==== * (nds)

Reçoit des données depuis un serveur en passant par un socket.
  • socket (Socket) : socket à utiliser
  • longueur (Number) : taille des données à recevoir

Sons

Banques de son

Void Sound.loadBank(nomFichier)Void Sound.loadBank(nomFichier)* (_nds_) Charge une banque de son depuis un fichier en mémoire. * *nomFichier* (String) : chemin du fichier à charger * (nds)

Charge une banque de son depuis un fichier en mémoire.
  • nomFichier (String) : chemin du fichier à charger
Void Sound.unloadBank()Void Sound.unloadBank()* (_nds_) Décharge la banque de son de la mémoire. ==== Mods ==== * (nds)

Décharge la banque de son de la mémoire.

Mods

Void Sound.loadMod(index)Void Sound.loadMod(index)* (_nds_) Charge un module en mémoire. * *index* (Number) : index du module à charger * (nds)

Charge un module en mémoire.
  • index (Number) : index du module à charger
Void Sound.unloadMod(index)Void Sound.unloadMod(index)* (_nds_) Décharge un module de la mémoire. * *index* (Number) : index du module à décharger * (nds)

Décharge un module de la mémoire.
  • index (Number) : index du module à décharger
Void Sound.startMod(index, modeLecture)Void Sound.startMod(index, modeLecture)* (_nds_) Lance la lecture d’un module déjà chargé en mémoire. * *index* (Number) : index du module à jouer * *modeLecture* (Number) : mode de lecture (peut être (nds)

Lance la lecture d’un module déjà chargé en mémoire.
  • index (Number) : index du module à jouer
  • modeLecture (Number) : mode de lecture (peut être PLAY_ONCEPLAY_ONCE – jouer une fois – ou – jouer une fois – ou PLAY_LOOPPLAY_LOOP – jouer en boucle) * – jouer en boucle)
Void Sound.pause()Void Sound.pause()* (_nds_) Met en pause tous les modules. * (nds)

Met en pause tous les modules.

Void Sound.resume()Void Sound.resume()* (_nds_) Relance la lecture de tous les modules. * (nds)

Relance la lecture de tous les modules.

Void Sound.stop()Void Sound.stop()* (_nds_) Arrête la lecture de tous les modules. * (nds)

Arrête la lecture de tous les modules.

Void Sound.setPosition(index, position)Void Sound.setPosition(index, position)* (_nds_) Définit la position du curseur de lecture dans un module. * *index* (Number) : index du module * *position* (Number) : nouvelle position du curseur * (nds)

Définit la position du curseur de lecture dans un module.
  • index (Number) : index du module
  • position (Number) : nouvelle position du curseur
Boolean Sound.isActive()Boolean Sound.isActive()* (_nds_) Retourne (nds)

Retourne truetrue si le lecteur est actif, sinon retourne si le lecteur est actif, sinon retourne falsefalse. *.

Void Sound.startJingle(index)Void Sound.startJingle(index)* (_nds_) Lance la lecture d’un module comme un jingle. * *index* (Number) : index du volume à jouer * (nds)

Lance la lecture d’un module comme un jingle.
  • index (Number) : index du volume à jouer
Void Sound.setModVolume(volume)Void Sound.setModVolume(volume)* (_nds_) Définit le volume du module joué. * *volume* (Number) : nouvelle valeur du volume, comprise entre 0 et 1024 * (nds)

Définit le volume du module joué.
  • volume (Number) : nouvelle valeur du volume, comprise entre 0 et 1024
Void Sound.setJingleVolume(volume)Void Sound.setJingleVolume(volume)* (_nds_) Définit le volume du jingle joué. * *volume* (Number) : nouvelle valeur du volume, comprise entre 0 et 1024 * (nds)

Définit le volume du jingle joué.
  • volume (Number) : nouvelle valeur du volume, comprise entre 0 et 1024
Void Sound.setModTempo(tempo)Void Sound.setModTempo(tempo)* (_nds_) Définit le tempo du lecteur de module. * *tempo* (Number) : nouvelle valeur du tempo, comprise entre 512 et 2048 * (nds)

Définit le tempo du lecteur de module.
  • tempo (Number) : nouvelle valeur du tempo, comprise entre 512 et 2048
Void Sound.setModPitch(ton)Void Sound.setModPitch(ton)* (_nds_) Définit le ton du lecteur de module. * *ton* (Number) : nouvelle valeur du ton * *SFX* (effets sonores) : * (nds)

Définit le ton du lecteur de module.
  • ton (Number) : nouvelle valeur du ton
  • SFX (effets sonores) :
Void Sound.loadSFX(index)Void Sound.loadSFX(index)* (_nds_) Charge un SFX dans la mémoire. * *index* (Number) : index du SFX à charger * (nds)

Charge un SFX dans la mémoire.
  • index (Number) : index du SFX à charger
Void Sound.unloadSFX(index)Void Sound.unloadSFX(index)* (_nds_) Décharge un SFX de la mémoire. * *index* (Number) : index du SFX à décharger * (nds)

Décharge un SFX de la mémoire.
  • index (Number) : index du SFX à décharger
Handle Sound.startSFX(index)Handle Sound.startSFX(index)* (_nds_) Démarre un effet sonore déjà chargé en mémoire. Retourne un handle de cet SFX. * *index* (Number) : index du SFX à lire * (nds)

Démarre un effet sonore déjà chargé en mémoire. Retourne un handle de cet SFX.
  • index (Number) : index du SFX à lire
Void Sound.stopSFX(handle)Void Sound.stopSFX(handle)* (_nds_) Arrête un SFX joué. * *handle* (Handle) : handle d’un SFX, retourné par la fonction startSFX * (nds)

Arrête un SFX joué.
  • handle (Handle) : handle d’un SFX, retourné par la fonction startSFX
Void Sound.releaseSFX(handle)Void Sound.releaseSFX(handle)* (_nds_) Marque un effet en priorité faible. * *handle* (Handle) : handle d’un SFX, retourné par la fonction startSFX * (nds)

Marque un effet en priorité faible.
  • handle (Handle) : handle d’un SFX, retourné par la fonction startSFX
Void Sound.stopAllSFX()Void Sound.stopAllSFX()* (_nds_) Arrête tous les SFX joués. * (nds)

Arrête tous les SFX joués.

Void Sound.setSFXVolume(handle, volume)Void Sound.setSFXVolume(handle, volume)* (_nds_) Définit le volume d’un SFX joué. * *handle* (Handle) : handle d’un SFX, retourné par la fonction startSFX * *volume* (Number) : nouvelle valeur du volume, comprise entre 0 et 255 (différente de celle des mods) * (nds)

Définit le volume d’un SFX joué.
  • handle (Handle) : handle d’un SFX, retourné par la fonction startSFX
  • volume (Number) : nouvelle valeur du volume, comprise entre 0 et 255 (différente de celle des mods)
Void Sound.setSFXPanning(handle, balance)Void Sound.setSFXPanning(handle, balance)* (_nds_) Définit la balance d’un SFX joué. * *handle* (Handle) : handle d’un SFX, retourné par la fonction startSFX * *balance* (Number) : nouvelle valeur de la balance, comprise entre 0 (gauche) et 255 (droite) * (nds)

Définit la balance d’un SFX joué.
  • handle (Handle) : handle d’un SFX, retourné par la fonction startSFX
  • balance (Number) : nouvelle valeur de la balance, comprise entre 0 (gauche) et 255 (droite)
Void Sound.setSFXPitch(handle, ton)Void Sound.setSFXPitch(handle, ton)* (_nds_) Définit le ton d’un SFX joué. * *handle* (Handle) : handle d’un SFX, retourné par la fonction startSFX * *ton* : nouvelle valeur du ton * (nds)

Définit le ton d’un SFX joué.
  • handle (Handle) : handle d’un SFX, retourné par la fonction startSFX
  • ton : nouvelle valeur du ton
Void Sound.setSFXScalePitch(handle, gamme)Void Sound.setSFXScalePitch(handle, gamme)* (_nds_) Définit la gamme de ton d’un SFX joué. * *handle* (Handle) : handle d’un SFX, retourné par la fonction startSFX * *gamme* (Number) : nouvelle valeur de gamme du ton === Fichiers INI === * (nds)

Définit la gamme de ton d’un SFX joué.
  • handle (Handle) : handle d’un SFX, retourné par la fonction startSFX
  • gamme (Number) : nouvelle valeur de gamme du ton

Fichiers INI

Table INI.load(nomFichier)Table INI.load(nomFichier)* (_libs_) Charge un fichier INI et crée une table avec son contenu. * *nomFichier* (String): fichier à charger * (libs)

Charge un fichier INI et crée une table avec son contenu.
  • nomFichier (String): fichier à charger
Void INI.save(nomFichier, table)Void INI.save(nomFichier, table)* (_libs_) Sauvegarde une table dans un fichier INI. * *nomFichier* (String): fichier dans lequel la table sera sauvegardée * *table* (Table): table à sauvegarder Exemple: Un fichier INI contient: {{{ [infos] nom=toto age=25 }}} {{{ tab = INI.load('monFichier.ini') table['infos']['nom'] = 'tata' INI.save('monFichier.ini', tab) }}} Cet exemple change la ligne (libs)

Sauvegarde une table dans un fichier INI.
  • nomFichier (String): fichier dans lequel la table sera sauvegardée
  • table (Table): table à sauvegarder
Exemple:

Un fichier INI contient:
[infos]
nom=toto
age=25
infos nom=toto age=25 }}}
tab = INI.load('monFichier.ini')
table['infos']['nom'] = 'tata'
INI.save('monFichier.ini', tab)
tab = INI.load('monFichier.ini') table['infos']['nom'] = 'tata' INI.save('monFichier.ini', tab) }}} Cet exemple change la ligne nom=totonom=toto en en nom=tatanom=tata. Les tables de données des fichiers INI ne peuvent contenir que des Strings ! Si vous voulez sauvegarder des nombres, vous devez d'abord les convertir en String grâce à .

Les tables de données des fichiers INI ne peuvent contenir que des Strings ! Si vous voulez sauvegarder des nombres, vous devez d'abord les convertir en String grâce à tostring()tostring().