a1892b2800
We use the terms "flags" and "usage" interchangeably in this repo,
since they essentally mean the same thing. However, let's be a
little more consistent since it's kind of confusing, especially
when buffer map flags come to play. Let's:
- refer to everything in the drv_* layer as use_flags
- refer to everything in the gbm/gralloc layers as
usages
BUG=chromium:764871
TEST=emerge-eve {arc-cros-gralloc, minigbm}
Change-Id: If987d72369b895f38cde87e50ce1080f78f2a084
Reviewed-on: https://chromium-review.googlesource.com/691423
Commit-Ready: Gurchetan Singh <gurchetansingh@chromium.org>
Tested-by: Gurchetan Singh <gurchetansingh@chromium.org>
Reviewed-by: Stéphane Marchesin <marcheu@chromium.org>
153 lines
4.1 KiB
C
153 lines
4.1 KiB
C
/*
|
|
* Copyright 2016 The Chromium OS Authors. All rights reserved.
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
* found in the LICENSE file.
|
|
*/
|
|
|
|
#ifndef DRV_H_
|
|
#define DRV_H_
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <drm_fourcc.h>
|
|
#include <stdint.h>
|
|
|
|
#define DRV_MAX_PLANES 4
|
|
|
|
// clang-format off
|
|
/* Use flags */
|
|
#define BO_USE_NONE 0
|
|
#define BO_USE_SCANOUT (1ull << 0)
|
|
#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)
|
|
#define BO_USE_RENDERSCRIPT (1ull << 16)
|
|
#define BO_USE_TEXTURE (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)
|
|
|
|
/* 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')
|
|
|
|
// clang-format on
|
|
struct driver;
|
|
struct bo;
|
|
struct combination;
|
|
|
|
union bo_handle {
|
|
void *ptr;
|
|
int32_t s32;
|
|
uint32_t u32;
|
|
int64_t s64;
|
|
uint64_t u64;
|
|
};
|
|
|
|
struct drv_import_fd_data {
|
|
int fds[DRV_MAX_PLANES];
|
|
uint32_t strides[DRV_MAX_PLANES];
|
|
uint32_t offsets[DRV_MAX_PLANES];
|
|
uint64_t format_modifiers[DRV_MAX_PLANES];
|
|
uint32_t width;
|
|
uint32_t height;
|
|
uint32_t format;
|
|
uint64_t use_flags;
|
|
};
|
|
|
|
struct map_info {
|
|
void *addr;
|
|
size_t length;
|
|
uint32_t handle;
|
|
int32_t refcount;
|
|
void *priv;
|
|
};
|
|
|
|
struct driver *drv_create(int fd);
|
|
|
|
void drv_destroy(struct driver *drv);
|
|
|
|
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 use_flags);
|
|
|
|
struct bo *drv_bo_new(struct driver *drv, uint32_t width, uint32_t height, uint32_t format,
|
|
uint64_t use_flags);
|
|
|
|
struct bo *drv_bo_create(struct driver *drv, uint32_t width, uint32_t height, uint32_t format,
|
|
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);
|
|
|
|
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);
|
|
|
|
int drv_bo_unmap(struct bo *bo, struct map_info *data);
|
|
|
|
int drv_bo_flush(struct bo *bo, struct map_info *data);
|
|
|
|
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);
|
|
|
|
int drv_bo_get_plane_fd(struct bo *bo, size_t plane);
|
|
|
|
uint32_t drv_bo_get_plane_offset(struct bo *bo, size_t plane);
|
|
|
|
uint32_t drv_bo_get_plane_size(struct bo *bo, size_t plane);
|
|
|
|
uint32_t drv_bo_get_plane_stride(struct bo *bo, size_t plane);
|
|
|
|
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_resolve_format(struct driver *drv, uint32_t format, uint64_t use_flags);
|
|
|
|
size_t drv_num_planes_from_format(uint32_t format);
|
|
|
|
uint32_t drv_num_buffers_per_bo(struct bo *bo);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|