android_hardware_Camera.cpp revision da57856d749457e495bd860c4ff45aaaf87c9dab
1/* 2** 3** Copyright 2008, The Android Open Source Project 4** 5** Licensed under the Apache License, Version 2.0 (the "License"); 6** you may not use this file except in compliance with the License. 7** You may obtain a copy of the License at 8** 9** http://www.apache.org/licenses/LICENSE-2.0 10** 11** Unless required by applicable law or agreed to in writing, software 12** distributed under the License is distributed on an "AS IS" BASIS, 13** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14** See the License for the specific language governing permissions and 15** limitations under the License. 16*/ 17 18//#define LOG_NDEBUG 0 19#define LOG_TAG "Camera-JNI" 20#include <utils/Log.h> 21 22#include "jni.h" 23#include "JNIHelp.h" 24#include "android_runtime/AndroidRuntime.h" 25 26#include <ui/Surface.h> 27#include <ui/Camera.h> 28#include <utils/IMemory.h> 29 30using namespace android; 31 32struct fields_t { 33 jfieldID context; 34 jfieldID surface; 35 jmethodID post_event; 36}; 37 38static fields_t fields; 39static Mutex sLock; 40 41// provides persistent context for calls from native code to Java 42class JNICameraContext: public CameraListener 43{ 44public: 45 JNICameraContext(JNIEnv* env, jobject weak_this, jclass clazz, const sp<Camera>& camera); 46 ~JNICameraContext() { release(); } 47 virtual void notify(int32_t msgType, int32_t ext1, int32_t ext2); 48 virtual void postData(int32_t msgType, const sp<IMemory>& dataPtr); 49 virtual void postDataTimestamp(nsecs_t timestamp, int32_t msgType, const sp<IMemory>& dataPtr); 50 sp<Camera> getCamera() { Mutex::Autolock _l(mLock); return mCamera; } 51 void release(); 52 53private: 54 void copyAndPost(JNIEnv* env, const sp<IMemory>& dataPtr, int msgType); 55 56 jobject mCameraJObjectWeak; // weak reference to java object 57 jclass mCameraJClass; // strong reference to java class 58 sp<Camera> mCamera; // strong reference to native object 59 Mutex mLock; 60}; 61 62sp<Camera> get_native_camera(JNIEnv *env, jobject thiz, JNICameraContext** pContext) 63{ 64 sp<Camera> camera; 65 Mutex::Autolock _l(sLock); 66 JNICameraContext* context = reinterpret_cast<JNICameraContext*>(env->GetIntField(thiz, fields.context)); 67 if (context != NULL) { 68 camera = context->getCamera(); 69 } 70 LOGV("get_native_camera: context=%p, camera=%p", context, camera.get()); 71 if (camera == 0) { 72 jniThrowException(env, "java/lang/RuntimeException", "Method called after release()"); 73 } 74 75 if (pContext != NULL) *pContext = context; 76 return camera; 77} 78 79JNICameraContext::JNICameraContext(JNIEnv* env, jobject weak_this, jclass clazz, const sp<Camera>& camera) 80{ 81 mCameraJObjectWeak = env->NewGlobalRef(weak_this); 82 mCameraJClass = (jclass)env->NewGlobalRef(clazz); 83 mCamera = camera; 84} 85 86void JNICameraContext::release() 87{ 88 LOGV("release"); 89 Mutex::Autolock _l(mLock); 90 JNIEnv *env = AndroidRuntime::getJNIEnv(); 91 92 if (mCameraJObjectWeak != NULL) { 93 env->DeleteGlobalRef(mCameraJObjectWeak); 94 mCameraJObjectWeak = NULL; 95 } 96 if (mCameraJClass != NULL) { 97 env->DeleteGlobalRef(mCameraJClass); 98 mCameraJClass = NULL; 99 } 100 mCamera.clear(); 101} 102 103void JNICameraContext::notify(int32_t msgType, int32_t ext1, int32_t ext2) 104{ 105 LOGV("notify"); 106 107 // VM pointer will be NULL if object is released 108 Mutex::Autolock _l(mLock); 109 if (mCameraJObjectWeak == NULL) { 110 LOGW("callback on dead camera object"); 111 return; 112 } 113 JNIEnv *env = AndroidRuntime::getJNIEnv(); 114 env->CallStaticVoidMethod(mCameraJClass, fields.post_event, 115 mCameraJObjectWeak, msgType, ext1, ext2); 116} 117 118void JNICameraContext::copyAndPost(JNIEnv* env, const sp<IMemory>& dataPtr, int msgType) 119{ 120 jbyteArray obj = NULL; 121 122 // allocate Java byte array and copy data 123 if (dataPtr != NULL) { 124 ssize_t offset; 125 size_t size; 126 sp<IMemoryHeap> heap = dataPtr->getMemory(&offset, &size); 127 LOGV("postData: off=%d, size=%d", offset, size); 128 uint8_t *heapBase = (uint8_t*)heap->base(); 129 130 if (heapBase != NULL) { 131 const jbyte* data = reinterpret_cast<const jbyte*>(heapBase + offset); 132 obj = env->NewByteArray(size); 133 if (obj == NULL) { 134 LOGE("Couldn't allocate byte array for JPEG data"); 135 env->ExceptionClear(); 136 } else { 137 env->SetByteArrayRegion(obj, 0, size, data); 138 } 139 } else { 140 LOGE("image heap is NULL"); 141 } 142 } 143 144 // post image data to Java 145 env->CallStaticVoidMethod(mCameraJClass, fields.post_event, 146 mCameraJObjectWeak, msgType, 0, 0, obj); 147 if (obj) { 148 env->DeleteLocalRef(obj); 149 } 150} 151 152void JNICameraContext::postData(int32_t msgType, const sp<IMemory>& dataPtr) 153{ 154 // VM pointer will be NULL if object is released 155 Mutex::Autolock _l(mLock); 156 JNIEnv *env = AndroidRuntime::getJNIEnv(); 157 if (mCameraJObjectWeak == NULL) { 158 LOGW("callback on dead camera object"); 159 return; 160 } 161 162 // return data based on callback type 163 switch(msgType) { 164 case CAMERA_MSG_VIDEO_FRAME: 165 // should never happen 166 break; 167 // don't return raw data to Java 168 case CAMERA_MSG_RAW_IMAGE: 169 LOGV("rawCallback"); 170 env->CallStaticVoidMethod(mCameraJClass, fields.post_event, 171 mCameraJObjectWeak, msgType, 0, 0, NULL); 172 break; 173 default: 174 // TODO: Change to LOGV 175 LOGD("dataCallback(%d, %p)", msgType, dataPtr.get()); 176 copyAndPost(env, dataPtr, msgType); 177 break; 178 } 179} 180 181void JNICameraContext::postDataTimestamp(nsecs_t timestamp, int32_t msgType, const sp<IMemory>& dataPtr) 182{ 183 // TODO: plumb up to Java. For now, just drop the timestamp 184 postData(msgType, dataPtr); 185} 186 187// connect to camera service 188static void android_hardware_Camera_native_setup(JNIEnv *env, jobject thiz, jobject weak_this) 189{ 190 sp<Camera> camera = Camera::connect(); 191 192 if (camera == NULL) { 193 jniThrowException(env, "java/lang/RuntimeException", 194 "Fail to connect to camera service"); 195 return; 196 } 197 198 // make sure camera hardware is alive 199 if (camera->getStatus() != NO_ERROR) { 200 jniThrowException(env, "java/lang/RuntimeException", "Camera initialization failed"); 201 return; 202 } 203 204 jclass clazz = env->GetObjectClass(thiz); 205 if (clazz == NULL) { 206 jniThrowException(env, "java/lang/RuntimeException", "Can't find android/hardware/Camera"); 207 return; 208 } 209 210 // We use a weak reference so the Camera object can be garbage collected. 211 // The reference is only used as a proxy for callbacks. 212 sp<JNICameraContext> context = new JNICameraContext(env, weak_this, clazz, camera); 213 context->incStrong(thiz); 214 camera->setListener(context); 215 216 // save context in opaque field 217 env->SetIntField(thiz, fields.context, (int)context.get()); 218} 219 220// disconnect from camera service 221// It's okay to call this when the native camera context is already null. 222// This handles the case where the user has called release() and the 223// finalizer is invoked later. 224static void android_hardware_Camera_release(JNIEnv *env, jobject thiz) 225{ 226 // TODO: Change to LOGV 227 LOGD("release camera"); 228 JNICameraContext* context = NULL; 229 sp<Camera> camera; 230 { 231 Mutex::Autolock _l(sLock); 232 context = reinterpret_cast<JNICameraContext*>(env->GetIntField(thiz, fields.context)); 233 234 // Make sure we do not attempt to callback on a deleted Java object. 235 env->SetIntField(thiz, fields.context, 0); 236 } 237 238 // clean up if release has not been called before 239 if (context != NULL) { 240 camera = context->getCamera(); 241 context->release(); 242 LOGV("native_release: context=%p camera=%p", context, camera.get()); 243 244 // clear callbacks 245 if (camera != NULL) { 246 camera->setPreviewCallbackFlags(FRAME_CALLBACK_FLAG_NOOP); 247 camera->disconnect(); 248 } 249 250 // remove context to prevent further Java access 251 context->decStrong(thiz); 252 } 253} 254 255static void android_hardware_Camera_setPreviewDisplay(JNIEnv *env, jobject thiz, jobject jSurface) 256{ 257 LOGV("setPreviewDisplay"); 258 sp<Camera> camera = get_native_camera(env, thiz, NULL); 259 if (camera == 0) return; 260 261 sp<Surface> surface = NULL; 262 if (jSurface != NULL) { 263 surface = reinterpret_cast<Surface*>(env->GetIntField(jSurface, fields.surface)); 264 } 265 if (camera->setPreviewDisplay(surface) != NO_ERROR) { 266 jniThrowException(env, "java/io/IOException", "setPreviewDisplay failed"); 267 } 268} 269 270static void android_hardware_Camera_startPreview(JNIEnv *env, jobject thiz) 271{ 272 LOGV("startPreview"); 273 sp<Camera> camera = get_native_camera(env, thiz, NULL); 274 if (camera == 0) return; 275 276 if (camera->startPreview() != NO_ERROR) { 277 jniThrowException(env, "java/lang/RuntimeException", "startPreview failed"); 278 return; 279 } 280} 281 282static void android_hardware_Camera_stopPreview(JNIEnv *env, jobject thiz) 283{ 284 LOGV("stopPreview"); 285 sp<Camera> c = get_native_camera(env, thiz, NULL); 286 if (c == 0) return; 287 288 c->stopPreview(); 289} 290 291static bool android_hardware_Camera_previewEnabled(JNIEnv *env, jobject thiz) 292{ 293 LOGV("previewEnabled"); 294 sp<Camera> c = get_native_camera(env, thiz, NULL); 295 if (c == 0) return false; 296 297 return c->previewEnabled(); 298} 299 300static void android_hardware_Camera_setHasPreviewCallback(JNIEnv *env, jobject thiz, jboolean installed, jboolean oneshot) 301{ 302 // Important: Only install preview_callback if the Java code has called 303 // setPreviewCallback() with a non-null value, otherwise we'd pay to memcpy 304 // each preview frame for nothing. 305 JNICameraContext* context; 306 sp<Camera> camera = get_native_camera(env, thiz, &context); 307 if (camera == 0) return; 308 309 int callback_flag; 310 if (installed) { 311 callback_flag = oneshot ? FRAME_CALLBACK_FLAG_BARCODE_SCANNER : FRAME_CALLBACK_FLAG_CAMERA; 312 } else { 313 callback_flag = FRAME_CALLBACK_FLAG_NOOP; 314 } 315 camera->setPreviewCallbackFlags(callback_flag); 316} 317 318static void android_hardware_Camera_autoFocus(JNIEnv *env, jobject thiz) 319{ 320 LOGV("autoFocus"); 321 JNICameraContext* context; 322 sp<Camera> c = get_native_camera(env, thiz, &context); 323 if (c == 0) return; 324 325 if (c->autoFocus() != NO_ERROR) { 326 jniThrowException(env, "java/lang/RuntimeException", "autoFocus failed"); 327 } 328} 329 330static void android_hardware_Camera_takePicture(JNIEnv *env, jobject thiz) 331{ 332 LOGV("takePicture"); 333 JNICameraContext* context; 334 sp<Camera> camera = get_native_camera(env, thiz, &context); 335 if (camera == 0) return; 336 337 if (camera->takePicture() != NO_ERROR) { 338 jniThrowException(env, "java/lang/RuntimeException", "takePicture failed"); 339 return; 340 } 341} 342 343static void android_hardware_Camera_setParameters(JNIEnv *env, jobject thiz, jstring params) 344{ 345 LOGV("setParameters"); 346 sp<Camera> camera = get_native_camera(env, thiz, NULL); 347 if (camera == 0) return; 348 349 const jchar* str = env->GetStringCritical(params, 0); 350 String8 params8; 351 if (params) { 352 params8 = String8(str, env->GetStringLength(params)); 353 env->ReleaseStringCritical(params, str); 354 } 355 if (camera->setParameters(params8) != NO_ERROR) { 356 jniThrowException(env, "java/lang/RuntimeException", "setParameters failed"); 357 return; 358 } 359} 360 361static jstring android_hardware_Camera_getParameters(JNIEnv *env, jobject thiz) 362{ 363 LOGV("getParameters"); 364 sp<Camera> camera = get_native_camera(env, thiz, NULL); 365 if (camera == 0) return 0; 366 367 return env->NewStringUTF(camera->getParameters().string()); 368} 369 370static void android_hardware_Camera_reconnect(JNIEnv *env, jobject thiz) 371{ 372 LOGV("reconnect"); 373 sp<Camera> camera = get_native_camera(env, thiz, NULL); 374 if (camera == 0) return; 375 376 if (camera->reconnect() != NO_ERROR) { 377 jniThrowException(env, "java/io/IOException", "reconnect failed"); 378 return; 379 } 380} 381 382static jint android_hardware_Camera_lock(JNIEnv *env, jobject thiz) 383{ 384 LOGV("lock"); 385 sp<Camera> camera = get_native_camera(env, thiz, NULL); 386 if (camera == 0) return INVALID_OPERATION; 387 return (jint) camera->lock(); 388} 389 390static jint android_hardware_Camera_unlock(JNIEnv *env, jobject thiz) 391{ 392 LOGV("unlock"); 393 sp<Camera> camera = get_native_camera(env, thiz, NULL); 394 if (camera == 0) return INVALID_OPERATION; 395 return (jint) camera->unlock(); 396} 397 398//------------------------------------------------- 399 400static JNINativeMethod camMethods[] = { 401 { "native_setup", 402 "(Ljava/lang/Object;)V", 403 (void*)android_hardware_Camera_native_setup }, 404 { "native_release", 405 "()V", 406 (void*)android_hardware_Camera_release }, 407 { "setPreviewDisplay", 408 "(Landroid/view/Surface;)V", 409 (void *)android_hardware_Camera_setPreviewDisplay }, 410 { "startPreview", 411 "()V", 412 (void *)android_hardware_Camera_startPreview }, 413 { "stopPreview", 414 "()V", 415 (void *)android_hardware_Camera_stopPreview }, 416 { "previewEnabled", 417 "()Z", 418 (void *)android_hardware_Camera_previewEnabled }, 419 { "setHasPreviewCallback", 420 "(ZZ)V", 421 (void *)android_hardware_Camera_setHasPreviewCallback }, 422 { "native_autoFocus", 423 "()V", 424 (void *)android_hardware_Camera_autoFocus }, 425 { "native_takePicture", 426 "()V", 427 (void *)android_hardware_Camera_takePicture }, 428 { "native_setParameters", 429 "(Ljava/lang/String;)V", 430 (void *)android_hardware_Camera_setParameters }, 431 { "native_getParameters", 432 "()Ljava/lang/String;", 433 (void *)android_hardware_Camera_getParameters }, 434 { "reconnect", 435 "()V", 436 (void*)android_hardware_Camera_reconnect }, 437 { "lock", 438 "()I", 439 (void*)android_hardware_Camera_lock }, 440 { "unlock", 441 "()I", 442 (void*)android_hardware_Camera_unlock }, 443}; 444 445struct field { 446 const char *class_name; 447 const char *field_name; 448 const char *field_type; 449 jfieldID *jfield; 450}; 451 452static int find_fields(JNIEnv *env, field *fields, int count) 453{ 454 for (int i = 0; i < count; i++) { 455 field *f = &fields[i]; 456 jclass clazz = env->FindClass(f->class_name); 457 if (clazz == NULL) { 458 LOGE("Can't find %s", f->class_name); 459 return -1; 460 } 461 462 jfieldID field = env->GetFieldID(clazz, f->field_name, f->field_type); 463 if (field == NULL) { 464 LOGE("Can't find %s.%s", f->class_name, f->field_name); 465 return -1; 466 } 467 468 *(f->jfield) = field; 469 } 470 471 return 0; 472} 473 474// Get all the required offsets in java class and register native functions 475int register_android_hardware_Camera(JNIEnv *env) 476{ 477 field fields_to_find[] = { 478 { "android/hardware/Camera", "mNativeContext", "I", &fields.context }, 479 { "android/view/Surface", "mSurface", "I", &fields.surface } 480 }; 481 482 if (find_fields(env, fields_to_find, NELEM(fields_to_find)) < 0) 483 return -1; 484 485 jclass clazz = env->FindClass("android/hardware/Camera"); 486 fields.post_event = env->GetStaticMethodID(clazz, "postEventFromNative", 487 "(Ljava/lang/Object;IIILjava/lang/Object;)V"); 488 if (fields.post_event == NULL) { 489 LOGE("Can't find android/hardware/Camera.postEventFromNative"); 490 return -1; 491 } 492 493 494 // Register native functions 495 return AndroidRuntime::registerNativeMethods(env, "android/hardware/Camera", 496 camMethods, NELEM(camMethods)); 497} 498 499