render
Generate a viewable image of the current molecular scene to verify and refine your visualization setup.
Instructions
Renders the current scene and returns the image, so you can see it.
Use this instead of calling ray and png separately — those leave
you holding a filename you cannot look at. Call this after setting up a
view to check what it actually looks like, and iterate.
Every render is ray-traced, which takes seconds to minutes on a large
assembly. ray_trace=False is accepted but ignored: PyMOL's fast
unshaded frame grab needs its GUI thread, which this plugin does not run
on, so that path wrote blank images. Render smaller to render faster.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| width | No | Image width in pixels. Larger costs render time and context. | |
| height | No | Image height in pixels. | |
| filename | No | Optional path to also keep the PNG at. Without it the render goes to a temporary file that is cleaned up afterwards — except when the image is too large to inline, where the file is kept so you still have the render. | |
| ray_trace | No | Kept for compatibility and ignored — every render is ray-traced, because PyMOL's unshaded OpenGL capture does not work over this bridge. Use a smaller width/height to render faster. |