Documentation:Modules/logo

2011-02-24T11:57:12Z

Prividen:

{{Module|name=logo|type=Video subfilter|description=Overlays a logo on the video}}
{{Module|name=logo|type=Video output filter|description=Overlays a logo on the video}}

The logo filter can be used to add a logo on the video. This logo can be a static image or series of image which will be displayed alternatively. When used as a video output filter, you can move the logo with the mouse.

== Options ==

{{Option
|name=logo-file
|value=string
|description=Image to display. The full format is <image>[,<delay in ms>[,<alpha>]][;<image>[,<delay>[,<alpha>]]][;...]}}

{{Option
|name=logo-x
|value=integer
|default=0 (0.8.6d and prior: -1)
|description=X offset from upper left corner. (0.8.6d and prior: This is only if both logo-x and logo-y are positive)
}}

{{Option
|name=logo-y
|value=integer
|default=0
|description=Y offset from upper left corner. (0.8.6d and prior: This is only if both logo-x and logo-y are positive)
}}

{{Option
|name=logo-position
|value=integer
|default=5
|description=Logo position: 0=center, 1=left, 2=right, 4=top, 8=bottom, you can also use combinations of these values, eg 6 = top-right. (0.8.6d and prior: This is only used if logo-x or logo-y are negative)
}}

{{Option
|name=logo-opacity
|value=integer
|default=255
|description=Logo opacity. 0 is transparent, 255 is fully opaque.
}}

{{Option
|name=logo-delay
|value=integer
|default=1000
|description=Global delay in ms. Sets the duration each image will be displayed for in a loop iteration unless specified otherwise in the --logo-file option.
}}

{{Option
|name=logo-repeat
|value=integer
|default=-1
|description=Number of loops for the logo animation. -1 for continuous, 0 to disable.
}}

== Examples ==

Example command line use '''(VLC 0.9.0 and above)''':
% '''vlc --sub-filter "logo{file=cone.png,transparency=128}" somevideo.avi'''
: This command will display image cone.png in the video's upper right corner with 50% transparency.

% '''vlc --sub-filter "logo{file='cone1.png,2000,128;cone2.png,3000'}" somevideo.avi'''
: This command will display image cone1.png for 2 seconds with 50% transparency followed by image cone2.png for 3 seconds at default transparency and loop.

Example command line '''(All versions including VLC 8.6d and prior)''':
% '''vlc --sub-filter=logo --logo-file=cone.png --logo-transparency=128 somevideo.avi'''

{{Stub}}

{{Documentation}}

Documentation:Modules/marq

2011-02-24T11:54:46Z

Prividen:

{{Module|name=marq|type=Video subfilter|description=Overlays text on the video}}

The marq subfilter can be used to display text on a video.

== Options ==

{{Option
|name=marq-marquee
|value=string
|default=VLC
|description=Marquee text to display. Since VLC version 0.9.0 you can use [[Documentation:Play_HowTo/Format_String|format strings]] to display meta data and time information}}

{{Option
|name=marq-x
|value=integer
|default=0 (0.8.6d and prior: -1)
|description=X offset from upper left corner. (0.8.6d and prior: This is only if both marq-x and marq-y are positive)
}}

{{Option
|name=marq-y
|value=integer
|default=0
|description=Y offset from upper left corner. (0.8.6d and prior: This is only if both marq-x and marq-y are positive)
}}

{{Option
|name=marq-position
|value=integer
|default=5
|description=Marquee position: 0=center, 1=left, 2=right, 4=top, 8=bottom, you can also use combinations of these values, eg 6 = top-right. (0.8.6d and prior: This is only used if marq-x or marq-y are negative)
}}

{{Option
|name=marq-opacity
|value=integer
|default=255
|description=Marquee opacity. 0 is transparent, 255 is fully opaque.
}}

{{Option
|name=marq-color
|value=integer
|default=16777215 (0xFFFFFF, white)
|description=Marquee color. Use the decimal value of the HTML color code.
}}

{{Option
|name=marq-size
|value=integer
|default=-1
|description=Font size in pixels. -1 uses the default font size
}}

{{Option
|name=marq-timeout
|value=integer
|default=0
|description=Number of millitseconds the marquee must remain displayed. 0 means forever.
}}

{{Option
|name=marq-refresh
|value=integer
|default=1000
|description=Number of milliseconds between string updates. This is mainly useful when using meta data or time format string sequences.
}}

== Avalabile Format Variables ==

* Time related:
**%Y = year
**%m = month
**%d = day
**%H = hour
**%M = minute
**%S = second

*Meta data related:
**$a = artist
**$b = album
**$c = copyright
**$d = description
**$e = encoded by
**$g = genre
**$l = language
**$n = track num
**$p = now playing
**$r = rating
**$s = subtitles language
**$t = title
**$u = url
**$A = date
**$B = audio bitrate (in kb/s)
**$C = chapter
**$D = duration
**$F = full name with path
**$I = title
**$L = time left
**$N = name
**$O = audio language
**$P = position (in %)
**$R = rate
**$S = audio sample rate (in kHz)
**$T = time
**$U = publisher
**$V = volume
**$_ = new line

== Examples ==

Example command line use '''(VLC 0.9.0 and above)''':
% '''vlc --sub-filter "marq{marquee=\$t (\$P%%),color=16776960}:marq{marquee=%H:%M:%S,position=6}" somevideo.avi'''
% '''vlc --sub-filter 'marq{marquee=$t ($P%%),color=16776960}:marq{marquee=%H:%M:%S,position=6}' somevideo.avi'''
:This command line will show the stream's title ($t) and current position ($P) in the upper left corner and the current time in the upper right corner. Note that we have to escape $ characters when running this from command line in UNIX shells (this is why we use \$ instead of $). The second line uses single quotes to delimit the string so we don't need to escape the $ character.
:On windows the command line would be:
C:\Program Files\VideoLAN\VLC\>'''vlc.exe --sub-filter=marq{marquee=$t ($P%%),color=16776960}:marq{marquee=%H:%m%s,position=6} somevideo.avi'''

Example command line '''(All versions including VLC 8.6d and prior)''':
% '''vlc --sub-filter=marq --marq-marquee="Obvious Watermark" --marq-position=0 --marq-size=50 --marq-opacity=25 --marq-color=32768 somevideo.avi'''
:This command will show centered transparent green text. Text sized too large to fit the video window will not appear, and may crash VLC.

== See also ==
* [[Documentation:Modules/rss]]

{{Stub}}

{{Documentation}}

VideoLAN Wiki - User contributions [en]

Documentation:Modules/logo

Documentation:Modules/marq