1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
/*
* Copyright (C) 2016 Christian Gmeiner <christian.gmeiner@gmail.com>
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice (including the next
* paragraph) shall be included in all copies or substantial portions of the
* Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*
* Authors:
* Christian Gmeiner <christian.gmeiner@gmail.com>
*/
#ifndef RENDERONLY_H
#define RENDERONLY_H
#include <stdint.h>
#include "frontend/drm_driver.h"
#include "pipe/p_state.h"
struct renderonly_scanout {
uint32_t handle;
uint32_t stride;
};
struct renderonly {
/**
* Create a renderonly_scanout object for scanout resource.
*
* This function creates a renderonly_scanout object based on the provided
* resource. The library is designed that the driver specific pipe_resource
* struct holds a pointer to a renderonly_scanout struct.
*
* struct driver_resource {
* struct pipe_resource base;
* struct renderonly_scanout *scanout;
* ...
* };
*
* The renderonly_scanout object exits for two reasons:
* - Do any special treatment for a scanout resource like importing the GPU
* resource into the scanout hw.
* - Make it easier for a gallium driver to detect if anything special needs
* to be done in flush_resource(..) like a resolve to linear.
*/
struct renderonly_scanout *(*create_for_resource)(struct pipe_resource *rsc,
struct renderonly *ro,
struct winsys_handle *out_handle);
void (*destroy)(struct renderonly *ro);
int kms_fd;
int gpu_fd;
};
static inline struct renderonly_scanout *
renderonly_scanout_for_resource(struct pipe_resource *rsc,
struct renderonly *ro,
struct winsys_handle *out_handle)
{
return ro->create_for_resource(rsc, ro, out_handle);
}
void
renderonly_scanout_destroy(struct renderonly_scanout *scanout,
struct renderonly *ro);
static inline boolean
renderonly_get_handle(struct renderonly_scanout *scanout,
struct winsys_handle *handle)
{
if (!scanout)
return FALSE;
assert(handle->type == WINSYS_HANDLE_TYPE_KMS);
handle->handle = scanout->handle;
handle->stride = scanout->stride;
return TRUE;
}
/**
* Create a dumb buffer object for a resource at scanout hw.
*/
struct renderonly_scanout *
renderonly_create_kms_dumb_buffer_for_resource(struct pipe_resource *rsc,
struct renderonly *ro,
struct winsys_handle *out_handle);
/**
* Import GPU resource into scanout hw.
*/
struct renderonly_scanout *
renderonly_create_gpu_import_for_resource(struct pipe_resource *rsc,
struct renderonly *ro,
struct winsys_handle *out_handle);
#endif /* RENDERONLY_H_ */
|
