Png - Revision history

Bell: 1 revision

2015-04-21T22:50:05Z

1 revision

2015-02-09T17:31:19Z

example, remove obsolete "blank screen" comment

2014-06-09T14:21:54Z

5 revisions

2014-06-05T17:16:05Z

Transparent Backgrounds: added example of ray_opaque_background setting

2014-06-05T17:11:10Z

DPI Setting: updated to account for integrated width, height, and ray arguments

2014-06-05T17:06:46Z

USAGE: updated with additional parameters

2014-06-05T17:01:34Z

PYMOL API: updated API to match `help png` output and include defaults

2014-06-05T16:56:52Z

USAGE: added brackets and defaults for keyword arguments

2014-03-28T03:36:30Z

15 revisions

2010-03-16T13:47:26Z

@@ Line 1: / Line 1: @@
 '''png''' writes a png format image file of the current image to disk.
-===USAGE===
+== Usage ==
   png filename[, width[, height[, dpi[, ray[, quiet]]]]]
@@ Line 11: / Line 11: @@
 * '''quiet''' = 0 or 1: if 1, logged output is suppressed.  {default: 0}
-===PYMOL API===
+== Example ==
 <source lang="python">
 cmd.png(string filename, int width=0, int height=0, float dpi=-1, int ray=0, int quiet=0)
 </source>
-===COMMENTS===
+== Comments ==
 ====Transparent Backgrounds====

@@ Line 22: / Line 22: @@
 ====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.
+Use the `[[ray_opaque_background]]` setting to output images with transparent backgrounds.
 ====DPI Setting====

@@ Line 25: / Line 25: @@
 ====DPI Setting====
-Use the DPI option to have PyMol set the DPI of your image.  If I execute
+Use the DPI option to have PyMol set the DPI of your image.  Executing the command
-<source lang="python">ray 1200,1200</source>
+<source lang="python">png /tmp/ex.png, width=1200, height=1200, dpi=300, ray=1</source>
-then execute
+will ouput a four-inch square image at 300dpi.  Leaving off the '''dpi''' parameter would yield a 1200x1200 image at your system's default pixel density (e.g. 72 or 96 dpi).  This saves the intermediate step of having to use GIMP/PhotoShop/etc to rescale your photos for publication.
 [[Category:Commands|Png]]
 [[Category:Publication_Quality|Png]]
 [[Category:Performance|Png]]

@@ Line 2: / Line 2: @@
 ===USAGE===
-  png filename[, dpi[, ray]]
+  png filename[, width[, height[, dpi[, ray[, quiet]]]]]
-* '''dpi''', sets the dots per inch (dpi) of the final image (default=-1 [unspecified])
+* '''filename''' = string: file path to be written
-* '''ray''', whether or not PyMOL ray traces the image before saving (default=0)
+* '''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)}
 ===PYMOL API===

@@ Line 9: / Line 9: @@
 ===PYMOL API===
 <source lang="python">
-cmd.png( string file, dpi, ray )
+cmd.png(string filename, int width=0, int height=0, float dpi=-1, int ray=0, int quiet=0)
 </source>

← Older revision	Revision as of 22:50, 21 April 2015
(No difference)

← Older revision	Revision as of 14:21, 9 June 2014
(No difference)

← Older revision	Revision as of 03:36, 28 March 2014
(No difference)