Android Gallery2流程分析

Android 系统的多媒体数据provider

packages/providers/MediaProvider/
含有类MediaProvider.java、MediaScannerService.java、MediaScannerReceiver.java，
编译后生成MediaProvider.apk。会在开机时扫描本机和sdcard上的媒体文件（图片、视频、音频），并在/data/data/com.android.providers.media/databases 目录下生成internal.db（/system/meida）和external-？.db(/sdcard)两个数据库文件。此后所有的多媒体信息都从这两个数据库中获取。

rameworks/base/core/java/android/provider/MediaStore.java
提供的多媒体数据库，所有多媒体数据信息都可以从这里提取。数据库的操作通过利用ContentResolver调用相关的接口实现。

frameworks/base/media/java/android/media/
提供了android上 多媒体应用层的操作接口。主要说明：
• MediaPlayer.java：提供了视频、音频、数据流的播放控制等操作的接口。
• MediaScanner*.java：提供了媒体扫描接口的支持，媒体扫描后加入数据库中，涉及MediaScannerConnection.java和MediaScannerConnectionClient.java。

gallery2的功能交互：

android 媒体文件类型：

 

 

以下转自：

http://blog.csdn.net/shareviews/article/details/7953912

Android4.0图库Gallery2代码分析(二) 数据管理和数据加载

一 图库数据管理

Gallery2的数据管理 DataManager(职责:管理数据源)- MediaSource(职责:管理数据集) - MediaSet(职责:管理数据项)。DataManager中初始化所有的数据源(LocalSource, PicasaSource, MtpSource, ComboSource, ClusterSource, FilterSource, UriSource, SnailSource),将数据源放到一个Hash表中，提供存取操作。MediaSource负责管理数据集，以LoacalSource为例，从他的createMediaObject函数可以看出，根据路径他可以创建出LocalMediaSet, LocalMedia, LocalImage, LocalVideo等。MediaSet负责管理数据项MediaItem. 图库数据管理简要图如图-1

图-1:图库数据管理简化图

二 数据项(MediaItem)的加载过程。

下面介绍一下，Albumpage加载缩略图列表的过程为例子。AlbumSetPage加载相册缩略图和PhotoPage加载大图的过程，请读者自行分析。

在相册页面(AlbumPage)和缩略图数据加载相关的有两个成员变量AlbumDataLoader和AlbumSlotRender。AlbumDataLoader负责维护要加载数据提供一个管理，将要加载的数据项MediaItem放在链表中进行存取操作，动态的增删改查操作。在AlbumPage类的Onresume函数中调用了AlbumDataLoader的resume,AlbumDataLoader的resume创建了一个线程，随时处理数据的变化(MediaItem的增删改查)。AlbumDataLoader的作用过程见图2。

图-2:AlbumDataLoader的作用过程

       AlbumDataLoader负责数据模型的维护，AlbumSlotRender负责数据的缩略图的加载工作，为了提高性能，数据加载使用了【线程池】。AlbumSlotRender从AlbumDataLoader获取要加载的数据MediaItem, 根据每一个MediaItem的状态确定是是否Bitmap缩略图的是需要加载、回收、还是等待等。对于需要加载的缩略图，提交到线程池中。AlbumSlotRender的作用过程见图3。数据加载过程中，【同步问题】其实也是需要重点分析的，由于时间有限，这里就缩略了，见谅！

图-3:AlbumSlotRender的作用过程

以下转自： http://www.2cto.com/kf/201312/267018.html

 

gallery2 实例分析：

GalleryAppImpl 在androidManifest.xml中注册Application标签，应用创建时就会被初始化，维护应用内部全局数据。
主要看几个函数：initializeAsyncTask(),GalleryUtils.initialize(this),


private void initializeAsyncTask() {
    // AsyncTask class needs to be loaded in UI thread.
    // So we load it here to comply the rule.
    try {
        Class.forName(AsyncTask.class.getName());
    } catch (ClassNotFoundException e) {
    }
}
Class.forName(AsyncTask.class.getName())会返回AsyncTask这个类，并要求JVM查找并加载AsyncTask 类，也就是说JVM会执行AsyncTask类的静态代码段。


public static void initialize(Context context) {
    DisplayMetrics metrics = new DisplayMetrics();
    WindowManager wm = (WindowManager)
            context.getSystemService(Context.WINDOW_SERVICE);
    wm.getDefaultDisplay().getMetrics(metrics);
    sPixelDensity = metrics.density;
    Resources r = context.getResources();
    TiledScreenNail.setPlaceholderColor(r.getColor(
            R.color.bitmap_screennail_placeholder));
    initializeThumbnailSizes(metrics, r);
}
GalleryUtil是Gallery的工具类，获得了屏幕参数，WindowManager，Resource等。
onCreate中由于mStitchingProgressManager赋值为null，所以暂时未调用getDataManager()。这个函数下面会介绍到，主要用来管理Gallery的数据路径层次。


Gallery 从launcher进入Gallery，图库应用会进入应用主入口Gallery.java。onCreate()中加载布局main.xml。


