vo_postprocess.h File Reference

#include "types.h"

Include dependency graph for vo_postprocess.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	vo_postprocess_info

Macros
#define	VO_PP_ABI_VERSION   7
#define	VO_PP_DOES_CHANGE_TILING_MODE   1 /* bool false */
#define	VO_PP_PROPERTY_CODECS   0 /* codec_t[] all uncompressed */

Typedefs
typedef void(*	vo_postprocess_done_t) (void *)
typedef void(*	vo_postprocess_get_out_desc_t) (void *s, struct video_desc *out, int *in_tile_mode, int *out_frame_count)
typedef bool(*	vo_postprocess_get_property_t) (void *state, int property, void *val, size_t *len)
typedef struct video_frame *(*	vo_postprocess_getf_t) (void *state)
typedef void *(*	vo_postprocess_init_t) (const char *cfg)
typedef bool(*	vo_postprocess_reconfigure_t) (void *state, struct video_desc desc)
typedef bool(*	vo_postprocess_t) (void *state, struct video_frame *in, struct video_frame *out, int req_out_pitch)

Functions
void	show_vo_postprocess_help (bool full)
bool	vo_postprocess (struct vo_postprocess_state *, struct video_frame *, struct video_frame *, int req_pitch)
void	vo_postprocess_done (struct vo_postprocess_state *s)
void	vo_postprocess_get_out_desc (struct vo_postprocess_state *, struct video_desc *out, int *display_mode, int *out_frames_count)
bool	vo_postprocess_get_property (struct vo_postprocess_state *, int property, void *val, size_t *len)
struct video_frame *	vo_postprocess_getf (struct vo_postprocess_state *)
struct vo_postprocess_state *	vo_postprocess_init (const char *config_string)
bool	vo_postprocess_reconfigure (struct vo_postprocess_state *, struct video_desc)

Detailed Description

Author

Martin Pulec pulec.nosp@m.@ces.nosp@m.net.c.nosp@m.z

Definition in file vo_postprocess.h.

Macro Definition Documentation

VO_PP_ABI_VERSION

#define VO_PP_ABI_VERSION   7

Definition at line 53 of file vo_postprocess.h.

Referenced by init(), and show_vo_postprocess_help().

VO_PP_DOES_CHANGE_TILING_MODE

#define VO_PP_DOES_CHANGE_TILING_MODE   1 /* bool false */

Definition at line 51 of file vo_postprocess.h.

Referenced by display_reconfigure(), split_get_property(), and vo_postprocess_get_property().

VO_PP_PROPERTY_CODECS

#define VO_PP_PROPERTY_CODECS   0 /* codec_t[] all uncompressed */

Definition at line 50 of file vo_postprocess.h.

Referenced by change_pixfmt_vo_pp_get_property(), delay_get_property(), display_ctl_property(), scale_get_property(), and vo_postprocess_get_property().

Typedef Documentation

vo_postprocess_done_t

typedef void(* vo_postprocess_done_t) (void *)

Cleanup function

Definition at line 115 of file vo_postprocess.h.

vo_postprocess_get_out_desc_t

typedef void(* vo_postprocess_get_out_desc_t) (void *s, struct video_desc *out, int *in_tile_mode, int *out_frame_count)

Definition at line 83 of file vo_postprocess.h.

vo_postprocess_get_property_t

typedef bool(* vo_postprocess_get_property_t) (void *state, int property, void *val, size_t *len)

Returns supported codecs

Parameters

state	postprocessor state
property	property to be queried
val	returned value, 0 indicates that the property is understood, but there was a problem processing the query (true is returned)
len	argument length IN - length of allocated block OUT - returned size (must be equal or less than allocated space)

Returns

true if the flag is understood false if not, in that case, default values are assumed (if possible)

Definition at line 99 of file vo_postprocess.h.

vo_postprocess_getf_t

typedef struct video_frame *(* vo_postprocess_getf_t) (void *state)

Definition at line 69 of file vo_postprocess.h.

vo_postprocess_init_t

typedef void *(* vo_postprocess_init_t) (const char *cfg)

Parameters

init	optional configuration, cannot be null

Definition at line 60 of file vo_postprocess.h.

vo_postprocess_reconfigure_t

typedef bool(* vo_postprocess_reconfigure_t) (void *state, struct video_desc desc)

Reconfigures postprocessor for frame and returns resulting frame properties (they can be different)

Parameters

state	postprocessor state
desc	video description to be configured to

Definition at line 69 of file vo_postprocess.h.

vo_postprocess_t

typedef bool(* vo_postprocess_t) (void *state, struct video_frame *in, struct video_frame *out, int req_out_pitch)

Postprocesses video frame

