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)
-
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
-
cycles
¶ Cycles camera settings
- Type
CyclesCameraSettings
, (readonly)
-
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)
-
lens
¶ Perspective Camera lens 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 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 6.0
-
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 [-10, 10], default 0.0
-
shift_y
¶ Camera vertical shift
- Type
float in [-10, 10], 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, 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]
-
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
-
Inherited Properties
Inherited Functions
References