Android图形系统之Surface、SurfaceView、SurfaceHolder及SurfaceHolder.Callback之间的联系

/********************************************************************************************
* author:conowen@大钟
* E-mail:conowen@hotmail.com
* http://blog.csdn.net/conowen
* 注:本文为原创,仅作为学习交流使用,转载请标明作者及出处。

********************************************************************************************/


1、Surface


Surface

extends Object
implements Parcelable
java.lang.Object
android.view.Surface

Class Overview


Handle onto a raw buffer that is being managed by the screen compositor.

简单翻译:

Surface是原始图像缓冲区(raw buffer)的一个句柄,而原始图像缓冲区是由屏幕图像合成器(screen compositor)管理的。




1.1、 就如在C语言编程一样,通过一个文件的句柄,就可以操作文件,获取文件的内容。 同样的,通过Surface就可以获取raw buffer其中的内容。原生缓冲区(raw buffer)存储着当前窗口的像素数据。


1.2、事实上,当得到一个Surface对象时,同时会得到一个Canvas(画布)对象。这一点可以通过查看\frameworks\base\core\java\android\view\Surface.java文件可知道Surface类定义了一个Canvas成员变量


    //@\frameworks\base\core\java\android\view\Surface.java
    // The mSurfaceControl will only be present for Surfaces used by the window
    // server or system processes. When this class is parceled we defer to the
    // mSurfaceControl to do the parceling. Otherwise we parcel the
    // mNativeSurface.
    private int mSurfaceControl;
    private int mSaveCount;
    private Canvas mCanvas;
    private int mNativeSurface;
    private int mSurfaceGenerationId;
    private String mName;

1.3、 理解Canvas对象,可以把它当做画布,Canvas的方法大多数是设置画布的大小、形状、画布背景颜色等等,要想在画布上面画画,一般要与Paint对象结合使用,顾名思义,Paint就是画笔的风格,颜料的色彩之类的。

        // 创建画笔  
        Paint paint = new Paint();  
        paint.setColor(Color.RED);// 设置红色  

        canvas.drawCircle(60, 20, 10, paint);// 画一个圆  


1.4、Surface本身的作用类似一个句柄,得到了这个句柄就可以得到其中的Canvas、原生缓冲器以及其它方面的内容。


1.5、Surface实现了Parcelable接口,(implements Parcelable),也就是说Surface对象可以把显示内容的数据写入到 Parcel 中,并且能够从Parcel读回数据。

Parcelable

android.os.Parcelable
Known Indirect Subclasses

Class Overview


Interface for classes whose instances can be written to and restored from a Parcel. Classes implementing the Parcelable interface must also have a static field calledCREATOR, which is an object implementing theParcelable.Creator interface.

简单翻译:
实现这个接口的对象可以写入数据到Parcel,同时也可以把数据读出来。



2、SurfaceView


SurfaceView

extends View
java.lang.Object
android.view.View
android.view.SurfaceView
Known Direct Subclasses

Class Overview


Provides a dedicated drawing surface embedded inside of a view hierarchy. You can control the format of this surface and, if you like, its size; the SurfaceView takes care of placing the surface at the correct location on the screen

The surface is Z ordered so that it is behind the window holding its SurfaceView; the SurfaceView punches a hole in its window to allow its surface to be displayed. The view hierarchy will take care of correctly compositing with the Surface any siblings of the SurfaceView that would normally appear on top of it. This can be used to place overlays such as buttons on top of the Surface, though note however that it can have an impact on performance since a full alpha-blended composite will be performed each time the Surface changes.

Access to the underlying surface is provided via the SurfaceHolder interface, which can be retrieved by callinggetHolder().

The Surface will be created for you while the SurfaceView's window is visible; you should implementsurfaceCreated(SurfaceHolder) andsurfaceDestroyed(SurfaceHolder) to discover when the Surface is created and destroyed as the window is shown and hidden.

One of the purposes of this class is to provide a surface in which a secondary thread can render into the screen. If you are going to use it this way, you need to be aware of some threading semantics:

简单翻译:

SurfaceView提供了一个专门用于绘制的surface,这个surface内嵌于。你可以控制这个Surface的格式和尺寸。Surfaceview控制这个Surface在屏幕的正确绘制位置。

surface是Z-ordered的(也就是说在xyz坐标系中,按照Z坐标排序的,Z值大的表面覆盖在Z值小的表面的上方),这表明它总在自己所在窗口的后面。surfaceview在显示窗口处为Surface提供了一个可见区域,通过这个区域,才能看到Surface里面的内容。可以放置一些覆盖图层(overlays)在Surface上面,如Button、Textview之类的。但是,需要注意的是,如果Surface上面有全透明的控件,那么随着Surface的每一次变化,这些全透明的控件就会重新渲染,这样的话,就影响性能与显示的效果。

你可以通过SurfaceHolder这个接口去访问Surface,而执行getHolder()方法可以得到SurfaceHolder接口。

