CameraPerspectiveAdvanced

CameraPerspectiveAdvanced#

(Perspective Advanced)

Category: /Camera
Default object name: perspective_advanced
Inherits from: ProjectItem > SceneItem > Camera

Description#

Define a pin-hole camera with advanced settings.

Public Attributes#

Type	Name	Visual Hint	Description
`double`	`horizontal_field_of_view`	`VISUAL_HINT_ANGLE`	Camera horizontal field of view in degrees. Is deducted from focal length and aperture. Linked to aperture.
`double`	`vertical_field_of_view`	`VISUAL_HINT_ANGLE`	Camera vertical field of view in degrees. Is deducted from focal length and aperture. Linked to aperture.
`double`	`focal_length`	`VISUAL_HINT_DISTANCE`	Camera focal length. Use this attribute to zoom in and out. Impacts field of view
`double`	`horizontal_aperture`	`VISUAL_HINT_DISTANCE`	Camera horizontal aperture: size of the camera sensor. Linked to field of view
`double`	`vertical_aperture`	`VISUAL_HINT_DISTANCE`	Camera vertical aperture: size of the camera sensor. Linked to field of view
`double[2]`	`film_offset`	`VISUAL_HINT_DISTANCE`	Offset of the camera sensor to the lens. Offsets the frustrum used to compute 3D layers.
`double`	`lens_ratio`	`VISUAL_HINT_DEFAULT`	Lens squeeze ratio.
`long`	`fit_mode`	`VISUAL_HINT_DEFAULT`	If set to horizontal, vertical or fill, use a square pixel aspect ratio. Vertical or horizontal aperture is recomputed to fit the target image.
`bool`	`enable_dof`	`VISUAL_HINT_DEFAULT`
`double`	`f_stop`	`VISUAL_HINT_DEFAULT`	Set the focal ratio. This controls the size of the lens.
`double`	`focus_distance`	`VISUAL_HINT_DISTANCE`	Set the distance at which the focus is done.
`reference` (`SceneItem`)	`focus_object`	`VISUAL_HINT_DEFAULT`	Use the input object to compute the focus distance. If none then focus_distance is used.

Inherited Public Attributes#

Type	Name	Visual Hint	Description
`double[3]`	`translate`	`VISUAL_HINT_DISTANCE`	Set the XYZ position of the item relative to its parent item.
`double[3]`	`rotate`	`VISUAL_HINT_ANGLE`	Set the XYZ rotation of the item relative to its parent item.
`double[3]`	`scale`	`VISUAL_HINT_SCALE`	Set the XYZ scaling of the item relative to its parent item.
`double[3]`	`shear`	`VISUAL_HINT_SCALE`	Set the XYZ shear of the item relative to its parent item.
`long`	`rotation_order`	`VISUAL_HINT_DEFAULT`	Specify on which order the Euler rotations are composed. By default Clarisse's uses YXZ
`reference` (`SceneItem`)	`parent`	`VISUAL_HINT_DEFAULT`	Set the parent item of the item.
`bool`	`inherit_transform`	`VISUAL_HINT_DEFAULT`	Does the current object inherits its parent transformation ?
`long`	`reference_frame`	`VISUAL_HINT_FRAME`	Set the reference frame that defines the base transform and deformation state of the item. This reference is used when computing texture projections or when generating point cloud (in Global Base) on the base geometry.
`object[]` (`Constraint`)	`constraints`	`VISUAL_HINT_DEFAULT`	Stack of constraint operators. Constraints like Target, Point, Orient... are applied to a Scene Item in order to drive the transformation of the item.
`double[3]`	`scale_pivot`	`VISUAL_HINT_DISTANCE`	Set the coordinates of the scale pivot.
`double[3]`	`rotate_pivot`	`VISUAL_HINT_DISTANCE`	Set the coordinates of the rotation pivot.
`double[3]`	`translate_offset`	`VISUAL_HINT_DISTANCE`	Set the XYZ position of the pivot point of the item.
`double[3]`	`rotate_offset`	`VISUAL_HINT_ANGLE`	Set the XYZ rotation of the pivot point of the item.
`double[3]`	`scale_offset`	`VISUAL_HINT_SCALE`	Set the XYZ scaling of the pivot point of the item.
`long`	`rotation_offset_order`	`VISUAL_HINT_DEFAULT`	Set the rotation axis mode.
`bool`	`display_visible`	`VISUAL_HINT_DEFAULT`	Set whether the item is shown in the 3D View or not.
`bool`	`display_pickable`	`VISUAL_HINT_DEFAULT`	Set whether the item is pickable in the 3D View or in the Image View.
`long`	`display_color`	`VISUAL_HINT_DEFAULT`	Set the item color for constant or simple shading display in the 3D View.
`double[3]`	`display_custom_color`	`VISUAL_HINT_COLOR`	Set the item custom color used for display in the 3D View when the Display Color attribute is set to Custom.
`bool`	`enable_motion_blur`	`VISUAL_HINT_DEFAULT`	Set whether the renderer will do motion blur on the item or not.

