video_frame.h

Go to the documentation of this file.

 
/* Copyright (c) 2005-2013 CESNET z.s.p.o.
 *
 * 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. All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 *
 *      This product includes software developed by CESNET z.s.p.o.
 *
 * 4. Neither the name of the 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.
 *
 */
#ifndef video_frame_h_
#define video_frame_h_
 
#ifndef __cplusplus
#include <stdbool.h>
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include "types.h"
 
#define PARAM_WIDTH                     (1<<0u)
#define PARAM_HEIGHT                    (1<<2u)
#define PARAM_CODEC                     (1<<3u)
#define PARAM_INTERLACING               (1<<4u)
#define PARAM_FPS                       (1<<5u)
#define PARAM_TILE_COUNT                (1<<6u)
#define VIDEO_FRAME_DISPOSE(frame) if ((frame) && (frame)->callbacks.dispose) \
        (frame)->callbacks.dispose(frame)
 
struct video_frame * vf_alloc(int count);
struct video_frame * vf_alloc_desc(struct video_desc desc);
struct video_frame * vf_alloc_desc_data(struct video_desc desc);
 
void vf_free(struct video_frame *buf);
 
void vf_recycle(struct video_frame *buf);
 
void vf_data_deleter(struct video_frame *buf);
 
struct tile * vf_get_tile(struct video_frame *buf, int pos);
struct video_frame * vf_get_copy(struct video_frame *original_frame);
bool video_desc_eq(struct video_desc, struct video_desc);
bool video_desc_eq_excl_param(struct video_desc a, struct video_desc b, unsigned int excluded_params);
struct video_desc video_desc_from_frame(const struct video_frame *frame);
const char *get_interlacing_description(enum interlacing_t interlacing);
const char *get_interlacing_suffix(enum interlacing_t interlacing);
enum interlacing_t get_interlacing_from_suffix(const char *suffix);
 
void il_lower_to_merged(char *dst, char *src, int linesize, int height, void **stored_state);
/* these functions transcode one interlacing format to another */
void il_upper_to_merged(char *dst, char *src, int linesize, int height, void **stored_state);
void il_merged_to_upper(char *dst, char *src, int linesize, int height, void **stored_state);
 
double compute_fps(int fps, int fpsd, int fd, int fi);
bool parse_fps(const char *fps, struct video_desc *desc);
 
bool save_video_frame_as_pnm(struct video_frame *frame, const char *name);
const char *save_video_frame(struct video_frame *frame, const char *name, bool raw);
struct video_frame *load_video_frame(const char *name, codec_t codec, int width,
                                     int height);
 
void vf_copy_metadata(struct video_frame *dest, const struct video_frame *src);
void vf_store_metadata(const struct video_frame *f, void *);
void vf_restore_metadata(struct video_frame *f, void *);
 
unsigned int vf_get_data_len(struct video_frame *f);
 
void buf_get_planes(int width, int height, codec_t color_spec, char *data, char **planes);
void buf_get_linesizes(int width, codec_t color_spec, int *linesize);
 
void vf_clear(struct video_frame *f);
 
#define AUX_INTERLACED  (1<<0)
#define AUX_PROGRESSIVE (1<<1)
#define AUX_SF          (1<<2)
#define AUX_RGB         (1<<3) /* if device supports both, set both */
#define AUX_YUV         (1<<4)
#define AUX_10Bit       (1<<5)
#ifdef __cplusplus
}
#endif
 
#endif