Celestia wiki - Contributions [fr]

Setactiveview

2008-09-17T14:35:09Z

Vincent : Nouvelle page : '''{ setactiveview { view 2 } }''' Active la vue n°2. ''retour à la page Script''

'''{ setactiveview { view 2 } }''' 
Active la vue n°2.

 ''retour à la page [[Script]]''

Splitview

2008-09-17T14:31:26Z

Vincent : Nouvelle page : '''{ splitview { view 1 type "h" position 0.5 } wait {duration 3} splitview {view 2 type "v" position 0.7} }''' Scinde la vue n°1 horizontalement à ...

'''{ splitview { view 1 type "h" position 0.5 } wait {duration 3} splitview {view 2 type "v" position 0.7} }''' 
Scinde la vue n°1 horizontalement à 50%, puis scinde la vue n°2 verticalement à 70%.

 ''retour à la page [[Script]]''

Singleview

2008-09-17T14:24:05Z

Vincent : Nouvelle page : '''{ singleview{} }''' Supprime toutes les vues sauf la vue active pour revenir en mode vue unique. ''retour à la page Script''

'''{ singleview{} }''' 
Supprime toutes les vues sauf la vue active pour revenir en mode vue unique.

 ''retour à la page [[Script]]''

Setgalaxylightgain

2008-09-17T14:22:10Z

Vincent :

'''{ setgalaxylightgain { gain 0.6 } }''' 
Règle le gain de luminosité des galaxies sur '''0.6''' (= 60%). 

''retour à la page [[Script]]''

Deleteview

2008-09-17T14:21:39Z

Vincent :

'''{ deleteview { view 3 } }''' 
Supprime la vue n°3. Les vues sont indexées dans l'ordre de leur création. 

''retour à la page [[Script]]''

Setradius

2008-09-17T14:20:56Z

Vincent : Nouvelle page : '''{ setradius { object "Sol/Earth" radius 1e-5 } wait { duration 3 } setradius { object "Sol/Earth" radius 6378.1 } }''' Donne au rayon de la Terre l...

'''{ setradius { object "Sol/Earth" radius 1e-5 } wait { duration 3 } setradius { object "Sol/Earth" radius 6378.1 } }''' 
Donne au rayon de la Terre la valeur '''0.00001''' km (permet de faire disparaître la Terre), puis lui redonne sa valeur réelle de '''6378.1''' km.

 ''retour à la page [[Script]]''

Setgalaxylightgain

2008-09-17T14:15:34Z

Vincent :

'''{ setgalaxylightgain {gain 0.6} }''' 
Règle le gain de luminosité des galaxies sur '''0.6''' (= 60%). 

''retour à la page [[Script]]''

Setgalaxylightgain

2008-09-17T14:14:12Z

Vincent : Nouvelle page : '''{ setgalaxylightgain {gain 0.6} }''' Règle le gain de luminosité des galaxies à 60%. ''retour à la page Script''

'''{ setgalaxylightgain {gain 0.6} }''' 
Règle le gain de luminosité des galaxies à 60%. 

''retour à la page [[Script]]''

Deleteview

2008-09-17T14:11:24Z

Vincent : Nouvelle page : '''{ deleteview {view 3} }''' Supprime la vue n°3. Les vues sont indexées dans l'ordre de leur création. ''retour à la page Script''

'''{ deleteview {view 3} }''' 
Supprime la vue n°3. Les vues sont indexées dans l'ordre de leur création. 

''retour à la page [[Script]]''

Script

2008-09-17T14:08:06Z

Vincent : /* nouvelles commandes pour Celestia 1.6 */

== Qu'est-ce qu'un script Celestia ? ==
Un '''script''' Celestia est un fichier texte (enregistré au format .[[cel]] ou .[[celx]]) comportant une série de commandes qui permettent d'exécuter et surtout d'enchaîner automatiquement la plupart des fonctions habituellement accessibles à travers les différents menus. Les scripts offrent donc la possibilité d'enchaîner, 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. 
En d'autres termes, il est donc possible de "programmer" Celestia pour visualiser de nombreux objets célestes (sous toutes les coutures), tout en affichant simultanément des commentaires, ce qui fait de Celestia un outil pédagogique de premier ordre. A ce titre, un "script" Celestia peut être considéré comme un véritable "scénario".
 

== Comment lancer ou interrompre un script dans Celestia ? ==
*Les scripts sont accessibles à partir du Menu "File" ("Fichier") > "Open script" ("Ouvrir script")
*Lors de l'installation de [[Celestia]], les fichiers .[[cel]] et .[[celx]] ont été associés à ce logiciel (sauf consigne contraire de l'utilisateur). Ainsi, il est possible de lancer un script à partir d'un gestionnaire de fichiers par un simple double-clic. Dans ce cas, [[Celestia]] se lancera automatiquement, puis chargera et lancera ledit script tout aussi automatiquement.
*Pour interrompre un script, il suffit d'une simple pression sur la touche <Echap> (ou <Esc>).
 

== 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 (rien à voir avec le langage "''Basic''" !) propre à [[Celestia]]. Ils ne permettent aucune interaction avec l'utilisateur qui ne peut que l'interrompre en cours d'exécution. 

*Les fichiers .[[celx]] utilisent une partie des fonctions du [http://www.lua.org 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. Une description (en anglais) des fonctions Lua disponibles sous [[Celestia]] a été rédigée par Harald Schmidt et est consultable ici : [http://celestia.h-schmidt.net/celx-summary-latest.html http://celestia.h-schmidt.net/].
 

== 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). Voir aussi l'article traitant des [[Fichiers_Texte|fichiers en format "texte"]].
 
