2. MND Script
2.1. Single-values
2.2. Default value
2.3. Multi-values
2.4. Coordinates
2.5. Command parameters
2.6. Target, shower and local area
2.7. Timing
2.8. Nested projects

3. Directives Reference
3.1. @@C - Set Project Caption
3.2. @@T - Set Project Time
3.3. @@R - Set Project Resolution

4. Commands Reference
4.1. @C - Fill with Color
4.2. @I - Show Image
4.3. @S - Render Scene Frame(s)
4.4. @D - Render Project Frame(s)
4.5. @M - Play Music
4.6. @T - Print Text

5. Parameters Reference
5.1. Blending modes
5.2. Wrapping modes

@@X <parameters>

@X <mandatory-parameters> <optional-parameters>

Each command creates one shower for that command. Shower is responsible for
interpreting parameters of commands and executing that command. Every command
has one corresponing shower type. There are exectly as many showers as there
are commands in the project script.

* default value: ?
     - this denotes default value for parameter

* normal value: <number>
     - this is normal floating point or integer number

Numbers can be signed (have + or - before digits). Scientific notation (like
1.0E-3) is not supported for floating point numbers. Integer numbers can be
specified in hexadecimal notation when $ is written before hexadecimal digits.

For example, default project resolution is 800x600. So, instead of

All four combinations will have exactly same final effect.

Instead of a multi-value, you can always use single-value (default or normal).

Multi-value starts with [ and ends with ]. Between brackets, you specify
keyframes (much like keyframes in Lightwave) - time and value for each keyframe
in the form TIME:VALUE and you separate keyframes with commas. Here are some
simple examples:

You can also specify more than one keyframe:

Note that time can be either ordinary floating point number or default value.
Default value of time for any keyframe is length of local time (see section
Timing for explanation of local time).

As for value of any keyframe, you can use any single-value (default or normal).

Multi-values can be repeated/looped. You can do this by putting ! after the
last keyframe and before ]. In this case, behavior of multi-value is repeated
after the last keyframe. So, if you have multi-value

There is one more thing you can do with multi-value. Imagine that you want to
have value of some to be 1 from 0s to 10s and 2 from 10s to 20s. Something like:

As you can see, the only problematic place is 10s, where you have some kind of
jump from 1 to 2. It is possible to have this behaviour in easy way:

You can think of this as an abbrivation for two multi-values above. Note that
you can "combine" more than two multi-values:

Coordinates are relative to the upper left corner, which means (0,0) indicates
upper left corner of the screen.

Examples:

At the time, one parameter can be entered multiple times in which case
behavior of the program will be valid but undefined.

- at the beginning of each frame, target area is set to full screen
- parameter P of command @D denotes new target area
- parameter S of command @D sets proportions of target area

Target area is not limited to the size of image (or screen), it can be larger
in which case everything outside visible area is clipped.

Shower area is part of target area on which shower renders its command. Shower
area is not limited to target area, but only those parts inside target area
will be rendered, everything else will be clipped.

Local area is part of the source of the command which is rendered to shower
area. Usually, size of local and shower area are same. They differ in some
situations like when part of image (or whole image) is stretched to shower
area which means it's not anymore in original proportions.

All commands in script have time which tells when they are "active". Outside
this range, commands are not being executed, and nothing is rendered (or heard,
in case of sounds). This time is called 'shower time'.

Shower times must fall inside project time, and for each command, starting time
must be less than or equal to ending time. Default value for shower starting
time is project starting time, and default value for shower ending time is
project ending time.

Inside one command for shower, all times are written in local time. Local time
for every shower is 0 at shower starting time and lasts for as long as shower.
For example, if shower time is 30:75, then its local time is 0:45 (45 = 75-30).

Examples:

- if some project is rendered, then current time of that project is picked for
rendering
- otherwise, time since application started is picked as current time for
nested project rendering

Nested projects are created in following way: Let's say that we have image
called TEXTURE.JPG. Now, if we create project TEXTURE.JPG.MND, then contents of
this project will be used instead of image TEXTURE.JPG. After we create the
project, original image (TEXTURE.JPG) doesn't have to exist anymore. Also note
that image can be in any format, not only JPEG.

Target image rendered in this way can be used as any other image (all
properties of surface regarding way the image is rendered apply to it, all
parameters of command @I...). It is ordinary image like any other after it is
rendered.

Note that every target image is rendered only once per application frame. So,
if you have same target image used as a texture on two objects, it will be
rendered only once.

Also, be careful when using nested project because you can get strange effects
like in this situation:

But, you will not get desired effect. Both left and right side of the screen
will animate from black to red because they use same target image (NESTED.MND).
To have correct behaviour, you will need to create NESTED2.MND. So, create
TEST_INNER2.MND and modify TEST.MND:

Description
   This directive sets caption of the project. This caption is used
   when project is played directly in NORD.

Default value
   @@C <name-of-MND-file>

Example:

Description
   This directive sets starting and ending time for animation. In the first
   case, when there is not <starttime>, it is assumed to be 0.

   Ending time must be greater than starting time.

   This directive is mandatory, and has to be set before any command in the
   script.

Default value,
   None. This directive is mandatory.

Examples