dav1d: dav1d/picture.h Source File

dav1d 1.3.0 dav1d is an AV1 decoder

Loading...
Searching...
No Matches
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
38extern "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;
49 enum Dav1dPixelLayout layout;
50 int bpc;
51} Dav1dPictureParameters;
52
53 typedef struct Dav1dPicture {
54 Dav1dSequenceHeader *seq_hdr;
55 Dav1dFrameHeader *frame_hdr;
56
64 void *data[3];
65
69 ptrdiff_t stride[2];
70
71 Dav1dPictureParameters p;
72 Dav1dDataProps m;
73
78 Dav1dContentLightLevel *content_light;
83 Dav1dMasteringDisplay *mastering_display;
87 Dav1dITUTT35 *itut_t35;
88
92 size_t n_itut_t35;
93
94 uintptr_t reserved[4];
95
96 struct Dav1dRef *frame_hdr_ref;
97 struct Dav1dRef *seq_hdr_ref;
98 struct Dav1dRef *content_light_ref;
99 struct Dav1dRef *mastering_display_ref;
100 struct Dav1dRef *itut_t35_ref;
101 uintptr_t reserved_ref[4];
102 struct Dav1dRef *ref;
103
104 void *allocator_data;
105} Dav1dPicture;
106
107 typedef struct Dav1dPicAllocator {
108 void *cookie;
133 int (*alloc_picture_callback)(Dav1dPicture *pic, void *cookie);
145 void (*release_picture_callback)(Dav1dPicture *pic, void *cookie);
146} Dav1dPicAllocator;
147
151 DAV1D_API void dav1d_picture_unref(Dav1dPicture *p);
152
153#ifdef __cplusplus
154} /* extern "C" */
155#endif
156
157#endif /* DAV1D_PICTURE_H */
common.h
DAV1D_API
#define DAV1D_API
Definition common.h:50
Dav1dRef
struct Dav1dRef Dav1dRef
Definition dav1d.h:44
headers.h
Dav1dPixelLayout
Dav1dPixelLayout
Definition headers.h:108
dav1d_picture_unref
DAV1D_API void dav1d_picture_unref(Dav1dPicture *p)
Dav1dContentLightLevel
Definition headers.h:184
Dav1dDataProps
Definition common.h:77
Dav1dFrameHeader
Definition headers.h:339
Dav1dITUTT35
Definition headers.h:200
Dav1dMasteringDisplay
Definition headers.h:189
Dav1dPicAllocator
Definition picture.h:107
Dav1dPicAllocator::release_picture_callback
void(* release_picture_callback)(Dav1dPicture *pic, void *cookie)
Definition picture.h:145
Dav1dPicAllocator::alloc_picture_callback
int(* alloc_picture_callback)(Dav1dPicture *pic, void *cookie)
Definition picture.h:133
Dav1dPicAllocator::cookie
void * cookie
custom data to pass to the allocator callbacks.
Definition picture.h:108
Dav1dPictureParameters
Definition picture.h:46
Dav1dPictureParameters::h
int h
height (in pixels)
Definition picture.h:48
Dav1dPictureParameters::layout
enum Dav1dPixelLayout layout
format of the picture
Definition picture.h:49
Dav1dPictureParameters::w
int w
width (in pixels)
Definition picture.h:47
Dav1dPictureParameters::bpc
int bpc
bits per pixel component (8 or 10)
Definition picture.h:50
Dav1dPicture
Definition picture.h:53
Dav1dPicture::allocator_data
void * allocator_data
pointer managed by the allocator
Definition picture.h:104
Dav1dPicture::p
Dav1dPictureParameters p
Definition picture.h:71
Dav1dPicture::content_light
Dav1dContentLightLevel * content_light
Definition picture.h:78
Dav1dPicture::frame_hdr_ref
struct Dav1dRef * frame_hdr_ref
Dav1dFrameHeader allocation origin.
Definition picture.h:96
Dav1dPicture::itut_t35_ref
struct Dav1dRef * itut_t35_ref
Dav1dITUTT35 allocation origin.
Definition picture.h:100
Dav1dPicture::content_light_ref
struct Dav1dRef * content_light_ref
Dav1dContentLightLevel allocation origin.
Definition picture.h:98
Dav1dPicture::reserved_ref
uintptr_t reserved_ref[4]
reserved for future use
Definition picture.h:101
Dav1dPicture::ref
struct Dav1dRef * ref
Frame data allocation origin.
Definition picture.h:102
Dav1dPicture::reserved
uintptr_t reserved[4]
reserved for future use
Definition picture.h:94
Dav1dPicture::n_itut_t35
size_t n_itut_t35
Definition picture.h:92
Dav1dPicture::itut_t35
Dav1dITUTT35 * itut_t35
Definition picture.h:87
Dav1dPicture::stride
ptrdiff_t stride[2]
Definition picture.h:69
Dav1dPicture::m
Dav1dDataProps m
Definition picture.h:72
Dav1dPicture::mastering_display_ref
struct Dav1dRef * mastering_display_ref
Dav1dMasteringDisplay allocation origin.
Definition picture.h:99
Dav1dPicture::frame_hdr
Dav1dFrameHeader * frame_hdr
Definition picture.h:55
Dav1dPicture::seq_hdr_ref
struct Dav1dRef * seq_hdr_ref
Dav1dSequenceHeader allocation origin.
Definition picture.h:97
Dav1dPicture::seq_hdr
Dav1dSequenceHeader * seq_hdr
Definition picture.h:54
Dav1dPicture::mastering_display
Dav1dMasteringDisplay * mastering_display
Definition picture.h:83
Dav1dPicture::data
void * data[3]
Definition picture.h:64
Dav1dSequenceHeader
Definition headers.h:207