FFmpeg
hwcontext_drm.h
Go to the documentation of this file.
1 /*
2  * This file is part of FFmpeg.
3  *
4  * FFmpeg is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * FFmpeg is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with FFmpeg; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18 
19 #ifndef AVUTIL_HWCONTEXT_DRM_H
20 #define AVUTIL_HWCONTEXT_DRM_H
21 
22 #include <stddef.h>
23 #include <stdint.h>
24 
25 /**
26  * @file
27  * API-specific header for AV_HWDEVICE_TYPE_DRM.
28  *
29  * Internal frame allocation is not currently supported - all frames
30  * must be allocated by the user. Thus AVHWFramesContext is always
31  * NULL, though this may change if support for frame allocation is
32  * added in future.
33  */
34 
35 enum {
36  /**
37  * The maximum number of layers/planes in a DRM frame.
38  */
40 };
41 
42 /**
43  * DRM object descriptor.
44  *
45  * Describes a single DRM object, addressing it as a PRIME file
46  * descriptor.
47  */
48 typedef struct AVDRMObjectDescriptor {
49  /**
50  * DRM PRIME fd for the object.
51  */
52  int fd;
53  /**
54  * Total size of the object.
55  *
56  * (This includes any parts not which do not contain image data.)
57  */
58  size_t size;
59  /**
60  * Format modifier applied to the object (DRM_FORMAT_MOD_*).
61  *
62  * If the format modifier is unknown then this should be set to
63  * DRM_FORMAT_MOD_INVALID.
64  */
65  uint64_t format_modifier;
67 
68 /**
69  * DRM plane descriptor.
70  *
71  * Describes a single plane of a layer, which is contained within
72  * a single object.
73  */
74 typedef struct AVDRMPlaneDescriptor {
75  /**
76  * Index of the object containing this plane in the objects
77  * array of the enclosing frame descriptor.
78  */
80  /**
81  * Offset within that object of this plane.
82  */
83  ptrdiff_t offset;
84  /**
85  * Pitch (linesize) of this plane.
86  */
87  ptrdiff_t pitch;
89 
90 /**
91  * DRM layer descriptor.
92  *
93  * Describes a single layer within a frame. This has the structure
94  * defined by its format, and will contain one or more planes.
95  */
96 typedef struct AVDRMLayerDescriptor {
97  /**
98  * Format of the layer (DRM_FORMAT_*).
99  */
100  uint32_t format;
101  /**
102  * Number of planes in the layer.
103  *
104  * This must match the number of planes required by format.
105  */
107  /**
108  * Array of planes in this layer.
109  */
112 
113 /**
114  * DRM frame descriptor.
115  *
116  * This is used as the data pointer for AV_PIX_FMT_DRM_PRIME frames.
117  * It is also used by user-allocated frame pools - allocating in
118  * AVHWFramesContext.pool must return AVBufferRefs which contain
119  * an object of this type.
120  *
121  * The fields of this structure should be set such it can be
122  * imported directly by EGL using the EGL_EXT_image_dma_buf_import
123  * and EGL_EXT_image_dma_buf_import_modifiers extensions.
124  * (Note that the exact layout of a particular format may vary between
125  * platforms - we only specify that the same platform should be able
126  * to import it.)
127  *
128  * The total number of planes must not exceed AV_DRM_MAX_PLANES, and
129  * the order of the planes by increasing layer index followed by
130  * increasing plane index must be the same as the order which would
131  * be used for the data pointers in the equivalent software format.
132  */
133 typedef struct AVDRMFrameDescriptor {
134  /**
135  * Number of DRM objects making up this frame.
136  */
138  /**
139  * Array of objects making up the frame.
140  */
142  /**
143  * Number of layers in the frame.
144  */
146  /**
147  * Array of layers in the frame.
148  */
151 
152 /**
153  * DRM device.
154  *
155  * Allocated as AVHWDeviceContext.hwctx.
156  */
157 typedef struct AVDRMDeviceContext {
158  /**
159  * File descriptor of DRM device.
160  *
161  * This is used as the device to create frames on, and may also be
162  * used in some derivation and mapping operations.
163  *
164  * If no device is required, set to -1.
165  */
166  int fd;
168 
169 #endif /* AVUTIL_HWCONTEXT_DRM_H */
AVDRMPlaneDescriptor
DRM plane descriptor.
Definition: hwcontext_drm.h:74
AVDRMFrameDescriptor::nb_layers
int nb_layers
Number of layers in the frame.
Definition: hwcontext_drm.h:145
AVDRMFrameDescriptor
DRM frame descriptor.
Definition: hwcontext_drm.h:133
AVDRMDeviceContext::fd
int fd
File descriptor of DRM device.
Definition: hwcontext_drm.h:166
AVDRMLayerDescriptor::nb_planes
int nb_planes
Number of planes in the layer.
Definition: hwcontext_drm.h:106
AVDRMLayerDescriptor::planes
AVDRMPlaneDescriptor planes[AV_DRM_MAX_PLANES]
Array of planes in this layer.
Definition: hwcontext_drm.h:110
AVDRMPlaneDescriptor::offset
ptrdiff_t offset
Offset within that object of this plane.
Definition: hwcontext_drm.h:83
AVDRMLayerDescriptor
DRM layer descriptor.
Definition: hwcontext_drm.h:96
AVDRMObjectDescriptor
DRM object descriptor.
Definition: hwcontext_drm.h:48
AVDRMObjectDescriptor::fd
int fd
DRM PRIME fd for the object.
Definition: hwcontext_drm.h:52
AVDRMFrameDescriptor::layers
AVDRMLayerDescriptor layers[AV_DRM_MAX_PLANES]
Array of layers in the frame.
Definition: hwcontext_drm.h:149
AVDRMObjectDescriptor::size
size_t size
Total size of the object.
Definition: hwcontext_drm.h:58
AVDRMFrameDescriptor::objects
AVDRMObjectDescriptor objects[AV_DRM_MAX_PLANES]
Array of objects making up the frame.
Definition: hwcontext_drm.h:141
AVDRMObjectDescriptor::format_modifier
uint64_t format_modifier
Format modifier applied to the object (DRM_FORMAT_MOD_*).
Definition: hwcontext_drm.h:65
AV_DRM_MAX_PLANES
@ AV_DRM_MAX_PLANES
The maximum number of layers/planes in a DRM frame.
Definition: hwcontext_drm.h:39
AVDRMPlaneDescriptor::object_index
int object_index
Index of the object containing this plane in the objects array of the enclosing frame descriptor.
Definition: hwcontext_drm.h:79
AVDRMLayerDescriptor::format
uint32_t format
Format of the layer (DRM_FORMAT_*).
Definition: hwcontext_drm.h:100
AVDRMPlaneDescriptor::pitch
ptrdiff_t pitch
Pitch (linesize) of this plane.
Definition: hwcontext_drm.h:87
AVDRMDeviceContext
DRM device.
Definition: hwcontext_drm.h:157
AVDRMFrameDescriptor::nb_objects
int nb_objects
Number of DRM objects making up this frame.
Definition: hwcontext_drm.h:137