@Override
protected void onCreate(Bundle savedInstanceState) {
    …...
    setContentView(R.layout.main);
 
    if (savedInstanceState != null) {
       getStateManager().restoreFromState(savedInstanceState);
    } else {
        initializeByIntent();
    }
}
savedInstanceState是在Activity在onPause时保存状态用的，这里暂时为null。


    private void initializeByIntent() {
        Intent intent = getIntent();
        String action = intent.getAction();
 
        if (Intent.ACTION_GET_CONTENT.equalsIgnoreCase(action)){
            startGetContent(intent);
        } else if(Intent.ACTION_PICK.equalsIgnoreCase(action)) {
            // We do NOT really support the PICKintent. Handle it as
            // the GET_CONTENT. However, we needto translate the type
            // in the intent here.
            Log.w(TAG, "action PICK is notsupported");
            String type =Utils.ensureNotNull(intent.getType());
            if(type.startsWith("vnd.android.cursor.dir/")) {
                if(type.endsWith("/image")) intent.setType("image/*");
                if(type.endsWith("/video")) intent.setType("video/*");
            }
            startGetContent(intent);
        } else if(Intent.ACTION_VIEW.equalsIgnoreCase(action)
                ||ACTION_REVIEW.equalsIgnoreCase(action)){
            startViewAction(intent);
        } else {
            startDefaultPage();
        }
}
从这个函数看，如果从相册应用图标进入，会走startDefaultPage流程，如果外部打开图片，会走startGetContent流程。先看默认的startDefaultPage流程吧。


    public void startDefaultPage() {
        PicasaSource.showSignInReminder(this);
        Bundle data = new Bundle();
        data.putString(AlbumSetPage.KEY_MEDIA_PATH,
               getDataManager().getTopSetPath(DataManager.INCLUDE_ALL));
        getStateManager().startState(AlbumSetPage.class,data);
        mVersionCheckDialog =PicasaSource.getVersionCheckDialog(this);
        if (mVersionCheckDialog != null) {
           mVersionCheckDialog.setOnCancelListener(this);
        }
}
data里面存了相册顶层路径："/combo/{/mtp,/local/all,/picasa/all}"

 

 StateManager和AbstractGalleryActivity

 

StateManager
StateManager中有个Stack mStack，类似于ActivityManager中的ActivityStack。用于控制相册界面的窗口堆栈管理，成员为StateEntry类。再看startState这个函数：


    public void startState(Class klass,
            Bundle data) {
        Log.v(TAG, "startState " + klass);
        ActivityState state = null;
        try {
            // 用窗口类创建一个ActivityState实例
            state = klass.newInstance();
        } catch (Exception e) {
            throw new AssertionError(e);
        }
        // 堆栈非空
        if (!mStack.isEmpty()) {
             // 获取栈顶ActivityState
            ActivityState top = getTopState();
           top.transitionOnNextPause(top.getClass(), klass,
                   StateTransitionAnimation.Transition.Incoming);
            // 调用栈顶ActivityState的onPause
            if (mIsResumed) top.onPause();
        }
        // 初始化当前的ActivityState，这个和startActivity非常相似
        state.initialize(mActivity, data);
        // 初始化后入栈
        mStack.push(new StateEntry(data, state));


        Log.d(TAG, "startState:startState->onCreate");
        // 调用新ActivityState实例的onCreate，这个和startActivity的流程又好相似
        state.onCreate(data, null);
        Log.d(TAG, "startState:startState->resume");
        // 调用新ActivityState实例的onResume
        if (mIsResumed) state.resume();
}
可以说这个函数和启动应用activity的流程非常相似，只是简化了流程而已。另外，startStateForResult也和startActivityForResult类似。
AbstractGalleryActivity 在介绍AlbumSetPage、AlbumPage、PhotoPage等页面前，必须先介绍AbstractGalleryActivity，因为以上三个页面的父类ActivityState中有成员变量AbstractGalleryActivity mActivity。相册的Activity实际上只有一个，可以说就是这个mActivity，通过StateManager和DataManager来控制显示不同的页面。
继承自Activity，其中有几个重要成员：GLRootView mGLRootView，StateManager mStateManager，DataManager，GalleryActionBar mActionBar，OrientationManager mOrientationManager。
其中GalleryActionBar就是相册各个界面顶部的ActionBar控件。按照Activity的生命周期，在onCreate中创建OrientationManager对象赋予mOrientationManager，调用toggleStatusBarByOrientation在屏幕横竖屏时对window的全屏标记做增加和清除。
    // Shows status bar in portrait view, hide in landscape view
    private void toggleStatusBarByOrientation() {
        if (mDisableToggleStatusBar) return;


        Window win = getWindow();
        if (getResources().getConfiguration().orientation== Configuration.ORIENTATION_PORTRAIT) {
            win.clearFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);
        } else {
           win.addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);
        }
    }
在setContentView()中加载GLRootView。在onStart()中注册AlertDialog的onClick处理。在onResume()，onPause()中都会分别对StateManager，DataManager做对应的onResume, onPause操作。例如：
    @Override
    protected void onResume() {
        super.onResume();
        mGLRootView.lockRenderThread();
        try {
            getStateManager().resume();
            getDataManager().resume();
        } finally {
            mGLRootView.unlockRenderThread();
        }
        mGLRootView.onResume();
        mOrientationManager.resume();
    }
其中 mGLRootView会调用 lockRenderThread()，在执行完xxx.resume()后会再调用unlockRenderThread()。下面是GLRootView的lockXXX()和unlockXXX()函数。
    @Override
    public void lockRenderThread() {
        mRenderLock.lock();
    }


    @Override
    public void unlockRenderThread() {
        mRenderLock.unlock();
    }
其中 mRenderLock是ReentrantLock对象。那么ReentrantLock（可重入锁）的作用是什么？
因为Gallery的每个页面AlbumSet、AlbumPage、PhotoPage、PhotoView都是同一个Activity，界面的控制是通过StateManager以及DataManager，切换进入每个状态页面，都会获取不同的GLRootView，所以必须保证GLRootView是锁定情况下，才能对StateManager以及DataManager做处

 

