/*  karma_xc.h

    Header for  xc_  package.

    Copyright (C) 1993-2003  Richard Gooch

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the Free
    Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

    Richard Gooch may be reached by email at  karma-request@atnf.csiro.au
    The postal address is:
      Richard Gooch, c/o ATNF, P. O. Box 76, Epping, N.S.W., 2121, Australia.
*/

/*

    This include file contains all the definitions and function declarations
  needed to interface to the xc_ routines in the Karma library.


    Written by      Richard Gooch   25-FEB-1993

    Last updated by Richard Gooch   21-APR-2003

*/

#if !defined(KARMA_H) || defined(MAKEDEPEND)
#  include <karma.h>
#endif
#include <X11/Xlib.h>

#ifndef KARMA_XC_H
#define KARMA_XC_H


#ifndef KDISPLAY_DEFINED
#  define KDISPLAY_DEFINED
typedef struct kdisplay_handle_type * Kdisplay;
#endif


/*  File:  xc.c  */
EXTERN_FUNCTION (Kdisplay xc_get_dpy_handle, (Display *display,
					      Colormap cmap) );
EXTERN_FUNCTION (unsigned int xc_alloc_colours, (unsigned int num_cells,
						 unsigned long *pixel_values,
						 unsigned int min_cells,
						 Kdisplay dpy_handle) );
EXTERN_FUNCTION (void xc_free_colours, (unsigned int num_cells,
					unsigned long *pixel_values,
					Kdisplay dpy_handle) );
EXTERN_FUNCTION (void xc_store_colours, (unsigned int num_cells,
					 CONST unsigned long *pixel_values,
					 unsigned short *reds,
					 unsigned short *greens,
					 unsigned short *blues,
					 unsigned int stride,
					 Kdisplay dpy_handle) );
EXTERN_FUNCTION (void xc_get_location, (Kdisplay dpy_handle,
					unsigned long *serv_hostaddr,
					unsigned long *serv_display_num) );
EXTERN_FUNCTION (void xc_get_location2,
		 (Kdisplay dpy_handle, unsigned long *serv_hostaddr,
		  unsigned long *serv_display_num, unsigned long *cmap_id) );
EXTERN_FUNCTION (Colormap xc_get_cmap, (Kdisplay dpy_handle) );
EXTERN_FUNCTION (void xc_free_handle, (Kdisplay dpy_handle) );


#endif /*  KARMA_XC_H  */
