dav1d  1.4.0
dav1d is an AV1 decoder
picture.h
Go to the documentation of this file.
1 /*
2  * Copyright © 2018-2020, VideoLAN and dav1d authors
3  * Copyright © 2018, Two Orioles, LLC
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions are met:
8  *
9  * 1. Redistributions of source code must retain the above copyright notice, this
10  * list of conditions and the following disclaimer.
11  *
12  * 2. Redistributions in binary form must reproduce the above copyright notice,
13  * this list of conditions and the following disclaimer in the documentation
14  * and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
19  * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
20  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
21  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
22  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
23  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
25  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  */
27 
28 #ifndef DAV1D_PICTURE_H
29 #define DAV1D_PICTURE_H
30 
31 #include <stddef.h>
32 #include <stdint.h>
33 
34 #include "common.h"
35 #include "headers.h"
36 
37 #ifdef __cplusplus
38 extern "C" {
39 #endif
40 
41 /* Number of bytes to align AND pad picture memory buffers by, so that SIMD
42  * implementations can over-read by a few bytes, and use aligned read/write
43  * instructions. */
44 #define DAV1D_PICTURE_ALIGNMENT 64
45 
46 typedef struct Dav1dPictureParameters {
47  int w;
48  int h;
50  int bpc;
52 
53 typedef struct Dav1dPicture {
56 
64  void *data[3];
65 
69  ptrdiff_t stride[2];
70 
73 
88 
92  size_t n_itut_t35;
93 
94  uintptr_t reserved[4];
95 
101  uintptr_t reserved_ref[4];
102  struct Dav1dRef *ref;
103 
105 } Dav1dPicture;
106 
107 typedef struct Dav1dPicAllocator {
108  void *cookie;
147 
152 
153 #ifdef __cplusplus
154 } /* extern "C" */
155 #endif
156 
157 #endif /* DAV1D_PICTURE_H */
#define DAV1D_API
Definition: common.h:50
struct Dav1dRef Dav1dRef
Definition: dav1d.h:44
Dav1dPixelLayout
Definition: headers.h:108
DAV1D_API void dav1d_picture_unref(Dav1dPicture *p)
Definition: headers.h:184
Definition: common.h:77
Definition: headers.h:339
Definition: headers.h:200
Definition: headers.h:189
Definition: picture.h:107
void(* release_picture_callback)(Dav1dPicture *pic, void *cookie)
Definition: picture.h:145
int(* alloc_picture_callback)(Dav1dPicture *pic, void *cookie)
Definition: picture.h:133
void * cookie
custom data to pass to the allocator callbacks.
Definition: picture.h:108
Definition: picture.h:46
int h
height (in pixels)
Definition: picture.h:48
enum Dav1dPixelLayout layout
format of the picture
Definition: picture.h:49
int w
width (in pixels)
Definition: picture.h:47
int bpc
bits per pixel component (8 or 10)
Definition: picture.h:50
Definition: picture.h:53
void * allocator_data
pointer managed by the allocator
Definition: picture.h:104
Dav1dPictureParameters p
Definition: picture.h:71
Dav1dContentLightLevel * content_light
Definition: picture.h:78
struct Dav1dRef * frame_hdr_ref
Dav1dFrameHeader allocation origin.
Definition: picture.h:96
struct Dav1dRef * itut_t35_ref
Dav1dITUTT35 allocation origin.
Definition: picture.h:100
struct Dav1dRef * content_light_ref
Dav1dContentLightLevel allocation origin.
Definition: picture.h:98
uintptr_t reserved_ref[4]
reserved for future use
Definition: picture.h:101
struct Dav1dRef * ref
Frame data allocation origin.
Definition: picture.h:102
uintptr_t reserved[4]
reserved for future use
Definition: picture.h:94
size_t n_itut_t35
Definition: picture.h:92
Dav1dITUTT35 * itut_t35
Definition: picture.h:87
ptrdiff_t stride[2]
Definition: picture.h:69
Dav1dDataProps m
Definition: picture.h:72
struct Dav1dRef * mastering_display_ref
Dav1dMasteringDisplay allocation origin.
Definition: picture.h:99
Dav1dFrameHeader * frame_hdr
Definition: picture.h:55
struct Dav1dRef * seq_hdr_ref
Dav1dSequenceHeader allocation origin.
Definition: picture.h:97
Dav1dSequenceHeader * seq_hdr
Definition: picture.h:54
Dav1dMasteringDisplay * mastering_display
Definition: picture.h:83
void * data[3]
Definition: picture.h:64
Definition: headers.h:207