Difference between revisions of "NEWIMAGE"

From QB64 Wiki
Jump to navigation Jump to search
imported>Clippy
m
imported>Clippy
m
Line 16: Line 16:
  
 
{{PageExamples}}
 
{{PageExamples}}
1) Shrinking a SCREEN 0 text window's size:
+
''Example 1:'' Shrinking a SCREEN 0 text window's size:
 +
 
 
{{CodeStart}}
 
{{CodeStart}}
  
Line 23: Line 24:
 
{{CodeEnd}}
 
{{CodeEnd}}
  
 
+
''Example 2:'' Creating an 800 by 600 window version of SCREEN 12 with 256 colors (text 36 X 100):
2) Creating an 800 by 600 window version of SCREEN 12 with 256 colors (text 36 X 100):
 
 
{{CodeStart}}
 
{{CodeStart}}
  
Line 32: Line 32:
 
{{CodeEnd}}
 
{{CodeEnd}}
  
 +
''Example 3:'' Setting a SCREEN with _NEWIMAGE and page flipping in QB64.
 +
 +
{{CodeStart}}
 +
 +
SCREEN _NEWIMAGE(640, 480, 256), , 1, 0
 +
 +
{{CodeEnd}}
 +
 +
: ''Note:'' [[_DISPLAY]] may be used as a substitute for page flipping or [[PCOPY]].
  
  

Revision as of 02:44, 10 July 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

  • 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!


Examples

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

SCREEN _NEWIMAGE(28, 25, 0)

Example 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&

Example 3: Setting a SCREEN with _NEWIMAGE and page flipping in QB64.

SCREEN _NEWIMAGE(640, 480, 256), , 1, 0

Note: _DISPLAY may be used as a substitute for page flipping or PCOPY.


See also



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