Where can I find this command?
The ViewCapture and ScreenCapture commands save a bitmap image. The ViewCapture commands save the contents of the viewport with options for turning on various viewport elements. The SceenCapture commands save the viewport including the viewport frame, viewport title, and the cursor.
The ViewCaptureToFile command saves an image of the current view to a file.
ViewCaptureToFile saves the contents of the view with a specified width and height, disregarding the current viewport size.
Viewport borders, cursor images, and other decorations are not saved.
Steps
Choose the location, file type, and name for the bitmap file.
BMP, JPG, PCX, PNG, TIFF, and TGA formats are supported.
Options
Transparent background (supported file types only)
Saves the background with alpha channel. Select a file format that supports alpha channels, otherwise, the alpha channel will be stripped out.
Command-line options
To access command-line options
Type a hyphen in front of the command name: -ViewCaptureToFile.
These options stay in effect when the command is subsequently run normally with the exception of the width and height, which are taken from the current viewport size.
Width
Sets the image width. This option persists when the command is run in scripting mode. When the command is run normally, the width of the current viewport determines the image width.
Height
Sets the image height. This option persists when the command is run in scripting mode. When the command is run normally, the height of the current viewport determines the image height.
Scale
Scales the image from the viewport size. For example, with a viewport that is 400x600, a scale of 2 will make the image 800x1200.
DrawGrid
The grid appears in the captured image.
DrawWorldAxes
The world axis icon appears in the captured image.
DrawCPlaneAxes
The construction plane axes appear in the captured image.
TransparentBackground
All background pixels will have a 0.0% alpha value. This overrides the DrawWorldAxes setting.
The ViewCaptureToClipboard command saves an image of the current view to the Windows Clipboard.
Command-line options
To access command-line options
Type a hyphen in front of the command name: -View CaptureToClipboard.
These options stay in effect when the command is subsequently run normally with the exception of the width and height, which are taken from the current viewport size.
Width
Sets the image width. This option persists when the command is run in scripting mode. When the command is run normally, the width of the current viewport determines the image width.
Height
Sets the image height. This option persists when the command is run in scripting mode. When the command is run normally, the height of the current viewport determines the image height.
Scale
Scales the image from the viewport size. For example, with a viewport that is 400x600, a scale of 2 will make the image 800x1200.
DrawGrid
The grid appears in the captured image.
DrawWorldAxes
The world axis icon appears in the captured image.
DrawCPlaneAxes
The construction plane axes appear in the captured image.
The ScreenCaptureToFile command saves an image of the current viewport with viewport borders, viewport titles, cursor images, and other decorations as a bitmap file, using the current viewport size.
Screen captures are useful if you are creating illustrations for documentation. With Rhino you can capture the current viewport to the Windows Clipboard, to a file with a color depth to match your current settings.
Steps
Choose the location, file type, and name for the bitmap file.
BMP, JPG, PCX, PNG, TIFF, and TGA formats are supported.
The ScreenCaptureToClipboard command saves an image of the current viewport with borders and viewport titles to the Windows Clipboard.
The active viewport is captured to the Clipboard as a bitmap. You can paste this image into a paint program for further editing, or another program that accepts bitmap images.
See also
Rhino Screen Capture Strategies tutorial
Rhinoceros 5 © 2010-2015 Robert McNeel & Associates. 17-Sep-2015