以下转自：

http://blog.csdn.net/buleideli/article/details/8491744

一、

1.1.1 进入gallery
进行如下关键操作。
        先进入gallery’中处理。Gallery中initializeByIntent中最终会调用启动albumset，代码如下。
Bundledata = new Bundle();
       data.putString(AlbumSetPage.KEY_MEDIA_PATH,
              getDataManager().getTopSetPath(DataManager.INCLUDE_ALL));
       getStateManager().startState(AlbumSetPage.class,data);
        初始化view，创建albumsetview并注册其侦听者，该侦听者负责侦听用户点击触摸操作。
        创建GLView类的对象，在该对象重载实现onlayout()以及render函数。其中onlayout()在每次进入这个主界面时调用，render()在每次该界面视图改变时调用，例如触摸等操作使得界面视图改变调用render来重绘。
        创建界面上的其他元素。
        创建过渡动画。
 
1.1.2 退出gallery
        调用onbackpressed退出。
        最终执行退出操作是由StateManager的finishState。该函数会先出栈一个activitystate，后再判断是否栈为空，为空才真正终止应用退出。
 
1.1.3 打开相册
在点击进入相册前进行如下操作。
        若进入的相册下一级已经没有相册了，那就启动albumpage。
        若进入的相册下一级仍有相册了，那就启动albumsetpage。
进入albumpage后，主要步骤跟进入gallery时差不多。
1.1.4 打开相片或视频
1）打开图片见3.1.5。
2）打开视频见下面分析。主要操作见下面。
        ControllerOverlay用于播放控件的实现，诸如时间条，屏幕中间显示的播放状态按钮等等。
        加载各种view，控件。
        Movieplayer中的Bookmarker是个书签功能，看代码就是负责保存本次播放的位置，等挂起后重新进入gallery可以从上一次播放位置继续播放。
1.1.5 播放幻灯片
主要操作如下。
        初始化数据以及view。
        指定播放幻灯片按什么顺序播放，或是随机，或是顺序。
1.1.6 删除图片或视频
主要操作如下。
        删除操作在三个地方有，gallery主界面、相册内界面、图片浏览界面，他们都是由界面上方的actionbar按钮触发。
        Albumsetpage、albumpage均是创建ActionModeHandler来实现加载这个actionbar。Photopage是通过创建MenuExecutor来加载这个actionbar。另外这个actionbar同时包括actiobar的其他操作，诸如裁剪、编辑等等。
        最终的删除操作是通过获取mediaobject对象，对其进行操作实现的。Mediaobject同时是mediaset、mediaitem的父类，多态性就能保证对相册或是相片进行删除操作。删除操作最终通过conresolver.delete实现。
1.1.7 开机与media相关的数据库流程
流程见下。
        创建mediaprovider。Mediaprovider中oncreate主要做如下处理。
        挂载内部存储器，创建内部存储器的数据库。
        创建侦听者来侦听卸载存储器的事件，包括卸载内部存储器以及外部存储器。
        挂载外部存储器，创建外部存储器的数据库。
        创建线程，用于处理更新缩略图的请求。缩略图请求分为两种，一种是图片缩略图，处理原则是FIFO，先请求先处理；另一种是音乐专辑缩略图，处理原则是LIFO，后请求先处理。


        与2.3一样，先通过mediascanerreceiver接收到Intent.ACTION_MEDIA_MOUNTED这个加载intent，调用scan对全盘媒体文件进行扫描。
        接着调用到mediascannerservice。ServiceHandler中对指定路径进行扫描。调用到mediascannerservice.scan()。扫描前发送Intent.ACTION_MEDIA_SCANNER_STARTED广播，接着创建mediascanner进行扫描，扫描后发送Intent.ACTION_MEDIA_SCANNER_FINISHED。接收这两个广播的地方找不到。应该是用于提示外部的应用扫描的开始以及结束。
        在扫描前会插入数据库一条记录，之后就删除该条记录。为什么要在之前插入一条记录，之后就删除这条记录，并且只是获取了uri，并没对这个uri进行操作，看不懂。代码如下。
 
UriscanUri = getContentResolver().insert(MediaStore.getMediaScannerUri(),values);
//...
getContentResolver().delete(scanUri,null, null);
        调用mediascanner.scanDirectories扫描所有目录。
          mediascanner.scanDirectories中，有如下关键操作。
        Initalize()：初始化各个媒体uri。总共有如下uri。
mAudioUri
mVideoUri
mImagesUri
mThumbsUri
mFilesUri
        Prescan()：扫描mFilesUri所示的文件。写入filecache中。同时计算mImagesUri的文件数。
        processDirectory()：遍历扫描所有路径。具体进入c++代码，看不懂。
        Postscan()：删除掉文件系统中不存在但数据库中存在的文件项，此删除为删除数据库中记录项。
1.1.8    Filemanager中删除媒体文件
删除单个文件主要流程见下。
在Filemanager中，主要操作流程如下。
        删除该文件。
        FileMgrMenuUtil.notifyFileSystemChanged中发送Intent.ACTION_MEDIA_SCANNER_SCAN_FILE通知删除文件成功。Mediareceiver接收到就交给mediascannerservice进行scanfile()处理。
        Mediascannerservice.scanfile()，最终调用到Mediascanner.scansinglefile()处理。主要进行如下处理。
        初始化各种扫描需要的东西，如路径等。
        Prescan()：更新媒体文件的filecache。Filecache是一个索引表，存放媒体文件的关键数据，以提高访问这些文件的速度。
        Doscanfile()：在这里主要是置标志位表示已经在文件系统找到该文件。
        均是调用mediaobject.delete()完成删除操作，其实最终调用的是mediaobject派生出的mediaset、mediaitem。而跟进代码最终是在mediaprovider.delete处理。
        Mediaprovider.delete()主要是删除数据库中该条记录。
 
