SippCopy Command

This command copies a single image from one image store to another. If the image store is capable of storing multiple images, only one image is copied. The input and output images can't have conflicting scanning directions (i.e. can't copy an RLE file to a PBMPlus file). Pixmaps can be used to buffer copies between image stores with conflicting scanning directions.

When copying between image stores that support image comments (RLE files and pixmaps), comments from the input image are merged into the output image comments. Comments in the output image override a comment by the same name from the input image. In RLE files, all comments are reset after a writing the image has completed. New comments can then be added and another image copied to the RLE file. With pixmaps, comments are not reset after storing an image in it. If a single pixmap instance is reused, the comments should probably be cleared with SippCommentDelete before adding new comments and storing a new image.

The following optional flags may be specified:

• -clear - Causes images copied to the a Tk photo image to be cleared before copying the image. This is the default.
• -noclear - Causes images copied to the a Tk photo image to not be cleared before copying the image. The contents of the previously rendered image will remain until a scanline is overwritten by the new image. This is most useful for overwriting a LINE rendered image with fully rendered image. Only one of -clear or -noclear may be specified.