X-Git-Url: http://research.m1stereo.tv/gitweb?a=blobdiff_plain;f=docs%2Fservices.txt;h=6500f5ff831ca600b64f7a965812408c46a6986d;hb=d903958e230b9f8178e243be66cdc1d962d48598;hp=3a442f62a58a24e59b269cdad0872c8e0da3f22f;hpb=e3d91d2866e0bb32fb18a2eee633da13e5bb251f;p=melted diff --git a/docs/services.txt b/docs/services.txt index 3a442f6..6500f5f 100644 --- a/docs/services.txt +++ b/docs/services.txt @@ -28,26 +28,56 @@ Producers ffmpeg must be configured as --enable-shared and installed prior to compilation of mlt. - Oddities - - There seems to be a discrepancy between audio and video pts (time - stamps) which causes audio seeking to be unreliable in some cases. - If audio playback is broken, try adding discrepancy=3 as a - property. - - Not sure of the exact reasons, but am investigating. - Known Bugs - Fixed frame rate. Audio sync discrepancy with some content. Not all libavformat supported formats are seekable. ogg is currently broken. - Multiple mp3 uses in a single instance causes crash (patch - available on request - submitted to ffmpeg mailing list). mpeg seeking is inaccurate - doesn't seek to i-frames so you may get junk for a few frames. + fezzik + + Description + + A friendly giant that likes to rhyme and throw rocks + + Constructor Argument + + 'file' - produce a/v from file + + Initialisation Properties + + int in - in point + int out - out point + + all producer initialising properties + + Read Only Properties + + string resource - file location + + all producer read only properties + + Details + + This producer is has two roles: + + 1. it handles the mappings of all file names to the other + producers; + 2. it attaches normalising filters (rescale, resize and resample) + to the producers (when necessary). + + This producer simplifies many aspects of use. Essentially, it + ensures that a consumer will receive images and audio precisely as + they request them. + + Dependencies + + all. + + Known Bugs + + None. + ffmpeg Description @@ -150,8 +180,7 @@ Producers Known Bugs - Can be problematic with source NTSC DV files? really? yes - try - playing pond.dv... + Can be problematic with some NTSC DV files? mcmpeg @@ -211,8 +240,8 @@ Producers http://developer.gnome.org/doc/API/2.0/pango/PangoMarkupFormat.html - requires xml-like encoding special chars: <, >, & to <, >, & - int fgcolor - an rgba color specification of the text (i.e. 0xrrggbbaa) - int bgcolor - an rgba color of the background rectangle + string fgcolour - an rgba colour specification of the text (i.e. 0xrrggbbaa) + string bgcolour - an rgba colour of the background rectangle int align - paragraph alignment: 0 = left, 1 = center, 2 = right int pad - the number of pixels to pad the background rectangle beyond edges of text default 0 @@ -220,12 +249,6 @@ Producers string text - non-markup text (can contain markup chars un-encoded) string font - the default typeface to use when not using markup default "Sans 48" - int x - the horizontal position of the title on the frame - default 0 - int y - the vertical position of the title on the frame - default 0 - double mix - the overall opacity control of the generated title - default 1.0 Read Only Properties @@ -268,11 +291,6 @@ Producers PAL = 0, NTSC = 1 this determines proper pixel aspect ratio double ttl - how long (seconds) to repeat each picture in file sequences - int x - the horizontal offset from the left edge of the frame - int y - the vertical offset from the top edge of the frame - double mix - the opacity factor to apply to the second frame - (used in addition to alpha channel). - Read Only Properties @@ -399,7 +417,7 @@ Filters Description - Use ffmpeg executable to substitute audio stream. + Use ffmpeg executable to substitute audio stream. Constructor Argument @@ -455,7 +473,7 @@ Filters Description - Convert color image to greyscale + Convert colour image to greyscale Constructor Argument @@ -478,19 +496,20 @@ Filters none - resize + obscure Description - Image scaling and padding + Obscuring filter. Constructor Argument - scale - "affine" to use affine transform scaling, otherwise - center and pad. + none Initialisation Properties + string start - in the format X,Y:WxH[:PWxPY] + string end - in the format X,Y:WxH[:PWxPY] int in - in point int out - out point @@ -501,48 +520,30 @@ Filters Dependencies none - + Known Bugs none - volume - + resize + Description - Adjust an audio stream's volume level + Image scaling and padding Constructor Argument - gain - a string containing one of: - - a floating point value of the gain adjustment - - a numeric value with the suffix "dB" to adjust in terms of decibels - - "normalise" to normalise the volume to the target amplitude -12dBFS + scale - "affine" to use affine transform scaling, otherwise + center and pad. Initialisation Properties int in - in point int out - out point - int window - the number of video frames over which to smooth normalisation. - defaults to 75. - - Mutable Properties - - string gain - same as constructor argument above - string normalise - normalise the volume to the amplitude: - - a numeric value with the suffix "dB" to set amplitude in decibels - - a floating point value of the relative volume - - an unspecified value uses the default -12dBFS - - string limiter - limit all samples above: - - a numeric value with the suffix "dB" - - a floating point value ( dB = 20 * log10(x) ) - - an unspecified value uses the default -6dBFS + Read Only Properties - double max_gain - a floating point or decibel value of the maximum gain that - can be applied during normalisation. - - an unspecified value uses the default 20dB + none Dependencies @@ -602,6 +603,14 @@ Filters string interpolation - see constructor argument above + If a property "consumer_aspect_ratio" exists on the frame, then + rescaler normalises the producer's aspect ratio and maximises the + size of the frame, but may not produce the consumer's requested + dimension. Therefore, this option works best in conjunction with the + resize filter. This behavior can be disabled by another service by + either removing the property, setting it to zero, or setting + frame property "distort" to 1. + Dependencies libgdk_pixbuf-2.0, libglib-2.0, libgobject-2.0, libgmodule-2.0 @@ -610,6 +619,93 @@ Filters none + volume + + Description + + Adjust an audio stream's volume level + + Constructor Argument + + gain - a string containing one of: + - a floating point value of the gain adjustment + - a numeric value with the suffix "dB" to adjust in terms of decibels + - "normalise" to normalise the volume to the target amplitude -12dBFS + + Initialisation Properties + + int in - in point + int out - out point + int window - the number of video frames over which to smooth normalisation. + defaults to 75. + + Mutable Properties + + string gain - same as constructor argument above + + string normalise - normalise the volume to the amplitude: + - a numeric value with the suffix "dB" to set amplitude in decibels + - a floating point value of the relative volume + - an unspecified value uses the default -12dBFS + + string limiter - limit all samples above: + - a numeric value with the suffix "dB" + - a floating point value ( dB = 20 * log10(x) ) + - an unspecified value uses the default -6dBFS + + double max_gain - a floating point or decibel value of the maximum gain that + can be applied during normalisation. + - an unspecified value uses the default 20dB + + string end - a gain value just like the gain property above. + This causes the gain to be interpolated from 'gain' to 'end' + over the duration. + + int window - the size of the normalising smoothing buffer in video frame units. + - the smoothing buffer prevents erratic gain changes. + - the default value is 75 video frames. + + gain can be applied as a factor to the normalise amplitude! + + Dependencies + + none + + Known Bugs + + none + + watermark + + Description + + Add a watermark to the frames. + + Constructor Argument + + resource - the producer to use (ie: a .png) + + Initialisation Properties + + string resource - the producer to use + string factory - producer required for the resource ('fezzik') + string geometry - composite geometry + string distort - control scaling + int in - in point + int out - out point + + Mutable Properties + + none + + Dependencies + + mlt core modules and optionally, fezzik + + Known Bugs + + none + Transitions ----------- @@ -621,21 +717,14 @@ Transitions Constructor Argument - mix - see below + string start - X,Y:WxH[:mix] Initialisation Properties + string end - X,Y:WxH[:mix] int in - in point int out - out point - - Mutable Properties - - int x - the horizontal offset from the left edge of the frame - int y - the vertical offset from the top edge of the frame - double mix - the opacity factor to apply to the second frame - (used in addition to alpha channel). - - any negative value causes an automatic dissolve - + Read Only Properties none @@ -696,7 +785,7 @@ Transitions Constructor Argument - mix - see below + start - see below Initalisation Properties @@ -705,8 +794,11 @@ Transitions Mutable Properties - double mix - the mix level to apply to the second frame. - - any negative value causes an automatic crossfade. + double start - the mix level to apply to the second frame. + - any negative value causes an automatic crossfade from 0 to 1. + double end - the ending value of the mix level. mix level will be interpolated + from start to end over the in-out range. + int reverse - set to 1 to reverse the direction of the mix. Read Only Properties