# Commandes du serveur

CdC, en temps que serveur, accepte les commandes suivantes par la connexion TCP/IP

## Connexion

Vous pouvez utiliser n'importe quelle libraire ou objet fournissant un socket pour vous connecter depuis votre logiciel, ou utiliser les commandes telnet ou netcat depuis un script.
Pour envoyer une commande, écrivez sur le socket la commande, tout paramètre séparé par un espace, et enfin une terminaison CR-LF.
Pour des exemples dans divers langages voir: https://github.com/pchev/skychart/tree/master/skychart/sample_client

Le port par défaut est 3292 mais il peut être modifier par l'utilisateur dans le menu de configuration. Le programme peut aussi choisir un autre port si celui-ci est occupé.

Cartes du Ciel maintient un fichier avec le port de connexion et son état.
Avec Linux et Mac : [Configuration utilisateur /tmp/tcpport
Avec Windows : Clé de registre HKCU\Software\Astro_PC\Ciel\Status\TcpPort

Le fichier (ou clé) n'existe pas si Cartes du Ciel n'a jamais été lancé.
Il contient 0 si le programme n'est pas démarrer ou si le serveur est désactivé dans la configuration.
Il contient le numéro du port si le programme est prêt à accepter une connexion.

## Commandes principales

Commande | Paramètres | Commentaires ou équivalent Interface Utilisateur
--- | --- | ---
NEWCHART | nom_carte | Fichier > Nouvelle Carte
CLOSECHART | nom_carte | Fichier > Fermer la Carte
SELECTCHART | nom_carte | Fenêtre > nom_carte
LISTCHART |  | Fenêtre
SEARCH | nom_objet | Outil Recherche (Barre principale)
GETMSGBOX |  | Retourne le contenu de la barre d'état
GETCOORBOX |  | Retourne les coordonnées affichées dans la barre d'état
GETINFOBOX |  | Configuration > Configuration du programme > Affichage > Labels - Information sur la carte
FIND | classe_objet nom_objet | Même chose que search mais permet d'indiquer la classe de l'objet: 0=nébuleuse, 1=na, 2=étoile, 3=étoile, 4=variable, 5=double, 6=comète, 7=astéroïde, 8=planète, 9=constellation, 10=catalogue de ligne
SAVE | nom_fichier | Enregistre la carte courante dans le fichier spécifié
LOAD | nom_fichier | Charge la carte à partir du fichier
LOADDEFAULT | nom_fichier | Utilisez cette option pour charger un extrait du fichier de configuration skychart.ini
SETCAT | path shortname active min max | Ajoute ou modifie un catalogue Catgen. Les champs sont les mêmes que dans la configuration des catalogues
SHUTDOWN |  | Quitte le programme
RESET |  | Recharge la carte et les options par défaut (même chose que signal HUP)
PLANETINFO | numéro_de_la_page | Ouvre la fenêtre d'Informations du système solaire à la page donnée
GETSELECTEDOBJECT |  | Renvoie des informations sur le dernier objet sélectionné
LOADMPCORB | nom_fichier | Charge le fichier d'éléments d’astéroïde au format MPCORB. Le résultat détaillé est disponible dans le fichier [Configuration utilisateur] /​database/LoadAsteroidFile.log
? |  | Liste des commandes disponibles

## Commandes de Carte

Commande | Paramètres | Commentaires ou équivalent Interface Utilisateur
--- | --- | ---
ZOOM+ |  | Voir > Zoom avant
ZOOM- |  | Voir > Zoom arrière
MOVEEAST |  | Clavier flèche gauche
MOVEWEST |  | Clavier flèche droite
MOVENORTH |  | Clavier flèche haut
MOVESOUTH |  | Clavier flèche bas
MOVENORTHEAST |  | Pavé numérique 7 (Sans verrou numérique)
MOVENORTHWEST |  | Pavé numérique 9 (Sans verrou numérique)
MOVESOUTHEAST |  | Pavé numérique 1 (Sans verrou numérique)
MOVESOUTHWEST |  | Pavé numérique 3 (Sans verrou numérique)
FLIPX |  | Carte > Tranformation > Miroir Horizontal
FLIPY |  | Carte > Tranformation > Miroir Vertical
SETCURSOR | pixX pixY |
CENTRECURSOR |  | Clic droit > Centrer
ZOOM+MOVE |  | Clic droit > Centrer et Zoom +
ZOOM-MOVE |  | Clic droit > Centrer et Zoom -
ROT+ |  | Carte > Tranformation > Rotation à droite
ROT- |  | Carte > Tranformation > Rotation à gauche
SETEQGRID | ON/OFF | Carte > Lignes/Grilles Ajouter la grille équatoriale
SETGRID | ON/OFF | Carte > Lignes/Grilles Voir les grilles de coordonnées
SETSTARMODE | 0/1/2 | Configuration > Mode d'affichage > Affichage des étoiles
SETNEBMODE | 0/1 | Configuration > Mode d'affichage > 1Affichage des nébuleuses
SETAUTOSKY | ON/OFF | Configuration > Configuration du programme > Affichage > Voir la couleur du ciel
UNDO |  | Edition > Défaire
REDO |  | Edition > Refaire
SETPROJ | ALTAZ/EQUAT/GALACTIC/ECLIPTIC | Carte > Système de coordonnées
SETFOV | 00d00m00s or 00.00 | Icône (champ de vision) ou Icône (Barre principale)
SETRA | RA:00h00m00s ou 00.00 | Icône (Coordonnées AD)
SETDEC | DEC:+00d00m00s ou 00.00 | Icône (Coordonnées DEC)
SETOBS | LAT:+00d00m00sLON:+000d00m00s ALT:000mOBS:name | Configuration > Observatoire Attention que la longitude doit être négative vers l'Est. Dans de nombreux cas, vous devez changer le signe de longitude.
IDCURSOR |  |
SAVEIMG | PNG/JPEG/BMP Fichiername quality | Fichier > Enregistrer l'image…
PRINT | PRT/PS/BMP PORTRAIT/LANDSCAPE COLOR/BW filepath | Imprime ou exporte en Postscript ou Bitmap, Fichier → Imprimer et Fichier→ Options imprimante
SETNORTH |  | Carte > Voir l'horizon > Nord
SETSOUTH |  | Carte > Voir l'horizon > Sud
SETEAST |  | Carte > Voir l'horizon > Est
SETWEST |  | Carte > Voir l'horizon > Ouest
SETZENITH |  | Icône (Barre de droite)
ALLSKY |  | Icône (Barre de droite)
REDRAW |  | Suit toute commande modifiant la carte, nécessaire à sa mise à jour
GETCURSOR |  |
GETEQGRID |  |
GETGRID |  |
GETSTARMODE |  |
GETNEBMODE |  |
GETAUTOSKY |  |
GETPROJ |  |
GETFOV | S/F |
GETRA | S/F |
GETDEC | S/F |
GETDATE |  |
GETOBS | LAT:+00d00m00sLON:+000d00m00s ALT:000mOBS:name | Attention que la longitude est négative vers l'Est. Dans de nombreux cas, vous devez changer le signe de longitude.
SETDATE | yyyy-mm-ddThh:mm:ss or “yyyy-mm-dd hh:mm:ss” | Configuration > Date/Heure
SETTZ | Etc/GMT | Configuration > Observatoire (Zone horaire du pays)
GETTZ |  |
SETGRIDNUM | ON/OFF | Configuration > Configuration du programme > Affichage > Lignes - Voir les labels de grille
SETCONSTLINE | ON/OFF | Configuration > Configuration du programme > Affichage > Lignes - Figure des constellations
SETCONSTBOUNDARY | ON/OFF | Configuration > Configuration du programme > Affichage > Lignes - Limites des Constellations
RESIZE | largeur hauteur | Dimensionne la carte
GETRISESET |  | Heure de lever/transit/coucher pour l'objet sélectionné
MOVESCOPE | RA Dec [00.00] | Déplace le curseur du télescope aux coordonnée. RA en heures décimale.
MOVESCOPEH | HourAngle Dec [00.00] | Comme MOVESCOPE mais avec l'angle horaire plutôt que l’ascension droite. Angle horaire en heures décimale
IDCENTER |  | Identifie l'objet au centre de la carte
IDSCOPE |  | Identifie l'objet à la position du télescope
SHOWPICTURE | ON/OFF | Carte → Voir les objets → Voir les images
SHOWBGIMAGE | ON/OFF | Affiche l'image d'arrière plan
LOADBGIMAGE | fits_filename | Charge une nouvelle image FITS, force la mise a jour de l'image si le nom est le même.
LOADCIRCLE | nom_fichier | Charge une liste de marqueur, comme clic droit - Cercle du chercheur - Charge depuis un fichier
SETCIRCLE | num diametre rotation offset | Défini un cercle du chercheur, comme Configuration - Affichage - Cercle du chercheur
SETRECTANGLE | num largeur hauteur rotation offset | Défini un rectangle du chercheur, comme Configuration - Affichage - Rectangle du chercheur
SHOWCIRCLE | num_list | Liste séparée par des virgules de cercle a afficher 1,2,…,10
SHOWRECTANGLE | num_list | Liste séparée par des virgules de rectangle a afficher 1,2,…,10
MARKCENTER | ON/OFF | Marque le centre de la carte avec un cercle, comme Voir les marques
GETSCOPERADEC |  | Retourne les coordonnées du télescope.
TRACKTELESCOPE | ON/OFF | Comme le menu Télescope / Suit le télescope.
CONNECTINDI |  | Connecte le télescope INDI configuré.
DISCONNECTINDI |  | Déconnecte le télescope INDI.
SLEWINDI | RAhr Dec [décimal] | Déplace le télescope INDI aux coordonnées spécifiées.
ABORTSLEWINDI |  | Abandon de la commande de déplacement en cours.
SYNCINDI | RAhr Dec [décimal] | Sync du télescope INDI aux coordonnées spécifiées.
CONNECTTELESCOPE |  | Connecte le télescope par défaut.
DISCONNECTTELESCOPE |  | Déconnecte le télescope par défaut.
SLEW | RAhr Dec [in decimal] | Déplace le télescope par défaut aux coordonnées spécifiées.
ABORTSLEW |  | Abandon de la commande de déplacement en cours.
SYNC | RAhr Dec [in decimal] | Sync du télescope par défaut aux coordonnées spécifiées.
OBSLISTLOAD | list_file_name |
OBSLISTFIRST |  |
OBSLISTLAST |  |
OBSLISTNEXT |  |
OBSLISTPREV |  |
OBSLISTLIMIT | ON/OFF |
OBSLISTAIRMASSLIMIT | [airmass] |
OBSLISTTRANSITLIMIT | [hours] |
OBSLISTTRANSITSIDE | EAST/WEST/BOTH |
GETSCOPERATES |  | Retourne une liste des vitesses supportée par le télescope
SCOPEMOVEAXIS | axe(0/1) vitesse | Déplace le télescope le long de (axe) à la (vitesse)
SETSCOPEREFRESHRATE | delay [ms] | Rafraîchir la position du télescope chaque (delay) [ms]
PLANISPHEREDATE | ON/OFF | Afficher ou masquer l'échelle de date de la planisphère
PLANISPHERETIME | ON/OFF | Afficher ou masquer l'échelle d'heure de la planisphère
SETFOVPROJECTION | fov_number HAI/MER/CAR/ARC/TAN/SIN | Définir la projection pour le champ fov_number
SHOWONLYMERIDIAN | ON/OFF | Afficher uniquement le méridien au lieu de la grille complète
SHOWALWAYSMERIDIAN | ON/OFF | Afficher le méridien pour toutes les projections
CLEANUPMAP |  | Supprime toute les sélections et redessine la carte
GETCHARTEQSYS |  | Retourne le système équatorial courant, Date or J2000, B1950, …

## Compatibilité avec V2.7 - commandes DDE

Commande | Paramètres | Commentaires ou équivalent Interface Utilisateur
--- | --- | ---
MOVE | obsolete RA: 00h00m00.00s DEC:+00d00m00.0s FOV:+00d00m00s | Icône
DATE | obsolete same as SETDATE |
OBSL | obsolete same as SETOBS |
RFSH | obsolete same as REDRAW |
PDSS |  | Même chose que le menu Carte - Voir les images DSS
SBMP | obsolete use SAVEIMG |
SGIF | obsolete use SAVEIMG |
SJPG | obsolete use SAVEIMG |
IDXY | X:pixelx Y:pixely |
GOXY | X:pixelx Y:pixely |
ZOM+ | obsolete same as ZOOM+ |
ZOM- | obsolete same as ZOOM- |
STA+ |  | Icône (Barre principale)
STA- |  | Icône (Barre principale)
NEB+ |  | Icône (Barre principale)
NEB- |  | Icône (Barre principale)
GREQ | obsolete use SETEQGRID |
GRAZ | obsolete use SETGRID |
GRNM | obsolete use SETGRIDNUM |
CONL | obsolete use SETCONSTLINE |
CONB | obsolete use SETCONSTBOUNDARY |
EQAZ | obsolete use SETPROJ |

## Information sur l'objet sélectionné

Les informations suivantes sont retournée quand un objet est sélectionné sur la carte, que ce soit par un clic de souris ou le résultat d'une recherche. Chaque champ est séparé par le caractère <tab>.

    > Chart_1 : 23h21m39.85s +61°19'04.8" Nb  NGC 7635 m:11.00 Dim: 15.0 x  8.0 ' class:  Identifier:C11,LBN 548

- > indique le début d'un message.
- Chart_1 : le nom de la carte où l'objet est sélectionné.
- 23h21m39.85s AD de l'objet utilisant l'équinoxe de la carte.
- +61°19'04.8“ Dec de l'objet utilisant l'équinoxe de la carte.
- Nb le type d'objet.
- NGC 7635 le nom de l'objet

Viennent ensuite plusieurs champs dont le contenu dépend du type d'objet et du catalogue utilisé.

Si la sélection provient d'un clic de souris il y a également ces informations donnant la distance au dernier objet sélectionné:

    > Chart_1 : From: "Sh 2-150" to "NGC 7635 " Separation: +06°48'05.6" PA:119° Offset:  0h49m46.4s -03°53'47"