Documentation:Modules/kate

From VideoLAN Wiki
< Documentation:Modules
Revision as of 07:17, 17 May 2019 by DoesItReallyMatter (talk | contribs) (Add shortcut, misc.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Module: kate
Type Access demux
First VLC version 0.9.0
Last VLC version -
Operating system(s) all
Description Kate overlay decoder
Shortcut(s) kate

The help text for this module:

Kate is a codec for text and image based overlays.
The Tiger rendering library is needed to render complex Kate streams, but VLC can still render static text and image based subtitles if it is not available.
Note that changing settings below will not take effect until a new stream is played. This will hopefully be fixed soon.

Options

Basic

  • kate-formatted <boolean> : Kate streams allow for text formatting. VLC partly implements this, but you can choose to disable all formatting. Note that this has no effect if rendering via Tiger is enabled default value: enabled

Tiger

  • kate-use-tiger <boolean> : Kate streams can be rendered using the Tiger library. Disabling this will only render static text and bitmap based streams default value: enabled
  • kate-tiger-quality <float [0.0f .. 1.0f]> : Select rendering quality, at the expense of speed. 0 is fastest, 1 is highest quality default value: 1.0

Tiger rendering defaults

  • kate-tiger-default-font-desc <string> : Which font description to use if the Kate stream does not specify particular font parameters (name, size, etc) to use. A blank name (default) will let Tiger choose font parameters where appropriate
  • kate-tiger-default-font-effect <integer> : Add a font effect to text to improve readability against different backgrounds default value: 0
  • kate-tiger-default-font-effect-strength <float [0.0f .. 1.0f]> : How pronounced to make the chosen font effect (effect dependent) default value: 0.5
  • kate-tiger-default-font-color <integer> : Default font color to use if the Kate stream does not specify a particular font color to use default value: 0x00ffffff (white)
  • kate-tiger-default-font-alpha <integer [0x00 .. 0xff]> : Transparency of the default font color if the Kate stream does not specify a particular font color to use (0x00 is fully transparent, 0xff is fully opaque) default value: 0xff
  • kate-tiger-default-background-color <integer> : Default background color if the Kate stream does not specify a background color to use default value: 0x00ffffff (white)
  • kate-tiger-default-background-alpha <integer [0x00 .. 0xff]> : Transparency of the default background color if the Kate stream does not specify a particular background color to use (0x00 is fully transparent, 0xff is fully opaque) default value: 0x00

Source code