Better README

v2
Mattia Iavarone 7 years ago
parent a043f488b6
commit 7411d55855
  1. 28
      README.md

@ -68,11 +68,14 @@ See below for a [list of what was done](#roadmap) and [licensing info](#contribu
- [Capturing Video](#capturing-video) - [Capturing Video](#capturing-video)
- [Other camera events](#other-camera-events) - [Other camera events](#other-camera-events)
- [Gestures](#gestures) - [Gestures](#gestures)
- [Gesture APIs](#gesture-apis)
- [Sizing Behavior](#sizing-behavior) - [Sizing Behavior](#sizing-behavior)
- [Preview Size](#preview-size) - [Preview Size](#preview-size)
- [Capture Size](#capture-size) - [Capture Size](#capture-size)
- [Size APIs](#size-apis)
- [Camera Controls](#camera-controls) - [Camera Controls](#camera-controls)
- [Frame Processing](#frame-processing) - [Frame Processing](#frame-processing)
- [Frame Processing APIs](#frame-processing-apis)
- [Other APIs](#other-apis) - [Other APIs](#other-apis)
- [Permissions Behavior](#permissions-behavior) - [Permissions Behavior](#permissions-behavior)
- [Logging](#logging) - [Logging](#logging)
@ -295,6 +298,13 @@ Simple as that. More gestures are coming. There are two things to be noted:
|`SCROLL_HORIZONTAL` (`cameraGestureScrollHorizontal`)|Horizontal movement gesture.|`zoom` `exposureCorrection` `none`| |`SCROLL_HORIZONTAL` (`cameraGestureScrollHorizontal`)|Horizontal movement gesture.|`zoom` `exposureCorrection` `none`|
|`SCROLL_VERTICAL` (`cameraGestureScrollVertical`)|Vertical movement gesture.|`zoom` `exposureCorrection` `none`| |`SCROLL_VERTICAL` (`cameraGestureScrollVertical`)|Vertical movement gesture.|`zoom` `exposureCorrection` `none`|
### Gesture APIs
|Method|Description|
|------|-----------|
|`mapGesture(Gesture, GestureAction)`|Maps a certain gesture to a certain action. No-op if the action is not supported.|
|`getGestureAction(Gesture)`|Returns the action currently mapped to the given gesture.|
|`clearGesture(Gesture)`|Clears any action mapped to the given gesture.|
## Sizing Behavior ## Sizing Behavior
@ -414,6 +424,16 @@ camera.setPictureSize(result);
camera.setVideoSize(result); camera.setVideoSize(result);
``` ```
### Size APIs
|Method|Description|
|------|-----------|
|`setPictureSize(SizeSelector)`|Provides a size selector for the capture size in `PICTURE` mode.|
|`setVideoSize(SizeSelector)`|Provides a size selector for the capture size in `VIDEO` mode.|
|`getPictureSize()`|Returns the size of the output picture, including any rotation. Returns null in `VIDEO` mode.|
|`getVideoSize()`|Returns the size of the output video, including any rotation. Returns null in `PICTURE` mode.|
|`getSnapshotSize()`|Returns the size of snapshots (pictures or video), including any rotation and cropping.|
## Camera controls ## Camera controls
Most camera parameters can be controlled through XML attributes or linked methods. Most camera parameters can be controlled through XML attributes or linked methods.
@ -601,9 +621,12 @@ apply new data to it. So:
- you can do your job synchronously in the `process()` method - you can do your job synchronously in the `process()` method
- if you must hold the `Frame` instance longer, use `frame = frame.freeze()` to get a frozen instance - if you must hold the `Frame` instance longer, use `frame = frame.freeze()` to get a frozen instance
that will not be affected that will not be affected
### Frame Processing APIs
|Frame API|Type|Description| |Frame API|Type|Description|
|---------|----|-----------| |---------|----|-----------|
|`camera.addFrameProcessor(FrameProcessor)`|`-`|Register a `FrameProcessor`.|
|`frame.getData()`|`byte[]`|The current preview frame, in its original orientation.| |`frame.getData()`|`byte[]`|The current preview frame, in its original orientation.|
|`frame.getTime()`|`long`|The preview timestamp, in `System.currentTimeMillis()` reference.| |`frame.getTime()`|`long`|The preview timestamp, in `System.currentTimeMillis()` reference.|
|`frame.getRotation()`|`int`|The rotation that should be applied to the byte array in order to see what the user sees.| |`frame.getRotation()`|`int`|The rotation that should be applied to the byte array in order to see what the user sees.|
@ -619,9 +642,6 @@ Other APIs not mentioned above are provided, and are well documented and comment
|Method|Description| |Method|Description|
|------|-----------| |------|-----------|
|`isStarted()`|Returns true if `start()` was called succesfully. This does not mean that camera is open or showing preview.| |`isStarted()`|Returns true if `start()` was called succesfully. This does not mean that camera is open or showing preview.|
|`mapGesture(Gesture, GestureAction)`|Maps a certain gesture to a certain action. No-op if the action is not supported.|
|`getGestureAction(Gesture)`|Returns the action currently mapped to the given gesture.|
|`clearGesture(Gesture)`|Clears any action mapped to the given gesture.|
|`getCameraOptions()`|If camera was started, returns non-null object with information about what is supported.| |`getCameraOptions()`|If camera was started, returns non-null object with information about what is supported.|
|`setZoom(float)`, `getZoom()`|Sets a zoom value, where 0 means camera zoomed out and 1 means zoomed in. No-op if zoom is not supported, or camera not started.| |`setZoom(float)`, `getZoom()`|Sets a zoom value, where 0 means camera zoomed out and 1 means zoomed in. No-op if zoom is not supported, or camera not started.|
|`setExposureCorrection(float)`, `getExposureCorrection()`|Sets exposure compensation EV value, in camera stops. No-op if this is not supported. Should be between the bounds returned by CameraOptions.| |`setExposureCorrection(float)`, `getExposureCorrection()`|Sets exposure compensation EV value, in camera stops. No-op if this is not supported. Should be between the bounds returned by CameraOptions.|
@ -630,8 +650,6 @@ Other APIs not mentioned above are provided, and are well documented and comment
|`setLocation(double, double)`|Sets latitude and longitude to be appended to picture/video metadata.| |`setLocation(double, double)`|Sets latitude and longitude to be appended to picture/video metadata.|
|`getLocation()`|Retrieves location data previously applied with setLocation().| |`getLocation()`|Retrieves location data previously applied with setLocation().|
|`startAutoFocus(float, float)`|Starts an autofocus process at the given coordinates, with respect to the view dimensions.| |`startAutoFocus(float, float)`|Starts an autofocus process at the given coordinates, with respect to the view dimensions.|
|`getSnapshotSize()`|Returns the size of snapshots (pictures or video), including any rotation and cropping.|
|`getPictureSize()`|Returns the size of the output picture, including any rotation.|
Take also a look at public methods in `CameraUtils`, `CameraOptions`. Take also a look at public methods in `CameraUtils`, `CameraOptions`.

Loading…
Cancel
Save