title: GDK-PixBuf
media types:
Video
description: A still graphics to video generator using gdk-pixbuf
version: 2
creator: Dan Dennedy
copyright: Meltytech, LLC
license: LGPLv2.1
Pixbuf 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_PIXBUF_PRODUCER_CACHE could be used to to override /increase the number of cached converted images for simultaneous use.
title: File
description:
The name of a graphics file loadable by a gdk-pixbuf loader. See the output of gdk-pixbuf-query-loaders. Definitely png, jpeg, tiff, pnm, and xpm will work.
If "%" in filename, the filename is used with sprintf to generate a filename from a counter for multi-file/flipbook animation. The file sequence ends when numeric discontinuity >100.
If the file sequence does not begin within the count of 100 you can pass the begin property like a query string parameter, for example: anim-%04d.png?begin=1000.
If filename contains "/.all.", suffix with an extension to load all pictures with matching extension from a directory.
If filename contains the string "<svg", then pixbuf tries to load the filename as inline SVG XML, which is convenient for melt commands. If filename extension is .csv (format is: picture_filename;ttl), then pixbuf reads pictures and corresponding ttl from it, which is convenient for generating a slideshow with different image duration; in this case main ttl property is ignored.
type: string
readonly: no
required: yes
widget: fileopen
title: Begin
description:
When using an image sequence, this sets the starting number.
type: integer
readonly: no
required: no
minimum: 0
widget: spinner
title: Time-to-live
description:
How long (in frames) to repeat each picture in file sequences.
type: integer
readonly: no
required: no
minimum: 0
default: 25
widget: spinner
title: Real width
description:
The original, unscaled width of the rendered image.
type: integer
readonly: yes
required: no
title: Real height
description:
The original, unscaled height of the rendered image.
type: integer
readonly: yes
required: no
title: Width
description:
The last requested scaled image width.
type: integer
readonly: yes
required: no
title: Height
description:
The last requested scaled image height.
type: integer
readonly: yes
required: no
description:
Reload the file instead of using its cached image. This property automatically resets itself once it has been set 1 and processed.
type: integer
readonly: no
required: no
minimum: 0
maximum: 1
title: Disable auto-rotation
type: boolean
readonly: no
required: no
default: 0
widget: checkbox
title: Sample aspect ratio
description:
Optionally override a (mis)detected aspect ratio
type: float
readonly: no
required: no
title: Loop sequence of images indefinitively
description:
when 1 (default) loop sequences of images, when 0, play them only once
type: boolean
readonly: no
required: no
default: 1
widget: checkbox
title: Automatically compute length
description:
Whether to automatically compute the length and out point for an image sequence.
type: boolean
readonly: no
required: no
default: 0
widget: checkbox
Subscribe to News via RSS.