gbm/dri: Expose visuals table through gbm_dri_device
[mesa.git] / src / gbm / main / gbm.c
index afcca63da3ac1242710b37233061e683fa2144bc..0bf2922bacdd408035049111cf30a464d3dfc010 100644 (file)
@@ -85,6 +85,20 @@ gbm_device_is_format_supported(struct gbm_device *gbm,
    return gbm->is_format_supported(gbm, format, usage);
 }
 
+/** Get the number of planes that are required for a given format+modifier
+ *
+ * \param gbm The gbm device returned from gbm_create_device()
+ * \param format The format to query
+ * \param modifier The modifier to query
+ */
+GBM_EXPORT int
+gbm_device_get_format_modifier_plane_count(struct gbm_device *gbm,
+                                           uint32_t format,
+                                           uint64_t modifier)
+{
+   return gbm->get_format_modifier_plane_count(gbm, format, modifier);
+}
+
 /** Destroy the gbm device and free all resources associated with it.
  *
  * \param gbm The device created using gbm_create_device()
@@ -186,7 +200,7 @@ gbm_bo_get_stride_for_plane(struct gbm_bo *bo, int plane)
  * The format of the pixels in the buffer.
  *
  * \param bo The buffer object
- * \return The format of buffer object, on of the GBM_FORMAT_* codes
+ * \return The format of buffer object, one of the GBM_FORMAT_* codes
  */
 GBM_EXPORT uint32_t
 gbm_bo_get_format(struct gbm_bo *bo)
@@ -194,6 +208,72 @@ gbm_bo_get_format(struct gbm_bo *bo)
    return bo->format;
 }
 
+/** Get the bit-per-pixel of the buffer object's format
+ *
+ * The bits-per-pixel of the buffer object's format.
+ *
+ * Note; The 'in-memory pixel' concept makes no sense for YUV formats
+ * (pixels are the result of the combination of multiple memory sources:
+ * Y, Cb & Cr; usually these are even in separate buffers), so YUV
+ * formats are not supported by this function.
+ *
+ * \param bo The buffer object
+ * \return The number of bits0per-pixel of the buffer object's format.
+ */
+GBM_EXPORT uint32_t
+gbm_bo_get_bpp(struct gbm_bo *bo)
+{
+   switch (bo->format) {
+      default:
+         return 0;
+      case GBM_FORMAT_C8:
+      case GBM_FORMAT_R8:
+      case GBM_FORMAT_RGB332:
+      case GBM_FORMAT_BGR233:
+         return 8;
+      case GBM_FORMAT_GR88:
+      case GBM_FORMAT_XRGB4444:
+      case GBM_FORMAT_XBGR4444:
+      case GBM_FORMAT_RGBX4444:
+      case GBM_FORMAT_BGRX4444:
+      case GBM_FORMAT_ARGB4444:
+      case GBM_FORMAT_ABGR4444:
+      case GBM_FORMAT_RGBA4444:
+      case GBM_FORMAT_BGRA4444:
+      case GBM_FORMAT_XRGB1555:
+      case GBM_FORMAT_XBGR1555:
+      case GBM_FORMAT_RGBX5551:
+      case GBM_FORMAT_BGRX5551:
+      case GBM_FORMAT_ARGB1555:
+      case GBM_FORMAT_ABGR1555:
+      case GBM_FORMAT_RGBA5551:
+      case GBM_FORMAT_BGRA5551:
+      case GBM_FORMAT_RGB565:
+      case GBM_FORMAT_BGR565:
+         return 16;
+      case GBM_FORMAT_RGB888:
+      case GBM_FORMAT_BGR888:
+         return 24;
+      case GBM_FORMAT_XRGB8888:
+      case GBM_FORMAT_XBGR8888:
+      case GBM_FORMAT_RGBX8888:
+      case GBM_FORMAT_BGRX8888:
+      case GBM_FORMAT_ARGB8888:
+      case GBM_FORMAT_ABGR8888:
+      case GBM_FORMAT_RGBA8888:
+      case GBM_FORMAT_BGRA8888:
+      case GBM_FORMAT_XRGB2101010:
+      case GBM_FORMAT_XBGR2101010:
+      case GBM_FORMAT_RGBX1010102:
+      case GBM_FORMAT_BGRX1010102:
+      case GBM_FORMAT_ARGB2101010:
+      case GBM_FORMAT_ABGR2101010:
+      case GBM_FORMAT_RGBA1010102:
+      case GBM_FORMAT_BGRA1010102:
+         return 32;
+   }
+}
+
 /** Get the offset for the data of the specified plane
  *
  * Extra planes, and even the first plane, may have an offset from the start of
@@ -203,7 +283,7 @@ gbm_bo_get_format(struct gbm_bo *bo)
  * \param bo The buffer object
  * \return The offset
  */
