From QB64 Wiki
Revision as of 08:23, 8 July 2010 by imported>Clippy
Jump to navigation Jump to search

The _NEWIMAGE Function prepares a window image surface and returns the handle value.


handle& = _NEWIMAGE& (width AS LONG, height AS LONG[, BPPmode AS LONG])


  • Minimum screen dimensions are Width& >= 0, Height& >= 1 measured in pixels.
  • BPPmode& is either a QB type screenmode(0 to 2 or 7 to 13) or 256 colors or 32 bit(high color) compatible.
  • If BPPmode is omitted, an image will be created in the same BPP mode as the current destination image.
  • Valid LONG handle returns are less than -1. Invalid handles equal -1.
  • You can create any sized window(limited by OS) using this function.
  • It is IMPORTANT to free unused or uneeded images with _FREEIMAGE to prevent CPU memory overflow errors!


1) Shrinking a SCREEN 0 text window's size:


2) Creating an 800 by 600 window version of SCREEN 12 with 256 colors (text 36 X 100):

handle& = _NEWIMAGE(800, 600, 256) SCREEN handle&

See also

Keyword Reference - Alphabetical
Keyword Reference - By Usage
Main Wiki Page