Parameters

state	postprocessor state
input	frame

Returns

flag If output video frame is filled with valid data.

Definition at line 110 of file vo_postprocess.h.

Function Documentation

show_vo_postprocess_help()

void show_vo_postprocess_help

(

bool

full

)

Definition at line 82 of file vo_postprocess.c.

{
        printf("Usage:\n");
        color_printf(TERM_BOLD "\t-p <postprocess_module>[:<args>] | help\n" TERM_RESET);
        printf("\n");
        printf("Possible postprocess modules:\n");
        list_modules(LIBRARY_CLASS_VIDEO_POSTPROCESS, VO_PP_ABI_VERSION, full);
}

References color_printf(), LIBRARY_CLASS_VIDEO_POSTPROCESS, list_modules(), TERM_BOLD, TERM_RESET, and VO_PP_ABI_VERSION.

Referenced by initialize_video_display(), and vo_postprocess_init().

Here is the call graph for this function:

vo_postprocess()

bool vo_postprocess	(	struct vo_postprocess_state *	s,
		struct video_frame *	in,
		struct video_frame *	out,
		int	req_pitch )

param in will be NULL if vo_postprocess_get_out_desc() returns out_frames_count > 1 and will be called out_frames_count-1 times

Definition at line 215 of file vo_postprocess.c.

{
        if (s == NULL) {
                return false;
        }
        assert(in == ((struct vo_postprocess_state_single *) simple_linked_list_first(s->postprocessors))->f || in == NULL);
 
        for(void *it = simple_linked_list_it_init(s->postprocessors); it != NULL; ) {
                struct vo_postprocess_state_single *state = simple_linked_list_it_next(&it);
                struct video_frame *next = out;
                if (it != NULL) {
                        struct vo_postprocess_state_single *state_next = simple_linked_list_it_peek_next(it);
                        next = state_next->f;
                }
 
                int pitch = vc_get_linesize(next->tiles[0].width, next->color_spec);
                if (it == NULL) {
                        pitch = req_pitch;
                }
                bool ret = state->funcs->vo_postprocess(state->state, in, next, pitch);
                if (!ret) {
                        return false;
                }
                in = next;
        }
 
        return true;
}

References video_frame::color_spec, vo_postprocess_state_single::f, vo_postprocess_state::postprocessors, simple_linked_list_first(), simple_linked_list_it_init(), simple_linked_list_it_next(), simple_linked_list_it_peek_next(), state, video_frame::tiles, vc_get_linesize(), and tile::width.

Referenced by display_put_frame().

Here is the call graph for this function:

vo_postprocess_done()

void vo_postprocess_done

(

struct vo_postprocess_state *

s

)

Definition at line 245 of file vo_postprocess.c.

{
        if (s == NULL) {
                return;
        }
        for(void *it = simple_linked_list_it_init(s->postprocessors); it != NULL; ) {
                struct vo_postprocess_state_single *state = simple_linked_list_it_next(&it);
                state->funcs->done(state->state);
                free(state);
        }
        simple_linked_list_destroy(s->postprocessors);
        free(s);
}

References vo_postprocess_state::postprocessors, simple_linked_list_destroy(), simple_linked_list_it_init(), simple_linked_list_it_next(), and state.

Referenced by display_done(), process_message(), and vo_postprocess_init().

Here is the call graph for this function:

vo_postprocess_get_out_desc()

void vo_postprocess_get_out_desc	(	struct vo_postprocess_state *	s,
		struct video_desc *	out,
		int *	display_mode,
		int *	out_frames_count )

Definition at line 259 of file vo_postprocess.c.

{
        if (s == NULL) {
                return;
        }
        struct vo_postprocess_state_single *state = simple_linked_list_last(s->postprocessors);
        state->funcs->get_out_desc(state->state, out, display_mode, out_frames_count);
}

References vo_postprocess_state::postprocessors, simple_linked_list_last(), and state.

Referenced by display_reconfigure(), and restrict_returned_codecs().

Here is the call graph for this function:

vo_postprocess_get_property()

bool vo_postprocess_get_property	(	struct vo_postprocess_state *	s,
		int	property,
		void *	val,
		size_t *	len )

Todo

This is not corrrect in a generic case - the codec may be acceptable for first filter but the output of the filter may be unacceptable for the following filter (or later on).

Definition at line 268 of file vo_postprocess.c.

