rxImgSize version 0.1

==Description==
rxImgSize is a rexx dll that can capture the screen and save it to a file.
This is a Rexx Screen Capture demostration with the source code. It is a function in a rexx dll that can capture the screen and save it to a file. Released under the BSD clause.

===Example===
For those of you that would like to get a hint...

Unpack the .zip-file somewhere, e.g. C:\Desktop\rxImgSize

Open a program or folder that contain the title text "rxImgSize"  (e.g. Folder or Archive manager with .zip-file open) and another window that contain the text "Editor"  (e.g. Text Editor).

Start a command prompt and run the script "rxtestimgsze"
 C:\DESKTOP\rxImgSize                                     Show current directory
 C:\DESKTOP\rxImgSize                                     Show current directory
 [C:\DESKTOP\rxImgSize]MKDIR IMAGES           Create a subfolder named IMAGES
 >rxImgSize: version 1.02, GBM: version 1.12<  Show version information about the library itself and GBM
 >1.02<                                        Show only information about the library itself
 >1.12<                                        Show only information about the GBM library
 0                                             Capture window that contain the title text "rximgsize" and save as example0.bmp in the folder images
 338 243 24                                    Show size and color depth for saved image (width height bpp)
 0                                             Resize example0.bmp to 100 pixels wide (keep aspect) and save the result as example1.jpg in the folder images
 0                                             Resize example0.bmp to 120 pixels wide (keep aspect) and save the result as example1.bmp in the folder images
 0                                             Resize example0.bmp to 120x120 pixels and save the result as example2.bmp in the folder images
 0                                             Resize example0.bmp to 120 pixels high and save the result as example3.bmp in the folder images
 0                                             Resize example3.bmp to 137 pixels high and replace example3.bmp in the folder images
 0                                             Read example0.bmp and save it as example4.bmp in the folder images
 0                                             Resize example4.bmp to 210 pixels wide and replace it
 0                                             Read and do quality scale (Lanczos) of example1.bmp to 1000x1000 pixels and save it as example5.bmp
 0                                             Read and do quality scale (Nearestneighbor) of example3.bmp to 2000x2000 pixels and save it as example6.bmp
 0                                             Read and do quality scale (Lanczos) of example0.bmp to 3000x3000 pixels and save it as example7.bmp
 0                                             Capture the desktop and save as example.bmp in the folder images
 0                                             Capture interior of window that contain the title text "editor" and save as example8.bmp in the folder images
 [C:\DESKTOP\rxImgSize]


You should see several rows with 0 (zero) if it is successful .
The capture procedure search for window names that match exactly (though caseless comparison) at first, but if it can't find any match look for windows that contain the text.

) or "RXIMGSIZE" or "rximgsize" or any variation to it as capitalization doesn't matter
) the capture procedure will return "RXIMGSIZE not found." if there is no window with that name
) info/resize/scale etc. will fail with a number depending on the cause. 0 = OK, 2 = missing image/file, etc. See source code for specific reasons.


==License==
BSD 3-Clause

==Author==
Jan-Erik Lrka

==Acknowledge==
Parts of the code has been influenced by GBM. Thanks to the work by Heiko Nitzsche, Germany.

==Links==
http://www.os2world.com/wiki/index.php/RxImgSize