camera.h revision 66ea3574b6383e4107c74a192cadda1427320375
166ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev/* 266ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * Copyright (C) 2011 The Android Open Source Project 366ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * 466ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * Licensed under the Apache License, Version 2.0 (the "License"); 566ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * you may not use this file except in compliance with the License. 666ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * You may obtain a copy of the License at 766ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * 866ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * http://www.apache.org/licenses/LICENSE-2.0 966ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * 1066ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * Unless required by applicable law or agreed to in writing, software 1166ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * distributed under the License is distributed on an "AS IS" BASIS, 1266ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1366ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * See the License for the specific language governing permissions and 1466ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * limitations under the License. 1566ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev */ 1666ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev 1766ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev#ifndef SYSTEM_CORE_INCLUDE_ANDROID_CAMERA_H 1866ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev#define SYSTEM_CORE_INCLUDE_ANDROID_CAMERA_H 1966ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev 2066ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev#include <stdint.h> 2166ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev#include <sys/cdefs.h> 2266ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev#include <sys/types.h> 2366ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev#include <cutils/native_handle.h> 2466ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev#include <hardware/hardware.h> 2566ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev#include <hardware/gralloc.h> 2666ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev 2766ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev__BEGIN_DECLS 2866ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev 2966ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev/** 3066ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * A set of bit masks for specifying how the received preview frames are 3166ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * handled before the previewCallback() call. 3266ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * 3366ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * The least significant 3 bits of an "int" value are used for this purpose: 3466ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * 3566ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * ..... 0 0 0 3666ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * ^ ^ ^ 3766ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * | | |---------> determine whether the callback is enabled or not 3866ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * | |-----------> determine whether the callback is one-shot or not 3966ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * |-------------> determine whether the frame is copied out or not 4066ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * 4166ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * WARNING: When a frame is sent directly without copying, it is the frame 4266ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * receiver's responsiblity to make sure that the frame data won't get 4366ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * corrupted by subsequent preview frames filled by the camera. This flag is 4466ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * recommended only when copying out data brings significant performance price 4566ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * and the handling/processing of the received frame data is always faster than 4666ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * the preview frame rate so that data corruption won't occur. 4766ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * 4866ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * For instance, 4966ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * 1. 0x00 disables the callback. In this case, copy out and one shot bits 5066ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * are ignored. 5166ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * 2. 0x01 enables a callback without copying out the received frames. A 5266ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * typical use case is the Camcorder application to avoid making costly 5366ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * frame copies. 5466ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * 3. 0x05 is enabling a callback with frame copied out repeatedly. A typical 5566ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * use case is the Camera application. 5666ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * 4. 0x07 is enabling a callback with frame copied out only once. A typical 5766ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * use case is the Barcode scanner application. 5866ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev */ 5966ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev 6066ea3574b6383e4107c74a192cadda1427320375Iliyan Malchevenum { 6166ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_FRAME_CALLBACK_FLAG_ENABLE_MASK = 0x01, 6266ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_FRAME_CALLBACK_FLAG_ONE_SHOT_MASK = 0x02, 6366ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_FRAME_CALLBACK_FLAG_COPY_OUT_MASK = 0x04, 6466ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev /** Typical use cases */ 6566ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_FRAME_CALLBACK_FLAG_NOOP = 0x00, 6666ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_FRAME_CALLBACK_FLAG_CAMCORDER = 0x01, 6766ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_FRAME_CALLBACK_FLAG_CAMERA = 0x05, 6866ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_FRAME_CALLBACK_FLAG_BARCODE_SCANNER = 0x07 6966ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev}; 7066ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev 7166ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev/** msgType in notifyCallback and dataCallback functions */ 7266ea3574b6383e4107c74a192cadda1427320375Iliyan Malchevenum { 7366ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_MSG_ERROR = 0x0001, 7466ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_MSG_SHUTTER = 0x0002, 7566ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_MSG_FOCUS = 0x0004, 7666ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_MSG_ZOOM = 0x0008, 7766ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_MSG_PREVIEW_FRAME = 0x0010, 7866ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_MSG_VIDEO_FRAME = 0x0020, 7966ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_MSG_POSTVIEW_FRAME = 0x0040, 8066ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_MSG_RAW_IMAGE = 0x0080, 8166ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_MSG_COMPRESSED_IMAGE = 0x0100, 8266ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_MSG_RAW_IMAGE_NOTIFY = 0x0200, 8366ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_MSG_ALL_MSGS = 0xFFFF 8466ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev}; 8566ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev 8666ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev/** cmdType in sendCommand functions */ 8766ea3574b6383e4107c74a192cadda1427320375Iliyan Malchevenum { 8866ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_CMD_START_SMOOTH_ZOOM = 1, 8966ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_CMD_STOP_SMOOTH_ZOOM = 2, 9066ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev /** Set the clockwise rotation of preview display (setPreviewDisplay) in 9166ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * degrees. This affects the preview frames and the picture displayed after 9266ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * snapshot. This method is useful for portrait mode applications. Note 9366ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * that preview display of front-facing cameras is flipped horizontally 9466ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * before the rotation, that is, the image is reflected along the central 9566ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * vertical axis of the camera sensor. So the users can see themselves as 9666ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * looking into a mirror. 9766ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * 9866ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * This does not affect the order of byte array of 9966ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * CAMERA_MSG_PREVIEW_FRAME, CAMERA_MSG_VIDEO_FRAME, 10066ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * CAMERA_MSG_POSTVIEW_FRAME, CAMERA_MSG_RAW_IMAGE, or 10166ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * CAMERA_MSG_COMPRESSED_IMAGE. This is not allowed to be set during 10266ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * preview 10366ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev */ 10466ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_CMD_SET_DISPLAY_ORIENTATION = 3, 10566ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev 10666ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev /** cmdType to disable/enable shutter sound. In sendCommand passing arg1 = 10766ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * 0 will disable, while passing arg1 = 1 will enable the shutter sound. 10866ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev */ 10966ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_CMD_ENABLE_SHUTTER_SOUND = 4, 11066ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev 11166ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev /* cmdType to play recording sound */ 11266ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_CMD_PLAY_RECORDING_SOUND = 5, 11366ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev}; 11466ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev 11566ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev/** camera fatal errors */ 11666ea3574b6383e4107c74a192cadda1427320375Iliyan Malchevenum { 11766ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_ERROR_UNKNOWN = 1, 11866ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_ERROR_SERVER_DIED = 100 11966ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev}; 12066ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev 12166ea3574b6383e4107c74a192cadda1427320375Iliyan Malchevenum { 12266ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_FACING_BACK = 0, /** The facing of the camera is opposite to that of 12366ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * the screen. */ 12466ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev CAMERA_FACING_FRONT = 1 /** The facing of the camera is the same as that of 12566ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev * the screen. */ 12666ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev}; 12766ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev 12866ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev__END_DECLS 12966ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev 13066ea3574b6383e4107c74a192cadda1427320375Iliyan Malchev#endif /* SYSTEM_CORE_INCLUDE_ANDROID_CAMERA_H */ 131