File: mod_collage_xml_help.html

package info (click to toggle)
sitplus 1.0.3-3
links: PTS, VCS
area: main
in suites: wheezy
size: 23,636 kB
sloc: cpp: 34,437; ansic: 7,957; xml: 1,141; yacc: 326; lisp: 235; lex: 167; makefile: 107; sh: 5
file content (610 lines) | stat: -rw-r--r-- 18,732 bytes
parent folder | download | duplicates (2)
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
    "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.2.7" />
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
/*
  border: 1px solid red;
*/
}

body {
  margin: 1em 5% 1em 5%;
}

a {
  color: blue;
  text-decoration: underline;
}
a:visited {
  color: fuchsia;
}

em {
  font-style: italic;
  color: navy;
}

strong {
  font-weight: bold;
  color: #083194;
}

tt {
  color: navy;
}

h1, h2, h3, h4, h5, h6 {
  color: #527bbd;
  font-family: sans-serif;
  margin-top: 1.2em;
  margin-bottom: 0.5em;
  line-height: 1.3;
}

h1, h2, h3 {
  border-bottom: 2px solid silver;
}
h2 {
  padding-top: 0.5em;
}
h3 {
  float: left;
}
h3 + * {
  clear: left;
}

div.sectionbody {
  font-family: serif;
  margin-left: 0;
}

hr {
  border: 1px solid silver;
}

p {
  margin-top: 0.5em;
  margin-bottom: 0.5em;
}

ul, ol, li > p {
  margin-top: 0;
}

pre {
  padding: 0;
  margin: 0;
}

span#author {
  color: #527bbd;
  font-family: sans-serif;
  font-weight: bold;
  font-size: 1.1em;
}
span#email {
}
span#revision {
  font-family: sans-serif;
}

div#footer {
  font-family: sans-serif;
  font-size: small;
  border-top: 2px solid silver;
  padding-top: 0.5em;
  margin-top: 4.0em;
}
div#footer-text {
  float: left;
  padding-bottom: 0.5em;
}
div#footer-badges {
  float: right;
  padding-bottom: 0.5em;
}

div#preamble,
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
  margin-right: 10%;
  margin-top: 1.5em;
  margin-bottom: 1.5em;
}
div.admonitionblock {
  margin-top: 2.5em;
  margin-bottom: 2.5em;
}

div.content { /* Block element content. */
  padding: 0;
}

/* Block element titles. */
div.title, caption.title {
  color: #527bbd;
  font-family: sans-serif;
  font-weight: bold;
  text-align: left;
  margin-top: 1.0em;
  margin-bottom: 0.5em;
}
div.title + * {
  margin-top: 0;
}

td div.title:first-child {
  margin-top: 0.0em;
}
div.content div.title:first-child {
  margin-top: 0.0em;
}
div.content + div.title {
  margin-top: 0.0em;
}

div.sidebarblock > div.content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
}

div.listingblock {
  margin-right: 0%;
}
div.listingblock > div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
}

div.quoteblock {
  padding-left: 2.0em;
}
div.quoteblock > div.attribution {
  padding-top: 0.5em;
  text-align: right;
}

div.verseblock {
  padding-left: 2.0em;
}
div.verseblock > div.content {
  white-space: pre;
}
div.verseblock > div.attribution {
  padding-top: 0.75em;
  text-align: left;
}
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
div.verseblock + div.attribution {
  text-align: left;
}

div.admonitionblock .icon {
  vertical-align: top;
  font-size: 1.1em;
  font-weight: bold;
  text-decoration: underline;
  color: #527bbd;
  padding-right: 0.5em;
}
div.admonitionblock td.content {
  padding-left: 0.5em;
  border-left: 2px solid silver;
}

div.exampleblock > div.content {
  border-left: 2px solid silver;
  padding: 0.5em;
}

div.imageblock div.content { padding-left: 0; }
div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }

dl {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
}
dt {
  margin-top: 0.5em;
  margin-bottom: 0;
  font-style: normal;
}
dd > *:first-child {
  margin-top: 0.1em;
}

ul, ol {
    list-style-position: outside;
}
div.olist > ol {
  list-style-type: decimal;
}
div.olist2 > ol {
  list-style-type: lower-alpha;
}

div.tableblock > table {
  border: 3px solid #527bbd;
}
thead {
  font-family: sans-serif;
  font-weight: bold;
}
tfoot {
  font-weight: bold;
}

div.hlist {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
}
div.hlist td {
  padding-bottom: 15px;
}
td.hlist1 {
  vertical-align: top;
  font-style: normal;
  padding-right: 0.8em;
}
td.hlist2 {
  vertical-align: top;
}

@media print {
  div#footer-badges { display: none; }
}

