1 /*
2  * Copyright (C) 2008-2012 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 package android.renderscript;
18 
19 import android.annotation.UnsupportedAppUsage;
20 import android.content.Context;
21 import android.util.AttributeSet;
22 import android.view.SurfaceHolder;
23 import android.view.SurfaceView;
24 
25 /**
26  * @hide
27  * @deprecated in API 16
28  * The Surface View for a graphics renderscript (RenderScriptGL) to draw on.
29  *
30  * <div class="special reference">
31  * <h3>Developer Guides</h3>
32  * <p>For more information about creating an application that uses RenderScript, read the
33  * <a href="{@docRoot}guide/topics/renderscript/index.html">RenderScript</a> developer guide.</p>
34  * </div>
35  */
36 public class RSSurfaceView extends SurfaceView implements SurfaceHolder.Callback {
37     private SurfaceHolder mSurfaceHolder;
38     private RenderScriptGL mRS;
39 
40     /**
41      * @deprecated in API 16
42      * Standard View constructor. In order to render something, you
43      * must call {@link android.opengl.GLSurfaceView#setRenderer} to
44      * register a renderer.
45      */
46     @UnsupportedAppUsage
RSSurfaceView(Context context)47     public RSSurfaceView(Context context) {
48         super(context);
49         init();
50         //Log.v(RenderScript.LOG_TAG, "RSSurfaceView");
51     }
52 
53     /**
54      * @deprecated in API 16
55      * Standard View constructor. In order to render something, you
56      * must call {@link android.opengl.GLSurfaceView#setRenderer} to
57      * register a renderer.
58      */
59     @UnsupportedAppUsage
RSSurfaceView(Context context, AttributeSet attrs)60     public RSSurfaceView(Context context, AttributeSet attrs) {
61         super(context, attrs);
62         init();
63         //Log.v(RenderScript.LOG_TAG, "RSSurfaceView");
64     }
65 
init()66     private void init() {
67         // Install a SurfaceHolder.Callback so we get notified when the
68         // underlying surface is created and destroyed
69         SurfaceHolder holder = getHolder();
70         holder.addCallback(this);
71     }
72 
73     /**
74      * @deprecated in API 16
75      * This method is part of the SurfaceHolder.Callback interface, and is
76      * not normally called or subclassed by clients of RSSurfaceView.
77      */
surfaceCreated(SurfaceHolder holder)78     public void surfaceCreated(SurfaceHolder holder) {
79         mSurfaceHolder = holder;
80     }
81 
82     /**
83      * @deprecated in API 16
84      * This method is part of the SurfaceHolder.Callback interface, and is
85      * not normally called or subclassed by clients of RSSurfaceView.
86      */
surfaceDestroyed(SurfaceHolder holder)87     public void surfaceDestroyed(SurfaceHolder holder) {
88         synchronized (this) {
89             // Surface will be destroyed when we return
90             if (mRS != null) {
91                 mRS.setSurface(null, 0, 0);
92             }
93         }
94     }
95 
96     /**
97      * @deprecated in API 16
98      * This method is part of the SurfaceHolder.Callback interface, and is
99      * not normally called or subclassed by clients of RSSurfaceView.
100      */
surfaceChanged(SurfaceHolder holder, int format, int w, int h)101     public void surfaceChanged(SurfaceHolder holder, int format, int w, int h) {
102         synchronized (this) {
103             if (mRS != null) {
104                 mRS.setSurface(holder, w, h);
105             }
106         }
107     }
108 
109    /**
110      * @deprecated in API 16
111      * Inform the view that the activity is paused. The owner of this view must
112      * call this method when the activity is paused. Calling this method will
113      * pause the rendering thread.
114      * Must not be called before a renderer has been set.
115      */
pause()116     public void pause() {
117         if(mRS != null) {
118             mRS.pause();
119         }
120     }
121 
122     /**
123      * @deprecated in API 16
124      * Inform the view that the activity is resumed. The owner of this view must
125      * call this method when the activity is resumed. Calling this method will
126      * recreate the OpenGL display and resume the rendering
127      * thread.
128      * Must not be called before a renderer has been set.
129      */
resume()130     public void resume() {
131         if(mRS != null) {
132             mRS.resume();
133         }
134     }
135 
136     /**
137      * @deprecated in API 16
138      **/
createRenderScriptGL(RenderScriptGL.SurfaceConfig sc)139     public RenderScriptGL createRenderScriptGL(RenderScriptGL.SurfaceConfig sc) {
140       RenderScriptGL rs = new RenderScriptGL(this.getContext(), sc);
141         setRenderScriptGL(rs);
142         return rs;
143     }
144 
145     /**
146      * @deprecated in API 16
147      **/
destroyRenderScriptGL()148     public void destroyRenderScriptGL() {
149         synchronized (this) {
150             mRS.destroy();
151             mRS = null;
152         }
153     }
154 
155     /**
156      * @deprecated in API 16
157      **/
setRenderScriptGL(RenderScriptGL rs)158     public void setRenderScriptGL(RenderScriptGL rs) {
159         mRS = rs;
160     }
161 
162     /**
163      * @deprecated in API 16
164      **/
getRenderScriptGL()165     public RenderScriptGL getRenderScriptGL() {
166         return mRS;
167     }
168 }
169