1/*
2 * Copyright © 2011 Intel Corporation
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
13 * Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18 * NONINFRINGEMENT.  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
19 * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
20 * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
22 * DEALINGS IN THE SOFTWARE.
23 *
24 * Authors:
25 *    Benjamin Franzke <benjaminfranzke@googlemail.com>
26 */
27
28#ifndef INTERNAL_H_
29#define INTERNAL_H_
30
31#include "gbm.h"
32#include <sys/stat.h>
33
34/* GCC visibility */
35#if defined(__GNUC__) && __GNUC__ >= 4
36#define GBM_EXPORT __attribute__ ((visibility("default")))
37#else
38#define GBM_EXPORT
39#endif
40
41/**
42 * \file gbmint.h
43 * \brief Internal implementation details of gbm
44 */
45
46/**
47 * The device used for the memory allocation.
48 *
49 * The members of this structure should be not accessed directly
50 */
51struct gbm_device {
52   /* Hack to make a gbm_device detectable by its first element. */
53   struct gbm_device *(*dummy)(int);
54
55   int fd;
56   const char *name;
57   unsigned int refcount;
58   struct stat stat;
59
60   void (*destroy)(struct gbm_device *gbm);
61   int (*is_format_supported)(struct gbm_device *gbm,
62                              uint32_t format,
63                              uint32_t usage);
64
65   struct gbm_bo *(*bo_create)(struct gbm_device *gbm,
66                               uint32_t width, uint32_t height,
67                               uint32_t format,
68                               uint32_t usage);
69   struct gbm_bo *(*bo_import)(struct gbm_device *gbm, uint32_t type,
70                               void *buffer, uint32_t usage);
71   int (*bo_write)(struct gbm_bo *bo, const void *buf, size_t data);
72   void (*bo_destroy)(struct gbm_bo *bo);
73
74   struct gbm_surface *(*surface_create)(struct gbm_device *gbm,
75                                         uint32_t width, uint32_t height,
76                                         uint32_t format, uint32_t flags);
77   struct gbm_bo *(*surface_lock_front_buffer)(struct gbm_surface *surface);
78   void (*surface_release_buffer)(struct gbm_surface *surface,
79                                  struct gbm_bo *bo);
80   int (*surface_has_free_buffers)(struct gbm_surface *surface);
81   void (*surface_destroy)(struct gbm_surface *surface);
82};
83
84/**
85 * The allocated buffer object.
86 *
87 * The members in this structure should not be accessed directly.
88 */
89struct gbm_bo {
90   struct gbm_device *gbm;
91   uint32_t width;
92   uint32_t height;
93   uint32_t stride;
94   uint32_t format;
95   union gbm_bo_handle  handle;
96   void *user_data;
97   void (*destroy_user_data)(struct gbm_bo *, void *);
98};
99
100struct gbm_surface {
101   struct gbm_device *gbm;
102   uint32_t width;
103   uint32_t height;
104   uint32_t format;
105   uint32_t flags;
106};
107
108struct gbm_backend {
109   const char *backend_name;
110   struct gbm_device *(*create_device)(int fd);
111};
112
113GBM_EXPORT struct gbm_device *
114_gbm_mesa_get_device(int fd);
115
116#endif
117