div#toctitle {
  color: #527bbd;
  font-family: sans-serif;
  font-size: 1.1em;
  font-weight: bold;
  margin-top: 1.0em;
  margin-bottom: 0.1em;
}

div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
  margin-top: 0;
  margin-bottom: 0;
}
div.toclevel2 {
  margin-left: 2em;
  font-size: 0.9em;
}
div.toclevel3 {
  margin-left: 4em;
  font-size: 0.9em;
}
div.toclevel4 {
  margin-left: 6em;
  font-size: 0.9em;
}
/* Workarounds for IE6's broken and incomplete CSS2. */

div.sidebar-content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
}
div.sidebar-title, div.image-title {
  color: #527bbd;
  font-family: sans-serif;
  font-weight: bold;
  margin-top: 0.0em;
  margin-bottom: 0.5em;
}

div.listingblock div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
}

div.quoteblock-attribution {
  padding-top: 0.5em;
  text-align: right;
}

div.verseblock-content {
  white-space: pre;
}
div.verseblock-attribution {
  padding-top: 0.75em;
  text-align: left;
}

div.exampleblock-content {
  border-left: 2px solid silver;
  padding-left: 0.5em;
}

/* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }

/* Because IE6 child selector is broken. */
div.olist2 ol {
  list-style-type: lower-alpha;
}
div.olist2 div.olist ol {
  list-style-type: decimal;
}
</style>
<script type="text/javascript">
/*<![CDATA[*/
window.onload = function(){generateToc(2)}
/* Author: Mihai Bazon, September 2002
 * http://students.infoiasi.ro/~mishoo
 *
 * Table Of Content generator
 * Version: 0.4
 *
 * Feel free to use this script under the terms of the GNU General Public
 * License, as long as you do not remove or alter this notice.
 */

 /* modified by Troy D. Hanson, September 2006. License: GPL */
 /* modified by Stuart Rackham, October 2006. License: GPL */

function getText(el) {
  var text = "";
  for (var i = el.firstChild; i != null; i = i.nextSibling) {
    if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
      text += i.data;
    else if (i.firstChild != null)
      text += getText(i);
  }
  return text;
}

function TocEntry(el, text, toclevel) {
  this.element = el;
  this.text = text;
  this.toclevel = toclevel;
}

function tocEntries(el, toclevels) {
  var result = new Array;
  var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
  // Function that scans the DOM tree for header elements (the DOM2
  // nodeIterator API would be a better technique but not supported by all
  // browsers).
  var iterate = function (el) {
    for (var i = el.firstChild; i != null; i = i.nextSibling) {
      if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
        var mo = re.exec(i.tagName)
        if (mo)
          result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
        iterate(i);
      }
    }
  }
  iterate(el);
  return result;
}

// This function does the work. toclevels = 1..4.
function generateToc(toclevels) {
  var toc = document.getElementById("toc");
  var entries = tocEntries(document.getElementsByTagName("body")[0], toclevels);
  for (var i = 0; i < entries.length; ++i) {
    var entry = entries[i];
    if (entry.element.id == "")
      entry.element.id = "toc" + i;
    var a = document.createElement("a");
    a.href = "#" + entry.element.id;
    a.appendChild(document.createTextNode(entry.text));
    var div = document.createElement("div");
    div.appendChild(a);
    div.className = "toclevel" + entry.toclevel;
    toc.appendChild(div);
  }
  if (entries.length == 0)
    document.getElementById("header").removeChild(toc);
}
/*]]>*/
</script>
<title>Structure of XML file for mod_collage</title>
</head>
<body>
<div id="header">
<h1>Structure of XML file for mod_collage</h1>
<div id="toc">
  <div id="toctitle">Table of Contents</div>
  <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
