News:
GAIA DR3 | 2024/02/25 10:59 |
Cartes du Ciel is free software released under the terms of the
GNU General Public License
News:
GAIA DR3 | 2024/02/25 10:59 |
Cartes du Ciel is free software released under the terms of the
GNU General Public License
This is an old revision of the document!
SkyChart can work as a server. It accepts the following commands from a TCP/IP connection:
You can use any socket library or object to connect to Skychart from your software, or use the commands telnet or netcat from a script.
To send a command, write to the socket the command, any parameter separated by a blank space, and finally a CR-LF termination.
For examples with various languages, see https://github.com/pchev/skychart/tree/master/skychart/sample_client
The standard port is 3292, this can be changed by the user in the configuration menu. The program can also choose to listen to another random port if the configured port is busy.
Skychart maintains a file with information about the port and it's status.
In Linux and Mac: [User settings]/tmp/tcpport
In Windows: Registry key HKCU\Software\Astro_PC\Ciel\Status\TcpPort
The file (or key) do not exist if Skychart was never run.
It contains 0 if the program is not running, or the server is disabled in the configuration menu.
It contains the listen port if the program is ready to accept a connection.
Command | Parameters | Comment or GUI Equivalent |
---|---|---|
NEWCHART | chart_name | File → New Chart |
CLOSECHART | chart_name | File → Close Chart |
SELECTCHART | chart_name | Window → chart_name |
LISTCHART | Window | |
SEARCH | object_name | Search tool (Main Bar) |
GETMSGBOX | Returns the status bar content | |
GETCOORBOX | Returns the coordinates shown in the status bar | |
GETINFOBOX | Setup → Display → Labels - Display the chart information in the menu bar | |
FIND | object_class object_name | Same as search, but lets you specify the class of object you want: 0=nebula, 1=na, 2=star, 3=star, 4=variable, 5=double, 6=comet, 7=asteroid, 8=planet, 9=constellation, 10=line catalog |
SAVE | saved_file_name | Save the current chart to the specified file |
LOAD | saved_file_name | Load the chart from the file |
LOADDEFAULT | option_file_name | Use this command to load an extract of the configuration file that temporarily replace some option from skychart.ini. |
SETCAT | path shortname active min max | Add or change a Catgen catalog. The fields are the same as in the catalog setup. |
SHUTDOWN | Close the program | |
RESET | Reload the default chart and options (same as signal HUP) | |
PLANETINFO | page_number | Open the Solar system information window at the given page |
GETSELECTEDOBJECT | Return information about the last selected object | |
LOADMPCORB | file_name | Load the specified file with asteroid element in MPCORB format. Detail result is available in file [user_data]/database/LoadAsteroidFile.log |
? | No GUI equivalent, list of available commands |
Command | Parameters | Comment or GUI Equivalent |
---|---|---|
MOVE | obsolete RA: 00h00m00.00s DEC:+00d00m00.0s FOV:+00d00m00s | Icon |
DATE | obsolete, same as SETDATE | |
OBSL | obsolete, same as SETOBS | |
RFSH | obsolete, same as REDRAW | |
PDSS | Same as the menu Chart-Get DSS Image | |
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+ | icon (Main Bar) | |
STA- | icon (Main Bar) | |
NEB+ | icon (Main Bar) | |
NEB- | icon (Main Bar) | |
GREQ | obsolete, use SETEQGRID | |
GRAZ | obsolete, use SETGRID | |
GRNM | obsolete, use SETGRIDNUM | |
CONL | obsolete, use SETCONSTLINE | |
CONB | obsolete, use SETCONSTBOUNDARY | |
EQAZ | obsolete, use SETPROJ |