Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileScrdmp()
Setprt()
Prtblk()                                                              XBIOS

Syntax

WORD Prtblk( blk )
PRTBLK *blk;

Function      Prtblk() accesses the built-in bitmap/text printing code.

Opcode        36 (0x24)

Availability  All TOS versions.

Parameters    blk is a PRTBLK pointer containing information about the
              bitmap or text to print. PRTBLK is defined as follows:

              typedef struct
              {
               VOIDP blkptr;  /* pointer to screen scanline */
               UWORD offset;  /* bit offset of first column */
               UWORD width;  /* width of bitmap in bits */
               UWORD height;  /* height of bitmap in scanlines */
               UWORD left;  /* left print margin (in pixels) */
               UWORD right;  /* right print margin (in pixels) */
               UWORD srcres;  /* same as Getrez() */
               UWORD destres;  /* 0 = draft, 1 = final */
               UWORD *colpal;  /* color palette pointer */
               /*
                * 0 = B/W Atari
                * 1 = Color Atari
                * 2 = Daisy Wheel
                * 3 = B/W Epson
                */
               UWORD type;
               /* 0 = parallel, 1 = serial */
               UWORD port;
               /* halftone mask pointer or NULL to use default */
               char *masks;
              } PRTBLK;

Binding       pea      blk
              move.w   #$24,-(sp)
              trap     #14
              addq.l   #6,sp

Caveats       This call is extremely device dependent. v_bit_image() with
              GDOS installed should be used instead. Only ST compatible
              screen resolution bitmaps may be printed with this utility
              function.

Comments      When printing text, blkptr should point to the text string,
              width should be the length of the text string, height should
              be 0, and masks should be NULL. In graphic print mode, masks
              can be NULL to use the default halftone masks. The system
              variable _prt_cnt (WORD *)0x4EE should be set to 1 to
              disable the alt-help key before calling this function. It
              should be restored to a value of -1 when done.

See Also      Scrdmp(), Setprt()