IVideoCameraState Property

Returns the current camera operational state.

Definition

Namespace: ASCOM.Common.DeviceInterfaces
Assembly: ASCOM.Common (in ASCOM.Common.dll) Version: 3.0.0-rc.1+86c25ce733aebb4d8b1b8a62e84770ea5e972bea
C#
VideoCameraState CameraState { get; }

Property Value

VideoCameraState
The state of the camera.

Remarks

Must be implemented, must not throw an ASCOM.NotImplementedException.

Returns one of the following status information:
  • 0 CameraRunning The camera is running and video frames are available for viewing and recording
  • 1 CameraRecording The camera is running and recording a video
  • 2 CameraError Camera error condition serious enough to prevent further operations (connection fail, etc.).

CameraIdle and CameraBusy are optional states. Free running cameras cannot be stopped and don't have a CameraIdle state. When those cameras are powered they immediately enter CameraRunning state. Some digital cameras or video systems may support operations that take longer to complete. While those longer operations are running the camera will remain in the state it was before the operation started.

The video camera state diagram is shown below:

Exceptions

NotConnectedExceptionWhen Connected is False.
DriverExceptionAn error occurred that is not described by one of the more specific ASCOM exceptions. Include sufficient detail in the message text to enable the issue to be accurately diagnosed by someone other than yourself.

Version Information

.NET Standard

Supported in: 2.0

See Also