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)