当SurfaceView的窗口可见时,Surface就会被创建,当SurfaceView窗口隐藏时,Surface就会被销毁。当然了,你也可以通过复写surfaceCreated(SurfaceHolder)surfaceDestroyed(SurfaceHolder) 这两个方法来验证一下Surface何时被创建与何时被销毁。

SurfaceView提供了一个运行在渲染线程的surface,若你要更新屏幕,你需要了解以下线程知识。


2.1、SurfaceView与Surface的联系

简单来说,SurfaceView与Surface的联系就是,Surface是管理显示内容的数据(implementsParcelable),包括存储于数据的交换。而SurfaceView就是把这些数据显示出来到屏幕上面。

两者联系如图所示:



3、SurfaceHolder


SurfaceHolder

android.view.SurfaceHolder

Class Overview


Abstract interface to someone holding a display surface. Allows you to control the surface size and format, edit the pixels in the surface, and monitor changes to the surface. This interface is typically available through theSurfaceView class.

When using this interface from a thread other than the one running its SurfaceView, you will want to carefully read the methodslockCanvas() andCallback.surfaceCreated().

简单翻译:

SurfaceHolder是控制surface的一个抽象接口,你可以通过SurfaceHolder来控制surface的尺寸和格式,或者修改surface的像素,监视surface的变化等等,SurfaceHolder是SurfaceView的典型接口。

与直接控制SurfaceView来修改surface不同,使用SurfaceHolder来修改surface时,需要注意lockCanvas()Callback.surfaceCreated().这两个方法。

SurfaceHolder控制surface的流程所使用的几个方法。

3.1、abstract void addCallback(SurfaceHolder.Callback callback)
Add a Callback interface for this holder.// 给SurfaceHolder一个回调对象。

3.2、abstract Canvas lockCanvas(Rect dirty)
Just like lockCanvas() but allows specification of a dirty rectangle.
// 锁定画布中的某一个区域,返回的画布对象Canvas(当更新的内容只有一个区域时,同时要追求高效,可以只更
新一部分的区域,而不必更新全部画布区域)

3.3、abstract Canvas lockCanvas()
Start editing the pixels in the surface.// 锁定画布,返回的画布对象Canvas

3.4、abstract void removeCallback(SurfaceHolder.Callback callback)
Removes a previously added Callback interface from this holder.//移除回调对象

3.5、abstract void unlockCanvasAndPost(Canvas canvas)
Finish editing pixels in the surface.// 结束锁定画图,并提交改变。

4、SurfaceHolder.Callback

SurfaceHolder.Callback

android.view.SurfaceHolder.Callback
Known Indirect Subclasses

Class Overview


A client may implement this interface to receive information about changes to the surface. When used with aSurfaceView, the Surface being held is only available between calls tosurfaceCreated(SurfaceHolder) andsurfaceDestroyed(SurfaceHolder). The Callback is set withSurfaceHolder.addCallback method.

简单翻译:

SurfaceHolder.Callback是监听surface改变的一个接口

4.1、public abstract voidsurfaceChanged(SurfaceHolder holder, int format, int width, int height)
holderThe SurfaceHolder whose surface has changed.
formatThe new PixelFormat of the surface.
widthThe new width of the surface.
heightThe new height of the surfa
//surface发生改变时被调用


4.2、public abstract voidsurfaceCreated(SurfaceHolder holder)

Parameters
holderThe SurfaceHolder whose surface is being created

//在surface创建时被调用,一般在这个方法里面开启渲染屏幕的线程。


4.3、public abstract voidsurfaceDestroyed(SurfaceHolder holder)
Parameters
holderThe SurfaceHolder whose surface is being destroyed.
//销毁时被调用,一般在这个方法里将渲染的线程停止。


附上上述所说几种的联系方法

SurfaceHolder = SurfaceView.getHolder();

Surface = SurfaceHolder.getSurface();

Canvas =SurfaceHolder.LockCanvas(Rect dirty)

Canvas   =Surface.lockCanvas(Rect dirty)


5、Demo小程序

共有两个class效果图如下,具体看代码和注释。


进入程序,执行

public void surfaceCreated(SurfaceHolder holder)

然后执行

public void surfaceChanged(SurfaceHolder holder, int format, int width,  int height)

退出程序调用surfaceDestroyed,释放资源。

public void surfaceDestroyed(SurfaceHolder holder)




/****************************************************************/

效果图:


@MySurfaceView.java

/*
 * author: conowen
 * e-mail: conowen@hotmail.com
 * date  :  2012.8.4
 */
package com.conowen.SurfaceViewDemo;

import android.app.Activity;
import android.os.Bundle;

public class SurfaceViewDemoActivity extends Activity {
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
       // setContentView(R.layout.main);
        setContentView(new MySurfaceView(this));
        
    }
}



@SurfaceViewDemoActivity.java

/*
 * author: conowen
 * e-mail: conowen@hotmail.com
 * date  :  2012.8.4
 */
