.. default-domain:: py
.. highlight:: py
.. currentmodule:: SpaceCenter

Camera
======


.. class:: Camera

   Controls the game's camera.
   Obtained by calling :attr:`camera`.

   .. attribute:: mode

      The current mode of the camera.

      :Attribute: Can be read or written
      :rtype: :class:`CameraMode`
      :Game Scenes: Flight

   .. method:: next_camera()

      Switch to the next available camera.
      In flight, this moves to the next flight camera mode. In IVA, it moves the
      view to the next crew member in the active vessel.

      :Game Scenes: Flight

   .. method:: previous_camera()

      Switch to the previous available camera.
      In flight, this moves to the previous flight camera mode. In IVA, it moves
      the view to the previous crew member in the active vessel.

      :Game Scenes: Flight

   .. attribute:: pitch

      The pitch of the camera, in degrees.
      A value between :attr:`Camera.min_pitch` and :attr:`Camera.max_pitch`

      :Attribute: Can be read or written
      :rtype: float
      :Game Scenes: Flight

   .. attribute:: heading

      The heading of the camera, in degrees.

      :Attribute: Can be read or written
      :rtype: float
      :Game Scenes: Flight

   .. attribute:: distance

      The distance from the camera to the subject, in meters.
      A value between :attr:`Camera.min_distance` and :attr:`Camera.max_distance`.

      :Attribute: Can be read or written
      :rtype: float
      :Game Scenes: Flight

   .. attribute:: fo_v

      The Field of View of the camera, in degrees.
      A value between :attr:`Camera.min_fo_v` and :attr:`Camera.max_fo_v`.

      :Attribute: Can be read or written
      :rtype: float
      :Game Scenes: Flight

   .. attribute:: min_pitch

      The minimum pitch of the camera.

      :Attribute: Read-only, cannot be set
      :rtype: float
      :Game Scenes: Flight

   .. attribute:: max_pitch

      The maximum pitch of the camera.

      :Attribute: Read-only, cannot be set
      :rtype: float
      :Game Scenes: Flight

   .. attribute:: min_distance

      Minimum distance from the camera to the subject, in meters.

      :Attribute: Read-only, cannot be set
      :rtype: float
      :Game Scenes: Flight

   .. attribute:: max_distance

      Maximum distance from the camera to the subject, in meters.

      :Attribute: Read-only, cannot be set
      :rtype: float
      :Game Scenes: Flight

   .. attribute:: min_fo_v

      The minimum field of view the camera in degrees.

      :Attribute: Read-only, cannot be set
      :rtype: float
      :Game Scenes: Flight

   .. attribute:: max_fo_v

      The maximum field of view the camera in degrees.

      :Attribute: Read-only, cannot be set
      :rtype: float
      :Game Scenes: Flight

   .. attribute:: default_distance

      Default distance from the camera to the subject, in meters.

      :Attribute: Read-only, cannot be set
      :rtype: float
      :Game Scenes: Flight

   .. attribute:: default_fo_v

      The default field of view the camera in degrees.

      :Attribute: Read-only, cannot be set
      :rtype: float
      :Game Scenes: Flight

   .. attribute:: focussed_body

      In map mode, the celestial body that the camera is focussed on.
      Returns ``None`` if the camera is not focussed on a celestial body.
      Returns an error is the camera is not in map mode.

      :Attribute: Can be read or written
      :rtype: :class:`CelestialBody` or None
      :Game Scenes: Flight

   .. attribute:: focussed_vessel

      In map mode, the vessel that the camera is focussed on.
      Returns ``None`` if the camera is not focussed on a vessel.
      Returns an error is the camera is not in map mode.

      :Attribute: Can be read or written
      :rtype: :class:`Vessel` or None
      :Game Scenes: Flight

   .. attribute:: focussed_node

      In map mode, the maneuver node that the camera is focussed on.
      Returns ``None`` if the camera is not focussed on a maneuver node.
      Returns an error is the camera is not in map mode.

      :Attribute: Can be read or written
      :rtype: :class:`Node` or None
      :Game Scenes: Flight

   .. attribute:: focussed_crew_member

      In IVA mode, the crew member whose view the camera is showing.
      Returns ``None`` if no crew member is in view.
      Returns an error if the camera is not in IVA mode.
      Setting this moves the view to the given crew member, switching the camera to
      IVA mode if it is not already. The crew member must be in the active vessel,
      and in a part whose interior the game has placed them in.

      :Attribute: Can be read or written
      :rtype: :class:`CrewMember` or None
      :Game Scenes: Flight



.. class:: CameraMode

   See :attr:`Camera.mode`.


   .. data:: automatic

      The camera is showing the active vessel, in "auto" mode.


   .. data:: free

      The camera is showing the active vessel, in "free" mode.


   .. data:: chase

      The camera is showing the active vessel, in "chase" mode.


   .. data:: locked

      The camera is showing the active vessel, in "locked" mode.


   .. data:: orbital

      The camera is showing the active vessel, in "orbital" mode.


   .. data:: iva

      The Intra-Vehicular Activity view is being shown.


   .. data:: map

      The map view is being shown.