es_format.c File Reference

Include dependency graph for es_format.c:

Functions
void	video_format_Setup (video_format_t *p_fmt, vlc_fourcc_t i_chroma, int i_width, int i_height, int i_visible_width, int i_visible_height, int i_sar_num, int i_sar_den)
	It will fill up a video_format_t using the given arguments.
void	video_format_CopyCrop (video_format_t *p_dst, const video_format_t *p_src)
	It will copy the crop properties from a video_format_t to another.
void	video_format_ScaleCropAr (video_format_t *p_dst, const video_format_t *p_src)
	It will compute the crop/ar properties when scaling.
static void	transform_GetBasicOps (video_transform_t transform, unsigned *restrict angle, bool *restrict hflip)
static video_transform_t	transform_FromBasicOps (unsigned angle, bool hflip)
video_transform_t	video_format_GetTransform (video_orientation_t src, video_orientation_t dst)
	Returns the operation required to transform src into dst.
void	video_format_TransformBy (video_format_t *fmt, video_transform_t transform)
	This function applies the transform operation to fmt.
void	video_format_TransformTo (video_format_t *restrict fmt, video_orientation_t dst_orientation)
void	video_format_ApplyRotation (video_format_t *restrict out, const video_format_t *restrict in)
bool	video_format_IsSameChroma (const video_format_t *f1, const video_format_t *f2)
	Checks whether the video formats have the same chroma and mask.
bool	video_format_IsSimilar (const video_format_t *f1, const video_format_t *f2)
	This function will check if the first video format is similar to the second one.
void	video_format_LogDifferences (struct vlc_logger *log, const char *name_a, const video_format_t *a, const char *name_b, const video_format_t *b)
	Log differences between 2 video format.
void	video_format_Print (vlc_object_t *p_this, const char *psz_text, const video_format_t *fmt)
	It prints details about the given video_format_t.
void	es_format_Init (es_format_t *fmt, int i_cat, vlc_fourcc_t i_codec)
	This function will initialize a es_format_t structure.
void	es_format_InitFromVideo (es_format_t *p_es, const video_format_t *p_fmt)
	This function will initialize a es_format_t structure from a video_format_t.
int	es_format_Copy (es_format_t *restrict dst, const es_format_t *src)
void	es_format_Clean (es_format_t *fmt)
	This function will clean up a es_format_t and release all associated resources.
bool	es_format_IsSimilar (const es_format_t *p_fmt1, const es_format_t *p_fmt2)
	This function will check if the first ES format is similar to the second one.
void	es_format_LogDifferences (struct vlc_logger *log, const char *name_a, const es_format_t *a, const char *name_b, const es_format_t *b)
	Log differences between 2 ES format.

Variables
static const char *	orient_to_string []

Function Documentation

es_format_Clean()

void es_format_Clean

(

es_format_t *

fmt

)

This function will clean up a es_format_t and release all associated resources.

You can call it multiple times on the same structure.

References es_format_Init(), es_format_t::i_cat, es_format_t::i_extra, es_format_t::i_extra_languages, es_format_t::p_extra, es_format_t::p_extra_languages, extra_languages_t::psz_description, es_format_t::psz_description, subs_format_t::psz_encoding, extra_languages_t::psz_language, es_format_t::psz_language, SPU_ES, es_format_t::subs, UNKNOWN_ES, es_format_t::video, VIDEO_ES, and video_format_Clean().

Referenced by ChangeFilters(), CmdCleanAdd(), CmdCleanControl(), CreateDecoder(), decoder_Clean(), DecoderSendSubstream(), DecoderThread_Reload(), DecoderUpdateFormatLocked(), DeleteConverter(), DeleteDecoder(), demux_PacketizerDestroy(), demux_PacketizerNew(), es_format_Change(), EsOutAddLocked(), EsOutDestroyDecoder(), EsOutEsUpdateFmt(), EsOutSend(), EsOutVaControlLocked(), EsRelease(), filter_chain_AppendInner(), filter_chain_Delete(), filter_chain_DeleteFilter(), filter_chain_Reset(), image_HandlerDelete(), ImageConvert(), ImageRead(), ImageReadUrl(), ImageWrite(), input_item_Release(), input_item_UpdateTracksInfo(), LoadDecoder(), ModuleThread_UpdateVideoFormat(), rtp_opus_init(), sout_MuxAddStream(), sout_MuxDeleteStream(), vlc_encoder_Destroy(), vlc_player_track_priv_Delete(), vlc_player_track_priv_Update(), vlc_subdec_desc_Clean(), and VoutSetupConverter().

