We need your help! 🔥
Please consider disabling your ad-blocker to support this website! 🔑
We are a free, community-supported website! 🥰
We only display small unobtrusive ads which help us stay online! 💯
Thank you in advance! ❤️
We are a free, community-supported website! 🥰
We only display small unobtrusive ads which help us stay online! 💯
Thank you in advance! ❤️
Capture View
Use this component to capture Rhino views and save them to your hard drive as as a .png files.
This is particularly useful if you are trying to create animations of Grasshopper geometry and want to automate the capturing of views.
Note that your images will have a Rhino world axes icon in the lower left of the image unless you go to Options > Grid > and uncheck "Show world axes icon" in Rhino.
Inputs
| Name | ID | Description | Type |
|---|---|---|---|
| File Name | _fileName | The file name that you would like the image to be saved as. Note that, for animations, you want to make sure that each saved images has a different filename otherwise the previous image will be overwritten by each successive image. | Goo |
| Folder | folder_ | The folder into which you would like to write the image file. This should be a complete file path to the folder. If no folder is provided, the images will be written to C:/Ladybug/Capturedviews/. | Goo |
| View Names | viewNames_ | The Rhino viewport name which you would like to take a snapshot of. Acceptable inputs include "Perspective", "Top", "Bottom", "Left", "Right", "Front", "Back" or any view name that you have already saved within the Rhino file (note that you do not need to input quotations). If no text is input here, the default will be an image of the active viewport (or the last viewport in which you navigated). | Goo |
| Image Width | imageWidth_ | The width of the image that you would like to take in pixels. If no value is provided here, the component will set the width to that of the active Rhino viewport on your screen. | Goo |
| Image Height | imageHeight_ | The height of the image that you would like to take in pixels. If no value is provided here, the component will set the height to that of the active Rhino viewport on your screen. | Goo |
| Display Mode | displayMode_ | The display mode of the viewport that you would like to take an image of. Acceptable inputs include "Wireframe", "Shaded", "Rendered", "Ghosted", "X-Ray", "Technical", "Artistic", and "Pen". If no text is input here, the default will be the displaymode of the active viewport (or the last viewport in which you navigated). | Goo |
| Keep Aspect R | keepAspectR_ | Set to "True" to keep the aspect ratio of the viewport in the images that you save. By default, this is set to "False" if you have connected an imageHeight_ but will override this input to ensure correct aspect ratio if set to "True". | Goo |
| Transpar Back | transparBack_ | Set to "True" to have a transparent background for the image and set to "False" to save a picture using the Rhino viewport background color. The default is set to "False" for an opaque background. | Goo |
| Capture | _capture | Set to "True" to capture the image of the Rhino viewport and save it to your hard drive. | Goo |
Outputs
| Name | ID | Description | Type |
|---|---|---|---|
| Output | Output | The filepath of the image taken with this component. | String |
Site design © Robin Rodricks.
Site co-created by Andrew Heumann.
Ladybug and associated data © 2024 Ladybug Tools.
Rhinoceros and Grasshopper are registered trademarks of Robert McNeel & Associates.
Hosted by GitHub