CameraView/MIGRATION.md

Migrating to v2.X.X

• JpegQuality: both cameraJpegQuality and setJpegQuality() have been removed, because they were working only with specific setups. We'll use the default quality provided by the camera engine.
• CropOutput: both cameraCropOutput and setCropOutput() have been removed. If you want your output to be cropped to match the view bounds, use the *snapshot() APIs.
• ExtraProperties: this has been removed.
• capturePicture(): renamed to takePicture().
• captureSnapshot(): renamed to takePictureSnapshot().
• startCapturingVideo(): renamed to takeVideo(). Signature changed from long to int.
• getPreviewSize(): removed.
• getPictureSize(): the size is now equal to the output picture size (includes rotation).
• getSnapshotSize(): this is the size of pictures taken with takePictureSnapshot() and videos taken with takeVideoSnapshot(). It includes rotation and cropping.
• onVideoTaken(): now passing a VideoResult. Use VideoResult.getFile() to access the video file.
• onPictureTaken(): now passing a PictureResult. Use PictureResult.getJpeg() to access the jpeg stream.
• CameraUtils.BitmapCallback: has been moved in a separate BitmapCallback class.
• isCapturingVideo(): renamed to isTakingVideo().
• SessionType: renamed to Mode. This means that setSessionType() and cameraSessionType are renamed to setMode() and cameraMode.
• CameraOptions.isVideoSnapshotSupported(): removed, this would be ambiguous now. While in video mode, you can only use takePictureSnapshot(), not takePicture().
• takePicture(): will now throw an exception if called when Mode == Mode.VIDEO. You can only take snapshots.
• VideoQuality: this has been removed.
• CameraOptions: methods returning a Set now return a Collection.
• CameraOptions: in addition to getSupportedPictureSizes and getSupportedPictureAspectRatio, now there are video mode equivalents too.
• getPictureSize(): now it returns null when mode == Mode.VIDEO.
• getVideoSize(): added. Returns the size of the capture in video mode. Returns null when mode == Mode.PICTURE.
• VideoSizeSelector: added. It is needed to choose the capture size in VIDEO mode. Defaults to SizeSelectors.biggest(), but you can choose by aspect ratio or whatever.
• isTakingPicture(): added on top of isTakingVideo().
• takeVideoSnapshot(): new api. API 18 and the Gl preview, or it will throw. Respects orientation, videocodec and max duration limit. Automatically rotates the data. Automatically crops the video. NO audio support. NO maxSize limit.
• New cameraPreview XML attribute lets you choose the backing preview engine (surfaceView, textureView, GlSurfaceView). The default is GlSurfaceView and it is highly recommended that you do not change this.
• New pictureRecorder interface for picture capturing.
• Created FullPictureRecorder and SnapshotPictureRecorder for capturing HQ pictures and snapshots.
• When preview is GlSurface, the SnapshotPictureRecorder will use the gl texture and draw it into JPEG. This is really fast and allows us to avoid RotationHelper, creating bitmap copies, OOMs, EXIF stuff.
• When preview is GlSurface, you can take snapshots while recording video (or video snapshots!). TODO: document this
• VideoSnapshots now record audio according to your Audio setting
• VideoSnapshots now respect maxDuration and maxSize limits
• Added videoFrameRate to the videoResult
• TODO: cameraPreview documentation
• TODO: takeVideoSnapshot documentation
• New setVideoBitRate() and setAudioBitRate() (and XML too) options, accepting bits per second values. TODO: document them
• Now default Facing value is not BACK but rather a value that guarantees taht you have cameras (if possible). If device has no BACK cameras, defaults to FRONT.
• Added CameraView.setGridColor() and app:cameraGridColor. TODO: document this
• UI Changes in the demo app, changed controls appearance, added some missing controls. added all information from the VideoResult in the VideoPreviewActivity, same for pictures
• BitmapCallback result is now @Nullable ! This will happen if we encounter an OutOfMemoryError during decoding. You should consider passing a maxWidth and maxHeight instead of loading the full image.
• TODO: add Shape control: RECT and OVAL. Pass this shape around, to the preview and whoever needs it
• TODO: add setPreviewSize API (think about it)
• TODO: fix video recording rotation: with front camera, it does not work.