es_format_Copy()

int es_format_Copy	(	es_format_t *restrict	dst,
		const es_format_t *	src
	)

References es_format_t::i_cat, es_format_t::i_extra, es_format_t::i_extra_languages, likely, es_format_t::p_extra, es_format_t::p_extra_languages, extra_languages_t::psz_description, es_format_t::psz_description, subs_format_t::psz_encoding, extra_languages_t::psz_language, es_format_t::psz_language, SPU_ES, strdup(), es_format_t::subs, unlikely, es_format_t::video, VIDEO_ES, video_format_Copy(), VLC_ENOMEM, and VLC_SUCCESS.

Referenced by CmdInitAdd(), CmdInitControl(), CreateConverter(), decoder_Init(), DecoderThread_Reload(), DecoderUpdateFormatLocked(), EsOutAddLocked(), EsOutEsUpdateFmt(), EsOutVaControlLocked(), filter_chain_AppendInner(), filter_chain_Reset(), GetStatusLocked(), ImageRead(), ImageWrite(), input_item_UpdateTracksInfo(), sout_MuxAddStream(), vlc_player_track_priv_New(), and vlc_player_track_priv_Update().

es_format_Init()

void es_format_Init	(	es_format_t *	fmt,
		int	i_cat,
		vlc_fourcc_t	i_codec
	)

This function will initialize a es_format_t structure.

References es_format_t::b_packetized, ES_PRIORITY_SELECTABLE_MIN, es_format_t::i_cat, es_format_t::i_codec, i_codec, es_format_t::i_id, es_format_t::i_level, es_format_t::i_priority, es_format_t::i_profile, es_format_t::p_extra, es_format_t::p_extra_languages, es_format_t::psz_description, es_format_t::psz_language, es_format_t::video, VIDEO_ES, and video_format_Init().

Referenced by CreateDecoder(), decoder_Init(), DecoderSendSubstream(), demux_PacketizerNew(), es_format_Change(), es_format_Clean(), es_format_InitFromVideo(), EsOutAddLocked(), filter_chain_NewInner(), filter_NewBlend(), GetCCDescLocked(), gsm_init(), ImageConvert(), ImageReadUrl(), ImageWrite(), qcelp_init(), rtp_ac3_begin(), rtp_g722_init(), rtp_g726_init(), rtp_h264_init(), rtp_h265_init(), rtp_mpa_init(), rtp_mpeg4a_init(), rtp_mpeg4v_init(), rtp_mpv_init(), rtp_opus_init(), rtp_pcm_init(), rtp_raw_begin(), SpuRenderCreateAndLoadScale(), SpuRenderCreateAndLoadText(), and xiph_decode().

es_format_InitFromVideo()

void es_format_InitFromVideo	(	es_format_t *	p_es,
		const video_format_t *	p_fmt
	)

This function will initialize a es_format_t structure from a video_format_t.

References es_format_Init(), video_format_t::i_chroma, es_format_t::video, VIDEO_ES, and video_format_Copy().

Referenced by ChangeFilters(), CreateEncoder(), ImageConvert(), ImageWrite(), and VoutSetupConverter().

es_format_IsSimilar()

bool es_format_IsSimilar	(	const es_format_t *	p_fmt1,
		const es_format_t *	p_fmt2
	)

This function will check if the first ES format is similar to the second one.

All descriptive fields are ignored.

References es_format_t::audio, AUDIO_ES, audio_format_t::channel_type, es_format_t::i_cat, audio_format_t::i_chan_mode, audio_format_t::i_channels, video_format_t::i_chroma, es_format_t::i_codec, audio_format_t::i_format, audio_format_t::i_physical_channels, es_format_t::i_profile, audio_format_t::i_rate, SPU_ES, es_format_t::video, VIDEO_ES, video_format_IsSimilar(), and vlc_fourcc_GetCodec().

Referenced by ChangeFilters(), and DecoderThread_ProcessInput().

es_format_LogDifferences()