package com.conowen.SurfaceViewDemo;

import android.content.Context;
import android.graphics.Canvas;
import android.graphics.Color;
import android.graphics.Paint;
import android.graphics.Rect;
import android.util.Log;
import android.view.SurfaceHolder;
import android.view.SurfaceView;

public class MySurfaceView extends SurfaceView implements
		SurfaceHolder.Callback {

	private String TAG = "conowen";
	
	private SurfaceHolder sfh;
	private boolean ThreadFlag;
	private int counter;
	private Canvas canvas;

	private Thread mThread = new Thread(new Runnable() {

		@Override
		public void run() {
			// TODO Auto-generated method stub
			while (ThreadFlag) {

				// 锁定画布,得到Canvas对象
				canvas = sfh.lockCanvas();

				// 设定Canvas对象的背景颜色
				canvas.drawColor(Color.GREEN);

				// 创建画笔
				Paint p = new Paint();
				// 设置画笔颜色
				p.setColor(Color.RED);
				// 设置文字大小
				p.setTextSize(40);

				// 创建一个Rect对象rect
				// public Rect (int left, int top, int right, int bottom)
				Rect rect = new Rect(100, 50, 400, 350);
				// 在canvas上绘制rect
				canvas.drawRect(rect, p);
				// 在canvas上显示时间
				// public void drawText (String text, float x, float y, Paint
				// paint)
				canvas.drawText("时间 = " + (counter++) + " 秒", 500, 200, p);

				if (canvas != null) {
					// 解除锁定,并提交修改内容,更新屏幕
					sfh.unlockCanvasAndPost(canvas);
				}
				try {
					Thread.sleep(1000);
				} catch (InterruptedException e) {
					// TODO Auto-generated catch block
					e.printStackTrace();
				}
			}
		}

	});

	public MySurfaceView(Context context) {
		super(context);
		// TODO Auto-generated constructor stub

		// 通过SurfaceView获得SurfaceHolder对象
		sfh = this.getHolder();

		// 为SurfaceHolder添加回调结构SurfaceHolder.Callback
		sfh.addCallback(this);

	}

	@Override
	public void surfaceChanged(SurfaceHolder holder, int format, int width,
			int height) {
		// TODO Auto-generated method stub
		Log.i(TAG, "surfaceChanged");

	}

	@Override
	public void surfaceCreated(SurfaceHolder holder) {
		// TODO Auto-generated method stub
		Log.i(TAG, "surfaceCreated");
		counter = 0;
		ThreadFlag = true;
		mThread.start();

	}

	@Override
	public void surfaceDestroyed(SurfaceHolder holder) {
		// TODO Auto-generated method stub
		Log.i(TAG, "surfaceDestroyed");
		ThreadFlag = false;

	}

}




Android Studio 中出现 `public class VideoActivity extends Activity implements SurfaceHolder.Callback` 的编译提示通常是因为你在尝试创建一个处理视频流的Activity,并希望它能够监听Surface的变化,比如摄像头预览等。这涉及到Android多媒体框架,特别是SurfaceViewSurfaceHolder。 要解决这个编译错误,你需要遵循以下步骤: 1. **添加依赖**:首先确保你的项目已经包含了处理多媒体的库,例如`android.hardware.camera`或`com.google.android.media.exoplayer`等。如果尚未添加,可以在build.gradle文件中添加相应的依赖。 ```groovy dependencies { implementation 'com.google.android.gms:play-services-vision:latest_version' // 或者其他需要的多媒体库 } ``` 2. **设置SurfaceHolder**:在VideoActivity中,你需要初始化一个SurfaceView并设置SurfaceHolder回调。这通常是通过覆盖`onCreate()`方法并在其中完成的。 ```java @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_video); // 确保布局文件引用了SurfaceView SurfaceView surfaceView = findViewById(R.id.surface_view); SurfaceHolder holder = surfaceView.getHolder(); holder.addCallback(this); // 将当前Activity注册为SurfaceHolder的Callback holder.setType(SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS); // 设置Surface类型 } ``` 3. **实现Callback接口**:然后,你需要实现`SurfaceHolder.Callback`接口的相应方法,如`surfaceCreated()`, `surfaceChanged()`, 和 `surfaceDestroyed()`,这些方法会在Surface的相关生命周期事件中被调用。 4. **处理回调**:在上述方法内部,你可以设置CameraPreview、MediaPlayer或其他多媒体组件,并在合适的时机启动它们。 ```java @Override public void surfaceCreated(SurfaceHolder holder) { if (camera != null) { try { camera.setPreviewDisplay(holder); camera.startPreview(); // 初始化和开始相机预览 } catch (IOException e) { Log.e(TAG, "Error setting camera preview", e); } } } // 其他两个方法可以分别用于调整大小、停止等操作 ``` 5. **检查权限**:别忘了在AndroidManifest.xml中添加使用摄像头的权限。 ```xml <uses-permission android:name="android.permission.CAMERA" /> ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值