vuo.scene

These nodes are for working with 3D scenes.

A scene (scenegraph) contains a set of 3D objects. Each object has a set of vertices (mesh) that defines its shape. You can control how the object looks when rendered (such as color and texture) by changing its shader. You can control the position, angle, and size of the object by changing its transform. You can control the point of view on the scene by adding a camera.

To load a 3D model from a file, you can use the Fetch Scene node. It supports files with extension .3dgs, .3ds, .ac3d, .b3d, .blend, .cob, .dae, .dxf, .fbx, .hmp, .irr, .irrmesh, .lwo, .lxo, .m3, .md2, .md3, .md5, .mdc, .mdl, .ms3d, .ndo, .nff, .obj, .off, .pk3, .ply, .q3d, .q3s, .raw, .scn, .smd, .stl, .ter, and .xml.

To make graphics rendering more efficient, by default Vuo only renders the front/exterior side of a 3D object. For example, with Make Sphere Vertices, Vuo shows the sphere when viewed from the outside — but if you move the camera inside the sphere, it disappears. You can make the back/interior of the object visible with the Show Back of 3D Object node.

In Vuo Coordinates, (0,0,0) is the center of the scene. The default camera is at (0,0,1). When viewed through this camera, the scene has a width of 2, with X-coordinate -1 on the left edge and 1 on the right edge. The scene’s height is determined by its aspect ratio, with the Y-coordinate increasing from bottom to top. The Z-coordinate increases from back to front. Objects are visible if their distance from the camera along the Z-axis is between 0.1 and 10.

If you’d like to create a scene within Vuo, you can start with the Make 3D Object node or one of the shortcut nodes, such as Make Cube or Make 3D Object from Image.

To display a scene, you can use the Render Scene to Window node.

Example compositions:

• Add Noise To Clay: Displays 4 spheres in a grid, and deforms them with noise.
• Aim Flashlight: Displays a simple scene which can be lit and revealed by moving the mouse to aim the flashlight.
• Bend Sphere: Deforms a sphere by bending it around a focal point.
• Blend Sphere Into Scene: Demonstrates different ways of blending a semi-transparent sphere onto the scene behind it.
• Bounce Stereo Sphere: Displays a sphere using a stereo camera, and displays the result as a red/cyan anaglyph to be viewed with 3D glasses.
• Change Traffic Signal: Displays a traffic signal mesh, and changes the shader used to render each of its lights.
• Compare Cameras: Makes a scene consisting of two palm trees, each shaded with a different color. Displays 4 different views of the same scene, like CAD software.
• Compare Lights: Makes a scene consisting of a cube and a sphere. Displays 3 different types of lights, explaining the difference between them.
• Dent Room: Makes a room of grid lines that you can displace by moving the mouse.
• Displace Radial Gradient: Extrudes a grid in the shape of a cone using an image.
• Display Cube: Displays a 3D wireframe cube. You can rotate it by dragging the mouse.
• Display Row Of Spheres: Displays multiple copies of a sphere in a row across the graphics area.
• Display Scene: Displays a 3D scene which you can drag using the mouse.
• Display Scene With Floor: Displays a 3D scene with a plane underneath.
• Display Sphere: Displays a sphere.
• Divide Sphere: Breaks a sphere into pieces and moves them outward from the sphere's original surface.
• Explode Sphere: Shatters the front of a sphere.
• Facet Sphere: Deforms a sphere by turning its smooth surface into flat faces.
• Make Rugged Terrain: Deforms a plane by moving its points according to the brightness of parts of an image. Press space to switch between vertical lines, horizontal lines, and both.
• Move Beads On String: Creates a simple bead and string scene, then applies wave motion to it.
• Move Spinning Sphere: Displays a rotating sphere that can be moved using the mouse.
• Move Through Tube With Fisheye: Animates moving through a tube, using a fisheye camera.
• Paint Scene With Checkerboard: Displays a 3D scene whose shaders have been replaced with a checkerboard image.
• Pinch Rectangles: Deforms three different rectangular scene objects with a "pinch" object filter: a solid rectangle, a rectangle made up of grid lines, and a rectangle made up of grid points.
• Pinch Sphere: Deforms a sphere by pulling it toward and pushing it away from a point.
• Rewind Checkerboard Explosion: Shows a cloud of triangular confetti that gradually joins together to form a checkerboard-painted square.
• Ripple Grid: Ripples a plane with various kinds of waves.
• Ripple Image Of Sphere: Renders a rotating sphere to an image, then adds a ripple distortion to the image.
• Show Random Points: Shows a set of rotating points, demonstrating different random distributions.
• Show Spheres With Lights: This composition shows a rotating camera viewing three spheres. Click to change the elevation of the camera.
• Show Trees With Fisheye: Shows a simple scene using a fisheye camera.
• Skew Sphere: Deforms a sphere by skewing it along a diagonal.
• Spike Sphere: Deforms a sphere by making spikes grow out of it.
• Switch Cameras: Switches between the default camera looking at the front of a scene and a second camera looking down on the scene from above.
• Trim Sphere: Trims a sphere horizontally and vertically.
• Twirl Grid: Deforms a plane by twirling it.

Nodes:

