88841f1059
This patch cleans up the source buffer storage and copy mechanism to allow access through a standard push/pop/peek interface. This approach also avoids an extra copy in the case where the source is not a multiple of 16, fixing issue #102. Change-Id: I05808c39f5743625cb4c7af54cc841b9b10fdbd9
102 lines
2.9 KiB
C
102 lines
2.9 KiB
C
/*
|
|
* Copyright (c) 2011 The WebM project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
#ifndef LOOKAHEAD_H
|
|
#define LOOKAHEAD_H
|
|
#include "vpx_scale/yv12config.h"
|
|
#include "vpx/vpx_integer.h"
|
|
|
|
struct lookahead_entry
|
|
{
|
|
YV12_BUFFER_CONFIG img;
|
|
int64_t ts_start;
|
|
int64_t ts_end;
|
|
unsigned int flags;
|
|
};
|
|
|
|
|
|
struct lookahead_ctx;
|
|
|
|
/**\brief Initializes the lookahead stage
|
|
*
|
|
* The lookahead stage is a queue of frame buffers on which some analysis
|
|
* may be done when buffers are enqueued.
|
|
*
|
|
*
|
|
*/
|
|
struct lookahead_ctx* vp8_lookahead_init(unsigned int width,
|
|
unsigned int height,
|
|
unsigned int depth
|
|
);
|
|
|
|
|
|
/**\brief Destroys the lookahead stage
|
|
*
|
|
*/
|
|
void vp8_lookahead_destroy(struct lookahead_ctx *ctx);
|
|
|
|
|
|
/**\brief Enqueue a source buffer
|
|
*
|
|
* This function will copy the source image into a new framebuffer with
|
|
* the expected stride/border.
|
|
*
|
|
* \param[in] ctx Pointer to the lookahead context
|
|
* \param[in] src Pointer to the image to enqueue
|
|
* \param[in] ts_start Timestamp for the start of this frame
|
|
* \param[in] ts_end Timestamp for the end of this frame
|
|
* \param[in] flags Flags set on this frame
|
|
*/
|
|
int
|
|
vp8_lookahead_push(struct lookahead_ctx *ctx,
|
|
YV12_BUFFER_CONFIG *src,
|
|
int64_t ts_start,
|
|
int64_t ts_end,
|
|
unsigned int flags);
|
|
|
|
|
|
/**\brief Get the next source buffer to encode
|
|
*
|
|
*
|
|
* \param[in] ctx Pointer to the lookahead context
|
|
* \param[in] drain Flag indicating the buffer should be drained
|
|
* (return a buffer regardless of the current queue depth)
|
|
*
|
|
* \retval NULL, if drain set and queue is empty
|
|
* \retval NULL, if drain not set and queue not of the configured depth
|
|
*
|
|
*/
|
|
struct lookahead_entry*
|
|
vp8_lookahead_pop(struct lookahead_ctx *ctx,
|
|
int drain);
|
|
|
|
|
|
/**\brief Get a future source buffer to encode
|
|
*
|
|
* \param[in] ctx Pointer to the lookahead context
|
|
* \param[in] index Index of the frame to be returned, 0 == next frame
|
|
*
|
|
* \retval NULL, if no buffer exists at the specified index
|
|
*
|
|
*/
|
|
struct lookahead_entry*
|
|
vp8_lookahead_peek(struct lookahead_ctx *ctx,
|
|
int index);
|
|
|
|
|
|
/**\brief Get the number of frames currently in the lookahead queue
|
|
*
|
|
* \param[in] ctx Pointer to the lookahead context
|
|
*/
|
|
unsigned int
|
|
vp8_lookahead_depth(struct lookahead_ctx *ctx);
|
|
|
|
|
|
#endif
|