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