Rapid-Q Documentation by William Yu (c)1999 | Appendix A: QBITMAP

# QBITMAP Component

  QBitmap is a non-visible component, used to store/retrieve BMP images.
  QBitmap Properties

  Field | Type | R/W | Default | Support

  BMP | STRING | RW |  | W
  | Use BMP to assign a new bitmap file, or to store BMP in the image cache. Examples:

  > DIM Bitmap AS QBITMAP
  > Bitmap.BMP = "whatever.bmp"

  BMPHandle | RESOURCE | W |  | W
  CopyMode | INTEGER | RW | cmBlackness | W
  Empty | INTEGER | R |  | W
  Font | QFONT | W |  | W
  Handle | INTEGER | RW |  | W
  Height | INTEGER | RW |  | WG
  Monochrome | INTEGER | RW |  | W
  Pixel | 2D ARRAY of INTEGER | RW |  | WG
  PixelFormat | INTEGER | RW | pfDevice | W
  Top | INTEGER | RW |  | WG
  Transparent | INTEGER | RW | False | W
  TransparentColor | INTEGER | RW |  | W
  TransparentMode | INTEGER | RW | 0 | W
  Width | INTEGER | RW |  | WG

  QBitmap Methods

  Method | Type | Description | Params | Support

  Circle | SUB (x1%, y1%, x2%, y2%, c%, fill%) | Draw & Fill Circle | 6 | WG
  CopyRect | SUB (D, Image, S) | D and S are QRECTs, Image can be a QImage, QCanvas, or QBitmap | 3 | W
  | Example (copies QIMAGE to bitmap at 10,10):

  > DIM Destination AS QRECT
  > DIM Source AS QRECT
  > DIM Image AS QIMAGE
  > DIM Bitmap AS QBITMAP
  > Image.BMP = "whatever.bmp"
  > WITH Destination
  > .Top = 10
  > .Left = 10
  > .Right = .Left+Image.Width
  > .Bottom = .Top+Image.Height
  > END WITH
  > WITH Source
  > .Top = 0
  > .Left = 0
  > .Right = Image.Width
  > .Bottom = Image.Height
  > END WITH
  > Bitmap.CopyRect(Destination, Image, Source)

  Draw | SUB (x%, y%, BMP) | Draw Bitmap on Canvas | 3 | WG
  FillRect | SUB (x1%, y1%, x2%, y2%, c%) | Draws & Fills a rectangle | 5 | WG
  Line | SUB (x1%, y1%, x2%, y2%, c%) | Draws a line | 5 | WG
  LoadFromFile | SUB (FileName$) | Load BMP from a file | 1 | W
  LoadFromStream | SUB (Stream) | Load BMP from a stream | 1 | W
  Paint | SUB (x%, y%, c%, borderc%) | Fill Region | 4 | WG
  Pset | SUB (x%, y%, c%) | Pixel plot | 3 | WG
  Rectangle | SUB (x1%, y1%, x2%, y2%, c%) | Draws a rectangle | 5 | WG
  Rotate | SUB (xOrigin%, yOrigin%, Angle%) | Rotates entire bitmap at specified origin | 3 | W
  RoundRect | SUB (x1%, y1%, x2%, y2%, x3%, y3%, c%) | Draws & Fills a rounded rectangle | 7 | W
  SaveToFile | SUB (FileName$) | Save BMP to a file | 1 | W
  SaveToStream | SUB (Stream) | Save BMP to a stream | 1 | W
  StretchDraw | SUB (Rect AS QRECT, BMP) | Draw BMP and stretch to fit inside Rect | 2 | W
  TextHeight | FUNCTION (Text$) AS WORD | Returns the height, in pixels, of Text$ string | 1 | W
  TextWidth | FUNCTION (Text$) AS WORD | Returns the width, in pixels, of Text$ string | 1 | W
  TextRect | SUB (Rect AS QRECT, x%, y%, S$, fc%, bc%) | Write text, and clip within region Rect | 6 | W
  TextOut | SUB (x%, y%, S$, fc%, bc%) | Writes text to image | 5 | WG

  QBitmap Examples

      DIM BitMap AS QBitMap

      BitMap.BMP = "close.bmp"

      CREATE Form AS QForm
        CREATE Image1 AS QImage
          Left = 100
          Draw 5, 5, BitMap.BMP
        END CREATE
        Center
        ShowModal
      END CREATE

  Prev Component | Contents | Next Component