# 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)

  `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`

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

`bpy_struct.id_data` `ID.name` `ID.users` `ID.use_fake_user` `ID.tag` | `ID.is_updated` `ID.is_updated_data` `ID.is_library_indirect` `ID.library` `ID.preview`

Inherited Functions

`bpy_struct.as_pointer` `bpy_struct.driver_add` `bpy_struct.driver_remove` `bpy_struct.get` `bpy_struct.is_property_hidden` `bpy_struct.is_property_readonly` `bpy_struct.is_property_set` `bpy_struct.items` `bpy_struct.keyframe_delete` `bpy_struct.keyframe_insert` `bpy_struct.keys` | `bpy_struct.path_from_id` `bpy_struct.path_resolve` `bpy_struct.property_unset` `bpy_struct.type_recast` `bpy_struct.values` `ID.copy` `ID.user_clear` `ID.animation_data_create` `ID.animation_data_clear` `ID.update_tag`

References

`bpy.context.camera` `BlendData.cameras` | `BlendDataCameras.new` `BlendDataCameras.remove`