FocusMeteringAction.Builder
public class FocusMeteringAction.Builder
The builder used to create the FocusMeteringAction.
Summary
Public constructors |
|---|
Builder(@NonNull MeteringPoint point)Creates a Builder from a |
Builder(@NonNull MeteringPoint point, int meteringMode)Creates a Builder from a |
Public methods |
|
|---|---|
@NonNull FocusMeteringAction.Builder |
addPoint(@NonNull MeteringPoint point)Adds another |
@NonNull FocusMeteringAction.Builder |
addPoint(@NonNull MeteringPoint point, int meteringMode)Adds another |
@NonNull FocusMeteringAction |
build()Builds the |
@NonNull FocusMeteringAction.Builder |
Disables the auto-cancel. |
@NonNull FocusMeteringAction.Builder |
setAutoCancelDuration(Sets the auto-cancel duration. |
Public constructors
Builder
public Builder(@NonNull MeteringPoint point)
Creates a Builder from a MeteringPoint with default mode FLAG_AF | FLAG_AE | FLAG_AWB.
Builder
public Builder(@NonNull MeteringPoint point, int meteringMode)
Creates a Builder from a MeteringPoint and MeteringMode.
Metering mode is a combination of flags consisting of FLAG_AF, FLAG_AE, and FLAG_AWB. This combination indicates whether the MeteringPoint is used to set AF(Auto Focus) region, AE(Auto Exposure) region or AWB(Auto White Balance) region.
Public methods
addPoint
public @NonNull FocusMeteringAction.Builder addPoint(@NonNull MeteringPoint point)
Adds another MeteringPoint with default metering mode FLAG_AF | FLAG_AE | FLAG_AWB.
The points added here will be appended in order after the point set in builder constructor.
If more points are added than what current device supports for AF/AE/AWB, only the first point and then in order up to the number of points supported on the device will be enabled.
If none of the points is supported on the device, this FocusMeteringAction will cause startFocusAndMetering to fail.
| See also | |
|---|---|
startFocusAndMetering |
addPoint
public @NonNull FocusMeteringAction.Builder addPoint(@NonNull MeteringPoint point, int meteringMode)
Adds another MeteringPoint with specified meteringMode.
Metering mode is a combination of flags consisting of FLAG_AF, FLAG_AE, and FLAG_AWB. This combination indicates whether the MeteringPoint is used to set AF(Auto Focus) region, AE(Auto Exposure) region or AWB(Auto White Balance) region.
The points added here will be appended in order after the point set in builder constructor.
If more points are added than what current device supports for AF/AE/AWB, only the first point and then in order up to the number of points supported on the device will be enabled.
If none of the points is supported on the device, this FocusMeteringAction will cause startFocusAndMetering to fail.
| See also | |
|---|---|
startFocusAndMetering |
build
public @NonNull FocusMeteringAction build()
Builds the FocusMeteringAction instance.
disableAutoCancel
public @NonNull FocusMeteringAction.Builder disableAutoCancel()
Disables the auto-cancel.
setAutoCancelDuration
public @NonNull FocusMeteringAction.Builder setAutoCancelDuration(
@IntRange(from = 1) long duration,
@NonNull TimeUnit timeUnit
)
Sets the auto-cancel duration. After set, cancelFocusAndMetering will be called in specified duration. By default, auto-cancel is enabled with 5 seconds duration. The duration must be greater than or equal to 1 otherwise it will throw a IllegalArgumentException.