helpers.c

   1 /*
   2  * Copyright 2014 The Chromium OS Authors. All rights reserved.
   3  * Use of this source code is governed by a BSD-style license that can be
   4  * found in the LICENSE file.
   5  */
   6
   7 #include <assert.h>
   8 #include <errno.h>
   9 #include <stdbool.h>
  10 #include <stdio.h>
  11 #include <stdlib.h>
  12 #include <string.h>
  13 #include <sys/mman.h>
  14 #include <xf86drm.h>
  15 #include <xf86drmMode.h>
  16
  17 #include "drv_priv.h"
  18 #include "helpers.h"
  19 #include "util.h"
  20
  21 struct planar_layout {
  22         size_t num_planes;
  23         int horizontal_subsampling[DRV_MAX_PLANES];
  24         int vertical_subsampling[DRV_MAX_PLANES];
  25         int bytes_per_pixel[DRV_MAX_PLANES];
  26 };
  27
  28 // clang-format off
  29
  30 static const struct planar_layout packed_1bpp_layout = {
  31         .num_planes = 1,
  32         .horizontal_subsampling = { 1 },
  33         .vertical_subsampling = { 1 },
  34         .bytes_per_pixel = { 1 }
  35 };
  36
  37 static const struct planar_layout packed_2bpp_layout = {
  38         .num_planes = 1,
  39         .horizontal_subsampling = { 1 },
  40         .vertical_subsampling = { 1 },
  41         .bytes_per_pixel = { 2 }
  42 };
  43
  44 static const struct planar_layout packed_3bpp_layout = {
  45         .num_planes = 1,
  46         .horizontal_subsampling = { 1 },
  47         .vertical_subsampling = { 1 },
  48         .bytes_per_pixel = { 3 }
  49 };
  50
  51 static const struct planar_layout packed_4bpp_layout = {
  52         .num_planes = 1,
  53         .horizontal_subsampling = { 1 },
  54         .vertical_subsampling = { 1 },
  55         .bytes_per_pixel = { 4 }
  56 };
  57
  58 static const struct planar_layout packed_8bpp_layout = {
  59         .num_planes = 1,
  60         .horizontal_subsampling = { 1 },
  61         .vertical_subsampling = { 1 },
  62         .bytes_per_pixel = { 8 }
  63 };
  64
  65 static const struct planar_layout biplanar_yuv_420_layout = {
  66         .num_planes = 2,
  67         .horizontal_subsampling = { 1, 2 },
  68         .vertical_subsampling = { 1, 2 },
  69         .bytes_per_pixel = { 1, 2 }
  70 };
  71
  72 static const struct planar_layout triplanar_yuv_420_layout = {
  73         .num_planes = 3,
  74         .horizontal_subsampling = { 1, 2, 2 },
  75         .vertical_subsampling = { 1, 2, 2 },
  76         .bytes_per_pixel = { 1, 1, 1 }
  77 };
  78
  79 // clang-format on
  80
  81 static const struct planar_layout *layout_from_format(uint32_t format)
  82 {
  83         switch (format) {
  84         case DRM_FORMAT_BGR233:
  85         case DRM_FORMAT_C8:
  86         case DRM_FORMAT_R8:
  87         case DRM_FORMAT_RGB332:
  88                 return &packed_1bpp_layout;
  89
  90         case DRM_FORMAT_YVU420:
  91         case DRM_FORMAT_YVU420_ANDROID:
  92                 return &triplanar_yuv_420_layout;
  93
  94         case DRM_FORMAT_NV12:
  95         case DRM_FORMAT_NV21:
  96                 return &biplanar_yuv_420_layout;
  97
  98         case DRM_FORMAT_ABGR1555:
  99         case DRM_FORMAT_ABGR4444:
 100         case DRM_FORMAT_ARGB1555:
 101         case DRM_FORMAT_ARGB4444:
 102         case DRM_FORMAT_BGR565:
 103         case DRM_FORMAT_BGRA4444:
 104         case DRM_FORMAT_BGRA5551:
 105         case DRM_FORMAT_BGRX4444:
 106         case DRM_FORMAT_BGRX5551:
 107         case DRM_FORMAT_GR88:
 108         case DRM_FORMAT_RG88:
 109         case DRM_FORMAT_RGB565:
 110         case DRM_FORMAT_RGBA4444:
 111         case DRM_FORMAT_RGBA5551:
 112         case DRM_FORMAT_RGBX4444:
 113         case DRM_FORMAT_RGBX5551:
 114         case DRM_FORMAT_UYVY:
 115         case DRM_FORMAT_VYUY:
 116         case DRM_FORMAT_XBGR1555:
 117         case DRM_FORMAT_XBGR4444:
 118         case DRM_FORMAT_XRGB1555:
 119         case DRM_FORMAT_XRGB4444:
 120         case DRM_FORMAT_YUYV:
 121         case DRM_FORMAT_YVYU:
 122                 return &packed_2bpp_layout;
 123
 124         case DRM_FORMAT_BGR888:
 125         case DRM_FORMAT_RGB888:
 126                 return &packed_3bpp_layout;
 127
 128         case DRM_FORMAT_ABGR2101010:
 129         case DRM_FORMAT_ABGR8888:
 130         case DRM_FORMAT_ARGB2101010:
 131         case DRM_FORMAT_ARGB8888:
 132         case DRM_FORMAT_AYUV:
 133         case DRM_FORMAT_BGRA1010102:
 134         case DRM_FORMAT_BGRA8888:
 135         case DRM_FORMAT_BGRX1010102:
 136         case DRM_FORMAT_BGRX8888:
 137         case DRM_FORMAT_RGBA1010102:
 138         case DRM_FORMAT_RGBA8888:
 139         case DRM_FORMAT_RGBX1010102:
 140         case DRM_FORMAT_RGBX8888:
 141         case DRM_FORMAT_XBGR2101010:
 142         case DRM_FORMAT_XBGR8888:
 143         case DRM_FORMAT_XRGB2101010:
 144         case DRM_FORMAT_XRGB8888:
 145                 return &packed_4bpp_layout;
 146
 147         case DRM_FORMAT_XBGR16161616:
 148                 return &packed_8bpp_layout;
 149
 150         default:
 151                 drv_log("UNKNOWN FORMAT %d\n", format);
 152                 return NULL;
 153         }
 154 }
 155
 156 size_t drv_num_planes_from_format(uint32_t format)
 157 {
 158         const struct planar_layout *layout = layout_from_format(format);
 159
 160         /*
 161          * drv_bo_new calls this function early to query number of planes and
 162          * considers 0 planes to mean unknown format, so we have to support
 163          * that.  All other layout_from_format() queries can assume that the
 164          * format is supported and that the return value is non-NULL.
 165          */
 166
 167         return layout ? layout->num_planes : 0;
 168 }
 169
 170 uint32_t drv_height_from_format(uint32_t format, uint32_t height, size_t plane)
 171 {
 172         const struct planar_layout *layout = layout_from_format(format);
 173
 174         assert(plane < layout->num_planes);
 175
 176         return DIV_ROUND_UP(height, layout->vertical_subsampling[plane]);
 177 }
 178
 179 uint32_t drv_bytes_per_pixel_from_format(uint32_t format, size_t plane)
 180 {
 181         const struct planar_layout *layout = layout_from_format(format);
 182
 183         assert(plane < layout->num_planes);
 184
 185         return layout->bytes_per_pixel[plane];
 186 }
 187
 188 uint32_t drv_bo_get_stride_in_pixels(struct bo *bo)
 189 {
 190         uint32_t bytes_per_pixel = drv_bytes_per_pixel_from_format(bo->format, 0);
 191         return DIV_ROUND_UP(bo->strides[0], bytes_per_pixel);
 192 }
 193
 194 /*
 195  * This function returns the stride for a given format, width and plane.
 196  */
 197 uint32_t drv_stride_from_format(uint32_t format, uint32_t width, size_t plane)
 198 {
 199         const struct planar_layout *layout = layout_from_format(format);
 200         assert(plane < layout->num_planes);
 201
 202         uint32_t plane_width = DIV_ROUND_UP(width, layout->horizontal_subsampling[plane]);
 203         uint32_t stride = plane_width * layout->bytes_per_pixel[plane];
 204
 205         /*
 206          * The stride of Android YV12 buffers is required to be aligned to 16 bytes
 207          * (see <system/graphics.h>).
 208          */
 209         if (format == DRM_FORMAT_YVU420_ANDROID)
 210                 stride = (plane == 0) ? ALIGN(stride, 32) : ALIGN(stride, 16);
 211
 212         return stride;
 213 }
 214
 215 uint32_t drv_size_from_format(uint32_t format, uint32_t stride, uint32_t height, size_t plane)
 216 {
 217         return stride * drv_height_from_format(format, height, plane);
 218 }
 219
 220 static uint32_t subsample_stride(uint32_t stride, uint32_t format, size_t plane)
 221 {
 222         if (plane != 0) {
 223                 switch (format) {
 224                 case DRM_FORMAT_YVU420:
 225                 case DRM_FORMAT_YVU420_ANDROID:
 226                         stride = DIV_ROUND_UP(stride, 2);
 227                         break;
 228                 }
 229         }
 230
 231         return stride;
 232 }
 233
 234 /*
 235  * This function fills in the buffer object given the driver aligned stride of
 236  * the first plane, height and a format. This function assumes there is just
 237  * one kernel buffer per buffer object.
 238  */
 239 int drv_bo_from_format(struct bo *bo, uint32_t stride, uint32_t aligned_height, uint32_t format)
 240 {
 241
 242         size_t p, num_planes;
 243         uint32_t offset = 0;
 244
 245         num_planes = drv_num_planes_from_format(format);
 246         assert(num_planes);
 247
 248         /*
 249          * HAL_PIXEL_FORMAT_YV12 requires that (see <system/graphics.h>):
 250          *  - the aligned height is same as the buffer's height.
 251          *  - the chroma stride is 16 bytes aligned, i.e., the luma's strides
 252          *    is 32 bytes aligned.
 253          */
 254         if (format == DRM_FORMAT_YVU420_ANDROID) {
 255                 assert(aligned_height == bo->height);
 256                 assert(stride == ALIGN(stride, 32));
 257         }
 258
 259         for (p = 0; p < num_planes; p++) {
 260                 bo->strides[p] = subsample_stride(stride, format, p);
 261                 bo->sizes[p] = drv_size_from_format(format, bo->strides[p], aligned_height, p);
 262                 bo->offsets[p] = offset;
 263                 offset += bo->sizes[p];
 264         }
 265
 266         bo->total_size = offset;
 267         return 0;
 268 }
 269
 270 int drv_dumb_bo_create(struct bo *bo, uint32_t width, uint32_t height, uint32_t format,
 271                        uint64_t use_flags)
 272 {
 273         int ret;
 274         size_t plane;
 275         uint32_t aligned_width, aligned_height;
 276         struct drm_mode_create_dumb create_dumb;
 277
 278         aligned_width = width;
 279         aligned_height = height;
 280         if (format == DRM_FORMAT_YVU420_ANDROID) {
 281                 /*
 282                  * Align width to 32 pixels, so chroma strides are 16 bytes as
 283                  * Android requires.
 284                  */
 285                 aligned_width = ALIGN(width, 32);
 286         }
 287
 288         if (format == DRM_FORMAT_YVU420_ANDROID || format == DRM_FORMAT_YVU420) {
 289                 aligned_height = 3 * DIV_ROUND_UP(height, 2);
 290         }
 291
 292         memset(&create_dumb, 0, sizeof(create_dumb));
 293         create_dumb.height = aligned_height;
 294         create_dumb.width = aligned_width;
 295         create_dumb.bpp = layout_from_format(format)->bytes_per_pixel[0] * 8;
 296         create_dumb.flags = 0;
 297
 298         ret = drmIoctl(bo->drv->fd, DRM_IOCTL_MODE_CREATE_DUMB, &create_dumb);
 299         if (ret) {
 300                 drv_log("DRM_IOCTL_MODE_CREATE_DUMB failed (%d, %d)\n", bo->drv->fd, errno);
 301                 return ret;
 302         }
 303
 304         drv_bo_from_format(bo, create_dumb.pitch, height, format);
 305
 306         for (plane = 0; plane < bo->num_planes; plane++)
 307                 bo->handles[plane].u32 = create_dumb.handle;
 308
 309         bo->total_size = create_dumb.size;
 310         return 0;
 311 }
 312
 313 int drv_dumb_bo_destroy(struct bo *bo)
 314 {
 315         struct drm_mode_destroy_dumb destroy_dumb;
 316         int ret;
 317
 318         memset(&destroy_dumb, 0, sizeof(destroy_dumb));
 319         destroy_dumb.handle = bo->handles[0].u32;
 320
 321         ret = drmIoctl(bo->drv->fd, DRM_IOCTL_MODE_DESTROY_DUMB, &destroy_dumb);
 322         if (ret) {
 323                 drv_log("DRM_IOCTL_MODE_DESTROY_DUMB failed (handle=%x)\n", bo->handles[0].u32);
 324                 return ret;
 325         }
 326
 327         return 0;
 328 }
 329
 330 int drv_gem_bo_destroy(struct bo *bo)
 331 {
 332         struct drm_gem_close gem_close;
 333         int ret, error = 0;
 334         size_t plane, i;
 335
 336         for (plane = 0; plane < bo->num_planes; plane++) {
 337                 for (i = 0; i < plane; i++)
 338                         if (bo->handles[i].u32 == bo->handles[plane].u32)
 339                                 break;
 340                 /* Make sure close hasn't already been called on this handle */
 341                 if (i != plane)
 342                         continue;
 343
 344                 memset(&gem_close, 0, sizeof(gem_close));
 345                 gem_close.handle = bo->handles[plane].u32;
 346
 347                 ret = drmIoctl(bo->drv->fd, DRM_IOCTL_GEM_CLOSE, &gem_close);
 348                 if (ret) {
 349                         drv_log("DRM_IOCTL_GEM_CLOSE failed (handle=%x) error %d\n",
 350                                 bo->handles[plane].u32, ret);
 351                         error = ret;
 352                 }
 353         }
 354
 355         return error;
 356 }
 357
 358 int drv_prime_bo_import(struct bo *bo, struct drv_import_fd_data *data)
 359 {
 360         int ret;
 361         size_t plane;
 362         struct drm_prime_handle prime_handle;
 363
 364         for (plane = 0; plane < bo->num_planes; plane++) {
 365                 memset(&prime_handle, 0, sizeof(prime_handle));
 366                 prime_handle.fd = data->fds[plane];
 367
 368                 ret = drmIoctl(bo->drv->fd, DRM_IOCTL_PRIME_FD_TO_HANDLE, &prime_handle);
 369
 370                 if (ret) {
 371                         drv_log("DRM_IOCTL_PRIME_FD_TO_HANDLE failed (fd=%u)\n", prime_handle.fd);
 372
 373                         /*
 374                          * Need to call GEM close on planes that were opened,
 375                          * if any. Adjust the num_planes variable to be the
 376                          * plane that failed, so GEM close will be called on
 377                          * planes before that plane.
 378                          */
 379                         bo->num_planes = plane;
 380                         drv_gem_bo_destroy(bo);
 381                         return ret;
 382                 }
 383
 384                 bo->handles[plane].u32 = prime_handle.handle;
 385         }
 386
 387         for (plane = 0; plane < bo->num_planes; plane++) {
 388                 pthread_mutex_lock(&bo->drv->driver_lock);
 389                 drv_increment_reference_count(bo->drv, bo, plane);
 390                 pthread_mutex_unlock(&bo->drv->driver_lock);
 391         }
 392
 393         return 0;
 394 }
 395
 396 void *drv_dumb_bo_map(struct bo *bo, struct vma *vma, size_t plane, uint32_t map_flags)
 397 {
 398         int ret;
 399         size_t i;
 400         struct drm_mode_map_dumb map_dumb;
 401
 402         memset(&map_dumb, 0, sizeof(map_dumb));
 403         map_dumb.handle = bo->handles[plane].u32;
 404
 405         ret = drmIoctl(bo->drv->fd, DRM_IOCTL_MODE_MAP_DUMB, &map_dumb);
 406         if (ret) {
 407                 drv_log("DRM_IOCTL_MODE_MAP_DUMB failed\n");
 408                 return MAP_FAILED;
 409         }
 410
 411         for (i = 0; i < bo->num_planes; i++)
 412                 if (bo->handles[i].u32 == bo->handles[plane].u32)
 413                         vma->length += bo->sizes[i];
 414
 415         return mmap(0, vma->length, drv_get_prot(map_flags), MAP_SHARED, bo->drv->fd,
 416                     map_dumb.offset);
 417 }
 418
 419 int drv_bo_munmap(struct bo *bo, struct vma *vma)
 420 {
 421         return munmap(vma->addr, vma->length);
 422 }
 423
 424 int drv_mapping_destroy(struct bo *bo)
 425 {
 426         int ret;
 427         size_t plane;
 428         struct mapping *mapping;
 429         uint32_t idx;
 430
 431         /*
 432          * This function is called right before the buffer is destroyed. It will free any mappings
 433          * associated with the buffer.
 434          */
 435
 436         idx = 0;
 437         for (plane = 0; plane < bo->num_planes; plane++) {
 438                 while (idx < drv_array_size(bo->drv->mappings)) {
 439                         mapping = (struct mapping *)drv_array_at_idx(bo->drv->mappings, idx);
 440                         if (mapping->vma->handle != bo->handles[plane].u32) {
 441                                 idx++;
 442                                 continue;
 443                         }
 444
 445                         if (!--mapping->vma->refcount) {
 446                                 ret = bo->drv->backend->bo_unmap(bo, mapping->vma);
 447                                 if (ret) {
 448                                         drv_log("munmap failed\n");
 449                                         return ret;
 450                                 }
 451
 452                                 free(mapping->vma);
 453                         }
 454
 455                         /* This shrinks and shifts the array, so don't increment idx. */
 456                         drv_array_remove(bo->drv->mappings, idx);
 457                 }
 458         }
 459
 460         return 0;
 461 }
 462
 463 int drv_get_prot(uint32_t map_flags)
 464 {
 465         return (BO_MAP_WRITE & map_flags) ? PROT_WRITE | PROT_READ : PROT_READ;
 466 }
 467
 468 uintptr_t drv_get_reference_count(struct driver *drv, struct bo *bo, size_t plane)
 469 {
 470         void *count;
 471         uintptr_t num = 0;
 472
 473         if (!drmHashLookup(drv->buffer_table, bo->handles[plane].u32, &count))
 474                 num = (uintptr_t)(count);
 475
 476         return num;
 477 }
 478
 479 void drv_increment_reference_count(struct driver *drv, struct bo *bo, size_t plane)
 480 {
 481         uintptr_t num = drv_get_reference_count(drv, bo, plane);
 482
 483         /* If a value isn't in the table, drmHashDelete is a no-op */
 484         drmHashDelete(drv->buffer_table, bo->handles[plane].u32);
 485         drmHashInsert(drv->buffer_table, bo->handles[plane].u32, (void *)(num + 1));
 486 }
 487
 488 void drv_decrement_reference_count(struct driver *drv, struct bo *bo, size_t plane)
 489 {
 490         uintptr_t num = drv_get_reference_count(drv, bo, plane);
 491
 492         drmHashDelete(drv->buffer_table, bo->handles[plane].u32);
 493
 494         if (num > 0)
 495                 drmHashInsert(drv->buffer_table, bo->handles[plane].u32, (void *)(num - 1));
 496 }
 497
 498 uint32_t drv_log_base2(uint32_t value)
 499 {
 500         int ret = 0;
 501
 502         while (value >>= 1)
 503                 ++ret;
 504
 505         return ret;
 506 }
 507
 508 void drv_add_combinations(struct driver *drv, const uint32_t *formats, uint32_t num_formats,
 509                           struct format_metadata *metadata, uint64_t use_flags)
 510 {
 511         uint32_t i;
 512
 513         for (i = 0; i < num_formats; i++) {
 514                 struct combination combo = { .format = formats[i],
 515                                              .metadata = *metadata,
 516                                              .use_flags = use_flags };
 517
 518                 drv_array_append(drv->combos, &combo);
 519         }
 520 }
 521
 522 void drv_modify_combination(struct driver *drv, uint32_t format, struct format_metadata *metadata,
 523                             uint64_t use_flags)
 524 {
 525         uint32_t i;
 526         struct combination *combo;
 527         /* Attempts to add the specified flags to an existing combination. */
 528         for (i = 0; i < drv_array_size(drv->combos); i++) {
 529                 combo = (struct combination *)drv_array_at_idx(drv->combos, i);
 530                 if (combo->format == format && combo->metadata.tiling == metadata->tiling &&
 531                     combo->metadata.modifier == metadata->modifier)
 532                         combo->use_flags |= use_flags;
 533         }
 534 }
 535
 536 struct drv_array *drv_query_kms(struct driver *drv)
 537 {
 538         struct drv_array *kms_items;
 539         uint64_t plane_type, use_flag;
 540         uint32_t i, j, k;
 541
 542         drmModePlanePtr plane;
 543         drmModePropertyPtr prop;
 544         drmModePlaneResPtr resources;
 545         drmModeObjectPropertiesPtr props;
 546
 547         kms_items = drv_array_init(sizeof(struct kms_item));
 548         if (!kms_items)
 549                 goto out;
 550
 551         /*
 552          * The ability to return universal planes is only complete on
 553          * ChromeOS kernel versions >= v3.18.  The SET_CLIENT_CAP ioctl
 554          * therefore might return an error code, so don't check it.  If it
 555          * fails, it'll just return the plane list as overlay planes, which is
 556          * fine in our case (our drivers already have cursor bits set).
 557          * modetest in libdrm does the same thing.
 558          */
 559         drmSetClientCap(drv->fd, DRM_CLIENT_CAP_UNIVERSAL_PLANES, 1);
 560
 561         resources = drmModeGetPlaneResources(drv->fd);
 562         if (!resources)
 563                 goto out;
 564
 565         for (i = 0; i < resources->count_planes; i++) {
 566                 plane = drmModeGetPlane(drv->fd, resources->planes[i]);
 567                 if (!plane)
 568                         goto out;
 569
 570                 props = drmModeObjectGetProperties(drv->fd, plane->plane_id, DRM_MODE_OBJECT_PLANE);
 571                 if (!props)
 572                         goto out;
 573
 574                 for (j = 0; j < props->count_props; j++) {
 575                         prop = drmModeGetProperty(drv->fd, props->props[j]);
 576                         if (prop) {
 577                                 if (strcmp(prop->name, "type") == 0) {
 578                                         plane_type = props->prop_values[j];
 579                                 }
 580
 581                                 drmModeFreeProperty(prop);
 582                         }
 583                 }
 584
 585                 switch (plane_type) {
 586                 case DRM_PLANE_TYPE_OVERLAY:
 587                 case DRM_PLANE_TYPE_PRIMARY:
 588                         use_flag = BO_USE_SCANOUT;
 589                         break;
 590                 case DRM_PLANE_TYPE_CURSOR:
 591                         use_flag = BO_USE_CURSOR;
 592                         break;
 593                 default:
 594                         assert(0);
 595                 }
 596
 597                 for (j = 0; j < plane->count_formats; j++) {
 598                         bool found = false;
 599                         for (k = 0; k < drv_array_size(kms_items); k++) {
 600                                 struct kms_item *item = drv_array_at_idx(kms_items, k);
 601                                 if (item->format == plane->formats[j] &&
 602                                     item->modifier == DRM_FORMAT_MOD_LINEAR) {
 603                                         item->use_flags |= use_flag;
 604                                         found = true;
 605                                         break;
 606                                 }
 607                         }
 608
 609                         if (!found) {
 610                                 struct kms_item item = { .format = plane->formats[j],
 611                                                          .modifier = DRM_FORMAT_MOD_LINEAR,
 612                                                          .use_flags = use_flag };
 613
 614                                 drv_array_append(kms_items, &item);
 615                         }
 616                 }
 617
 618                 drmModeFreeObjectProperties(props);
 619                 drmModeFreePlane(plane);
 620         }
 621
 622         drmModeFreePlaneResources(resources);
 623 out:
 624         if (kms_items && !drv_array_size(kms_items)) {
 625                 drv_array_destroy(kms_items);
 626                 return NULL;
 627         }
 628
 629         return kms_items;
 630 }
 631
 632 int drv_modify_linear_combinations(struct driver *drv)
 633 {
 634         uint32_t i, j;
 635         struct kms_item *item;
 636         struct combination *combo;
 637         struct drv_array *kms_items;
 638
 639         /*
 640          * All current drivers can scanout linear XRGB8888/ARGB8888 as a primary
 641          * plane and as a cursor. Some drivers don't support
 642          * drmModeGetPlaneResources, so add the combination here. Note that the
 643          * kernel disregards the alpha component of ARGB unless it's an overlay
 644          * plane.
 645          */
 646         drv_modify_combination(drv, DRM_FORMAT_XRGB8888, &LINEAR_METADATA,
 647                                BO_USE_CURSOR | BO_USE_SCANOUT);
 648         drv_modify_combination(drv, DRM_FORMAT_ARGB8888, &LINEAR_METADATA,
 649                                BO_USE_CURSOR | BO_USE_SCANOUT);
 650
 651         kms_items = drv_query_kms(drv);
 652         if (!kms_items)
 653                 return 0;
 654
 655         for (i = 0; i < drv_array_size(kms_items); i++) {
 656                 item = (struct kms_item *)drv_array_at_idx(kms_items, i);
 657                 for (j = 0; j < drv_array_size(drv->combos); j++) {
 658                         combo = drv_array_at_idx(drv->combos, j);
 659                         if (item->format == combo->format)
 660                                 combo->use_flags |= BO_USE_SCANOUT;
 661                 }
 662         }
 663
 664         drv_array_destroy(kms_items);
 665         return 0;
 666 }
 667
 668 /*
 669  * Pick the best modifier from modifiers, according to the ordering
 670  * given by modifier_order.
 671  */
 672 uint64_t drv_pick_modifier(const uint64_t *modifiers, uint32_t count,
 673                            const uint64_t *modifier_order, uint32_t order_count)
 674 {
 675         uint32_t i, j;
 676
 677         for (i = 0; i < order_count; i++) {
 678                 for (j = 0; j < count; j++) {
 679                         if (modifiers[j] == modifier_order[i]) {
 680                                 return modifiers[j];
 681                         }
 682                 }
 683         }
 684
 685         return DRM_FORMAT_MOD_LINEAR;
 686 }