فرمت های پیکسل جدید را به اندروید اضافه کنید

افزودن پشتیبانی برای فرمت پیکسل جدید نیازمند تغییراتی در hardware_buffer.h و AHardwareBuffer.cpp است. برای کد منبع AHB به frameworks/native/libs/nativewindow مراجعه کنید.

برای افزودن فرمت پیکسل جدید به AHB، این مراحل را دنبال کنید:

1. در hardware_buffer.h ، فرمت پیکسل جدید را به عنوان یک ورودی جدید به انتهای enum AHardwareBuffer_Format اضافه کنید. از قراردادهای کد موجود پیروی کنید.

   با استفاده از مثال فرمت پیکسل RGBA_8888 ، ورودی فرمت پیکسل جدید را به صورت زیر اضافه کنید:

   /**
    * Corresponding formats:
    *   Vulkan: VK_FORMAT_R8G8B8A8_UNORM
    *   OpenGL ES: GL_RGBA8
    */
   AHARDWAREBUFFER_FORMAT_R8G8B8A8_UNORM = 1,
   

   توجه داشته باشید که فرمت پیکسل جدید در AHB نامی دارد که باید با AHARDWAREBUFFER_FORMAT_ شروع شود و به دنبال آن اختصارات کانال و عمق بیت‌ها و در نهایت کدگذاری قرار گیرد. این ورودی شمارشی باید همان مقدار هگز موجود در PixelFormat.aidl را داشته باشد.

   انتظار می‌رود فرمت پیکسل، یک یا هر دو فرمت مرتبط Vulkan یا OpenGL ES را داشته باشد. در صورت لزوم، فرمت مرتبط را مشخص کنید. اگر فرمت مرتبطی وجود ندارد، مشخص کنید N/A .

2. اگر فرمت پیکسل با فرمت OpenGL ES مرتبط است، آن را به تست اختیاری تحت CTS اضافه کنید. برای انجام این کار، فرمت GL جدید را به AHardwareBufferGLTest.cpp در AHBFormatAsString(int32_t format) با FORMAT_CASE(...) و GL_FORMAT_CASE(...) برای فرمت جدید، که به شرح زیر نشان داده شده است، اضافه کنید:

   const char* AHBFormatAsString(int32_t format) {
     switch (format) {
         ...
         FORMAT_CASE(R8G8B8A8_UNORM);
         ...
         GL_FORMAT_CASE(GL_RGB8);
     }
     return "";
   }
   

3. سپس، یک تست جدید به AHardwareBufferGLTest.cpp اضافه کنید، که به صورت زیر نشان داده شده است:

   class RGBA8Test : public AHardwareBufferGLTest {};
   
   // Verify that if we can allocate an RGBA8 AHB we can render to it.
   TEST_P(RGBA8Test, Write) {
       AHardwareBuffer_Desc desc = GetParam();
       desc.usage = AHARDWAREBUFFER_USAGE_GPU_FRAMEBUFFER;
       if (!SetUpBuffer(desc)) {
           return;
       }
   
       ASSERT_NO_FATAL_FAILURE(SetUpFramebuffer(desc.width, desc.height, 0, kBufferAsRenderbuffer));
       ASSERT_NO_FATAL_FAILURE(
           SetUpProgram(kVertexShader, kColorFragmentShader, kPyramidPositions, 0.5f));
   
       glDrawArrays(GL_TRIANGLES, 0, kPyramidVertexCount);
       ASSERT_EQ(GLenum{GL_NO_ERROR}, glGetError());
   }
   
   INSTANTIATE_TEST_CASE_P(
       SingleLayer, RGBA8Test,
       ::testing::Values(
           AHardwareBuffer_Desc{57, 33, 1, AHARDWAREBUFFER_FORMAT_R16G16_UINT, 0, 0, 0, 0}),
       &GetTestName);
   

   حداقل یک مجموعه از مقادیر AHardwareBuffer_Desc را مشخص کنید. در صورت نیاز مقادیر بیشتری اضافه کنید.

