OSDN Git Service

Distinguish COMPOSER_TARGET_BUFFER
[android-x86/external-minigbm.git] / drv.h
diff --git a/drv.h b/drv.h
index 8c132d3..47940b5 100644 (file)
--- a/drv.h
+++ b/drv.h
@@ -12,6 +12,7 @@ extern "C" {
 #endif
 
 #include <drm_fourcc.h>
+#include <stdbool.h>
 #include <stdint.h>
 
 #define DRV_MAX_PLANES 4
@@ -23,37 +24,51 @@ extern "C" {
 #define BO_USE_CURSOR                  (1ull << 1)
 #define BO_USE_CURSOR_64X64            BO_USE_CURSOR
 #define BO_USE_RENDERING               (1ull << 2)
-#define BO_USE_LINEAR                  (1ull << 3)
-#define BO_USE_SW_READ_NEVER           (1ull << 4)
-#define BO_USE_SW_READ_RARELY          (1ull << 5)
-#define BO_USE_SW_READ_OFTEN           (1ull << 6)
-#define BO_USE_SW_WRITE_NEVER          (1ull << 7)
-#define BO_USE_SW_WRITE_RARELY         (1ull << 8)
-#define BO_USE_SW_WRITE_OFTEN          (1ull << 9)
-#define BO_USE_EXTERNAL_DISP           (1ull << 10)
-#define BO_USE_PROTECTED               (1ull << 11)
-#define BO_USE_HW_VIDEO_ENCODER                (1ull << 12)
-#define BO_USE_CAMERA_WRITE            (1ull << 13)
-#define BO_USE_CAMERA_READ             (1ull << 14)
+/* Skip for GBM_BO_USE_WRITE */
+#define BO_USE_LINEAR                  (1ull << 4)
+#define BO_USE_TEXTURE                 (1ull << 5)
+#define BO_USE_CAMERA_WRITE            (1ull << 6)
+#define BO_USE_CAMERA_READ             (1ull << 7)
+#define BO_USE_PROTECTED               (1ull << 8)
+#define BO_USE_SW_READ_OFTEN           (1ull << 9)
+#define BO_USE_SW_READ_RARELY          (1ull << 10)
+#define BO_USE_SW_WRITE_OFTEN          (1ull << 11)
+#define BO_USE_SW_WRITE_RARELY         (1ull << 12)
+#define BO_USE_HW_VIDEO_DECODER         (1ull << 13)
+#define BO_USE_HW_VIDEO_ENCODER         (1ull << 14)
+#define BO_USE_TEST_ALLOC              (1ull << 15)
 #define BO_USE_RENDERSCRIPT            (1ull << 16)
-#define BO_USE_TEXTURE                 (1ull << 17)
+#define BO_USE_COMPOSER_TARGET         (1ull << 17)
 
-/* Read-Write permissions for drv_bo_map() flags */
-#define BO_TRANSFER_NONE 0
-#define BO_TRANSFER_READ (1 << 0)
-#define BO_TRANSFER_WRITE (1 << 1)
-#define BO_TRANSFER_READ_WRITE (BO_TRANSFER_READ | BO_TRANSFER_WRITE)
+/* Quirks for allocating a buffer. */
+#define BO_QUIRK_NONE                  0
+#define BO_QUIRK_DUMB32BPP             (1ull << 0)
+
+/* Map flags */
+#define BO_MAP_NONE 0
+#define BO_MAP_READ (1 << 0)
+#define BO_MAP_WRITE (1 << 1)
+#define BO_MAP_READ_WRITE (BO_MAP_READ | BO_MAP_WRITE)
 
 /* This is our extension to <drm_fourcc.h>.  We need to make sure we don't step
  * on the namespace of already defined formats, which can be done by using invalid
  * fourcc codes.
  */
-
 #define DRM_FORMAT_NONE                                fourcc_code('0', '0', '0', '0')
 #define DRM_FORMAT_YVU420_ANDROID              fourcc_code('9', '9', '9', '7')
 #define DRM_FORMAT_FLEX_IMPLEMENTATION_DEFINED fourcc_code('9', '9', '9', '8')
 #define DRM_FORMAT_FLEX_YCbCr_420_888          fourcc_code('9', '9', '9', '9')
 
+/* This is a 10-bit bayer format for private reprocessing on MediaTek ISP. It's
+ * a private RAW format that other DRM drivers will never support and thus
+ * making it not upstreamable (i.e., defined in official DRM headers). */
+#define DRM_FORMAT_MTISP_SXYZW10               fourcc_code('M', 'B', '1', '0')
+
+// TODO(crbug.com/958181): remove this definition once drm_fourcc.h contains it.
+#ifndef DRM_FORMAT_P010
+#define DRM_FORMAT_P010 fourcc_code('P', '0', '1', '0')
+#endif
+
 // clang-format on
 struct driver;
 struct bo;
@@ -75,18 +90,34 @@ struct drv_import_fd_data {
        uint32_t width;
        uint32_t height;
        uint32_t format;
-       uint64_t flags;
+       uint32_t tiling;
+       uint64_t use_flags;
 };
 
-struct map_info {
+struct vma {
        void *addr;
        size_t length;
        uint32_t handle;
+       uint32_t map_flags;
        int32_t refcount;
+       uint32_t map_strides[DRV_MAX_PLANES];
        void *priv;
 };
 
-struct driver *drv_create(int fd);
+struct rectangle {
+       uint32_t x;
+       uint32_t y;
+       uint32_t width;
+       uint32_t height;
+};
+
+struct mapping {
+       struct vma *vma;
+       struct rectangle rect;
+       uint32_t refcount;
+};
+
+struct driver *drv_create(int fd, bool try_generic);
 
 void drv_destroy(struct driver *drv);
 
@@ -94,13 +125,13 @@ int drv_get_fd(struct driver *drv);
 
 const char *drv_get_name(struct driver *drv);
 
-struct combination *drv_get_combination(struct driver *drv, uint32_t format, uint64_t usage);
+struct combination *drv_get_combination(struct driver *drv, uint32_t format, uint64_t use_flags);
 
 struct bo *drv_bo_new(struct driver *drv, uint32_t width, uint32_t height, uint32_t format,
-                     uint64_t flags);
+                     uint64_t use_flags, bool is_test_buffer);
 
 struct bo *drv_bo_create(struct driver *drv, uint32_t width, uint32_t height, uint32_t format,
-                        uint64_t flags);
+                        uint64_t use_flags);
 
 struct bo *drv_bo_create_with_modifiers(struct driver *drv, uint32_t width, uint32_t height,
                                        uint32_t format, const uint64_t *modifiers, uint32_t count);
@@ -109,19 +140,21 @@ void drv_bo_destroy(struct bo *bo);
 
 struct bo *drv_bo_import(struct driver *drv, struct drv_import_fd_data *data);
 
-void *drv_bo_map(struct bo *bo, uint32_t x, uint32_t y, uint32_t width, uint32_t height,
-                uint32_t flags, struct map_info **map_data, size_t plane);
+void *drv_bo_map(struct bo *bo, const struct rectangle *rect, uint32_t map_flags,
+                struct mapping **map_data, size_t plane);
+
+int drv_bo_unmap(struct bo *bo, struct mapping *mapping);
+
+int drv_bo_invalidate(struct bo *bo, struct mapping *mapping);
 
-int drv_bo_unmap(struct bo *bo, struct map_info *data);
+int drv_bo_flush(struct bo *bo, struct mapping *mapping);
 
-int drv_bo_flush(struct bo *bo, struct map_info *data);
+int drv_bo_flush_or_unmap(struct bo *bo, struct mapping *mapping);
 
 uint32_t drv_bo_get_width(struct bo *bo);
 
 uint32_t drv_bo_get_height(struct bo *bo);
 
-uint32_t drv_bo_get_stride_or_tiling(struct bo *bo);
-
 size_t drv_bo_get_num_planes(struct bo *bo);
 
 union bo_handle drv_bo_get_plane_handle(struct bo *bo, size_t plane);
@@ -138,14 +171,29 @@ uint64_t drv_bo_get_plane_format_modifier(struct bo *bo, size_t plane);
 
 uint32_t drv_bo_get_format(struct bo *bo);
 
-uint32_t drv_bo_get_stride_in_pixels(struct bo *bo);
+uint32_t drv_bytes_per_pixel_from_format(uint32_t format, size_t plane);
+
+uint32_t drv_stride_from_format(uint32_t format, uint32_t width, size_t plane);
 
-uint32_t drv_resolve_format(struct driver *drv, uint32_t format, uint64_t usage);
+uint32_t drv_resolve_format(struct driver *drv, uint32_t format, uint64_t use_flags);
 
 size_t drv_num_planes_from_format(uint32_t format);
 
+size_t drv_num_planes_from_modifier(struct driver *drv, uint32_t format, uint64_t modifier);
+
 uint32_t drv_num_buffers_per_bo(struct bo *bo);
 
+int drv_resource_info(struct bo *bo, uint32_t strides[DRV_MAX_PLANES],
+                     uint32_t offsets[DRV_MAX_PLANES]);
+
+#define drv_log(format, ...)                                                                       \
+       do {                                                                                       \
+               drv_log_prefix("minigbm", __FILE__, __LINE__, format, ##__VA_ARGS__);              \
+       } while (0)
+
+__attribute__((format(printf, 4, 5))) void drv_log_prefix(const char *prefix, const char *file,
+                                                         int line, const char *format, ...);
+
 #ifdef __cplusplus
 }
 #endif