Mpng: Difference between revisions

From PyMOLWiki
Jump to navigation Jump to search
No edit summary
 
(usage)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
===DESCRIPTION===
  "mpng" writes a series of numbered movie frames to png files with
  the specified prefix.  If the "ray_trace_frames" variable is
  non-zero, these frames will be ray-traced.  This operation can take
  several hours for a long movie.
  Be sure to disable "cache_frames" when issuing this operation on a
  long movie (>100 frames) to avoid running out of memory.
===USAGE===
  mpng prefix [, first [, last]]
  Options "first" and "last" can be used to specify an inclusive
  interval over which to render frames.  Thus, you can write a smart
  Python program that will automatically distribute rendering over a
  cluster of workstations.  If these options are left at zero, then
  the entire movie will be rendered.
===PYMOL API===
<source lang="python">
  cmd.mpng( string prefix, int first=0, int last=0 )
</source>


[[Category:Commands|mpng]]
'''mpng''' writes a series of numbered movie frames to png files with the specified prefix.  If the '''[[ray_trace_frames]]''' variable is non-zero, these frames will be ray-traced.  This operation can take several hours for a long movie.
 
Be sure to disable '''[[cache_frames]]''' when issuing this operation on a long movie (>100 frames) to avoid running out of memory.
 
== Usage ==
 
mpng prefix [, first [, last [, preserve [, modal [, mode [, quiet
    [, width [, height ]]]]]]]]
 
Options "first" and "last" can be used to specify an inclusive interval over which to render frames.  Thus, you can write a smart Python program that will automatically distribute rendering over a cluster of workstations.  If these options are left at zero, then the entire movie will be rendered.
 
== Arguments ==
 
* '''prefix''' = string: filename prefix for saved images -- output files will be numbered and end in ".png"
* '''first''' = integer: starting frame {default: 0 (first frame)}
* '''last''' = integer: last frame {default: 0 (last frame)}
* '''preserve''' = 0/1: Only write non-existing files {default: 0}
* '''modal''' = integer: will frames be rendered with a modal draw loop
* '''mode''' = int: 2=ray, 1=draw, 0=normal {default: -1, check [[ray_trace_frames]] or [[draw_frames]]}
* '''width''' = int: width in pixels {default: current [[viewport]]}
* '''height''' = int: height in pixels {default: current [[viewport]]}
 
== Python API ==
<source lang="python">
cmd.mpng(str prefix, int first=0, int last=0, int preserve=0,
    int modal=0, int mode=-1, int quiet=1,
    int width=0, int height=0)
</source>
 
[[Category:Commands|Mpng]]

Latest revision as of 02:58, 31 January 2019

mpng writes a series of numbered movie frames to png files with the specified prefix. If the ray_trace_frames variable is non-zero, these frames will be ray-traced. This operation can take several hours for a long movie.

Be sure to disable cache_frames when issuing this operation on a long movie (>100 frames) to avoid running out of memory.

Usage

mpng prefix [, first [, last [, preserve [, modal [, mode [, quiet
    [, width [, height ]]]]]]]]

Options "first" and "last" can be used to specify an inclusive interval over which to render frames. Thus, you can write a smart Python program that will automatically distribute rendering over a cluster of workstations. If these options are left at zero, then the entire movie will be rendered.

Arguments

  • prefix = string: filename prefix for saved images -- output files will be numbered and end in ".png"
  • first = integer: starting frame {default: 0 (first frame)}
  • last = integer: last frame {default: 0 (last frame)}
  • preserve = 0/1: Only write non-existing files {default: 0}
  • modal = integer: will frames be rendered with a modal draw loop
  • mode = int: 2=ray, 1=draw, 0=normal {default: -1, check ray_trace_frames or draw_frames}
  • width = int: width in pixels {default: current viewport}
  • height = int: height in pixels {default: current viewport}

Python API

cmd.mpng(str prefix, int first=0, int last=0, int preserve=0,
    int modal=0, int mode=-1, int quiet=1,
    int width=0, int height=0)