在Gallery中，主要需要注意流程如下。
        均是调用mediaobject.delete()完成删除操作，其实最终调用的是mediaobject派生出的mediaset、mediaitem。而跟进代码最终是在mediaprovider.delete处理。
        Mediaprovider.delete()主要是删除数据库中该条记录。
        但是不能找到地方处理删除文件操作。
 
 
删除目录。
在filemanager中，流程稍有不同，主要见以下。
        会调用到RecursiveDeleteTask线程进行递归删除目录下文件的处理。
        FileMgrMenuUtil.notifyFileSystemChanged中发送Intent.ACTION_MEDIA_MOUNTED通知删除文件夹成功。Mediascannerservice进行scan()处理。其主要操作跟“开机与media相关的数据库流程”内的Mediascannerservice.scan()大同小异，区别在与扫描范围的不同。
 
在gallery中，操作见上面的删除单个文件操作。
1.1.9    Filemanager中移动媒体文件
移动单个文件。
在filemanager中，主要注意以下。
        交由MoveTask线程处理，线程中通过file.renameto()来实现将文件移动到另一个地方，这个方法只是更改了原来文件路径。
        FileMgrMenuUtil.notifyFileSystemChanged中发送Intent.ACTION_MEDIA_SCANNER_SCAN_FILE通知移动文件成功。接着Mediascannerservice同样进行单个文件扫描处理。
 
移动一整个目录。
在filemanager中，主要注意以下。
        主要通过以下数据结构来存放待处理的文件列表。
private ArrayList<FileInfo>mCheckedFileList = newArrayList<FileInfo>();
        同样还是MoveTask线程处理这些文件。
        FileMgrMenuUtil.notifyFileSystemChanged中发送Intent.ACTION_MEDIA_MOUNTED通知移动文件夹成功。Mediascannerservice进行scan()处理。
1.1.10 Filemanager中重命名媒体文件
重命名单个文件与文件夹操作基本一致。
Filemanager中，主要操作流程如下。
        同样使用file.renameto()进行重命名文件操作。
        同样使用FileMgrMenuUtil.notifyFileSystemChanged发送intent消息通知重命名操作，使得Mediascannerservice再去扫描。这里发送的intent消息，重命名单个文件与重命名文件夹是不一样的，与之前区别一样。
1.1.11 Filemanager中复制媒体文件
复制单个文件。
在filemanager中，主要操作流程如下。
        检查目的地址空间足够与否。
        同样使用FileMgrMenuUtil.notifyFileSystemChanged发送intent消息通知重命名操作，使得Mediascannerservice再去扫描。这里发送的intent消息，重命名单个文件与重命名文件夹是不一样的，与之前区别一样。
 
复制目录。与单个文件操作基本一致。主要见以下。
        递归实现copy。
1.1.12 增加媒体文件
在camera拍摄一张照片后，主要进行如下操作。
        生成这个jpeg格式的图片。
        ContentResolver中插入一条关于这照片的记录到对应数据库中。

 

二、

3.1.1 Gallery

gallery的主程序类。

其类图如下。

相关类说明
1）GalleryActionBar
用于在相册主界面出现的排序下拉框，如下。

3.1.2 AbstractGalleryActivity

实现基本的activity操作的类，作为某些类的基类。
其类图如下。

相关类说明
1）GalleryActivity 
接口类，主要是一些获取AbstractGalleryActivity成员变量的方法。
public interface GalleryActivity extends GalleryContext {
public StateManager getStateManager();
public GLRoot getGLRoot();
public PositionRepository getPositionRepository();
public GalleryApp getGalleryApplication();
public GalleryActionBar getGalleryActionBar();
}
public interface GalleryContext {
public ImageCacheService getImageCacheService();
public DataManager getDataManager();

public Context getAndroidContext();

public Looper getMainLooper();
public Resources getResources();
public ContentResolver getContentResolver();
public ThreadPool getThreadPool();
}
2）StateManager
其负责管理activity的各种状态的启动挂起等。
通过管理一个栈，来维护所有activity的显示状态。
private Stack<StateEntry> mStack = new Stack<StateEntry>();
同时保存一个GalleryActivity的mcontext，用来方便对相应activity进行操作。
一般通过如下来启动一个activity。
mActivity.getStateManager().startState(ManageCachePage.class, data);
其相当于
context.startActivity()
或是通过如下启动一个需要处理结果的activity。
mActivity.getStateManager().startStateForResult(
PhotoPage.class, REQUEST_PHOTO, data);
其相当于
context.startActivityForResult()
以下是类图。

