B. Commandes de Script

commande nom de l'argument Valeur de l'argument note
audio action pause play sync  
  file name

(nom de fichier)

AUDIO_FILENAME Utilisé avec l'action "play" Le format dépend du système résident. Ogg Vorbis est recommandé. Le format WAV devrait fonctionner mais il n'est pas recommandé parce que dans ce cas, la piste audio ne sera pas en phase si le script est envoyé rapidement. [c'est une limitation actuelle du prog. SDL_Mixer.]
  loop

(boucle)

on off Utilisé avec l'action «play». «Off» par défaut.
  output_rate

(échantillonnage de sortie)

SAMPLES_PER_SECOND Par exemple: 44100 pour une qualité audio CD.
  volume decrement increment VOLUME_LEVEL VOLUME_LEVEL (le niveau du volume) est entre 0 et 1, inclus.
clear state natural Arrête l'affichage de la brume, des étiquettes, dessins linéaires et artistiques. Met en service le rendu des planètes, étoiles et nébuleuse. Désélectionne tous les objets sélectionnés. Revient à la direction d'observation d'origine et au champ de vision (FOV) d'origine. . Si l'état est naturel, le sol et l'atmosphère seront affichés, dans le cas contraire, l'affichage sera arrêté.
configuration action load reload Seule la fonction "reload" rechargement est possible à partir d'un script. recharge les réglages par défaut.
date local [[-]YYYY-MM-DD]Thh:mm:ss Ajuste le temps à la date et/ou au temps spécifié en utilisant le fuseau horaire courant. «T» est positif.
  utc [-]YYYY-MM-DDThh:mm:ss Ajuste le temps à une date et une heure en temps UTC. «T» est positif.
  relative DAYS Change la date et le temps par Jours (peut être une valeur fractionnaire).
  load current Ajuste la date à la date courante.
deselect     Désélectionne l'objet actuellement sélectionné, sélection de constellation incluse. voir la commande «select»
flag

drapeaux

atmosphere
azimuthal_grid
bright_nebulae
cardinal_points
constellation_art
constellation_drawing
constellation_names
constellation_pick
ecliptic_line
enable_move_keys
enable_tui_menu
enable_zoom_keys
equator_line
equatorial_grid
fog
gravity_labels
help
infos
moon_scaled
landscape
manual_zoom
menu
meridian_line
milky_way
nebulae
nebula_names
object_trails
planets
planet_names
planet_orbits
point_star
show_appname
show_date
show_fov
show_fps
show_gravity_ui
show_selected_object_info
show_time
show_topbar
show_tui_datetime
show_tui_short_obj_info
star_names
star_twinkle
stars
track_object
utc_time
on 1 off 0 toggle (inversion) Ajuste les drapeaux de rendu. Un nom d'argument par commande est couramment autorisé. "track_objet" n'est utile que lorsqu'un objet est sélectionné.Les drapeaux suivants sont des clés ajustées par l'utilisateur et ne sont pas accessible par des commandes de script: enable_move_keys, enable_move_mouse, enable_tui_menu,

enable_zoom_keys,

gravity_labels,

help horizon,

infos menu,

show_appname,

show_date,

show_fov,

show_fps,

show_gravity_ui,

show_time,

show_topbar,

utc_time

image action load drop Effacer les images lorsqu'elle ne sont plus nécessaires pour améliorer les performances.
  altitude ALTITUDE_ANGLE Pour positionner le centre de l'image dans des coordonnées horizontales. Zéro est sur l'horizon, 90 est au zénith.
  azimuth AZIMUTH_ANGLE Pour positionner le centre de l'image en coordonnées horizontales. Zéro; est le Nord, 90 est l'Est.
  coordinate_system viewport horizontal Quel système de coordonnées doit être utilisé pour positionner l'image. Doit être définit au moment de charger une image. Ne peut être changé plus tard. viewport est la valeur par défaut.
  duration SECONDS Combien de temps faut il prendre pour terminer la commande.
  filename IMAGE_FILENAME le chemin (arborescence) doit être relatif au script.
  filename IMAGE_FILENAME le chemin (arborescence) doit être relatif au script.
  name IMAGE_NAME Utilisé pour se référer à l'image pour des appels ultérieurs pour manipuler l'image. Si les images n'ont pas des dimensions qui sont des puissances de 2 (128,256, etc.). Elles sont redimensionnées au moment du chargement pour être conforme à cette demande.
  alpha ALPHA 0 is transparent (default), 1 si opaque. ALPHA peut être fractionnaire. Les images sont dessinées dans l'ordre où elles sont chargées.
  scale SCALE De quelle grandeur faut-il dessiner l'image. En coordonnées "viewport" (surface de vision de l'écran)avec une valeur de 1, l'image est mise à l'échelle de telle sorte à maximiser la surface de vision. En coordonnées horizontale, ce paramètre définit la largeur angulaire maximum de l'image en degré.
  rotation DEGREES Rotation absolue. Une valeur positive indique une rotation horaire.
  xpos X_POSITION Où dessiner le centre de l'image. 0 est le centre de la surface de vision, 1 est le bord droit de la surface de vision.
  ypos Y_POSITION Où dessiner le centre de l'image. 0 est le centre de la surface de vision (viewport), 1 est le bord supérieur de la surface de vision (viewport).
