Provided by: plplot-doc_5.15.0+dfsg2-9build1.1_all bug

NAME

       plimagefr - Plot a 2D matrix using cmap1

SYNOPSIS

       plimagefr(idata, nx, ny, xmin, xmax, ymin, ymax, zmin, zmax, valuemin, valuemax, pltr, pltr_data)

DESCRIPTION

       Plot a 2D matrix using cmap1.

       Redacted  form:  General:  plimagefr(idata, xmin, xmax, ymin, ymax, zmin, zmax, valuemin, valuemax, pltr,
       pltr_data)

       This function is used in example 20.

ARGUMENTS

       idata (PLFLT_MATRIX(3plplot), input)
              A matrix of values (intensities) to plot.  Should have dimensions of nx by ny.

       nx, ny (PLINT(3plplot), input)
              Dimensions of idata

       xmin, xmax, ymin, ymax (PLFLT(3plplot), input)
              See the discussion of pltr below for how these arguments are used (only for the special case  when
              the callback function pltr is not supplied).

       zmin, zmax (PLFLT(3plplot), input)
              Only data between zmin and zmax (inclusive) will be plotted.

       valuemin, valuemax (PLFLT(3plplot), input)
              The  minimum and maximum data values to use for value to color mappings.  A datum equal to or less
              than valuemin will be plotted with color 0.0, while a datum equal to or greater than valuemax will
              be plotted with color 1.0.  Data between valuemin and valuemax map linearly to colors in the range
              (0.0-1.0).

       pltr (PLTRANSFORM_callback(3plplot), input)
              A callback function that defines the transformation between the zero-based indices of  the  matrix
              idata  and  world  coordinates. If pltr is not supplied (e.g., is set to NULL in the C case), then
              the x indices of idata are mapped to the range xmin through xmax and the y indices  of  idata  are
              mapped to the range ymin through ymax.For the C case, transformation functions are provided in the
              PLplot library: pltr0(3plplot) for the identity mapping, and pltr1(3plplot) and pltr2(3plplot) for
              arbitrary mappings respectively defined by vectors and matrices.  In addition, C callback routines
              for  the  transformation  can  be  supplied  by  the  user  such  as  the   mypltr   function   in
              examples/c/x09c.c  which  provides  a  general linear transformation between index coordinates and
              world coordinates.For languages other than C you should consult the PLplot documentation  for  the
              details  concerning  how  PLTRANSFORM_callback(3plplot)  arguments  are  interfaced.  However,  in
              general, a particular pattern of  callback-associated  arguments  such  as  a  tr  vector  with  6
              elements;  xg  and  yg  vectors;  or  xg  and yg matrices are respectively interfaced to a linear-
              transformation routine similar to the above mypltr function; pltr1(3plplot);  and  pltr2(3plplot).
              Furthermore, some of our more sophisticated bindings (see, e.g., the PLplot documentation) support
              native language callbacks for handling index to  world-coordinate  transformations.   Examples  of
              these   various   approaches   are   given  in  examples/<language>x09*,  examples/<language>x16*,
              examples/<language>x20*,  examples/<language>x21*,  and  examples/<language>x22*,  for   all   our
              supported languages.

       pltr_data (PLPointer(3plplot), input)
              Extra  parameter  to  help  pass information to pltr0(3plplot), pltr1(3plplot), pltr2(3plplot), or
              whatever routine is externally supplied.

AUTHORS

       Many developers (who are credited at http://plplot.org/credits.php) have contributed to PLplot  over  its
       long history.

SEE ALSO

       PLplot documentation at http://plplot.org/documentation.php.

                                                  October, 2024                               PLIMAGEFR(3plplot)