Difference between revisions of "NEWIMAGE"

From QB64 Wiki
Jump to navigation Jump to search
imported>Clippy
m
imported>Clippy
m
Line 8: Line 8:
 
{{PageDescription}}
 
{{PageDescription}}
 
* Width& >= 0, Height& >= 1 measured in pixels.  
 
* Width& >= 0, Height& >= 1 measured in pixels.  
* Mode& is either a QB type screenmode(0 to 2 or 7 to 13) or 256 or 32 bit compatible.
+
* Mode& is either a QB type screenmode(0 to 2 or 7 to 13) or 256 colors or 32 bit compatible.
 
* If BPPmode is omitted, an image will be created in the same BPP mode as the current destination image.
 
* If BPPmode is omitted, an image will be created in the same BPP mode as the current destination image.
 
* Valid {{KW|LONG}} handle returns are less than -1. Invalid handles equal -1.
 
* Valid {{KW|LONG}} handle returns are less than -1. Invalid handles equal -1.

Revision as of 19:43, 20 February 2010

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


Syntax

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


Description

  • Width& >= 0, Height& >= 1 measured in pixels.
  • Mode& is either a QB type screenmode(0 to 2 or 7 to 13) or 256 colors or 32 bit 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.


Examples

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

SCREEN _NEWIMAGE(28, 25, 0)


2) Creating a 800 by 600 window version of SCREEN 12 with 256 colors:

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



See also




Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page