include/android_runtime/android_view_Surface.h

   1 /*
   2  * Copyright (C) 2010 The Android Open Source Project
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 #ifndef _ANDROID_VIEW_SURFACE_H
  18 #define _ANDROID_VIEW_SURFACE_H
  19
  20 #include <android/native_window.h>
  21
  22 #include "jni.h"
  23
  24 namespace android {
  25
  26 class Surface;
  27 class IGraphicBufferProducer;
  28
  29 /**
  30  * Enum mirroring the public API definitions for image and pixel formats.
  31  * Some of these are hidden in the public API
  32  *
  33  * Keep up to date with android.graphics.ImageFormat and
  34  * android.graphics.PixelFormat
  35  */
  36 enum class PublicFormat {
  37     UNKNOWN           = 0x0,
  38     RGBA_8888         = 0x1,
  39     RGBX_8888         = 0x2,
  40     RGB_888           = 0x3,
  41     RGB_565           = 0x4,
  42     NV16              = 0x10,
  43     NV21              = 0x11,
  44     YUY2              = 0x14,
  45     RAW_SENSOR        = 0x20,
  46     PRIVATE           = 0x22,
  47     YUV_420_888       = 0x23,
  48     RAW10             = 0x25,
  49     JPEG              = 0x100,
  50     DEPTH_POINT_CLOUD = 0x101,
  51     YV12              = 0x32315659,
  52     Y8                = 0x20203859, // @hide
  53     Y16               = 0x20363159, // @hide
  54     DEPTH16           = 0x44363159
  55 };
  56
  57 /* Gets the underlying ANativeWindow for a Surface. */
  58 extern sp<ANativeWindow> android_view_Surface_getNativeWindow(
  59         JNIEnv* env, jobject surfaceObj);
  60
  61 /* Returns true if the object is an instance of Surface. */
  62 extern bool android_view_Surface_isInstanceOf(JNIEnv* env, jobject obj);
  63
  64 /* Gets the underlying Surface from a Surface Java object. */
  65 extern sp<Surface> android_view_Surface_getSurface(JNIEnv* env, jobject surfaceObj);
  66
  67 /* Creates a Surface from an IGraphicBufferProducer. */
  68 extern jobject android_view_Surface_createFromIGraphicBufferProducer(JNIEnv* env,
  69         const sp<IGraphicBufferProducer>& bufferProducer);
  70
  71 /* Convert from android.graphics.ImageFormat/PixelFormat enums to graphics.h HAL
  72  * format */
  73 extern int android_view_Surface_mapPublicFormatToHalFormat(PublicFormat f);
  74
  75 /* Convert from android.graphics.ImageFormat/PixelFormat enums to graphics.h HAL
  76  * dataspace */
  77 extern android_dataspace android_view_Surface_mapPublicFormatToHalDataspace(
  78         PublicFormat f);
  79
  80 /* Convert from HAL format, dataspace pair to
  81  * android.graphics.ImageFormat/PixelFormat.
  82  * For unknown/unspecified pairs, returns PublicFormat::UNKNOWN */
  83 extern PublicFormat android_view_Surface_mapHalFormatDataspaceToPublicFormat(
  84         int format, android_dataspace dataSpace);
  85
  86 } // namespace android
  87
  88 #endif // _ANDROID_VIEW_SURFACE_H