Name
GrabScreenPixels -- grab pixels of display's host screen (V6.0, optional)
Synopsis
ULONG *rgb = GrabScreenPixels(APTR handle, int x, int y, int width,
                 int height, ULONG flags, struct hwTagList *tags);
Function
This function must grab the pixels of the screen that is currently hosting the specified display and return them to Hollywood as a 32-bit RGB pixel array. The pixel array that is returned by this function must be exactly width * height * 4 bytes in size. No padding bytes are allowed.

Hollywood will call your FreeGrabScreenPixels() function to free the pixel array allocated by this function.

GrabScreenPixels() is an optional API and must only be implemented if HWSDAFLAGS_GRABSCREEN has been passed to hw_SetDisplayAdapter(). See hw_SetDisplayAdapter for details.

Inputs
handle
display handle returned by OpenDisplay()
x
x offset marking the start position of the grab operation
y
y offset marking the start position of the grab operation
width
grab width in pixels
height
grab height in pixels
flags
reserved for future use (currently 0)
tags
reserved for future use (currently NULL)
Results
rgb
32bit RGB array containing the grabbed pixels
Show TOC