- ←Prev
- AST
A Library for Handling
World Coordinate Systems
in Astronomy - Next→
- TOC ↑
Description:
This
function returns the current value of a character-valued AST global tuning parameter, optionally
storing a new value for the parameter. For integer-valued tuning parameters, see
AST_TUNE.
Invocation
CALL AST_TUNEC( NAME, VALUE, BUFF, STATUS )
Arguments
NAME = CHARACTER
(
)
(Given)
The name of the tuning parameter (case-insensitive).
VALUE = CHARACTER
( ) (Given)
The
new value for the tuning parameter. If this is AST__TUNULLC, the existing current value will be retained.
BUFF
= CHARACTER
( ) (Given)
A character string in which to return the original value of the tuning parameter. An error
will be reported if the buffer is too small to hold the value.
STATUS = INTEGER (Given and
Returned)
The global status.
Notes:
-
This routine attempts to execute even if STATUS is set to an error value on entry, although no further
error report will be made if it subsequently fails under these circumstances.
-
All threads in a process share the same AST tuning parameters values.
Tuning Parameters :
HRDel
A string to be drawn following the hours field in a formatted sky axis value when "
g"
format is in
use (see the Format attribute). This string may include escape sequences to produce super-scripts, etc.
(see the Escapes attribute for details of the escape sequences allowed). The default value is "
%-%50%s70h%"
which produces a super-script "
h"
.
MNDel
A string to be drawn following the minutes
field in a formatted sky axis value when "
g"
format is in use. The default value is "
%-%50%s70m%"
which produces a super-script "
m"
.
SCDel
A string to be drawn following the seconds
field in a formatted sky axis value when "
g"
format is in use. The default value is "
%-%50%s70s%"
which produces a super-script "
s"
.
DGDel
A string to be drawn following the degrees
field in a formatted sky axis value when "
g"
format is in use. The default value is "
%-%53%s60o%"
which produces a super-script "
o"
.
AMDel
A string to be drawn following the arc-minutes
field in a formatted sky axis value when "
g"
format is in use. The default value is "
%-%20%s85’
%"
which produces a super-script "
’
"
(single quote).
ASDel
A string to be drawn following the
arc-seconds field in a formatted sky axis value when "
g"
format is in use. The default value is "
%-%20%s85"
%"
which produces a super-script "
"
"
(double quote).
EXDel
A string to be drawn to
introduce the exponent in a value when "
g"
format is in use. The default value is "
10%-%50%s70"
which produces "
10"
followed by the exponent as a super-script.
Copyright (C) 2017 East Asian Observatory
- ←Prev
- AST
A Library for Handling
World Coordinate
Systems
in Astronomy - Next→
- TOC ↑