Camera(ID)

base classes — bpy_struct, ID

class bpy.types.Camera(ID)

Camera datablock for storing camera settings

angle

Camera lens field of view

Type:float in [0.00640536, 3.01675], default 0.0
angle_x

Camera lens horizontal field of view

Type:float in [0.00640536, 3.01675], default 0.0
angle_y

Camera lens vertical field of view

Type:float in [0.00640536, 3.01675], default 0.0
animation_data

Animation data for this datablock

Type:AnimData, (readonly)
clip_end

Camera far clipping distance

Type:float in [1, inf], default 0.0
clip_start

Camera near clipping distance

Type:float in [0.001, inf], default 0.0
cycles

Cycles camera settings

Type:CyclesCameraSettings, (readonly)
dof_distance

Distance to the focus point for depth of field

Type:float in [0, inf], default 0.0
dof_object

Use this object to define the depth of field focal point

Type:Object
draw_size

Apparent size of the Camera object in the 3D View

Type:float in [0.01, 1000], default 0.0
gpu_dof
Type:GPUDOFSettings, (readonly)
lens

Perspective Camera lens value in millimeters

Type:float in [1, inf], default 0.0
lens_unit

Unit to edit lens in for the user interface

  • MILLIMETERS Millimeters, Specify the lens in millimeters.
  • FOV Field of View, Specify the lens as the field of view’s angle.
Type:enum in [‘MILLIMETERS’, ‘FOV’], default ‘MILLIMETERS’
ortho_scale

Orthographic Camera scale (similar to zoom)

Type:float in [0, inf], default 0.0
passepartout_alpha

Opacity (alpha) of the darkened overlay in Camera view

Type:float in [0, 1], default 0.0
sensor_fit

Method to fit image and field of view angle inside the sensor

  • AUTO Auto, Fit to the sensor width or height depending on image resolution.
  • HORIZONTAL Horizontal, Fit to the sensor width.
  • VERTICAL Vertical, Fit to the sensor height.
Type:enum in [‘AUTO’, ‘HORIZONTAL’, ‘VERTICAL’], default ‘AUTO’
sensor_height

Vertical size of the image sensor area in millimeters

Type:float in [1, inf], default 0.0
sensor_width

Horizontal size of the image sensor area in millimeters

Type:float in [1, inf], default 0.0
shift_x

Perspective Camera horizontal shift

Type:float in [-10, 10], default 0.0
shift_y

Perspective Camera vertical shift

Type:float in [-10, 10], default 0.0
show_guide

Draw overlay

Type:enum set in {‘CENTER’, ‘CENTER_DIAGONAL’, ‘THIRDS’, ‘GOLDEN’, ‘GOLDEN_TRIANGLE_A’, ‘GOLDEN_TRIANGLE_B’, ‘HARMONY_TRIANGLE_A’, ‘HARMONY_TRIANGLE_B’}, default {‘CENTER’}
show_limits

Draw the clipping range and focus point on the camera

Type:boolean, default False
show_mist

Draw a line from the Camera to indicate the mist area

Type:boolean, default False
show_name

Show the active Camera’s name in Camera view

Type:boolean, default False
show_passepartout

Show a darkened overlay outside the image area in Camera view

Type:boolean, default False
show_safe_areas

Show TV title safe and action safe areas in Camera view

Type:boolean, default False
show_safe_center

Show safe areas to fit content in a different aspect ratio

Type:boolean, default False
show_sensor

Show sensor size (film gate) in Camera view

Type:boolean, default False
type

Camera types

Type:enum in [‘PERSP’, ‘ORTHO’, ‘PANO’], default ‘PERSP’
view_frame(scene=None)

Return 4 points for the cameras frame (before object transformation)

Parameters:

scene (Scene, (optional)) – Scene to use for aspect calculation, when omitted 1:1 aspect is used
Return (result_1, result_2, result_3, result_4):
 

result_1, Result, float array of 3 items in [-inf, inf]

result_2, Result, float array of 3 items in [-inf, inf]

result_3, Result, float array of 3 items in [-inf, inf]

result_4, Result, float array of 3 items in [-inf, inf]

Inherited Properties

Inherited Functions

References