一个activity对应着多个显示状态。见如下定义。
private Stack<StateEntry> mStack = new Stack<StateEntry>();
private static class StateEntry {
public Bundle data;
public ActivityState activityState;

public StateEntry(Bundle data, ActivityState state) {
this.data = data;
this.activityState = state;
}
}
而显示状态通过StateEntry中的ActivityState变量来标识。
abstract public class ActivityState {
public static final int FLAG_HIDE_ACTION_BAR = 1;
public static final int FLAG_HIDE_STATUS_BAR = 2;
public static final int FLAG_SCREEN_ON = 3;
…｝
ActivityState用于控制activity的显示模式，是否需要点亮显示、是否需要显示状态栏、是否需要显示动作按钮。

3）GLRootView
实现绘图的类。其类图如下。

小贴士
1）GLSurfaceView介绍
GLSurfaceView是一个视图，继承至SurfaceView，它内嵌的surface专门负责OpenGL渲染。
GLSurfaceView提供了下列特性：
1> 管理一个surface，这个surface就是一块特殊的内存，能直接排版到android的视图view上。
2> 管理一个EGL display，它能让opengl把内容渲染到上述的surface上。
3> 用户自定义渲染器(render)。
4> 让渲染器在独立的线程里运作，和UI线程分离。
5> 支持按需渲染(on-demand)和连续渲染(continuous)。
6> 一些可选工具，如调试。

使用GLSurfaceView
通常会继承GLSurfaceView，并重载一些和用户输入事件有关的方法。如果你不需要重载事件方法，GLSurfaceView也可以直接使用， 你可以使用set方法来为该类提供自定义的行为。例如，GLSurfaceView的渲染被委托给渲染器在独立的渲染线程里进行，这一点和普通视图不一 样，setRenderer(Renderer)设置渲染器。

初始化GLSurfaceView
初始化过程其实仅需要你使用setRenderer(Renderer)设置一个渲染器(render)。当然，你也可以修改GLSurfaceView一些默认配置。
* setDebugFlags(int)
* setEGLConfigChooser(boolean)
* setEGLConfigChooser(EGLConfigChooser)
* setEGLConfigChooser(int, int, int, int, int, int)
* setGLWrapper(GLWrapper) 

定制android.view.Surface
GLSurfaceView默认会创建像素格式为PixelFormat.RGB_565的surface。如果需要透明效果，调用 getHolder().setFormat(PixelFormat.TRANSLUCENT)。透明(TRANSLUCENT)的surface的像 素格式都是32位，每个色彩单元都是8位深度，像素格式是设备相关的，这意味着它可能是ARGB、RGBA或其它。

选择EGL配置
Android设备往往支持多种EGL配置，可以使用不同数目的通道(channel)，也可以指定每个通道具有不同数目的位(bits)深度。因此， 在渲染器工作之前就应该指定EGL的配置。GLSurfaceView默认EGL配置的像素格式为RGB_656，16位的深度缓存(depth buffer)，默认不开启遮罩缓存(stencil buffer)。
如果你要选择不同的EGL配置，请使用setEGLConfigChooser方法中的一种。

调试行为
你可以调用调试方法setDebugFlags(int)或setGLWrapper(GLSurfaceView.GLWrapper)来自定义 GLSurfaceView一些行为。在setRenderer方法之前或之后都可以调用调试方法，不过最好是在之前调用，这样它们能立即生效。

设置渲染器
总之，你必须调用setRenderer(GLSurfaceView.Renderer)来注册一个GLSurfaceView.Renderer渲染器。渲染器负责真正的GL渲染工作。

渲染模式
渲染器设定之后，你可以使用setRenderMode(int)指定渲染模式是按需(on demand)还是连续(continuous)。默认是连续渲染。

Activity生命周期
Activity窗口暂停(pause)或恢复(resume)时，GLSurfaceView都会收到通知，此时它的onPause方法和 onResume方法应该被调用。这样做是为了让GLSurfaceView暂停或恢复它的渲染线程，以便它及时释放或重建OpenGL的资源。

事件处理
为了处理事件，一般都是继承GLSurfaceView类并重载它的事件方法。但是由于GLSurfaceView是多线程操作，所以需要一些特殊的处 理。由于渲染器在独立的渲染线程里，你应该使用Java的跨线程机制跟渲染器通讯。queueEvent(Runnable)方法就是一种相对简单的操 作，例如下面的例子。
class MyGLSurfaceView extends GLSurfaceView {

private MyRenderer mMyRenderer;

public void start() {
mMyRenderer = ...;
setRenderer(mMyRenderer);
}

public boolean onKeyDown(int keyCode, KeyEvent event) {
if (keyCode == KeyEvent.KEYCODE_DPAD_CENTER) {
queueEvent(new Runnable() {
// 这个方法会在渲染线程里被调用
public void run() {
mMyRenderer.handleDpadCenter();
}});
return true;
}
return super.onKeyDown(keyCode, event);
}
}

(注：如果在UI线程里调用渲染器的方法，很容易收到“call to OpenGL ES API with no current context”的警告，典型的误区就是在键盘或鼠标事件方法里直接调用opengl es的API，因为UI事件和渲染绘制在不同的线程里。更甚者，这种情况下调用glDeleteBuffers这种释放资源的方法，可能引起程序的崩溃， 因为UI线程想释放它，渲染线程却要使用它。)

2）GLSurfaceView的非交互使用

使用GLSurfaceView开发3D应用时，如果是非交互式的应用，可以直接使用GLSurfaceView。如果需要交互式的行为，则需要继承
GLSurfaceView并重写一些方法。交互式应用示例见下篇。

import javax.microedition.khronos.egl.EGLConfig;
import javax.microedition.khronos.opengles.GL10;
import android.app.Activity;
import android.opengl.GLSurfaceView;
import android.opengl.GLSurfaceView.Renderer;
import android.os.Bundle;
import android.provider.OpenableColumns;
/**
* 本示例演示OpenGL ES开发3D应用
* 该Activity直接使用了GLSurfaceView
* 这是因为GLSurfaceView可以直接使用，除非需要接受用户输入，和用户交互，才需要重写一些GLSurfaceView的方法
* 如果开发一个非交互式的OpenGL应用，可以直接使用GLSurfaceView。参照本示例
* @author Administrator
*
*/
public class NonInteractiveDemo extends Activity {

private GLSurfaceView mGLView;

@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);

mGLView = new GLSurfaceView(this);
//这里需要指定一个自定义的渲染器
mGLView.setRenderer(new DemoRenderer());
setContentView(mGLView);

}


