mirror of
https://github.com/QB64Official/qb64.git
synced 2024-07-05 19:20:25 +00:00
54 lines
2.1 KiB
Plaintext
54 lines
2.1 KiB
Plaintext
{{DISPLAYTITLE:_SCREENIMAGE}}
|
|
The {{KW|_SCREENIMAGE}} function stores the current desktop image or a portion of it and returns a handle value to reference.
|
|
|
|
|
|
{{PageSyntax}}
|
|
:: handle& = [[_SCREENIMAGE[]](''column1'', ''row1'', ''column2'', ''row2'')]
|
|
|
|
|
|
{{PageDescription}}
|
|
* The handle& value is the desktop image reference in memory of the present user's desktop.
|
|
* The optional screen ''column'' and ''row'' positions can be used to get only a portion of the desktop image.
|
|
* The desktop image or partial image is always a 32-bit image.
|
|
* The current screen resolution or width-to-height aspect ratio can be measured using the handle with [[_WIDTH (function)|_WIDTH]] and [[_HEIGHT]].
|
|
* Can be used to take screen shots of the desktop or used with [[_PRINTIMAGE]] to print them.
|
|
* It is IMPORTANT to free unused or uneeded image handles with [[_FREEIMAGE]] to prevent memory overflow errors!
|
|
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Keyword Not Supported in Linux or MAC versions]]
|
|
|
|
|
|
''Example:'' Determining the present screen resolution of user's PC for a screensaver program.
|
|
{{CodeStart}}
|
|
desktop& = {{Cl|_SCREENIMAGE}}
|
|
MaxScreenX& = {{Cl|_WIDTH (function)|_WIDTH}}(desktop&)
|
|
MaxScreenY& = {{Cl|_HEIGHT}}(desktop&)
|
|
{{Cl|_FREEIMAGE}} desktop& 'free image after measuring screen(it is not displayed)
|
|
{{Cl|SCREEN (statement)|SCREEN}} {{Cl|_NEWIMAGE}}(MaxScreenX&, MaxScreenY&, 256) 'program window is sized to fit '' ''
|
|
{{Cl|_SCREENMOVE}} _MIDDLE
|
|
{{CodeEnd}}
|
|
|
|
|
|
|
|
''Screen image savers:''
|
|
|
|
*{{KW|SAVEIMAGE}} (QB64 Image to Bitmap SUB by Galleon)
|
|
|
|
*{{KW|Program ScreenShots}} (Member program for legacy screen modes)
|
|
|
|
* {{KW|ThirtyTwoBit SUB}} (QB64 Image area to bitmap)
|
|
|
|
* [[SaveIcon32]] {{text|(converts any image to icon)}}
|
|
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[_SCREENCLICK]], [[_SCREENPRINT]]
|
|
* [[_SCREENMOVE]], [[_SCREENX]], [[_SCREENY]]
|
|
* [[_WIDTH (function)|_WIDTH]], [[_HEIGHT]]
|
|
* [[_FULLSCREEN]], [[_PRINTIMAGE]]
|
|
* [[SAVEIMAGE]] {{text|(save image to bitmap program)}}
|
|
* [[Screen Saver Programs]]
|
|
* [[Bitmaps]], [[Icons and Cursors]]
|
|
* [[Hardware images]]
|
|
|
|
|
|
{{PageNavigation}} |