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
-
clip_end
¶ Camera far clipping distance
Type: float in [1e-06, inf], default 0.0
-
clip_start
¶ Camera near clipping distance
Type: float in [1e-06, 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
-
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
¶ 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_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
-
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 usedReturn (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