</div>
</div>
<div id="preamble">
<div class="sectionbody">
<div class="para"><p>Authors: Marc Alba and Jaume Singla</p></div>
<div class="para"><p>Our XML file always starts with a definition of itself (see the code at the end of this document). Then we need two tags to define an activity which are <tt>&lt;activity&gt;</tt> and <tt>&lt;/activity&gt;</tt>. The first one is the begining of an activity and the second is the end, so we must define the activity between this two tags.</p></div>
<div class="para"><p>Each activity is composed by a list of modules from 1 to more.</p></div>
<div class="para"><p>A module is also defined by two tags: the begining tag <tt>&lt;module&gt;</tt> and the ending tag <tt>&lt;/module&gt;</tt>. At the begining tag you can define attributes from a module in this way</p></div>
<div class="para"><p><tt>&lt;module attribute1="property1" attribute2="property2"&gt;</tt></p></div>
<div class="para"><p>Attributes for <tt>module</tt> tag:</p></div>
<div class="ilist"><ul>
<li>
<p>
<tt>moduleType</tt>: Is a required attribute and defines wich kernel to use. Only properties <tt>COLLAGE</tt> and <tt>CYCLE</tt> are valid. The collage makes transitions from every picture creating and destroying them according to motion. The cycle makes transitions with pictures without creating and destroying them, in a loop, also according to motion.
</p>
</li>
<li>
<p>
<tt>delayType</tt>: Is an optional attribute and defines the behaviour of a module. Only properties <tt>NODELAY</tt>, <tt>RAND</tt> and <tt>MOTION</tt> are valid. Nodelay means that transitions are applied normally, rand is applied randomly and motion is applied according to motion. If no <tt>delaytype</tt> defined then the default is the <tt>RAND</tt> one.
</p>
</li>
<li>
<p>
<tt>listSrcBackground</tt>: Is an optional attribute. It can contain a list of images, with their relatives paths, separated with commas to make an animation in the background. Also you can insert carriage return between sources to make XML clearer.
</p>
</li>
<li>
<p>
<tt>lapseAnimation</tt>: Is an optional attribute, but if <tt>listSrcBackground</tt> is defined then that one is required, because to do an animation we need the time between pictures, that's it. The attribute must to be a float. If you only define one picture in the list and the lapse animation is zero, then we obtain a static background image, well same effect if there are more pictures but lapse is zero.
</p>
</li>
</ul></div>
<div class="para"><p>A module is composed by one element called <tt>default</tt> and a list of pictures from one to more. As before the elements are defined with a begining and ending tag.</p></div>
<div class="para"><p>default &#8658; <tt>&lt;default&gt;</tt> and <tt>&lt;/default&gt;</tt>
picture &#8658; <tt>&lt;picture&gt;</tt> and <tt>&lt;/picture&gt;</tt></p></div>
<div class="para"><p>The <tt>default</tt> element allows to define the input and output transition to use with pictures after defined, if the picture doesn't define a transition. In this element you can define one or two transitions. The default doesn't have attributes.</p></div>
<div class="para"><p>You can define attributes for a picture at begining tag as the module but in <tt>&lt;picture att1="prop1"&gt;</tt>.</p></div>
<div class="para"><p>Attributes for <tt>picture</tt> tag:</p></div>
<div class="ilist"><ul>
<li>
<p>
<tt>src</tt>: Is a required attribute, if not defined then, the picture is ignored. It can contain a list of pictures with their relatives paths, separated with commas. Also you can insert carriage return between sources to make XML clearer.
</p>
</li>
<li>
<p>
<tt>quantity</tt>: Is an optional attribute, if is not defined then quantity equals one (is an integer). It can specify how many times appears the pictures divided by the number of pictures defined, this means that if you specify two pictures at the attribute <tt>src</tt> and eight at this attribute, each picture appears four times alternatively in the same order specified.
</p>
</li>
<li>
<p>
<tt>scale</tt>: Is an optional attribute, a float one, and if is not defined then scale equals 0.25. It serves to zoom the picture.
</p>
</li>
<li>
<p>
<tt>rotated</tt>: Is an optional attribute, if is not defined then rotated equals zero. It is used for rotate the picture the degrees (not radians) specified by this attribute. It must be an integer.
</p>
</li>
<li>
<p>
<tt>position</tt>: Is the relative position where the picture will be painted. Its format is <tt>(x,y)</tt> with the parenthesis and the comma, then x and y are the coordinates in float number. I.e. <tt>&lt;picture &#8230; position="(0.3,0.5)" &gt;</tt>.
</p>
</li>
</ul></div>
<div class="para"><p>Each picture is composed by transitions from zero to more. In case of collage makes sense to specify two transitions, one for the input transition and the second for the output transition, but in the cycle module if two transitions are specified&#8230;well you can try, may be the result is unexpected and interesant at the same time. Specify more than two transitions has no sense but probably the last two will be taken, so be carefull. If a picture has no transitions defined then the default ones are taken, if there is no default element it will be an error. By definition it will become the activity into invalid one, but without DTD it only ignores the picture.</p></div>
<div class="para"><p>Each transition is composed, as before, with a begining and endig tag: <tt>&lt;transition&gt;</tt> and <tt>&lt;/transition&gt;</tt>. Its attribute are defined as before in the begining tag <tt>&lt;transition att1="prop1"&gt;</tt></p></div>
<div class="para"><p>Attributes for transition tag:</p></div>
<div class="ilist"><ul>
<li>
<p>
<tt>transitionType</tt>: is an optional attribute, if is not defined then <tt>IDENTITY</tt> is taken. Its only valid values are:
</p>
<div class="ilist"><ul>
<li>
<p>
<tt>IDENTITY</tt>: transition has no effect.
</p>
</li>
<li>
<p>
<tt>ALPHA</tt>: picture appears or desappears through the alpha channel.
</p>
</li>
<li>
<p>
<tt>SCALE</tt>: picture is zommed in and out.
</p>
</li>
<li>
<p>
<tt>ROTATE</tt>: picture is rotated.
</p>
</li>
<li>
<p>
<tt>CHANGE</tt>: picture is changed for another (extra attribute is needed).
</p>
</li>
<li>
<p>
<tt>VIBRATE</tt>: picture vibrates.
</p>
</li>
<li>
<p>
<tt>TRANSLATE</tt>: picture is translated (extra attribute is needed).
</p>
</li>
<li>
<p>
<tt>RANDOM</tt>: takes a random transition from before mentioned.
</p>
</li>
</ul></div>
</li>
<li>
<p>
<tt>inout</tt>: is an optional attribute, if is not defined then <tt>MIX</tt> is taken. Its values are <tt>IN</tt>, <tt>OUT</tt> and <tt>MIX</tt>. They specify if is an input transition (in)m an output transition (out) or only one transition is needed (mix). As mentioned before the input and output transitions only takes sense with the collage module, so in the cycle you can define only one transition per picture without this attribute, because the default is the <tt>mix</tt> one.
</p>
</li>
<li>
<p>
<tt>degreesRotation</tt>: is an optional parameter to specify the degrees of rotate transition, if is not defined it takes 90 degrees, and is an integer.
</p>
</li>
<li>
<p>
<tt>destinationSrc</tt>: Is an optional attribute. It can contain a list of pictures with their relatives paths, separated with commas. Also you can insert carriage return between sources to make XML clearer.     This attribute only makes sense if the transition type is <tt>CHANGE</tt>, and if the transition is the <tt>CHANGE</tt> one, then you need to specify the pictures to change for.
</p>
</li>
<li>
<p>
<tt>destinationPos</tt>: is an optional attribute which only makes sense if the transition is <tt>TRANSLATE</tt>, so if is a <tt>TRANSLATE</tt> transition you need to define this attribute. Is the relative position where the picture will be tranlated. Its format is <tt>(x,y)</tt> with the parenthesis and the comma, then x and y are the coordinates in float number. I.e. <tt>&lt;transition transitionType="TRANSLATE" destinationPos="(0.5,0.8)" &gt;</tt>.
</p>
</li>
</ul></div>
<div class="para"><p>Note that the transition has no elemnts inside so it can be defined without the mentioned ending tag from above, but in the same way needs and end, and it's a slash at the end of the begining tag.
i. e. <tt>&lt;transition transitionType="ALPHA" /&gt;</tt>.</p></div>
<div class="para"><p>The same applies if a picture has no transitions defined because we want to pick the default ones. So it will be: <tt>&lt;picture src="&#8230;" position="(0.2,0.4)" /&gt;</tt></p></div>
<div class="para"><p>See the samples at <tt>graphics/mod_collage_xml</tt> directory.</p></div>
<div class="para"><p>The next code is a template for defining any kind of activity:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;!DOCTYPE activity [&lt;!ELEMENT activity (module+)&gt;
&lt;!ELEMENT module (default, picture+)&gt;
&lt;!ATTLIST module
        delayType (NODELAY|RAND|MOTION) "RAND"
        moduleType (COLLAGE|CYCLE) #REQUIRED
        listSrcBackground CDATA #IMPLIED
        lapseAnimation CDATA "-1"
&gt;

&lt;!ELEMENT default (transition, transition?)&gt;

&lt;!ELEMENT picture (transition*)&gt;
&lt;!ATTLIST picture
        src CDATA #REQUIRED
        quantity CDATA "1"
        scale CDATA "0.25"
        position CDATA #IMPLIED
        rotated CDATA #IMPLIED
&gt;

&lt;!ELEMENT transition EMPTY&gt;
&lt;!ATTLIST transition
        transitionType (IDENTITY|ALPHA|SCALE|ROTATE|CHANGE|VIBRATE|TRANSLATE|RANDOM) "IDENTITY"
        inout (IN|OUT|MIX) "MIX"
        destinationSrc CDATA #IMPLIED
        degreesRotation CDATA #IMPLIED
        destinationPos CDATA #IMPLIED
&gt;
]&gt;
&lt;activity&gt;
        &lt;!--HERE YOU CAN DEFINE VARIOUS MODULES--&gt;
&lt;/activity&gt;</tt></pre>
</div></div>
</div>
</div>
<div id="footer">
<div id="footer-text">
Last updated 2011-06-21 18:40:34 CEST
</div>
</div>
</body>
</html>