[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
        PRD_DUMPRPORTTAGS -- dump the specified rastport to a printer (v44)

   FUNCTION
        Print a rendition of the supplied rastport, using the supplied
        colormap, position and scaling information, as specified in
        the printer preferences.

   IO REQUEST
        io_Message      mn_ReplyPort set if quick I/O is not possible.
        io_Command      prd_dumprport.
        io_Flags        IOB_QUICK set if quick I/O is possible.
        io_RastPort     ptr to a rastport.
        io_ColorMap     ptr to a colormap.
        io_Modes        the 'modes' flag from a viewport structure,
                        (the upper word is reserved and should be zero).

                        If you are running under version 36, or greater
                        of graphics.library, it is recommended that
                        you fill in "io_Modes" with the ULONG (32-bit)
                        value returned from calling:

                        ULONG ModeID = GetVPModeID(struct viewport *);

                        Doing so provides for upwards compatability with
                        the new display modes available under V36
                        (example: aspect ratio calculations for new
                        display modes).

        io_SrcX         x offset into the rastport to start printing from.
        io_SrcY         y offset into the rastport to start printing from.
        io_SrcWidth     width of the rastport to print (from io_srcx).
        io_SrcHeight    height of the rastport to print (from io_srcy).
        io_DestCols     width of the printout in printer pixels.
        io_DestRows     height of the printout in printer pixels.
        io_Special      flag bits
        io_TagList      a list of tags to specify more parameters for the
                        dump.

   TAGS
        DRPA_SourceHook a pointer to struct hook which is called to read
                        the source data. io_RastPort and io_ColorMap are
                        ignored and should be NULL.

                        The hook is called with object == NULL and message
                        is a pointer to struct drpsourcemsg. it must read
                        an array of source data.

                        Each pixel of the array is an ULONG of form
                        0x00RRGGBB.

                        Some printer drivers have set PPCB_NOSTRIPE which
                        means they cannot print in stripes. Using
                        DRPA_SourceHook is the best way for printing for such
                        printers because you can still prepare the printer
                        source data in stripes then.

                        The Source hook is always called in the context of
                        the printer driver DOS process.

        DRPA_AspectX    the X aspect ratio.
        DRPA_AspectY    the Y aspect ratio. This values overwrites the
                        aspect ratio from gfxbase or io_modes and is used
                        for scaling.