org.minetti.astrodevice.common.object
Interface CameraDslrGainCapabilities

All Superinterfaces:

CameraGainCapabilities

public interface CameraDslrGainCapabilities
extends CameraGainCapabilities

Object representing the gain capabilities for DSLR cameras.

Author:

Jean-Philippe MINETTI

Method Summary

List<String>

getGains() Returns the all gains supported by the camera.

Method Detail

getGains

List<String> getGains()

Returns the all gains supported by the camera.

getGains provides a 0-based array of available gain settings. This is often used to specify ISO settings for DSLR cameras. Typically the application software will display the available gain settings in a drop list. The application will then supply the selected index to the driver via the CameraOrbProcess.setGain(long, short) method.

The CameraOrbProcess.setGain(long, short) method may alternatively be called using integer values; Please see CameraAdjustableGainCapabilities for more information.

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.

Returns:

List of gain names.

Throws:

NotConnectedException - Must throw an exception if the information is not available (Some drivers may require an active connection in order to retrieve necessary information from the camera).

PropertyNotImplementedException - Must throw an exception if getGains is not supported.