gbm.c - platform/external/minigbm - Gitiles

 /*
  * Copyright 2014 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.
  */

 #include <assert.h>
 #include <fcntl.h>
 #include <stdint.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
 #include <sys/mman.h>
 #include <xf86drm.h>

 #include "drv.h"
 #include "gbm_helpers.h"
 #include "gbm_priv.h"
 #include "util.h"

 PUBLIC int gbm_device_get_fd(struct gbm_device *gbm)
 {

 	return drv_get_fd(gbm->drv);
 }

 PUBLIC const char *gbm_device_get_backend_name(struct gbm_device *gbm)
 {
 	return drv_get_name(gbm->drv);
 }

 PUBLIC int gbm_device_is_format_supported(struct gbm_device *gbm, uint32_t format, uint32_t usage)
 {
 	uint64_t use_flags;

 	if (usage & GBM_BO_USE_CURSOR && usage & GBM_BO_USE_RENDERING)
 		return 0;

 	use_flags = gbm_convert_usage(usage);

 	return (drv_get_combination(gbm->drv, format, use_flags) != NULL);
 }

 PUBLIC int gbm_device_get_format_modifier_plane_count(struct gbm_device *gbm, uint32_t format,
 						      uint64_t modifier)
 {
 	return 0;
 }

 PUBLIC struct gbm_device *gbm_create_device(int fd)
 {
 	struct gbm_device *gbm;

 	gbm = (struct gbm_device *)malloc(sizeof(*gbm));

 	if (!gbm)
 		return NULL;

 	gbm->drv = drv_create(fd);
 	if (!gbm->drv) {
 		free(gbm);
 		return NULL;
 	}

 	return gbm;
 }

 PUBLIC void gbm_device_destroy(struct gbm_device *gbm)
 {
 	drv_destroy(gbm->drv);
 	free(gbm);
 }

 PUBLIC struct gbm_surface *gbm_surface_create(struct gbm_device *gbm, uint32_t width,
 					      uint32_t height, uint32_t format, uint32_t usage)
 {
 	struct gbm_surface *surface = (struct gbm_surface *)malloc(sizeof(*surface));

 	if (!surface)
 		return NULL;

 	return surface;
 }

 PUBLIC 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 != 0 || modifiers != NULL)
 		return NULL;

 	return gbm_surface_create(gbm, width, height, format, 0);
 }

 PUBLIC struct gbm_bo *gbm_surface_lock_front_buffer(struct gbm_surface *surface)
 {
 	return NULL;
 }

 PUBLIC void gbm_surface_release_buffer(struct gbm_surface *surface, struct gbm_bo *bo)
 {
 }

 PUBLIC int gbm_surface_has_free_buffers(struct gbm_surface *surface)
 {
 	return 0;
 }

 PUBLIC void gbm_surface_destroy(struct gbm_surface *surface)
 {
 	free(surface);
 }

 static struct gbm_bo *gbm_bo_new(struct gbm_device *gbm, uint32_t format)
 {
 	struct gbm_bo *bo;

 	bo = (struct gbm_bo *)calloc(1, sizeof(*bo));
 	if (!bo)
 		return NULL;

 	bo->gbm = gbm;
 	bo->gbm_format = format;

 	return bo;
 }

 PUBLIC struct gbm_bo *gbm_bo_create(struct gbm_device *gbm, uint32_t width, uint32_t height,
 				    uint32_t format, uint32_t usage)
 {
 	struct gbm_bo *bo;

 	if (!gbm_device_is_format_supported(gbm, format, usage))
 		return NULL;

 	bo = gbm_bo_new(gbm, format);

 	if (!bo)
 		return NULL;

 	/*
 	 * HACK: This is for HAL_PIXEL_FORMAT_YV12 buffers allocated by arcvm. None of
 	 * our platforms can display YV12, so we can treat as a SW buffer. Remove once
 	 * this can be intelligently resolved in the guest. Also see compute_virgl_bind_flags.
 	 */
 	if (format == GBM_FORMAT_YVU420 && (usage & GBM_BO_USE_LINEAR))
 		format = DRM_FORMAT_YVU420_ANDROID;

 	bo->bo = drv_bo_create(gbm->drv, width, height, format, gbm_convert_usage(usage));

 	if (!bo->bo) {
 		free(bo);
 		return NULL;
 	}

 	return bo;
 }

 PUBLIC 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, uint32_t count)
 {
 	struct gbm_bo *bo;

 	bo = gbm_bo_new(gbm, format);

 	if (!bo)
 		return NULL;

 	bo->bo = drv_bo_create_with_modifiers(gbm->drv, width, height, format, modifiers, count);

 	if (!bo->bo) {
 		free(bo);
 		return NULL;
 	}

 	return bo;
 }

 PUBLIC void gbm_bo_destroy(struct gbm_bo *bo)
 {
 	if (bo->destroy_user_data) {
 		bo->destroy_user_data(bo, bo->user_data);
 		bo->destroy_user_data = NULL;
 		bo->user_data = NULL;
 	}

 	drv_bo_destroy(bo->bo);
 	free(bo);
 }

 PUBLIC struct gbm_bo *gbm_bo_import(struct gbm_device *gbm, uint32_t type, void *buffer,
 				    uint32_t usage)
 {
 	struct gbm_bo *bo;
 	struct drv_import_fd_data drv_data = { 0 };
 	struct gbm_import_fd_data *fd_data = buffer;
 	struct gbm_import_fd_modifier_data *fd_modifier_data = buffer;
 	uint32_t gbm_format;
 	size_t num_planes, i, num_fds;

 	drv_data.use_flags = gbm_convert_usage(usage);
 	switch (type) {
 	case GBM_BO_IMPORT_FD:
 		gbm_format = fd_data->format;
 		drv_data.width = fd_data->width;
 		drv_data.height = fd_data->height;
 		drv_data.format = fd_data->format;
 		drv_data.fds[0] = fd_data->fd;
 		drv_data.strides[0] = fd_data->stride;

 		for (i = 0; i < GBM_MAX_PLANES; ++i)
 			drv_data.format_modifiers[i] = DRM_FORMAT_MOD_INVALID;
 		break;
 	case GBM_BO_IMPORT_FD_MODIFIER:
 		gbm_format = fd_modifier_data->format;
 		drv_data.width = fd_modifier_data->width;
 		drv_data.height = fd_modifier_data->height;
 		drv_data.format = fd_modifier_data->format;
 		num_planes = drv_num_planes_from_modifier(gbm->drv, drv_data.format,
 							  fd_modifier_data->modifier);
 		assert(num_planes);

 		num_fds = fd_modifier_data->num_fds;
 		if (!num_fds || num_fds > num_planes)
 			return NULL;

 		for (i = 0; i < num_planes; i++) {
 			if (num_fds != num_planes)
 				drv_data.fds[i] = fd_modifier_data->fds[0];
 			else
 				drv_data.fds[i] = fd_modifier_data->fds[i];
 			drv_data.offsets[i] = fd_modifier_data->offsets[i];
 			drv_data.strides[i] = fd_modifier_data->strides[i];
 			drv_data.format_modifiers[i] = fd_modifier_data->modifier;
 		}

 		for (i = num_planes; i < GBM_MAX_PLANES; i++)
 			drv_data.fds[i] = -1;

 		break;
 	default:
 		return NULL;
 	}

 	if (!gbm_device_is_format_supported(gbm, gbm_format, usage))
 		return NULL;

 	bo = gbm_bo_new(gbm, gbm_format);

 	if (!bo)
 		return NULL;

 	bo->bo = drv_bo_import(gbm->drv, &drv_data);

 	if (!bo->bo) {
 		free(bo);
 		return NULL;
 	}

 	return bo;
 }

 PUBLIC void *gbm_bo_map(struct gbm_bo *bo, uint32_t x, uint32_t y, uint32_t width, uint32_t height,
 			uint32_t transfer_flags, uint32_t *stride, void **map_data)
 {
 	return gbm_bo_map2(bo, x, y, width, height, transfer_flags, stride, map_data, 0);
 }

 PUBLIC void gbm_bo_unmap(struct gbm_bo *bo, void *map_data)
 {
 	assert(bo);
 	drv_bo_flush_or_unmap(bo->bo, map_data);
 }

 PUBLIC uint32_t gbm_bo_get_width(struct gbm_bo *bo)
 {
 	return drv_bo_get_width(bo->bo);
 }

 PUBLIC uint32_t gbm_bo_get_height(struct gbm_bo *bo)
 {
 	return drv_bo_get_height(bo->bo);
 }

 PUBLIC uint32_t gbm_bo_get_stride(struct gbm_bo *bo)
 {
 	return gbm_bo_get_stride_for_plane(bo, 0);
 }

 PUBLIC uint32_t gbm_bo_get_format(struct gbm_bo *bo)
 {
 	return bo->gbm_format;
 }

 PUBLIC uint32_t gbm_bo_get_bpp(struct gbm_bo *bo)
 {
 	return drv_bytes_per_pixel_from_format(drv_bo_get_format(bo->bo), 0);
 }

 PUBLIC uint64_t gbm_bo_get_modifier(struct gbm_bo *bo)
 {
 	return drv_bo_get_plane_format_modifier(bo->bo, 0);
 }

 PUBLIC struct gbm_device *gbm_bo_get_device(struct gbm_bo *bo)
 {
 	return bo->gbm;
 }

 PUBLIC union gbm_bo_handle gbm_bo_get_handle(struct gbm_bo *bo)
 {
 	return gbm_bo_get_handle_for_plane(bo, 0);
 }

 PUBLIC int gbm_bo_get_fd(struct gbm_bo *bo)
 {
 	return gbm_bo_get_plane_fd(bo, 0);
 }

 PUBLIC int gbm_bo_get_plane_count(struct gbm_bo *bo)
 {
 	return drv_bo_get_num_planes(bo->bo);
 }

 PUBLIC union gbm_bo_handle gbm_bo_get_handle_for_plane(struct gbm_bo *bo, size_t plane)
 {
 	return (union gbm_bo_handle)drv_bo_get_plane_handle(bo->bo, (size_t)plane).u64;
 }

 PUBLIC uint32_t gbm_bo_get_offset(struct gbm_bo *bo, size_t plane)
 {
 	return drv_bo_get_plane_offset(bo->bo, (size_t)plane);
 }

 PUBLIC uint32_t gbm_bo_get_stride_for_plane(struct gbm_bo *bo, size_t plane)
 {
 	return drv_bo_get_plane_stride(bo->bo, (size_t)plane);
 }

 PUBLIC void gbm_bo_set_user_data(struct gbm_bo *bo, void *data,
 				 void (*destroy_user_data)(struct gbm_bo *, void *))
 {
 	bo->user_data = data;
 	bo->destroy_user_data = destroy_user_data;
 }

 PUBLIC void *gbm_bo_get_user_data(struct gbm_bo *bo)
 {
 	return bo->user_data;
 }

 /* The two GBM_BO_FORMAT_[XA]RGB8888 formats alias the GBM_FORMAT_*
  * formats of the same name. We want to accept them whenever someone
  * has a GBM format, but never return them to the user.
  */
 static uint32_t gbm_format_canonicalize(uint32_t gbm_format)
 {
 	switch (gbm_format) {
 	case GBM_BO_FORMAT_XRGB8888:
 		return GBM_FORMAT_XRGB8888;
 	case GBM_BO_FORMAT_ARGB8888:
 		return GBM_FORMAT_ARGB8888;
 	default:
 		return gbm_format;
 	}
 }

 /**
  * Returns a string representing the fourcc format name.
  */
 PUBLIC char *gbm_format_get_name(uint32_t gbm_format, struct gbm_format_name_desc *desc)
 {
 	gbm_format = gbm_format_canonicalize(gbm_format);

 	desc->name[0] = gbm_format;
 	desc->name[1] = gbm_format >> 8;
 	desc->name[2] = gbm_format >> 16;
 	desc->name[3] = gbm_format >> 24;
 	desc->name[4] = 0;

 	return desc->name;
 }

 /*
  * The following functions are not deprecated, but not in the Mesa the gbm
  * header. The main difference is minigbm allows for the possibility of
  * disjoint YUV images, while Mesa GBM does not.
  */
 PUBLIC uint32_t gbm_bo_get_plane_size(struct gbm_bo *bo, size_t plane)
 {
 	return drv_bo_get_plane_size(bo->bo, plane);
 }

 PUBLIC int gbm_bo_get_plane_fd(struct gbm_bo *bo, size_t plane)
 {
 	return drv_bo_get_plane_fd(bo->bo, plane);
 }

 PUBLIC void *gbm_bo_map2(struct gbm_bo *bo, uint32_t x, uint32_t y, uint32_t width, uint32_t height,
 			 uint32_t transfer_flags, uint32_t *stride, void **map_data, int plane)
 {
 	void *addr;
 	off_t offset;
 	uint32_t map_flags;
 	plane = (size_t)plane;
 	struct rectangle rect = { .x = x, .y = y, .width = width, .height = height };
 	if (!bo || width == 0 || height == 0 || !stride || !map_data)
 		return NULL;

 	map_flags = (transfer_flags & GBM_BO_TRANSFER_READ) ? BO_MAP_READ : BO_MAP_NONE;
 	map_flags |= (transfer_flags & GBM_BO_TRANSFER_WRITE) ? BO_MAP_WRITE : BO_MAP_NONE;

 	addr = drv_bo_map(bo->bo, &rect, map_flags, (struct mapping **)map_data, plane);
 	if (addr == MAP_FAILED)
 		return MAP_FAILED;

 	*stride = ((struct mapping *)*map_data)->vma->map_strides[plane];

 	offset = *stride * rect.y;
 	offset += rect.x * drv_bytes_per_pixel_from_format(bo->gbm_format, plane);
 	return (void *)((uint8_t *)addr + offset);
 }
	/*
	* Copyright 2014 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.
	*/

	#include <assert.h>
	#include <fcntl.h>
	#include <stdint.h>
	#include <stdio.h>
	#include <stdlib.h>
	#include <string.h>
	#include <sys/mman.h>
	#include <xf86drm.h>

	#include "drv.h"
	#include "gbm_helpers.h"
	#include "gbm_priv.h"
	#include "util.h"

	PUBLIC int gbm_device_get_fd(struct gbm_device *gbm)
	{

	return drv_get_fd(gbm->drv);
	}

	PUBLIC const char gbm_device_get_backend_name(struct gbm_device gbm)
	{
	return drv_get_name(gbm->drv);
	}

	PUBLIC int gbm_device_is_format_supported(struct gbm_device *gbm, uint32_t format, uint32_t usage)
	{
	uint64_t use_flags;

	if (usage & GBM_BO_USE_CURSOR && usage & GBM_BO_USE_RENDERING)
	return 0;

	use_flags = gbm_convert_usage(usage);

	return (drv_get_combination(gbm->drv, format, use_flags) != NULL);
	}

	PUBLIC int gbm_device_get_format_modifier_plane_count(struct gbm_device *gbm, uint32_t format,
	uint64_t modifier)
	{
	return 0;
	}

	PUBLIC struct gbm_device *gbm_create_device(int fd)
	{
	struct gbm_device *gbm;

	gbm = (struct gbm_device )malloc(sizeof(gbm));

	if (!gbm)
	return NULL;

	gbm->drv = drv_create(fd);
	if (!gbm->drv) {
	free(gbm);
	return NULL;
	}

	return gbm;
	}

	PUBLIC void gbm_device_destroy(struct gbm_device *gbm)
	{
	drv_destroy(gbm->drv);
	free(gbm);
	}

	PUBLIC struct gbm_surface gbm_surface_create(struct gbm_device gbm, uint32_t width,
	uint32_t height, uint32_t format, uint32_t usage)
	{
	struct gbm_surface surface = (struct gbm_surface )malloc(sizeof(*surface));

	if (!surface)
	return NULL;

	return surface;
	}

	PUBLIC 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 != 0 \|\| modifiers != NULL)
	return NULL;

	return gbm_surface_create(gbm, width, height, format, 0);
	}

	PUBLIC struct gbm_bo gbm_surface_lock_front_buffer(struct gbm_surface surface)
	{
	return NULL;
	}

	PUBLIC void gbm_surface_release_buffer(struct gbm_surface surface, struct gbm_bo bo)
	{
	}

	PUBLIC int gbm_surface_has_free_buffers(struct gbm_surface *surface)
	{
	return 0;
	}

	PUBLIC void gbm_surface_destroy(struct gbm_surface *surface)
	{
	free(surface);
	}

	static struct gbm_bo gbm_bo_new(struct gbm_device gbm, uint32_t format)
	{
	struct gbm_bo *bo;

	bo = (struct gbm_bo )calloc(1, sizeof(bo));
	if (!bo)
	return NULL;

	bo->gbm = gbm;
	bo->gbm_format = format;

	return bo;
	}

	PUBLIC struct gbm_bo gbm_bo_create(struct gbm_device gbm, uint32_t width, uint32_t height,
	uint32_t format, uint32_t usage)
	{
	struct gbm_bo *bo;

	if (!gbm_device_is_format_supported(gbm, format, usage))
	return NULL;

	bo = gbm_bo_new(gbm, format);

	if (!bo)
	return NULL;

	/*
	* HACK: This is for HAL_PIXEL_FORMAT_YV12 buffers allocated by arcvm. None of
	* our platforms can display YV12, so we can treat as a SW buffer. Remove once
	* this can be intelligently resolved in the guest. Also see compute_virgl_bind_flags.
	*/
	if (format == GBM_FORMAT_YVU420 && (usage & GBM_BO_USE_LINEAR))
	format = DRM_FORMAT_YVU420_ANDROID;

	bo->bo = drv_bo_create(gbm->drv, width, height, format, gbm_convert_usage(usage));

	if (!bo->bo) {
	free(bo);
	return NULL;
	}

	return bo;
	}

	PUBLIC 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, uint32_t count)
	{
	struct gbm_bo *bo;

	bo = gbm_bo_new(gbm, format);

	if (!bo)
	return NULL;

	bo->bo = drv_bo_create_with_modifiers(gbm->drv, width, height, format, modifiers, count);

	if (!bo->bo) {
	free(bo);
	return NULL;
	}

	return bo;
	}

	PUBLIC void gbm_bo_destroy(struct gbm_bo *bo)
	{
	if (bo->destroy_user_data) {
	bo->destroy_user_data(bo, bo->user_data);
	bo->destroy_user_data = NULL;
	bo->user_data = NULL;
	}

	drv_bo_destroy(bo->bo);
	free(bo);
	}

	PUBLIC struct gbm_bo gbm_bo_import(struct gbm_device gbm, uint32_t type, void *buffer,
	uint32_t usage)
	{
	struct gbm_bo *bo;
	struct drv_import_fd_data drv_data = { 0 };
	struct gbm_import_fd_data *fd_data = buffer;
	struct gbm_import_fd_modifier_data *fd_modifier_data = buffer;
	uint32_t gbm_format;
	size_t num_planes, i, num_fds;

	drv_data.use_flags = gbm_convert_usage(usage);
	switch (type) {
	case GBM_BO_IMPORT_FD:
	gbm_format = fd_data->format;
	drv_data.width = fd_data->width;
	drv_data.height = fd_data->height;
	drv_data.format = fd_data->format;
	drv_data.fds[0] = fd_data->fd;
	drv_data.strides[0] = fd_data->stride;

	for (i = 0; i < GBM_MAX_PLANES; ++i)
	drv_data.format_modifiers[i] = DRM_FORMAT_MOD_INVALID;
	break;
	case GBM_BO_IMPORT_FD_MODIFIER:
	gbm_format = fd_modifier_data->format;
	drv_data.width = fd_modifier_data->width;
	drv_data.height = fd_modifier_data->height;
	drv_data.format = fd_modifier_data->format;
	num_planes = drv_num_planes_from_modifier(gbm->drv, drv_data.format,
	fd_modifier_data->modifier);
	assert(num_planes);

	num_fds = fd_modifier_data->num_fds;
	if (!num_fds \|\| num_fds > num_planes)
	return NULL;

	for (i = 0; i < num_planes; i++) {
	if (num_fds != num_planes)
	drv_data.fds[i] = fd_modifier_data->fds[0];
	else
	drv_data.fds[i] = fd_modifier_data->fds[i];
	drv_data.offsets[i] = fd_modifier_data->offsets[i];
	drv_data.strides[i] = fd_modifier_data->strides[i];
	drv_data.format_modifiers[i] = fd_modifier_data->modifier;
	}

	for (i = num_planes; i < GBM_MAX_PLANES; i++)
	drv_data.fds[i] = -1;

	break;
	default:
	return NULL;
	}

	if (!gbm_device_is_format_supported(gbm, gbm_format, usage))
	return NULL;

	bo = gbm_bo_new(gbm, gbm_format);

	if (!bo)
	return NULL;

	bo->bo = drv_bo_import(gbm->drv, &drv_data);

	if (!bo->bo) {
	free(bo);
	return NULL;
	}

	return bo;
	}

	PUBLIC void gbm_bo_map(struct gbm_bo bo, uint32_t x, uint32_t y, uint32_t width, uint32_t height,
	uint32_t transfer_flags, uint32_t stride, void *map_data)
	{
	return gbm_bo_map2(bo, x, y, width, height, transfer_flags, stride, map_data, 0);
	}

	PUBLIC void gbm_bo_unmap(struct gbm_bo bo, void map_data)
	{
	assert(bo);
	drv_bo_flush_or_unmap(bo->bo, map_data);
	}

	PUBLIC uint32_t gbm_bo_get_width(struct gbm_bo *bo)
	{
	return drv_bo_get_width(bo->bo);
	}

	PUBLIC uint32_t gbm_bo_get_height(struct gbm_bo *bo)
	{
	return drv_bo_get_height(bo->bo);
	}

	PUBLIC uint32_t gbm_bo_get_stride(struct gbm_bo *bo)
	{
	return gbm_bo_get_stride_for_plane(bo, 0);
	}

	PUBLIC uint32_t gbm_bo_get_format(struct gbm_bo *bo)
	{
	return bo->gbm_format;
	}

	PUBLIC uint32_t gbm_bo_get_bpp(struct gbm_bo *bo)
	{
	return drv_bytes_per_pixel_from_format(drv_bo_get_format(bo->bo), 0);
	}

	PUBLIC uint64_t gbm_bo_get_modifier(struct gbm_bo *bo)
	{
	return drv_bo_get_plane_format_modifier(bo->bo, 0);
	}

	PUBLIC struct gbm_device gbm_bo_get_device(struct gbm_bo bo)
	{
	return bo->gbm;
	}

	PUBLIC union gbm_bo_handle gbm_bo_get_handle(struct gbm_bo *bo)
	{
	return gbm_bo_get_handle_for_plane(bo, 0);
	}

	PUBLIC int gbm_bo_get_fd(struct gbm_bo *bo)
	{
	return gbm_bo_get_plane_fd(bo, 0);
	}

	PUBLIC int gbm_bo_get_plane_count(struct gbm_bo *bo)
	{
	return drv_bo_get_num_planes(bo->bo);
	}

	PUBLIC union gbm_bo_handle gbm_bo_get_handle_for_plane(struct gbm_bo *bo, size_t plane)
	{
	return (union gbm_bo_handle)drv_bo_get_plane_handle(bo->bo, (size_t)plane).u64;
	}

	PUBLIC uint32_t gbm_bo_get_offset(struct gbm_bo *bo, size_t plane)
	{
	return drv_bo_get_plane_offset(bo->bo, (size_t)plane);
	}

	PUBLIC uint32_t gbm_bo_get_stride_for_plane(struct gbm_bo *bo, size_t plane)
	{
	return drv_bo_get_plane_stride(bo->bo, (size_t)plane);
	}

	PUBLIC void gbm_bo_set_user_data(struct gbm_bo bo, void data,
	void (destroy_user_data)(struct gbm_bo , void *))
	{
	bo->user_data = data;
	bo->destroy_user_data = destroy_user_data;
	}

	PUBLIC void gbm_bo_get_user_data(struct gbm_bo bo)
	{
	return bo->user_data;
	}

	/* The two GBM_BO_FORMAT_[XA]RGB8888 formats alias the GBM_FORMAT_*
	* formats of the same name. We want to accept them whenever someone
	* has a GBM format, but never return them to the user.
	*/
	static uint32_t gbm_format_canonicalize(uint32_t gbm_format)
	{
	switch (gbm_format) {
	case GBM_BO_FORMAT_XRGB8888:
	return GBM_FORMAT_XRGB8888;
	case GBM_BO_FORMAT_ARGB8888:
	return GBM_FORMAT_ARGB8888;
	default:
	return gbm_format;
	}
	}

	/**
	* Returns a string representing the fourcc format name.
	*/
	PUBLIC char gbm_format_get_name(uint32_t gbm_format, struct gbm_format_name_desc desc)
	{
	gbm_format = gbm_format_canonicalize(gbm_format);

	desc->name[0] = gbm_format;
	desc->name[1] = gbm_format >> 8;
	desc->name[2] = gbm_format >> 16;
	desc->name[3] = gbm_format >> 24;
	desc->name[4] = 0;

	return desc->name;
	}

	/*
	* The following functions are not deprecated, but not in the Mesa the gbm
	* header. The main difference is minigbm allows for the possibility of
	* disjoint YUV images, while Mesa GBM does not.
	*/
	PUBLIC uint32_t gbm_bo_get_plane_size(struct gbm_bo *bo, size_t plane)
	{
	return drv_bo_get_plane_size(bo->bo, plane);
	}

	PUBLIC int gbm_bo_get_plane_fd(struct gbm_bo *bo, size_t plane)
	{
	return drv_bo_get_plane_fd(bo->bo, plane);
	}

	PUBLIC void gbm_bo_map2(struct gbm_bo bo, uint32_t x, uint32_t y, uint32_t width, uint32_t height,
	uint32_t transfer_flags, uint32_t stride, void *map_data, int plane)
	{
	void *addr;
	off_t offset;
	uint32_t map_flags;
	plane = (size_t)plane;
	struct rectangle rect = { .x = x, .y = y, .width = width, .height = height };
	if (!bo \|\| width == 0 \|\| height == 0 \|\| !stride \|\| !map_data)
	return NULL;

	map_flags = (transfer_flags & GBM_BO_TRANSFER_READ) ? BO_MAP_READ : BO_MAP_NONE;
	map_flags \|= (transfer_flags & GBM_BO_TRANSFER_WRITE) ? BO_MAP_WRITE : BO_MAP_NONE;

	addr = drv_bo_map(bo->bo, &rect, map_flags, (struct mapping **)map_data, plane);
	if (addr == MAP_FAILED)
	return MAP_FAILED;

	stride = ((struct mapping )*map_data)->vma->map_strides[plane];

	offset = stride rect.y;
	offset += rect.x * drv_bytes_per_pixel_from_format(bo->gbm_format, plane);
	return (void )((uint8_t )addr + offset);
	}