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-Filev_getbitmap_info()                                                      VDI

Syntax

VOID v_getbitmap_info( handle, ch, advx, advy, xoff, yoff, width, height,
bitmap)
WORD handle, ch;
fix31 *advx, *advy, *xoff, *yoff;
WORD *width, *height;
VOID *bitmap;

Function      v_getbitmap_info() returns placement information for the
              bitmap of a character based on the current character font,
              size, and alignment.

Opcode        239

Availability  Available only with SpeedoGDOS.

Parameters    handle specifies a valid workstation handle. ch is the
              character to return information about. The fix31 variables
              pointed to by advx, advy, xoff, and yoff will be filled in
              with the x and y advance and offset vectors respectively.
              The WORDs pointed to by width and height will be filled in
              with the width and height of the bitmap pointed to by the
              value returned in bitmap.

Binding       contrl[0] = 239;
              contrl[1] = 0;
              contrl[3] = 1;
              contrl[6] = handle;

              intin[0] = ch;

              vdi();

              *width = intout[0];
              *height = intout[1];
              *advx = *(fix31 *)&intout[2];
              *advy = *(fix31 *)&intout[4];
              *xoff = *(fix31 *)&intout[6];
              *yoff = *(fix31 *)&intout[8];
              *bitmap = *(void *)&intout[10];

Comments      The advance vector represents the amount to add to the
              current point to properly place the character. The offset
              vector, when added to the current point, give the location
              of the upper-left corner of the bitmap.

Group         VDI SpeedoGDOS