get-screen-pixmap

Arguments: &key box prompt title no-dialog no-draw

This function simply calls get-pixmap to create a pixmap from the image in an area of the screen, first calling get-screen-box if box is unsupplied. The box argument is passed to get-pixmap, while the other arguments are passed to get-screen-box.

If no-draw is nil (the default), then a rubber-banding box is drawn during the time between the two presses of the control key to indicate the region that is being selected. If no-draw is true, then this box is not drawn. Drawing the box could leave screen droppings if the area being copied is being updated as the user is specifying the box.

The return value is a pixmap unless box is nil and the user presses the Escape key to cancel the interactive specification of the box, in which case nil is returned.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.