@ -18,6 +18,7 @@ import com.otaliastudios.cameraview.controls.Control;
import com.otaliastudios.cameraview.controls.Engine ; import com.otaliastudios.cameraview.controls.Engine ;
import com.otaliastudios.cameraview.controls.Facing ; import com.otaliastudios.cameraview.controls.Facing ;
import com.otaliastudios.cameraview.controls.Flash ; import com.otaliastudios.cameraview.controls.Flash ;
import com.otaliastudios.cameraview.controls.PictureFormat ;
import com.otaliastudios.cameraview.controls.Preview ; import com.otaliastudios.cameraview.controls.Preview ;
import com.otaliastudios.cameraview.engine.mappers.Camera1Mapper ; import com.otaliastudios.cameraview.engine.mappers.Camera1Mapper ;
import com.otaliastudios.cameraview.engine.mappers.Camera2Mapper ; import com.otaliastudios.cameraview.engine.mappers.Camera2Mapper ;
@ -44,263 +45,27 @@ import java.util.Set;
/ * * / * *
* Options telling you what is available and what is not . * Options telling you what is available and what is not .
* / * /
public class CameraOptions { public abstract class CameraOptions {
private Set < WhiteBalance > supportedWhiteBalance = new HashSet < > ( 5 ) ; protected Set < WhiteBalance > supportedWhiteBalance = new HashSet < > ( 5 ) ;
private Set < Facing > supportedFacing = new HashSet < > ( 2 ) ; protected Set < Facing > supportedFacing = new HashSet < > ( 2 ) ;
private Set < Flash > supportedFlash = new HashSet < > ( 4 ) ; protected Set < Flash > supportedFlash = new HashSet < > ( 4 ) ;
private Set < Hdr > supportedHdr = new HashSet < > ( 2 ) ; protected Set < Hdr > supportedHdr = new HashSet < > ( 2 ) ;
private Set < Size > supportedPictureSizes = new HashSet < > ( 15 ) ; protected Set < Size > supportedPictureSizes = new HashSet < > ( 15 ) ;
private Set < Size > supportedVideoSizes = new HashSet < > ( 5 ) ; protected Set < Size > supportedVideoSizes = new HashSet < > ( 5 ) ;
private Set < AspectRatio > supportedPictureAspectRatio = new HashSet < > ( 4 ) ; protected Set < AspectRatio > supportedPictureAspectRatio = new HashSet < > ( 4 ) ;
private Set < AspectRatio > supportedVideoAspectRatio = new HashSet < > ( 3 ) ; protected Set < AspectRatio > supportedVideoAspectRatio = new HashSet < > ( 3 ) ;
protected Set < PictureFormat > supportedPictureFormats = new HashSet < > ( 2 ) ;
private boolean zoomSupported ;
private boolean exposureCorrectionSupported ; protected boolean zoomSupported ;
private float exposureCorrectionMinValue ; protected boolean exposureCorrectionSupported ;
private float exposureCorrectionMaxValue ; protected float exposureCorrectionMinValue ;
private boolean autoFocusSupported ; protected float exposureCorrectionMaxValue ;
private float previewFrameRateMinValue ; protected boolean autoFocusSupported ;
private float previewFrameRateMaxValue ; protected float previewFrameRateMinValue ;
protected float previewFrameRateMaxValue ;
public CameraOptions ( @NonNull Camera . Parameters params , int cameraId , boolean flipSizes ) { protected CameraOptions ( ) { }
List < String > strings ;
Camera1Mapper mapper = Camera1Mapper . get ( ) ;
// Facing
Camera . CameraInfo cameraInfo = new Camera . CameraInfo ( ) ;
for ( int i = 0 , count = Camera . getNumberOfCameras ( ) ; i < count ; i + + ) {
Camera . getCameraInfo ( i , cameraInfo ) ;
Facing value = mapper . unmapFacing ( cameraInfo . facing ) ;
if ( value ! = null ) supportedFacing . add ( value ) ;
}
// WB
strings = params . getSupportedWhiteBalance ( ) ;
if ( strings ! = null ) {
for ( String string : strings ) {
WhiteBalance value = mapper . unmapWhiteBalance ( string ) ;
if ( value ! = null ) supportedWhiteBalance . add ( value ) ;
}
}
// Flash
supportedFlash . add ( Flash . OFF ) ;
strings = params . getSupportedFlashModes ( ) ;
if ( strings ! = null ) {
for ( String string : strings ) {
Flash value = mapper . unmapFlash ( string ) ;
if ( value ! = null ) supportedFlash . add ( value ) ;
}
}
// Hdr
supportedHdr . add ( Hdr . OFF ) ;
strings = params . getSupportedSceneModes ( ) ;
if ( strings ! = null ) {
for ( String string : strings ) {
Hdr value = mapper . unmapHdr ( string ) ;
if ( value ! = null ) supportedHdr . add ( value ) ;
}
}
// zoom
zoomSupported = params . isZoomSupported ( ) ;
// autofocus
autoFocusSupported = params . getSupportedFocusModes ( )
. contains ( Camera . Parameters . FOCUS_MODE_AUTO ) ;
// Exposure correction
float step = params . getExposureCompensationStep ( ) ;
exposureCorrectionMinValue = ( float ) params . getMinExposureCompensation ( ) * step ;
exposureCorrectionMaxValue = ( float ) params . getMaxExposureCompensation ( ) * step ;
exposureCorrectionSupported = params . getMinExposureCompensation ( ) ! = 0
| | params . getMaxExposureCompensation ( ) ! = 0 ;
// Picture Sizes
List < Camera . Size > sizes = params . getSupportedPictureSizes ( ) ;
for ( Camera . Size size : sizes ) {
int width = flipSizes ? size . height : size . width ;
int height = flipSizes ? size . width : size . height ;
supportedPictureSizes . add ( new Size ( width , height ) ) ;
supportedPictureAspectRatio . add ( AspectRatio . of ( width , height ) ) ;
}
// Video Sizes
// As a safety measure, remove Sizes bigger than CamcorderProfile.highest
CamcorderProfile profile = CamcorderProfiles . get ( cameraId ,
new Size ( Integer . MAX_VALUE , Integer . MAX_VALUE ) ) ;
Size videoMaxSize = new Size ( profile . videoFrameWidth , profile . videoFrameHeight ) ;
List < Camera . Size > vsizes = params . getSupportedVideoSizes ( ) ;
if ( vsizes ! = null ) {
for ( Camera . Size size : vsizes ) {
if ( size . width < = videoMaxSize . getWidth ( )
& & size . height < = videoMaxSize . getHeight ( ) ) {
int width = flipSizes ? size . height : size . width ;
int height = flipSizes ? size . width : size . height ;
supportedVideoSizes . add ( new Size ( width , height ) ) ;
supportedVideoAspectRatio . add ( AspectRatio . of ( width , height ) ) ;
}
}
} else {
// StackOverflow threads seems to agree that if getSupportedVideoSizes is null,
// previews can be used.
List < Camera . Size > fallback = params . getSupportedPreviewSizes ( ) ;
for ( Camera . Size size : fallback ) {
if ( size . width < = videoMaxSize . getWidth ( )
& & size . height < = videoMaxSize . getHeight ( ) ) {
int width = flipSizes ? size . height : size . width ;
int height = flipSizes ? size . width : size . height ;
supportedVideoSizes . add ( new Size ( width , height ) ) ;
supportedVideoAspectRatio . add ( AspectRatio . of ( width , height ) ) ;
}
}
}
// Preview FPS
previewFrameRateMinValue = Float . MAX_VALUE ;
previewFrameRateMaxValue = - Float . MAX_VALUE ;
List < int [ ] > fpsRanges = params . getSupportedPreviewFpsRange ( ) ;
for ( int [ ] fpsRange : fpsRanges ) {
float lower = ( float ) fpsRange [ 0 ] / 1000F ;
float upper = ( float ) fpsRange [ 1 ] / 1000F ;
previewFrameRateMinValue = Math . min ( previewFrameRateMinValue , lower ) ;
previewFrameRateMaxValue = Math . max ( previewFrameRateMaxValue , upper ) ;
}
}
// Camera2Engine constructor.
@RequiresApi ( Build . VERSION_CODES . LOLLIPOP )
public CameraOptions ( @NonNull CameraManager manager ,
@NonNull String cameraId ,
boolean flipSizes ) throws CameraAccessException {
Camera2Mapper mapper = Camera2Mapper . get ( ) ;
CameraCharacteristics cameraCharacteristics = manager . getCameraCharacteristics ( cameraId ) ;
// Facing
for ( String cameraId1 : manager . getCameraIdList ( ) ) {
CameraCharacteristics cameraCharacteristics1 = manager
. getCameraCharacteristics ( cameraId1 ) ;
Integer cameraFacing = cameraCharacteristics1 . get ( CameraCharacteristics . LENS_FACING ) ;
if ( cameraFacing ! = null ) {
Facing value = mapper . unmapFacing ( cameraFacing ) ;
if ( value ! = null ) supportedFacing . add ( value ) ;
}
}
// WB
int [ ] awbModes = cameraCharacteristics . get (
CameraCharacteristics . CONTROL_AWB_AVAILABLE_MODES ) ;
//noinspection ConstantConditions
for ( int awbMode : awbModes ) {
WhiteBalance value = mapper . unmapWhiteBalance ( awbMode ) ;
if ( value ! = null ) supportedWhiteBalance . add ( value ) ;
}
// Flash
supportedFlash . add ( Flash . OFF ) ;
Boolean hasFlash = cameraCharacteristics . get ( CameraCharacteristics . FLASH_INFO_AVAILABLE ) ;
if ( hasFlash ! = null & & hasFlash ) {
int [ ] aeModes = cameraCharacteristics . get (
CameraCharacteristics . CONTROL_AE_AVAILABLE_MODES ) ;
//noinspection ConstantConditions
for ( int aeMode : aeModes ) {
Set < Flash > flashes = mapper . unmapFlash ( aeMode ) ;
supportedFlash . addAll ( flashes ) ;
}
}
// HDR
supportedHdr . add ( Hdr . OFF ) ;
int [ ] sceneModes = cameraCharacteristics . get (
CameraCharacteristics . CONTROL_AVAILABLE_SCENE_MODES ) ;
//noinspection ConstantConditions
for ( int sceneMode : sceneModes ) {
Hdr value = mapper . unmapHdr ( sceneMode ) ;
if ( value ! = null ) supportedHdr . add ( value ) ;
}
// Zoom
Float maxZoom = cameraCharacteristics . get (
CameraCharacteristics . SCALER_AVAILABLE_MAX_DIGITAL_ZOOM ) ;
if ( maxZoom ! = null ) {
zoomSupported = maxZoom > 1 ;
}
// AutoFocus
// This now means 3A metering with respect to a specific region of the screen.
// Some controls (AF, AE) have special triggers that might or might not be supported.
// But they can also be on some continuous search mode so that the trigger is not needed.
// What really matters in my opinion is the availability of regions.
Integer afRegions = cameraCharacteristics . get ( CameraCharacteristics . CONTROL_MAX_REGIONS_AF ) ;
Integer aeRegions = cameraCharacteristics . get ( CameraCharacteristics . CONTROL_MAX_REGIONS_AE ) ;
Integer awbRegions = cameraCharacteristics . get (
CameraCharacteristics . CONTROL_MAX_REGIONS_AWB ) ;
autoFocusSupported = ( afRegions ! = null & & afRegions > 0 )
| | ( aeRegions ! = null & & aeRegions > 0 )
| | ( awbRegions ! = null & & awbRegions > 0 ) ;
// Exposure correction
Range < Integer > exposureRange = cameraCharacteristics . get (
CameraCharacteristics . CONTROL_AE_COMPENSATION_RANGE ) ;
Rational exposureStep = cameraCharacteristics . get (
CameraCharacteristics . CONTROL_AE_COMPENSATION_STEP ) ;
if ( exposureRange ! = null & & exposureStep ! = null & & exposureStep . floatValue ( ) ! = 0 ) {
exposureCorrectionMinValue = exposureRange . getLower ( ) / exposureStep . floatValue ( ) ;
exposureCorrectionMaxValue = exposureRange . getUpper ( ) / exposureStep . floatValue ( ) ;
}
exposureCorrectionSupported = exposureCorrectionMinValue ! = 0
& & exposureCorrectionMaxValue ! = 0 ;
// Picture Sizes
StreamConfigurationMap streamMap = cameraCharacteristics . get (
CameraCharacteristics . SCALER_STREAM_CONFIGURATION_MAP ) ;
if ( streamMap = = null ) {
throw new RuntimeException ( "StreamConfigurationMap is null. Should not happen." ) ;
}
android . util . Size [ ] psizes = streamMap . getOutputSizes ( ImageFormat . JPEG ) ;
for ( android . util . Size size : psizes ) {
int width = flipSizes ? size . getHeight ( ) : size . getWidth ( ) ;
int height = flipSizes ? size . getWidth ( ) : size . getHeight ( ) ;
supportedPictureSizes . add ( new Size ( width , height ) ) ;
supportedPictureAspectRatio . add ( AspectRatio . of ( width , height ) ) ;
}
// Video Sizes
// As a safety measure, remove Sizes bigger than CamcorderProfile.highest
CamcorderProfile profile = CamcorderProfiles . get ( cameraId ,
new Size ( Integer . MAX_VALUE , Integer . MAX_VALUE ) ) ;
Size videoMaxSize = new Size ( profile . videoFrameWidth , profile . videoFrameHeight ) ;
android . util . Size [ ] vsizes = streamMap . getOutputSizes ( MediaRecorder . class ) ;
for ( android . util . Size size : vsizes ) {
if ( size . getWidth ( ) < = videoMaxSize . getWidth ( )
& & size . getHeight ( ) < = videoMaxSize . getHeight ( ) ) {
int width = flipSizes ? size . getHeight ( ) : size . getWidth ( ) ;
int height = flipSizes ? size . getWidth ( ) : size . getHeight ( ) ;
supportedVideoSizes . add ( new Size ( width , height ) ) ;
supportedVideoAspectRatio . add ( AspectRatio . of ( width , height ) ) ;
}
}
// Preview FPS
Range < Integer > [ ] range = cameraCharacteristics . get (
CameraCharacteristics . CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES ) ;
if ( range ! = null ) {
previewFrameRateMinValue = Float . MAX_VALUE ;
previewFrameRateMaxValue = - Float . MAX_VALUE ;
for ( Range < Integer > fpsRange : range ) {
previewFrameRateMinValue = Math . min ( previewFrameRateMinValue , fpsRange . getLower ( ) ) ;
previewFrameRateMaxValue = Math . max ( previewFrameRateMaxValue , fpsRange . getUpper ( ) ) ;
}
} else {
previewFrameRateMinValue = 0F ;
previewFrameRateMaxValue = 0F ;
}
}
/ * * / * *
* Shorthand for getSupported * ( ) . contains ( value ) . * Shorthand for getSupported * ( ) . contains ( value ) .
@ -308,7 +73,7 @@ public class CameraOptions {
* @param control value to check * @param control value to check
* @return whether it ' s supported * @return whether it ' s supported
* / * /
public boolean supports ( @NonNull Control control ) { public final boolean supports ( @NonNull Control control ) {
return getSupportedControls ( control . getClass ( ) ) . contains ( control ) ; return getSupportedControls ( control . getClass ( ) ) . contains ( control ) ;
} }
@ -319,7 +84,7 @@ public class CameraOptions {
* @param action value to be checked * @param action value to be checked
* @return whether it ' s supported * @return whether it ' s supported
* / * /
public boolean supports ( @NonNull GestureAction action ) { public final boolean supports ( @NonNull GestureAction action ) {
switch ( action ) { switch ( action ) {
case AUTO_FOCUS : case AUTO_FOCUS :
return isAutoFocusSupported ( ) ; return isAutoFocusSupported ( ) ;
@ -338,7 +103,8 @@ public class CameraOptions {
@SuppressWarnings ( "unchecked" ) @SuppressWarnings ( "unchecked" )
@NonNull @NonNull
public < T extends Control > Collection < T > getSupportedControls ( @NonNull Class < T > controlClass ) { public final < T extends Control > Collection < T > getSupportedControls (
@NonNull Class < T > controlClass ) {
if ( controlClass . equals ( Audio . class ) ) { if ( controlClass . equals ( Audio . class ) ) {
return ( Collection < T > ) Arrays . asList ( Audio . values ( ) ) ; return ( Collection < T > ) Arrays . asList ( Audio . values ( ) ) ;
} else if ( controlClass . equals ( Facing . class ) ) { } else if ( controlClass . equals ( Facing . class ) ) {
@ -359,6 +125,8 @@ public class CameraOptions {
return ( Collection < T > ) Arrays . asList ( Engine . values ( ) ) ; return ( Collection < T > ) Arrays . asList ( Engine . values ( ) ) ;
} else if ( controlClass . equals ( Preview . class ) ) { } else if ( controlClass . equals ( Preview . class ) ) {
return ( Collection < T > ) Arrays . asList ( Preview . values ( ) ) ; return ( Collection < T > ) Arrays . asList ( Preview . values ( ) ) ;
} else if ( controlClass . equals ( PictureFormat . class ) ) {
return ( Collection < T > ) getSupportedPictureFormats ( ) ;
} }
// Unrecognized control.
// Unrecognized control.
return Collections . emptyList ( ) ; return Collections . emptyList ( ) ;
@ -370,7 +138,7 @@ public class CameraOptions {
* @return a collection of supported values . * @return a collection of supported values .
* / * /
@NonNull @NonNull
public Collection < Size > getSupportedPictureSizes ( ) { public final Collection < Size > getSupportedPictureSizes ( ) {
return Collections . unmodifiableSet ( supportedPictureSizes ) ; return Collections . unmodifiableSet ( supportedPictureSizes ) ;
} }
@ -379,9 +147,8 @@ public class CameraOptions {
* *
* @return a collection of supported values . * @return a collection of supported values .
* / * /
@SuppressWarnings ( "WeakerAccess" )
@NonNull @NonNull
public Collection < AspectRatio > getSupportedPictureAspectRatios ( ) { public final Collection < AspectRatio > getSupportedPictureAspectRatios ( ) {
return Collections . unmodifiableSet ( supportedPictureAspectRatio ) ; return Collections . unmodifiableSet ( supportedPictureAspectRatio ) ;
} }
@ -391,7 +158,7 @@ public class CameraOptions {
* @return a collection of supported values . * @return a collection of supported values .
* / * /
@NonNull @NonNull
public Collection < Size > getSupportedVideoSizes ( ) { public final Collection < Size > getSupportedVideoSizes ( ) {
return Collections . unmodifiableSet ( supportedVideoSizes ) ; return Collections . unmodifiableSet ( supportedVideoSizes ) ;
} }
@ -400,9 +167,8 @@ public class CameraOptions {
* *
* @return a set of supported values . * @return a set of supported values .
* / * /
@SuppressWarnings ( "WeakerAccess" )
@NonNull @NonNull
public Collection < AspectRatio > getSupportedVideoAspectRatios ( ) { public final Collection < AspectRatio > getSupportedVideoAspectRatios ( ) {
return Collections . unmodifiableSet ( supportedVideoAspectRatio ) ; return Collections . unmodifiableSet ( supportedVideoAspectRatio ) ;
} }
@ -414,7 +180,7 @@ public class CameraOptions {
* @return a collection of supported values . * @return a collection of supported values .
* / * /
@NonNull @NonNull
public Collection < Facing > getSupportedFacing ( ) { public final Collection < Facing > getSupportedFacing ( ) {
return Collections . unmodifiableSet ( supportedFacing ) ; return Collections . unmodifiableSet ( supportedFacing ) ;
} }
@ -428,7 +194,7 @@ public class CameraOptions {
* @return a collection of supported values . * @return a collection of supported values .
* / * /
@NonNull @NonNull
public Collection < Flash > getSupportedFlash ( ) { public final Collection < Flash > getSupportedFlash ( ) {
return Collections . unmodifiableSet ( supportedFlash ) ; return Collections . unmodifiableSet ( supportedFlash ) ;
} }
@ -443,7 +209,7 @@ public class CameraOptions {
* @return a collection of supported values . * @return a collection of supported values .
* / * /
@NonNull @NonNull
public Collection < WhiteBalance > getSupportedWhiteBalance ( ) { public final Collection < WhiteBalance > getSupportedWhiteBalance ( ) {
return Collections . unmodifiableSet ( supportedWhiteBalance ) ; return Collections . unmodifiableSet ( supportedWhiteBalance ) ;
} }
@ -454,19 +220,30 @@ public class CameraOptions {
* @see Hdr # ON * @see Hdr # ON
* @return a collection of supported values . * @return a collection of supported values .
* / * /
@SuppressWarnings ( "WeakerAccess" )
@NonNull @NonNull
public Collection < Hdr > getSupportedHdr ( ) { public final Collection < Hdr > getSupportedHdr ( ) {
return Collections . unmodifiableSet ( supportedHdr ) ; return Collections . unmodifiableSet ( supportedHdr ) ;
} }
/ * *
* Set of supported picture formats .
*
* @see PictureFormat # JPEG
* @see PictureFormat # DNG
* @return a collection of supported values .
* /
@NonNull
public final Collection < PictureFormat > getSupportedPictureFormats ( ) {
return Collections . unmodifiableSet ( supportedPictureFormats ) ;
}
/ * * / * *
* Whether zoom is supported . If this is false , pinch - to - zoom * Whether zoom is supported . If this is false , pinch - to - zoom
* will not work and { @link CameraView # setZoom ( float ) } will have no effect . * will not work and { @link CameraView # setZoom ( float ) } will have no effect .
* *
* @return whether zoom is supported . * @return whether zoom is supported .
* / * /
public boolean isZoomSupported ( ) { public final boolean isZoomSupported ( ) {
return zoomSupported ; return zoomSupported ;
} }
@ -478,7 +255,7 @@ public class CameraOptions {
* *
* @return whether auto focus is supported . * @return whether auto focus is supported .
* / * /
public boolean isAutoFocusSupported ( ) { public final boolean isAutoFocusSupported ( ) {
return autoFocusSupported ; return autoFocusSupported ;
} }
@ -490,7 +267,7 @@ public class CameraOptions {
* @see # getExposureCorrectionMaxValue ( ) * @see # getExposureCorrectionMaxValue ( )
* @return whether exposure correction is supported . * @return whether exposure correction is supported .
* / * /
public boolean isExposureCorrectionSupported ( ) { public final boolean isExposureCorrectionSupported ( ) {
return exposureCorrectionSupported ; return exposureCorrectionSupported ;
} }
@ -500,7 +277,7 @@ public class CameraOptions {
* *
* @return min EV value * @return min EV value
* / * /
public float getExposureCorrectionMinValue ( ) { public final float getExposureCorrectionMinValue ( ) {
return exposureCorrectionMinValue ; return exposureCorrectionMinValue ;
} }
@ -511,7 +288,7 @@ public class CameraOptions {
* *
* @return max EV value * @return max EV value
* / * /
public float getExposureCorrectionMaxValue ( ) { public final float getExposureCorrectionMaxValue ( ) {
return exposureCorrectionMaxValue ; return exposureCorrectionMaxValue ;
} }
@ -520,7 +297,7 @@ public class CameraOptions {
* *
* @return the min value * @return the min value
* / * /
public float getPreviewFrameRateMinValue ( ) { public final float getPreviewFrameRateMinValue ( ) {
return previewFrameRateMinValue ; return previewFrameRateMinValue ;
} }
@ -529,7 +306,7 @@ public class CameraOptions {
* *
* @return the max value * @return the max value
* / * /
public float getPreviewFrameRateMaxValue ( ) { public final float getPreviewFrameRateMaxValue ( ) {
return previewFrameRateMaxValue ; return previewFrameRateMaxValue ;
} }
} }
Mattia Iavarone
5 years ago
committed by
GitHub