Script

Qu'est-ce qu'un script Celestia ?

Un script Celestia est un fichier texte (enregistré au format .cel ou .celx) représentant une liste de commandes permettant d'exécuter automatiquement la plupart des fonctions habituellement accessibles à travers les différents menus. Les scripts offrent donc la possibilité d'enchaîner automatiquement (sans intervention de l'utilisateur) des déplacements, des mouvements de caméra, des changements de textures de planètes, bref de réaliser l'équivalent d'une véritable séquence vidéo dans Celestia. Ils permettent aussi d'afficher des commentaires textuels au cours de ces séquences.

Comment ouvrir un script dans Celestia ?

Les scripts sont accessibles à partir du Menu "File" ("Fichier") > "Open script" ("Ouvrir script")

Quelle est la différence entre les fichiers .cel et .celx ?

Ces 2 types de scripts n'utilisent pas le même langage de programmation.

- Les fichiers .cel utilisent un langage basique propre à Celestia. Ils ne permettent aucune interaction avec l'utilisateur.

- Les fichiers .celx utilisent une partie des fonctions du langage Lua. Plus complexes, ils autorisent un traitement mathématique et logique des valeurs, et offrent une forme d'interactivité avec l'utilisateur : par exemple, il est possible de demander le nom d'une planète pour pouvoir s'y rendre, de proposer des menus pour pouvoir passer directement à la 2ème partie d'un script, ou de demander la distance à laquelle on veut s'approcher d'un objet, etc...

Comment modifier un script ?

Un script peut être écrit ou modifié comme tout autre fichier texte, en utilisant votre éditeur de texte préféré (Notepad, ...). Il vous suffit ensuite de l'enregistrer au format .cel ou celx (exemple : monscript.cel).

Quelles sont les principales commandes ?

- Cancel
Annuler les commandes goto et track, et réinitialiser le Système de Coordonnées sur universal.

- Center
Centrer l'objet sélectionné sur l'écran.

- Changedistance
Changer la valeur de la distance depuis l'objet sélectionné.

- Chase
Régler le Système de Coordonnées sur chase.

- Cls
Effacer tous les messages affichés à l'écran avec la commande print.

- Follow
Suivre l'objet sélectionné - Régler le Système de Coordonnées sur ecliptical.

- Goto
Aller vers l'objet sélectionné sans changer le Système de Coordonnées.

- Gotoloc
Aller à la position et à l'orientation spécifiée de l'objet sélectionné sans changer le Système de Coordonnées.

- Gotolonglat
Aller à la longitude et à la latitude spécifiée de l'objet sélectionné.

- Labels
Afficher ou Effacer les différents labels.

- Lock
Verrouiller 2 objets dans le champs de la caméra - Régler le Système de Coordonnées sur lock

- Lookback
Changer le champs de la caméra de 180°.

- Mark
Marquer l'objet défini avec le symbole spécifié.

- Move
Déplacer la caméra à la vitesse spécifiée.

- Orbit
Se positionner en orbite autour de l'objet sélectionné sans changer le Système de Coordonnées.

preloadtex Pre-load a texture file from disk to memory. print Display a text message on the display screen. renderflags Set or clear items to be rendered/displayed on-screen. rotate Rotate the camera view. select Select an object (planet, moon, galaxy, etc.). set Set the Min Orbit Size, Ambient Light Level, Field Of View, Star Distance Limit, or Star Style. setfaintestautomag45deg Set the Magnitude of stars to be displayed when Auto-Magnitude is ON. setframe Set the Coordinate System to be used. setorientation Set the camera's orientation. setposition Set the camera's position in space. setsurface Set the name of an alternative surface for the selected object. setvisibilitylimit Set the Magnitude of stars to be displayed when Auto-Magnitude is OFF. seturl Move the camera to the location of a saved "location URL" (or Cell://URL). synchronus Orbit the currently selected object in Synch Orbit mode. Sets the Coordinate System to geographic. time Set the date and time in JulianDay format. timerate Set the time multiplication factor, ie. 100x. track Keep the currently selected object centered in the display. unmark Unmark the specified object. unmarkall UnMark all objects and disable the display of Marks. wait Pause script execution for the specified number of seconds.

Print

 print { origin "topleft"  row 13  column 25  duration 5 text "Voici une comète" }
 wait { duration 5 } 

 permet d'afficher "Voici une comète" en commençant à la 13ème ligne de la 25ème colonne à partir 
 de l'origine 'en haut à gauche' durant 5 secondes. 

 rem 1 : La commande wait (2ème ligne) est indispensable après une commande print.

 rem 2 : Pour permettre l'affichage de caractères accentués, il faut utiliser l'éditeur de texte
         Notepad2 (sous Windows) et choisir l'encodage UTF-8 (File > Encoding > UTF-8).
         Il suffit ensuite de taper le texte directement accentué comme dans l'exemple ci-dessus.

Preloadtex

 preloadtex { object "Sol/Earth" }
  
 permet de charger en mémoire les textures de la Terre avant l'affichage à l'écran.