Chimera Commands Index

copy [ file filename ] [ format ] [ printer printername ] [ width x ] [ height y ] [ units type ] [ dpi pixels-per-inch ] [ supersample n ] [ raytrace [ rtwait ] [ rtclean ]]

Copy saves the contents of the graphics window as an image, either rendered directly by Chimera or raytraced. Background transparency in Chimera-rendered PNG or TIFF images can be specified at startup with the --bgopacity option if images will be saved with the copy command (the Save Image dialog also contains the option). For background transparency in raytraced images, see the POV-Ray Options preferences. See also: windowsize, preset, export, Save Image, tips on preparing images

To copy a molecule model to create a new model, use the command combine instead. To copy settings from one molecule model to another, use the command mcopy.

If the file keyword is given, the image is saved in filename. If "-" is supplied instead of a filename, a dialog for saving a file will appear. The printer option does not work on Windows. On other platforms, the printer option sends the image in PostScript form to the printer named printername. If "-" is supplied instead of a printer name, the image is sent to the default system printer. If neither file nor printer is specified, a dialog for saving a file will appear.

If width and height are not specified, the image will have the same pixel dimensions as the graphics window. If only one dimension is specified, the other will be set according to the graphics window aspect ratio; if both are specified but the image aspect ratio is not the same as the graphics window aspect ratio, the image contents will differ from what is shown in the window.

Width and height values are assumed to be in pixels unless units are specified as one of the following types:

If units are specified as one of the above, a dpi value (pixels-per-inch) can also be specified, or the current Print resolution setting in the Save Image dialog will be used. If width and height are in pixels, dpi is ignored.

If the image is rendered directly by Chimera (the raytrace keyword is not supplied):

If the image is raytraced with POV-Ray (the raytrace keyword is supplied):