CameraSensorName Property |
Namespace: ASCOM.DriverAccess
Exception | Condition |
---|---|
PropertyNotImplementedException | Must throw an exception if not supported. |
NotConnectedException | If the device is not connected. |
DriverException | An error occurred that is not described by one of the more specific ASCOM exceptions. The device did not successfully complete the request. |
Must return an empty string if the sensor name is not known.
Returns the name (data sheet part number) of the sensor, e.g. ICX285AL. The format is to be exactly as shown on manufacturer data sheet, subject to the following rules. All letters shall be upper case. Spaces shall not be included.
Any extra suffixes that define region codes, package types, temperature range, coatings, grading, colour/monochrome, etc. shall not be included. For colour sensors, if a suffix differentiates different Bayer matrix encodings, it shall be included.
Examples:
Note:
The most common usage of this property is to select approximate colour balance parameters to be applied to the Bayer matrix of one-shot colour sensors. Application authors should assume that an appropriate IR cut-off filter is in place for colour sensors.
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 for the Camera Interface Version 2 and later.