mirror of
https://github.com/outbackdingo/UltraGrid.git
synced 2026-04-05 10:04:58 +00:00
0654e99744
Use pixfmt_desc instead of codec_t for internal compression
representation. This better alignes eg. YUV 10-bit 4:4:4 which has been
deduced as Y416 and eg. for DeckLink, R12L was chosen because it was
thought to be 16 bit, not 10.
This fixes:
uv -t testcard:codec=R10k -c libavcodec:encoder=libx265:yuv -d dummy:codec=decklink
being detected internally as Y416 and configured as R12L. Now it is
internally Y444_10 and output DeckLink would be configured to R10k.
Removed also params "lavd-use-10bit", "lavd-use-codec", which were
deprecated already some time and if can be replaced by
"decoder-use-codec" if needed.
191 lines
6.9 KiB
C
191 lines
6.9 KiB
C
/**
|
|
* @file video_decompress.h
|
|
* @author Martin Pulec <pulec@cesnet.cz>
|
|
*
|
|
* @ingroup video_decompress
|
|
* @brief API for video decompress drivers
|
|
*/
|
|
/*
|
|
* Copyright (c) 2011-2019 CESNET, z. s. p. o.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, is permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
*
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* 3. Neither the name of CESNET nor the names of its contributors may be
|
|
* used to endorse or promote products derived from this software without
|
|
* specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING,
|
|
* BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
|
|
* AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
|
|
* EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
|
|
* INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
|
* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
|
|
* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
*/
|
|
|
|
#define VIDEO_DECOMPRESS_ABI_VERSION 6
|
|
|
|
/**
|
|
* @defgroup video_decompress Video Decompress
|
|
* @{
|
|
*/
|
|
#ifndef __video_decompress_h
|
|
#define __video_decompress_h
|
|
|
|
#include "types.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct state_decompress;
|
|
|
|
/**
|
|
* This property tells that even broken frame (with missing data)
|
|
* can be passed to decompressor. Otherwise, broken frame is discarded.
|
|
*/
|
|
#define DECOMPRESS_PROPERTY_ACCEPTS_CORRUPTED_FRAME 1 /* int */
|
|
|
|
/**
|
|
* initializes decompression and returns internal state
|
|
*/
|
|
typedef void *(*decompress_init_t)();
|
|
/**
|
|
* Recompresses decompression for specified video description
|
|
* @param[in] desc video description
|
|
* @param[in] rshift requested output red shift (if output is RGB(A))
|
|
* @param[in] gshift requested output green shift
|
|
* @param[in] bshift requested output blue shift
|
|
* @param[in] pitch requested output pitch
|
|
* @param[in] out_codec requested output pixelformat (VIDEO_CODEC_NONE to
|
|
* discover internal representation)
|
|
* @retval FALSE if reconfiguration failed
|
|
* @retval TRUE if reconfiguration succeeded
|
|
*/
|
|
typedef int (*decompress_reconfigure_t)(void * state, struct video_desc desc,
|
|
int rshift, int gshift, int bshift, int pitch, codec_t out_codec);
|
|
|
|
typedef enum {
|
|
DECODER_NO_FRAME = 0, //Frame not decoded yet
|
|
DECODER_GOT_FRAME, //Frame decoded and written to destination
|
|
DECODER_GOT_CODEC, ///< Internal pixel format was determined
|
|
DECODER_UNSUPP_PIXFMT, ///< Decoder can't decode to selected out_codec
|
|
} decompress_status;
|
|
|
|
/**
|
|
* @brief Decompresses video frame
|
|
* @param[in] state decompress state
|
|
* @param[out] dst buffer where uncompressed frame will be written
|
|
* @note
|
|
* Length of the result isn't returned because is known from the informations
|
|
* passed with decompress_reconfigure.
|
|
* @param[in] buffer buffer where uncompressed frame will be written
|
|
* @param[in] src_len length of the compressed buffer
|
|
* @param[in] frame_seq sequential number of frame. Subsequent frames
|
|
* has sequential number +1. The point is to signalize
|
|
* decompressor when one or more frames got lost (interframe compress).
|
|
* @param callbacks used only by libavcodec
|
|
* @param[out] internal_codec internal codec pixel format that was probed (@see DECODER_GOT_CODEC).
|
|
* May be ignored if decoder doesn't announce codec probing (see @ref
|
|
* decode_from_to)
|
|
* @note
|
|
* Frame_seq used perhaps only for VP8, H.264 uses Periodic Intra Refresh.
|
|
*/
|
|
typedef decompress_status (*decompress_decompress_t)(
|
|
void *state,
|
|
unsigned char *dst,
|
|
unsigned char *buffer,
|
|
unsigned int src_len,
|
|
int frame_seq,
|
|
struct video_frame_callbacks *callbacks,
|
|
struct pixfmt_desc *internal_prop);
|
|
|
|
/**
|
|
* @param state decoder state
|
|
* @param property ID of queried property
|
|
* @param val return value
|
|
* @param[in] len max bytes that may be written to val
|
|
* @param[out] len number of bytes actually written
|
|
*/
|
|
typedef int (*decompress_get_property_t)(void *state, int property, void *val, size_t *len);
|
|
|
|
/**
|
|
* Cleanup function
|
|
*/
|
|
typedef void (*decompress_done_t)(void *);
|
|
|
|
/**
|
|
* @retval (-1) this module cannot decode specified configuration
|
|
* @return priority Priority to select this decoder if there are multiple matches for
|
|
* specified compress/pixelformat pair. Range is [0..1000], lower is better.
|
|
*/
|
|
typedef int (*decompress_get_priority_t)(codec_t compression, struct pixfmt_desc internal, codec_t ugc);
|
|
|
|
struct video_decompress_info {
|
|
decompress_init_t init;
|
|
decompress_reconfigure_t reconfigure;
|
|
decompress_decompress_t decompress;
|
|
decompress_get_property_t get_property;
|
|
decompress_done_t done;
|
|
decompress_get_priority_t get_decompress_priority;
|
|
};
|
|
|
|
bool decompress_init_multi(codec_t compression,
|
|
struct pixfmt_desc internal,
|
|
codec_t to,
|
|
struct state_decompress **out,
|
|
int count);
|
|
|
|
/** */
|
|
int decompress_reconfigure(struct state_decompress *,
|
|
struct video_desc,
|
|
int rshift,
|
|
int gshift,
|
|
int bshift,
|
|
int pitch,
|
|
codec_t out_codec);
|
|
|
|
/**
|
|
* @param internal_codec must not be nullptr if reconfigured with
|
|
* out_codec == VIDEO_CODEC_NONE. Its value
|
|
is valid only if returned DECODER_GOT_CODEC.
|
|
*/
|
|
decompress_status decompress_frame(struct state_decompress *,
|
|
unsigned char *dst,
|
|
unsigned char *src,
|
|
unsigned int src_len,
|
|
int frame_seq,
|
|
struct video_frame_callbacks *callbacks,
|
|
struct pixfmt_desc *internal_prop);
|
|
|
|
int decompress_get_property(struct state_decompress *state,
|
|
int property,
|
|
void *val,
|
|
size_t *len);
|
|
|
|
void decompress_done(struct state_decompress *);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __video_decompress_h */
|
|
/** @} */ // end of video_decompress
|
|
|