title: Pango
media types:
Video
description: A title generator that uses the Pango international text layout and Freetype2 font renderer.
version: 2
creator: Dan Dennedy
copyright: Meltytech, LLC
license: LGPLv2.1
Supplying a filename with extension ".txt" causes the loader producer to load with pango. If the filename begins with "+" the pango producer interprets the filename as pango text. This is a shortcut to embed titles in melt commands. For MLT XML, it is recommended that you embed the title text in the property value. Pango has builtin scaling. It will rescale the originally rendered title to whatever the consumer requests. Therefore, it will lose its aspect ratio if so requested, and it is up to the consumer to request a proper width and height that maintains the image aspect. Environment variable MLT_PANGO_PRODUCER_CACHE could be used to override and increase the size of cached converted images of simultaneous use. Fontset used by pango producer loaded once. That behavior prevents using new fonts till process used pango producer been restarted. To force fontmap reload you need to send signal "fontmap-reload" to pango producer: { mlt_profile profile = mlt_profile_init("dv_pal"); mlt_producer producer = mlt_factory_producer(profile, "pango", NULL); mlt_events_fire(mlt_producer_properties(producer), "fontmap-reload", NULL ); mlt_producer_close(producer); mlt_profile_close(profile); };
title: File
description:
A text file containing Pango markup, see:
https://developer.gnome.org/pango/stable/PangoMarkupFormat.html
requires xml-like encoding special chars from:
<, >, & -to- <, >, &
type: string
readonly: no
required: no
widget: fileopen
title: Markup
description:
A string containing Pango markup see:
http://developer.gnome.org/doc/API/2.0/pango/PangoMarkupFormat.html
requires xml-like encoding special chars from:
<, >, & -to- <, >, &
type: string
readonly: no
required: no
widget: textbox
title: Foreground color
description:
A color value is a hexadecimal representation of RGB plus alpha channel as 0xrrggbbaa. Colors can also be the words: white, black, red, green, or blue. You can also use a HTML-style color values #rrggbb or #aarrggbb.
type: string
readonly: no
required: no
widget: color
title: Background color
description:
A color value is a hexadecimal representation of RGB plus alpha channel as 0xrrggbbaa. Colors can also be the words: white, black, red, green, or blue. You can also use a HTML-style color values #rrggbb or #aarrggbb.
type: string
readonly: no
required: no
widget: color
title: Outline color
description:
A color value is a hexadecimal representation of RGB plus alpha channel as 0xrrggbbaa. Colors can also be the words: white, black, red, green, or blue. You can also use a HTML-style color values #rrggbb or #aarrggbb.
type: string
readonly: no
required: no
widget: color
title: Outline Width
description:
The width of the outline in pixels.
type: string
readonly: no
required: no
minimum: 0
maximum: 3
default: 0
unit: pixels
widget: spinner
title: Paragraph alignment
description:
left, centre, right (also, numbers 0, 1 and 2 can be used respectively)
type: string
readonly: no
required: no
default: left
widget: combo
title: Padding
description:
The number of pixels to pad the background rectangle beyond edges of text.
type: integer
readonly: no
required: no
default: 0
unit: pixels
widget: spinner
title: Text
description:
A non-markup string in UTF-8 encoding
(can contain markup chars un-encoded)
type: string
readonly: no
required: no
widget: textbox
title: Font family
description:
The default typeface to use when not using markup.
type: string
readonly: no
required: no
default: Sans
widget: combo
title: Font size
description:
The size in pixels of the font to use when not using markup.
type: integer
readonly: no
required: no
default: 48
unit: pixels
widget: spinner
title: Font style
description:
The style of the font to use when not using markup.
type: string
readonly: no
required: no
default: normal
widget: combo
values:
title: Font weight
description:
The weight of the font.
type: integer
readonly: no
required: no
minimum: 100
maximum: 1000
default: 400
widget: spinner
title: Encoding
description:
The text encoding type of the input if not UTF-8. See 'iconv –list' for a list of possible inputs.
type: string
readonly: no
required: no
default: UTF-8
widget: combo
title: Real width
description:
The original, unscaled width of the rendered title.
type: integer
readonly: yes
required: no
unit: pixels
title: Real height
description:
The original, unscaled height of the rendered title.
type: integer
readonly: yes
required: no
unit: pixels
title: Width
description:
The last requested scaled image width.
type: integer
readonly: yes
required: no
unit: pixels
title: Height
description:
The last requested scaled image height.
type: integer
readonly: yes
required: no
unit: pixels
title: Sample aspect ratio
description:
Optionally override a (mis)detected aspect ratio
type: float
readonly: no
required: no
title: Rotation angle
description:
The angle of text rotation in degrees. Positive value is clockwise.
type: integer
readonly: no
required: no
default: 0
unit: degrees
widget: spinner
title: Width to crop
description:
Limit width of rendered image.
type: integer
readonly: no
required: no
default: 0
unit: pixels
widget: spinner
title: Fit width
description:
Scale pango layout to fit specified width.
type: integer
readonly: no
required: no
default: 0
unit: pixels
widget: spinner
title: Sets lines spacing
description:
Sets the amount of spacing between the lines of the layout.
type: integer
readonly: no
required: no
default: 0
widget: spinner
title: Font stretch
description:
The stretch feature of pango's font description. Possible values: 1 - ULTRA_CONDENSED 2 - EXTRA_CONDENSED 3 - CONDENSED 4 - SEMI_CONDENSED 5 - NORMAL 6 - SEMI_EXPANDED 7 - EXPANDED 8 - EXTRA_EXPANDED 9 - ULTRA_EXPANDED
type: integer
readonly: no
required: no
minimum: 0
maximum: 9
default: 4
widget: spinner
title: Sets the width to wrap to
description:
Sets the width to which the lines of the PangoLayout should wrap.
type: integer
readonly: no
required: no
default: 0
unit: pixels
widget: spinner
title: Sets the wrap mode
description:
Sets the wrap mode; the wrap mode only has effect if a 'wrap_width' is set. Possible values: 0 - wrap lines at word boundaries 1 - wrap lines at character boundaries 2 - wrap lines at word boundaries, but fall back to character boundaries if there is not enough space for a full word
type: integer
readonly: no
required: no
default: 0
widget: spinner
Subscribe to News via RSS.