CBLExposureProperty

Objective-C

@protocol CBLExposureProperty <CBLCameraProperty>

Swift

protocol ExposureProperty : CameraProperty

A property that exposes its values as universal exposure values.

  • Returns the current value as a universal exposure value.

    Declaration

    Objective-C

    @property (nonatomic, copy, readonly, nullable) id<CBLExposurePropertyValue> currentExposureValue;

    Swift

    @NSCopying var currentExposureValue: (any ExposurePropertyValue)? { get }

  • Returns the valid settable values as an array of universal exposure values.

    Declaration

    Objective-C

    @property (nonatomic, copy, readonly, nullable) NSArray<id<CBLExposurePropertyValue>> *validSettableExposureValues;

    Swift

    var validSettableExposureValues: [any ExposurePropertyValue]? { get }

  • Guaranteed to return a non-nil value if validSettableValues isn’t empty.

    Declaration

    Objective-C

    @property (nonatomic, copy, readonly, nullable) id<CBLExposurePropertyValue> validZeroValue;

    Swift

    @NSCopying var validZeroValue: (any ExposurePropertyValue)? { get }

  • Returns the value in validSettableValues that, when set, will cause the camera to attempt to derive the value for this property automatically.

    If there is no such value, returns nil.

    Declaration

    Objective-C

    @property (nonatomic, copy, readonly, nullable) id<CBLExposurePropertyValue> validAutomaticValue;

    Swift

    @NSCopying var validAutomaticValue: (any ExposurePropertyValue)? { get }

  • Attempt to find a valid settable value for the given exposure value.

    Declaration

    Objective-C

    - (id<CBLExposurePropertyValue> _Nullable)validValueMatchingExposureValue:
    (id<CBLUniversalExposurePropertyValue> _Nonnull)exposureValue;

    Swift

    func validValue(matchingExposureValue exposureValue: any CBLUniversalExposurePropertyValue) -> (any ExposurePropertyValue)?

    Parameters

    exposureValue

    The exposure value to find a value for. The type must match the property identifier.

    Return Value

    Returns a valid settable value for the given exposure value, or nil if no value matches.