''Note: A l'origine, Celestia est un logiciel anglophone, et ignore donc les spécificités des langues latines comme les accents.'' 
Si vous souhaitez donc pouvoir afficher les caractères accentués dans Celestia, assurez-vous d'utiliser un Editeur de texte '''qui supporte les caractères Unicode et le codage en UTF-8''', sans quoi Celestia fera disparaître le caractère accentué ainsi que le caractère qui suit.

Le logiciel ''Wordpad'', fourni avec Microsoft Windows, est capable de changer d'encodage et permet théoriquement d'enregistrer les scripts en format texte "unicode". Néanmoins ce logiciel est à éviter puisque les scripts enregistrés ainsi on généré des [[bugs]]. 
Les deux éditeurs de texte à privilégier pour l'écriture de scripts sont :
*[http://www.framasoft.net/article2917.html Notepad2], un petit utilitaire qui reproduit le Notepad de Windows, mais amélioré (coloration syntaxique, indentation, encodages). 
*[http://www.cielespace.org/site/index.php?option=com_docman&task=doc_details&gid=11&Itemid=51 PSPad]. Il s'agit également d'un éditeur de texte amélioré mais qui supporte en plus les macros-commandes et qui, grâce à l'optimisation de Bluz, vous permettra de mettre sous forme de Macro les commandes de [[Celestia]], de sorte à ne pas avoir à les retaper constamment. Installation : décompresser l'archive puis lancer le fichier setup. Ensuite, placer le dossier "macro" dans votre dossier personnel : "utilisateur\Application Data\Pspad". Enfin, lancez l'application et faites CTRL+MAJ+F5 pour faire apparaître la liste des fonctions. (Pour toute question concernant l'utilisation de PSPad pour [[Celestia]], voir [http://www.ikiru.ch/celestia/forum/viewtopic.php?t=304 ici].
 

== Quelles sont les principales commandes .[[cel]] ? ==

'''''[[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 distance entre la caméra et l'objet sélectionné. 

'''''[[chase]]''''' 
Régler le [[Système de Coordonnées]] sur ''chase''. 

'''''[[constelations]]''''' ''[v1.5.1]'' 
Activer ou désactiver l'affichage d'une ou plusieurs constellations. 

'''''[[constellationcolor]]''''' ''[v1.5.1]'' 
Modifier la couleur d'une ou plusieurs constellations. 

'''''[[deleteview]]''''' ''[v1.6]'' 
Supprimer une vue en mode multi-vues. 

'''''[[exit]]''''' 
Quitter Celestia. 

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

'''''[[goto]]''''' 
Déplacer la caméra et la positionner face à l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[gotoloc]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de position et d'orientation de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[gotolonglat]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de longitude et de latitude de l'objet sélectionné. 

'''''[[labels]]''''' 
Activer ou désactiver l'affichage des noms pour les différentes classes d'objets. 

'''''[[lock]]''''' 
Verrouiller 2 objets par rapport à la position de la caméra - Régler le [[Système de Coordonnées]] sur ''lock''. 

'''''[[lookback]]''''' 
Changer instantanément (sans mouvement de caméra) le champ de la caméra de 180°. 

'''''[[mark]]''''' 
Activer le marquage d'un objet avec le symbole spécifié. 

'''''[[move]]''''' 
Déplacer la caméra à la vitesse spécifiée. 

'''''[[orbit]]''''' 
Se déplacer en orbite autour de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[orbitflags]]''''' 
Activer / désactiver l'affichage des orbites pour les différentes classes d'objets. 

'''''[[play]]''' (commande disponible uniquement avec la version [http://www.ikiru.ch/celestia/forum/index.php?showtopic=195 celestia_1.4.1_patch])'' 
Jouer un fichier son. 

'''''[[preloadtex]]''''' 
Pré-charger en mémoire une [[Texture|texture]] avant son affichage à l'écran. 

'''''[[print]]''''' 
Afficher un message à l'écran sous forme de texte. 

'''''[[renderflags]]''''' 
Activer / désactiver l'affichage des différentes classes d'objets. 

'''''[[renderpath]]''''' 
Changer/choisir le chemin de rendu (basic, multitexture, vp, vp-nv, glsl). 

'''''[[rotate]]''''' 
Effectuer une rotation du champ de la caméra. 

'''''[[select]]''''' 
Selectionner un objet (planète, satellite, galaxie, etc...). 

'''''[[set]]''''' 
Régler les valeurs de ''Min Orbit Size'', ''Ambient Light Level'', ''Field Of View'', ''Star Distance Limit'', ''Star Style''. 

'''''[[setambientlight]]''''' 
Régler le niveau de lumière ambiante. 

'''''[[setactiveview]]''''' ''[v1.6]'' 
Activer une vue en mode multi-vues. 

'''''[[setfaintestautomag45deg]]''''' 
Régler la magnitude automatique à 45°. 

'''''[[setframe]]''''' 
Choisir le [[Système de Coordonnées]] à utiliser. 

'''''[[setgalaxylightgain]]''''' ''[v1.6]'' 
Régler le gain de luminosité des galaxies. 

'''''[[setlabelcolor]]''''' ''[v1.6]'' 
Régler les couleurs de la palette des noms d'objets. 

'''''[[setlinecolor]]''''' ''[v1.6]'' 
Régler les couleurs de la palette des lignes. 

'''''[[setorientation]]''''' 
Régler l'orientation de la caméra. 

'''''[[setposition]]''''' 
Régler la position de la caméra dans l'espace. 

'''''[[setradius]]''''' ''[v1.6]'' 
Régler le rayon d'un objet ssc. 

'''''[[setsurface]]''''' 
Choisir une texture alternative pour l'objet sélectionné. 

'''''[[setvisibilitylimit]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est désactivée. 

'''''[[seturl]]''''' 
Placer la caméra à la position définie par une fonction ''Cell://URL''. 

'''''[[singleview]]''''' ''[v1.6]'' 
Revenir en mode vue unique. 

'''''[[splitview]]''''' ''[v1.6]'' 
Scinder une vue (-> mode multi-vues). 

'''''[[synchronous]]''''' 
Se placer en orbite autour de l'objet sélectionné en mode ''Synch Orbit'' - Régler le [[Système de Coordonnées]] sur ''geographic''. 

'''''[[time]]''''' 
Régler la date et l'heure en utilisant les formats ''JulianDay'' ou ''UTC''. 

'''''[[timerate]]''''' 
Régler la vitesse d'écoulement du temps. 

'''''[[track]]''''' 
Fixer la caméra sur l'objet sélectionné pour le garder centré sur l'écran. 

'''''[[unmark]]''''' 
Désactiver le marquage d'un objet. 

'''''[[unmarkall]]''''' 
Désactiver le marquage de tous les objets. 

'''''[[wait]]''''' 
Insérer une pause dans l'exécution du script (du nombre de secondes spécifiées). 
 

==Quelques exemples de scripts décortiqués==
Après la théorie, la pratique... Les quelques scripts qui suivent exposent des exemples concrets qui permettront de se faire une idée plus précise du sujet. Si vous êtes vous-même auteur d'un script pour [[Celestia]], n'hésitez pas à en faire profiter les lecteurs de ce wiki.
 
*[[Script : Spoutnik1|Spoutnik 1]]. Commandes utilisées : '''''time''''', '''''select''''', '''''goto'''''.
*[[Script : Start|Start]]. Commandes utilisées : '''''preloadtext''''', '''''select''''', '''''follow''''', '''''goto''''', '''''wait''''', '''''print'''''.
 

==Aide à la création de scripts==
La création d'un script peut parfois se révéler fastidieuse. Heureusement, K.holo nous a concocté '''''Promenade''''', un petit logiciel destiné à rendre le scripting plus accessible. 
A télécharger sur son site : [http://perso.orange.fr/surok/promenade/html/promenade.htm http://perso.orange.fr/surok/promenade/html/promenade.htm] 
Si vous avez des remarques, des commentaires au sujet de ce soft, postez-les ici : [http://www.ikiru.ch/celestia/forum/viewtopic.php?t=45 http://www.ikiru.ch/celestia/forum/viewtopic.php?t=45].
 A noter qu'un bug empêchait certains d'utiliser ''Promenade''. Bug résolu, qui était dû à deux .dll manquantes : msvbvm60.dll
et VB6FR.DLL (à copier dans le dossier d'installation de ''Promenade'' et '''non''' dans "c:\Windows\System" !). Voir le forum cité ci-dessus. (Un grand merci à K.holo qui n'a pas lâché le morceau, sans oublier Bluz qui a mis la main à la pâte.)

Setambientlight

2008-09-06T12:58:17Z

Vincent : Nouvelle page : '''{ setambientlight { brightness 0.2 } }''' Règle le niveau de lumière ambiante sur '''0,2'''. ''retour à la page Script''

'''{ setambientlight { brightness 0.2 } }''' 
Règle le niveau de lumière ambiante sur '''0,2'''.

 ''retour à la page [[Script]]''

Script

2008-09-06T12:56:41Z

Vincent : /* Quelles sont les principales commandes .cel ? */

== Qu'est-ce qu'un script Celestia ? ==
Un script Celestia est un fichier texte (enregistré au format .[[cel]] ou .[[celx]]) comportant une série de commandes qui permettent d'exécuter et surtout d'enchaîner automatiquement la plupart des fonctions habituellement accessibles à travers les différents menus. Les scripts offrent donc la possibilité d'enchaîner, 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. 
En d'autres termes, il est donc possible de "programmer" Celestia pour visualiser de nombreux objets célestes (sous toutes les coutures), tout en affichant simultanément des commentaires, ce qui fait de Celestia un outil pédagogique de premier ordre. A ce titre, un "script" Celestia peut être considéré comme un véritable "scénario".
 

== Comment lancer ou interrompre un script dans Celestia ? ==
*Les scripts sont accessibles à partir du Menu "File" ("Fichier") > "Open script" ("Ouvrir script")
*Lors de l'installation de [[Celestia]], les fichiers .[[cel]] et .[[celx]] ont été associés à ce logiciel (sauf consigne contraire de l'utilisateur). Ainsi, il est possible de lancer un script à partir d'un gestionnaire de fichiers par un simple double-clic. Dans ce cas, [[Celestia]] se lancera automatiquement, puis chargera et lancera ledit script tout aussi automatiquement.
*Pour interrompre un script, il suffit d'une simple pression sur la touche <Echap> (ou <Esc>).
 

== 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 (rien à voir avec le langage "''Basic''" !) propre à [[Celestia]]. Ils ne permettent aucune interaction avec l'utilisateur qui ne peut que l'interrompre en cours d'exécution. 

*Les fichiers .[[celx]] utilisent une partie des fonctions du [http://www.lua.org 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. Une description (en anglais) des fonctions Lua disponibles sous [[Celestia]] a été rédigée par Harald Schmidt et est consultable ici : [http://celestia.h-schmidt.net/celx-summary-latest.html http://celestia.h-schmidt.net/].
 

== 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). Voir aussi l'article traitant des [[Fichiers_Texte|fichiers en format "texte"]].
 
''Note: A l'origine, Celestia est un logiciel anglophone, et ignore donc les spécificités des langues latines comme les accents.'' 
Si vous souhaitez donc pouvoir afficher les caractères accentués dans Celestia, assurez-vous d'utiliser un Editeur de texte '''qui supporte les caractères Unicode et le codage en UTF-8''', sans quoi Celestia fera disparaître le caractère accentué ainsi que le caractère qui suit.

Le logiciel ''Wordpad'', fourni avec Microsoft Windows, est capable de changer d'encodage et permet théoriquement d'enregistrer les scripts en format texte "unicode". Néanmoins ce logiciel est à éviter puisque les scripts enregistrés ainsi on généré des [[bugs]]. 
Les deux éditeurs de texte à privilégier pour l'écriture de scripts sont :
*[http://www.framasoft.net/article2917.html Notepad2], un petit utilitaire qui reproduit le Notepad de Windows, mais amélioré (coloration syntaxique, indentation, encodages). 
*[http://www.cielespace.org/site/index.php?option=com_docman&task=doc_details&gid=11&Itemid=51 PSPad]. Il s'agit également d'un éditeur de texte amélioré mais qui supporte en plus les macros-commandes et qui, grâce à l'optimisation de Bluz, vous permettra de mettre sous forme de Macro les commandes de [[Celestia]], de sorte à ne pas avoir à les retaper constamment. Installation : décompresser l'archive puis lancer le fichier setup. Ensuite, placer le dossier "macro" dans votre dossier personnel : "utilisateur\Application Data\Pspad". Enfin, lancez l'application et faites CTRL+MAJ+F5 pour faire apparaître la liste des fonctions. (Pour toute question concernant l'utilisation de PSPad pour [[Celestia]], voir [http://www.ikiru.ch/celestia/forum/viewtopic.php?t=304 ici].
 

== Quelles sont les principales commandes .[[cel]] ? ==

'''''[[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 distance entre la caméra et l'objet sélectionné. 

'''''[[Chase]]''''' 
Régler le [[Système de Coordonnées]] sur ''chase''. 

'''''[[constelations]]''''' ''[v1.5.1]'' 
Activer ou désactiver l'affichage d'une ou plusieurs constellations. 

'''''[[constellationcolor]]''''' ''[v1.5.1]'' 
Modifier la couleur d'une ou plusieurs constellations. 

'''''[[Exit]]''''' 
Quitter Celestia. 

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

'''''[[Goto]]''''' 
Déplacer la caméra et la positionner face à l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotoloc]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de position et d'orientation de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotolonglat]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de longitude et de latitude de l'objet sélectionné. 

'''''[[Labels]]''''' 
Activer ou désactiver l'affichage des noms pour les différentes classes d'objets. 

'''''[[Lock]]''''' 
Verrouiller 2 objets par rapport à la position de la caméra - Régler le [[Système de Coordonnées]] sur ''lock''. 

'''''[[Lookback]]''''' 
Changer instantanément (sans mouvement de caméra) le champ de la caméra de 180°. 

'''''[[Mark]]''''' 
Activer le marquage d'un objet avec le symbole spécifié. 

'''''[[Move]]''''' 
Déplacer la caméra à la vitesse spécifiée. 

'''''[[Orbit]]''''' 
Se déplacer en orbite autour de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Orbitflags]]''''' 
Activer / désactiver l'affichage des orbites pour les différentes classes d'objets. 

'''''[[Play]]''' (commande disponible uniquement avec la version [http://www.ikiru.ch/celestia/forum/index.php?showtopic=195 celestia_1.4.1_patch])'' 
Jouer un fichier son. 

'''''[[Preloadtex]]''''' 
Pré-charger en mémoire une [[Texture|texture]] avant son affichage à l'écran. 

'''''[[Print]]''''' 
Afficher un message à l'écran sous forme de texte. 

'''''[[Renderflags]]''''' 
Activer / désactiver l'affichage des différentes classes d'objets. 

'''''[[Renderpath]]''''' 
Changer/choisir le chemin de rendu (basic, multitexture, vp, vp-nv, glsl). 

'''''[[Rotate]]''''' 
Effectuer une rotation du champ de la caméra. 

'''''[[Select]]''''' 
Selectionner un objet (planète, satellite, galaxie, etc...). 

'''''[[Set]]''''' 
Régler les valeurs de ''Min Orbit Size'', ''Ambient Light Level'', ''Field Of View'', ''Star Distance Limit'', ''Star Style''. 

'''''[[Setambientlight]]''''' 
Régler le niveau de lumière ambiante. 

'''''[[Setfaintestautomag45deg]]''''' 
Régler la magnitude automatique à 45°. 

'''''[[Setframe]]''''' 
Choisir le [[Système de Coordonnées]] à utiliser. 

'''''[[Setorientation]]''''' 
Régler l'orientation de la caméra. 

'''''[[Setposition]]''''' 
Régler la position de la caméra dans l'espace. 

'''''[[Setsurface]]''''' 
Choisir une texture alternative pour l'objet sélectionné. 

'''''[[Setvisibilitylimit]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est désactivée. 

'''''[[Seturl]]''''' 
Placer la caméra à la position définie par une fonction ''Cell://URL''. 

'''''[[Synchronous]]''''' 
Se placer en orbite autour de l'objet sélectionné en mode ''Synch Orbit'' - Régler le [[Système de Coordonnées]] sur ''geographic''. 

'''''[[Time]]''''' 
Régler la date et l'heure en utilisant les formats ''JulianDay'' ou ''UTC''. 

'''''[[Timerate]]''''' 
Régler la vitesse d'écoulement du temps. 

'''''[[Track]]''''' 
Fixer la caméra sur l'objet sélectionné pour le garder centré sur l'écran. 

'''''[[Unmark]]''''' 
Désactiver le marquage d'un objet. 

'''''[[Unmarkall]]''''' 
Désactiver le marquage de tous les objets. 

'''''[[Wait]]''''' 
Insérer une pause dans l'exécution du script (du nombre de secondes spécifiées). 
 

==Quelques exemples de scripts décortiqués==
Après la théorie, la pratique... Les quelques scripts qui suivent exposent des exemples concrets qui permettront de se faire une idée plus précise du sujet. Si vous êtes vous-même auteur d'un script pour [[Celestia]], n'hésitez pas à en faire profiter les lecteurs de ce wiki.
 
*[[Script : Spoutnik1|Spoutnik 1]]. Commandes utilisées : '''''time''''', '''''select''''', '''''goto'''''.
*[[Script : Start|Start]]. Commandes utilisées : '''''preloadtext''''', '''''select''''', '''''follow''''', '''''goto''''', '''''wait''''', '''''print'''''.
 

==Aide à la création de scripts==
La création d'un script peut parfois se révéler fastidieuse. Heureusement, K.holo nous a concocté '''''Promenade''''', un petit logiciel destiné à rendre le scripting plus accessible. 
A télécharger sur son site : [http://perso.orange.fr/surok/promenade/html/promenade.htm http://perso.orange.fr/surok/promenade/html/promenade.htm] 
Si vous avez des remarques, des commentaires au sujet de ce soft, postez-les ici : [http://www.ikiru.ch/celestia/forum/viewtopic.php?t=45 http://www.ikiru.ch/celestia/forum/viewtopic.php?t=45].
 A noter qu'un bug empêchait certains d'utiliser ''Promenade''. Bug résolu, qui était dû à deux .dll manquantes : msvbvm60.dll
et VB6FR.DLL (à copier dans le dossier d'installation de ''Promenade'' et '''non''' dans "c:\Windows\System" !). Voir le forum cité ci-dessus. (Un grand merci à K.holo qui n'a pas lâché le morceau, sans oublier Bluz qui a mis la main à la pâte.)

Setfaintestautomag45deg

2008-09-06T12:56:04Z

Vincent : Nouvelle page : '''{ setfaintestautomag45deg { magnitude 7.5 } }''' Règle la magnitude automatique à 45° sur '''7,5'''. ''retour à la page Script''

'''{ setfaintestautomag45deg { magnitude 7.5 } }''' 
Règle la magnitude automatique à 45° sur '''7,5'''.

 ''retour à la page [[Script]]''

Script

2008-09-06T12:51:44Z

Vincent : /* Quelles sont les principales commandes .cel ? */

== Qu'est-ce qu'un script Celestia ? ==
Un script Celestia est un fichier texte (enregistré au format .[[cel]] ou .[[celx]]) comportant une série de commandes qui permettent d'exécuter et surtout d'enchaîner automatiquement la plupart des fonctions habituellement accessibles à travers les différents menus. Les scripts offrent donc la possibilité d'enchaîner, 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. 
En d'autres termes, il est donc possible de "programmer" Celestia pour visualiser de nombreux objets célestes (sous toutes les coutures), tout en affichant simultanément des commentaires, ce qui fait de Celestia un outil pédagogique de premier ordre. A ce titre, un "script" Celestia peut être considéré comme un véritable "scénario".
 

== Comment lancer ou interrompre un script dans Celestia ? ==
*Les scripts sont accessibles à partir du Menu "File" ("Fichier") > "Open script" ("Ouvrir script")
*Lors de l'installation de [[Celestia]], les fichiers .[[cel]] et .[[celx]] ont été associés à ce logiciel (sauf consigne contraire de l'utilisateur). Ainsi, il est possible de lancer un script à partir d'un gestionnaire de fichiers par un simple double-clic. Dans ce cas, [[Celestia]] se lancera automatiquement, puis chargera et lancera ledit script tout aussi automatiquement.
*Pour interrompre un script, il suffit d'une simple pression sur la touche <Echap> (ou <Esc>).
 

== 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 (rien à voir avec le langage "''Basic''" !) propre à [[Celestia]]. Ils ne permettent aucune interaction avec l'utilisateur qui ne peut que l'interrompre en cours d'exécution. 

*Les fichiers .[[celx]] utilisent une partie des fonctions du [http://www.lua.org 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. Une description (en anglais) des fonctions Lua disponibles sous [[Celestia]] a été rédigée par Harald Schmidt et est consultable ici : [http://celestia.h-schmidt.net/celx-summary-latest.html http://celestia.h-schmidt.net/].
 

== 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). Voir aussi l'article traitant des [[Fichiers_Texte|fichiers en format "texte"]].
 
''Note: A l'origine, Celestia est un logiciel anglophone, et ignore donc les spécificités des langues latines comme les accents.'' 
Si vous souhaitez donc pouvoir afficher les caractères accentués dans Celestia, assurez-vous d'utiliser un Editeur de texte '''qui supporte les caractères Unicode et le codage en UTF-8''', sans quoi Celestia fera disparaître le caractère accentué ainsi que le caractère qui suit.

Le logiciel ''Wordpad'', fourni avec Microsoft Windows, est capable de changer d'encodage et permet théoriquement d'enregistrer les scripts en format texte "unicode". Néanmoins ce logiciel est à éviter puisque les scripts enregistrés ainsi on généré des [[bugs]]. 
Les deux éditeurs de texte à privilégier pour l'écriture de scripts sont :
*[http://www.framasoft.net/article2917.html Notepad2], un petit utilitaire qui reproduit le Notepad de Windows, mais amélioré (coloration syntaxique, indentation, encodages). 
*[http://www.cielespace.org/site/index.php?option=com_docman&task=doc_details&gid=11&Itemid=51 PSPad]. Il s'agit également d'un éditeur de texte amélioré mais qui supporte en plus les macros-commandes et qui, grâce à l'optimisation de Bluz, vous permettra de mettre sous forme de Macro les commandes de [[Celestia]], de sorte à ne pas avoir à les retaper constamment. Installation : décompresser l'archive puis lancer le fichier setup. Ensuite, placer le dossier "macro" dans votre dossier personnel : "utilisateur\Application Data\Pspad". Enfin, lancez l'application et faites CTRL+MAJ+F5 pour faire apparaître la liste des fonctions. (Pour toute question concernant l'utilisation de PSPad pour [[Celestia]], voir [http://www.ikiru.ch/celestia/forum/viewtopic.php?t=304 ici].
 

== Quelles sont les principales commandes .[[cel]] ? ==

'''''[[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 distance entre la caméra et l'objet sélectionné. 

'''''[[Chase]]''''' 
Régler le [[Système de Coordonnées]] sur ''chase''. 

'''''[[constelations]]''''' ''[v1.5.1]'' 
Activer ou désactiver l'affichage d'une ou plusieurs constellations. 

'''''[[constellationcolor]]''''' ''[v1.5.1]'' 
Modifier la couleur d'une ou plusieurs constellations. 

'''''[[Exit]]''''' 
Quitter Celestia. 

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

'''''[[Goto]]''''' 
Déplacer la caméra et la positionner face à l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotoloc]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de position et d'orientation de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotolonglat]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de longitude et de latitude de l'objet sélectionné. 

'''''[[Labels]]''''' 
Activer ou désactiver l'affichage des noms pour les différentes classes d'objets. 

'''''[[Lock]]''''' 
Verrouiller 2 objets par rapport à la position de la caméra - Régler le [[Système de Coordonnées]] sur ''lock''. 

'''''[[Lookback]]''''' 
Changer instantanément (sans mouvement de caméra) le champ de la caméra de 180°. 

'''''[[Mark]]''''' 
Activer le marquage d'un objet avec le symbole spécifié. 

'''''[[Move]]''''' 
Déplacer la caméra à la vitesse spécifiée. 

'''''[[Orbit]]''''' 
Se déplacer en orbite autour de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Orbitflags]]''''' 
Activer / désactiver l'affichage des orbites pour les différentes classes d'objets. 

'''''[[Play]]''' (commande disponible uniquement avec la version [http://www.ikiru.ch/celestia/forum/index.php?showtopic=195 celestia_1.4.1_patch])'' 
Jouer un fichier son. 

'''''[[Preloadtex]]''''' 
Pré-charger en mémoire une [[Texture|texture]] avant son affichage à l'écran. 

'''''[[Print]]''''' 
Afficher un message à l'écran sous forme de texte. 

'''''[[Renderflags]]''''' 
Activer / désactiver l'affichage des différentes classes d'objets. 

'''''[[Renderpath]]''''' 
Changer/choisir le chemin de rendu (basic, multitexture, vp, vp-nv, glsl). 

'''''[[Rotate]]''''' 
Effectuer une rotation du champ de la caméra. 

'''''[[Select]]''''' 
Selectionner un objet (planète, satellite, galaxie, etc...). 

'''''[[Set]]''''' 
Régler les valeurs de ''Min Orbit Size'', ''Ambient Light Level'', ''Field Of View'', ''Star Distance Limit'', ''Star Style''. 

'''''[[Setambientlight]]''''' 
Régler le niveau de lumière ambiante. 

'''''[[Setfaintestautomag45deg]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est activée. 

'''''[[Setframe]]''''' 
Choisir le [[Système de Coordonnées]] à utiliser. 

'''''[[Setorientation]]''''' 
Régler l'orientation de la caméra. 

'''''[[Setposition]]''''' 
Régler la position de la caméra dans l'espace. 

'''''[[Setsurface]]''''' 
Choisir une texture alternative pour l'objet sélectionné. 

'''''[[Setvisibilitylimit]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est désactivée. 

'''''[[Seturl]]''''' 
Placer la caméra à la position définie par une fonction ''Cell://URL''. 

'''''[[Synchronous]]''''' 
Se placer en orbite autour de l'objet sélectionné en mode ''Synch Orbit'' - Régler le [[Système de Coordonnées]] sur ''geographic''. 

'''''[[Time]]''''' 
Régler la date et l'heure en utilisant les formats ''JulianDay'' ou ''UTC''. 

'''''[[Timerate]]''''' 
Régler la vitesse d'écoulement du temps. 

'''''[[Track]]''''' 
Fixer la caméra sur l'objet sélectionné pour le garder centré sur l'écran. 

'''''[[Unmark]]''''' 
Désactiver le marquage d'un objet. 

'''''[[Unmarkall]]''''' 
Désactiver le marquage de tous les objets. 

'''''[[Wait]]''''' 
Insérer une pause dans l'exécution du script (du nombre de secondes spécifiées). 
 

==Quelques exemples de scripts décortiqués==
Après la théorie, la pratique... Les quelques scripts qui suivent exposent des exemples concrets qui permettront de se faire une idée plus précise du sujet. Si vous êtes vous-même auteur d'un script pour [[Celestia]], n'hésitez pas à en faire profiter les lecteurs de ce wiki.
 
*[[Script : Spoutnik1|Spoutnik 1]]. Commandes utilisées : '''''time''''', '''''select''''', '''''goto'''''.
*[[Script : Start|Start]]. Commandes utilisées : '''''preloadtext''''', '''''select''''', '''''follow''''', '''''goto''''', '''''wait''''', '''''print'''''.
 

==Aide à la création de scripts==
La création d'un script peut parfois se révéler fastidieuse. Heureusement, K.holo nous a concocté '''''Promenade''''', un petit logiciel destiné à rendre le scripting plus accessible. 
A télécharger sur son site : [http://perso.orange.fr/surok/promenade/html/promenade.htm http://perso.orange.fr/surok/promenade/html/promenade.htm] 
Si vous avez des remarques, des commentaires au sujet de ce soft, postez-les ici : [http://www.ikiru.ch/celestia/forum/viewtopic.php?t=45 http://www.ikiru.ch/celestia/forum/viewtopic.php?t=45].
 A noter qu'un bug empêchait certains d'utiliser ''Promenade''. Bug résolu, qui était dû à deux .dll manquantes : msvbvm60.dll
et VB6FR.DLL (à copier dans le dossier d'installation de ''Promenade'' et '''non''' dans "c:\Windows\System" !). Voir le forum cité ci-dessus. (Un grand merci à K.holo qui n'a pas lâché le morceau, sans oublier Bluz qui a mis la main à la pâte.)

Mark

2008-09-06T11:46:06Z

Vincent :

'''{ renderflags { set "markers" } mark { object "Sol/Earth" symbol "x" size 25 color [1 0 0] alpha 0.6 } }''' 
permet d'activer le marquage de l'objet 'Terre' avec le symbole ''''x'''' de taille 25, de couleur rouge et avec un coefficient de transparence de 0,6 ''[v1.5.1]''. 
rem 1: Les symboles pouvant être utilisés sont '''"diamond"''' (par défaut), '''"plus"''', '''"square"''', '''"triangle"''', '''"x"''', '''"circle"''' ''[v1.5.1]'', '''"disk"''' ''[v1.5.1]'', '''"filledsquare"''' ''[v1.5.1]'', '''"leftarrow"''' ''[v1.5.1]'', '''"rightarrow"''' ''[v1.5.1]'', '''"downarrow"''' ''[v1.5.1]'', '''"uparrow"''' ''[v1.5.1]''. 
rem 2: Les couleurs sont définies suivant le mode [Rouge Vert Bleu], soit par exemple :
- noir : '''[0 0 0]'''
- rouge : '''[1 0 0]''' (couleur par défaut)
- vert : '''[0 1 0]'''
- bleu : '''[0 0 1]'''
- jaune : '''[1 1 0]'''
- blanc : '''[1 1 1]'''
- gris : '''[0.5 0.5 0.5]'''
- etc... 

''retour à la page [[Script]]''

Script

2008-09-06T11:43:03Z

Vincent : /* Quelles sont les principales commandes .cel ? */

== Qu'est-ce qu'un script Celestia ? ==
Un script Celestia est un fichier texte (enregistré au format .[[cel]] ou .[[celx]]) comportant une série de commandes qui permettent d'exécuter et surtout d'enchaîner automatiquement la plupart des fonctions habituellement accessibles à travers les différents menus. Les scripts offrent donc la possibilité d'enchaîner, 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. 
En d'autres termes, il est donc possible de "programmer" Celestia pour visualiser de nombreux objets célestes (sous toutes les coutures), tout en affichant simultanément des commentaires, ce qui fait de Celestia un outil pédagogique de premier ordre. A ce titre, un "script" Celestia peut être considéré comme un véritable "scénario".
 

== Comment lancer ou interrompre un script dans Celestia ? ==
*Les scripts sont accessibles à partir du Menu "File" ("Fichier") > "Open script" ("Ouvrir script")
*Lors de l'installation de [[Celestia]], les fichiers .[[cel]] et .[[celx]] ont été associés à ce logiciel (sauf consigne contraire de l'utilisateur). Ainsi, il est possible de lancer un script à partir d'un gestionnaire de fichiers par un simple double-clic. Dans ce cas, [[Celestia]] se lancera automatiquement, puis chargera et lancera ledit script tout aussi automatiquement.
*Pour interrompre un script, il suffit d'une simple pression sur la touche <Echap> (ou <Esc>).
 

== 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 (rien à voir avec le langage "''Basic''" !) propre à [[Celestia]]. Ils ne permettent aucune interaction avec l'utilisateur qui ne peut que l'interrompre en cours d'exécution. 

*Les fichiers .[[celx]] utilisent une partie des fonctions du [http://www.lua.org 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. Une description (en anglais) des fonctions Lua disponibles sous [[Celestia]] a été rédigée par Harald Schmidt et est consultable ici : [http://celestia.h-schmidt.net/celx-summary-latest.html http://celestia.h-schmidt.net/].
 

== 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). Voir aussi l'article traitant des [[Fichiers_Texte|fichiers en format "texte"]].
 
''Note: A l'origine, Celestia est un logiciel anglophone, et ignore donc les spécificités des langues latines comme les accents.'' 
Si vous souhaitez donc pouvoir afficher les caractères accentués dans Celestia, assurez-vous d'utiliser un Editeur de texte '''qui supporte les caractères Unicode et le codage en UTF-8''', sans quoi Celestia fera disparaître le caractère accentué ainsi que le caractère qui suit.

Le logiciel ''Wordpad'', fourni avec Microsoft Windows, est capable de changer d'encodage et permet théoriquement d'enregistrer les scripts en format texte "unicode". Néanmoins ce logiciel est à éviter puisque les scripts enregistrés ainsi on généré des [[bugs]]. 
Les deux éditeurs de texte à privilégier pour l'écriture de scripts sont :
*[http://www.framasoft.net/article2917.html Notepad2], un petit utilitaire qui reproduit le Notepad de Windows, mais amélioré (coloration syntaxique, indentation, encodages). 
*[http://www.cielespace.org/site/index.php?option=com_docman&task=doc_details&gid=11&Itemid=51 PSPad]. Il s'agit également d'un éditeur de texte amélioré mais qui supporte en plus les macros-commandes et qui, grâce à l'optimisation de Bluz, vous permettra de mettre sous forme de Macro les commandes de [[Celestia]], de sorte à ne pas avoir à les retaper constamment. Installation : décompresser l'archive puis lancer le fichier setup. Ensuite, placer le dossier "macro" dans votre dossier personnel : "utilisateur\Application Data\Pspad". Enfin, lancez l'application et faites CTRL+MAJ+F5 pour faire apparaître la liste des fonctions. (Pour toute question concernant l'utilisation de PSPad pour [[Celestia]], voir [http://www.ikiru.ch/celestia/forum/viewtopic.php?t=304 ici].
 

== Quelles sont les principales commandes .[[cel]] ? ==

'''''[[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 distance entre la caméra et l'objet sélectionné. 

'''''[[Chase]]''''' 
Régler le [[Système de Coordonnées]] sur ''chase''. 

'''''[[constelations]]''''' ''[v1.5.1]'' 
Activer ou désactiver l'affichage d'une ou plusieurs constellations. 

'''''[[constellationcolor]]''''' ''[v1.5.1]'' 
Modifier la couleur d'une ou plusieurs constellations. 

'''''[[Exit]]''''' 
Quitter Celestia. 

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

'''''[[Goto]]''''' 
Déplacer la caméra et la positionner face à l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotoloc]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de position et d'orientation de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotolonglat]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de longitude et de latitude de l'objet sélectionné. 

'''''[[Labels]]''''' 
Activer ou désactiver l'affichage des noms pour les différentes classes d'objets. 

'''''[[Lock]]''''' 
Verrouiller 2 objets par rapport à la position de la caméra - Régler le [[Système de Coordonnées]] sur ''lock''. 

'''''[[Lookback]]''''' 
Changer instantanément (sans mouvement de caméra) le champ de la caméra de 180°. 

'''''[[Mark]]''''' 
Activer le marquage d'un objet avec le symbole spécifié. 

'''''[[Move]]''''' 
Déplacer la caméra à la vitesse spécifiée. 

'''''[[Orbit]]''''' 
Se déplacer en orbite autour de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Orbitflags]]''''' 
Activer / désactiver l'affichage des orbites pour les différentes classes d'objets. 

'''''[[Play]]''' (commande disponible uniquement avec la version [http://www.ikiru.ch/celestia/forum/index.php?showtopic=195 celestia_1.4.1_patch])'' 
Jouer un fichier son. 

'''''[[Preloadtex]]''''' 
Pré-charger en mémoire une [[Texture|texture]] avant son affichage à l'écran. 

'''''[[Print]]''''' 
Afficher un message à l'écran sous forme de texte. 

'''''[[Renderflags]]''''' 
Activer / désactiver l'affichage des différentes classes d'objets. 

'''''[[Renderpath]]''''' 
Changer/choisir le chemin de rendu (basic, multitexture, vp, vp-nv, glsl). 

'''''[[Rotate]]''''' 
Effectuer une rotation du champ de la caméra. 

'''''[[Select]]''''' 
Selectionner un objet (planète, satellite, galaxie, etc...). 

'''''[[Set]]''''' 
Régler les valeurs de ''Min Orbit Size'', ''Ambient Light Level'', ''Field Of View'', ''Star Distance Limit'', ''Star Style''. 

'''''[[Setfaintestautomag45deg]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est activée. 

'''''[[Setframe]]''''' 
Choisir le [[Système de Coordonnées]] à utiliser. 

'''''[[Setorientation]]''''' 
Régler l'orientation de la caméra. 

'''''[[Setposition]]''''' 
Régler la position de la caméra dans l'espace. 

'''''[[Setsurface]]''''' 
Choisir une texture alternative pour l'objet sélectionné. 

'''''[[Setvisibilitylimit]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est désactivée. 

'''''[[Seturl]]''''' 
Placer la caméra à la position définie par une fonction ''Cell://URL''. 

'''''[[Synchronous]]''''' 
Se placer en orbite autour de l'objet sélectionné en mode ''Synch Orbit'' - Régler le [[Système de Coordonnées]] sur ''geographic''. 

'''''[[Time]]''''' 
Régler la date et l'heure en utilisant les formats ''JulianDay'' ou ''UTC''. 

'''''[[Timerate]]''''' 
Régler la vitesse d'écoulement du temps. 

'''''[[Track]]''''' 
Fixer la caméra sur l'objet sélectionné pour le garder centré sur l'écran. 

'''''[[Unmark]]''''' 
Désactiver le marquage d'un objet. 

'''''[[Unmarkall]]''''' 
Désactiver le marquage de tous les objets. 

'''''[[Wait]]''''' 
Insérer une pause dans l'exécution du script (du nombre de secondes spécifiées). 
 

==Quelques exemples de scripts décortiqués==
Après la théorie, la pratique... Les quelques scripts qui suivent exposent des exemples concrets qui permettront de se faire une idée plus précise du sujet. Si vous êtes vous-même auteur d'un script pour [[Celestia]], n'hésitez pas à en faire profiter les lecteurs de ce wiki.
 
*[[Script : Spoutnik1|Spoutnik 1]]. Commandes utilisées : '''''time''''', '''''select''''', '''''goto'''''.
*[[Script : Start|Start]]. Commandes utilisées : '''''preloadtext''''', '''''select''''', '''''follow''''', '''''goto''''', '''''wait''''', '''''print'''''.
 

==Aide à la création de scripts==
La création d'un script peut parfois se révéler fastidieuse. Heureusement, K.holo nous a concocté '''''Promenade''''', un petit logiciel destiné à rendre le scripting plus accessible. 
A télécharger sur son site : [http://perso.orange.fr/surok/promenade/html/promenade.htm http://perso.orange.fr/surok/promenade/html/promenade.htm] 
Si vous avez des remarques, des commentaires au sujet de ce soft, postez-les ici : [http://www.ikiru.ch/celestia/forum/viewtopic.php?t=45 http://www.ikiru.ch/celestia/forum/viewtopic.php?t=45].
 A noter qu'un bug empêchait certains d'utiliser ''Promenade''. Bug résolu, qui était dû à deux .dll manquantes : msvbvm60.dll
et VB6FR.DLL (à copier dans le dossier d'installation de ''Promenade'' et '''non''' dans "c:\Windows\System" !). Voir le forum cité ci-dessus. (Un grand merci à K.holo qui n'a pas lâché le morceau, sans oublier Bluz qui a mis la main à la pâte.)

Mark

2008-09-06T11:32:31Z

Vincent :

'''{ renderflags { set "markers" } mark { object "Sol/Earth" symbol "x" size 25 color [1 0 0] alpha 0.6 } }''' 
permet d'activer le marquage de l'objet 'Terre' avec le symbole ''''x'''' de taille 25, de couleur rouge et avec un coefficient de transparence de 0,6. 
rem 1: Les symboles pouvant être utilisés sont '''"diamond"''' (par défaut), '''"plus"''', '''"square"''', '''"triangle"''', '''"x"''', '''"circle"''', '''"disk"''', '''"filledsquare"''', '''"leftarrow"''', '''"rightarrow"''', '''"downarrow"''', '''"uparrow"'''. 
rem 2: Les couleurs sont définies suivant le mode [Rouge Vert Bleu], soit par exemple :
- noir : '''[0 0 0]'''
- rouge : '''[1 0 0]''' (couleur par défaut)
- vert : '''[0 1 0]'''
- bleu : '''[0 0 1]'''
- jaune : '''[1 1 0]'''
- blanc : '''[1 1 1]'''
- gris : '''[0.5 0.5 0.5]'''
- etc... 

''retour à la page [[Script]]''

Script

2008-09-06T11:27:53Z

Vincent : /* Quelles sont les principales commandes .cel ? */

== Qu'est-ce qu'un script Celestia ? ==
Un script Celestia est un fichier texte (enregistré au format .[[cel]] ou .[[celx]]) comportant une série de commandes qui permettent d'exécuter et surtout d'enchaîner automatiquement la plupart des fonctions habituellement accessibles à travers les différents menus. Les scripts offrent donc la possibilité d'enchaîner, 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. 
En d'autres termes, il est donc possible de "programmer" Celestia pour visualiser de nombreux objets célestes (sous toutes les coutures), tout en affichant simultanément des commentaires, ce qui fait de Celestia un outil pédagogique de premier ordre. A ce titre, un "script" Celestia peut être considéré comme un véritable "scénario".
 

== Comment lancer ou interrompre un script dans Celestia ? ==
*Les scripts sont accessibles à partir du Menu "File" ("Fichier") > "Open script" ("Ouvrir script")
*Lors de l'installation de [[Celestia]], les fichiers .[[cel]] et .[[celx]] ont été associés à ce logiciel (sauf consigne contraire de l'utilisateur). Ainsi, il est possible de lancer un script à partir d'un gestionnaire de fichiers par un simple double-clic. Dans ce cas, [[Celestia]] se lancera automatiquement, puis chargera et lancera ledit script tout aussi automatiquement.
*Pour interrompre un script, il suffit d'une simple pression sur la touche <Echap> (ou <Esc>).
 

== 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 (rien à voir avec le langage "''Basic''" !) propre à [[Celestia]]. Ils ne permettent aucune interaction avec l'utilisateur qui ne peut que l'interrompre en cours d'exécution. 

*Les fichiers .[[celx]] utilisent une partie des fonctions du [http://www.lua.org 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. Une description (en anglais) des fonctions Lua disponibles sous [[Celestia]] a été rédigée par Harald Schmidt et est consultable ici : [http://celestia.h-schmidt.net/celx-summary-latest.html http://celestia.h-schmidt.net/].
 

== 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). Voir aussi l'article traitant des [[Fichiers_Texte|fichiers en format "texte"]].
 
''Note: A l'origine, Celestia est un logiciel anglophone, et ignore donc les spécificités des langues latines comme les accents.'' 
Si vous souhaitez donc pouvoir afficher les caractères accentués dans Celestia, assurez-vous d'utiliser un Editeur de texte '''qui supporte les caractères Unicode et le codage en UTF-8''', sans quoi Celestia fera disparaître le caractère accentué ainsi que le caractère qui suit.

Le logiciel ''Wordpad'', fourni avec Microsoft Windows, est capable de changer d'encodage et permet théoriquement d'enregistrer les scripts en format texte "unicode". Néanmoins ce logiciel est à éviter puisque les scripts enregistrés ainsi on généré des [[bugs]]. 
Les deux éditeurs de texte à privilégier pour l'écriture de scripts sont :
*[http://www.framasoft.net/article2917.html Notepad2], un petit utilitaire qui reproduit le Notepad de Windows, mais amélioré (coloration syntaxique, indentation, encodages). 
*[http://www.cielespace.org/site/index.php?option=com_docman&task=doc_details&gid=11&Itemid=51 PSPad]. Il s'agit également d'un éditeur de texte amélioré mais qui supporte en plus les macros-commandes et qui, grâce à l'optimisation de Bluz, vous permettra de mettre sous forme de Macro les commandes de [[Celestia]], de sorte à ne pas avoir à les retaper constamment. Installation : décompresser l'archive puis lancer le fichier setup. Ensuite, placer le dossier "macro" dans votre dossier personnel : "utilisateur\Application Data\Pspad". Enfin, lancez l'application et faites CTRL+MAJ+F5 pour faire apparaître la liste des fonctions. (Pour toute question concernant l'utilisation de PSPad pour [[Celestia]], voir [http://www.ikiru.ch/celestia/forum/viewtopic.php?t=304 ici].
 

== Quelles sont les principales commandes .[[cel]] ? ==

'''''[[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 distance entre la caméra et l'objet sélectionné. 

'''''[[Chase]]''''' 
Régler le [[Système de Coordonnées]] sur ''chase''. 

'''''[[constelations]]''''' 
Activer ou désactiver l'affichage d'une ou plusieurs constellations. 

'''''[[constellationcolor]]''''' 
Modifier la couleur d'une ou plusieurs constellations. 

'''''[[Exit]]''''' 
Quitter Celestia. 

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

'''''[[Goto]]''''' 
Déplacer la caméra et la positionner face à l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotoloc]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de position et d'orientation de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotolonglat]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de longitude et de latitude de l'objet sélectionné. 

'''''[[Labels]]''''' 
Activer ou désactiver l'affichage des noms pour les différentes classes d'objets. 

'''''[[Lock]]''''' 
Verrouiller 2 objets par rapport à la position de la caméra - Régler le [[Système de Coordonnées]] sur ''lock''. 

'''''[[Lookback]]''''' 
Changer instantanément (sans mouvement de caméra) le champ de la caméra de 180°. 

'''''[[Mark]]''''' 
Activer le marquage d'un objet avec le symbole spécifié. 

'''''[[Move]]''''' 
Déplacer la caméra à la vitesse spécifiée. 

'''''[[Orbit]]''''' 
Se déplacer en orbite autour de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Orbitflags]]''''' 
Activer / désactiver l'affichage des orbites pour les différentes classes d'objets. 

'''''[[Play]]''' (commande disponible uniquement avec la version [http://www.ikiru.ch/celestia/forum/index.php?showtopic=195 celestia_1.4.1_patch])'' 
Jouer un fichier son. 

'''''[[Preloadtex]]''''' 
Pré-charger en mémoire une [[Texture|texture]] avant son affichage à l'écran. 

'''''[[Print]]''''' 
Afficher un message à l'écran sous forme de texte. 

'''''[[Renderflags]]''''' 
Activer / désactiver l'affichage des différentes classes d'objets. 

'''''[[Renderpath]]''''' 
Changer/choisir le chemin de rendu (basic, multitexture, vp, vp-nv, glsl). 

'''''[[Rotate]]''''' 
Effectuer une rotation du champ de la caméra. 

'''''[[Select]]''''' 
Selectionner un objet (planète, satellite, galaxie, etc...). 

'''''[[Set]]''''' 
Régler les valeurs de ''Min Orbit Size'', ''Ambient Light Level'', ''Field Of View'', ''Star Distance Limit'', ''Star Style''. 

'''''[[Setfaintestautomag45deg]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est activée. 

'''''[[Setframe]]''''' 
Choisir le [[Système de Coordonnées]] à utiliser. 

'''''[[Setorientation]]''''' 
Régler l'orientation de la caméra. 

'''''[[Setposition]]''''' 
Régler la position de la caméra dans l'espace. 

'''''[[Setsurface]]''''' 
Choisir une texture alternative pour l'objet sélectionné. 

'''''[[Setvisibilitylimit]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est désactivée. 

'''''[[Seturl]]''''' 
Placer la caméra à la position définie par une fonction ''Cell://URL''. 

'''''[[Synchronous]]''''' 
Se placer en orbite autour de l'objet sélectionné en mode ''Synch Orbit'' - Régler le [[Système de Coordonnées]] sur ''geographic''. 

'''''[[Time]]''''' 
Régler la date et l'heure en utilisant les formats ''JulianDay'' ou ''UTC''. 

'''''[[Timerate]]''''' 
Régler la vitesse d'écoulement du temps. 

'''''[[Track]]''''' 
Fixer la caméra sur l'objet sélectionné pour le garder centré sur l'écran. 

'''''[[Unmark]]''''' 
Désactiver le marquage d'un objet. 

'''''[[Unmarkall]]''''' 
Désactiver le marquage de tous les objets. 

'''''[[Wait]]''''' 
Insérer une pause dans l'exécution du script (du nombre de secondes spécifiées). 
 

==Quelques exemples de scripts décortiqués==
Après la théorie, la pratique... Les quelques scripts qui suivent exposent des exemples concrets qui permettront de se faire une idée plus précise du sujet. Si vous êtes vous-même auteur d'un script pour [[Celestia]], n'hésitez pas à en faire profiter les lecteurs de ce wiki.
 
*[[Script : Spoutnik1|Spoutnik 1]]. Commandes utilisées : '''''time''''', '''''select''''', '''''goto'''''.
*[[Script : Start|Start]]. Commandes utilisées : '''''preloadtext''''', '''''select''''', '''''follow''''', '''''goto''''', '''''wait''''', '''''print'''''.
 

==Aide à la création de scripts==
La création d'un script peut parfois se révéler fastidieuse. Heureusement, K.holo nous a concocté '''''Promenade''''', un petit logiciel destiné à rendre le scripting plus accessible. 
A télécharger sur son site : [http://perso.orange.fr/surok/promenade/html/promenade.htm http://perso.orange.fr/surok/promenade/html/promenade.htm] 
Si vous avez des remarques, des commentaires au sujet de ce soft, postez-les ici : [http://www.ikiru.ch/celestia/forum/viewtopic.php?t=45 http://www.ikiru.ch/celestia/forum/viewtopic.php?t=45].
 A noter qu'un bug empêchait certains d'utiliser ''Promenade''. Bug résolu, qui était dû à deux .dll manquantes : msvbvm60.dll
et VB6FR.DLL (à copier dans le dossier d'installation de ''Promenade'' et '''non''' dans "c:\Windows\System" !). Voir le forum cité ci-dessus. (Un grand merci à K.holo qui n'a pas lâché le morceau, sans oublier Bluz qui a mis la main à la pâte.)

Installation de Celestia en français

2006-09-05T21:48:04Z

Vincent :

[[Celestia]], longtemps diffusé exclusivement en anglais, a été depuis peu internationalisé par Christophe Teyssier, c'est-à-dire, potentiellement disponible dans toutes les langues. Ainsi, '''Celestia 1.4.1''' est désormais disponible en '''version française intégrale'''.

==Sous Windows==

La version française intégrale de Celestia 1.4.1 a été réalisée par Christophe Teyssier et Vincent. 
Pour passer à cette version française, il vous faut tout d'abord installer la version 1.4.1 officielle (en anglais) depuis le [http://www.shatters.net/celestia/download.html site officiel]. 
Il vous suffit ensuite de télécharger (et d'exécuter) le fichier d'installation de la version française depuis le [http://www.ikiru.ch/celestia/forum/viewtopic.php?t=295 forum français]. 
A noter que les versions anglaise et française coexistent parfaitement. Vous pouvez lancer l'une ou l'autre à partir de l'exécutable (ou du raccourci ) de votre choix.
 

==Sous Linux==
Les utilisateurs de Linux se voient fournir une version 1.3.2 déjà en français. Ceux qui maîtrisent mal la langue de Shakespeare peuvent donc télécharger cette version (testée avec les paquetages rpm). 

==Sous Mac OS-X==
Egalement une version française disponible (par ElChristou).

[[Image:Info.jpg]] Pour l'instant, ces versions françaises, disponibles pour Windows et pour Mac, sont soumises à la même [[licence]] que [[Celestia]].

Installation de Celestia en français

2006-09-04T16:59:35Z

Vincent :

[[Celestia]], longtemps diffusé exclusivement en anglais, a été depuis peu internationalisé par Christophe Teyssier, c'est-à-dire, potentiellement disponible dans toutes les langues. Ainsi, '''Celestia 1.4.1''' est désormais disponible en '''version française intégrale'''.

==Sous Windows==

La version française intégrale de Celestia 1.4.1 a été réalisée par Christophe Teyssier et Vincent. 
Pour passer à cette version française, il vous faut tout d'abord installer la version 1.4.1 officielle (en anglais) depuis le [http://www.shatters.net/celestia/download.html site officiel]. 
Il vous suffit ensuite de télécharger (et d'exécuter) le fichier d'installation de la version française depuis le [http://www.ikiru.ch/celestia/forum/index.php?showtopic=295 forum français]. 
A noter que les versions anglaise et française coexistent parfaitement. Vous pouvez lancer l'une ou l'autre à partir de l'exécutable (ou du raccourci ) de votre choix.
 

==Sous Linux==
Les utilisateurs de Linux se voient fournir une version 1.3.2 déjà en français. Ceux qui maîtrisent mal la langue de Shakespeare peuvent donc télécharger cette version (testée avec les paquetages rpm). 

==Sous Mac OS-X==
Egalement une version française disponible (par ElChristou).

[[Image:Info.jpg]] Pour l'instant, ces versions françaises, disponibles pour Windows et pour Mac, sont soumises à la même [[licence]] que [[Celestia]].

Mods

2006-08-28T18:10:03Z

Vincent :

[[Celestia]] étant un logiciel [http://fr.wikipedia.org/wiki/Open_source open source], il est possible d'en modifier le code. Par exemple pour y intégrer de nouvelles fonctions. Ces modifications ("mods", pour reprendre une abréviation fréquemment utilisée dans le monde du jeu vidéo) ne sont pas encore très nombreuses pour [[Celestia]]. Quelques courageux s'y sont tout de même risqués...
 
==Du son dans Celestia !... mais pas uniquement...==
===Pourquoi ce mod ?===
Peut-être vous êtes-vous dit qu'il manquait un petit "quelque chose" à [[Celestia]]. Pas de [[son]], par exemple, ou un rendu graphique (visuel) qui vous semble améliorable... Dans ce cas, intéressez-vous à ce qui suit. Il se peut aussi que vous ne vous soyez pas posé cette question avant ces "cinq dernières minutes". Dans ce cas, jetez un oeil à ce qui suit et sans doute vous direz-vous : "Mais oui, mais c'est bien sûr !".

Le "mod" proposé ici est donc né sous une double étoile :
*Améliorer la qualité graphique de [[Celestia]].
*Sonoriser [[Celestia]].

Modestement intitulé "Celestia_1.4.1_patch", ce "mod" est le fruit du travail de Vincent, Boux et Victor. Il est en réalité un peu plus qu'un simple ''patch''...
 
===Quels changements par rapport à la version 1.4.1 "officielle" ?===
*Optimisation du rendu des queues des comètes.
*Nouveau type Hubble SBbc pour la Voie Lactée.
*Nouveau modèle SBbc.pts pour la Voie Lactée basé sur une photo de la galaxie M109 (type SBbc).
*Nouveau rendu de couleur pour les galaxies avec légèrement plus de saturation.
*Lecture de fichiers [[son]].
*Image Overlay.
*Rendu de constellations semi-transparentes.
*Affichage des dates de Début/FIn pour les vaisseaux.

Cette version "celestia_1.4.1_patch" est entièrement compatible avec la version 1.4.1 officielle (les 2 versions peuvent coexister dans le même répertoire) : 
- celestia_patch.cfg est défini comme fichier de configuration par défaut (-> plus besoin de modifier le fichier d'origine celestia.cfg ) 
- celestia_patch.cfg définit deepsky_patch.dsc comme fichier par défaut (-> plus besoin de modifier le fichier d'origine deepsky.dsc )
 
===Télécharger ce mod===
'''Voici les liens où vous pouvez télécharger Celestia_1.4.1_patch 3 :'''
*Windows (4,91 Mo): [http://vincent.gian.club.fr/celestia/celestia_win32_1.4.1_patch3.zip télécharger].
*Fichiers sources modifiés à compiler (4,38 Mo): [http://vincent.gian.club.fr/celestia/celestia_1.4.1_patch3.zip télécharger].
 

===Installation sous Windows===
Dézippez (= décompressez) le fichier "Celestia_1.4.1_patch.zip" dans le répertoire principal celestia (version 1.4.1). Cliquez sur "Oui" ou "Tous" : aucun de vos fichiers d'origine ne sera modifié ni écrasé.
 

===Utilisation===
*Lancez [[Celestia]] à partir de "celestia_1.4.1_patch.exe".
*Pour tester la fonction son : ouvrez le [[script]] : "soundtest2.cel".
*Pour tester la fonction "Image Overlay" : Appuyez sur F9.
 
===Plantage possible : comment y remédier ?===

Il se peut que l'installation de ce patch provoque, à la fermeture, un plantage accompagné d'un message du type "Celestia a rencontré un problème et doit fermer". Pour résoudre ce problème, voici la marche à suivre :

*Supprimer le fichier "OpenAL32.dll" qui se trouve dans le dossier "Celestia" installé sur le disque dur.
*Télécharger la nouvelle version de ce fichier ici : [http://developer.creative.com/articles/article.asp?cat=1&sbcat=31&top=38&aid=46&file=OpenALwEAX.exe OpenALwEAX.exe]
*Lancer le fichier téléchargé par un double-clic (c'est un exécutable).
*Et voilà ! Le tour est joué et [[Celestia]] ne devrait plus planter !

Mods

2006-08-25T09:57:20Z

Vincent :

[[Celestia]] étant un logiciel [http://fr.wikipedia.org/wiki/Open_source open source], il est possible d'en modifier le code. Par exemple pour y intégrer de nouvelles fonctions. Ces modifications ("mods", pour reprendre une abréviation fréquemment utilisée dans le monde du jeu vidéo) ne sont pas encore très nombreuses pour [[Celestia]]. Quelques courageux s'y sont tout de même risqués...
 
==Du son dans Celestia !... mais pas uniquement...==
===Pourquoi ce mod ?===
Peut-être vous êtes-vous dit qu'il manquait un petit "quelque chose" à [[Celestia]]. Pas de [[son]], par exemple, ou un rendu graphique (visuel) qui vous semble améliorable... Dans ce cas, intéressez-vous à ce qui suit. Il se peut aussi que vous ne vous soyez pas posé cette question avant ces "cinq dernières minutes". Dans ce cas, jetez un oeil à ce qui suit et sans doute vous direz-vous : "Mais oui, mais c'est bien sûr !".

Le "mod" proposé ici est donc né sous une double étoile :
*Améliorer la qualité graphique de [[Celestia]].
*Sonoriser [[Celestia]].

Modestement intitulé "Celestia_1.4.1_patch", ce "mod" est le fruit du travail de Vincent, Boux et Victor. Il est en réalité un peu plus qu'un simple ''patch''...
 
===Quels changements par rapport à la version 1.4.1 "officielle" ?===
*Optimisation du rendu des queues des comètes.
*Nouveau type Hubble SBbc pour la Voie Lactée.
*Nouveau modèle SBbc.pts pour la Voie Lactée basé sur une photo de la galaxie M109 (type SBbc).
*Nouveau rendu de couleur pour les galaxies avec légèrement plus de saturation.
*Lecture de fichiers [[son]].
*Image Overlay.
*Rendu de constellations semi-transparentes.
*Affichage des dates de Début/FIn pour les vaisseaux.

Cette version "celestia_1.4.1_patch" est entièrement compatible avec la version 1.4.1 officielle (les 2 versions peuvent coexister dans le même répertoire) : 
- celestia_patch.cfg est défini comme fichier de configuration par défaut (-> plus besoin de modifier le fichier d'origine celestia.cfg ) 
- celestia_patch.cfg définit deepsky_patch.dsc comme fichier par défaut (-> plus besoin de modifier le fichier d'origine deepsky.dsc )
 
===Télécharger ce mod===
'''Voici les liens où vous pouvez télécharger Celestia_1.4.1_patch :'''
*Windows (4,83 Mo): [http://vincent.gian.club.fr/celestia/celestia_win32_1.4.1_patch2.zip télécharger].
*Fichiers sources modifiés à compiler (4,28 Mo): [http://vincent.gian.club.fr/celestia/celestia_1.4.1_patch2.zip télécharger].
 

===Installation sous Windows===
Dézippez (= décompressez) le fichier "Celestia_1.4.1_patch.zip" dans le répertoire principal celestia (version 1.4.1). Cliquez sur "Oui" ou "Tous" : aucun de vos fichiers d'origine ne sera modifié ni écrasé.
 

===Utilisation===
*Lancez [[Celestia]] à partir de "celestia_1.4.1_patch.exe".
*Pour tester la fonction son : ouvrez le [[script]] : "soundtest2.cel".
*Pour tester la fonction "Image Overlay" : Appuyez sur F9.
 
===Plantage possible : comment y remédier ?===

Il se peut que l'installation de ce patch provoque, à la fermeture, un plantage accompagné d'un message du type "Celestia a rencontré un problème et doit fermer". Pour résoudre ce problème, voici la marche à suivre :

*Supprimer le fichier "OpenAL32.dll" qui se trouve dans le dossier "Celestia" installé sur le disque dur.
*Télécharger la nouvelle version de ce fichier ici : [http://developer.creative.com/articles/article.asp?cat=1&sbcat=31&top=38&aid=46&file=OpenALwEAX.exe OpenALwEAX.exe]
*Lancer le fichier téléchargé par un double-clic (c'est un exécutable).
*Et voilà ! Le tour est joué et [[Celestia]] ne devrait plus planter !

Son

2006-08-25T09:44:42Z

Vincent :

== Le son sous Celestia ==

Même s'il est impossible que le son puisse voyager dans l'espace à cause des lois de la physique, il peut être utile de disposer du son dans Celestia. Par exemple, pour capturer l'attention d'un public dans un planétarium, où dans diverses autres situations pédagogiques. Il suffira pour cela d'utiliser un script qui, plutôt que d'afficher un simple texte, émettra une bande son avec une voix off et éventuellement une musique d'ambiance qui accompagnera la lecture du script.

=== Installation pour Microsoft Windows===
Il existe différentes méthodes pour disposer du son sous Celestia. En effet, le patch d'origine créé par Victor (pseudonyme: vhpgomes) et diffusé sur les forums de [http://shatters.net/forum Shatters.net] a été repris, optimisé et amélioré par d'autres contributeurs qui en ont fait plusieurs sous variantes.
''Si le sujet vous intérêsse, et que vous voulez contribuer à un "projet audio", rendez-vous sur les forums de shatters.net (lien ci-dessus).''
En définitive, voici la méthode la plus simple pour bénéficier du son dans Celestia : 
1 - Télécharger et installer la '''version officielle 1.4.1''' de Celestia depuis le [http://www.shatters.net/celestia site officiel]. 
2 - Télécharger la version optimisé réalisée par Vincent appelée [http://www.ikiru.ch/celestia/forum/index.php?showtopic=241 '''Celestia patch 3'''] (disponible en fichiers sources et/ou sous forme d'éxecutable pour Windows]. 
3 - Décompresser (dézipper) le fichier zip et copier-coller tous les fichiers du dossier ''celestia_win32_1.4.1_patch3'' dans votre dossier principal de Celestia. Pas de souci, aucun fichier original ne sera effacé/écrasé. 
4 - Voilà, il ne vous reste plus qu'à lancer Celestia à partir de l'exécutable ''celestia_1.4.1_patch3.exe''. 
''rem : '''Celestia patch 3''' offre de nombreuses autres optimisations notamment dans le domaine graphique. Pour plus d'information, rendez-vous sur la page [[mods]].''

Son

2006-08-25T09:39:24Z

Vincent :

== Le son sous Celestia ==

Même s'il est impossible que le son puisse voyager dans l'espace à cause des lois de la physique, il peut être utile de disposer du son dans Celestia, par exemple, pour capturer l'attention d'un public dans un planétarium, où dans diverses autres situations pédagogiques. Il suffit pour cela d'utiliser un script qui, plutôt que d'afficher un simple texte, émettra une bande son avec une voix off et éventuellement une musique d'ambiance qui accompagnera la lecture du script.

=== Installation pour Microsoft Windows===
Il existe plusieurs méthodes différentes pour disposer du son sous Celestia.
Cela s'explique par le fait qu'à l'origine, le patch a été crée par Victor (pseudonyme: vhpgomes) puis diffusé sur les forums de [http://shatters.net/forum Shatters.net]. 
Son patch fut repris, optimisé et amélioré par d'autres contributeurs qui en ont fait plusieurs sous variantes.
''Si le sujet vous intérêsse, et que vous voulez contribuer à un "projet audio", rendez-vous sur les forums de shatters.net (lien ci-dessus).''
Voici en définitive la méthode la plus simple à mettre en oeuvre : 
1 - Télécharger et installer la '''version officielle 1.4.1''' de Celestia depuis le [http://www.shatters.net/celestia site officiel]. 
2 - Télécharger la version optimisé réalisée par Vincent appelée [http://www.ikiru.ch/celestia/forum/index.php?showtopic=241 '''Celestia patch 3'''] (disponible en fichiers sources et/ou sous forme d'éxecutable pour Windows]. 
3 - Décompresser (dézipper) le fichier zip et copier-coller tous les fichiers du dossier ''celestia_win32_1.4.1_patch3'' dans votre dossier principal de Celestia. Pas de souci, aucun fichier original ne sera effacé/écrasé. 
4 - Voilà, il ne vous reste plus qu'à lancer Celestia à partir de l'exécutable ''celestia_1.4.1_patch3.exe''. 
''rem : '''Celestia patch 3''' offre de nombreuses autres optimisations notamment dans le domaine graphique. Pour plus d'information, rendez-vous sur la page [[mods]].''

Son

2006-08-25T09:36:36Z

Vincent :

== Le son sous Celestia ==

Même s'il est impossible que le son puisse voyager dans l'espace à cause des lois de la physique, il peut être utile de disposer du son dans Celestia, par exemple, pour capturer l'attention d'un public dans un planétarium, où dans diverses situations pédagogiques. Il suffit pour cela d'utiliser un script qui, plutôt que d'afficher un simple texte, émettra une bande son avec une voix off et éventuellement une musique d'ambiance pour accompagner la lecture du script.

=== Installation pour Microsoft Windows===
Il existe plusieurs méthodes différentes pour disposer du son sous Celestia.
Cela s'explique par le fait qu'à l'origine, le patch a été crée par Victor (pseudonyme: vhpgomes) puis diffusé sur les forums de [http://shatters.net/forum Shatters.net]. 
Son patch fut repris, optimisé et amélioré par d'autres contributeurs qui en ont fait plusieurs sous variantes.
''Si le sujet vous intérêsse, et que vous voulez contribuer à un "projet audio", rendez-vous sur les forums de shatters.net (lien ci-dessus).''
Voici en définitive la méthode la plus simple à mettre en oeuvre : 
1 - Télécharger et installer la '''version officielle 1.4.1''' de Celestia depuis le [http://www.shatters.net/celestia site officiel]. 
2 - Télécharger la version optimisé réalisée par Vincent appelée [http://www.ikiru.ch/celestia/forum/index.php?showtopic=241 '''Celestia patch 3'''] (disponible en fichiers sources et/ou sous forme d'éxecutable pour Windows]. 
3 - Décompresser (dézipper) le fichier zip et copier-coller tous les fichiers du dossier ''celestia_win32_1.4.1_patch3'' dans votre dossier principale de Celestia. Pas de souci, aucun fichier original ne sera effacé/écrasé. 
4 - Voilà, il ne vous reste plus qu'à lancer Celestia à partir de l'exécutable ''celestia_1.4.1_patch3.exe''. 
rem : '''Celestia patch 3''' offre de nombreuses autres optimisations notamment dans le domaine graphique. Pour plus d'information, rendez-vous sur la page [[mods]].

Ssc

2006-04-08T15:06:01Z

Vincent : /* Utilisation */

== Qu'est-ce qu'un fichier ssc ? ==

C'est un fichier "Stellar System Catalog". Il permet de définir les caractéristiques (rayon, texture, données gravitationnaires, etc) d'objets tels que les planètes, satellites, astéroïdes, comètes, vaisseaux, ou localisations. Rapidement, si on veut avancer un peu dans [[Celestia]], on est obligé de s'y mettre.

Se place soit dans le répertoire "data" à la racine de [[Celestia]], soit (bien mieux) à la racine du répertoire créé spécifiquement pour l'add-on dans le répertoire "extra".

Pour visualiser ou modifier un fichier ssc, un simple éditeur de texte fera l'affaire ; concrètement, il ne s'agit que d'un fichier texte dont l'extension .txt a été modifiée en .ssc. (Sous Windows, on pourra utiliser Notepad ou Wordpad.) Voir aussi l'article traitant des [[Fichiers_Texte|fichiers en format texte]].

== Utilisation ==

Voici quelques valeurs que l'on peut définir dans un fichier ssc :

'''SemiMajorAxis'''

Représente le demi grand axe de l’orbite de l’[[objet]] (distance moyenne planète-soleil). Cette valeur est exprimée en unité astronomique (1 UA = distance Terre-Soleil = environ 150 millions de km).

'''Beginning "AAAA MM JJ HH:MM"'''
Détermine la date (AAAA MM JJ = année, mois, jour) et l'horaire (HH:MM = heure:minutes) à partir desquels l'[[objet]] sera affiché par Celestia.

'''Ending "AAAA MM JJ HH:MM"'''
Détermine (exactement de la même manière que pour '''Beginning''') la date et l'horaire à partir desquels l'[[objet]] ''ne sera plus'' affiché par Celestia.

== Limitation ==

Celestia impose une limite de visibilité pour les objets déclarés dans un fichier [[ssc]] : on ne peut les placer au-delà de 16'ooo années-lumière de notre Soleil, sinon ils ne seront pas visibles. On peut contourner ce problème, en déclarant un objet avec un [[dsc]] (qui n'impose pas de limite de distance), même si ce n'est pas une nébuleuse ou une galaxie.

Pourquoi cette limite dans le logiciel ?

1. C'est principalement en raison de la limite astronomique du catalogue Hipparcos, où les mesures ne sont précises qu'avec une parallaxe (méthode de calcul de la distance d'un astre à partir de l'angle sous lequel est vue la distance Terre-Soleil depuis cet astre) de 1 milli-arc-seconde. Ce qui implique que les objets situés au-delà de 16'ooo années-lumière ne peuvent être mesurés (et donc placés) précisément.

2. Limite logicielle puisque du coup, [[Celestia]] a limité l'affichage des objets au delà de 15-16'000 années-lumière pour permettre un calcul et donc un affichage plus rapide.

== Fichiers "location" ==

Ce sont des positions qu'on souhaite montrer sur un [[objet]] (souvent une planète). Montrer les capitales sur la Terre, le point d'amarsissage de Pathfinder, l'alunissage d'Apollo 11, etc.

=== Utilisation ===

Ils sont réunis dans des fichiers [[ssc]], eux-même catégorisés selon la planète. Il suffit de mettre ces fichiers dans le répertoire "Extra" de [[Celestia]], mais dans ma recherche de la rationalisation pure ;-) j'ai crée un répertoire "Location" à l'intérieur du répertoire mentionné.

Pour les afficher dans [[Celestia]], il suffit de faire le signe & (shift+6, selon les claviers); on peut aussi avoir accès à toute une série d'options dans le menu "Locations", pour régler par exemple un filtre, et choisir une taille minimum des objets à afficher (densité démographique pour les villes, par exemple).

Ssc

2006-04-08T15:05:04Z

Vincent : /* Qu'est-ce qu'un fichier ssc ? */

== Qu'est-ce qu'un fichier ssc ? ==

C'est un fichier "Stellar System Catalog". Il permet de définir les caractéristiques (rayon, texture, données gravitationnaires, etc) d'objets tels que les planètes, satellites, astéroïdes, comètes, vaisseaux, ou localisations. Rapidement, si on veut avancer un peu dans [[Celestia]], on est obligé de s'y mettre.

Se place soit dans le répertoire "data" à la racine de [[Celestia]], soit (bien mieux) à la racine du répertoire créé spécifiquement pour l'add-on dans le répertoire "extra".

Pour visualiser ou modifier un fichier ssc, un simple éditeur de texte fera l'affaire ; concrètement, il ne s'agit que d'un fichier texte dont l'extension .txt a été modifiée en .ssc. (Sous Windows, on pourra utiliser Notepad ou Wordpad.) Voir aussi l'article traitant des [[Fichiers_Texte|fichiers en format texte]].

== Utilisation ==

Voici quelques valeurs que peut prendre un fichier ssc :

'''SemiMajorAxis'''

Représente le demi grand axe de l’orbite de l’[[objet]] (distance moyenne planète-soleil). Cette valeur est exprimée en unité astronomique (1 UA = distance Terre-Soleil = environ 150 millions de km).

'''Beginning "AAAA MM JJ HH:MM"'''
Détermine la date (AAAA MM JJ = année, mois, jour) et l'horaire (HH:MM = heure:minutes) à partir desquels l'[[objet]] sera affiché par Celestia.

'''Ending "AAAA MM JJ HH:MM"'''
Détermine (exactement de la même manière que pour '''Beginning''') la date et l'horaire à partir desquels l'[[objet]] ''ne sera plus'' affiché par Celestia.

== Limitation ==

Celestia impose une limite de visibilité pour les objets déclarés dans un fichier [[ssc]] : on ne peut les placer au-delà de 16'ooo années-lumière de notre Soleil, sinon ils ne seront pas visibles. On peut contourner ce problème, en déclarant un objet avec un [[dsc]] (qui n'impose pas de limite de distance), même si ce n'est pas une nébuleuse ou une galaxie.

Pourquoi cette limite dans le logiciel ?

1. C'est principalement en raison de la limite astronomique du catalogue Hipparcos, où les mesures ne sont précises qu'avec une parallaxe (méthode de calcul de la distance d'un astre à partir de l'angle sous lequel est vue la distance Terre-Soleil depuis cet astre) de 1 milli-arc-seconde. Ce qui implique que les objets situés au-delà de 16'ooo années-lumière ne peuvent être mesurés (et donc placés) précisément.

2. Limite logicielle puisque du coup, [[Celestia]] a limité l'affichage des objets au delà de 15-16'000 années-lumière pour permettre un calcul et donc un affichage plus rapide.

== Fichiers "location" ==

Ce sont des positions qu'on souhaite montrer sur un [[objet]] (souvent une planète). Montrer les capitales sur la Terre, le point d'amarsissage de Pathfinder, l'alunissage d'Apollo 11, etc.

=== Utilisation ===

Ils sont réunis dans des fichiers [[ssc]], eux-même catégorisés selon la planète. Il suffit de mettre ces fichiers dans le répertoire "Extra" de [[Celestia]], mais dans ma recherche de la rationalisation pure ;-) j'ai crée un répertoire "Location" à l'intérieur du répertoire mentionné.

Pour les afficher dans [[Celestia]], il suffit de faire le signe & (shift+6, selon les claviers); on peut aussi avoir accès à toute une série d'options dans le menu "Locations", pour régler par exemple un filtre, et choisir une taille minimum des objets à afficher (densité démographique pour les villes, par exemple).

Script

2006-03-12T11:48:59Z

Vincent : /* Quelles sont les principales commandes .cel ? */

== 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 qui permettent 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. 
Il est donc possible de "programmer" Celestia pour visualiser de nombreux objets célestes (sous toutes les coutures), tout en affichant simultanément des commentaires, ce qui fait de celestia un outil pédagogique de premier ordre. A ce titre, un "script" Celestia peut être considéré comme un véritable "scénario".
 
== 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 [http://www.lua.org 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). Voir aussi l'article traitant des [[Fichiers_Texte|fichiers en format "texte"]].
 

== Quelles sont les principales commandes .[[cel]] ? ==

'''''[[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 distance entre la caméra et l'objet sélectionné. 

'''''[[Chase]]''''' 
Régler le [[Système de Coordonnées]] sur ''chase''. 

'''''[[Exit]]''''' 
Quitter Celestia. 

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

'''''[[Goto]]''''' 
Déplacer la caméra et la positionner face à l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotoloc]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de position et d'orientation de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotolonglat]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de longitude et de latitude de l'objet sélectionné. 

'''''[[Labels]]''''' 
Activer ou désactiver l'affichage des noms pour les différentes classes d'objets. 

'''''[[Lock]]''''' 
Verrouiller 2 objets par rapport à la position de la caméra - Régler le [[Système de Coordonnées]] sur ''lock''. 

'''''[[Lookback]]''''' 
Changer instantanément (sans mouvement de caméra) le champ de la caméra de 180°. 

'''''[[Mark]]''''' 
Activer le marquage d'un objet avec le symbole spécifié. 

'''''[[Move]]''''' 
Déplacer la caméra à la vitesse spécifiée. 

'''''[[Orbit]]''''' 
Se déplacer en orbite autour de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Orbitflags]]''''' 
Activer / désactiver l'affichage des orbites pour les différentes classes d'objets. 

'''''[[Play]]''' (commande disponible uniquement avec la version [http://www.ikiru.ch/celestia/forum/index.php?showtopic=195 celestia_1.4.1_patch])'' 
Jouer un fichier son. 

'''''[[Preloadtex]]''''' 
Pré-charger en mémoire une [[Texture|texture]] avant son affichage à l'écran. 

'''''[[Print]]''''' 
Afficher un message à l'écran sous forme de texte. 

'''''[[Renderflags]]''''' 
Activer / désactiver l'affichage des différentes classes d'objets. 

'''''[[Renderpath]]''''' 
Changer/choisir le chemin de rendu (basic, multitexture, vp, vp-nv, glsl). 

'''''[[Rotate]]''''' 
Effectuer une rotation du champ de la caméra. 

'''''[[Select]]''''' 
Selectionner un objet (planète, satellite, galaxie, etc...). 

'''''[[Set]]''''' 
Régler les valeurs de ''Min Orbit Size'', ''Ambient Light Level'', ''Field Of View'', ''Star Distance Limit'', ''Star Style''. 

'''''[[Setfaintestautomag45deg]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est activée. 

'''''[[Setframe]]''''' 
Choisir le [[Système de Coordonnées]] à utiliser. 

'''''[[Setorientation]]''''' 
Régler l'orientation de la caméra. 

'''''[[Setposition]]''''' 
Régler la position de la caméra dans l'espace. 

'''''[[Setsurface]]''''' 
Choisir une texture alternative pour l'objet sélectionné. 

'''''[[Setvisibilitylimit]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est désactivée. 

'''''[[Seturl]]''''' 
Placer la caméra à la position définie par une fonction ''Cell://URL''. 

'''''[[Synchronus]]''''' 
Se placer en orbite autour de l'objet sélectionné en mode ''Synch Orbit'' - Régler le [[Système de Coordonnées]] sur ''geographic''. 

'''''[[Time]]''''' 
Régler la date et l'heure en utilisant les formats ''JulianDay'' ou ''UTC''. 

'''''[[Timerate]]''''' 
Régler la vitesse d'écoulement du temps. 

'''''[[Track]]''''' 
Fixer la caméra sur l'objet sélectionné pour le garder centré sur l'écran. 

'''''[[Unmark]]''''' 
Désactiver le marquage d'un objet. 

'''''[[Unmarkall]]''''' 
Désactiver le marquage de tous les objets. 

'''''[[Wait]]''''' 
Insérer une pause dans l'exécution du script (du nombre de secondes spécifiées). 
 

==Quelques exemples de scripts décortiqués==
Après la théorie, la pratique... Les quelques scripts qui suivent exposent des exemples concrets qui permettront de se faire une idée plus précise du sujet. Si vous êtes vous-même auteur d'un script pour [[Celestia]], n'hésitez pas à en faire profiter les lecteurs de ce wiki.
 
*[[Script : Spoutnik1|Spoutnik 1]]. Commandes utilisées : ''time'', ''select'', ''goto''.
*[[Script : Start|Start]]. Commandes utilisées : ''preloadtext'', ''select'', ''follow'', ''goto'', ''wait'', ''print''.

Script

2006-03-12T09:46:50Z

Vincent : /* Quelles sont les principales commandes .cel ? */

== 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 qui permettent 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. 
Il est donc possible de "programmer" Celestia pour visualiser de nombreux objets célestes (sous toutes les coutures), tout en affichant simultanément des commentaires, ce qui fait de celestia un outil pédagogique de premier ordre. A ce titre, un "script" Celestia peut être considéré comme un véritable "scénario".
 
== 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 [http://www.lua.org 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). Voir aussi l'article traitant des [[Fichiers_Texte|fichiers en format "texte"]].
 

== Quelles sont les principales commandes .[[cel]] ? ==

'''''[[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 distance entre la caméra et l'objet sélectionné. 

'''''[[Chase]]''''' 
Régler le [[Système de Coordonnées]] sur ''chase''. 

'''''[[Exit]]''''' 
Quitter Celestia. 

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

'''''[[Goto]]''''' 
Déplacer la caméra et la positionner face à l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotoloc]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de position et d'orientation de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotolonglat]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de longitude et de latitude de l'objet sélectionné. 

'''''[[Labels]]''''' 
Activer ou désactiver l'affichage des noms pour les différentes classes d'objets. 

'''''[[Lock]]''''' 
Verrouiller 2 objets par rapport à la position de la caméra - Régler le [[Système de Coordonnées]] sur ''lock''. 

'''''[[Lookback]]''''' 
Changer instantanément (sans mouvement de caméra) le champ de la caméra de 180°. 

'''''[[Mark]]''''' 
Activer le marquage d'un objet avec le symbole spécifié. 

'''''[[Move]]''''' 
Déplacer la caméra à la vitesse spécifiée. 

'''''[[Orbit]]''''' 
Se déplacer en orbite autour de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Orbitflags]]''''' 
Activer / désactiver l'affichage des orbites pour les différentes classes d'objets. 

'''''[[Play]]''' (commande présente uniquement dans la version [http://www.ikiru.ch/celestia/forum/index.php?showtopic=195 celestia_1.4.1_patch])'' 
Jouer un fichier son. 

'''''[[Preloadtex]]''''' 
Pré-charger en mémoire une [[Texture|texture]] avant son affichage à l'écran. 

'''''[[Print]]''''' 
Afficher un message à l'écran sous forme de texte. 

'''''[[Renderflags]]''''' 
Activer / désactiver l'affichage des différentes classes d'objets. 

'''''[[Renderpath]]''''' 
Changer/choisir le chemin de rendu (basic, multitexture, vp, vp-nv, glsl). 

'''''[[Rotate]]''''' 
Effectuer une rotation du champ de la caméra. 

'''''[[Select]]''''' 
Selectionner un objet (planète, satellite, galaxie, etc...). 

'''''[[Set]]''''' 
Régler les valeurs de ''Min Orbit Size'', ''Ambient Light Level'', ''Field Of View'', ''Star Distance Limit'', ''Star Style''. 

'''''[[Setfaintestautomag45deg]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est activée. 

'''''[[Setframe]]''''' 
Choisir le [[Système de Coordonnées]] à utiliser. 

'''''[[Setorientation]]''''' 
Régler l'orientation de la caméra. 

'''''[[Setposition]]''''' 
Régler la position de la caméra dans l'espace. 

'''''[[Setsurface]]''''' 
Choisir une texture alternative pour l'objet sélectionné. 

'''''[[Setvisibilitylimit]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est désactivée. 

'''''[[Seturl]]''''' 
Placer la caméra à la position définie par une fonction ''Cell://URL''. 

'''''[[Synchronus]]''''' 
Se placer en orbite autour de l'objet sélectionné en mode ''Synch Orbit'' - Régler le [[Système de Coordonnées]] sur ''geographic''. 

'''''[[Time]]''''' 
Régler la date et l'heure en utilisant les formats ''JulianDay'' ou ''UTC''. 

'''''[[Timerate]]''''' 
Régler la vitesse d'écoulement du temps. 

'''''[[Track]]''''' 
Fixer la caméra sur l'objet sélectionné pour le garder centré sur l'écran. 

'''''[[Unmark]]''''' 
Désactiver le marquage d'un objet. 

'''''[[Unmarkall]]''''' 
Désactiver le marquage de tous les objets. 

'''''[[Wait]]''''' 
Insérer une pause dans l'exécution du script (du nombre de secondes spécifiées). 
 

==Quelques exemples de scripts décortiqués==
Après la théorie, la pratique... Les quelques scripts qui suivent exposent des exemples concrets qui permettront de se faire une idée plus précise du sujet. Si vous êtes vous-même auteur d'un script pour [[Celestia]], n'hésitez pas à en faire profiter les lecteurs de ce wiki.
 
*[[Script : Spoutnik1|Spoutnik 1]]. Commandes utilisées : ''time'', ''select'', ''goto''.
*[[Script : Start|Start]]. Commandes utilisées : ''preloadtext'', ''select'', ''follow'', ''goto'', ''wait'', ''print''.

Renderpath

2006-03-07T15:51:11Z

Vincent :

'''{ select {object "Sol/Earth"} follow {} gotolonglat { time 5 distance 5 longitude 0 latitude 20 } wait {duration 6 } renderpath {path "basic"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : Basic" } wait {duration 6 } renderpath {path "multitexture"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : Multitexture" } wait {duration 6 } renderpath {path "vp"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : OpenGL vertex program" } wait {duration 6 } renderpath {path "vp-nv"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : OpenGL vertex program/NVIDIA combiners" } wait {duration 6 } renderpath {path "glsl"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : OpenGL 2.0" } wait {duration 6 } }''' 
permet de choisir le chemin de rendu parmi les suivants : "basic" -> Basic "multitexture" -> Multitexture "vp" -> OpenGL vertex program "vp-nv" -> OpenGL vertex program/NVIDIA combiners "glsl" -> OpenGL 2.0 

''retour à la page [[Script]]''

Exit

2006-03-07T10:36:43Z

Vincent :

'''{ exit {} }''' 
permet de quitter Celestia. 

''retour à la page [[Script]]''

Renderpath

2006-03-07T10:35:02Z

Vincent :

'''{ select {object "Sol/Earth"} follow {} gotolonglat { time 5 distance 5 longitude 0 latitude 20 } wait {duration 6 } renderpath {path "basic"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : Basic" } wait {duration 6 } renderpath {path "multitexture"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : Multitexture" } wait {duration 6 } renderpath {path "vp"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : OpenGL vertex program" } wait {duration 6 } renderpath {path "vp-nv"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : OpenGL vertex program/NVIDIA combiners" } wait {duration 6 } renderpath {path "glsl"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : OpenGL 2.0" } wait {duration 6 } }''' 
permet de choisir le changer de rendu parmi les suivants : "basic" -> Basic "multitexture" -> Multitexture "vp" -> OpenGL vertex program "vp-nv" -> OpenGL vertex program/NVIDIA combiners "glsl" -> OpenGL 2.0 

''retour à la page [[Script]]''

Renderpath

2006-03-07T10:31:59Z

Vincent :

'''{ select {object "Sol/Earth"} follow {} gotolonglat { time 5 distance 5 longitude 0 latitude 20 } wait {duration 6 } renderpath {path "basic"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : Basic" } wait {duration 6 } renderpath {path "multitexture"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : Multitexture" } wait {duration 6 } renderpath {path "vp"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : OpenGL vertex program" } wait {duration 6 } renderpath {path "vp-nv"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : OpenGL vertex program/NVIDIA combiners" } wait {duration 6 } renderpath {path "glsl"} print { origin "bottomleft" row -4 column 2 duration 6 text "Chemin de rendu : OpenGL 2.0" } wait {duration 6 } }''' 
permet de choisir le changer de rendu parmi les suivants : "basic" -> Basic "multitexture" -> Multitexture "vp" -> OpenGL vertex program "vp-nv" -> OpenGL vertex program/NVIDIA combiners "glsl" -> OpenGL 2.0

''retour à la page [[Script]]''

Script

2006-03-07T10:25:26Z

Vincent : /* Quelles sont les principales commandes .cel ? */

== 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 qui permettent 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. 
Il est donc possible de "programmer" Celestia pour visualiser de nombreux objets célestes (sous toutes les coutures), tout en affichant simultanément des commentaires, ce qui fait de celestia un outil pédagogique de premier ordre. A ce titre, un "script" Celestia peut être considéré comme un véritable "scénario".
 
== 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 [http://www.lua.org 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). Voir aussi l'article traitant des [[Fichiers_Texte|fichiers en format "texte"]].
 

== Quelles sont les principales commandes .[[cel]] ? ==

'''''[[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 distance entre la caméra et l'objet sélectionné. 

'''''[[Chase]]''''' 
Régler le [[Système de Coordonnées]] sur ''chase''. 

'''''[[Exit]]''''' 
Quitter Celestia. 

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

'''''[[Goto]]''''' 
Déplacer la caméra et la positionner face à l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotoloc]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de position et d'orientation de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotolonglat]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de longitude et de latitude de l'objet sélectionné. 

'''''[[Labels]]''''' 
Activer ou désactiver l'affichage des noms pour les différentes classes d'objets. 

'''''[[Lock]]''''' 
Verrouiller 2 objets par rapport à la position de la caméra - Régler le [[Système de Coordonnées]] sur ''lock''. 

'''''[[Lookback]]''''' 
Changer instantanément (sans mouvement de caméra) le champ de la caméra de 180°. 

'''''[[Mark]]''''' 
Activer le marquage d'un objet avec le symbole spécifié. 

'''''[[Move]]''''' 
Déplacer la caméra à la vitesse spécifiée. 

'''''[[Orbit]]''''' 
Se déplacer en orbite autour de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Orbitflags]]''''' 
Activer / désactiver l'affichage des orbites pour les différentes classes d'objets. 

'''''[[Preloadtex]]''''' 
Pré-charger en mémoire une [[Texture|texture]] avant son affichage à l'écran. 

'''''[[Print]]''''' 
Afficher un message à l'écran sous forme de texte. 

'''''[[Renderflags]]''''' 
Activer / désactiver l'affichage des différentes classes d'objets. 

'''''[[Renderpath]]''''' 
Changer/choisir le chemin de rendu (basic, multitexture, vp, vp-nv, glsl). 

'''''[[Rotate]]''''' 
Effectuer une rotation du champ de la caméra. 

'''''[[Select]]''''' 
Selectionner un objet (planète, satellite, galaxie, etc...). 

'''''[[Set]]''''' 
Régler les valeurs de ''Min Orbit Size'', ''Ambient Light Level'', ''Field Of View'', ''Star Distance Limit'', ''Star Style''. 

'''''[[Setfaintestautomag45deg]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est activée. 

'''''[[Setframe]]''''' 
Choisir le [[Système de Coordonnées]] à utiliser. 

'''''[[Setorientation]]''''' 
Régler l'orientation de la caméra. 

'''''[[Setposition]]''''' 
Régler la position de la caméra dans l'espace. 

'''''[[Setsurface]]''''' 
Choisir une texture alternative pour l'objet sélectionné. 

'''''[[Setvisibilitylimit]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est désactivée. 

'''''[[Seturl]]''''' 
Placer la caméra à la position définie par une fonction ''Cell://URL''. 

'''''[[Synchronus]]''''' 
Se placer en orbite autour de l'objet sélectionné en mode ''Synch Orbit'' - Régler le [[Système de Coordonnées]] sur ''geographic''. 

'''''[[Time]]''''' 
Régler la date et l'heure en utilisant les formats ''JulianDay'' ou ''UTC''. 

'''''[[Timerate]]''''' 
Régler la vitesse d'écoulement du temps. 

'''''[[Track]]''''' 
Fixer la caméra sur l'objet sélectionné pour le garder centré sur l'écran. 

'''''[[Unmark]]''''' 
Désactiver le marquage d'un objet. 

'''''[[Unmarkall]]''''' 
Désactiver le marquage de tous les objets. 

'''''[[Wait]]''''' 
Insérer une pause dans l'exécution du script (du nombre de secondes spécifiées). 
 

==Quelques exemples de scripts décortiqués==
Après la théorie, la pratique... Les quelques scripts qui suivent exposent des exemples concrets qui permettront de se faire une idée plus précise du sujet. Si vous êtes vous-même auteur d'un script pour [[Celestia]], n'hésitez pas à en faire profiter les lecteurs de ce wiki.
 
*[[Script : Spoutnik1|Spoutnik 1]]. Commandes utilisées : ''time'', ''select'', ''goto''.
*[[Script : Start|Start]]. Commandes utilisées : ''preloadtext'', ''select'', ''follow'', ''goto'', ''wait'', ''print''.

Renderflags

2006-01-02T11:28:42Z

Vincent :

'''{ renderflags {set "automag"} renderflags {set "atmospheres"} renderflags {set "cloudmaps"} renderflags {set "comettails"} renderflags {set "eclipseshadows"} renderflags {set "galaxies"} renderflags {set "nightmaps"} renderflags {set "planets"} renderflags {set "pointstars"} renderflags {set "ringshadows"} renderflags {set "stars"} renderflags {clear "partialtrajectories"} renderflags {clear "constellations"} renderflags {clear "boundaries"} renderflags {clear "grid"} renderflags {clear "markers"} renderflags {clear "orbits"} }''' 
permet d'activer (set) ou désactiver (clear) les options de rendu de tous les éléments spécifiés. 
Ici, permet d'activer :
- la magnitude automatique
- l'affichage de l'atmosphère
- l'affichage des nuages
- l'affichage des queues des comètes
- l'affichage des ombres des éclipses
- l'affichage des galaxies
- l'affichage des textures de nuit
- l'affichage des planètes
- l'affichage des étoiles sous forme de points
- l'affichage des ombres des anneaux 
et de désactiver :
- l'affichage des trajectoires partielles
- l'affichage des constellations
- l'affichage des limites des constellations
- l'affichage de la grille celeste
- l'affichage des marqueurs
- l'affichage des orbites (de façon globale). 

''retour à la page [[Script]]''

Renderflags

2006-01-01T18:20:35Z

Vincent :

'''{ renderflags {set "automag"} renderflags {set "atmospheres"} renderflags {set "cloudmaps"} renderflags {set "comettails"} renderflags {set "eclipseshadows"} renderflags {set "galaxies"} renderflags {set "nightmaps"} renderflags {set "planets"} renderflags {set "pointstars"} renderflags {set "ringshadows"} renderflags {set "stars"} renderflags {clear "partialtrajectories"} renderflags {clear "constellations"} renderflags {clear "boundaries"} renderflags {clear "grid"} renderflags {clear "markers"} renderflags {clear "orbits"} }''' 
permet d'activer (set) ou désactiver (clear) les options de rendu de tous les éléments spécifiés : 
Ici, permet d'activer :
- la magnitude automatique
- l'affichage de l'atmosphère
- l'affichage des nuages
- l'affichage des queues des comètes
- l'affichage des ombres des éclipses
- l'affichage des galaxies
- l'affichage des textures de nuit
- l'affichage des planètes
- l'affichage des étoiles sous forme de points
- l'affichage des ombres des anneaux 
et de désactiver :
- l'affichage des trajectoires partielles
- l'affichage des constellations
- l'affichage des limites des constellations
- l'affichage de la grille celeste
- l'affichage des marqueurs
- l'affichage des orbites (de façon globale). 

''retour à la page [[Script]]''

Discussion:Gotolonglat

2006-01-01T18:15:57Z

Vincent :

Merci Jdou pour ton aide concernant le tuto des scripts !

J'ai simplement modifié la mise en page pour qu'elle soit en accord avec le début du tuto.

@+

Vincent

Discussion:Gotolonglat

2006-01-01T18:15:36Z

Vincent :

Merci Jdou pour ton aide concernant le tuto des scripts !
J'ai simplement modifié la mise en page pour qu'elle soit en accord avec le début du tuto.

@+

Vincent

Discussion:Gotolonglat

2006-01-01T18:15:22Z

Vincent :

Merci Jdou pour ton aide concernant le tuto des scripts !
J'ai simplement modifié la mise en page pour qu'elle soit en accord avec le début du tuto.

@+
Vincent

Gotolonglat

2006-01-01T18:14:00Z

Vincent :

'''{ print { duration 3 text "Rendons-nous au-dessus de Paris." } wait { duration 3 } select { object "Sol/Earth" } gotolonglat { time 3 distance 1.3 longitude 2 latitude 48 } wait { duration 3 } }''' 
permet de déplacer la caméra et de la positionner à une longitude de 2° et une latitude de 48° sur l'objet sélectionné 'Terre' à une distance (depuis le centre de la Terre) de 1,3 fois le rayon de la Terre, en effectuant un mouvement de caméra d'une durée de 3 secondes. 
rem : La commande ''wait'' (3ème ligne) est indispensable après une commande ''gotolonglat''. 

Pour la Terre, la longitude est référencée par rapport au méridien de Greenwich et va de 0 à +/- 180°. La latitude est référencée par rapport à l'équateur et va de 0 à +/- 90°. 
Les coordonnées géographiques d'un lieu sont parfois données sous la forme "47.62 N, 122.35 O" (Ex: Seattle). Les lettres correspondent à N= Nord, S= Sud, E= Est, O ou W= Ouest (West en anglais) 
Si la lettre associée est S ou O ou W il faut mettre un moins devant la valeur donnée.
Exemple : Pour aller au dessus de Seattle :
'''gotolonglat { time 3 distance 2 longitude -122.35 latitude 47.62 }'''
Astuce : Pour trouver les coordonnées d'un lieu, vous pouvez chercher celui-ci dans les fichiers donnant les noms des lieux tels que ceux que l'on trouve [http://www.celestiamotherlode.net/catalog/earthother.php ici] 

''retour à la page [[Script]]''

Gotolonglat

2006-01-01T18:13:26Z

Vincent :

Gotolonglat

2006-01-01T18:12:39Z

Vincent :

'''{ print { duration 3 text "Rendons-nous au-dessus de Paris." } wait { duration 3 } select { object "Sol/Earth" } gotolonglat { time 3 distance 1.3 longitude 2 latitude 48 } wait { duration 3 } }''' 
permet de déplacer la caméra et de la positionner à une longitude de 2° et une latitude de 48° sur l'objet sélectionné 'Terre' à une distance (depuis le centre de la Terre) de 1,3 fois le rayon de la Terre, en effectuant un mouvement de caméra d'une durée de 3 secondes. 
rem : La commande ''wait'' (3ème ligne) est indispensable après une commande ''gotolonglat''. 

Pour la Terre, la longitude est référencée par rapport au méridien de Greenwich et va de 0 à +/- 180°. La latitude est référencée par rapport à l'équateur et va de 0 à +/- 90°. 
Les coordonnées géographiques d'un lieu sont parfois données sous la forme "47.62 N, 122.35 O" (Ex: Seattle)
Les lettres correspondent à N= Nord, S= Sud, E= Est, O ou W= Ouest (West en anglais) 
Si la lettre associée est S ou O ou W il faut mettre un moins devant la valeur donnée.
Exemple : Pour aller au dessus de Seattle :
'''gotolonglat { time 3 distance 2 longitude -122.35 latitude 47.62 }'''
Astuce : Pour trouver les coordonnées d'un lieu, vous pouvez chercher celui-ci dans les fichiers donnant les noms des lieux
tels que ceux que l'on trouve [http://www.celestiamotherlode.net/catalog/earthother.php ici 

''retour à la page [[Script]]''

Renderflags

2006-01-01T18:10:49Z

Vincent :

''' { renderflags {set "automag"} renderflags {set "atmospheres"} renderflags {set "cloudmaps"} renderflags {set "comettails"} renderflags {set "eclipseshadows"} renderflags {set "galaxies"} renderflags {set "nightmaps"} renderflags {set "planets"} renderflags {set "pointstars"} renderflags {set "ringshadows"} renderflags {set "stars"} renderflags {clear "partialtrajectories"} renderflags {clear "constellations"} renderflags {clear "boundaries"} renderflags {clear "grid"} renderflags {clear "markers"} renderflags {clear "orbits"} }''' 
permet d'activer (set) ou désactiver (clear) les options de rendu de tous les éléments spécifiés : 
Ici, permet d'activer :
- la magnitude automatique
- l'affichage de l'atmosphère
- l'affichage des nuages
- l'affichage des queues des comètes
- l'affichage des ombres des éclipses
- l'affichage des galaxies
- l'affichage des textures de nuit
- l'affichage des planètes
- l'affichage des étoiles sous forme de points
- l'affichage des ombres des anneaux 
et de désactiver :
- l'affichage des trajectoires partielles
- l'affichage des constellations
- l'affichage des limites des constellations
- l'affichage de la grille celeste
- l'affichage des marqueurs
- l'affichage des orbites (de façon globale). 

''retour à la page [[Script]]''

Script

2005-12-20T20:51:35Z

Vincent : /* Quelles sont les principales commandes .cel ? */

== 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 qui permettent 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. 
Il est donc possible de "programmer" Celestia pour visualiser de nombreux objets célestes (sous toutes les coutures), tout en affichant simultanément des commentaires, ce qui fait de celestia un outil pédagogique de premier ordre. A ce titre, un "script" Celestia peut être considéré comme un véritable "scénario".

== 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 [http://www.lua.org 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 .[[cel]] ? ==

'''''[[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 distance entre la caméra et l'objet sélectionné. 

'''''[[Chase]]''''' 
Régler le [[Système de Coordonnées]] sur ''chase''. 

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

'''''[[Goto]]''''' 
Déplacer la caméra et la positionner face à l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotoloc]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de position et d'orientation de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotolonglat]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de longitude et de latitude de l'objet sélectionné. 

'''''[[Labels]]''''' 
Activer ou désactiver l'affichage des noms pour les différentes classes d'objets. 

'''''[[Lock]]''''' 
Verrouiller 2 objets par rapport à la position de la caméra - Régler le [[Système de Coordonnées]] sur ''lock''. 

'''''[[Lookback]]''''' 
Changer instantanément (sans mouvement de caméra) le champ de la caméra de 180°. 

'''''[[Mark]]''''' 
Activer le marquage d'un objet avec le symbole spécifié. 

'''''[[Move]]''''' 
Déplacer la caméra à la vitesse spécifiée. 

'''''[[Orbit]]''''' 
Se déplacer en orbite autour de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Orbitflags]]''''' 
Activer / désactiver l'affichage des orbites pour les différentes classes d'objets. 

'''''[[Preloadtex]]''''' 
Pré-charger en mémoire une [[Texture|texture]] avant son affichage à l'écran. 

'''''[[Print]]''''' 
Afficher un message à l'écran sous forme de texte. 

'''''[[Renderflags]]''''' 
Activer / désactiver l'affichage des différentes classes d'objets. 

'''''[[Rotate]]''''' 
Effectuer une rotation du champs de la caméra. 

'''''[[Select]]''''' 
Selectionner un objet (planète, satellite, galaxie, etc...). 

'''''[[Set]]''''' 
Régler les valeurs de ''Min Orbit Size'', ''Ambient Light Level'', ''Field Of View'', ''Star Distance Limit'', ''Star Style''. 

'''''[[Setfaintestautomag45deg]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est activée. 

'''''[[Setframe]]''''' 
Choisir le [[Système de Coordonnées]] à utiliser. 

'''''[[Setorientation]]''''' 
Régler l'orientation de la caméra. 

'''''[[Setposition]]''''' 
Régler la position de la caméra dans l'espace. 

'''''[[Setsurface]]''''' 
Choisir une texture alternative pour l'objet sélectionné. 

'''''[[Setvisibilitylimit]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est désactivée. 

'''''[[Seturl]]''''' 
Placer la caméra à la position définie par une fonction ''Cell://URL''. 

'''''[[Synchronus]]''''' 
Se placer en orbite autour de l'objet sélectionné en mode ''Synch Orbit'' - Régler le [[Système de Coordonnées]] sur ''geographic''. 

'''''[[Time]]''''' 
Régler la date et l'heure en utilisant les formats ''JulianDay'' ou ''UTC''. 

'''''[[Timerate]]''''' 
Régler la vitesse d'écoulement du temps. 

'''''[[Track]]''''' 
Fixer la caméra sur l'objet sélectionné pour le garder centré sur l'écran. 

'''''[[Unmark]]''''' 
Désactiver le marquage d'un objet. 

'''''[[Unmarkall]]''''' 
Désactiver le marquage de tous les objets. 

'''''[[Wait]]''''' 
Insérer une pause dans l'exécution du script (du nombre de secondes spécifiées).

Script

2005-12-20T17:49:50Z

Vincent : /* Quelles sont les principales commandes .cel ? */

== 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 qui permettent 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. 
Il est donc possible de "programmer" Celestia pour visualiser de nombreux objets célestes (sous toutes les coutures), tout en affichant simultanément des commentaires, ce qui fait de celestia un outil pédagogique de premier ordre. A ce titre, un "script" Celestia peut être considéré comme un véritable "scénario".

== 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 [http://www.lua.org 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 .[[cel]] ? ==

'''''[[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 distance entre la caméra et l'objet sélectionné. 

'''''[[Chase]]''''' 
Régler le [[Système de Coordonnées]] sur ''chase''. 

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

'''''[[Goto]]''''' 
Déplacer la caméra et la positionner face à l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotoloc]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de position et d'orientation de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Gotolonglat]]''''' 
Déplacer la caméra et la positionner aux valeurs spécifiées de longitude et de latitude de l'objet sélectionné. 

'''''[[Labels]]''''' 
Activer ou désactiver l'affichage des noms des éléments des différentes classes d'objets. 

'''''[[Lock]]''''' 
Verrouiller 2 objets par rapport à la position de la caméra - Régler le [[Système de Coordonnées]] sur ''lock''. 

'''''[[Lookback]]''''' 
Changer instantanément (sans mouvement de caméra) le champ de la caméra de 180°. 

'''''[[Mark]]''''' 
Activer le marquage d'un objet avec le symbole spécifié. 

'''''[[Move]]''''' 
Déplacer la caméra à la vitesse spécifiée. 

'''''[[Orbit]]''''' 
Se déplacer en orbite autour de l'objet sélectionné sans changer le [[Système de Coordonnées]]. 

'''''[[Orbitflags]]''''' 
Activer / désactiver l'affichage des orbites des éléments des différentes classes d'objets. 

'''''[[Preloadtex]]''''' 
Pré-charger en mémoire une [[Texture|texture]] avant son affichage à l'écran. 

'''''[[Print]]''''' 
Afficher un message à l'écran sous forme de texte. 

'''''[[Renderflags]]''''' 
Activer / désactiver l'affichage des différentes classes d'objets. 

'''''[[Rotate]]''''' 
Effectuer une rotation du champs de la caméra. 

'''''[[Select]]''''' 
Selectionner un objet (planète, satellite, galaxie, etc...). 

'''''[[Set]]''''' 
Régler les valeurs de ''Min Orbit Size'', ''Ambient Light Level'', ''Field Of View'', ''Star Distance Limit'', ''Star Style''. 

'''''[[Setfaintestautomag45deg]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est activée. 

'''''[[Setframe]]''''' 
Choisir le [[Système de Coordonnées]] à utiliser. 

'''''[[Setorientation]]''''' 
Régler l'orientation de la caméra. 

'''''[[Setposition]]''''' 
Régler la position de la caméra dans l'espace. 

'''''[[Setsurface]]''''' 
Choisir une texture alternative pour l'objet sélectionné. 

'''''[[Setvisibilitylimit]]''''' 
Régler la magnitude minimale des étoiles à afficher lorsque l'option ''Auto-Magnitude'' est désactivée. 

'''''[[Seturl]]''''' 
Placer la caméra à la position définie par une fonction ''Cell://URL''. 

'''''[[Synchronus]]''''' 
Se placer en orbite autour de l'objet sélectionné en mode ''Synch Orbit'' - Régler le [[Système de Coordonnées]] sur ''geographic''. 

'''''[[Time]]''''' 
Régler la date et l'heure en utilisant les formats ''JulianDay'' ou ''UTC''. 

'''''[[Timerate]]''''' 
Régler la vitesse d'écoulement du temps. 

'''''[[Track]]''''' 
Fixer la caméra sur l'objet sélectionné pour le garder centré sur l'écran. 

'''''[[Unmark]]''''' 
Désactiver le marquage d'un objet. 

'''''[[Unmarkall]]''''' 
Désactiver le marquage de tous les objets. 

'''''[[Wait]]''''' 
Insérer une pause dans l'exécution du script (du nombre de secondes spécifiées).

Mark

2005-12-20T12:07:04Z

Vincent :

'''{ renderflags { set "markers" } mark { object "Sol/Earth" symbol "x" size 25 color [1 0 0] } }''' 
permet d'activer le marquage de l'objet 'Terre' avec le symbole ''''x'''' de taille 25 et de couleur rouge. 
rem 1: Les symboles pouvant être utilisés sont '''"diamond"''' (par défaut), '''"plus"''', '''"square"''', '''"triangle"''', et '''"x"'''. 
rem 2: Les couleurs sont définies suivant le mode [Rouge Vert Bleu], soit par exemple :
- noir : '''[0 0 0]'''
- rouge : '''[1 0 0]''' (couleur par défaut)
- vert : '''[0 1 0]'''
- bleu : '''[0 0 1]'''
- jaune : '''[1 1 0]'''
- blanc : '''[1 1 1]'''
- gris : '''[0.5 0.5 0.5]'''
- etc... 

''retour à la page [[Script]]''

Mark

2005-12-19T23:18:10Z

Vincent :

'''{ mark { object "Sol/Earth" symbol "x" size 25 color [1 0 0] } }''' 
permet d'activer le marquage de l'objet 'Terre' avec le symbole ''''x'''' de taille 25 et de couleur rouge. 
rem 1: Les symboles pouvant être utilisés sont '''"diamond"''' (par défaut), '''"plus"''', '''"square"''', '''"triangle"''', et '''"x"'''. 
rem 2: Les couleurs sont définies suivant le mode [Rouge Vert Bleu], soit par exemple :
- noir : '''[0 0 0]'''
- rouge : '''[1 0 0]''' (couleur par défaut)
- vert : '''[0 1 0]'''
- bleu : '''[0 0 1]'''
- jaune : '''[1 1 0]'''
- blanc : '''[1 1 1]''' 

''retour à la page [[Script]]''

Mark

2005-12-19T23:18:00Z

Vincent :

Mark

2005-12-19T23:16:37Z

Vincent :

'''{ mark { object "Sol/Earth" symbol "x" size 25 color [1 0 0] } }''' 
permet d'activer le marquage de l'objet 'Terre' avec le symbole ''''x'''' de taille 25 et de couleur rouge. 
rem 1: Les symboles pouvant être utilisés sont '''"diamond"''' (par défaut), '''"plus"''', '''"square"''', '''"triangle"''', et '''"x"'''. 
rem 2: Les couleurs sont définies suivant le mode [Rouge Vert Bleu], soit :
- noir : '''[0 0 0]'''
- rouge : '''[1 0 0]''' (couleur par défaut)
- vert : '''[0 1 0]'''
- bleu : '''[0 0 1]'''
- jaune : '''[1 1 0]'''
- blanc : '''[1 1 1]''' 

''retour à la page [[Script]]''

Mark

2005-12-19T23:15:50Z

Vincent :

'''{ mark { object "Sol/Earth" symbol "x" size 25 color [1 0 0] } }''' 
permet d'activer le marquage de l'objet 'Terre' avec le symbole ''''x'''' de taille 25 et de couleur rouge. 
rem 1: Les symboles pouvant être utilisés sont '''"diamond"''' (par défaut), '''"plus"''', '''"square"''', '''"triangle"''', et '''"x"'''. 
rem 2: Les couleurs sont définies suivant le mode [Rouge Vert Bleu], soit : 
- noir : '''[0 0 0]'''
- rouge : '''[1 0 0]''' (couleur par défaut)
- vert : '''[0 1 0]'''
- bleu : '''[0 0 1]'''
- jaune : '''[1 1 0]'''
- blanc : '''[1 1 1]''' 

''retour à la page [[Script]]''