Camera(ID)#

base classes — bpy_struct, ID

class bpy.types.Camera(ID)#

Camera data-block 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 data-block

Type:

AnimData, (readonly)

background_images#

List of background images

Type:

CameraBackgroundImages bpy_prop_collection of CameraBackgroundImage, (readonly)

central_cylindrical_radius#

Radius of the virtual cylinder

Type:

float in [1e-05, inf], default 1.0

central_cylindrical_range_u_max#

Maximum Longitude value for the central cylindrical lens

Type:

float in [-inf, inf], default 3.14159

central_cylindrical_range_u_min#

Minimum Longitude value for the central cylindrical lens

Type:

float in [-inf, inf], default -3.14159

central_cylindrical_range_v_max#

Maximum Height value for the central cylindrical lens

Type:

float in [-inf, inf], default 1.0

central_cylindrical_range_v_min#

Minimum Height value for the central cylindrical lens

Type:

float in [-inf, inf], default -1.0

clip_end#

Camera far clipping distance

Type:

float in [1e-06, inf], default 1000.0

clip_start#

Camera near clipping distance

Type:

float in [1e-06, inf], default 0.1

display_size#

Apparent size of the Camera object in the 3D View

Type:

float in [0.01, 1000], default 1.0

dof#
Type:

CameraDOFSettings, (readonly)

fisheye_fov#

Field of view for the fisheye lens

Type:

float in [0.1745, 31.4159], default 3.14159

fisheye_lens#

Lens focal length (mm)

Type:

float in [0.01, 100], default 10.5

fisheye_polynomial_k0#

Coefficient K0 of the lens polynomial

Type:

float in [-inf, inf], default -1.17351e-05

fisheye_polynomial_k1#

Coefficient K1 of the lens polynomial

Type:

float in [-inf, inf], default -0.0199887

fisheye_polynomial_k2#

Coefficient K2 of the lens polynomial

Type:

float in [-inf, inf], default -3.3525e-06

fisheye_polynomial_k3#

Coefficient K3 of the lens polynomial

Type:

float in [-inf, inf], default 3.0993e-06

fisheye_polynomial_k4#

Coefficient K4 of the lens polynomial

Type:

float in [-inf, inf], default -2.61e-08

latitude_max#

Maximum latitude (vertical angle) for the equirectangular lens

Type:

float in [-1.5708, 1.5708], default 1.5708

latitude_min#

Minimum latitude (vertical angle) for the equirectangular lens

Type:

float in [-1.5708, 1.5708], default -1.5708

lens#

Perspective Camera focal length value in millimeters

Type:

float in [1, inf], default 50.0

lens_unit#

Unit to edit lens in for the user interface

  • MILLIMETERS Millimeters – Specify focal length of 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’

longitude_max#

Maximum longitude (horizontal angle) for the equirectangular lens

Type:

float in [-inf, inf], default 3.14159

longitude_min#

Minimum longitude (horizontal angle) for the equirectangular lens

Type:

float in [-inf, inf], default -3.14159

ortho_scale#

Orthographic Camera scale (similar to zoom)

Type:

float in [0, inf], default 6.0

panorama_type#

Distortion to use for the calculation

  • EQUIRECTANGULAR Equirectangular – Spherical camera for environment maps, also known as Lat Long panorama.

  • EQUIANGULAR_CUBEMAP_FACE Equiangular Cubemap Face – Single face of an equiangular cubemap.

  • MIRRORBALL Mirror Ball – Mirror ball mapping for environment maps.

  • FISHEYE_EQUIDISTANT Fisheye Equidistant – Ideal for fulldomes, ignore the sensor dimensions.

  • FISHEYE_EQUISOLID Fisheye Equisolid – Similar to most fisheye modern lens, takes sensor dimensions into consideration.

  • FISHEYE_LENS_POLYNOMIAL Fisheye Lens Polynomial – Defines the lens projection as polynomial to allow real world camera lenses to be mimicked.

  • CENTRAL_CYLINDRICAL Central Cylindrical – Projection onto a virtual cylinder from its center, similar as a rotating panoramic camera.

Type:

enum in [‘EQUIRECTANGULAR’, ‘EQUIANGULAR_CUBEMAP_FACE’, ‘MIRRORBALL’, ‘FISHEYE_EQUIDISTANT’, ‘FISHEYE_EQUISOLID’, ‘FISHEYE_LENS_POLYNOMIAL’, ‘CENTRAL_CYLINDRICAL’], default ‘FISHEYE_EQUISOLID’

passepartout_alpha#

Opacity (alpha) of the darkened overlay in Camera view

Type:

float in [0, 1], default 0.5

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 24.0

sensor_width#

Horizontal size of the image sensor area in millimeters

Type:

float in [1, inf], default 36.0

shift_x#

Camera horizontal shift

Type:

float in [-inf, inf], default 0.0

shift_y#

Camera vertical shift

Type:

float in [-inf, inf], default 0.0

show_background_images#

Display reference images behind objects in the 3D View

Type:

boolean, default False

show_composition_center#

Display center composition guide inside the camera view

Type:

boolean, default False

show_composition_center_diagonal#

Display diagonal center composition guide inside the camera view

Type:

boolean, default False

show_composition_golden#

Display golden ratio composition guide inside the camera view

Type:

boolean, default False

show_composition_golden_tria_a#

Display golden triangle A composition guide inside the camera view

Type:

boolean, default False

show_composition_golden_tria_b#

Display golden triangle B composition guide inside the camera view

Type:

boolean, default False

show_composition_harmony_tri_a#

Display harmony A composition guide inside the camera view

Type:

boolean, default False

show_composition_harmony_tri_b#

Display harmony B composition guide inside the camera view

Type:

boolean, default False

show_composition_thirds#

Display rule of thirds composition guide inside the camera view

Type:

boolean, default False

show_limits#

Display the clipping range and focus point on the camera

Type:

boolean, default False

show_mist#

Display 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 True

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

stereo#
Type:

CameraStereoData, (readonly, never None)

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, mathutils.Vector of 3 items in [-inf, inf]

result_2, Result, mathutils.Vector of 3 items in [-inf, inf]

result_3, Result, mathutils.Vector of 3 items in [-inf, inf]

result_4, Result, mathutils.Vector of 3 items in [-inf, inf]

classmethod bl_rna_get_subclass(id, default=None)#
Parameters:

id (str) – The RNA type identifier.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)#
Parameters:

id (str) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties#

Inherited Functions#

References#