X-Git-Url: http://research.m1stereo.tv/gitweb?a=blobdiff_plain;f=docs%2Fwestley.txt;h=1f42538d091be2e2d0558128eef7fa07b1573a63;hb=f4963a6aa07644399b273b5d2b1f9299c9047414;hp=c36fa6e77a1189611d7c21ef863f22d87be2d86f;hpb=8312a94c9a728e98e59ab12da1adbfe79d85ac7e;p=melted diff --git a/docs/westley.txt b/docs/westley.txt index c36fa6e..1f42538 100644 --- a/docs/westley.txt +++ b/docs/westley.txt @@ -1,10 +1,22 @@ +Westley Documentation + +Copyright (C) 2004 Ushodaya Enterprised Limited +Authors: Charles Yates +Last Revision: 2004-03-20 + + WESTLEY ------- Preamble: Westley is the MLT projects XML serialisation/deserialisation format - - as such, it closely mirrors the internal structure of the MLT API. + as such, it closely mirrors the internal structure of the MLT API. + + If you just want to go straight to the DTD, then see + mlt/src/modules/westley/westley.dtd, which gets installed at + $(prefix)/share/mlt/modules/westley.dtd. Currently, the westley parser is + non-validating. Introduction: @@ -173,9 +185,6 @@ Interlude - Introducing Multitracks: appear to be an exception - it isn't - it simply has a route back to the application to allow the application to interpret key presses). - Whether this is better or worse than a traditional graph approach is a moot - point. The author of this document likes it anyway :-). - Tractors: @@ -293,35 +302,35 @@ Tractors: - clip1.dv + clip1.dv - + - clip2.mpeg + clip2.mpeg - - + + - - - - - - 0 - 1 - luma - - - 0 - 1 - mix - 0.0 - 1.0 - + + + + + + 0 + 1 + luma + + + 0 + 1 + mix + 0.0 + 1.0 + @@ -331,7 +340,7 @@ Tractors: between the gain scaling factors between the start and end properties - in this example, from 0.0 (none of track B) to 1.0 (all of track B). Because the bottom track starts out with a gap specified using the - element, the upper track appears during the blank segment. See the demos and + element, the upper track appears during the blank segment. See the demos and services.txt to get an idea of the capabilities of the included transitions. Flexibility: @@ -471,18 +480,18 @@ Entities and Parameterisation: + ]> - pango - &msg; + pango + &msg; If you are embedding another XML document into a property value not using a CNODE section, then any DOCTYPE section must be relocated before any of - the xml elements to be well-formed. See demo/dvg.westley for an example. + the xml elements to be well-formed. See demo/svg.westley for an example. Entities can be used to parameterise westley! Using the above example, the entity declared serves as the default value for &msg;. The entity content @@ -515,39 +524,39 @@ Tips and Technique: If one finds the above hierarchical, abbreviated format intuitive, start with a simple template and fill and extend as needed: - - - - - ...add a playlist for each track... - - ...add filters and transitions... - - + + + + + ...add a playlist for each track... + + ...add filters and transitions... + + By using a playlist for each track, it is easier to iteratively add new - clips and blank regions as you develop the project. You will not have to + clips and blank regions as you develop the project. You will not have to use or later add when necessary. A more advanced template that allows sequencing multitracks is: - - - - - - ...add a playlist for each track... - - ...add filters and transitions... - - - - - - - ...add a playlist for each track... - - ...add filters and transitions... - - + + + + + + ...add a playlist for each track... + + ...add filters and transitions... + + + + + + + ...add a playlist for each track... + + ...add filters and transitions... + + If you end up making a collection of templates for various situations, then consider using XML Entities to make the template more effective by moving