Object which controls the position, orientation, and display of a camera view within the 3D workspace.
Note
This section is not fully updated.

Of course, K-3D wouldn't be a 3D program without some way of seeing your virtual world! Each Document in K-3D can contain an unlimited number of Cameras, each Camera representing a virtual view into your document through a Camera Viewport. By dragging your mouse through the Camera Viewport, you can interactively pan, tilt, and dolly the virtual camera, select geometry and even move, orient, and scale whole objects.
The following is not just limited to camera navigation but apply to the manipulation of all objects in the scene that has a position and orientation.
You can dolly by pressing the Shif key while holding down the right mouse button. The behaviour is dependent on what active axis is selected. With the Y axis active, mouse movement dolly the Camera along the X and Z axes.
Shift+Control while holding down the right mouse button dolly along the active axis. When a given axis is active, mouse movement alters an object around the other two axes; holding down CTRL constrains the change to the Active Axis.
You can use the mouse to select and deselect geometry interactivly. Selected geometry will be highlighted as white. When selecting in K-3D, it's important to keep in mind that there are three "levels" of selection: 1) Objects 2) Polygons 3) Points.
The first type of selection is the easiest: selecting an entire Object. You can do this in one of two ways: through the Hierarchy (clicking on the second square in front of the object) or by clicking on the Object with SHIFT and the Left Mouse Button.
Next, you might want to select polygons using a rectangular Rubber Band Box. Just drag the mouse with the Left Mouse Button down. An important thing to keep in mind is that every polygon that fits completely within the Rubber Band Box will be selected, whether it's visible or not. You may want to disable solid rendering for the Viewport while making selections, to avoid selecting unseen polygons by mistake.
Next, we'll select polygons using an arbitrarily-shaped Lasso. Hold down SHIFT while dragging the mouse with the Left Mouse Button down. Again, any polygon contained in the Lasso will be selected. When selecting with Rubber Band Boxes or Lassos, you will often need to move the Camera so you have a "clear shot" at the polygons you want to select.
You can select individual polygons by clicking within them with the Left Mouse Button. Again, any polygon under the mouse pointer is a candidate for selection.
We've covered Objects and Polygons so far, but what about Points? Actually, we've already been selecting Points, albeit indirectly - whenever you select a Polygon, you're selecting all its Points. This applies at the Object level, too - selecting an Object selects all its Polygons and Points. It's useful, though, to be able to select individual Points. To do this, we switch our Document to Point Edit Mode. We can now select individual Points using the same Rubber Band Box and Lasso techniques used earlier to select Polygons. You can use SHIFT click to select individual polygons while in Point Edit Mode.
You can deselect everything in your entire Document by clicking the Right Mouse Button in any Camera Viewport. Your Document can contain any combination of selected and unselected Objects, Polygons, and Points, and you'll need to keep track of what's selected, so you don't make inadvertent alterations. Use an Right Mouse Button click between selections to avoid leaving something selected by mistake. To deselect selectively, simply hold down CTRL while using any of the previously mentioned selection techniques.
Name | Description |
---|---|
name | Object name [string] |
input_matrix | Input matrix [matrix4] |
position | Position [vector3] |
orientation | Orientation [angle_axis] |
scale | Scale Matrix [vector3] |
output_matrix | Output matrix [matrix4] |
point_size | Point size [integer] |
background_color | Background color [color] |
fog | Fog [boolean] |
fog_near | Fog near distance [number] |
fog_far | Fog far distance [number] |
orthographic | Orthographic [boolean] |
left | Left [number] |
right | Right [number] |
top | Top [number] |
bottom | Bottom [number] |
near | Near plane distance [number] |
far | Far plane distance [number] |
headlight | Headlight [boolean] |
show_lights | Show Lights [boolean] |
draw_points | Draw Points [boolean] |
draw_edges | Draw Edges [boolean] |
draw_faces | Draw Faces [boolean] |
draw_linear_curves | Draw Linear Curves [boolean] |
draw_cubic_curves | Draw Cubic Curves [boolean] |
draw_nucurves | Draw NURBS Curves [boolean] |
draw_bilinear_patches | Draw Bilinear Patches [boolean] |
draw_bicubic_patches | Draw Bicubic Patches [boolean] |
draw_nupatches | Draw NURBS Patches [boolean] |
draw_face_orientations | Draw Face Orientations [boolean] |
draw_two_sided | Draw Two Sided [boolean] |
draw_safe_zone | Draw Safe Zone [boolean] |
viewport_host | Viewport Host [object] |