navigate_before Prev Next navigate_next
For modules we only need five tags: module, set, aspect, style and file, in that exact order.
The module is our root element. It contains information about our module and its creators/authors. This information will be displayed in the INFO tab once loaded into the EMCCV. The information will also be displayed on the EMCCV.com website, once your module is listed here (if you want it to be).
The set is the direct descendant or child element of the module. A set corresponds to the additional tabs (beyond the INFO tab) displayed in the EMCCV. You need at least one set for your module to make any sense, and a set contain aspects.
The aspect is the first element that allows the user to manipulate the generated image. Literally speaking an aspect is part of a whole. A foot is an aspect of a body. A door is an aspect of a house. Body, hair, eyes, leotard, skirt, etc are all aspects of SailorXv3. An aspect can be turned on or off with a checkbox. It also has a color. Within the aspect you most importantly define a descriptive title. In SailorXv3 the aspect with the id "aLeotard" and the title "leotard" controls the settings for... you guessed it: the leotard and all its corresponding files! BUT! We don't want all leotard files to be displayed at once because we have multiple styles which consist of different files! That is why we first have to define a style.
A style is the direct descendant of the aspect. It represents the radiobutton style options for an aspect, though the little cog wheel for opening the style menu of the aspect is only available if more than one style is defined for the aspect - if there is only one style, then that style is permanently selected. A style also has an id and a title among other attributes, to which we will get later. Within the style we can finally list our last elements: the corresponding files!
A file is our last building block and has no descendant/child elements. It does NOT need an id or a title. The file informs the EMCCV of a graphic file that is to be displayed on the canvas if and only if
Example: The file "leotard/standard.png" will only be displayed, if the style "leotard: standard" is selected and the aspect "leotard" is checked.
Now that we have the basic structure and principles down, we will also need to take a look at all the attributes we have on offer for controlling the layer and position of our files. But we will do that step by step as we create our first module!
Alternatively, if you are a more hands on learner, you might just want to download the Tutorial Module called "MyMod01". Just dive right into the config file and there you'll find some well commented basic examples to give you a head start!