[Android5.1]开机动画desc.txt描述文件的分析

在上篇文章《Android5.1开机画面显示工作流程分析》中，详细分析了Android开机动画显示的工作流程。其中提到了每个开机动画压缩文件中必须包含一个描述文件desc.txt，该文件用来描述开机动画具体是怎么样显示的。这篇文章就对desc.txt进行一个详细的解读。

1 desc.txt文件格式分析

desc.txt文件由若干行组成，每一行代表一种描述。下面以一个具体的例子为例，具体说明

480 640 20
p 1 0 folder1
p 2 20 folder2
c 0 0 folder3
c 1 0 folder4
第1行用来描述开机动画在屏幕显示的大小及速度。具体为：开机动画的宽度为480个像素，高度为640个像素，显示频率为每秒20帧，即每帧显示1/20秒。

下面的每一行代表一个片段，显示的时候会按照顺序从上到下依次显示。第1个字符为片段类型，有'c'和'p'两种，两者的区别后面会结合代码说明。

第2个数字为该片段重复显示的次数，如果为‘0’，表示会无限重复显示；第3个数字为两次显示之间的间隔，单位为第一行中定义的每帧显示的时间；第4个字符串为该片段所在的文件夹，一个片段可以由多个png图片组成，都存放在folder文件夹中。

“p 1 0 folder1”代表该片段显示1次，与下一个片段间隔0s，该片段的显示图片路径为bootanimation.zip/folder1。

“p 2 20 folder2”代表该片段显示2次，且两次之间显示的间隔为20*(1/20)=1s，与下一个片段间隔20*(1/20)=1s，该片段的显示图片路径为bootanimation.zip/folder2。

“c 0 0 folder3”代表该片段无限循环显示，且两次显示的间隔为0s，与下一个片段间隔0s，该片段的显示图路径为bootanimation.zip/folder3。

“c 1 10 folder4”代表该片段显示1次，显示后暂停10*(1/20)=0.5s，该片段的显示图路径为bootanimation.zip/folder4。

2 "p"片段和“c”片段的区别

在早期Android版本中只有“p”片段，且movie()中的显示代码如下：

for (int i=0 ; i<pcount && !exitPending() ; i++) {  
        const Animation::Part& part(animation.parts[i]);  
        const size_t fcount = part.frames.size();  
        glBindTexture(GL_TEXTURE_2D, 0);  
  
        for (int r=0 ; !part.count || r<part.count ; r++) {  
            for (int j=0 ; j<fcount && !exitPending(); j++) {  
                const Animation::Frame& frame(part.frames[j]);  
 
            .......
 
    .....
}
里面的主要参数和函数说吗如下：
pcount---显示片段的数量，比如上面的例子，pcount=4

p.count---该片段的重复显示次数。

fcount---该片段中png图片的数量
exitPending()---如果SurfaceFlinger服务通知bootanimation停止显示动画，则该函数返回值为true，否则为false。

第一个for循环用于顺序显示所有片段，第二个for循环用于重复显示该片段，第三个for循环用于顺序显示该片段中所有的png图片。

分析代码，可知：若exitPending()返回值为true，即SurfaceFlinger服务要求bootanimation停止显示动画，则不管当前显示到哪个片段或png图片，都会导致退出for循环，从而停止开机动画的显示。

在Android5.1中，加入了“c”片段。对与以"c"标识的片段，即使exitPending()返回值为true，也会继续显示。

我们分析一下源码，首先看一下movie()中解析desc.txt的代码：

    // Parse the description file  
    for (;;) {  
        ...... 
        if (sscanf(l, "%d %d %d %d", &width, &height, &fps, &flg) >= 3) {  
            animation.width = width;  
            animation.height = height;  
            animation.fps = fps;  
        }  
        else if (sscanf(l, " %c %d %d %s #%6s", &pathType, &count, &pause, path, color) >= 4) {  
            Animation::Part part;  
            part.playUntilComplete = pathType == 'c';  
            part.count = count;  
            part.pause = pause;  
            part.path = path;  
            part.audioFile = NULL;  
            if (!parseColor(color, part.backgroundColor)) {  
                ALOGE("> invalid color '#%s'", color);  
                part.backgroundColor[0] = 0.0f;  
                part.backgroundColor[1] = 0.0f;  
                part.backgroundColor[2] = 0.0f;  
            }  
            animation.parts.add(part);  
        }  
  
        s = ++endl;  
    }
可以看到，如果pathType==‘c’，part.playUntilComplete等于true，否则为false。接着，看一下显示代码：
for (size_t i=0 ; i<pcount ; i++) {  
        const Animation::Part& part(animation.parts[i]);  
        const size_t fcount = part.frames.size();  
        glBindTexture(GL_TEXTURE_2D, 0);  
  
        for (int r=0 ; !part.count || r<part.count ; r++) {  
            // Exit any non playuntil complete parts immediately  
            if(exitPending() && !part.playUntilComplete)  
                break;  
 
            ......
            for (size_t j=0 ; j<fcount && (!exitPending() || part.playUntilComplete) ; j++) {  
                
        ......
  
                checkExit();  
            }  
  
            usleep(part.pause * ns2us(frameDuration));  
  
            // For infinite parts, we've now played them at least once, so perhaps exit  
            if(exitPending() && !part.count)  
                break;  
        }  
  
        ......  
    } 
可以看到，如果exitPending()返回值为true且part.playUntilComplete=false，则会break。即：当SurfaceFlinger服务要求bootanimation停止显示动画时，以‘p’标识的片段会停止，而以'c'标识的片段会继续显示。这就是两者之间的主要区别。
这里有个问题：重复循环显示的'c'标识片段，会不受任何约束的一直显示下去，这显然是不合适的。
于是在第二个for循环体最后，有如下代码：

// For infinite parts, we've now played them at least once, so perhaps exit  
            if(exitPending() && !part.count)  
                break; 
意思是，如果检测到SurfaceFlinger服务要求bootanimation停止显示，且该片段的显示次数为'0'，即重复循环显示，则会break停止显示。

我猜想"c"标识的意思是continue，即：即使SurfaceFlinger要求bootanimation停止动画，bootanimation也不会立刻停止动画，它会等c标识片段都显示完毕后，再停止。

这样，我们可以利用'c'和'p'片段的区别，设计出更灵活的开机动画。