19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.view; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An instance of this class represents a connection to the surface 2164a55af0ac700baecb0877235eb42caac59a3560Jeff Brown * flinger, from which you can create one or more Surface instances that will 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be composited to the screen. 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2564a55af0ac700baecb0877235eb42caac59a3560Jeff Brownpublic final class SurfaceSession { 2664a55af0ac700baecb0877235eb42caac59a3560Jeff Brown // Note: This field is accessed by native code. 2764a55af0ac700baecb0877235eb42caac59a3560Jeff Brown private int mNativeClient; // SurfaceComposerClient* 280b722fe9ce98d97dbcb6fefd170b85ab7037e528Jeff Brown 2964a55af0ac700baecb0877235eb42caac59a3560Jeff Brown private static native int nativeCreate(); 3064a55af0ac700baecb0877235eb42caac59a3560Jeff Brown private static native void nativeDestroy(int ptr); 3164a55af0ac700baecb0877235eb42caac59a3560Jeff Brown private static native void nativeKill(int ptr); 320b722fe9ce98d97dbcb6fefd170b85ab7037e528Jeff Brown 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Create a new connection with the surface flinger. */ 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public SurfaceSession() { 3564a55af0ac700baecb0877235eb42caac59a3560Jeff Brown mNativeClient = nativeCreate(); 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* no user serviceable parts here ... */ 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() throws Throwable { 410b722fe9ce98d97dbcb6fefd170b85ab7037e528Jeff Brown try { 4264a55af0ac700baecb0877235eb42caac59a3560Jeff Brown if (mNativeClient != 0) { 4364a55af0ac700baecb0877235eb42caac59a3560Jeff Brown nativeDestroy(mNativeClient); 4464a55af0ac700baecb0877235eb42caac59a3560Jeff Brown } 450b722fe9ce98d97dbcb6fefd170b85ab7037e528Jeff Brown } finally { 460b722fe9ce98d97dbcb6fefd170b85ab7037e528Jeff Brown super.finalize(); 470b722fe9ce98d97dbcb6fefd170b85ab7037e528Jeff Brown } 480b722fe9ce98d97dbcb6fefd170b85ab7037e528Jeff Brown } 490b722fe9ce98d97dbcb6fefd170b85ab7037e528Jeff Brown 500b722fe9ce98d97dbcb6fefd170b85ab7037e528Jeff Brown /** 510b722fe9ce98d97dbcb6fefd170b85ab7037e528Jeff Brown * Forcibly detach native resources associated with this object. 520b722fe9ce98d97dbcb6fefd170b85ab7037e528Jeff Brown * Unlike destroy(), after this call any surfaces that were created 5364a55af0ac700baecb0877235eb42caac59a3560Jeff Brown * from the session will no longer work. 540b722fe9ce98d97dbcb6fefd170b85ab7037e528Jeff Brown */ 550b722fe9ce98d97dbcb6fefd170b85ab7037e528Jeff Brown public void kill() { 5664a55af0ac700baecb0877235eb42caac59a3560Jeff Brown nativeKill(mNativeClient); 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 60