void es_format_LogDifferences	(	struct vlc_logger *	log,
		const char *	name_a,
		const es_format_t *	a,
		const char *	name_b,
		const es_format_t *	b
	)

Log differences between 2 ES format.

The difference checks the same fields as es_format_IsSimilar

References es_format_t::audio, AUDIO_ES, audio_format_t::channel_type, es_format_t::i_cat, audio_format_t::i_chan_mode, audio_format_t::i_channels, video_format_t::i_chroma, es_format_t::i_codec, audio_format_t::i_format, audio_format_t::i_physical_channels, es_format_t::i_profile, audio_format_t::i_rate, es_format_t::video, VIDEO_ES, video_format_LogDifferences(), vlc_debug, and vlc_fourcc_GetCodec().

Referenced by ChangeFilters(), and DecoderThread_ProcessInput().

transform_FromBasicOps()

static video_transform_t transform_FromBasicOps ( unsigned  angle, bool  hflip  )

static

References TRANSFORM_ANTI_TRANSPOSE, TRANSFORM_HFLIP, TRANSFORM_IDENTITY, TRANSFORM_R180, TRANSFORM_R270, TRANSFORM_R90, TRANSFORM_TRANSPOSE, and TRANSFORM_VFLIP.

Referenced by video_format_GetTransform().

transform_GetBasicOps()

static void transform_GetBasicOps ( video_transform_t  transform, unsigned *restrict  angle, bool *restrict  hflip  )

static

References ORIENT_IS_MIRROR, transform(), TRANSFORM_ANTI_TRANSPOSE, TRANSFORM_HFLIP, TRANSFORM_IDENTITY, TRANSFORM_R180, TRANSFORM_R270, TRANSFORM_R90, TRANSFORM_TRANSPOSE, TRANSFORM_VFLIP, and vlc_assert_unreachable.

Referenced by video_format_GetTransform(), and video_format_TransformBy().

video_format_ApplyRotation()

void video_format_ApplyRotation	(	video_format_t *restrict	out,
		const video_format_t *restrict	in
	)

References ORIENT_NORMAL, and video_format_TransformTo().

Referenced by PrerenderPicture(), vout_display_PlacePicture(), and vout_display_TranslateCoordinates().

video_format_CopyCrop()

void video_format_CopyCrop	(	video_format_t *	p_dst,
		const video_format_t *	p_src
	)

It will copy the crop properties from a video_format_t to another.

References video_format_t::i_visible_height, video_format_t::i_visible_width, video_format_t::i_x_offset, and video_format_t::i_y_offset.

Referenced by picture_Setup(), video_format_CopyCropAr(), vout_snapshot_Set(), and vout_UpdateDisplaySourceProperties().

video_format_GetTransform()

video_transform_t video_format_GetTransform	(	video_orientation_t	src,
		video_orientation_t	dst
	)

Returns the operation required to transform src into dst.

References transform_FromBasicOps(), transform_GetBasicOps(), and transform_Inverse().

Referenced by video_format_TransformTo().

video_format_IsSameChroma()

bool video_format_IsSameChroma	(	const video_format_t *	f1,
		const video_format_t *	f2
	)

Checks whether the video formats have the same chroma and mask.

References video_format_t::i_chroma.

Referenced by filter_chain_GetVideoCtxOut(), filter_ConfigureBlend(), ImageConvert(), ImageRead(), ImageWrite(), PrerenderPicture(), SourceConverterBuffer(), subpicture_region_ForPicture(), and video_format_IsSimilar().

video_format_IsSimilar()

bool video_format_IsSimilar	(	const video_format_t *	f1,
		const video_format_t *	f2
	)

This function will check if the first video format is similar to the second one.

References video_format_t::i_height, video_format_t::i_sar_den, video_format_t::i_sar_num, video_format_t::i_visible_height, video_format_t::i_visible_width, video_format_t::i_width, video_format_t::i_x_offset, video_format_t::i_y_offset, video_format_t::multiview_mode, video_format_t::orientation, and video_format_IsSameChroma().

Referenced by es_format_IsSimilar(), OSDEpgUpdate(), OSDTextUpdate(), OSDWidgetUpdate(), spu_PrerenderWake(), and vout_ChangeSource().

video_format_LogDifferences()

void video_format_LogDifferences	(	struct vlc_logger *	log,
		const char *	name_a,
		const video_format_t *	a,
		const char *	name_b,
		const video_format_t *	b
	)

