NAME

       FunImageRowPut - put row(s) of an image

SYNOPSIS

         #include <funtools.h>

         void *FunImageRowPut(Fun fun, void *buf, int rstart, int rstop,
                              int dim1, int dim2, int bitpix, char *plist)

DESCRIPTION

       The  FunImageRowPut()  routine writes one or more image rows to the specified FITS image file.  The first
       argument is the Funtools handle returned by FunOpen().  The second buf argument is a pointer to  the  row
       data  buffer,  while the third and fourth arguments specify the starting and ending rows to write.  Valid
       rows values range from 1 to dim2, i.e., row is one-valued.

       The dim1and dim2 arguments that follow specify the dimensions, where dim1 corresponds to naxis1 and  dim2
       corresponds  to  naxis2.   The  bitpix  argument  data type of the image and can have the following FITS-
       standard values:

       •   8 unsigned char

       •   16 short

       •   32 int

       •   -32 float

       •   -64 double

       For example:

         double *drow;
         Fun fun, fun2;
         ... open files ...
         /* get section dimensions */
         FunInfoGet(fun, FUN_SECT_DIM1, &dim1, FUN_SECT_DIM2, &dim2, 0);
         /* allocate one line's worth */
         drow = malloc(dim1*sizeof(double));
         /* retrieve and process each input row (starting at 1) */
         for(i=1; i <= dim2; i++){
           if( !FunImageRowGet(fun, drow, i, i, "bitpix=-64") )
             gerror(stderr, "can't FunImageRowGet: %d %s\n", i, iname);
           ... process drow ...
           if( !FunImageRowPut(fun2, drow, i, i, 64, NULL) )
             gerror(stderr, "can't FunImageRowPut: %d %s\n", i, oname);
         }
         ...

       The data are assumed to be in the native machine format and will automatically be swapped  to  big-endian
       FITS  format if necessary.  This behavior can be over-ridden with the convert=[true⎪false] keyword in the
       plist param list string.

       When you are finished writing the image, you should call FunFlush() to write out the FITS image  padding.
       However,  this  is  not  necessary if you subsequently call FunClose() without doing any other I/O to the
       FITS file.

SEE ALSO

       See funtools(7) for a list of Funtools help pages

version 1.4.5                                    April 14, 2011                                funimagerowput(3)