-GBM_EXPORT int64_t
+GBM_EXPORT uint32_t
 gbm_bo_get_offset(struct gbm_bo *bo, int plane)
 {
    return bo->gbm->bo_get_offset(bo, plane);
@@ -280,6 +360,25 @@ gbm_bo_get_handle_for_plane(struct gbm_bo *bo, int plane)
    return bo->gbm->bo_get_handle(bo, plane);
 }
 
+/**
+ * Get the chosen modifier for the buffer object
+ *
+ * This function returns the modifier that was chosen for the object. These
+ * properties may be generic, or platform/implementation dependent.
+ *
+ * \param bo The buffer object
+ * \return Returns the selected modifier (chosen by the implementation) for the
+ * BO.
+ * \sa gbm_bo_create_with_modifiers() where possible modifiers are set
+ * \sa gbm_surface_create_with_modifiers() where possible modifiers are set
+ * \sa define DRM_FORMAT_MOD_* in drm_fourcc.h for possible modifiers
+ */
+GBM_EXPORT uint64_t
+gbm_bo_get_modifier(struct gbm_bo *bo)
+{
+   return bo->gbm->bo_get_modifier(bo);
+}
+
 /** Write data into the buffer object
  *
  * If the buffer object was created with the GBM_BO_USE_WRITE flag,
@@ -369,9 +468,28 @@ gbm_bo_create(struct gbm_device *gbm,
       return NULL;
    }
 
-   return gbm->bo_create(gbm, width, height, format, usage);
+   return gbm->bo_create(gbm, width, height, format, usage, NULL, 0);
 }
 
+GBM_EXPORT struct gbm_bo *
+gbm_bo_create_with_modifiers(struct gbm_device *gbm,
+                             uint32_t width, uint32_t height,
+                             uint32_t format,
+                             const uint64_t *modifiers,
+                             const unsigned int count)
+{
+   if (width == 0 || height == 0) {
+      errno = EINVAL;
+      return NULL;
+   }
+
+   if ((count && !modifiers) || (modifiers && !count)) {
+      errno = EINVAL;
+      return NULL;
+   }
+
+   return gbm->bo_create(gbm, width, height, format, 0, modifiers, count);
+}
 /**
  * Create a gbm buffer object from an foreign object
  *
@@ -388,8 +506,8 @@ gbm_bo_create(struct gbm_device *gbm,
  * independent of the foreign object.
  *
  * \param gbm The gbm device returned from gbm_create_device()
- * \param gbm The type of object we're importing
- * \param gbm Pointer to the external object
+ * \param type The type of object we're importing
+ * \param buffer Pointer to the external object
  * \param usage The union of the usage flags for this buffer
  *
  * \return A newly allocated buffer object that should be freed with
@@ -477,7 +595,23 @@ gbm_surface_create(struct gbm_device *gbm,
                    uint32_t width, uint32_t height,
                   uint32_t format, uint32_t flags)
 {
-   return gbm->surface_create(gbm, width, height, format, flags);
+   return gbm->surface_create(gbm, width, height, format, flags, NULL, 0);
+}
+
+GBM_EXPORT struct gbm_surface *
+gbm_surface_create_with_modifiers(struct gbm_device *gbm,
+                                  uint32_t width, uint32_t height,
+                                  uint32_t format,
+                                  const uint64_t *modifiers,
+                                  const unsigned int count)
+{
+   if ((count && !modifiers) || (modifiers && !count)) {
+      errno = EINVAL;
+      return NULL;
+   }
+
+   return gbm->surface_create(gbm, width, height, format, 0,
+                              modifiers, count);
 }
 
 /**