Android帧缓冲区（Frame Buffer）硬件抽象层（HAL）模块Gralloc的实现原理分析

 

        前面在介绍Android系统的开机画面时提到，Android设备的显示屏被抽象为一个帧缓冲区，而Android系统中的SurfaceFlinger服务就是通过向这个帧缓冲区写入内容来绘制应用程序的用户界面的。Android系统在硬件抽象层中提供了一个Gralloc模块，封装了对帧缓冲区的所有访问操作。本文将详细分析Gralloc模块的实现，为后续分析SurfaceFlinger服务的实现打下基础。

        在前面Android系统的开机画面显示过程分析一文中提到，Linux内核在启动的过程中会创建一个类别和名称分别为“graphics”和“fb0”的设备，用来描述系统中的第一个帧缓冲区，即第一个显示屏，其中，数字0表示从设备号。注意，系统中至少要存在一个显示屏，因此，名称为“fb0”的设备是肯定会存在的，否则的话，就是出错了。Android系统和Linux内核本身的设计都是支持多个显示屏的，不过，在Android目前的实现中，只支持一个显示屏。

        在前面Android系统的开机画面显示过程分析一文中还提到，init进程在启动的过程中，会启动另外一个进程ueventd来管理系统的设备文件。当ueventd进程启动起来之后，会通过netlink接口来Linux内核通信，以便可以获得内核中的硬件设备变化通知。而当ueventd进程发现内核中创建了一个类型和名称分别为“graphics”和“fb0”的设备的时候，就会这个设备创建一个/dev/graphics/fb0设备文件。这样，用户空间的应用程序就可以通过设备文件/dev/graphics/fb0来访问内核中的帧缓冲区，即在设备的显示屏中绘制指定的画面。注意，用户空间的应用程序一般是通过内存映射的方式来访问设备文件/dev/graphics/fb0的。

        Android系统定义了硬件抽象层模块的编写规范，具体可以参考Android硬件抽象层（HAL）概要介绍和学习计划一文。本文假设读者已经熟悉Android系统的硬件抽象层编写规范，因此，我们将按照帧缓冲区的使用情景以及硬件抽象层编写规范来介绍Gralloc模块的实现。

        用户空间的应用程序在使用帧缓冲区之间，首先要加载Gralloc模块，并且获得一个gralloc设备和一个fb设备。有了gralloc设备之后，用户空间中的应用程序就可以申请分配一块图形缓冲区，并且将这块图形缓冲区映射到应用程序的地址空间来，以便可以向里面写入要绘制的画面的内容。最后，用户空间中的应用程序就通过fb设备来将前面已经准备好了的图形缓冲区渲染到帧缓冲区中去，即将图形缓冲区的内容绘制到显示屏中去。相应地，当用户空间中的应用程序不再需要使用一块图形缓冲区的时候，就可以通过gralloc设备来释放它，并且将它从地址空间中解除映射。接下来，我们就按照上述使用情景来分析Gralloc模块的实现。

       1. Gralloc模块的加载过程。

        每一个HAL模块都有一个ID值，以这些ID值为参数来调用硬件抽象层提供的函数hw_get_module就可以将指定的模块加载到内存来，并且获得一个hw_module_t接口来打开相应的设备。

        Gralloc模块的ID值定义在hardware/libhardware/include/hardware/gralloc.h文件中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. #define GRALLOC_HARDWARE_MODULE_ID "gralloc"

        函数hw_get_module实现在hardware/libhardware/hardware.c文件中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. /** Base path of the hal modules */
  2. #define HAL_LIBRARY_PATH1 "/system/lib/hw"
  3. #define HAL_LIBRARY_PATH2 "/vendor/lib/hw"
  5. /**
  6. * There are a set of variant filename for modules. The form of the filename
  7. * is "<MODULE_ID>.variant.so" so for the led module the Dream variants
  8. * of base "ro.product.board", "ro.board.platform" and "ro.arch" would be:
  9. *
  10. * led.trout.so
  11. * led.msm7k.so
  12. * led.ARMV6.so
  13. * led.default.so
  14. */
  16. static const char *variant_keys[] = { 
  17. "ro.hardware",  /* This goes first so that it can pick up a different
  18.                        file on the emulator. */
  19. "ro.product.board", 
  20. "ro.board.platform", 
  21. "ro.arch"
  22. }; 
  24. static const int HAL_VARIANT_KEYS_COUNT = 
  25.     (sizeof(variant_keys)/sizeof(variant_keys[0])); 
  27. ...... 
  29. int hw_get_module(const char *id, const struct hw_module_t **module) 
  30. { 
  31. int status; 
  32. int i; 
  33. const struct hw_module_t *hmi = NULL; 
  34. char prop[PATH_MAX]; 
  35. char path[PATH_MAX]; 
  37. /*
  38.      * Here we rely on the fact that calling dlopen multiple times on
  39.      * the same .so will simply increment a refcount (and not load
  40.      * a new copy of the library).
  41.      * We also assume that dlopen() is thread-safe.
  42.      */
  44. /* Loop through the configuration variants looking for a module */
  45. for (i=0 ; i<HAL_VARIANT_KEYS_COUNT+1 ; i++) { 
  46. if (i < HAL_VARIANT_KEYS_COUNT) { 
  47. if (property_get(variant_keys[i], prop, NULL) == 0) { 
  48. continue; 
  49.             } 
  51.             snprintf(path, sizeof(path), "%s/%s.%s.so", 
  52.                     HAL_LIBRARY_PATH1, id, prop); 
  53. if (access(path, R_OK) == 0) break; 
  55.             snprintf(path, sizeof(path), "%s/%s.%s.so", 
  56.                      HAL_LIBRARY_PATH2, id, prop); 
  57. if (access(path, R_OK) == 0) break; 
  58.         } else { 
  59.             snprintf(path, sizeof(path), "%s/%s.default.so", 
  60.                      HAL_LIBRARY_PATH1, id); 
  61. if (access(path, R_OK) == 0) break; 
  62.         } 
  63.     } 
  65.     status = -ENOENT; 
  66. if (i < HAL_VARIANT_KEYS_COUNT+1) { 
  67. /* load the module, if this fails, we're doomed, and we should not try
  68.          * to load a different variant. */
  69.         status = load(id, path, module); 
  70.     } 
  72. return status; 
  73. } 

        函数hw_get_module依次在目录/system/lib/hw和/vendor/lib/hw中查找一个名称为"<MODULE_ID>.variant.so"的文件，其中，<MODULE_ID>是一个模块ID，而variant表示"ro.hardware"、"ro.product.board"、"ro.board.platform"和"ro.arch"四个系统属性值之一。例如，对于Gralloc模块来说，函数hw_get_module依次在目录/system/lib/hw和/vendor/lib/hw中检查是否存在以下四个文件：

       gralloc.<ro.hardware>.so

       gralloc.<ro.product.board>.so

       gralloc.<ro.board.platform>.so

       gralloc.<ro.arch>.so

       只要其中的一个文件存在，  函数hw_get_module就会停止查找过程，并且调用另外一个函数load来将这个文件加载到内存中来。另一方面，如果在/system/lib/hw和/vendor/lib/hw中均不存这些文件，那么函数hw_get_module就会在目录/system/lib/hw中查找是否存在一个名称为gralloc.default.so的文件。如果存在的话，那么也会调用函数load将它加载到内存中来。

       函数load也是实现在文件hardware/libhardware/hardware.c文件中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. static int load(const char *id, 
  2. const char *path, 
  3. const struct hw_module_t **pHmi) 
  4. { 
  5. int status; 
  6. void *handle; 
  7. struct hw_module_t *hmi; 
  9. /*
  10.      * load the symbols resolving undefined symbols before
  11.      * dlopen returns. Since RTLD_GLOBAL is not or'd in with
  12.      * RTLD_NOW the external symbols will not be global
  13.      */
  14.     handle = dlopen(path, RTLD_NOW); 
  15. if (handle == NULL) { 
  16. char const *err_str = dlerror(); 
  17.         LOGE("load: module=%s\n%s", path, err_str?err_str:"unknown"); 
  18.         status = -EINVAL; 
  19. goto done; 
  20.     } 
  22. /* Get the address of the struct hal_module_info. */
  23. const char *sym = HAL_MODULE_INFO_SYM_AS_STR; 
  24.     hmi = (struct hw_module_t *)dlsym(handle, sym); 
  25. if (hmi == NULL) { 
  26.         LOGE("load: couldn't find symbol %s", sym); 
  27.         status = -EINVAL; 
  28. goto done; 
  29.     } 
  31. /* Check that the id matches */
  32. if (strcmp(id, hmi->id) != 0) { 
  33.         LOGE("load: id=%s != hmi->id=%s", id, hmi->id); 
  34.         status = -EINVAL; 
  35. goto done; 
  36.     } 
  38.     hmi->dso = handle; 
  40. /* success */
  41.     status = 0; 
  43.     done: 
  44. if (status != 0) { 
  45.         hmi = NULL; 
  46. if (handle != NULL) { 
  47.             dlclose(handle); 
  48.             handle = NULL; 
  49.         } 
  50.     } else { 
  51.         LOGV("loaded HAL id=%s path=%s hmi=%p handle=%p", 
  52.                 id, path, *pHmi, handle); 
  53.     } 
  55.     *pHmi = hmi; 
  57. return status; 
  58. } 

        在Linux系统中，后缀名为"so"的文件为动态链接库文件，可能通过函数dlopen来加载到内存中。硬件抽象层模块编写规范规定每一个硬件抽象层模块都必须导出一个符号名称为HAL_MODULE_INFO_SYM_AS_STR的符号，而且这个符号必须是用来描述一个类型为hw_module_t的结构体的。

        HAL_MODULE_INFO_SYM_AS_STR是一个宏，定义在文件hardware/libhardware/include/hardware/hardware.h文件中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. #define HAL_MODULE_INFO_SYM_AS_STR  "HMI"

       将Gralloc模块加载到内存中来之后，就可以调用函数dlsym来获得它所导出的符号HMI。由于这个符号指向的是一个hw_module_t结构体，因此，最后函数load就可以强制地将这个符号转换为一个hw_module_t结构体指针，并且保存在输出参数pHmi中返回给调用者。调用者获得了这个hw_module_t结构体指针之后，就可以创建一个gralloc设备或者一个fb设备。

       模块Gralloc实现在目录hardware/libhardware/modules/gralloc中，它导出的符号HMI定义在文件hardware/libhardware/modules/gralloc/gralloc.cpp文件中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. static struct hw_module_methods_t gralloc_module_methods = { 
  2.         open: gralloc_device_open 
  3. }; 
  5. struct private_module_t HAL_MODULE_INFO_SYM = { 
  6.     base: { 
  7.         common: { 
  8.             tag: HARDWARE_MODULE_TAG, 
  9.             version_major: 1, 
  10.             version_minor: 0, 
  11.             id: GRALLOC_HARDWARE_MODULE_ID, 
  12.             name: "Graphics Memory Allocator Module", 
  13.             author: "The Android Open Source Project", 
  14.             methods: &gralloc_module_methods 
  15.         }, 
  16.         registerBuffer: gralloc_register_buffer, 
  17.         unregisterBuffer: gralloc_unregister_buffer, 
  18.         lock: gralloc_lock, 
  19.         unlock: gralloc_unlock, 
  20.     }, 
  21.     framebuffer: 0, 
  22.     flags: 0, 
  23.     numBuffers: 0, 
  24.     bufferMask: 0, 
  25.     lock: PTHREAD_MUTEX_INITIALIZER, 
  26.     currentBuffer: 0, 
  27. }; 

       HAL_MODULE_INFO_SYM也是一个宏，它的值是与宏HAL_MODULE_INFO_SYM_AS_STR对应的，它也是定义在文件hardware/libhardware/include/hardware/hardware.h文件中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. #define HAL_MODULE_INFO_SYM         HMI

       符号HAL_MODULE_INFO_SYM的类型为private_module_t。前面提到，符号HAL_MODULE_INFO_SYM必须指向一个hw_module_t结构体，但是这里它指向的却是一个private_module_t结构体，是不是有问题呢？为了弄清楚这个问题，我们首先了解一下结构体private_module_t的定义，如图1所示：

Android帧缓冲区（Frame Buffer）硬件抽象层（HAL）模块Gralloc的实现原理分析

