2 * Copyright 2016 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.
14 #include <drm_fourcc.h>
17 #define DRV_MAX_PLANES 4
22 #define BO_USE_SCANOUT (1ull << 0)
23 #define BO_USE_CURSOR (1ull << 1)
24 #define BO_USE_CURSOR_64X64 BO_USE_CURSOR
25 #define BO_USE_RENDERING (1ull << 2)
26 #define BO_USE_LINEAR (1ull << 3)
27 #define BO_USE_SW_READ_NEVER (1ull << 4)
28 #define BO_USE_SW_READ_RARELY (1ull << 5)
29 #define BO_USE_SW_READ_OFTEN (1ull << 6)
30 #define BO_USE_SW_WRITE_NEVER (1ull << 7)
31 #define BO_USE_SW_WRITE_RARELY (1ull << 8)
32 #define BO_USE_SW_WRITE_OFTEN (1ull << 9)
33 #define BO_USE_EXTERNAL_DISP (1ull << 10)
34 #define BO_USE_PROTECTED (1ull << 11)
35 #define BO_USE_HW_VIDEO_ENCODER (1ull << 12)
36 #define BO_USE_CAMERA_WRITE (1ull << 13)
37 #define BO_USE_CAMERA_READ (1ull << 14)
38 #define BO_USE_RENDERSCRIPT (1ull << 16)
39 #define BO_USE_TEXTURE (1ull << 17)
40 #define BO_USE_HW_VIDEO_DECODER (1ull << 18)
41 #define BO_USE_FRAMEBUFFER (1ull << 19)
46 #define BO_MAP_READ (1 << 0)
47 #define BO_MAP_WRITE (1 << 1)
48 #define BO_MAP_READ_WRITE (BO_MAP_READ | BO_MAP_WRITE)
50 /* This is our extension to <drm_fourcc.h>. We need to make sure we don't step
51 * on the namespace of already defined formats, which can be done by using invalid
55 #define DRM_FORMAT_NONE fourcc_code('0', '0', '0', '0')
56 #define DRM_FORMAT_YVU420_ANDROID fourcc_code('9', '9', '9', '7')
57 #define DRM_FORMAT_FLEX_IMPLEMENTATION_DEFINED fourcc_code('9', '9', '9', '8')
58 #define DRM_FORMAT_FLEX_YCbCr_420_888 fourcc_code('9', '9', '9', '9')
73 struct drv_import_fd_data {
74 int fds[DRV_MAX_PLANES];
75 uint32_t strides[DRV_MAX_PLANES];
76 uint32_t offsets[DRV_MAX_PLANES];
77 uint64_t format_modifiers[DRV_MAX_PLANES];
90 uint32_t map_strides[DRV_MAX_PLANES];
103 struct rectangle rect;
107 struct driver *drv_create(int fd);
109 void drv_destroy(struct driver *drv);
111 int drv_get_fd(struct driver *drv);
113 const char *drv_get_name(struct driver *drv);
115 struct combination *drv_get_combination(struct driver *drv, uint32_t format, uint64_t use_flags);
117 struct bo *drv_bo_new(struct driver *drv, uint32_t width, uint32_t height, uint32_t format,
120 struct bo *drv_bo_create(struct driver *drv, uint32_t width, uint32_t height, uint32_t format,
123 struct bo *drv_bo_create_with_modifiers(struct driver *drv, uint32_t width, uint32_t height,
124 uint32_t format, const uint64_t *modifiers, uint32_t count);
126 void drv_bo_destroy(struct bo *bo);
128 struct bo *drv_bo_import(struct driver *drv, struct drv_import_fd_data *data);
130 void *drv_bo_map(struct bo *bo, const struct rectangle *rect, uint32_t map_flags,
131 struct mapping **map_data, size_t plane);
133 int drv_bo_unmap(struct bo *bo, struct mapping *mapping);
135 int drv_bo_invalidate(struct bo *bo, struct mapping *mapping);
137 int drv_bo_flush_or_unmap(struct bo *bo, struct mapping *mapping);
139 uint32_t drv_bo_get_width(struct bo *bo);
141 uint32_t drv_bo_get_height(struct bo *bo);
143 uint32_t drv_bo_get_stride_or_tiling(struct bo *bo);
145 size_t drv_bo_get_num_planes(struct bo *bo);
147 union bo_handle drv_bo_get_plane_handle(struct bo *bo, size_t plane);
149 int drv_bo_get_plane_fd(struct bo *bo, size_t plane);
151 uint32_t drv_bo_get_plane_offset(struct bo *bo, size_t plane);
153 uint32_t drv_bo_get_plane_size(struct bo *bo, size_t plane);
155 uint32_t drv_bo_get_plane_stride(struct bo *bo, size_t plane);
157 uint64_t drv_bo_get_plane_format_modifier(struct bo *bo, size_t plane);
159 uint32_t drv_bo_get_format(struct bo *bo);
161 uint32_t drv_bytes_per_pixel_from_format(uint32_t format, size_t plane);
163 uint32_t drv_stride_from_format(uint32_t format, uint32_t width, size_t plane);
165 uint32_t drv_resolve_format(struct driver *drv, uint32_t format, uint64_t use_flags);
167 size_t drv_num_planes_from_format(uint32_t format);
169 uint32_t drv_num_buffers_per_bo(struct bo *bo);
171 #define drv_log(format, ...) \
173 drv_log_prefix("minigbm", __FILE__, __LINE__, format, ##__VA_ARGS__); \
176 __attribute__((format(printf, 4, 5))) void drv_log_prefix(const char *prefix, const char *file,
177 int line, const char *format, ...);