CID#

class "CameraPerspectiveAdvanced" "Camera" {
    #version 0.9
    icon "../icons/object_icons/camera_perspective_advanced.iconrc"
    doc "Define a pin-hole camera with advanced settings."
    attribute_group "camera" {
        angle "horizontal_field_of_view" {
            doc "Camera horizontal field of view in degrees. Is deducted from focal length and aperture. Linked to aperture."
            animatable yes
            numeric_range yes 0.01 179.99
            ui_range yes 0.01 179.99
            value 39.5977527090599
        }
        angle "vertical_field_of_view" {
            doc "Camera vertical field of view in degrees. Is deducted from focal length and aperture. Linked to aperture."
            animatable yes
            numeric_range yes 0.01 179.99
            ui_range yes 0.01 179.99
            value 26.9914665615984
        }
        distance "focal_length" {
            doc "Camera focal length. Use this attribute to zoom in and out. Impacts field of view"
            animatable yes
            numeric_range yes 1e-06 3.402823e+38
            ui_range yes 0.001 1
            value 0.05
        }
    }
    attribute_group "camera>film_back" {
        collapsed yes
        distance "horizontal_aperture" {
            doc "Camera horizontal aperture: size of the camera sensor. Linked to field of view"
            animatable yes
            numeric_range yes 1e-06 3.402823e+38
            ui_range yes 0.001 1
            value 0.036
        }
        distance "vertical_aperture" {
            doc "Camera vertical aperture: size of the camera sensor. Linked to field of view"
            animatable yes
            numeric_range yes 1e-06 3.402823e+38
            ui_range yes 0.001 1
            value 0.024
        }
        distance[2] "film_offset" {
            doc "Offset of the camera sensor to the lens. Offsets the frustrum used to compute 3D layers."
            numeric_range yes -0.1 0.1
            ui_range yes -0.01 0.01
            value 0.0 0.0
        }
        double "lens_ratio" {
            doc "Lens squeeze ratio."
            numeric_range yes 0.1 10
            ui_range yes 0.1 10
            value 1
        }
        long "fit_mode" {
            doc "If set to horizontal, vertical or fill, use a square pixel aspect ratio. Vertical or horizontal aperture is recomputed to fit the target image."
            preset "Horizontal" "0"
            preset "Vertical" "1"
            preset "Remap" "2"
            preset "Fill" "3"
            value 0
        }
        double[4] "overscan" {
            hidden yes
            numeric_range yes 0.0 10000
            ui_range yes 0.0 10000
            value 1 0.0 0.0 0.0
        }
    }
    attribute_group "camera>depth_of_field" {
        collapsed yes
        bool "enable_dof" {
            animatable yes
            value no
        }
        double "f_stop" {
            doc "Set the focal ratio. This controls the size of the lens."
            animatable yes
            numeric_range yes 0.01 1000000
            ui_range yes 0.01 64
            read_only yes
            value 5.6
        }
        distance "focus_distance" {
            doc "Set the distance at which the focus is done."
            animatable yes
            numeric_range yes 0.0 1000000
            ui_range yes 0.0 1000
            read_only yes
            value 5
        }
        reference "focus_object" {
            doc "Use the input object to compute the focus distance. If none then focus_distance is used."
            filter "SceneItem"
            input "motion_translate"
            read_only yes
            value ""
        }
    }
}