public void onPause(){
super.onPause();
mGLView.onPause(); //当Activity暂停时，告诉GLSurfaceView也停止渲染，并释放资源。
}

public void onResume(){
super.onResume();
mGLView.onResume(); //当Activity恢复时，告诉GLSurfaceView加载资源，继续渲染。
}




}
class DemoRenderer implements Renderer{
@Override
public void onDrawFrame(GL10 gl) {
//每帧都需要调用该方法进行绘制。绘制时通常先调用glClear来清空framebuffer。
//然后调用OpenGL ES其他接口进行绘制
gl.glClear(GL10.GL_COLOR_BUFFER_BIT|GL10.GL_DEPTH_BUFFER_BIT);

}
@Override
public void onSurfaceChanged(GL10 gl, int w, int h) {
//当surface的尺寸发生改变时，该方法被调用，。往往在这里设置ViewPort。或者Camara等。 
gl.glViewport(0, 0, w, h);
}
@Override
public void onSurfaceCreated(GL10 gl, EGLConfig config) {
// 该方法在渲染开始前调用，OpenGL ES的绘制上下文被重建时也会调用。
//当Activity暂停时，绘制上下文会丢失，当Activity恢复时，绘制上下文会重建。

//do nothing special
}

}

3）GLSurfaceView交互式

import javax.microedition.khronos.egl.EGLConfig;
import javax.microedition.khronos.opengles.GL10;
import android.app.Activity;
import android.content.Context;
import android.opengl.GLSurfaceView;
import android.os.Bundle;
import android.view.MotionEvent;
/**
* 本示例演示OpenGL ES开发3D应用
* 该Activity使用了自定义的GLSurfaceView的子类
* 这样，我们可以开发出和用户交互的应用，比如游戏等。
* 需要注意的是：由于渲染对象是运行在一个独立的渲染线程中，所以
* 需要采用跨线程的机制来进行事件的处理。但是Android提供了一个简便的方法
* 我们只需要在事件处理中使用queueEvent(Runnable)就可以了.
* 
* 对于大多数3D应用，如游戏、模拟等都是持续性渲染，但对于反应式应用来说，只有等用户进行了某个操作后再开始渲染。
* GLSurfaceView支持这两种模式。通过调用方法setRenderMode()方法设置。
* 调用requestRender()继续渲染。
* 
* 
* @author Administrator
*
*/
public class InteractiveDemo extends Activity {

private GLSurfaceView mGLView;

public void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
mGLView = new DemoGLSurfaceView(this); //这里使用的是自定义的GLSurfaceView的子类
setContentView(mGLView);
}


public void onPause(){
super.onPause();
mGLView.onPause();
}

public void onResume(){
super.onResume();
mGLView.onResume();
}
}
class DemoGLSurfaceView extends GLSurfaceView{
DemoRenderer2 mRenderer;

public DemoGLSurfaceView(Context context) {
super(context);
//为了可以激活log和错误检查，帮助调试3D应用，需要调用setDebugFlags()。
this.setDebugFlags(DEBUG_CHECK_GL_ERROR|DEBUG_LOG_GL_CALLS);
mRenderer = new DemoRenderer2();
this.setRenderer(mRenderer);
}

public boolean onTouchEvent(final MotionEvent event){
//由于DemoRenderer2对象运行在另一个线程中，这里采用跨线程的机制进行处理。使用queueEvent方法
//当然也可以使用其他像Synchronized来进行UI线程和渲染线程进行通信。
this.queueEvent(new Runnable() {

@Override
public void run() {

//TODO:
mRenderer.setColor(event.getX()/getWidth(), event.getY()/getHeight(), 1.0f);
}
});

return true;
}

}
/**
* 这个应用在每一帧中清空屏幕，当tap屏幕时，改变屏幕的颜色。
* @author Administrator
*
*/
class DemoRenderer2 implements GLSurfaceView.Renderer{

private float mRed;
private float mGreen;
private float mBlue;
@Override
public void onDrawFrame(GL10 gl) {
// TODO Auto-generated method stub
gl.glClearColor(mRed, mGreen, mBlue, 1.0f);
gl.glClear(GL10.GL_COLOR_BUFFER_BIT|GL10.GL_DEPTH_BUFFER_BIT);
}
@Override
public void onSurfaceChanged(GL10 gl, int w, int h) {
// TODO Auto-generated method stub
gl.glViewport(0, 0, w, h);
}
@Override
public void onSurfaceCreated(GL10 gl, EGLConfig config) {
// TODO Auto-generated method stub

}

public void setColor(float r, float g, float b){
this.mRed = r;
this.mGreen = g;
this.mBlue = b;
}

}

GLRootView的构造函数中对其进行初始化操作，设置渲染器，设置EGL，设置背景图，使用RGB565作为像素格式。

三、

3.1.3 AlbumSetPage
负责处理刚进入相册显示的所有相册界面。

其类图如下。

