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

Camera(ID)¶

Previous topic

Next topic

Navigation

Camera(ID)¶

Previous topic

Next topic

Quick search

Navigation