图1 private_module_t结构体定义

        结构体private_module_t的第一个成员变量base指向一个gralloc_module_t结构体，而gralloc_module_t结构体的第一个成员变量common又指向了一个hw_module_t结构体，这意味着，指向一个private_module_t结构体的指针同时可以用作一个gralloc_module_t或者hw_module_t结构体提针来使用。事实上，这是使用C语言来实现的一种继承关系，等价于结构体private_module_t继承结构体gralloc_module_t，而结构体gralloc_module_t继承hw_module_t结构体。这样，我们就可以把在Gralloc模块中定义的符号HAL_MODULE_INFO_SYM看作是一个hw_module_t结构体。

        hw_module_t结构体有一个重要的成员变量methods，它的类型为hw_module_methods_t，它用来描述一个HAL模块的操作方法列表。结构体hw_module_methods_t只定义有一个操作方法open，用来打开一个指定的设备。在Gralloc模块中，用来打开指定设备的函数被指定为gralloc_device_open，通过这个函数就可以打开Gralloc模块中的gralloc或者fb设备，后面我们再详细分析。

       结构体gralloc_module_t定义在文件hardware/libhardware/include/hardware/gralloc.h中，它主要是定义了四个用来操作图形缓冲区的成员函数，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. typedef struct gralloc_module_t { 
  2.     ...... 
  4. int (*registerBuffer)(struct gralloc_module_t const* module, 
  5.             buffer_handle_t handle); 
  7. int (*unregisterBuffer)(struct gralloc_module_t const* module, 
  8.             buffer_handle_t handle); 
  11. int (*lock)(struct gralloc_module_t const* module, 
  12.             buffer_handle_t handle, int usage, 
  13. int l, int t, int w, int h, 
  14. void** vaddr); 
  16. int (*unlock)(struct gralloc_module_t const* module, 
  17.             buffer_handle_t handle); 
  19.     ...... 
  20. } 

        成员函数registerBuffer和unregisterBuffer分别用来注册和注销一个指定的图形缓冲区，这个指定的图形缓冲区使用一个buffer_handle_t句柄来描述。所谓注册图形缓冲区，实际上就是将一块图形缓冲区映射到一个进程的地址空间去，而注销图形缓冲区就是执行相反的操作。

        成员函数lock和unlock分别用来锁定和解锁一个指定的图形缓冲区，这个指定的图形缓冲区同样是使用一个buffer_handle_t句柄来描述。在访问一块图形缓冲区的时候，例如，向一块图形缓冲写入内容的时候，需要将该图形缓冲区锁定，用来避免访问冲突。在锁定一块图形缓冲区的时候，可以指定要锁定的图形绘冲区的位置以及大小，这是通过参数l、t、w和h来指定的，其中，参数l和t指定的是要访问的图形缓冲区的左上角位置，而参数w和h指定的是要访问的图形缓冲区的宽度和长度。锁定之后，就可以获得由参数参数l、t、w和h所圈定的一块缓冲区的起始地址，保存在输出参数vaddr中。另一方面，在访问完成一块图形缓冲区之后，需要解除这块图形缓冲区的锁定。

        在Gralloc模块中，符号HAL_MODULE_INFO_SYM指向的gralloc结构体的成员函数registerBuffer、unregisterBuffer、lock和unlock分别被指定为函数gralloc_register_buffer、gralloc_unregister_buffer、gralloc_lock和gralloc_unlock，后面我们再详细分析它们的实现。

        结构体private_module_t定义在文件hardware/libhardware/modules/gralloc/gralloc_priv.h中，它主要是用来描述帧缓冲区的属性，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. struct private_module_t { 
  2.     gralloc_module_t base; 
  4.     private_handle_t* framebuffer; 
  5.     uint32_t flags; 
  6.     uint32_t numBuffers; 
  7.     uint32_t bufferMask; 
  8.     pthread_mutex_t lock; 
  9.     buffer_handle_t currentBuffer; 
  10. int pmem_master; 
  11. void* pmem_master_base; 
  13. struct fb_var_screeninfo info; 
  14. struct fb_fix_screeninfo finfo; 
  15. float xdpi; 
  16. float ydpi; 
  17. float fps; 
  18. }; 

       成员变量framebuffer的类型为private_handle_t，它是一个指向系统帧缓冲区的句柄，后面我们再分析结构体private_handle_t的定义。

       成员变量flags用来标志系统帧缓冲区是否支持双缓冲。如果支持的话，那么它的PAGE_FLIP位就等于1，否则的话，就等于0。

       成员变量numBuffers表示系统帧缓冲区包含有多少个图形缓冲区。一个帧缓冲区包含有多少个图形缓冲区是与它的可视分辨率以及虚拟分辨率的大小有关的。例如，如果一个帧缓冲区的可视分辨率为800 x 600，而虚拟分辨率为1600 x 600，那么这个帧缓冲区就可以包含有两个图形缓冲区。

       成员变量bufferMask用来记录系统帧缓冲区中的图形缓冲区的使用情况。例如，假设系统帧缓冲区有两个图形缓冲区，这时候成员变量bufferMask就有四种取值，分别是二进制的00、01、10和11，其中，00分别表示两个图缓冲区都是空闲的，01表示第1个图形缓冲区已经分配出去，而第2个图形缓冲区是空闲的，10表示第1个图形缓冲区是空闲的，而第2个图形缓冲区已经分配出去，11表示两个图缓冲区都已经分配出去。

       成员变量lock是一个互斥锁，用来保护结构体private_module_t的并行访问。

       成员变量currentBuffer的类型为buffer_handle_t，用来描述当前正在被渲染的图形缓冲区，后面我们再分析它的定义。

       成员变量pmem_master和pmem_master_base目前没有使用。

       成员变量info和finfo的类型分别为fb_var_screeninfo和fb_fix_screeninfo，它们用来保存设备显示屏的属性信息，其中，成员变量info保存的属性信息是可以动态设置的，而成员变量finfo保存的属性信息是只读的。这两个成员变量的值可以通过IO控制命令FBIOGET_VSCREENINFO和FBIOGET_FSCREENINFO来从帧缓冲区驱动模块中获得。

       成员变量xdpi和ydpi分别用来描述设备显示屏在宽度和高度上的密度，即每英寸有多少个像素点。

       成员变量fps用来描述显示屏的刷新频率，它的单位的fps，即每秒帧数。

       接下来， 我们再分析结构体buffer_handle_t和private_handle_t的定义。

       结构体buffer_handle_t定义在文件hardware/libhardware/include/hardware/gralloc.h文件中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. typedef const native_handle* buffer_handle_t; 

       它是一个类型为native_handle_t的指针，而结构体native_handle_t用来描述一个本地句柄值，它定义在系统运行时层的文件system/core/include/cutils/native_handle.h文件中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. typedef struct
  2. { 
  3. int version;        /* sizeof(native_handle_t) */
  4. int numFds;         /* number of file-descriptors at &data[0] */
  5. int numInts;        /* number of ints at &data[numFds] */
  6. int data[0];        /* numFds + numInts ints */
  7. } native_handle_t; 

       成员变量version的大小被设置为结构体native_handle_t的大小，用来标识结构体native_handle_t的版本。

       成员变量numFds和numInts表示结构体native_handle_t所包含的文件描述符以及整数值的个数，这些文件描述符和整数保存在成员变量data所指向的一块缓冲区中。

       我们一般不直接使用native_handle_t结构体来描述一个本地句柄值，而是通过它的子类来描述一个具体的本地句柄值。接下来我们就通过结构体private_handle_t的定义来说明native_handle_t结构体的用法。

       结构体private_handle_t用来描述一块图形缓冲区，这块图形缓冲区可能是在帧缓冲区中分配的，也可能是在内存中分配的，视具体情况而定，它定义在文件hardware/libhardware/modules/gralloc/gralloc_priv.h文件中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. #ifdef __cplusplus
  2. struct private_handle_t : public native_handle { 
  3. #else
  4. struct private_handle_t { 
  5. struct native_handle nativeHandle; 
  6. #endif
  8. enum { 
  9.         PRIV_FLAGS_FRAMEBUFFER = 0x00000001 
  10.     }; 
  12. // file-descriptors
  13. int     fd; 
  14. // ints
  15. int     magic; 
  16. int     flags; 
  17. int     size; 
  18. int     offset; 
  20. // FIXME: the attributes below should be out-of-line
  21. int     base; 
  22. int     pid; 
  24. #ifdef __cplusplus
  25. static const int sNumInts = 6; 
  26. static const int sNumFds = 1; 
  27. static const int sMagic = 0x3141592; 
  29.     private_handle_t(int fd, int size, int flags) : 
  30.         fd(fd), magic(sMagic), flags(flags), size(size), offset(0), 
  31.         base(0), pid(getpid()) 
  32.     { 
  33.         version = sizeof(native_handle); 
  34.         numInts = sNumInts; 
  35.         numFds = sNumFds; 
  36.     } 
  37.     ~private_handle_t() { 
  38.         magic = 0; 
  39.     } 
  41. static int validate(const native_handle* h) { 
  42. const private_handle_t* hnd = (const private_handle_t*)h; 
  43. if (!h || h->version != sizeof(native_handle) || 
  44.                 h->numInts != sNumInts || h->numFds != sNumFds || 
  45.                 hnd->magic != sMagic) 
  46.         { 
  47.             LOGE("invalid gralloc handle (at %p)", h); 
  48. return -EINVAL; 
  49.         } 
  50. return 0; 
  51.     } 
  52. #endif
  53. }; 

        为了方便描述，我们假设我们是在C++环境中编译文件gralloc_priv.h，即编译环境定义有宏__cplusplus。这样，结构体private_handle_t就是从结构体native_handle_t继承下来的，它包含有1个文件描述符以及6个整数，以及三个静态成员变量。

        成员变量fd指向一个文件描述符，这个文件描述符要么指向帧缓冲区设备，要么指向一块匿名共享内存，取决于它的宿主结构体private_handle_t描述的一个图形缓冲区是在帧缓冲区分配的，还是在内存中分配的。

        成员变量magic指向一个魔数，它的值由静态成员变量sMagic来指定，用来标识一个private_handle_t结构体。

        成员变量flags用来描述一个图形缓冲区的标志，它的值要么等于0，要么等于PRIV_FLAGS_FRAMEBUFFER。当一个图形缓冲区的标志值等于PRIV_FLAGS_FRAMEBUFFER的时候，就表示它是在帧缓冲区中分配的。

       成员变量size用来描述一个图形缓冲区的大小。

       成员变量offset用来描述一个图形缓冲区的偏移地址。例如，当一个图形缓冲区是在一块内存中分块的时候，假设这块内存的地址为start，那么这个图形缓冲区的起始地址就为start + offset。

       成员变量base用来描述一个图形缓冲区的实际地址，它是通过成员变量offset来计算得到的。例如，上面计算得到的start + offset的值就保存在成员变量base中。

       成员变量pid用来描述一个图形缓冲区的创建者的PID。例如，如果一个图形缓冲区是在ID值为1000的进程中创建的，那么用来描述这个图形缓冲区的private_handle_t结构体的成员变量pid的值就等于1000。

       结构体private_handle_t的静态成员变量sMagic前面已经描述过了，另外两个静态成员变量sNumInts和sNumFds的值分别等于1和6，表示结构体private_handle_t包含有1个文件描述符和6个整数，它们是用来初始化结构体private_handle_t的父类native_handle_t的成员变量numInts和numFds的，如结构体private_handle_t的构造函数所示。从这里就可以看出，结构体private_handle_t的父类native_handle_t的成员变量data所指向的缓冲区就是由结构体private_handle_t的成员变量fds、magic、flags、size、offset、base和pid所占用的连续内存块来组成的，一共包含有7个整数。

       结构体private_handle_t还定义了一个静态成员函数validate，用来验证一个native_handle_t指针是否指向了一个private_handle_t结构体。

       至此，Gralloc模块的加载过程以及相关的数据结构体就介绍到这里，接下来我们分别分析定义在Gralloc模块中的gralloc和fb设备的打开过程。

       2. gralloc设备的打开过程

       在Gralloc模块中，gralloc设备的ID值定义为GRALLOC_HARDWARE_GPU0。GRALLOC_HARDWARE_GPU0是一个宏，定义在文件hardware/libhardware/include/hardware/gralloc.h中， 如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. #define GRALLOC_HARDWARE_GPU0 "gpu0"

       gralloc设备使用结构体alloc_device_t 来描述。结构体alloc_device_t有两个成员函数alloc和free，分别用来分配和释放图形缓冲区。

       结构体alloc_device_t 也是定义在文件hardware/libhardware/include/hardware/gralloc.h中， 如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. typedef struct alloc_device_t { 
  2. struct hw_device_t common; 
  4. int (*alloc)(struct alloc_device_t* dev, 
  5. int w, int h, int format, int usage, 
  6.             buffer_handle_t* handle, int* stride); 
  8. int (*free)(struct alloc_device_t* dev, 
  9.             buffer_handle_t handle); 
  11. } alloc_device_t; 

       Gralloc模块在在文件hardware/libhardware/include/hardware/gralloc.h中定义了一个帮助函数gralloc_open，用来打开gralloc设备，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. static inline int gralloc_open(const struct hw_module_t* module, 
  2. struct alloc_device_t** device) { 
  3. return module->methods->open(module, 
  4.             GRALLOC_HARDWARE_GPU0, (struct hw_device_t**)device); 
  5. } 

       参数module指向的是一个用来描述Gralloc模块的hw_module_t结构体，它的成员变量methods所指向的一个hw_module_methods_t结构体的成员函数open指向了Gralloc模块中的函数gralloc_device_open。

       函数gralloc_device_open定义在文件hardware/libhardware/modules/gralloc/gralloc.cpp文件中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. struct gralloc_context_t { 
  2.     alloc_device_t  device; 
  3. /* our private data here */
  4. }; 
  6. ...... 
  8. int gralloc_device_open(const hw_module_t* module, const char* name, 
  9.         hw_device_t** device) 
  10. { 
  11. int status = -EINVAL; 
  12. if (!strcmp(name, GRALLOC_HARDWARE_GPU0)) { 
  13.         gralloc_context_t *dev; 
  14.         dev = (gralloc_context_t*)malloc(sizeof(*dev)); 
  16. /* initialize our state here */
  17.         memset(dev, 0, sizeof(*dev)); 
  19. /* initialize the procs */
  20.         dev->device.common.tag = HARDWARE_DEVICE_TAG; 
  21.         dev->device.common.version = 0; 
  22.         dev->device.common.module = const_cast<hw_module_t*>(module); 
  23.         dev->device.common.close = gralloc_close; 
  25.         dev->device.alloc   = gralloc_alloc; 
  26.         dev->device.free    = gralloc_free; 
  28.         *device = &dev->device.common; 
  29.         status = 0; 
  30.     }  
  31.     ...... 
  33. return status; 
  34. } 

        这个函数主要是用来创建一个gralloc_context_t结构体，并且对它的成员变量device进行初始化。结构体gralloc_context_t的成员变量device的类型为gralloc_device_t，它用来描述一个gralloc设备。前面提到，gralloc设备是用来分配和释放图形缓冲区的，这是通过调用它的成员函数alloc和free来实现的。从这里可以看出，函数gralloc_device_open所打开的gralloc设备的成员函数alloc和free分别被设置为Gralloc模块中的函数gralloc_alloc和gralloc_free，后面我们再详细分析它们的实现。

        至此，gralloc设备的打开过程就分析完成了，接下来我们继续分析fb设备的打开过程。

        3. fb设备的打开过程

        在Gralloc模块中，fb设备的ID值定义为GRALLOC_HARDWARE_FB0。GRALLOC_HARDWARE_FB0是一个宏，定义在文件hardware/libhardware/include/hardware/gralloc.h中， 如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. #define GRALLOC_HARDWARE_FB0 "fb0"

       fb设备使用结构体framebuffer_device_t 来描述。结构体framebuffer_device_t是用来描述系统帧缓冲区的信息，它定义在文件hardware/libhardware/include/hardware/gralloc.h中， 如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. typedef struct framebuffer_device_t { 
  2. struct hw_device_t common; 
  4. /* flags describing some attributes of the framebuffer */
  5. const uint32_t  flags; 
  7. /* dimensions of the framebuffer in pixels */
  8. const uint32_t  width; 
  9. const uint32_t  height; 
  11. /* frambuffer stride in pixels */
  12. const int       stride; 
  14. /* framebuffer pixel format */
  15. const int       format; 
  17. /* resolution of the framebuffer's display panel in pixel per inch*/
  18. const float     xdpi; 
  19. const float     ydpi; 
  21. /* framebuffer's display panel refresh rate in frames per second */
  22. const float     fps; 
  24. /* min swap interval supported by this framebuffer */
  25. const int       minSwapInterval; 
  27. /* max swap interval supported by this framebuffer */
  28. const int       maxSwapInterval; 
  30. int reserved[8]; 
  32. int (*setSwapInterval)(struct framebuffer_device_t* window, 
  33. int interval); 
  35. int (*setUpdateRect)(struct framebuffer_device_t* window, 
  36. int left, int top, int width, int height); 
  38. int (*post)(struct framebuffer_device_t* dev, buffer_handle_t buffer); 
  40. int (*compositionComplete)(struct framebuffer_device_t* dev); 
  42. void* reserved_proc[8]; 
  44. } framebuffer_device_t; 

        成员变量flags用来记录系统帧缓冲区的标志，目前没有使用这成员变量，它的值被设置为0。

        成员变量width和height分别用来描述设备显示屏的宽度和高度，它们是以像素为单位的。

        成员变量stride用来描述设备显示屏的一行有多少个像素点。

        成员变量format用来描述系统帧缓冲区的像素格式，支持的像素格式主要有HAL_PIXEL_FORMAT_RGBX_8888和HAL_PIXEL_FORMAT_RGB_565两种。HAL_PIXEL_FORMAT_RGBX_8888表示一个像素使用32位来描述，R、G和B分别占8位，另外8位未使用。HAL_PIXEL_FORMAT_RGB_565表示一个像素使用16位来描述，R、G和B分别占5、6和5位。

        成员变量xdpi和ydpi分别用来描述设备显示屏在宽度和高度上的密度，即每英寸有多少个像素点。

        成员变量fps用来描述设备显示屏的刷新频率，它的单位是帧每秒。

        成员变量minSwapInterval和maxSwapInterval用来描述帧缓冲区交换前后两个图形缓冲区的最小和最大时间间隔。

        成员变量reserved是保留给将来使用的。

        成员函数setSwapInterval用来设置帧缓冲区交换前后两个图形缓冲区的最小和最大时间间隔。

        成员函数setUpdateRect用来设置帧缓冲区的更新区域。

        成员函数post用来将图形缓冲区buffer的内容渲染到帧缓冲区中去，即显示在设备的显示屏中去。

        成员函数compositionComplete用来通知fb设备device，图形缓冲区的组合工作已经完成，目前没有使用这个成员函数。

        成员变量reserved是一个函数指针数组，它们是保留给将来使用的。

        在结构体framebuffer_device_t的一系列成员函数中，post是最重要的一个成员函数，用户空间的应用程序通过调用这个成员函数就可以在设备的显示屏中渲染指定的画面，后面我们将详细这个函数的实现。

        Gralloc模块在在文件hardware/libhardware/include/hardware/gralloc.h中定义了一个帮助函数framebuffer_open，用来打开fb设备，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. static inline int framebuffer_open(const struct hw_module_t* module, 
  2. struct framebuffer_device_t** device) { 
  3. return module->methods->open(module, 
  4.             GRALLOC_HARDWARE_FB0, (struct hw_device_t**)device); 
  5. } 

       参数module指向的是一个用来描述Gralloc模块的hw_module_t结构体，前面提到，它的成员变量methods所指向的一个hw_module_methods_t结构体的成员函数open指向了Gralloc模块中的函数gralloc_device_open，这个函数打开fb设备的代码段如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. int gralloc_device_open(const hw_module_t* module, const char* name, 
  2.         hw_device_t** device) 
  3. { 
  4. int status = -EINVAL; 
  5. if (!strcmp(name, GRALLOC_HARDWARE_GPU0)) { 
  6.         ...... 
  7.     } else { 
  8.         status = fb_device_open(module, name, device); 
  9.     } 
  10. return status; 
  11. } 

       参数name的值等于GRALLOC_HARDWARE_FB0，因此，函数gralloc_device_open接下来会调用另外一个函数fb_device_open来执行打开fb设备的操作。

       函数fb_device_open定义在文件hardware/libhardware/modules/gralloc/framebuffer.cpp中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. struct fb_context_t { 
  2.     framebuffer_device_t  device; 
  3. }; 
  5. ...... 
  7. int fb_device_open(hw_module_t const* module, const char* name, 
  8.         hw_device_t** device) 
  9. { 
  10. int status = -EINVAL; 
  11. if (!strcmp(name, GRALLOC_HARDWARE_FB0)) { 
  12.         alloc_device_t* gralloc_device; 
  13.         status = gralloc_open(module, &gralloc_device); 
  14. if (status < 0) 
  15. return status; 
  17. /* initialize our state here */
  18.         fb_context_t *dev = (fb_context_t*)malloc(sizeof(*dev)); 
  19.         memset(dev, 0, sizeof(*dev)); 
  21. /* initialize the procs */
  22.         dev->device.common.tag = HARDWARE_DEVICE_TAG; 
  23.         dev->device.common.version = 0; 
  24.         dev->device.common.module = const_cast<hw_module_t*>(module); 
  25.         dev->device.common.close = fb_close; 
  26.         dev->device.setSwapInterval = fb_setSwapInterval; 
  27.         dev->device.post            = fb_post; 
  28.         dev->device.setUpdateRect = 0; 
  30.         private_module_t* m = (private_module_t*)module; 
  31.         status = mapFrameBuffer(m); 
  32. if (status >= 0) { 
  33. int stride = m->finfo.line_length / (m->info.bits_per_pixel >> 3); 
  34. int format = (m->info.bits_per_pixel == 32) 
  35.                          ? HAL_PIXEL_FORMAT_RGBX_8888 
  36.                          : HAL_PIXEL_FORMAT_RGB_565; 
  37. #ifdef NO_32BPP
  38.             format = HAL_PIXEL_FORMAT_RGB_565; 
  39. #endif
  40. const_cast<uint32_t&>(dev->device.flags) = 0; 
  41. const_cast<uint32_t&>(dev->device.width) = m->info.xres; 
  42. const_cast<uint32_t&>(dev->device.height) = m->info.yres; 
  43. const_cast<int&>(dev->device.stride) = stride; 
  44. const_cast<int&>(dev->device.format) = format; 
  45. const_cast<float&>(dev->device.xdpi) = m->xdpi; 
  46. const_cast<float&>(dev->device.ydpi) = m->ydpi; 
  47. const_cast<float&>(dev->device.fps) = m->fps; 
  48. const_cast<int&>(dev->device.minSwapInterval) = 1; 
  49. const_cast<int&>(dev->device.maxSwapInterval) = 1; 
  50.             *device = &dev->device.common; 
  51.         } 
  52.     } 
  53. return status; 
  54. } 

        这个函数主要是用来创建一个fb_context_t结构体，并且对它的成员变量device进行初始化。结构体fb_context_t的成员变量device的类型为framebuffer_device_t，前面提到，它是用来描述fb设备的。fb设备主要是用来渲染图形缓冲区的，这是通过调用它的成员函数post来实现的。从这里可以看出，函数fb_device_open所打开的fb设备的成员函数post被设置为Gralloc模块中的函数fb_post，后面我们再详细分析它的实现。

        函数fb_device_open在打开fb设备的过程中，会调用另外一个函数mapFrameBuffer来获得系统帧缓冲区的信息，并且将这些信息保存在参数module所描述的一个private_module_t结构体的各个成员变量中。有了系统帧缓冲区的信息之后，函数fb_device_open接下来就可以对前面所打开的一个fb设备的各个成员变量进行初始化。这些成员变量的含义可以参考前面对结构体framebuffer_device_t的介绍。接下来我们只简单介绍一下结构体framebuffer_device_t的成员变量stride和format的初始化过程。

        变量m的成员变量finfo的类型为fb_fix_screeninfo，它是在函数mapFrameBuffer中被始化的。fb_fix_screeninfo是在内核中定义的一个结构体，用来描述设备显示屏的固定属性信息，其中，它的成员变量line_length用来描述显示屏一行像素总共所占用的字节数。

        变量m的另外一个成员变量info的类型为fb_var_screeninfo，它也是在函数mapFrameBuffer中被始化的。fb_var_screeninfo也是内核中定义的一个结构体，用来描述可以动态设置的显示屏属性信息，其中，它的成员变量bits_per_pixel用来描述显示屏每一个像素所占用的位数。

        这样，我们将m->info.bits_per_pixel的值向右移3位，就可以得到显示屏每一个像素所占用的字节数。用显示屏每一个像素所占用的字节数去除显示屏一行像素总共所占用的字节数m->finfo.line_length，就可以得到显示屏一行有多少个像素点。这个值最终就可以保存在前面所打开的fb设备的成员变量stride中。

        当显示屏每一个像素所占用的位数等于32的时候，那么前面所打开的fb设备的像素格式format就会被设置为HAL_PIXEL_FORMAT_RGBX_8888，否则的话，就会被设置为HAL_PIXEL_FORMAT_RGB_565。另一方面，如果在编译的时候定义了NO_32BPP宏，即不要使用32位来描述一个像素，那么函数fb_device_open就会强制将前面所打开的fb设备的像素格式format设置为HAL_PIXEL_FORMAT_RGB_565。

        函数mapFrameBuffer除了用来获得系统帧缓冲区的信息之外，还会将系统帧缓冲区映射到当前进程的地址空间来。在Android系统中，Gralloc模块中的fb设备是由SurfaceFlinger服务来负责打开和管理的，而SurfaceFlinger服是运行System进程中的，因此，系统帧缓冲区实际上是映射到System进程的地址空间中的。

        函数mapFrameBuffer实现在文件hardware/libhardware/modules/gralloc/framebuffer.cpp，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. static int mapFrameBuffer(struct private_module_t* module) 
  2. { 
  3.     pthread_mutex_lock(&module->lock); 
  4. int err = mapFrameBufferLocked(module); 
  5.     pthread_mutex_unlock(&module->lock); 
  6. return err; 
  7. } 

       这个函数调用了同一个文件中的另外一个函数mapFrameBufferLocked来初始化参数module以及将系统帧缓冲区映射到当前进程的地址空间来。

       函数mapFrameBufferLocked的实现比较长，我们分段来阅读：

[cpp] view plaincopy在CODE上查看代码片

  1. int mapFrameBufferLocked(struct private_module_t* module) 
  2. { 
  3. // already initialized...
  4. if (module->framebuffer) { 
  5. return 0; 
  6.     } 
  8. char const * const device_template[] = { 
  9. "/dev/graphics/fb%u", 
  10. "/dev/fb%u", 
  11.             0 }; 
  13. int fd = -1; 
  14. int i=0; 
  15. char name[64]; 
  17. while ((fd==-1) && device_template[i]) { 
  18.         snprintf(name, 64, device_template[i], 0); 
  19.         fd = open(name, O_RDWR, 0); 
  20.         i++; 
  21.     } 
  22. if (fd < 0) 
  23. return -errno; 

        这段代码在首先在系统中检查是否存在设备文件/dev/graphics/fb0或者/dev/fb0。如果存在的话，那么就调用函数open来打开它，并且将得到的文件描述符保存在变量fd中。这样，接下来函数mapFrameBufferLocked就可以通过文件描述符fd来与内核中的帧缓冲区驱动程序交互。

        继续往下看函数mapFrameBufferLocked：

[cpp] view plaincopy在CODE上查看代码片

  1. struct fb_fix_screeninfo finfo; 
  2. if (ioctl(fd, FBIOGET_FSCREENINFO, &finfo) == -1) 
  3. return -errno; 
  5. struct fb_var_screeninfo info; 
  6. if (ioctl(fd, FBIOGET_VSCREENINFO, &info) == -1) 
  7. return -errno; 

       这几行代码分别通过IO控制命令FBIOGET_FSCREENINFO和FBIOGET_VSCREENINFO来获得系统帧缓冲区的信息，分别保存在fb_fix_screeninfo结构体finfo和fb_var_screeninfo结构体info中。

        再往下看函数mapFrameBufferLocked：

[cpp] view plaincopy在CODE上查看代码片

  1.     info.reserved[0] = 0; 
  2.     info.reserved[1] = 0; 
  3.     info.reserved[2] = 0; 
  4.     info.xoffset = 0; 
  5.     info.yoffset = 0; 
  6.     info.activate = FB_ACTIVATE_NOW; 
  8. #if defined(NO_32BPP)
  9. /*
  10.      * Explicitly request 5/6/5
  11.      */
  12.     info.bits_per_pixel = 16; 
  13.     info.red.offset     = 11; 
  14.     info.red.length     = 5; 
  15.     info.green.offset   = 5; 
  16.     info.green.length   = 6; 
  17.     info.blue.offset    = 0; 
  18.     info.blue.length    = 5; 
  19.     info.transp.offset  = 0; 
  20.     info.transp.length  = 0; 
  21. #endif
  23. /*
  24.      * Request NUM_BUFFERS screens (at lest 2 for page flipping)
  25.      */
  26.     info.yres_virtual = info.yres * NUM_BUFFERS; 
  29.     uint32_t flags = PAGE_FLIP; 
  30. if (ioctl(fd, FBIOPUT_VSCREENINFO, &info) == -1) { 
  31.         info.yres_virtual = info.yres; 
  32.         flags &= ~PAGE_FLIP; 
  33.         LOGW("FBIOPUT_VSCREENINFO failed, page flipping not supported"); 
  34.     } 
  36. if (info.yres_virtual < info.yres * 2) { 
  37. // we need at least 2 for page-flipping
  38.         info.yres_virtual = info.yres; 
  39.         flags &= ~PAGE_FLIP; 
  40.         LOGW("page flipping not supported (yres_virtual=%d, requested=%d)", 
  41.                 info.yres_virtual, info.yres*2); 
  42.     } 

       这段代码主要是用来设置设备显示屏的虚拟分辨率。在前面Android系统的开机画面显示过程分析一文提到，结构体fb_var_screeninfo的成员变量xres和yres用来描述显示屏的可视分辨率，而成员变量xres_virtual和yres_virtual用来描述显示屏的虚拟分辨率。这里保持可视分辨率以及虚拟分辨率的宽度值不变，而将虚拟分辨率的高度值设置为可视分辨率的高度值的NUM_BUFFERS倍。NUM_BUFFERS是一个宏，它的值被定义为2。这样，我们就可以将系统帧缓冲区划分为两个图形缓冲区来使用，即可以通过硬件来实现双缓冲技术。

       在结构体fb_var_screeninfo中，与显示屏的可视分辨率和虚拟分辨率相关的另外两个成员变量是xoffset和yoffset，它们用来告诉帧缓冲区当前要渲染的图形缓冲区是哪一个，它们的使用方法可以参考前面Android系统的开机画面显示过程分析一文。

       这段代码在设置设备显示屏的虚拟分辨率之前，还会检查是否定义了宏NO_32BPP。如果定义了的话，那么就说明系统显式地要求将帧缓冲区的像素格式设置为HAL_PIXEL_FORMAT_RGB_565。在这种情况下，这段代码就会通过fb_var_screeninfo结构体info的成员变量bits_per_pixel、red、green、blue和transp来通知帧缓冲区驱动程序使用HAL_PIXEL_FORMAT_RGB_565像素格式来渲染显示屏。

        这段代码最终是通过IO控制命令FBIOPUT_VSCREENINFO来设置设备显示屏的虚拟分辨率以及像素格式的。如果设置失败，即调用函数ioctl的返回值等于-1，那么很可能是因为系统帧缓冲区在硬件上不支持双缓冲，因此，接下来的代码就会重新将显示屏的虚拟分辨率的高度值设置为可视分辨率的高度值，并且将变量flags的PAGE_FLIP位置为0。

        另一方面，如果调用函数ioctl成功，但是最终获得的显示屏的虚拟分辨率的高度值小于可视分辨率的高度值的2倍，那么也说明系统帧缓冲区在硬件上不支持双缓冲。在这种情况下，接下来的代码也会重新将显示屏的虚拟分辨率的高度值设置为可视分辨率的高度值，并且将变量flags的PAGE_FLIP位置为0。

        再继续往下看函数mapFrameBufferLocked：

[cpp] view plaincopy在CODE上查看代码片

  1. if (ioctl(fd, FBIOGET_VSCREENINFO, &info) == -1) 
  2. return -errno; 
  4. uint64_t  refreshQuotient = 
  5. ( 
  6.         uint64_t( info.upper_margin + info.lower_margin + info.yres ) 
  7.         * ( info.left_margin  + info.right_margin + info.xres ) 
  8.         * info.pixclock 
  9. ); 
  11. /* Beware, info.pixclock might be 0 under emulation, so avoid a
  12. * division-by-0 here (SIGFPE on ARM) */
  13. int refreshRate = refreshQuotient > 0 ? (int)(1000000000000000LLU / refreshQuotient) : 0; 
  15. if (refreshRate == 0) { 
  16. // bleagh, bad info from the driver
  17.     refreshRate = 60*1000;  // 60 Hz
  18. } 

        这段代码再次通过IO控制命令FBIOGET_VSCREENINFO来获得系统帧缓冲区的可变属性信息，并且保存在fb_var_screeninfo结构体info中，接下来再计算设备显示屏的刷新频率。

        显示屏的刷新频率与显示屏的扫描时序相关。显示屏的扫描时序可以参考Linux内核源代码目录下的Documentation/fb/framebuffer.txt文件。我们结合图2来简单说明上述代码是如何计算显示屏的刷新频率的。

Android帧缓冲区（Frame Buffer）硬件抽象层（HAL）模块Gralloc的实现原理分析

图 2 显示屏扫描时序示意图

        中间由xres和yres组成的区域即为显示屏的图形绘制区，在绘制区的上、下、左和右分别有四个边距upper_margin、lower_margin、left_margin和right_margin。此外，在显示屏的最右边以及最下边还有一个水平同步区域hsync_len和一个垂直同步区域vsync_len。电子枪按照从左到右、从上到下的顺序来显示屏中打点，从而可以将要渲染的图形显示在屏幕中。前面所提到的区域信息分别保存在fb_var_screnninfo结构体info的成员变量xres、yres、upper_margin、lower_margin、left_margin、right_margin、hsync_len和vsync_len。

        电子枪每在xres和yres所组成的区域中打一个点所花费的时间记录在fb_var_screnninfo结构体info的成员变量pixclock，单位为pico seconds，即10E-12秒。

        电子枪从左到右扫描完成一行之后，都会处理关闭状态，并且会重新折回到左边去。由于电子枪在从右到左折回的过程中不需要打点，因此，这个过程会比从左到右扫描屏幕的过程要快，这个折回的时间大概就等于在xres和yres所组成的区域扫描（left_margin+right_margin）个点的时间。这样，我们就可以认为每渲染一行需要的时间为（xres + left_margin + right_margin）* pixclock。

       同样，电子枪从上到下扫描完成显示屏之后，需要从右下角折回到左上角去，折回的时间大概等于在xres和yres所组成的区域中扫描（upper_margin + lower_margin）行所需要的时间。这样，我们就可以认为每渲染一屏图形所需要的时间等于在xres和yres所组成的区域中扫描（yres + upper_margin + lower_margin）行所需要的时间。由于在xres和yres所组成的区域中扫描一行所需要的时间为（xres + left_margin + right_margin）* pixclock，因此，每渲染一屏图形所需要的总时间就等于（yres + upper_margin + lower_margin）* （xres + left_margin + right_margin）* pixclock。

       每渲染一屏图形需要的总时间经过计算之后，就保存在变量refreshQuotient中。注意，变量refreshQuotient所描述的时间的单位为1E-12秒。这样，将变量refreshQuotient的值倒过来，就可以得到设备显示屏的刷新频率。将这个频率值乘以10E15次方之后，就得到一个单位为10E-3 HZ的刷新频率，保存在变量refreshRate中。

       当Android系统在模拟器运行的时候，保存在fb_var_screnninfo结构体info的成员变量pixclock中的值可能等于0。在这种情况下，前面计算得到的变量refreshRate的值就会等于0。在这种情况下，接下来的代码会将变量refreshRate的值设置为60 * 1000 * 10E-3 HZ，即将显示屏的刷新频率设置为60HZ。

       再往下看函数mapFrameBufferLocked：

[cpp] view plaincopy在CODE上查看代码片

  1. if (int(info.width) <= 0 || int(info.height) <= 0) { 
  2. // the driver doesn't return that information
  3. // default to 160 dpi
  4.     info.width  = ((info.xres * 25.4f)/160.0f + 0.5f); 
  5.     info.height = ((info.yres * 25.4f)/160.0f + 0.5f); 
  6. } 
  8. float xdpi = (info.xres * 25.4f) / info.width; 
  9. float ydpi = (info.yres * 25.4f) / info.height; 
  10. float fps  = refreshRate / 1000.0f; 

        这段代码首先计算显示屏的密度，即每英寸有多少个像素点，分别宽度和高度两个维度，分别保存在变量xdpi和ydpi中。注意，fb_var_screeninfo结构体info的成员变量width和height用来描述显示屏的宽度和高度，它们是以毫米（mm）为单位的。

        这段代码接着再将前面计算得到的显示屏刷新频率的单位由10E-3 HZ转换为HZ，即帧每秒，并且保存在变量fps中。

        再往下看函数mapFrameBufferLocked：

[cpp] view plaincopy在CODE上查看代码片

  1. if (ioctl(fd, FBIOGET_FSCREENINFO, &finfo) == -1) 
  2. return -errno; 
  4. if (finfo.smem_len <= 0) 
  5. return -errno; 
  8. module->flags = flags; 
  9. module->info = info; 
  10. module->finfo = finfo; 
  11. module->xdpi = xdpi; 
  12. module->ydpi = ydpi; 
  13. module->fps = fps; 

       这段代码再次通过IO控制命令FBIOGET_FSCREENINFO来获得系统帧缓冲区的固定信息，并且保存在fb_fix_screeninfo结构体finfo中，接下来再使用fb_fix_screeninfo结构体finfo以及前面得到的系统帧缓冲区的其它信息来初始化参数module所描述的一个private_module_t结构体。

       最后，函数mapFrameBufferLocked就将系统帧缓冲区映射到当前进程的地址空间来：

[cpp] view plaincopy在CODE上查看代码片

  1. /*
  2.      * map the framebuffer
  3.      */
  5. int err; 
  6. size_t fbSize = roundUpToPageSize(finfo.line_length * info.yres_virtual); 
  7.     module->framebuffer = new private_handle_t(dup(fd), fbSize, 0); 
  9.     module->numBuffers = info.yres_virtual / info.yres; 
  10.     module->bufferMask = 0; 
  12. void* vaddr = mmap(0, fbSize, PROT_READ|PROT_WRITE, MAP_SHARED, fd, 0); 
  13. if (vaddr == MAP_FAILED) { 
  14.         LOGE("Error mapping the framebuffer (%s)", strerror(errno)); 
  15. return -errno; 
  16.     } 
  17.     module->framebuffer->base = intptr_t(vaddr); 
  18.     memset(vaddr, 0, fbSize); 
  19. return 0; 
  20. } 

        表达式finfo.line_length * info.yres_virtual计算的是整个系统帧缓冲区的大小，它的值等于显示屏行数（虚拟分辨率的高度值，info.yres_virtual）乘以每一行所占用的字节数（finfo.line_length）。函数roundUpToPageSize用来将整个系统帧缓冲区的大小对齐到页面边界。对齐后的大小保存在变量fbSize中。

        表达式finfo.yres_virtual / info.yres计算的是整个系统帧缓冲区可以划分为多少个图形缓冲区来使用，这个数值保存在参数module所描述的一个private_module_t结构体的成员变量nmBuffers中。参数module所描述的一个private_module_t结构体的另外一个成员变量bufferMask的值接着被设置为0，表示系统帧缓冲区中的所有图形缓冲区都是处于空闲状态，即它们可以分配出去给应用程序使用。

        系统帧缓冲区是通过调用函数mmap来映射到当前进程的地址空间来的。映射后得到的地址空间使用一个private_handle_t结构体来描述，这个结构体的成员变量base保存的即为系统帧缓冲区在当前进程的地址空间中的起始地址。这样，Gralloc模块以后就可以从这块地址空间中分配图形缓冲区给当前进程使用。

        至此，fb设备的打开过程就分析完成了。在打开fb设备的过程中，Gralloc模块还完成了对系统帧缓冲区的初始化工作。接下来我们继续分析Gralloc模块是如何分配图形缓冲区给用户空间的应用程序使用的。

        4. 分配图形缓冲区

        前面提到，用户空间的应用程序用到的图形缓冲区是由Gralloc模块中的函数gralloc_alloc来分配的，这个函数实现在文件hardware/libhardware/modules/gralloc/gralloc.cpp中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. static int gralloc_alloc(alloc_device_t* dev, 
  2. int w, int h, int format, int usage, 
  3.         buffer_handle_t* pHandle, int* pStride) 
  4. { 
  5. if (!pHandle || !pStride) 
  6. return -EINVAL; 
  8. size_t size, stride; 
  10. int align = 4; 
  11. int bpp = 0; 
  12. switch (format) { 
  13. case HAL_PIXEL_FORMAT_RGBA_8888: 
  14. case HAL_PIXEL_FORMAT_RGBX_8888: 
  15. case HAL_PIXEL_FORMAT_BGRA_8888: 
  16.             bpp = 4; 
  17. break; 
  18. case HAL_PIXEL_FORMAT_RGB_888: 
  19.             bpp = 3; 
  20. break; 
  21. case HAL_PIXEL_FORMAT_RGB_565: 
  22. case HAL_PIXEL_FORMAT_RGBA_5551: 
  23. case HAL_PIXEL_FORMAT_RGBA_4444: 
  24.             bpp = 2; 
  25. break; 
  26. default: 
  27. return -EINVAL; 
  28.     } 
  29. size_t bpr = (w*bpp + (align-1)) & ~(align-1); 
  30.     size = bpr * h; 
  31.     stride = bpr / bpp; 
  33. int err; 
  34. if (usage & GRALLOC_USAGE_HW_FB) { 
  35.         err = gralloc_alloc_framebuffer(dev, size, usage, pHandle); 
  36.     } else { 
  37.         err = gralloc_alloc_buffer(dev, size, usage, pHandle); 
  38.     } 
  40. if (err < 0) { 
  41. return err; 
  42.     } 
  44.     *pStride = stride; 
  45. return 0; 
  46. } 

        参数format用来描述要分配的图形缓冲区的颜色格式。当format值等于HAL_PIXEL_FORMAT_RGBA_8888、HAL_PIXEL_FORMAT_RGBX_8888或者HAL_PIXEL_FORMAT_BGRA_8888的时候，一个像素需要使用32位来表示，即4个字节。当format值等于HAL_PIXEL_FORMAT_RGB_888的时候，一个像素需要使用24位来描述，即3个字节。当format值等于HAL_PIXEL_FORMAT_RGB_565、HAL_PIXEL_FORMAT_RGBA_5551或者HAL_PIXEL_FORMAT_RGBA_4444的时候，一个像需要使用16位来描述，即2个字节。最终一个像素需要使用的字节数保存在变量bpp中。

        参数w表示要分配的图形缓冲区所保存的图像的宽度，将它乘以bpp，就可以得到保存一行像素所需要使用的字节数。我们需要将这个字节数对齐到4个字节边界，最后得到一行像素所需要的字节数就保存在变量bpr中。

        参数h表示要分配的图形缓冲区所保存的图像的高度，将它乘以bpr，就可以得到保存整个图像所需要使用的字节数。

        将变量bpr的值除以变量bpp的值，就得到要分配的图形缓冲区一行包含有多少个像素点，这个结果需要保存在输出参数pStride中，以便可以返回给调用者。

        参数usage用来描述要分配的图形缓冲区的用途。如果是用来在系统帧缓冲区中渲染的，即参数usage的GRALLOC_USAGE_HW_FB位等于1，那么就必须要系统帧缓冲区中分配，否则的话，就在内存中分配。注意，在内存中分配的图形缓冲区，最终是需要拷贝到系统帧缓冲区去的，以便可以将它所描述的图形渲染出来。

        函数gralloc_alloc_framebuffer用来在系统帧缓冲区中分配图形缓冲区，而函数gralloc_alloc_buffer用来在内存在分配图形缓冲区，接下来我们就分别分析这两个函数的实现。

         函数gralloc_alloc_framebuffer实现在文件hardware/libhardware/modules/gralloc/gralloc.cpp中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. static int gralloc_alloc_framebuffer(alloc_device_t* dev, 
  2. size_t size, int usage, buffer_handle_t* pHandle) 
  3. { 
  4.     private_module_t* m = reinterpret_cast<private_module_t*>( 
  5.             dev->common.module); 
  6.     pthread_mutex_lock(&m->lock); 
  7. int err = gralloc_alloc_framebuffer_locked(dev, size, usage, pHandle); 
  8.     pthread_mutex_unlock(&m->lock); 
  9. return err; 
  10. } 

        这个函数调用了另外一个函数gralloc_alloc_framebuffer_locked来分配图形缓冲区。

        函数gralloc_alloc_framebuffer_locked也是实现在文件hardware/libhardware/modules/gralloc/gralloc.cpp中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. static int gralloc_alloc_framebuffer_locked(alloc_device_t* dev, 
  2. size_t size, int usage, buffer_handle_t* pHandle) 
  3. { 
  4.     private_module_t* m = reinterpret_cast<private_module_t*>( 
  5.             dev->common.module); 
  7. // allocate the framebuffer
  8. if (m->framebuffer == NULL) { 
  9. // initialize the framebuffer, the framebuffer is mapped once
  10. // and forever.
  11. int err = mapFrameBufferLocked(m); 
  12. if (err < 0) { 
  13. return err; 
  14.         } 
  15.     } 
  17. const uint32_t bufferMask = m->bufferMask; 
  18. const uint32_t numBuffers = m->numBuffers; 
  19. const size_t bufferSize = m->finfo.line_length * m->info.yres; 
  20. if (numBuffers == 1) { 
  21. // If we have only one buffer, we never use page-flipping. Instead,
  22. // we return a regular buffer which will be memcpy'ed to the main
  23. // screen when post is called.
  24. int newUsage = (usage & ~GRALLOC_USAGE_HW_FB) | GRALLOC_USAGE_HW_2D; 
  25. return gralloc_alloc_buffer(dev, bufferSize, newUsage, pHandle); 
  26.     } 
  28. if (bufferMask >= ((1LU<<numBuffers)-1)) { 
  29. // We ran out of buffers.
  30. return -ENOMEM; 
  31.     } 
  33. // create a "fake" handles for it
  34. intptr_t vaddr = intptr_t(m->framebuffer->base); 
  35.     private_handle_t* hnd = new private_handle_t(dup(m->framebuffer->fd), size, 
  36.             private_handle_t::PRIV_FLAGS_FRAMEBUFFER); 
  38. // find a free slot
  39. for (uint32_t i=0 ; i<numBuffers ; i++) { 
  40. if ((bufferMask & (1LU<<i)) == 0) { 
  41.             m->bufferMask |= (1LU<<i); 
  42. break; 
  43.         } 
  44.         vaddr += bufferSize; 
  45.     } 
  47.     hnd->base = vaddr; 
  48.     hnd->offset = vaddr - intptr_t(m->framebuffer->base); 
  49.     *pHandle = hnd; 
  51. return 0; 
  52. } 

       在系统帧缓冲区分配图形缓冲区之前，首先要对系统帧缓冲区进行过初始化，即这里的变量m所指向的一个private_module_t结构体的成员变量framebuffer的值不能等于NULL。如果等于NULL的话，那么就必须要调用另外一个函数mapFrameBufferLocked来初始化系统帧缓冲区。初始化系统帧缓冲区的过程可以参考前面第3部分的内容。

       变量bufferMask用来描述系统帧缓冲区的使用情况，而变量numBuffers用来描述系统帧缓冲区可以划分为多少个图形缓冲区来使用，另外一个变量bufferSize用来描述设备显示屏一屏内容所占用的内存的大小。

        如果系统帧缓冲区只有一个图形缓冲区大小，即变量numBuffers的值等于1，那么这个图形缓冲区就始终用作系统主图形缓冲区来使用。在这种情况下，我们就不能够在系统帧缓冲区中分配图形缓冲区来给用户空间的应用程序使用，因此，这时候就会转向内存中来分配图形缓冲区，即调用函数gralloc_alloc_buffer来分配图形缓冲区。注意，这时候分配的图形缓冲区的大小为一屏内容的大小，即bufferSize。

        如果bufferMask的值大于等于((1LU<<numBuffers)-1)的值，那么就说明系统帧缓冲区中的图形缓冲区全部都分配出去了，这时候分配图形缓冲区就失败了。例如，假设图形缓冲区的个数为2，那么((1LU<<numBuffers)-1)的值就等于3，即二制制0x11。如果这时候bufferMask的值也等于0x11，那么就表示第一个和第二个图形缓冲区都已经分配出去了。因此，这时候就不能再在系统帧缓冲区中分配图形缓冲区。

       假设此时系统帧缓冲区中尚有空闲的图形缓冲区的，接下来函数就会创建一个private_handle_t结构体hnd来描述这个即将要分配出去的图形缓冲区。注意，这个图形缓冲区的标志值等于PRIV_FLAGS_FRAMEBUFFER，即表示这是一块在系统帧缓冲区中分配的图形缓冲区。

       接下来的for循环从低位到高位检查变量bufferMask的值，并且找到第一个值等于0的位，这样就可以知道在系统帧缓冲区中，第几个图形缓冲区的是空闲的。注意，变量vadrr的值开始的时候指向系统帧缓冲区的基地址，在下面的for循环中，每循环一次它的值都会增加bufferSize。从这里就可以看出，每次从系统帧缓冲区中分配出去的图形缓冲区的大小都是刚好等于显示屏一屏内容大小的。

        最后分配出去的图形缓冲区的开始地址就保存在前面所创建的private_handle_t结构体hnd的成员变量base中，这样，用户空间的应用程序就可以直接将要渲染的图形内容拷贝到这个地址上去，这就相当于是直接将图形渲染到系统帧缓冲区中去。

        在将private_handle_t结构体hnd返回给调用者之前，还需要设置它的成员变量offset，以便可以知道它所描述的图形缓冲区的起始地址相对于系统帧缓冲区的基地址的偏移量。

        至此，在系统帧缓冲区中分配图形缓冲区的过程就分析完成了，接下来我们再分析在内存在分析图形缓冲区的过程，即分析函数gralloc_alloc_buffer的实现。

        函数gralloc_alloc_buffer也是实现在文件hardware/libhardware/modules/gralloc/gralloc.cpp中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. static int gralloc_alloc_buffer(alloc_device_t* dev, 
  2. size_t size, int usage, buffer_handle_t* pHandle) 
  3. { 
  4. int err = 0; 
  5. int fd = -1; 
  7.     size = roundUpToPageSize(size); 
  9.     fd = ashmem_create_region("gralloc-buffer", size); 
  10. if (fd < 0) { 
  11.         LOGE("couldn't create ashmem (%s)", strerror(-errno)); 
  12.         err = -errno; 
  13.     } 
  15. if (err == 0) { 
  16.         private_handle_t* hnd = new private_handle_t(fd, size, 0); 
  17.         gralloc_module_t* module = reinterpret_cast<gralloc_module_t*>( 
  18.                 dev->common.module); 
  19.         err = mapBuffer(module, hnd); 
  20. if (err == 0) { 
  21.             *pHandle = hnd; 
  22.         } 
  23.     } 
  25.     LOGE_IF(err, "gralloc failed err=%s", strerror(-err)); 
  27. return err; 
  28. } 

       这个函数的实现很简单，它首先调用函数ashmem_create_region来创建一块匿名共享内存，接着再在这块匿名共享内存上分配一个图形缓冲区。注意，这个图形缓冲区也是使用一个private_handle_t结构体来描述的，不过这个图形缓冲区的标志值等于0，以区别于在系统帧缓冲区中分配的图形缓冲区。匿名共享内存的相关知识，可以参考前面Android系统匿名共享内存Ashmem（Anonymous Shared Memory）简要介绍和学习计划一文，以及Android系统匿名共享内存（Anonymous Shared Memory）C++调用接口分析这篇文章。

        从匿名共享内存中分配的图形缓冲区还需要映射到进程的地址空间来，然后才可以使用，这是通过调用函数mapBuffer来实现的。

        函数mapBuffer实现在文件hardware/libhardware/modules/gralloc/mapper.cpp中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. int mapBuffer(gralloc_module_t const* module, 
  2.         private_handle_t* hnd) 
  3. { 
  4. void* vaddr; 
  5. return gralloc_map(module, hnd, &vaddr); 
  6. } 

       它通过调用另外一个函数gralloc_map来将参数hnd所描述的一个图形缓冲区映射到当前进程的地址空间来。后面在分析图形缓冲区的注册过程时，我们再分析函数gralloc_map的实现。

        注意，在Android系统中，在系统帧缓冲区中分配的图形缓冲区是在SurfaceFlinger服务中使用的，而在内存中分配的图形缓冲区既可以在SurfaceFlinger服务中使用，也可以在其它的应用程序中使用。当其它的应用程序需要使用图形缓冲区的时候，它们就会请求SurfaceFlinger服务为它们分配，因此，对于其它的应用程序来说，它们只需要将SurfaceFlinger服务返回来的图形缓冲区映射到自己的进程地址空间来使用就可以了，这就是后面我们所要分析的图形缓冲区的注册过程。

        至此，图形缓冲区的分配过程就分析完成了，接下来我们继续分析图形缓冲区的释放过程。

        5. 图形缓冲区的释放过程

        前面提到，用户空间的应用程序用到的图形缓冲区是由Gralloc模块中的函数gralloc_free来释放的，这个函数实现在文件hardware/libhardware/modules/gralloc/gralloc.cpp中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. static int gralloc_free(alloc_device_t* dev, 
  2.         buffer_handle_t handle) 
  3. { 
  4. if (private_handle_t::validate(handle) < 0) 
  5. return -EINVAL; 
  7.     private_handle_t const* hnd = reinterpret_cast<private_handle_t const*>(handle); 
  8. if (hnd->flags & private_handle_t::PRIV_FLAGS_FRAMEBUFFER) { 
  9. // free this buffer
  10.         private_module_t* m = reinterpret_cast<private_module_t*>( 
  11.                 dev->common.module); 
  12. const size_t bufferSize = m->finfo.line_length * m->info.yres; 
  13. int index = (hnd->base - m->framebuffer->base) / bufferSize; 
  14.         m->bufferMask &= ~(1<<index); 
  15.     } else { 
  16.         gralloc_module_t* module = reinterpret_cast<gralloc_module_t*>( 
  17.                 dev->common.module); 
  18.         terminateBuffer(module, const_cast<private_handle_t*>(hnd)); 
  19.     } 
  21.     close(hnd->fd); 
  22. delete hnd; 
  23. return 0; 
  24. } 

        要释放的图形缓冲区使用参数handle来描述。前面提到，从Gralloc模块中分配的图形缓冲区是使用private_handle_t结构体来描述的，因此，这里的参数handle应该指向一个private_handle_t结构体，这是通过调用private_handle_t类的静态成员函数validate来验证的。private_handle_t类的静态成员函数validate的实现可以参考前面第1部分的内容。

        要释放的图形缓冲区有可能是在系统帧缓冲区分配的，也有可能是在内存中分配的，这可以通过检查它的标志值flags的PRIV_FLAGS_FRAMEBUFFER位是否等于1来确认。

        如果要释放的图形缓冲区是在系统帧缓冲区中分配的，那么首先要知道这个图形缓冲区是系统帧缓冲区的第index个位置，接着再将变量m所描述的一个private_module_t结构体的成员变量bufferMask的第index位重置为0即可。我们只需要将要释放的图形缓冲区的开始地址减去系统帧缓冲区的基地址，再除以一个图形缓冲区的大小，就可以知道要释放的图形缓冲区是系统帧缓冲区的第几个位置。这个过程刚好是在系统帧缓冲区中分配图形缓冲区的逆操作。

        如果要释放的图形缓冲区是内存中分配的，那么只需要调用另外一个函数terminateBuffer来解除要释放的图形缓冲区在当前进程的地址空间中的映射。

        最后，这个函数还会将用来描述要释放的图形缓冲区的private_handle_t结构体所占用的内存释放掉，并且将要要释放的图形缓冲区所在的系统帧缓冲区或者匿名共享内存的文件描述符关闭掉。

       函数terminateBuffer实现在文件hardware/libhardware/modules/gralloc/mapper.cpp中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. int terminateBuffer(gralloc_module_t const* module, 
  2.         private_handle_t* hnd) 
  3. { 
  4. if (hnd->base) { 
  5. // this buffer was mapped, unmap it now
  6.         gralloc_unmap(module, hnd); 
  7.     } 
  9. return 0; 
  10. } 

       它通过调用另外一个函数gralloc_unmap来解除参数hnd所描述的一个图形缓冲区在当前进程的地址空间中的映射。后面在分析图形缓冲区的注销过程时，我们再详细分析函数gralloc_unmap的实现。

       至此，图形缓冲区的释放过程就分析完成了，接下来我们继续分析图形缓冲区的注册过程。

       6. 图形缓冲区的注册过程

       前面提到，在Android系统中，所有的图形缓冲区都是由SurfaceFlinger服务分配的，而当一个图形缓冲区被分配的时候，它会同时被映射到请求分配的进程的地址空间去，即分配的过程同时也包含了注册的过程。但是对用户空间的其它的应用程序来说，它们所需要的图形缓冲区是在由SurfaceFlinger服务分配的，因此，当它们得到SurfaceFlinger服务分配的图形缓冲区之后，还需要将这块图形缓冲区映射到自己的地址空间来，以便可以使用这块图形缓冲区。这个映射的过程即为我们接下来要分析的图形缓冲区注册过程。

       前面还提到，注册图形缓冲区的操作是由Gralloc模块中的函数gralloc_register_buffer来实现的，这个函数实现在文件hardware/libhardware/modules/gralloc/mapper.cpp中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. int gralloc_register_buffer(gralloc_module_t const* module, 
  2.         buffer_handle_t handle) 
  3. { 
  4. if (private_handle_t::validate(handle) < 0) 
  5. return -EINVAL; 
  7. // if this handle was created in this process, then we keep it as is.
  8. int err = 0; 
  9.     private_handle_t* hnd = (private_handle_t*)handle; 
  10. if (hnd->pid != getpid()) { 
  11. void *vaddr; 
  12.         err = gralloc_map(module, handle, &vaddr); 
  13.     } 
  14. return err; 
  15. } 

       这个函数首先验证参数handle指向的一块图形缓冲区的确是由Gralloc模块分配的，方法是调用private_handle_t类的静态成员函数validate来验证，即如果参数handle指向的是一个private_handle_t结构体，那么它所指向的一块图形缓冲区就是由Gralloc模块分配的。

       通过了上面的检查之后，函数gralloc_register_buffer还需要检查当前进程是否就是请求Gralloc模块分配图形缓冲区hnd的进程。如果是的话，那么当前进程在请求Gralloc模块分配图形缓冲区hnd的时候，就已经将图形缓冲区hnd映射进自己的地址空间来了，因此，这时候就不需要重复在当前进程中注册这个图形缓冲区。

       真正执行注册图形缓冲区的操作是由函数gralloc_map来实现的，这个函数也是实现文件hardware/libhardware/modules/gralloc/mapper.cpp中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. static int gralloc_map(gralloc_module_t const* module, 
  2.         buffer_handle_t handle, 
  3. void** vaddr) 
  4. { 
  5.     private_handle_t* hnd = (private_handle_t*)handle; 
  6. if (!(hnd->flags & private_handle_t::PRIV_FLAGS_FRAMEBUFFER)) { 
  7. size_t size = hnd->size; 
  8. void* mappedAddress = mmap(0, size, 
  9.                 PROT_READ|PROT_WRITE, MAP_SHARED, hnd->fd, 0); 
  10. if (mappedAddress == MAP_FAILED) { 
  11.             LOGE("Could not mmap %s", strerror(errno)); 
  12. return -errno; 
  13.         } 
  14.         hnd->base = intptr_t(mappedAddress) + hnd->offset; 
  15. //LOGD("gralloc_map() succeeded fd=%d, off=%d, size=%d, vaddr=%p",
  16. //        hnd->fd, hnd->offset, hnd->size, mappedAddress);
  17.     } 
  18.     *vaddr = (void*)hnd->base; 
  19. return 0; 
  20. } 

       由于在系统帧缓冲区中分配的图形缓冲区只在SurfaceFlinger服务中使用，而SurfaceFlinger服务在初始化系统帧缓冲区的时候，已经将系统帧缓冲区映射到自己所在的进程中来了，因此，函数gralloc_map如果发现要注册的图形缓冲区是在系统帧缓冲区分配的时候，那么就不需要再执行映射图形缓冲区的操作了。

       如果要注册的图形缓冲区是在内存中分配的，即它的标志值flags的PRIV_FLAGS_FRAMEBUFFER位等于1，那么接下来就需要将它映射到当前进程的地址空间来了。由于要注册的图形缓冲区是在文件描述符hnd->fd所描述的一块匿名共享内存中分配的，因此，我们只需要将文件描述符hnd->fd所描述的一块匿名共享内存映射到当前进程的地址空间来，就可以将参数hnd所描述的一个图形缓冲区映射到当前进程的地址空间来。

       由于映射文件描述符hnd->fd得到的是一整块匿名共享内存在当前进程地址空间的基地址，而要注册的图形缓冲区可能只占据这块匿名共享内存的某一小部分，因此，我们还需要将要注册的图形缓冲区的在被映射的匿名共享内存中的偏移量hnd->offset加上被映射的匿名共享内存的基地址hnd->base，才可以得到要注册的图形缓冲区在当前进程中的访问地址，这个地址最终又被写入到hnd->base中去。

       注册图形缓冲区的过程就是这么简单，接下来我们再分析图形缓冲区的注销过程。

       7. 图形缓冲区的注销过程

       图形缓冲区使用完成之后，就需要从当前进程中注销。前面提到，注销图形缓冲区是由Gralloc模块中的函数gralloc_unregister_buffer来实现的，这个函数实现在文件hardware/libhardware/modules/gralloc/mapper.cpp中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. int gralloc_unregister_buffer(gralloc_module_t const* module, 
  2.         buffer_handle_t handle) 
  3. { 
  4. if (private_handle_t::validate(handle) < 0) 
  5. return -EINVAL; 
  7. // never unmap buffers that were created in this process
  8.     private_handle_t* hnd = (private_handle_t*)handle; 
  9. if (hnd->pid != getpid()) { 
  10. if (hnd->base) { 
  11.             gralloc_unmap(module, handle); 
  12.         } 
  13.     } 
  14. return 0; 
  15. } 

        这个函数同样是首先调用private_handle_t类的静态成员函数validate来验证参数handle指向的一块图形缓冲区的确是由Gralloc模块分配的，接着再将将参数handle指向的一块图形缓冲区转换为一个private_handle_t结构体hnd来访问。

        一块图形缓冲区只有被注册过，即被Gralloc模块中的函数gralloc_register_buffer注册过，才需要注销，而由函数gralloc_register_buffer注册的图形缓冲区都不是由当前进程分配的，因此，当前进程在注销一个图形缓冲区的时候，会检查要注销的图形缓冲区是否是由自己分配的。如果是由自己分配的话，那么它什么也不做就返回了。

        假设要注销的图形缓冲区hnd不是由当前进程分配的，那么接下来就会调用另外一个函数galloc_unmap来注销图形缓冲区hnd。

        函数galloc_unmap也是实现在文件hardware/libhardware/modules/gralloc/mapper.cpp中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. static int gralloc_unmap(gralloc_module_t const* module, 
  2.         buffer_handle_t handle) 
  3. { 
  4.     private_handle_t* hnd = (private_handle_t*)handle; 
  5. if (!(hnd->flags & private_handle_t::PRIV_FLAGS_FRAMEBUFFER)) { 
  6. void* base = (void*)hnd->base; 
  7. size_t size = hnd->size; 
  8. //LOGD("unmapping from %p, size=%d", base, size);
  9. if (munmap(base, size) < 0) { 
  10.             LOGE("Could not unmap %s", strerror(errno)); 
  11.         } 
  12.     } 
  13.     hnd->base = 0; 
  14. return 0; 
  15. } 

        这个函数的实现与前面所分析的函数gralloc_map的实现是类似的，只不过它执行的是相反的操作，即将解除一个指定的图形缓冲区在当前进程的地址空间中的映射，从而完成对这个图形缓冲区的注销工作。

        这样，图形缓冲区的注销过程就分析完成了，接下来我们再继续分析一个图形缓冲区是如何被渲染到系统帧缓冲区去的，即它的内容是如何绘制在设备显示屏中的。

        8. 图形缓冲区的渲染过程

        用户空间的应用程序将画面内容写入到图形缓冲区中去之后，还需要将图形缓冲区渲染到系统帧缓冲区中去，这样才可以把画面绘制到设备显示屏中去。前面提到，渲染图形缓冲区是由Gralloc模块中的函数fb_post来实现的，这个函数实现在文件hardware/libhardware/modules/gralloc/framebuffer.cpp中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. static int fb_post(struct framebuffer_device_t* dev, buffer_handle_t buffer) 
  2. { 
  3. if (private_handle_t::validate(buffer) < 0) 
  4. return -EINVAL; 
  6.     fb_context_t* ctx = (fb_context_t*)dev; 
  8.     private_handle_t const* hnd = reinterpret_cast<private_handle_t const*>(buffer); 
  9.     private_module_t* m = reinterpret_cast<private_module_t*>( 
  10.             dev->common.module); 
  12. if (hnd->flags & private_handle_t::PRIV_FLAGS_FRAMEBUFFER) { 
  13. const size_t offset = hnd->base - m->framebuffer->base; 
  14.         m->info.activate = FB_ACTIVATE_VBL; 
  15.         m->info.yoffset = offset / m->finfo.line_length; 
  16. if (ioctl(m->framebuffer->fd, FBIOPUT_VSCREENINFO, &m->info) == -1) { 
  17.             LOGE("FBIOPUT_VSCREENINFO failed"); 
  18.             m->base.unlock(&m->base, buffer); 
  19. return -errno; 
  20.         } 
  21.         m->currentBuffer = buffer; 
  23.     } else { 
  24. // If we can't do the page_flip, just copy the buffer to the front
  25. // FIXME: use copybit HAL instead of memcpy
  27. void* fb_vaddr; 
  28. void* buffer_vaddr; 
  30.         m->base.lock(&m->base, m->framebuffer, 
  31.                 GRALLOC_USAGE_SW_WRITE_RARELY, 
  32.                 0, 0, m->info.xres, m->info.yres, 
  33.                 &fb_vaddr); 
  35.         m->base.lock(&m->base, buffer, 
  36.                 GRALLOC_USAGE_SW_READ_RARELY, 
  37.                 0, 0, m->info.xres, m->info.yres, 
  38.                 &buffer_vaddr); 
  40.         memcpy(fb_vaddr, buffer_vaddr, m->finfo.line_length * m->info.yres); 
  42.         m->base.unlock(&m->base, buffer); 
  43.         m->base.unlock(&m->base, m->framebuffer); 
  44.     } 
  46. return 0; 
  47. } 

        参数buffer用来描述要渲染的图形缓冲区，它指向的必须要是一个private_handle_t结构体，这是通过调用private_handle_t类的静态成员函数validate来验证的。验证通过之后，就可以将参数buffer所描述的一个buffer_handle_t结构体转换成一个private_handle_t结构体hnd。

        参数dev用来描述在Gralloc模块中的一个fb设备。从前面第3部分的内容可以知道，在打开fb设备的时候，Gralloc模块返回给调用者的实际上是一个fb_context_t结构体，因此，这里就可以将参数dev所描述的一个framebuffer_device_t结构体转换成一个fb_context_t结构体ctx。

        参数dev的成员变量common指向了一个hw_device_t结构体，这个结构体的成员变量module指向了一个Gralloc模块。从前面第1部分的内容可以知道，一个Gralloc模块是使用一个private_module_t结构体来描述的，因此，我们可以将dev->common.moudle转换成一个private_module_t结构体m。

        由于private_handle_t结构体hnd所描述的图形缓冲区可能是在系统帧缓冲区分配的，也有可能是内存中分配的，因此，我们分两种情况来讨论图形缓冲区渲染过程。

        当private_handle_t结构体hnd所描述的图形缓冲区是在系统帧缓冲区中分配的时候，即这个图形缓冲区的标志值flags的PRIV_FLAGS_FRAMEBUFFER位等于1的时候，我们是不需要将图形缓冲区的内容拷贝到系统帧缓冲区去的，因为我们将内容写入到图形缓冲区的时候，已经相当于是将内容写入到了系统帧缓冲区中去了。虽然在这种情况下，我们不需要将图形缓冲区的内容拷贝到系统帧缓冲区去，但是我们需要告诉系统帧缓冲区设备将要渲染的图形缓冲区作为系统当前的输出图形缓冲区，这样才可以将要渲染的图形缓冲区的内容绘制到设备显示屏来。例如，假设系统帧缓冲区有2个图形缓冲区，当前是以第1个图形缓冲区作为输出图形缓冲区的，这时候如果我们需要渲染第2个图形缓冲区，那么就必须告诉系统帧绘冲区设备，将第2个图形缓冲区作为输出图形缓冲区。

       设置系统帧缓冲区的当前输出图形缓冲区是通过IO控制命令FBIOPUT_VSCREENINFO来进行的。IO控制命令FBIOPUT_VSCREENINFO需要一个fb_var_screeninfo结构体作为参数。从前面第3部分的内容可以知道，private_module_t结构体m的成员变量info正好保存在我们所需要的这个fb_var_screeninfo结构体。有了个m->info这个fb_var_screeninfo结构体之后，我们只需要设置好它的成员变量yoffset的值（不用设置成员变量xoffset的值是因为所有的图形缓冲区的宽度是相等的），就可以将要渲染的图形缓冲区设置为系统帧缓冲区的当前输出图形缓冲区。fb_var_screeninfo结构体的成员变量yoffset保存的是当前输出图形缓冲区在整个系统帧缓冲区的纵向偏移量，即Y偏移量。我们只需要将要渲染的图形缓冲区的开始地址hnd->base的值减去系统帧缓冲区的基地址m->framebuffer->base的值，再除以图形缓冲区一行所占据的字节数m->finfo.line_length，就可以得到所需要的Y偏移量。

        在执行IO控制命令FBIOPUT_VSCREENINFO之前，还会将作为参数的fb_var_screeninfo结构体的成员变量activate的值设置FB_ACTIVATE_VBL，表示要等到下一个垂直同步事件出现时，再将当前要渲染的图形缓冲区的内容绘制出来。这样做的目的是避免出现屏幕闪烁，即避免前后两个图形缓冲区的内容各有一部分同时出现屏幕中。

        成功地执行完成IO控制命令FBIOPUT_VSCREENINFO之后，函数还会将当前被渲染的图形缓冲区保存在private_module_t结构体m的成员变量currentBuffer中，以便可以记录当前被渲染的图形缓冲区是哪一个。

        当private_handle_t结构体hnd所描述的图形缓冲区是在内存中分配的时候，即这个图形缓冲区的标志值flags的PRIV_FLAGS_FRAMEBUFFER位等于0的时候，我们就需要将它的内容拷贝到系统帧缓冲区中去了。这个拷贝的工作是通过调用函数memcpy来完成的。在拷贝之前，我们需要三个参数。第一个参数是要渲染的图形缓冲区的起址地址，这个地址保存在参数buffer所指向的一个private_handle_t结构体中。第二个参数是要系统帧缓冲区的基地址，这个地址保存在private_module_t结构体m的成员变量framebuffer所指向的一个private_handle_t结构体中。第三个参数是要拷贝的内容的大小，这个大小就刚好是一个屏幕像素所占据的内存的大小。屏幕高度由m->info.yres来描述，而一行屏幕像素所占用的字节数由m->finfo.line_length来描述，将这两者相乘，就可以得到一个屏幕像素所占据的内存的大小。

        在将一块内存缓冲区的内容拷贝到系统帧缓冲区中去之前，需要对这两块缓冲区进行锁定，以保证在拷贝的过程中，这两块缓冲区的内容不会被修改。这个锁定的工作是由Gralloc模块中的函数gralloc_lock来实现的。从前面第1部分的内容可以知道，Gralloc模块中的函数gralloc_lock的地址正好就保存在private_module_t结构体m的成员变量base所描述的一个gralloc_module_t结构体的成员函数lock中。

        在调用函数gralloc_lock来锁定一块缓冲区之后，还可以通过最后一个输出参数来获得被锁定的缓冲区的开始地址，因此，通过调用函数gralloc_lock来锁定要渲染的图形缓冲区以及系统帧缓冲区，就可以得到前面所需要的第一个和第二个参数。

        将要渲染的图形缓冲区的内容拷贝到系统帧缓冲区之后，就可以解除前面对它们的锁定了，这个解锁的工作是由Gralloc模块中的函数gralloc_unlock来实现的。从前面第1部分的内容可以知道，Gralloc模块中的函数gralloc_unlock的地址正好就保存在private_module_t结构体m的成员变量base所描述的一个gralloc_module_t结构体的成员函数unlock中。

        这样，一个图形缓冲区的渲染过程就分析完成了。

        为了完整性起见，最后我们再简要分析函数gralloc_lock和gralloc_unlock的实现，以便可以了解一个图形缓冲区的锁定和解锁操作是如何实现的。

        函数gralloc_lock实现在文件hardware/libhardware/modules/gralloc/mapper.cpp文件中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. int gralloc_lock(gralloc_module_t const* module, 
  2.         buffer_handle_t handle, int usage, 
  3. int l, int t, int w, int h, 
  4. void** vaddr) 
  5. { 
  6. // this is called when a buffer is being locked for software
  7. // access. in thin implementation we have nothing to do since
  8. // not synchronization with the h/w is needed.
  9. // typically this is used to wait for the h/w to finish with
  10. // this buffer if relevant. the data cache may need to be
  11. // flushed or invalidated depending on the usage bits and the
  12. // hardware.
  14. if (private_handle_t::validate(handle) < 0) 
  15. return -EINVAL; 
  17.     private_handle_t* hnd = (private_handle_t*)handle; 
  18.     *vaddr = (void*)hnd->base; 
  19. return 0; 
  20. } 

        从这里可以看出，函数gralloc_lock其实并没有执行锁定参数handle所描述的一个缓冲区的操作，它只简单地将要锁定的缓冲区的开始地址返回给调用者。

        理论上来说，函数gralloc_lock应该检查参数handle所描述的一个缓冲区是否正在被其进程或者线程使用。如果是的话，那么函数gralloc_lock就必须要等待，直到要锁定的缓冲区被其它进程或者线程使用结束为止，以便接下来可以独占它。由于函数gralloc_lock实际上并没有作这些操作，因此，就必须要由调用者来保证要锁定的缓冲区当前是没有被其它进程或者线程使用的。

        函数gralloc_unlock也是实现在文件hardware/libhardware/modules/gralloc/mapper.cpp文件中，如下所示：

[cpp] view plaincopy在CODE上查看代码片

  1. int gralloc_unlock(gralloc_module_t const* module, 
  2.         buffer_handle_t handle) 
  3. { 
  4. // we're done with a software buffer. nothing to do in this
  5. // implementation. typically this is used to flush the data cache.
  7. if (private_handle_t::validate(handle) < 0) 
  8. return -EINVAL; 
  9. return 0; 
  10. } 

       函数gralloc_unlock执行的操作本来是刚好与函数gralloc_lock相反的，但是由于函数gralloc_lock并没有真实地锁定参数handle所描述的一个缓冲区的，因此，函数gralloc_unlock是不需要执行实际的解锁工作的。

       至此，我们就分析完成Android帧缓冲区硬件抽象层模块Gralloc的实现原理了。从分析的过程可以知道，为了在屏幕中绘制一个指定的画面，我们需要：

       1.  分配一个匹配屏幕大小的图形缓冲区

       2.  将分配好的图形缓冲区注册（映射）到当前进程的地址空间来

       3.  将要绘制的画面的内容写入到已经注册好的图形缓冲区中去，并且渲染（拷贝）到系统帧缓冲区中去

       为了实现以上三个操作，我们还需要：

       1. 加载Gralloc模块

       2. 打开Gralloc模块中的gralloc设备和fb设备

       其中，gralloc设备负责分配图形缓冲区，Gralloc模块负责注册图形缓冲区，而fb设备负责渲染图形缓冲区。

       理解了Gralloc模块的实现原理之后，就可以为后续分析SurfaceFlinger服务的实现打下坚实的基础了。

 

摘自：http://blog.csdn.net/luoshengyang/article/details/7747932

你可能感兴趣的:(android)

  • android系统selinux中添加新属性property 辉色投像
    1.定位/android/system/sepolicy/private/property_contexts声明属性开头：persist.charge声明属性类型：u:object_r:system_prop:s0图12.定位到android/system/sepolicy/public/domain.te删除neverallow{domain-init}default_prop:property
  • 2.2.6 通知类控件 Toast、Menu 常思行
    本文例程下载：WillFlow_Toast、WillFlowMenu一、什么是Toast？Toast也被叫做吐司，是Android系统提供的一种非常好的提醒方式，在程序中可以使用它将一些短小的信息通知给用户，它有如下两个特点：Toast是没有焦点的Toast显示的时间有限过一定的时间就会自动消失所以一般来讲Toast的使用并不会影响我们的正常操作，并且它通常不会占用太大的屏幕空间，有着良好的用户体
  • mac 备份android 手机通讯录导入iphone,iphone如何导出通讯录（轻松教你iPhone备份通讯录的方法）... weixin_39762838 mac备份android手机通讯录导入iphone
    在日新月异的手机更替中，换手机已经成为一个非常稀松平常的事情，但将旧手机上面的通讯录导入到新手机还是让不少小伙伴为难，本篇将给大家详细讲解这方面的知识：“苹果手机通讯录怎么导入到新手机”及“安卓手机通讯录导入到新手机”的方法。一、苹果手机通讯录导入到新手机常用方法(SIM卡导入)在苹果手机主频幕上找到“设置”，单击进入设置菜单，下拉菜单列表，点击“邮件、通讯录、日历”，然后找到“导入SIM卡通讯录
  • android 更改窗口的层次,浮窗开发之窗口层级 Ms.Bu android更改窗口的层次
    最近在项目中遇到了这样的需求：需要在特定的其他应用之上悬浮自己的UI交互(拖动、输入等复杂的UI交互)，和九游的浮窗类似，不过我们的比九游的体验更好，我们越过了很多授权的限制。浮窗效果很多人都知道如何去实现一个简单的浮窗，但是却很少有人去深入的研究背后的流程机制，由于项目中浮窗交互比较复杂，遇到了些坑查看了很多资料，故总结浮窗涉及到的知识点：窗口层级关系(浮窗是如何“浮”的)？浮窗有哪些限制，如何
  • Android应用性能优化 轻口味 Android
    Android手机由于其本身的后台机制和硬件特点，性能上一直被诟病，所以软件开发者对软件本身的性能优化就显得尤为重要；本文将对Android开发过程中性能优化的各个方面做一个回顾与总结。Cache优化ListView缓存：ListView中有一个回收器，Item滑出界面的时候View会回收到这里，需要显示新的Item的时候，就尽量重用回收器里面的View；每次在getView函数中inflate新
  • Android实现监听事件的方法 Amy木婉清
    1.通过内部类实现2.通过匿名内部类实现3.通过事件源所在类实现4.通过外部类实现5.布局文件中onclick属性(针对点击事件)1.通过内部类实现代码:privateButtonmBtnEvent;//oncreate中mBtnEvent.setOnClickListener(newOnClick());//内部类实现监听classOnClickimplementsView.OnClickLis
  • 高级UI<第二十四篇>：Android中用到的矩阵常识 NoBugException
    （1）定义在数学中，矩阵（Matrix）是一个按照长方阵列排列的复数或实数集合。由m×n个数aij排成的m行n列的数表称为m行n列的矩阵，简称m×n矩阵。记作：图片.png这m×n个数称为矩阵A的元素，简称为元，数aij位于矩阵A的第i行第j列，称为矩阵A的(i,j)元，以数aij为(i,j)元的矩阵可记为(aij)或(aij)m×n，m×n矩阵A也记作Amn。元素是实数的矩阵称为实矩阵，元素是复
  • RK3229_Android9.0_Box 4G模块EC200A调试 suifen_ 网络
    0、kernel修改这部分完全可以参考Linux的移植：RK3588EC200A-CN【4G模块】调试_rkec200a-cn-CSDN博客1、修改device/rockchip/rk322xdiff--gita/device.mkb/device.mkindexec6bfaa..e7c32d1100755---a/device.mk+++b/device.mk@@-105,6+105,8@@en
  • kt文件和java文件_Java与Kotlin之间怎样进行互操作 铭空间 kt文件和java文件
    Java与Kotlin之间怎样进行互操作发布时间：2021-02-0210:50:43来源：亿速云阅读：98作者：小新这篇文章主要介绍了Java与Kotlin之间怎样进行互操作，具有一定借鉴价值，感兴趣的朋友可以参考下，希望大家阅读完这篇文章之后大有收获，下面让小编带着大家一起了解一下。前言目前kotlin是谷歌首推的开发Android的语言，但由于历史原因，我们绝大部分项目依旧还是以Java为主
  • Android shell 常用 debug 命令 晨春计 Audiodebugandroidlinux
    目录1、查看版本2、am命令3、pm命令4、dumpsys命令5、sed命令6、log定位查看APK进程号7、log定位使用场景1、查看版本1.1、Android串口终端执行getpropro.build.version.release#获取Android版本uname-a#查看linux内核版本信息uname-r#单独查看内核版本1.2、linux服务器执行lsb_release-a#查看Lin
  • 2024年最全Flutter如何和Native通信-Android视角，Electron开发Android界面 2401_84544531 程序员android面试学习
    总结【Android详细知识点思维脑图（技能树）】其实Android开发的知识点就那么多，面试问来问去还是那么点东西。所以面试没有其他的诀窍，只看你对这些知识点准备的充分程度。so，出去面试时先看看自己复习到了哪个阶段就好。虽然Android没有前几年火热了，已经过去了会四大组件就能找到高薪职位的时代了。这只能说明Android中级以下的岗位饱和了，现在高级工程师还是比较缺少的，很多高级职位给的薪
  • 分享一个基于python的电子书数据采集与可视化分析 hadoop电子书数据分析与推荐系统 spark大数据毕设项目（源码、调试、LW、开题、PPT) 计算机源码社 Python项目大数据大数据pythonhadoop计算机毕业设计选题计算机毕业设计源码数据分析spark毕设
    作者：计算机源码社个人简介：本人八年开发经验，擅长Java、Python、PHP、.NET、Node.js、Android、微信小程序、爬虫、大数据、机器学习等，大家有这一块的问题可以一起交流！学习资料、程序开发、技术解答、文档报告如需要源码，可以扫取文章下方二维码联系咨询Java项目微信小程序项目Android项目Python项目PHP项目ASP.NET项目Node.js项目选题推荐项目实战|p
  • android ndk 开发jni调用对象方法，数组参数 wulongkou 开发问题安卓的事ndkandroidstudiojni
    一、JNI和NDK关系JNI是Java语言提供的Java和C/C++相互沟通的机制，Java可以通过JNI调用本地的C/C++代码，本地的C/C++的代码也可以调用java代码。JNI是本地编程接口，Java和C/C++互相通过的接口。Java通过C/C++使用本地的代码的一个关键性原因在于C/C++代码的高效性。NDK是一系列工具的集合。它提供了一系列的工具，帮助开发者快速开发C（或C++）的动
  • Android jni中数组参数的传递方式 lokeyme Andriodandroid开发JNINDKjavac语言
    1、背景今天调试了一下Androidjni关于Java中调用C代码的程序，发现我的数组参数传递方式不对，导致值传递不正确，我的方法是：C代码，入口函数#include#includejintJava_sony_MedicalRecordDemo_MainActivity_decryptionSuccess(JNIEnv*env,jobjectthiz,jintAttr[]){returnAttr[
  • 1-1.Jetpack 之 Navigation 简单编码模板 我命由我12345 Android-Jetpack简化编程javajava-eeandroid-studioandroidstudio安卓androidjetpack
    一、Navigation1、Navigation概述Navigation是Jetpack中的一个重要成员，它主要是结合导航图（NavigationGraph）来控制和简化Fragment之间的导航，即往哪里走，该怎么走2、Navigate引入在模块级build.gradle中引入相关依赖implementation'androidx.navigation:navigation-fragment:2
  • Android JetPack架构——结合记事本Demo一篇打通对Sqlite的增删改查结合常用jetpack架构应用 erhtre 程序员androidjetpack架构sqlite
    为什么要用Jetpack?========================================================================关于为什么要用Jetpack，我参考了许多的博客和官方文档，开阔了我对Android生态圈的理解和认识，在Jetpack推出前出现的许许多多强大的第三方框架与语言，典型代表无疑是强大的RxJava在Jetpack仍然有许多粉丝在一
  • Android干净架构MVI模板使用指南 井美婵Toby
    Android干净架构MVI模板使用指南android-clean-architecture-mvi-boilerplateAforkofourcleanarchitectureboilerplateusingtheModel-View-Intentpattern项目地址:https://gitcode.com/gh_mirrors/an/android-clean-architecture-mv
  • ⭐Unity 安卓环境中正确地读取和处理 XML 文件 惊鸿醉 Unityunityandroidxml
    写了一个选择题Demo，电脑包和编辑器内无问题，但是打包安卓手机之后题目无法正常使用，想到的是安卓环境中正确地读取文件的问题改进方案：1.由于XmlDocument.Load方法在Android上的路径问题（由于文件位于APK内部，无法像在文件系统中那样直接访问），需要先使用UnityWebRequest来异步加载文件内容，然后再解析XML。2.异步处理：修改你的代码，以支持异步文件加载和处理，这
  • 《Android进阶之光》读书笔记 soleil雪寂 读书笔记#Android进阶之光
    文章目录第1章Android新特性1.1.Android5.0新特性1.2.RecyclerView1.1.4.3种Notification1.1.5.Toolbar与Palette1.1.6.Palette1.2.Android6.0新特性1.2.2.运行时权限机制1.3.Android7.0新特性第2章MaterialDesign2.2.DesignSupportLibrary常用控件详解第3
  • 《Android进阶之光》— Android 书籍 王睿丶 Android永无止境《Android进阶之光》Android书籍Androidphoenix移动开发
    文章目录第1章Android新特性1第2章MaterialDesign48第3章View体系与自定义View87第4章多线程编程165第5章网络编程与网络框架204第6章设计模式271第7章事件总线308第8章函数响应式编程333第9章注解与依赖注入框架382第10章应用架构设计422第11章系统架构与MediaPlayer框架460出版年:2017-7简介：《Android进阶之光》是一本And
  • 《android进阶之光》——多线程编程（上） TAING要一直努力 读书笔记
    今天了解了下多线程编程，知识点如下：进程与线程：进程是什么？线程是什么？进程可以看作是程序的实体，是线程的容器，是受操作系统管理的基本运行单元，例如exe文件就是一个进程。线程是进程运行的一些子任务，是操作系统调度的最小单元，各线程拥有自己的计数器，堆栈，局部变量等，也可以访问线程间共享的内存。线程的状态有哪些？新创建，可运行，等待，超时等待，阻塞，终止怎么创建一个线程？-三种方法第一种，MyTr
  • android进阶之光！Android面试必备的集合源码详解，系列篇 程序员Sunbu 程序员Android
    前言面试：如果不准备充分的面试，完全是浪费时间，更是对自己的不负责。文末会给大家分享下我整理的Android面试专题及答案其中大部分都是大企业面试常问的面试题，可以对照这查漏补缺，当然了，这里所列的肯定不可能覆盖全部方式，不过对大家找工作肯定是有帮助！本月飞机到达上海，到今天第6天了，四家大公司华为，小米，映客，抖音，还有二家中小型公司。有几家已经面了几轮，下周还要面，挂了几家，不过目前已经选择了
  • Android-悬浮窗功能的实现（附Java、KT实现源码）(1) egrhef 程序员androidjava开发语言
    //获取服务的操作对象valbinder=serviceasFloatWinfowServices.MyBinderbinder.service}overridefunonServiceDisconnected(name:ComponentName){}}overridefunonActivityResult(requestCode:Int,resultCode:Int,data:Intent){
  • Visual Studio中的Android模拟器使用详解 wurui8 androidandroidstudioandroidandroid应用
    关注微信号：javalearns随时随地学Java或扫一扫随时随地学JavaMicrosoft本周发布了VisualStudio2015预览版,里面包含Android开发工具.安装的时候,如果选Android开发,VisualStudio会把调试Android应用程序用的VisualStudio模拟器也装上.在介绍这个新模拟器之前,我们先来聊一聊,为什么需要一个新的Android模拟器–当然,你也
  • Unity 热更 之 【HybirdCLR】+【YooAsset】 [安卓 Android端] [代码 + 资源热更] 功能的 简单实现演示 仙魁XAN Unity进阶unityHybirdCLRYooAssetHotUpdate热更新
    Unity热更之【HybirdCLR】+【YooAsset】[安卓Android端][代码+资源热更]功能的简单实现演示目录Unity热更之【HybirdCLR】+【YooAsset】[安卓Android端][代码+资源热更]功能的简单实现演示一、简单介绍二、HybridCLR三、YooAsset四、HybirdCLR引入工程五、YooAsset引入工程六、Python服务器简单构建七、Hybir
  • Android 用线程池实现一个简单的任务队列(Kotlin) 深海呐 Android#Android进阶#Kotlinandroidkotlin线程池延时任务队列线程池延时任务
    关于线程池,Kotlin和java的使用方式一样在Android中,很多人喜欢用Handler的postDelayed()去实现延时任务.要使用postDelayed(),去实现延时任务队列,就不可避免要使用递归.但是这样做,代码的简洁性,和书写的简易,就远不如使用线程池.使用线程池的简单程度:privatevalmThreadPool=Executors.newSingleThreadSched
  • （小白入门）Windows环境下搭建React Native Android开发环境 码农老黑 前端ReactNative移动开发Androidstudio
    ReactNative(简称RN)是Facebook于2015年4月开源的跨平台移动应用开发框架，是Facebook早先开源的UI框架React在原生移动应用平台的衍生产物，目前支持iOS和Android两大平台。RN的环境搭建在RN的中文社区有所介绍，但是对于小白来说还是有些太过简略了。RN中文社区详见参考，本文不涉及的问题也许在其中能够有所解答。ReactNative思想底层引擎是JavaSc
  • Android Dialog圆角设置无效的问题 ly969434341 android
    一，参考AndroidDialog圆角设置无效的问题https://blog.csdn.net/woshi_awei/article/details/99664527Android自定义Dialog实现通用圆角对话框https://cloud.tencent.com/developer/article/1740956二，原因Diallog的默认背景是白色（直角背景），我自定义的Dialog背景也是
  • MultiSnapRecyclerView：让Android RecyclerView的滚动停靠更灵活 技术无疆 Androidandroiduiandroidstudioandroid-studiojavaandroidx
    在Android应用开发中，RecyclerView是一个强大且灵活的组件，用于展示大量数据集合。然而，标准的RecyclerView只支持单一的滚动停靠点，这在某些场景下可能不够灵活。为了解决这个问题，TakuSemba开发了一个名为MultiSnapRecyclerView的库，它允许开发者在RecyclerView中实现多个滚动停靠点。文章目录什么是MultiSnapRecyclerView
  • Android界面特效全汇总 小飞鹤 Android开发详解android
    （一）Activity页面切换的效果Android2.0之后有了overridePendingTransition（），其中里面两个参数，一个是前一个activity的退出两一个activity的进入，Java代码1.@OverridepublicvoidonCreate(BundlesavedInstanceState){2.super.onCreate(savedInstanceState);
  • Dom 周华华 JavaScripthtml
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml&q
  • 【Spark九十六】RDD API之combineByKey bit1129 spark
    1. combineByKey函数的运行机制   RDD提供了很多针对元素类型为(K,V)的API，这些API封装在PairRDDFunctions类中，通过Scala隐式转换使用。这些API实现上是借助于combineByKey实现的。combineByKey函数本身也是RDD开放给Spark开发人员使用的API之一   首先看一下combineByKey的方法说明：
  • msyql设置密码报错：ERROR 1372 (HY000): 解决方法详解 daizj mysql设置密码
    MySql给用户设置权限同时指定访问密码时，会提示如下错误： ERROR 1372 (HY000): Password hash should be a 41-digit hexadecimal number；   问题原因：你输入的密码是明文。不允许这么输入。   解决办法：用select password('你想输入的密码');查询出你的密码对应的字符串， 然后
  • 路漫漫其修远兮 吾将上下而求索 周凡杨 学习 思索
    王国维在他的《人间词话》中曾经概括了为学的三种境界古今之成大事业、大学问者，罔不经过三种之境界。“昨夜西风凋碧树。独上高楼，望尽天涯路。”此第一境界也。“衣带渐宽终不悔，为伊消得人憔悴。”此第二境界也。“众里寻他千百度，蓦然回首，那人却在灯火阑珊处。”此第三境界也。学习技术，这也是你必须经历的三种境界。第一层境界是说，学习的路是漫漫的，你必须做好充分的思想准备，如果半途而废还不如不要开始。这里，注
  • Hadoop(二)对话单的操作 朱辉辉33 hadoop
    Debug： 1、 A = LOAD '/user/hue/task.txt' USING PigStorage(' ') AS (col1,col2,col3); DUMP A; //输出结果前几行示例： (>ggsnPDPRecord(21),,) (-->recordType(0),,) (-->networkInitiation(1),,)
  • web报表工具FineReport常用函数的用法总结（日期和时间函数） 老A不折腾 finereport报表工具web开发
    web报表工具FineReport常用函数的用法总结（日期和时间函数）   说明：凡函数中以日期作为参数因子的，其中日期的形式都必须是yy/mm/dd。而且必须用英文环境下双引号(" ")引用。   DATE DATE(year,month,day):返回一个表示某一特定日期的系列数。 Year:代表年，可为一到四位数。 Month:代表月份。
  • c++ 宏定义中的##操作符 墙头上一根草 C++
    #与##在宏定义中的--宏展开 #include <stdio.h> #define f(a,b) a##b #define g(a)   #a #define h(a) g(a) int main() {       &nbs
  • 分析Spring源代码之，DI的实现 aijuans springDI现源代码
    (转) 分析Spring源代码之，DI的实现 2012/1/3 by tony                 接着上次的讲，以下这个sample [java]  view plain copy print
  • for循环的进化 alxw4616 JavaScript
    // for循环的进化 // 菜鸟 for (var i = 0; i < Things.length ; i++) { // Things[i] } // 老鸟 for (var i = 0, len = Things.length; i < len; i++) { // Things[i] } // 大师 for (var i = Things.le
  • 网络编程Socket和ServerSocket简单的使用 百合不是茶 网络编程基础IP地址端口
      网络编程;TCP/IP协议   网络:实现计算机之间的信息共享,数据资源的交换   协议:数据交换需要遵守的一种协议,按照约定的数据格式等写出去   端口:用于计算机之间的通信      每运行一个程序，系统会分配一个编号给该程序，作为和外界交换数据的唯一标识 0~65535   查看被使用的
  • JDK1.5 生产消费者 bijian1013 javathread生产消费者java多线程
    ArrayBlockingQueue：        一个由数组支持的有界阻塞队列。此队列按 FIFO（先进先出）原则对元素进行排序。队列的头部 是在队列中存在时间最长的元素。队列的尾部 是在队列中存在时间最短的元素。新元素插入到队列的尾部，队列检索操作则是从队列头部开始获得元素。 ArrayBlockingQueue的常用方法：
  • JAVA版身份证获取性别、出生日期及年龄 bijian1013 java性别出生日期年龄
            工作中需要根据身份证获取性别、出生日期及年龄，且要还要支持15位长度的身份证号码，网上搜索了一下，经过测试好像多少存在点问题，干脆自已写一个。 CertificateNo.java package com.bijian.study; import java.util.Calendar; import
  • 【Java范型六】范型与枚举 bit1129 java
    首先，枚举类型的定义不能带有类型参数，所以，不能把枚举类型定义为范型枚举类，例如下面的枚举类定义是有编译错的   public enum EnumGenerics<T> { //编译错，提示枚举不能带有范型参数 OK, ERROR; public <T> T get(T type) { return null;
  • 【Nginx五】Nginx常用日志格式含义 bit1129 nginx
    1. log_format 1.1 log_format指令用于指定日志的格式，格式：   log_format name(格式名称) type(格式样式)   1.2 如下是一个常用的Nginx日志格式：   log_format main '[$time_local]|$request_time|$status|$body_bytes
  • Lua 语言 15 分钟快速入门 ronin47 lua 基础
    - - 单行注释 - - [[      [多行注释] - - ]]   - - - - - - - - - - - 1. 变量 & 控制流 - - - - - - - - - - num = 23 - - 数字都是双精度 str = 'aspythonstring'
  • java-35.求一个矩阵中最大的二维矩阵 ( 元素和最大 ) bylijinnan java
    the idea is from: http://blog.csdn.net/zhanxinhang/article/details/6731134 public class MaxSubMatrix { /**see http://blog.csdn.net/zhanxinhang/article/details/6731134 * Q35 求一个矩阵中最大的二维
  • mongoDB文档型数据库特点 开窍的石头 mongoDB文档型数据库特点
    MongoDD: 文档型数据库存储的是Bson文档-->json的二进制 特点：内部是执行引擎是js解释器，把文档转成Bson结构，在查询时转换成js对象。 mongoDB传统型数据库对比    传统类型数据库：结构化数据，定好了表结构后每一个内容符合表结构的。也就是说每一行每一列的数据都是一样的    文档型数据库：不用定好数据结构，
  • [毕业季节]欢迎广大毕业生加入JAVA程序员的行列 comsci java
        一年一度的毕业季来临了。。。。。。。。      正在投简历的学弟学妹们。。。如果觉得学校推荐的单位和公司不适合自己的兴趣和专业，可以考虑来我们软件行业，做一名职业程序员。。。      软件行业的开发工具中，对初学者最友好的就是JAVA语言了，网络上不仅仅有大量的
  • PHP操作Excel – PHPExcel 基本用法详解 cuiyadll PHPExcel
    导出excel属性设置//Include classrequire_once('Classes/PHPExcel.php');require_once('Classes/PHPExcel/Writer/Excel2007.php');$objPHPExcel = new PHPExcel();//Set properties 设置文件属性$objPHPExcel->getProperties
  • IBM Webshpere MQ Client User Issue (MCAUSER) darrenzhu IBMjmsuserMQMCAUSER
    IBM MQ JMS Client去连接远端MQ Server的时候，需要提供User和Password吗？ 答案是根据情况而定，取决于所定义的Channel里面的属性Message channel agent user identifier (MCAUSER)的设置。 http://stackoverflow.com/questions/20209429/how-mca-user-i
  • 网线的接法 dcj3sjt126com
    一、PC连HUB (直连线)A端：（标准568B）：白橙，橙，白绿，蓝，白蓝，绿，白棕，棕。 B端：（标准568B）：白橙，橙，白绿，蓝，白蓝，绿，白棕，棕。 二、PC连PC （交叉线）A端：(568A)： 白绿，绿，白橙，蓝，白蓝，橙，白棕，棕； B端：（标准568B）：白橙，橙，白绿，蓝，白蓝，绿，白棕，棕。 三、HUB连HUB&nb
  • Vimium插件让键盘党像操作Vim一样操作Chrome dcj3sjt126com chromevim
    什么是键盘党？ 键盘党是指尽可能将所有电脑操作用键盘来完成，而不去动鼠标的人。鼠标应该说是新手们的最爱，很直观，指哪点哪，很听话！不过常常使用电脑的人，如果一直使用鼠标的话，手会发酸，因为操作鼠标的时候，手臂不是在一个自然的状态，臂肌会处于绷紧状态。而使用键盘则双手是放松状态，只有手指在动。而且尽量少的从鼠标移动到键盘来回操作，也省不少事。 在chrome里安装 vimium 插件
  • MongoDB查询（2）——数组查询[六] eksliang mongodbMongoDB查询数组
    MongoDB查询数组 转载请出自出处：http://eksliang.iteye.com/blog/2177292 一、概述  MongoDB查询数组与查询标量值是一样的，例如，有一个水果列表，如下所示： > db.food.find() { "_id" : "001", "fruits" : [ "苹
  • cordova读写文件（1） gundumw100 JavaScriptCordova
    使用cordova可以很方便的在手机sdcard中读写文件。 首先需要安装cordova插件：file 命令为： cordova plugin add org.apache.cordova.file 然后就可以读写文件了，这里我先是写入一个文件，具体的JS代码为： var datas=null;//datas need write var directory=&
  • HTML5 FormData 进行文件jquery ajax 上传 到又拍云 ileson jqueryAjaxhtml5FormData
    html5 新东西：FormData  可以提交二进制数据。 页面test.html <!DOCTYPE> <html> <head> <title> formdata file jquery ajax upload</title> </head> <body> <
  • swift appearanceWhenContainedIn:(version1.2 xcode6.4) 啸笑天 version
      swift1.2中没有oc中对应的方法： + (instancetype)appearanceWhenContainedIn:(Class <UIAppearanceContainer>)ContainerClass, ... NS_REQUIRES_NIL_TERMINATION;  解决方法： 在swift项目中新建oc类如下： #import &
  • java实现SMTP邮件服务器 macroli java编程
    电子邮件传递可以由多种协议来实现。目前，在Internet 网上最流行的三种电子邮件协议是SMTP、POP3 和 IMAP，下面分别简单介绍。 　　◆ SMTP 协议 　　简单邮件传输协议(Simple Mail Transfer Protocol,SMTP)是一个运行在TCP/IP之上的协议，用它发送和接收电子邮件。SMTP 服务器在默认端口25上监听。SMTP客户使用一组简单的、基于文本的
  • mongodb group by having where 查询sql qiaolevip 每天进步一点点学习永无止境mongo纵观千象
    SELECT cust_id, SUM(price) as total FROM orders WHERE status = 'A' GROUP BY cust_id HAVING total > 250 db.orders.aggregate( [ { $match: { status: 'A' } }, { $group: {
  • Struts2 Pojo（六） Luob. POJOstrust2
    注意：附件中有完整案例 1.采用POJO对象的方法进行赋值和传值 2.web配置 <?xml version="1.0" encoding="UTF-8"?> <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee&q
  • struts2步骤 wuai struts
    1、添加jar包 2、在web.xml中配置过滤器 <filter>        <filter-name>struts2</filter-name>        <filter-class>org.apache.st
按字母分类： ABCDEFGHIJKLMNOPQRSTUVWXYZ其他