Documentation:Format String - Revision history

DoesItReallyMatter: /* Source code */ Explain b_empty_if_na

2019-04-04T03:03:33Z

Source code: Explain b_empty_if_na

← Older revision		Revision as of 03:03, 4 April 2019
Line 66:		Line 66:
	===Source code===		===Source code===
	If you want to know how this works, check out {{VLCSourceFile\|src/text/strings.c}} (search for <code>vlc_strfinput</code>)		If you want to know how this works, check out {{VLCSourceFile\|src/text/strings.c}} (search for <code>vlc_strfinput</code>)

			The variable <var>b_empty_if_na</var> refers to the leading space feature: {{Commitdiff\|3cc651e520ccb3106097e3f0167cc8c26f23e36c\|l=Add option to format strings to prevent displaying dashes if the meta info was unavailable (ie: if time is unavailable, "$T" will display "--:--:--" while "$ T" won't display anything). This is of course completely untested :)}}

	{{Documentation}}		{{Documentation}}

DoesItReallyMatter: /* Input meta */ Z was added in 697d7cd50c411ba3efc74091fb87aa922cde45f9 / 1c81c0863ba03ec8022aed8a8e3bac81884dd509 and o in ee5301b540900fbd64acecea711f74d080b048c0

2019-04-03T07:13:02Z

Input meta: Z was added in 697d7cd50c411ba3efc74091fb87aa922cde45f9 / 1c81c0863ba03ec8022aed8a8e3bac81884dd509 and o in ee5301b540900fbd64acecea711f74d080b048c0

← Older revision		Revision as of 07:13, 3 April 2019
Line 37:		Line 37:
	* $l : language		* $l : language
	* $n : track number		* $n : track number
			* $o : track total
	* $p : now playing		* $p : now playing
	* $r : rating		* $r : rating
Line 57:		Line 58:
	* $U : publisher		* $U : publisher
	* $V : volume		* $V : volume
			* $Z : now playing (artist - title)
	* $_ : new line		* $_ : new line
	* $<any other char> : <any other char> (for example: $$ transforms to $)		* $<any other char> : <any other char> (for example: $$ transforms to $)

DoesItReallyMatter: /* Source code */ The function name seems to have changed from str_format_meta to vlc_strfinput

2019-04-03T06:54:17Z

Source code: The function name seems to have changed from str_format_meta to vlc_strfinput

← Older revision		Revision as of 06:54, 3 April 2019
Line 63:		Line 63:

	===Source code===		===Source code===
	If you want to know how this works, check out {{VLCSourceFile\|src/text/strings.c}} (~~str_format_meta function~~)		If you want to know how this works, check out {{VLCSourceFile\|src/text/strings.c}} (search for <code>vlc_strfinput</code>)

	{{Documentation}}		{{Documentation}}

DoesItReallyMatter: /* Source code */ Link

2019-04-03T06:52:38Z

Source code: Link

← Older revision		Revision as of 06:52, 3 April 2019
Line 63:		Line 63:

	===Source code===		===Source code===
	If you want to know how this works, check out src\text\strings.c (str_format_meta function)~~[http://git.videolan.org/?p=vlc.git;a=blob;f=src/text/strings.c]~~		If you want to know how this works, check out {{VLCSourceFile\|src/text/strings.c}} (str_format_meta function)

	{{Documentation}}		{{Documentation}}

EPirat: /* Input meta */ Correct information about what will printed in case of empty times, for both cases, as else the example is a bit useless.

2015-10-22T11:41:53Z

Input meta: Correct information about what will printed in case of empty times, for both cases, as else the example is a bit useless.

← Older revision		Revision as of 11:41, 22 October 2015
Line 60:		Line 60:
	* $<any other char> : <any other char> (for example: $$ transforms to $)		* $<any other char> : <any other char> (for example: $$ transforms to $)

	You can insert a space between the $ sign and the character to tell it to not display anything if the meta data isn't available. For example: $ T instead will display "" if no time is available ~~while $T~~ would display something like "01_22_13" (for a snapshot from one hour, 22 minutes and 13 seconds in a video).		You can insert a space between the $ sign and the character to tell it to not display anything if the meta data isn't available. For example: <code>$ T</code> instead will display "" while <code>$T</code> would display "--:--:--", if no time is available. If a time is available, it would display something like "01_22_13" (for a snapshot from one hour, 22 minutes and 13 seconds in a video).

	===Source code===		===Source code===

Courmisch: Document snapshot-path too

2014-02-09T19:06:45Z

Document snapshot-path too

← Older revision		Revision as of 19:06, 9 February 2014
Line 5:		Line 5:
	Starting with [[VLC media player]] 0.9.0, the following options specify a character formatted time string, rather than just a plain character string:		Starting with [[VLC media player]] 0.9.0, the following options specify a character formatted time string, rather than just a plain character string:
	* --marq-marquee		* --marq-marquee
			* --snapshot-path
	* --snapshot-prefix		* --snapshot-prefix
	* --sout-file-format		* --sout-file-format
Line 23:		Line 24:
	VLC-specific meta-data expansions are available for the following options:		VLC-specific meta-data expansions are available for the following options:
	* --input-title-format		* --input-title-format
			* --snapshot-path (in version 2.2.0 and later)
	* --snapshot-prefix (in version 2.2.0 and later)		* --snapshot-prefix (in version 2.2.0 and later)

Courmisch at 19:03, 9 February 2014

2014-02-09T19:03:28Z

← Older revision		Revision as of 19:03, 9 February 2014
Line 3:		Line 3:
	== Time ==		== Time ==

	Starting with [[VLC media player]] 0.9.0, the following ~~option~~ specify a character formatted time string, rather than just a plain character string:		Starting with [[VLC media player]] 0.9.0, the following options specify a character formatted time string, rather than just a plain character string:
	* --marq-marquee		* --marq-marquee
	* --snapshot-prefix		* --snapshot-prefix
Line 21:		Line 21:
	==Input meta==		==Input meta==

	~~The following~~ VLC-specific meta-data expansions are available for the --input-title-format ~~option, and since~~ version 2.2.0~~, for the --snapshot-prefix option as well~~:		VLC-specific meta-data expansions are available for the following options:
			* --input-title-format
			* --snapshot-prefix (in version 2.2.0 and later)

			The following expansion are performed:
	* $a : artist		* $a : artist
	* $b : album		* $b : album

Courmisch: Update to 2.2.0

2014-02-09T19:01:21Z

Update to 2.2.0

← Older revision		Revision as of 19:01, 9 February 2014
Line 21:		Line 21:
	==Input meta==		==Input meta==

	The following VLC-specific meta-data expansions are available for the --input-title-format option:		The following VLC-specific meta-data expansions are available for the --input-title-format option, and since version 2.2.0, for the --snapshot-prefix option as well:
	* $a : artist		* $a : artist
	* $b : album		* $b : album

Courmisch: /* Input meta */

2013-11-20T18:53:02Z

Input meta

← Older revision		Revision as of 18:53, 20 November 2013
Line 21:		Line 21:
	==Input meta==		==Input meta==

	The following VLC-specific meta-data expansions are available for the --input-title-~~formato ption~~:		The following VLC-specific meta-data expansions are available for the --input-title-format option:
	* $a : artist		* $a : artist
	* $b : album		* $b : album

Courmisch: Correct / update to 2.1.0

2013-10-03T16:26:26Z

Correct / update to 2.1.0

← Older revision		Revision as of 16:26, 3 October 2013
Line 1:		Line 1:
	{{RightMenu\|Documentation TOC}}		{{RightMenu\|Documentation TOC}}

	Starting with [[VLC media player]] 0.9.0, ~~format string variables can be used with~~ the following ~~options~~:		== Time ==

			Starting with [[VLC media player]] 0.9.0, the following option specify a character formatted time string, rather than just a plain character string:
	* --marq-marquee		* --marq-marquee
	* --snapshot-path (when specifying a full image path, not a directory)
	* --snapshot-prefix		* --snapshot-prefix
	* --~~image~~-~~out~~-~~prefix (or --scene-prefix in 1.0.0 and newer)~~		* --sout-file-format
	* --~~msn~~-~~format (windows only)~~		* --sout-livehttp-index
	* file access output dst/url (like in std{access=file,mux=ts,dst='''THIS'''})

	~~There are two kinds of format string variables: time variables and meta variables.~~

	~~==Time==~~

	Time variables are those defined by the '''strftime''' C function. ~~Those include~~:		Time variables are those defined by the '''strftime''' C function. The following expansions are most common:
	* %Y : year		* %Y : year
	* %m : month		* %m : month
Line 20:		Line 16:
	* %M : minute		* %M : minute
	* %S : second		* %S : second
	~~For an extensive list have a look at [http://www.hmug.org/man/3/strftime.php man strftime].~~

	==~~Meta~~==		For an extensive list have a look at [http://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html] (or the strftime manual page on Unix systems).

			==Input meta==

	~~Meta variables are~~ VLC specific~~. The complete list is~~:		The following VLC-specific meta-data expansions are available for the --input-title-formato ption:
	* $a : artist		* $a : artist
	* $b : album		* $b : album
Line 30:		Line 27:
	* $d : description		* $d : description
	* $e : encoded by		* $e : encoded by
	* $f : frame count		* $f : total decoded frame count (since VLC started)
	* $g : genre		* $g : genre
	* $l : language		* $l : language
	* $n : track ~~num~~		* $n : track number
	* $p : now playing		* $p : now playing
	* $r : rating		* $r : rating
Line 59:		Line 56:
	You can insert a space between the $ sign and the character to tell it to not display anything if the meta data isn't available. For example: $ T instead will display "" if no time is available while $T would display something like "01_22_13" (for a snapshot from one hour, 22 minutes and 13 seconds in a video).		You can insert a space between the $ sign and the character to tell it to not display anything if the meta data isn't available. For example: $ T instead will display "" if no time is available while $T would display something like "01_22_13" (for a snapshot from one hour, 22 minutes and 13 seconds in a video).

	==Source code==		===Source code===
	If you want to know how this works, check out src\text\strings.c (str_format_meta function)[http://git.videolan.org/?p=vlc.git;a=blob;f=src/text/strings.c]		If you want to know how this works, check out src\text\strings.c (str_format_meta function)[http://git.videolan.org/?p=vlc.git;a=blob;f=src/text/strings.c]

	{{Documentation}}		{{Documentation}}