相关类说明
1）SelectionManager.SelectionListener
负责对选择状态时的侦听。

2）SelectionManager
负责对选择状态的处理。
其类图如下。

mSourceMediaSet主要用于对相册数据进行管理，其具体作用待分析。MediaSet类请参见Mediaset。
mClickedSet主要用于对选中的媒体文件的路径进行管理。
mListener就是侦听者。
mDataManager主要用于管理相册数据。
mPressedPath存放当前点中的媒体数据的路径。

选择分为以下几种状态。
SelectionManager.ENTER_SELECTION_MODE
SelectionManager.LEAVE_SELECTION_MODE
SelectionManager.SELECT_ALL_MODE
进入退出全选，对应每种状态都要相应处理。

3）GalleryActionBar.ClusterRunner
主要实现doCluster函数。该函数用于实现按模式排序时的activity跳转。
通过GalleryActionBar实现排序，原理就是打包bundle值，重新开启一个activity，新的activity接受到这个bundle值。
4）EyePosition.EyePositionListener
人眼定位的侦听者，主要实现onEyePositionChanged，用于对人眼位置改变的侦听。未研究。
5）EyePosition
处理人眼定位的类。未研究。
6）MediaSet.SyncListener
处理异步加载mediaset的结果侦听者。实现onSyncDone（）函数。
该函数处理异步加载的结果。

7）StaticBackground
管理背景图图片。

8）AlbumSetView
负责绘制所有相册的view。
如下是类图。

8.1）SLotView
将GLView再封装。未研究。

8.2）GLView
关于GLView类介绍的注释如下。通过其可以知道GLView大致是用来将内容渲染到GLCanvas画布上的，同时处理一些触摸事件。未研究。

// GLView is a UI component. It can render to a GLCanvas and accept touch
// events. A GLView may have zero or more child GLView and they form a tree
// structure. The rendering and event handling will pass through the tree
// structure.
//
// A GLView tree should be attached to a GLRoot before event dispatching and
// rendering happens. GLView asks GLRoot to re-render or re-layout the
// GLView hierarchy using requestRender() and requestLayoutContentPane().
//
// The render() method is called in a separate thread. Before calling
// dispatchTouchEvent() and layout(), GLRoot acquires a lock to avoid the
// rendering thread running at the same time. If there are other entry points
// from main thread (like a Handler) in your GLView, you need to call
// lockRendering() if the rendering thread should not run at the same time.
8.3）AlbumSetSlidingWindow
负责滑动显示图片相关。
9）AlbumSetDataAdapter
数据适配器。
10）ActionModeHandler
对操作栏上的操作进行管理。
目前有如下操作。
private static final int SUPPORT_MULTIPLE_MASK = MediaObject.SUPPORT_DELETE
| MediaObject.SUPPORT_ROTATE | MediaObject.SUPPORT_SHARE
| MediaObject.SUPPORT_CACHE | MediaObject.SUPPORT_IMPORT;
3.1.4 AlbumPage
其基本结构与albumsetpage差不多，里面的view变成albumview。

四、

3.1.5 PhotoPage

其类图如下。

一般创建流程如下。顺序无先后
1）绘制视图，添加需要用到的控件或各种view。
2）为需要侦听者的控件或view加侦听者。
3）绑定相应model，例如这里绑定photopage.model。
4）创建渲染对象，GLView。各个视图用到的view都是加载在其上的，通过GLView.addComponent()实现。
其他主要page，诸如albumsetpage、albumpage。
相关类说明
1）PhotoView.PhotoTapListener
主要是处理onSingleTapUp事件。用于处理点击媒体文件时的动作。
2）PhotoView
主要处理photo的view。
其类图如下。

2.1）ScreenNailEntry
主要保存上下两个缩略图的显示的数据，显示这两个缩略图。
手势识别相关
ScaleGestureDetector、GestureDetector、DownUpDetector、PositionController都是跟手势识别相关的。例如左滑动、右滑动切换图片，手势放大图片等，以及过渡动画。
2.2）TileImageView
负责每个图片的处理流程。
存在一个状态机，标示每种decode相关的状态。如下图：

Tile作为一个绘制的单位，可以理解为，其封装了解码后的图片数据。TileQueue是存放tile的队列，这些tile就是等待最终调用canvas绘制的数据。GLCanvas就是封装了canvas的类。
Tileimageview.render就是绘制图片的开始。里面会调用到queueForDecode()将绘制的tile丢入tilequeue中等待被处理。一旦轮到该tile被绘制，则调用decodetile将此tile解码。
ImageCacheRequest.run调用DecodeUtils. requestDecode完成最终的解码操作。
存在三个队列，如下：
Decodequeue:存放等待decode的tile。
Uploadqueue：存放等待upload的tile。Upload就是将解码的数据送到CAVANS绘制出来，因此都是从decode中出来的。
Recycledqueue：存放要回收的tile。
mActiveTiles用于存放已激活的tile的map。
2.3）EdgeView
缩略图中每张图的蓝色外框。
2.4）Model
用于沟通UI层与数据层的桥梁。
其定义如下。

    public static interface Model extendsTileImageView.Model {
        public void next();
        public void previous();
        public void jumpTo(int index);
        public int getImageRotation();
 
        // Return null if the specified imageis unavailable.
       public ImageDatagetNextImage();
        public ImageData getPreviousImage();
    }