landscape     Charger un paysage. les arguments ont les même noms et valeurs possibles que dans le fichier landscapes.ini, à l'exception du fait que le nom du fichier de texture doit être spécifié en entier incluant également le chemin relatif au script. L'argument «action load» doit aussi être ajouter.
meteors zhr ZENITH_HOURLY_RATE  
moveto lat LATITUDE Valeurs de latitude Sud sont négatives.
  lon LONGITUDE Valeurs de longitude Ouest sont négatives.
  alt ALTITUDE En Mètres
  duration SECONDS Durée de la temporisation pour effectuer ce changement.
script action play end pause resume Note: fonction bipolaire: «Pause», «Playback». Si un script démarre un autre script, le premier sera stoppé.
  filename SCRIPT_FILENAME  
select     Si aucun argument n'est fourni, désélectionne l'objet courant. (laisse seulement la sélection Constellation). Voir la commande «Deselect»
  constellation CONSTELLATION_SHORT_NAME Abréviation de trois caractères pour «constellationship.fab», cas non sensible.
  hp HP_NUMBER  
  nebula NEBULA_NAME Nom comme défini dans fichier «messier.fab»
  planet PLANET_NAME Nom comme défini dans «system.ini»
  pointer on 1 off 0 Doit-on dessiner le pointeur de surlignage autour de l'objet sélectionné. la valeur par défaut est «on»
set atmosphere_fade_duration SECONDS  
  auto_move_duration SECONDS Utilisé pour auto-zoom
  constellation_art_fade_duration SECONDS  
  constellation_art_intensity   0-1
  landscape_name   Depuis «landscapes.ini»
  max_mag_nebula_name   Nommer uniquement les nébuleuses plus brillantes que cette valeur
  moon_scale   le paramètre «1» indique une représentation à la taille réelle.
  sky_culture   Nom du répertoire origine «skycultures.fab».
  sky_locale   Code de 3 lettres. eng, fra, etc...
  star_mag_scale    
  star_scale    
  star_twinkle_amount   la valeur 0 = pas de scintillement
  time_zone   Le fuseau horaire dépend du système résident
timerate rate SECONDS_PER_SECOND Ajuste la vitesse de simulation du temps.
wait duration SECONDS Seulement utile dans un script. «SECONDS» peuvent être fractionnaires.
zoom auto in initial out «initial» repositionne le système à l'angle de vision (fov) et à la direction d'observation initiaux.
  fov FIELD_OF_VIEW en degrés
  delta_fov DELTA_DEGREES  
  duration SECONDS n'est pas utilisé avec le delta_fov

Matthew Gates 2006-03-23