Difference between revisions of "Png"
Jaredsampson (talk | contribs) (→PYMOL API: updated API to match `help png` output and include defaults) |
Jaredsampson (talk | contribs) (→USAGE: updated with additional parameters) |
||
| Line 2: | Line 2: | ||
===USAGE=== | ===USAGE=== | ||
| − | png filename[, dpi[, ray]] | + | png filename[, width[, height[, dpi[, ray[, quiet]]]]] |
| − | * ''' | + | * '''filename''' = string: file path to be written |
| − | * '''ray''' | + | * '''width''' = integer or string: width in pixels (integer or string without units), inches (in), or centimeters (cm). If unit suffix is given, `dpi` argument is required as well. If only one of `width` or `height` is given, the aspect ratio of the viewport is preserved. {default: 0 (current)} |
| + | * '''height''' = integer or string: height (see width) {default: 0 (current)} | ||
| + | * '''dpi''' = float: dots-per-inch {default -1.0 (unspecified)} | ||
| + | * '''ray''' = 0 or 1: should ray be run first {default: 0 (no)} | ||
| + | * '''quiet''' = 0 or 1: if 1, logged output is suppressed. {default: 0} | ||
===PYMOL API=== | ===PYMOL API=== | ||
Revision as of 13:06, 5 June 2014
png writes a png format image file of the current image to disk.
USAGE
png filename[, width[, height[, dpi[, ray[, quiet]]]]]
- filename = string: file path to be written
- width = integer or string: width in pixels (integer or string without units), inches (in), or centimeters (cm). If unit suffix is given, `dpi` argument is required as well. If only one of `width` or `height` is given, the aspect ratio of the viewport is preserved. {default: 0 (current)}
- height = integer or string: height (see width) {default: 0 (current)}
- dpi = float: dots-per-inch {default -1.0 (unspecified)}
- ray = 0 or 1: should ray be run first {default: 0 (no)}
- quiet = 0 or 1: if 1, logged output is suppressed. {default: 0}
PYMOL API
cmd.png(string filename, int width=0, int height=0, float dpi=-1, int ray=0, int quiet=0)
COMMENTS
Blank Screen Shots
If, when you execute the Png command, you get blank images, you may have to Ray trace your image first, before running the Png command. This occurs when there is no device context for the image, such as when running PyMOL in quiet gui-less mode. If the ray tracing is taking too long due to scene complexity or size, then please see the Ray page or search the wiki for information about making movies with PyMOL (there are many ways to speed up rendering).
Transparent Backgrounds
See Ray_opaque_background. This is very useful for presentations, or images that are placed on top of a background of nonuniform color, or if you simply want a transparent background for your images.
DPI Setting
Use the DPI option to have PyMol set the DPI of your image. If I execute
ray 1200,1200
then execute
png /tmp/ex.png, dpi=300
I will get a four-inch square image at 300dpi. Leaving off the dpi flag would net me a 1200x1200 image at 72dpi. This saves the intermediate step of having to use GIMP/PhotoShop/etc to rescale your photos for publication.