diff options
author | Wu-cheng Li <wuchengli@google.com> | 2010-08-12 14:07:59 -0700 |
---|---|---|
committer | Android Git Automerger <android-git-automerger@android.com> | 2010-08-12 14:07:59 -0700 |
commit | fd83b2f92edf3d1f95161ad3cb2b45826bad6e35 (patch) | |
tree | 2120f7e924f87a35a0c2f033082d1d6020b9de48 /include | |
parent | 465206940acade296a1064ac5a1fbcd0419d9eb6 (diff) | |
parent | 77a473fbcea0214832255af91e0a65d853757aae (diff) | |
download | frameworks_base-fd83b2f92edf3d1f95161ad3cb2b45826bad6e35.zip frameworks_base-fd83b2f92edf3d1f95161ad3cb2b45826bad6e35.tar.gz frameworks_base-fd83b2f92edf3d1f95161ad3cb2b45826bad6e35.tar.bz2 |
am 77a473fb: am ccaa0028: Merge "Improve camera documentation." into gingerbread
Merge commit '77a473fbcea0214832255af91e0a65d853757aae'
* commit '77a473fbcea0214832255af91e0a65d853757aae':
Improve camera documentation.
Diffstat (limited to 'include')
-rw-r--r-- | include/camera/CameraParameters.h | 30 |
1 files changed, 17 insertions, 13 deletions
diff --git a/include/camera/CameraParameters.h b/include/camera/CameraParameters.h index b2808f5..bed174b 100644 --- a/include/camera/CameraParameters.h +++ b/include/camera/CameraParameters.h @@ -188,10 +188,9 @@ public: // Supported flash modes. // Example value: "auto,on,off". Read only. static const char KEY_SUPPORTED_FLASH_MODES[]; - // Current focus mode. If the camera does not support auto-focus, the value - // should be FOCUS_MODE_FIXED. If the focus mode is not FOCUS_MODE_FIXED or - // or FOCUS_MODE_INFINITY, applications should call - // CameraHardwareInterface.autoFocus to start the focus. + // Current focus mode. This will not be empty. Applications should call + // CameraHardwareInterface.autoFocus to start the focus if focus mode is + // FOCUS_MODE_AUTO or FOCUS_MODE_MACRO. // Example value: "auto" or FOCUS_MODE_XXX constants. Read/write. static const char KEY_FOCUS_MODE[]; // Supported focus modes. @@ -248,11 +247,16 @@ public: // be in focus. The object is sharpest at the optimal focus distance. The // depth of field is the far focus distance minus near focus distance. // - // Applications can read this parameter anytime to get the latest focus - // distances. If the focus mode is FOCUS_MODE_EDOF, the values may be all - // 0, which means focus distance is not applicable. If the focus mode is - // FOCUS_MODE_CONTINUOUS and autofocus has started, focus distances may - // change from time to time. + // Focus distances may change after starting auto focus, canceling auto + // focus, or starting the preview. Applications can read this anytime to get + // the latest focus distances. If the focus mode is FOCUS_MODE_CONTINUOUS, + // focus distances may change from time to time. + // + // This is intended to estimate the distance between the camera and the + // subject. After autofocus, the subject distance may be within near and far + // focus distance. However, the precision depends on the camera hardware, + // autofocus algorithm, the focus area, and the scene. The error can be + // large and it should be only used as a reference. // // Far focus distance > optimal focus distance > near focus distance. If // the far focus distance is infinity, the value should be "Infinity" (case @@ -365,10 +369,10 @@ public: // continuously. Applications should not call // CameraHardwareInterface.autoFocus in this mode. static const char FOCUS_MODE_EDOF[]; - // Continuous focus mode. The camera continuously tries to focus. This is - // ideal for shooting video or shooting photo of moving object. Continuous - // focus starts when CameraHardwareInterface.autoFocus is called. Focus - // callback will be only called once as soon as the picture is in focus. + // Continuous auto focus mode. The camera continuously tries to focus. This + // is ideal for shooting video or shooting photo of moving object. Auto + // focus starts when the parameter is set. Applications should not call + // CameraHardwareInterface.autoFocus in this mode. static const char FOCUS_MODE_CONTINUOUS[]; // The camera determines the exposure by giving more weight to the |