Difference between revisions of "Mpng"
Jump to navigation
Jump to search
m |
(usage) |
||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
| − | + | ||
'''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. | '''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. | 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]] | + | |
| + | 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. | 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"> | <source lang="python"> | ||
| − | cmd.mpng( | + | 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> | </source> | ||
[[Category:Commands|Mpng]] | [[Category:Commands|Mpng]] | ||
Latest revision as of 03: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)