TextureView.java revision 451ce44a18e4c48f8a43aa250957f76967a35d31
1aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy/* 2aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Copyright (C) 2011 The Android Open Source Project 3aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 4aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Licensed under the Apache License, Version 2.0 (the "License"); 5aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * you may not use this file except in compliance with the License. 6aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * You may obtain a copy of the License at 7aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 8aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * http://www.apache.org/licenses/LICENSE-2.0 9aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 10aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Unless required by applicable law or agreed to in writing, software 11aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * distributed under the License is distributed on an "AS IS" BASIS, 12aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * See the License for the specific language governing permissions and 14aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * limitations under the License. 15aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 16aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 17aa6c24c21c727a196451332448d4e3b11a80be69Romain Guypackage android.view; 18aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 19aa6c24c21c727a196451332448d4e3b11a80be69Romain Guyimport android.content.Context; 20aa6c24c21c727a196451332448d4e3b11a80be69Romain Guyimport android.graphics.Canvas; 21aa6c24c21c727a196451332448d4e3b11a80be69Romain Guyimport android.graphics.Paint; 22aa6c24c21c727a196451332448d4e3b11a80be69Romain Guyimport android.graphics.SurfaceTexture; 23aa6c24c21c727a196451332448d4e3b11a80be69Romain Guyimport android.util.AttributeSet; 24aa6c24c21c727a196451332448d4e3b11a80be69Romain Guyimport android.util.Log; 25aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 26aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy/** 27aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * <p>A TextureView can be used to display a content stream. Such a content 28aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * stream can for instance be a video or an OpenGL scene. The content stream 29aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * can come from the application's process as well as a remote process.</p> 30aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 31aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * <p>TextureView can only be used in a hardware accelerated window. When 32aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * rendered in software, TextureView will draw nothing.</p> 33aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 34aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * <p>Unlike {@link SurfaceView}, TextureView does not create a separate 35aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * window but behaves as a regular View. This key difference allows a 36aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * TextureView to be moved, transformed, animated, etc. For instance, you 37aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * can make a TextureView semi-translucent by calling 38aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * <code>myView.setAlpha(0.5f)</code>.</p> 39aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 40aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * <p>Using a TextureView is simple: all you need to do is get its 41aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * {@link SurfaceTexture}. The {@link SurfaceTexture} can then be used to 42aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * render content. The following example demonstrates how to render the 43aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * camera preview into a TextureView:</p> 44aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 45aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * <pre> 46aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * public class LiveCameraActivity extends Activity implements TextureView.SurfaceTextureListener { 47aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * private Camera mCamera; 48aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * private TextureView mTextureView; 49aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 50aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * protected void onCreate(Bundle savedInstanceState) { 51aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * super.onCreate(savedInstanceState); 52aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 53aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * mTextureView = new TextureView(this); 54aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * mTextureView.setSurfaceTextureListener(this); 55aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 56aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * setContentView(mTextureView); 57aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * } 58aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 59451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy * public void onSurfaceTextureAvailable(SurfaceTexture surface, int width, int height) { 60aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * mCamera = Camera.open(); 61aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 62aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * try { 63aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * mCamera.setPreviewTexture(surface); 64aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * mCamera.startPreview(); 65aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * } catch (IOException ioe) { 66aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * // Something bad happened 67aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * } 68aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * } 698f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy * 708f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy * public void onSurfaceTextureSizeChanged(SurfaceTexture surface, int width, int height) { 718f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy * // Ignored, Camera does all the work for us 728f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy * } 73451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy * 74451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy * public void onSurfaceTextureDestroyed(SurfaceTexture surface) { 75451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy * mCamera.stopPreview(); 76451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy * mCamera.release(); 77451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy * } 78aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * } 79aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * </pre> 80aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 81aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * <p>A TextureView's SurfaceTexture can be obtained either by invoking 82aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * {@link #getSurfaceTexture()} or by using a {@link SurfaceTextureListener}. 83aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * It is important to know that a SurfaceTexture is available only after the 84aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * TextureView is attached to a window (and {@link #onAttachedToWindow()} has 85aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * been invoked.) It is therefore highly recommended you use a listener to 86aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * be notified when the SurfaceTexture becomes available.</p> 87aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 88aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @see SurfaceView 89aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @see SurfaceTexture 90aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 91aa6c24c21c727a196451332448d4e3b11a80be69Romain Guypublic class TextureView extends View { 92aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy private HardwareLayer mLayer; 93aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy private SurfaceTexture mSurface; 94aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy private SurfaceTextureListener mListener; 95aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 96aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy private final Runnable mUpdateLayerAction = new Runnable() { 97aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy @Override 98aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy public void run() { 99aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy updateLayer(); 100aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 101aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy }; 1028f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy private SurfaceTexture.OnFrameAvailableListener mUpdateListener; 103aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 104aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy /** 105aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Creates a new TextureView. 106aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 107aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @param context The context to associate this view with. 108aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 109aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy public TextureView(Context context) { 110aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy super(context); 111aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy init(); 112aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 113aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 114aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy /** 115aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Creates a new TextureView. 116aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 117aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @param context The context to associate this view with. 118aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @param attrs The attributes of the XML tag that is inflating the view. 119aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 120aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy @SuppressWarnings({"UnusedDeclaration"}) 121aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy public TextureView(Context context, AttributeSet attrs) { 122aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy super(context, attrs); 123aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy init(); 124aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 125aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 126aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy /** 127aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Creates a new TextureView. 128aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 129aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @param context The context to associate this view with. 130aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @param attrs The attributes of the XML tag that is inflating the view. 131aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @param defStyle The default style to apply to this view. If 0, no style 132aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * will be applied (beyond what is included in the theme). This may 133aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * either be an attribute resource, whose value will be retrieved 134aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * from the current theme, or an explicit style resource. 135aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 136aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy @SuppressWarnings({"UnusedDeclaration"}) 137aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy public TextureView(Context context, AttributeSet attrs, int defStyle) { 138aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy super(context, attrs, defStyle); 139aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy init(); 140aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 141aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 142aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy private void init() { 143aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy mLayerPaint = new Paint(); 144aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 145aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 146aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy @Override 147aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy protected void onAttachedToWindow() { 148aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy super.onAttachedToWindow(); 149aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 150aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy if (!isHardwareAccelerated()) { 151aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy Log.w("TextureView", "A TextureView or a subclass can only be " 152aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy + "used with hardware acceleration enabled."); 153aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 154aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 155aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 156451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy @Override 157451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy protected void onDetachedFromWindow() { 158451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy super.onDetachedFromWindow(); 159451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy 160451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy if (isHardwareAccelerated() && mLayer != null) { 161451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy if (mListener != null) { 162451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy mListener.onSurfaceTextureDestroyed(mSurface); 163451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy } 164451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy 165451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy mLayer.destroy(); 166451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy mSurface = null; 167451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy mLayer = null; 168451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy } 169451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy } 170451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy 171aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy /** 172aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * The layer type of a TextureView is ignored since a TextureView is always 173aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * considered to act as a hardware layer. The optional paint supplied to this 174aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * method will however be taken into account when rendering the content of 175aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * this TextureView. 176aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 177aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @param layerType The ype of layer to use with this view, must be one of 178aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * {@link #LAYER_TYPE_NONE}, {@link #LAYER_TYPE_SOFTWARE} or 179aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * {@link #LAYER_TYPE_HARDWARE} 180aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @param paint The paint used to compose the layer. This argument is optional 181aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * and can be null. It is ignored when the layer type is 182aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * {@link #LAYER_TYPE_NONE} 183aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 184aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy @Override 185aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy public void setLayerType(int layerType, Paint paint) { 186aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy if (paint != mLayerPaint) { 187aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy mLayerPaint = paint; 188aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy invalidate(); 189aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 190aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 191aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 192aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy /** 193aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Always returns {@link #LAYER_TYPE_HARDWARE}. 194aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 195aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy @Override 196aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy public int getLayerType() { 197aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy return LAYER_TYPE_HARDWARE; 198aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 199aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 200aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy /** 201aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Calling this method has no effect. 202aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 203aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy @Override 204aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy public void buildLayer() { 205aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 206aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 207aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy /** 208aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Subclasses of TextureView cannot do their own rendering 209aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * with the {@link Canvas} object. 210aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 211aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @param canvas The Canvas to which the View is rendered. 212aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 213aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy @Override 214aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy public final void draw(Canvas canvas) { 215aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy super.draw(canvas); 216aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 217aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 218aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy /** 219aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Subclasses of TextureView cannot do their own rendering 220aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * with the {@link Canvas} object. 221aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 222aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @param canvas The Canvas to which the View is rendered. 223aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 224aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy @Override 225aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy protected final void onDraw(Canvas canvas) { 226aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 227aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 228aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy @Override 2298f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy protected void onSizeChanged(int w, int h, int oldw, int oldh) { 2308f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy super.onSizeChanged(w, h, oldw, oldh); 2318f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy if (mSurface != null) { 2328f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy nSetDefaultBufferSize(mSurface.mSurfaceTexture, getWidth(), getHeight()); 233451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy if (mListener != null) { 234451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy mListener.onSurfaceTextureSizeChanged(mSurface, getWidth(), getHeight()); 235451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy } 2368f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy } 2378f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy } 2388f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy 2398f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy @Override 240aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy HardwareLayer getHardwareLayer() { 241aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy if (mAttachInfo == null || mAttachInfo.mHardwareRenderer == null) { 242aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy return null; 243aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 244aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 245aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy if (mLayer == null) { 246aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy mLayer = mAttachInfo.mHardwareRenderer.createHardwareLayer(); 247aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy mSurface = mAttachInfo.mHardwareRenderer.createSuraceTexture(mLayer); 2488f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy nSetDefaultBufferSize(mSurface.mSurfaceTexture, getWidth(), getHeight()); 249aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 2508f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy mUpdateListener = new SurfaceTexture.OnFrameAvailableListener() { 251aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy @Override 252aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy public void onFrameAvailable(SurfaceTexture surfaceTexture) { 253aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy // Per SurfaceTexture's documentation, the callback may be invoked 254aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy // from an arbitrary thread 255aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy post(mUpdateLayerAction); 256aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 2578f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy }; 2588f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy mSurface.setOnFrameAvailableListener(mUpdateListener); 259aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 260aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy if (mListener != null) { 261451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy mListener.onSurfaceTextureAvailable(mSurface, getWidth(), getHeight()); 262aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 263aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 264aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 265aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy return mLayer; 266aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 267aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 2688f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy @Override 2698f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy protected void onVisibilityChanged(View changedView, int visibility) { 2708f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy super.onVisibilityChanged(changedView, visibility); 2718f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy 2728f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy if (mSurface != null) { 2738f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy // When the view becomes invisible, stop updating it, it's a waste of CPU 2748f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy // To cancel updates, the easiest thing to do is simply to remove the 2758f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy // updates listener 2768f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy if (visibility == VISIBLE) { 2778f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy mSurface.setOnFrameAvailableListener(mUpdateListener); 2788f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy updateLayer(); 2798f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy } else { 2808f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy mSurface.setOnFrameAvailableListener(null); 2818f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy } 2828f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy } 2838f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy } 2848f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy 285aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy private void updateLayer() { 286aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy if (mAttachInfo == null || mAttachInfo.mHardwareRenderer == null) { 287aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy return; 288aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 289aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 2908f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy mAttachInfo.mHardwareRenderer.updateTextureLayer(mLayer, getWidth(), getHeight(), mSurface); 291aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 292aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy invalidate(); 293aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 294aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 295aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy /** 296aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Returns the {@link SurfaceTexture} used by this view. This method 297aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * may return null if the view is not attached to a window. 298aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 299aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy public SurfaceTexture getSurfaceTexture() { 300aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy return mSurface; 301aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 302aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 303aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy /** 304aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Returns the {@link SurfaceTextureListener} currently associated with this 305aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * texture view. 306aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 307aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @see #setSurfaceTextureListener(android.view.TextureView.SurfaceTextureListener) 308aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @see SurfaceTextureListener 309aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 310aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy public SurfaceTextureListener getSurfaceTextureListener() { 311aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy return mListener; 312aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 313aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 314aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy /** 315aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Sets the {@link SurfaceTextureListener} used to listen to surface 316aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * texture events. 317aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 318aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @see #getSurfaceTextureListener() 319aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @see SurfaceTextureListener 320aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 321aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy public void setSurfaceTextureListener(SurfaceTextureListener listener) { 322aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy mListener = listener; 323aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 324aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy 325aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy /** 326aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * This listener can be used to be notified when the surface texture 327aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * associated with this texture view is available. 328aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 329aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy public static interface SurfaceTextureListener { 330aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy /** 331aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * Invoked when a {@link TextureView}'s SurfaceTexture is ready for use. 332aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * 333aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * @param surface The surface returned by 334aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy * {@link android.view.TextureView#getSurfaceTexture()} 335451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy * @param width The width of the surface 336451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy * @param height The height of the surface 337aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy */ 338451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy public void onSurfaceTextureAvailable(SurfaceTexture surface, int width, int height); 3398f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy 3408f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy /** 3418f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy * Invoked when the {@link SurfaceTexture}'s buffers size changed. 3428f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy * 3438f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy * @param surface The surface returned by 3448f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy * {@link android.view.TextureView#getSurfaceTexture()} 3458f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy * @param width The new width of the surface 3468f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy * @param height The new height of the surface 3478f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy */ 3488f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy public void onSurfaceTextureSizeChanged(SurfaceTexture surface, int width, int height); 349451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy 350451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy /** 351451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy * Invoked when the specified {@link SurfaceTexture} is about to be destroyed. 352451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy * After this method is invoked, no rendering should happen inside the surface 353451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy * texture. 354451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy * 355451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy * @param surface The surface about to be destroyed 356451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy */ 357451ce44a18e4c48f8a43aa250957f76967a35d31Romain Guy public void onSurfaceTextureDestroyed(SurfaceTexture surface); 358aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy } 3598f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy 3608f0095cd33558e9cc8a440047908e53b68906f5fRomain Guy private static native void nSetDefaultBufferSize(int surfaceTexture, int width, int height); 361aa6c24c21c727a196451332448d4e3b11a80be69Romain Guy} 362