mirror of
https://github.com/QB64-Phoenix-Edition/QB64pe.git
synced 2024-06-29 10:30:36 +00:00
52 lines
2.1 KiB
Plaintext
52 lines
2.1 KiB
Plaintext
{{DISPLAYTITLE:_SCREENIMAGE}}
|
|
The [[_SCREENIMAGE]] function stores the current desktop image or a portion of it and returns an image handle.
|
|
|
|
|
|
{{PageSyntax}}
|
|
: {{Parameter|imageHandle&}} = [[_SCREENIMAGE]]({{Parameter|column1}}, {{Parameter|row1}}, {{Parameter|column2}}, {{Parameter|row2}})]
|
|
|
|
|
|
{{PageDescription}}
|
|
* {{Parameter|imageHandle&}} is the handle to the new image in memory that will contain the desktop screenshot.
|
|
* The optional screen {{Parameter|column}} and {{Parameter|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 obtained with [[_DESKTOPWIDTH]] and [[_DESKTOPHEIGHT]].
|
|
* Can be used to take screenshots 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]]
|
|
|
|
|
|
{{PageExamples}}
|
|
''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}}
|
|
|
|
|
|
===Sample code to save images to disk===
|
|
*[[SAVEIMAGE]]
|
|
*[[Program ScreenShots]] (member-contributed program for legacy screen modes)
|
|
* [[ThirtyTwoBit SUB]]
|
|
* [[SaveIcon32]]
|
|
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[_SCREENCLICK]], [[_SCREENPRINT]]
|
|
* [[_SCREENMOVE]], [[_SCREENX]], [[_SCREENY]]
|
|
* [[_WIDTH (function)|_WIDTH]], [[_HEIGHT]]
|
|
* [[_DESKTOPWIDTH]], [[_DESKTOPHEIGHT]]
|
|
* [[_FULLSCREEN]], [[_PRINTIMAGE]]
|
|
* [[Screen Saver Programs]]
|
|
* [[Bitmaps]], [[Icons and Cursors]]
|
|
* [[Hardware images]]
|
|
|
|
|
|
{{PageNavigation}}
|
|
<
|