2.5）ProgressSpinner
进度圆圈。
2.6）手势识别处理相关
private final ScaleGestureDetector mScaleDetector;//两点触摸放大缩小等处理
private final GestureDetector mGestureDetector;
private final DownUpDetector mDownUpDetector;//点击处理相关
private PhotoTapListener mPhotoTapListener;
private final PositionController mPositionController;
3）FilmStripView.Listener
显示图片下方的缩略图滚动条的处理侦听者。主要涉及点击跳转的侦听。如下
public interface Listener {
// Returns false if it cannot jump to the specified index at this time.
boolean onSlotSelected(int slotIndex);
}

4）FilmStripView
处理在这个 控件之上的操作，诸如触摸移动长按等动作。

五、

3.1.6 SlideshowPage
处理幻灯片动画显示。

其类图如下。

1）SlideshowView
负责处理幻灯片播放的view。
1.1）SlideshowAnimation
其继承自Animation，负责具体幻灯片切换的显示。这里用到两个对象，mPrevAnimation负责上一张图片动画显示，mCurrentAnimation负责当前图片动画显示，显示动画效果就是扩大，淡入淡出。
Animation类的基本用法如下：
1）使用前需要设置每张图片显示周期，使用setDuration()。
2）开始播放，使用start()。
3）calculate()返回单张图片是否在一个周期显示完毕。
1.2）FloatAnimation
与SlideshowAnimation配合，未研究。
1.3）BitmapTexture
存放显示的图片。这里也用到两个对象，mPrevTexture负责存放上一张图片数据，mCurrentTexture负责存放当前图片数据。
2）Slide
负责存放具体相片数据。
3）ShuffleSource
负责生成随机的图片序列。用于随机幻灯片显示图片。
4）SequentialSource
负责生成顺序的图片序列。用于顺序幻灯片显示图片。
3.1.7 PhotoDataAdapter
Photodataadapter属于photopage的数据层，负责在图片数据更新时请求刷新UI。
1）渲染显示各个界面元素的原理
Photopage界面上，显示的元素种类分为三种。完整画面显示的图片，位于图片下方的缩略图图片，可能出现的GIF图片。
Photopage界面上一般存在多个元素，一个完整图片以及很多张缩略图图片，要同时刷新这么多元素，只能多线程，而涉及的线程那么多，最好就是用线程池来管理。简单说，在需要渲染界面元素时，就将该渲染任务丢入线程池中，线程池中若有空闲线程就分配来处理之，没有则该任务挂起，等待一定时间。同时线程池容许存放的任务数有上限。如下图表示线程池处理渲染的原理图。

这里的发起更新图片请求通过updateImageRequests()来实现。

2）数据层与UI层的桥梁
该类保存了一个PhotoView，看其函数调用，很多都是notify开头的，可见该对象主要在这里扮演桥梁的角色。一旦数据更新了，就会经由它通知UI层进行更新，或是一旦UI层变化了了，就经由它通知数据层更新。
各种代码片段如下。
通知UI层更新。

通知数据层更新。

3）ReloadTask
继承自thread。该线程是是与SourceListener共同配合，处理当前显示图片检测到路径不存在时的情形。诸如，在文件管理器或是图库删除此图片时，就会进行该处理，通知界面各元素更新。

4）各种图片元素表示相关类
ImageEntry 类用于表示当前显示的图片。其结构如下：
private static class ImageEntry {
public int requestedBits = 0;
public int rotation;
public BitmapRegionDecoder fullImage;
public Bitmap screenNail;
public Future<Bitmap> screenNailTask;
public Future<BitmapRegionDecoder> fullImageTask;
public boolean failToLoad = false;
// the below members are added for Gif animation
public GifDecoder gifDecoder;
public Future<GifDecoder> gifDecoderTask;
public Bitmap currentGifFrame;
}

FullImageListener用于侦听全屏显示的图片的更新。
ScreenNailListener用于侦听缩略图显示的图片的更新。
ScreenNailJob用于缩略图更新时的具体处理，与ScreenNailListener配合使用。
GifDecoderListener用于侦听GIF图片的更新。
GifAnimation类用于表示当前显示的GIF图片，其结构如下：
private static class GifAnimation {
public ImageEntry entry;
public GifDecoder gifDecoder;
public int animatedIndex;
public int currentFrame;
public int totalFrameCount;
}
GifAnimationRunnable是负责GIF解码显示的runnale类。

5）图片缓存处理相关
要想在图片切换时速度加快，就应该建立一套缓存机制。Gallery 4.0主要通过在保存当前显示图片临近图片元素来实现。如前面所说，图片元素包括，完整画面显示的图片，位于图片下方的缩略图图片，可能出现的GIF图片。对于缩略图图片，IMAGE_CACHE_SIZE限定保存个数，这里是5，其余两种元素各保留一个。
保存图片元素使用ImageFetch，其类定义如下。
private static class ImageFetch {
int indexOffset;
int imageBit;
public ImageFetch(int offset, int bit) {
indexOffset = offset;
imageBit = bit;
}
}
6）图片裁切相关数据处理
相关类是TileImageViewAdapter。
7）DataManager
Mediaset以及mediaitem都用一个64bit的id来标识。高32bit用来标识其与父集的关系，低32bit用来标识本身，其作为私有id。对于mediaset，该私有id是唯一的。对于mediaitem，该私有id在其父集中是唯一的，全局来说并非唯一的。
父集的概念，应该就是文件夹的概念。Mediaitem不能作为其他元素的父集，而mediaset可以作为mediaitem的父集。
Datamanager用于管理mediaset以及mediaitem组成的树状数据结构的类。

8）DataListener
幻灯片播放时图片数据改变等时的侦听者。