canvas::snap - Variations on a canvas

[ Tklib Home | Main Table Of Contents | Table Of Contents | Keyword Index | Categories | Modules | Applications ]

# canvas::snap(n) 1.0.1 tklib "Variations on a canvas"

## Name

canvas::snap - Canvas snapshot to Tk photo image

## Synopsis

- package require Tcl 8.5
- package require Tk 8.5
- package require canvas::snap ?1.0.1?
- package require img::window

- ::canvas::snap pathName

## Description

This package provides a command to take snapshots of arbitrary canvases.

## API

::canvas::snap pathName

  Takes a snapshot of the canvas pathName. The result is the name of a new Tk photo image containing the snapshot.

  Note that this command has a side-effect. To avoid having white rectangles where other windows may overlap the canvas this command forces the toplevel window the canvas is in to the top of the stacking order.

## Bugs, Ideas, Feedback

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category canvas of the Tklib Trackers. Please also report any ideas for enhancements you may have for either package and/or documentation.

## Keywords

canvas, image, photo, print screen, snapshot

## Copyright

Copyright © 2004 George Petasis (http://wiki.tcl.tk/1404)
Copyright © 2010 Documentation, Andreas Kupries