Home | History | Annotate | Download | only in android_runtime
      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     RAW_PRIVATE       = 0x24,
     49     RAW10             = 0x25,
     50     RAW12             = 0x26,
     51     JPEG              = 0x100,
     52     DEPTH_POINT_CLOUD = 0x101,
     53     YV12              = 0x32315659,
     54     Y8                = 0x20203859, // @hide
     55     Y16               = 0x20363159, // @hide
     56     DEPTH16           = 0x44363159
     57 };
     58 
     59 /* Gets the underlying ANativeWindow for a Surface. */
     60 extern sp<ANativeWindow> android_view_Surface_getNativeWindow(
     61         JNIEnv* env, jobject surfaceObj);
     62 
     63 /* Returns true if the object is an instance of Surface. */
     64 extern bool android_view_Surface_isInstanceOf(JNIEnv* env, jobject obj);
     65 
     66 /* Gets the underlying Surface from a Surface Java object. */
     67 extern sp<Surface> android_view_Surface_getSurface(JNIEnv* env, jobject surfaceObj);
     68 
     69 /* Creates a Surface from an IGraphicBufferProducer. */
     70 extern jobject android_view_Surface_createFromIGraphicBufferProducer(JNIEnv* env,
     71         const sp<IGraphicBufferProducer>& bufferProducer);
     72 
     73 /* Convert from android.graphics.ImageFormat/PixelFormat enums to graphics.h HAL
     74  * format */
     75 extern int android_view_Surface_mapPublicFormatToHalFormat(PublicFormat f);
     76 
     77 /* Convert from android.graphics.ImageFormat/PixelFormat enums to graphics.h HAL
     78  * dataspace */
     79 extern android_dataspace android_view_Surface_mapPublicFormatToHalDataspace(
     80         PublicFormat f);
     81 
     82 /* Convert from HAL format, dataspace pair to
     83  * android.graphics.ImageFormat/PixelFormat.
     84  * For unknown/unspecified pairs, returns PublicFormat::UNKNOWN */
     85 extern PublicFormat android_view_Surface_mapHalFormatDataspaceToPublicFormat(
     86         int format, android_dataspace dataSpace);
     87 
     88 } // namespace android
     89 
     90 #endif // _ANDROID_VIEW_SURFACE_H
     91