{
        if (s == NULL) {
                return false;
        }
        assert(s->magic == MAGIC);
 
        if (simple_linked_list_size(s->postprocessors) == 1 || property == VO_PP_DOES_CHANGE_TILING_MODE) {
                struct vo_postprocess_state_single *state = simple_linked_list_last(s->postprocessors);
                assert(state->magic == MAGIC_SINGLE);
                return state->funcs->get_property(state->state, property, val, len);
        }
 
        if (property == VO_PP_PROPERTY_CODECS) {
                struct vo_postprocess_state_single *state = simple_linked_list_first(s->postprocessors);
                assert(state->magic == MAGIC_SINGLE);
                return state->funcs->get_property(state->state, property, val, len);
        }
 
        return false;
}

References len, MAGIC, vo_postprocess_state::magic, MAGIC_SINGLE, vo_postprocess_state::postprocessors, property, simple_linked_list_first(), simple_linked_list_last(), simple_linked_list_size(), state, val, VO_PP_DOES_CHANGE_TILING_MODE, and VO_PP_PROPERTY_CODECS.

Referenced by display_ctl_property(), and display_reconfigure().

Here is the call graph for this function:

vo_postprocess_getf()

struct video_frame * vo_postprocess_getf

(

struct vo_postprocess_state *

s

)

Definition at line 188 of file vo_postprocess.c.

{
        if (s == NULL) {
                return NULL;
        }
 
        struct video_frame *out = NULL;
 
        for(void *it = simple_linked_list_it_init(s->postprocessors); it != NULL; ) {
                struct vo_postprocess_state_single *state = simple_linked_list_it_next(&it);
                state->f = state->funcs->getf(state->state);
                if (state->f == NULL) {
                        simple_linked_list_it_destroy(it);
                        return NULL;
                }
                if (out == NULL) {
                        out = state->f;
                }
        }
 
        return out;
}

References vo_postprocess_state::postprocessors, simple_linked_list_it_destroy(), simple_linked_list_it_init(), simple_linked_list_it_next(), and state.

Referenced by display_get_frame().

Here is the call graph for this function:

vo_postprocess_init()

struct vo_postprocess_state * vo_postprocess_init

(

const char *

config_string

)

Definition at line 128 of file vo_postprocess.c.

{
        if (!config_string) {
                return NULL;
        }
 
        if (strcmp(config_string, "help") == 0 || strcmp(config_string, "fullhelp") == 0) {
                show_vo_postprocess_help(strcmp(config_string, "fullhelp") == 0);
                return NULL;
        }
 
        struct vo_postprocess_state *s = (struct vo_postprocess_state *) malloc(sizeof(struct vo_postprocess_state));
        s->magic = MAGIC;
        s->postprocessors = simple_linked_list_init();
 
        if (!init(s, config_string)) {
                vo_postprocess_done(s);
                return NULL;
        }
 
        return s;
}

References init(), MAGIC, vo_postprocess_state::magic, vo_postprocess_state::postprocessors, show_vo_postprocess_help(), simple_linked_list_init(), and vo_postprocess_done().

Referenced by initialize_video_display(), and process_message().

Here is the call graph for this function:

vo_postprocess_reconfigure()

bool vo_postprocess_reconfigure	(	struct vo_postprocess_state *	s,
		struct video_desc	desc )

Definition at line 152 of file vo_postprocess.c.

{
        if (s == NULL) {
                return false;
        }
 
        bool filter_complex = false;
 
        for(void *it = simple_linked_list_it_init(s->postprocessors); it != NULL; ) {
                struct vo_postprocess_state_single *state = simple_linked_list_it_next(&it);
                const bool ret = state->funcs->reconfigure(state->state, desc);
                if (!ret) {
                        simple_linked_list_it_destroy(it);
                        return false;
                }
                // get desc for next iteration
                int display_mode = 0;
                int out_frames_count = 0;
                state->funcs->get_out_desc(state->state, &desc, &display_mode, &out_frames_count);
 
                // check if convert is simple (doesn't change display mode and out_fr_count == 1); if not, only one filter allowed
                if (display_mode != DISPLAY_PROPERTY_VIDEO_MERGED || out_frames_count != 1) {
                        filter_complex = true;
                }
        }
 
        if (filter_complex && simple_linked_list_size(s->postprocessors) > 1) {
                log_msg(LOG_LEVEL_ERROR, MOD_NAME "One of postprocessors is complex (changing properties) and "
                                "cannot be used in filter chain (more postprocessors)!\n");
                return false;
        }
 
        return true;
}

References desc, DISPLAY_PROPERTY_VIDEO_MERGED, LOG_LEVEL_ERROR, log_msg(), MOD_NAME, vo_postprocess_state::postprocessors, simple_linked_list_it_destroy(), simple_linked_list_it_init(), simple_linked_list_it_next(), simple_linked_list_size(), and state.

Referenced by display_reconfigure(), and restrict_returned_codecs().

Here is the call graph for this function: