WCS_ASTRO_TRANSFORM3(3)

EXPERIMENTAL_FUNC
wcs_astro_transform3 - Transform between linear and projected co-ordinates.

SYNOPSIS
#include <karma_wcs.h>

flag wcs_astro_transform3

(KwcsAstro ap, flag thread, unsigned int num_coords, CONST char *name0, double *coords0, flag to_lin0, CONST char *name1, double *coords1, flag to_lin1, CONST char *name2, double *coords2, flag to_lin2, unsigned int num_restr, CONST char **restr_names, CONST double *restr_values)

DESCRIPTION
This routine will convert up to three arrays of co-ordinates using an astronomical projection system. The co-ordinate arrays are named. If a co-ordinate array is not defined the co-ordinates are unchanged.

ap  The KwcsAstro object.

thread
    If TRUE, the operation may be threaded, else it will not be.

num_coords
    The number of co-ordinates to transform.

name0
    The name of co-ordinate array 0.

coords0
    Co-ordinate array 0.

to_lin0
    If TRUE the co-ordinate 0 values are transformed to linear co-ordinates, else they are transformed to non-linear co-ordinates.

name1
    The name of co-ordinate array 1.

coords1
    Co-ordinate array 1.

to_lin1
    If TRUE the co-ordinate 1 values are transformed to linear co-ordinates, else they are transformed to non-linear co-ordinates.

name2
    The name of co-ordinate array 2.

coords2
    Co-ordinate array 2.

to_lin2
    If TRUE the co-ordinate 2 values are transformed to linear co-ordinates, else they are transformed to non-linear co-ordinates.

num_restr
    The number of restrictions.

restr_names
    The array of restriction names.

restr_values
    The restriction values.

RETURN VALUE
TRUE on success, else FALSE. If nothing is to be transformed, TRUE is returned.

Multi-threading Level
Unsafe.

AUTHOR
Richard Gooch (rgooch@atnf.csiro.au)

AVAILABLITY
The Karma Distribution is available for anonymous ftp from: ftp://ftp.atnf.csiro.au/pub/software/karma/ ftp://wuarchive.wustl.edu/graphics/graphics/packages/karma/ ftp://ftp.pwr.wroc.pl/pub/karma/ The Karma Home Page is: http://www.atnf.csiro.au/karma/