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/**
18 * @addtogroup NativeActivity Native Activity
19 * @{
20 */
21
22/**
23 * @file native_window_jni.h
24 */
25
26#ifndef ANDROID_NATIVE_WINDOW_JNI_H
27#define ANDROID_NATIVE_WINDOW_JNI_H
28
29#include <sys/cdefs.h>
30
31#include <android/native_window.h>
32
33#include <jni.h>
34
35#ifdef __cplusplus
36extern "C" {
37#endif
38
39/**
40 * Return the ANativeWindow associated with a Java Surface object,
41 * for interacting with it through native code.  This acquires a reference
42 * on the ANativeWindow that is returned; be sure to use ANativeWindow_release()
43 * when done with it so that it doesn't leak.
44 */
45ANativeWindow* ANativeWindow_fromSurface(JNIEnv* env, jobject surface);
46
47#if __ANDROID_API__ >= 13
48/**
49 * Return the ANativeWindow associated with a Java SurfaceTexture object,
50 * for interacting with it through native code.  This acquires a reference
51 * on the ANativeWindow that is returned; be sure to use ANativeWindow_release()
52 * when done with it so that it doesn't leak.
53 */
54ANativeWindow* ANativeWindow_fromSurfaceTexture(JNIEnv* env, jobject surfaceTexture);
55#endif
56
57#if __ANDROID_API__ >= 26
58/**
59 * Return a Java Surface object derived from the ANativeWindow, for interacting
60 * with it through Java code. The returned Java object acquires a reference on
61 * the ANativeWindow; maintains it through general Java object's life cycle;
62 * and will automatically release the reference when the Java object gets garbage
63 * collected.
64 */
65jobject ANativeWindow_toSurface(JNIEnv* env, ANativeWindow* window);
66#endif
67
68#ifdef __cplusplus
69};
70#endif
71
72#endif // ANDROID_NATIVE_WINDOW_H
73
74/** @} */
75