4. در AHardwareBuffer.cpp ، انتهای دستورات استاتیک موجود در داخل آن را پیدا کنید:

   // ----------------------------------------------------------------------------
   // Validate hardware_buffer.h and PixelFormat.aidl agree
   // ----------------------------------------------------------------------------
   

   یک static_assert جدید برای فرمت پیکسل جدید اضافه کنید، با استفاده از PixelFormat:: enum و نه با ثابت HAL_PIXEL_FORMAT . با استفاده از همان مثال برای فرمت پیکسل RGBA_8888 از Add a new pixel format to AIDL ، ورودی فرمت پیکسل جدید را به شرح زیر اضافه کنید:

   static_assert(static_cast(aidl::android::hardware::graphics::common::PixelFormat::RGBA_8888) ==
     AHARDWAREBUFFER_FORMAT_R8G8B8A8_UNORM,
   "HAL and AHardwareBuffer pixel format don't match");
   

5. با افزودن فرمت پیکسل جدید به انتهای PrintAhbFormat() در AHardwareBufferTest.cpp ، فرمت پیکسل جدید را به تست‌های مربوطه اضافه کنید. از قرارداد کد موجود، همانطور که در زیر نشان داده شده است، پیروی کنید:

   void PrintAhbFormat(std::ostream& os, uint64_t format) {
       switch (format) {
           ...
           FORMAT_CASE(R8G8B8A8_UNORM);
           default: os << "unknown"; break;
       }
   }
   

6. فرمت پیکسل جدید را با اضافه کردن یک ورودی جدید به @IntDef به HardwareBuffer SDK در HardwareBuffer.java اضافه کنید. برای مثال، ورودی مربوط به فرمت RGBA_8888 به صورت زیر نمایش داده می‌شود:

   @Retention(RetentionPolicy.SOURCE)
   @IntDef(prefix = { "RGB", "BLOB", "YCBCR_", "D_", "DS_", "S_" }, value = {
     ...
     RGBA_8888,
   })
   

   اگر مقادیر مؤلفه بدون علامت نرمال‌سازی نشده باشند، مقدار را به صراحت در نام متغیر ذکر کنید. برای مثال، نام متغیر برای یک فرمت کانال قرمز ۱۶ بیتی بدون علامت که فقط عدد صحیح است، باید R_16UI باشد و همان فرمت با یک فرمت کانال سبز ۱۶ بیتی بدون علامت اضافی باید RG_16UI16UI باشد.

7. با افزودن یک متغیر عضو عمومی جدید در انتهای @Format ، فرمت پیکسل جدید را به عنوان یک static int در HardwareBuffer.java اضافه کنید:

   @Format
   ...
   /** Format: 8 bits each red, green, blue, alpha */
   public static final int RGBA_8888 = 0x1;
   

   این ورودی شمارشی باید همان مقدار هگز را داشته باشد که در PixelFormat.aidl و hardware_buffer.h وجود دارد. از قراردادهای موجود پیروی کنید.

8. تلاش برای ساخت با این تغییرات کد، خطای ساخت ایجاد می‌کند:

   android_developer:~/android/aosp-android-latest-release: m
   ...
   ******************************
   You have tried to change the API from what has been previously approved.
   
   To make these errors go away, you have two choices:
      1. You can add '@hide' javadoc comments (and remove @SystemApi/@TestApi/etc)
         to the new methods, etc. shown in the above diff.
   
      2. You can update current.txt and/or removed.txt by executing the following command:
            m api-stubs-docs-non-updatable-update-current-api
   
         To submit the revised current.txt to the main Android repository,
         you will need approval.
   ******************************
   ...
   

   برای رفع این خطا، دستور زیر را، همانطور که در پیام خطا مشخص شده است، برای تغییر current.txt اجرا کنید:

   m api-stubs-docs-non-updatable-update-current-api
   

   اجرای دستور بالا، فایل صحیح را به‌روزرسانی می‌کند تا بتوان آن را به طور عادی ساخت.

9. قالب پیکسل جدید را با اضافه کردن قالب پیکسل جدید به انتهای paramsForTestCreateOptionalFormats() در HardwareBufferTest.java ، که به صورت زیر نشان داده شده است، به تست‌های جاوا اضافه کنید:

   private static Object[] paramsForTestCreateOptionalFormats() {
     return new Integer[]{
         HardwareBuffer.RGBA_8888
     };