Log differences between 2 video format.

The difference checks the same fields as video_format_IsSimilar

References video_format_t::i_chroma, video_format_t::i_height, video_format_t::i_sar_den, video_format_t::i_sar_num, video_format_t::i_visible_height, video_format_t::i_visible_width, video_format_t::i_width, video_format_t::i_x_offset, video_format_t::i_y_offset, video_format_t::multiview_mode, video_format_t::orientation, and vlc_debug.

Referenced by es_format_LogDifferences(), and vout_ChangeSource().

video_format_Print()

void video_format_Print	(	vlc_object_t *	p_this,
		const char *	psz_text,
		const video_format_t *	fmt
	)

It prints details about the given video_format_t.

References ARRAY_SIZE, video_format_t::i_chroma, video_format_t::i_height, video_format_t::i_sar_den, video_format_t::i_sar_num, video_format_t::i_visible_height, video_format_t::i_visible_width, video_format_t::i_width, video_format_t::i_x_offset, video_format_t::i_y_offset, msg_Dbg, orient_to_string, and video_format_t::orientation.

Referenced by vout_Start(), and vout_UpdateSourceCrop().

video_format_ScaleCropAr()

void video_format_ScaleCropAr	(	video_format_t *	p_dst,
		const video_format_t *	p_src
	)

It will compute the crop/ar properties when scaling.

References video_format_t::i_height, video_format_t::i_sar_den, video_format_t::i_sar_num, video_format_t::i_visible_height, video_format_t::i_visible_width, video_format_t::i_width, video_format_t::i_x_offset, video_format_t::i_y_offset, and vlc_ureduce().

video_format_Setup()

void video_format_Setup	(	video_format_t *	p_fmt,
		vlc_fourcc_t	i_chroma,
		int	i_width,
		int	i_height,
		int	i_visible_width,
		int	i_visible_height,
		int	i_sar_num,
		int	i_sar_den
	)

It will fill up a video_format_t using the given arguments.

Note that the video_format_t must already be initialized.

References video_format_t::i_chroma, video_format_t::i_height, video_format_t::i_sar_den, video_format_t::i_sar_num, video_format_t::i_visible_height, video_format_t::i_visible_width, video_format_t::i_width, video_format_t::i_x_offset, video_format_t::i_y_offset, ORIENT_NORMAL, video_format_t::orientation, VIDEO_ES, vlc_fourcc_GetCodec(), and vlc_ureduce().

Referenced by picture_New(), and picture_Setup().

video_format_TransformBy()

void video_format_TransformBy	(	video_format_t *	fmt,
		video_transform_t	transform
	)

This function applies the transform operation to fmt.

References video_format_t::i_height, video_format_t::i_sar_den, video_format_t::i_sar_num, video_format_t::i_visible_height, video_format_t::i_visible_width, video_format_t::i_width, video_format_t::i_x_offset, video_format_t::i_y_offset, ORIENT_ANTI_TRANSPOSED, ORIENT_HFLIPPED, ORIENT_IS_SWAP, ORIENT_NORMAL, ORIENT_ROTATED_180, ORIENT_ROTATED_270, ORIENT_ROTATED_90, ORIENT_TRANSPOSED, ORIENT_VFLIPPED, video_format_t::orientation, transform(), and transform_GetBasicOps().

Referenced by video_format_TransformTo().

video_format_TransformTo()

void video_format_TransformTo	(	video_format_t *restrict	fmt,
		video_orientation_t	dst_orientation
	)

References transform(), video_format_GetTransform(), and video_format_TransformBy().

Referenced by video_format_ApplyRotation().

Variable Documentation

orient_to_string

const char* orient_to_string[]

static

Initial value:

=
{
    [ORIENT_NORMAL]             = "normal",
    [ORIENT_TRANSPOSED]         = "transposed",
    [ORIENT_ANTI_TRANSPOSED]    = "antitransposed",
    [ORIENT_HFLIPPED]           = "hflip",
    [ORIENT_VFLIPPED]           = "vflip",
    [ORIENT_ROTATED_180]        = "80",
    [ORIENT_ROTATED_270]        = "270",
    [ORIENT_ROTATED_90]         = "90",
}

Referenced by video_format_Print().