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     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
     89