viewwrite command

Creates a flipbook from a viewport.

Replaced by: hou.GeometryViewport

All Usages Options Examples

Usages

  1. viewwrite [-f start end] [-i inc] [-r resx resy] [-c] [-a audio_file] [-o frame audio_sec] [-s spool_dir] [-v pattern] [-k] [-A] viewername output

viewername must be a single, open viewport.

output can be a file path (using the $F variable to create an image sequence), or “md” or “ip” to spool the images to the spool directory (default is $HOUDINI_TEMP_DIR).

Options

-f start end

Frame range to render

-i inc

Increment in frame range. For example, 2 renders every other frame, 3 renders every third frame, etc.

-r resx resy

Resolution. If not specified, the command uses the viewport resolution. The command makes no effort to preserve aspect ratio.

-c

Crop out view mask overlay region.

-b imagefile

Background image.

-g gamma

Gamma value.

-l lutfile

File containing a lookup table (LUT).

-e

Enable block editing.

-a audio_file

Audio file to use with the flipbook.

-o frame audio_sec

Synchronize image frame with audio at audio_sec.

-q aa_quality

Set the antialias quality to 0 (off), 1 (low, 2x), 2 (med, 4x) or 3 (high, 8x or 6x). This will antialias polygons and textures in addition to lines.

-s spool_dir

Spool directory to use when output is “md” or “ip”.

-v pattern

Only objects whose names match pattern appear in the render. Default is “*“.

-m frames bias shutter

Flipbook with motion blur, by blending num_frames subframes together. bias specifies if the subframes rendered are before (-1), centered about (0) or after (1) the specified render frame. shutter specifies the camera shutter time (or, the portion of a frame that the subframes are sampled over). If zero, the value from the camera attached to the viewport will be used.

-d quality focus_length aperture fstop

Flipbook with depth of field, by blending quality subframes together, jittered about the camera’s circle of confusion. Increasing the quality improves the blur, at the expense of rendering time. The focus_length, aperture and fstop parameters specify the camera values needed to determine the depth of field (defaults 10, 41.4124 and 22). If any of these parameters are zero, the value from the camera attached to the viewport will be used.

-k

Render only frames at which currently scoped channels have keys.

-A

Append the rendered frames to the existing sequence (frame numbers will no longer correspond to the images).

-I

Initialize simulation operators (POPs, DOPs, Spring SOPs) before creating the flipbook. This is useful to flipbook simulations that are not cached, and therefore may not appear correctly in the flipbook if the current frame is later than the frames being flipbooked.

Examples

viewwrite -f 1 10 Build.pane2.world.persp1 ip
Render frames 1 to 10 to a flipbook.

viewwrite -f 1 10 Build.pane2.world.persp1 '$F.jpg'
Render frames 1 to 10 to disk files. Single quotes protect the $F variable from being expanded when the command is entered.