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 110
