media/libvpx/vp8/encoder/lookahead.h

branch
TOR_BUG_9701
changeset 10
ac0c01689b40
equal deleted inserted replaced
-1:000000000000 0:7b4ce01a25d6
1 /*
2 * Copyright (c) 2011 The WebM project authors. All Rights Reserved.
3 *
4 * Use of this source code is governed by a BSD-style license
5 * that can be found in the LICENSE file in the root of the source
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 */
10 #ifndef LOOKAHEAD_H
11 #define LOOKAHEAD_H
12 #include "vpx_scale/yv12config.h"
13 #include "vpx/vpx_integer.h"
14
15 struct lookahead_entry
16 {
17 YV12_BUFFER_CONFIG img;
18 int64_t ts_start;
19 int64_t ts_end;
20 unsigned int flags;
21 };
22
23
24 struct lookahead_ctx;
25
26 /**\brief Initializes the lookahead stage
27 *
28 * The lookahead stage is a queue of frame buffers on which some analysis
29 * may be done when buffers are enqueued.
30 *
31 *
32 */
33 struct lookahead_ctx* vp8_lookahead_init(unsigned int width,
34 unsigned int height,
35 unsigned int depth
36 );
37
38
39 /**\brief Destroys the lookahead stage
40 *
41 */
42 void vp8_lookahead_destroy(struct lookahead_ctx *ctx);
43
44
45 /**\brief Enqueue a source buffer
46 *
47 * This function will copy the source image into a new framebuffer with
48 * the expected stride/border.
49 *
50 * If active_map is non-NULL and there is only one frame in the queue, then copy
51 * only active macroblocks.
52 *
53 * \param[in] ctx Pointer to the lookahead context
54 * \param[in] src Pointer to the image to enqueue
55 * \param[in] ts_start Timestamp for the start of this frame
56 * \param[in] ts_end Timestamp for the end of this frame
57 * \param[in] flags Flags set on this frame
58 * \param[in] active_map Map that specifies which macroblock is active
59 */
60 int
61 vp8_lookahead_push(struct lookahead_ctx *ctx,
62 YV12_BUFFER_CONFIG *src,
63 int64_t ts_start,
64 int64_t ts_end,
65 unsigned int flags,
66 unsigned char *active_map);
67
68
69 /**\brief Get the next source buffer to encode
70 *
71 *
72 * \param[in] ctx Pointer to the lookahead context
73 * \param[in] drain Flag indicating the buffer should be drained
74 * (return a buffer regardless of the current queue depth)
75 *
76 * \retval NULL, if drain set and queue is empty
77 * \retval NULL, if drain not set and queue not of the configured depth
78 *
79 */
80 struct lookahead_entry*
81 vp8_lookahead_pop(struct lookahead_ctx *ctx,
82 int drain);
83
84
85 #define PEEK_FORWARD 1
86 #define PEEK_BACKWARD -1
87 /**\brief Get a future source buffer to encode
88 *
89 * \param[in] ctx Pointer to the lookahead context
90 * \param[in] index Index of the frame to be returned, 0 == next frame
91 *
92 * \retval NULL, if no buffer exists at the specified index
93 *
94 */
95 struct lookahead_entry*
96 vp8_lookahead_peek(struct lookahead_ctx *ctx,
97 unsigned int index,
98 int direction);
99
100
101 /**\brief Get the number of frames currently in the lookahead queue
102 *
103 * \param[in] ctx Pointer to the lookahead context
104 */
105 unsigned int
106 vp8_lookahead_depth(struct lookahead_ctx *ctx);
107
108
109 #endif

mercurial