Click or drag to resize

ICameraV3Gains Property

This is an existing ICameraV2 property and its interface definition has not been changed. The Remarks section has been clarified to describe the two gain management modes.

List of Gain names supported by the camera

Namespace:  ASCOM.DeviceInterface
Assembly:  ASCOM.DeviceInterfaces (in ASCOM.DeviceInterfaces.dll) Version: 3c9121baba46811fe6e53a58a05935662261416d
Syntax
ArrayList Gains { get; }

Return Value

Type: ArrayList
Thed list of supported gain names as an ArrayList of strings
Exceptions
ExceptionCondition
PropertyNotImplementedExceptionWhen the Gain property is not implemented or is operating in GAIN VALUE mode.
NotConnectedExceptionWhen the information is not available. (Some drivers may require an active connection in order to retrieve necessary information from the camera.)
Remarks

This is an optional property and can throw a PropertyNotImplementedException.

When Gain is operating in GAINS INDEX mode:

The returned gain names could, for example, be a list of ISO settings for a DSLR camera or a list of gain names for a CMOS camera. Typically the application software will display the returned gain names in a drop list, from which the astronomer can select the required value. The application can then configure the required gain by setting the camera's Gain property to the array index of the selected description.

It is recommended that this function be called only after a connection is established with the camera hardware to ensure that the driver is aware of the capabilities of the specific camera model.

This is only available in Camera Interface Version 2 and later.

See Also