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
- background_images#
List of background images
- Type:
CameraBackgroundImages
bpy_prop_collection
ofCameraBackgroundImage
, (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 (string) – The RNA type identifier.
- Returns:
The RNA type or default when not found.
- Return type:
bpy.types.Struct
subclass