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.
For example is various language see http://skychart.svn.sourceforge.net/viewvc/skychart/trunk/skychart/sample_client/
The standard port is 3292 but this can be changed by the user in the configuration menu. The program can also choice to listen to another random port if the configured port is busy.
Skychart maintain a file with to let you know the connection 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 contain 0 if the program is not started, or the server is disabled in the configuration menu.
It contain 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) | |
? | 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 |