git.sesse.net Git - mlt/blob - src/modules/gtk2/filter_dynamictext.yml

   1 schema_version: 0.1
   2 type: filter
   3 identifier: dynamictext
   4 title: Dynamic text
   5 version: 1
   6 copyright: Ushodaya Enterprises Limited
   7 creator: Brian Matherly
   8 license: LGPLv2.1
   9 language: en
  10 tags:
  11   - Video
  12 description: Overlay dynamic text onto the video
  13 notes: >
  14   The dynamic text filter will search for keywords in the text to be overlayed
  15   and will replace those keywords on a frame-by-frame basis.
  16
  17 parameters:
  18   - identifier: argument
  19     title: Dynamic text
  20     type: string
  21     description: |
  22       The text to overlay. May include keywords enclosed in "#".
  23       Keywords include:
  24         * #timecode# - timecode of the frame (based on framerate and position)
  25         * #frame#    - frame number of the frame
  26         * #filedate# - modification date of the file
  27       Keywords may also be any frame property (e.g. #meta.media.0.codec.frame_rate#)
  28       The # may be escaped with "\".
  29     required: yes
  30     readonly: no
  31     default: > #trick to escape "#" character
  32       #timecode#
  33     widget: text
  34   - identifier: geometry
  35     title: Geometry
  36     type: geometry
  37     description: A set of X/Y coordinates by which to adjust the text.
  38     default: 0%/0%:100%x100%:100
  39   - identifier: font
  40     title: Font
  41     type: string
  42     description: The typeface to use
  43     default: Sans 48
  44     readonly: no
  45     mutable: yes
  46     widget: font
  47   - identifier: weight
  48     title: Font weight
  49     type: integer
  50     description: The weight of the font.
  51     minimum: 100
  52     maximum: 900
  53     default: 400
  54     readonly: no
  55     mutable: yes
  56     widget: spinner
  57   - identifier: fgcolour
  58     title: Foreground color
  59     type: string
  60     description: an RGBA colour specification of the text (i.e. 0xrrggbbaa)
  61     default: 0x000000ff
  62     readonly: no
  63     mutable: yes
  64     widget: color
  65   - identifier: bgcolour
  66     title: Background color
  67     type: string
  68     description: an RGBA colour of the background rectangle (i.e. 0xrrggbbaa)
  69     default: 0x00000020
  70     readonly: no
  71     mutable: yes
  72     widget: color