• Arrange 3D Objects in Grid (vuo.scene.arrange.grid): Moves objects so that they are evenly arranged in a 3D grid.
• Show Back of 3D Object (vuo.scene.back): Shows the back/interior of the object (optionally keeping the front/exterior).
• Bend 3D Object (vuo.scene.bend): Warps the object along a curve.
• Change 3D Object Blending (vuo.scene.blendMode): Applies a different image compositing style to the object.
• Get 3D Object Bounds (vuo.scene.bounds): Outputs the center and size of a 3D object.
• Combine 3D Objects (vuo.scene.combine): Groups multiple 3D objects together and applies a transformation to the group.
• Copy 3D Object with Transforms (vuo.scene.copy): Creates 3D object group consisting of transformed copies of an original.
• Copy 3D Object (vuo.scene.copy.trs): Creates a 3D object group consisting of transformed copies of an original.
• Displace 3D Object with Image (vuo.scene.displace.image): Translates each vertex in a direction perpendicular to its plane by an amount determined by the brightness of an image.
• Divide 3D Object (vuo.scene.divide): Separates the object’s edges, and moves them outward.
• Explode 3D Object (vuo.scene.explode): Violently shatters the object.
• Facet 3D Object (vuo.scene.facet): Sharpens the object’s edges.
• Fetch Scene (vuo.scene.fetch): Loads or downloads a 3D scene (3D model) from a URL.
• Fetch List of Scenes (vuo.scene.fetch.list): Loads or downloads 3D scenes (3D models) from a set of URLs.
• Make 3D Object (vuo.scene.make): Creates a 3D object that can be added to a 3D scene.
• Make Draggable Camera (vuo.scene.make.camera.drag): Creates a draggable perspective camera that can be added to a 3D scene.
• Make Fisheye Camera (vuo.scene.make.camera.fisheye) [Pro node]: Creates a fisheye camera that can be added to a 3D scene.
• Make Targeted Fisheye Camera (vuo.scene.make.camera.fisheye.target) [Pro node]: Creates a fisheye camera that can be added to a 3D scene.
• Make Orthographic Camera (vuo.scene.make.camera.orthographic): Creates an orthographic camera that can be added to a 3D scene.
• Make Targeted Orthographic Camera (vuo.scene.make.camera.orthographic.target): Creates an orthographic camera that can be added to a 3D scene.
• Make Perspective Camera (vuo.scene.make.camera.perspective): Creates a perspective camera that can be added to a 3D scene.
• Make Targeted Perspective Camera (vuo.scene.make.camera.perspective.target): Creates a perspective camera that can be added to a 3D scene.
• Make Stereo Camera (vuo.scene.make.camera.stereo) [Pro node]: Creates a stereoscopic perspective camera that can be added to a 3D scene.
• Make Targeted Stereo Camera (vuo.scene.make.camera.stereo.target) [Pro node]: Creates a stereoscopic perspective camera that can be added to a 3D scene.
• Make Cone (vuo.scene.make.cone): Creates a scene object in the shape of a cone.
• Make Cube with Materials (vuo.scene.make.cube): Creates a scene object in the shape of a cube.
• Make Cube (vuo.scene.make.cube.1): Creates a scene object in the shape of a cube.
• Make Grid Lines Object (vuo.scene.make.grid.lines): Creates a square mesh made up of lines.
• Make Grid Points Object (vuo.scene.make.grid.points): Creates a square mesh made up of points.
• Make Icosphere (vuo.scene.make.icosphere): Creates a scene object in the shape of a sphere.
• Make 3D Object from Image (vuo.scene.make.image): Turns an image into a 3D object that can be added to a 3D scene.
• Make Unlit 3D Object from Image (vuo.scene.make.image.unlit): Turns an image into a 3D object that can be added to a 3D scene.
• Make Ambient Light (vuo.scene.make.light.ambient): Creates ambient light that can be added to a 3D scene.
• Make Point Light (vuo.scene.make.light.point): Creates a point light that can be added to a 3D scene.
• Make Spotlight (vuo.scene.make.light.spot): Creates a spotlight that can be added to a 3D scene.
• Make Targeted Spotlight (vuo.scene.make.light.spot.target): Creates a spotlight that can be added to a 3D scene.
• Make Random Points Object (vuo.scene.make.random.points): Creates a 3D object made up of points at random positions.
• Make Sphere (vuo.scene.make.sphere): Creates a scene object in the shape of a sphere.
• Make 3D Square (vuo.scene.make.square): Creates a scene object in the shape of a square.
• Make Torus (vuo.scene.make.torus): Creates a scene object in the shape of a torus.
• Make 3D Triangle (vuo.scene.make.triangle): Creates a scene object in the shape of an equilateral triangle.
• Make Tube (vuo.scene.make.tube): Creates a scene object in the shape of a tube.
• Add Noise to 3D Object (vuo.scene.noise): Moves the object’s vertices using Perlin noise.
• Normalize 3D Object (vuo.scene.normalize): Centers and scales a 3D object so that it can easily be rendered.
• Pinch 3D Object (vuo.scene.pinch): Pulls the object toward the specified point, or pushes it away from the point.
• Is 3D Object Populated (vuo.scene.populated): Outputs true if the 3D object is non-empty or has any non-empty child objects.
• Render Scene to Image (vuo.scene.render.image): Creates an image that is a snapshot of a 3D scene.
• Render Scene to Stereo Images (vuo.scene.render.image.stereo) [Pro node]: Creates an image that is a stereoscopic snapshot of a 3D scene.
• Render Scene to Window (vuo.scene.render.window): Displays a window containing a 3D scene.
• Ripple 3D Object (vuo.scene.ripple): Distorts the object with a wave effect.
• Change All Shaders (vuo.scene.shader.all): Applies a shader to a 3D object and all of its child objects.
• Change Shaders with Name (vuo.scene.shader.material): Replaces shaders in a 3D object and all of its child objects.
• Skew 3D Object (vuo.scene.skew): Moves part of the object, while holding part of it steady.
• Spike 3D Object (vuo.scene.spike): This node takes every triangle in an object and splits it into 3 triangles, each touching a new vertex added at the center of the original triangle.
• Trim 3D Object (vuo.scene.trim): Hides parts of the object that are outside the specified box.
• Twirl 3D Object (vuo.scene.twirl): Rotates part of the object, while holding part of it steady.