1. Media Element¶
The media element defines an media object, that can be an image, video, text and even HTML documents or Lua scripts.
Its syntax is defined as:
Media = "media" * Id *(Comentario + MacroCall + Area + Propriedade)^0 * end
Area = "area" * Id * (Comentario + Propriedade)^0 * "end"
It is identified univocally by the id field, for example, the code below declares a media object that is a HTML document and has the id “media1”. In this case, no other element in the entire application may have the id “media1”.
1 2 3 | media media1
type: "text/html"
end
|
The media element must have either a type, a source or refer to another element, so the player knows what is the type of the media object.
1 2 3 4 5 6 7 8 9 | media media1
type: "text/html" -- a type
end
media media2
src: "docs/index.html" -- a source
end
media media3
refer: media2 -- media3 refers to media2
end
|
In addition to specifying the type of the media object, or what the object is, it can also be specified where the object will appear in the screen, the location of it, the list of these other possible properties is in Default Properties
1 2 3 4 5 6 | media media4
-- a media with margin of 15 pixels on both sides
src: "medias/image.jpg"
left: 15px
right: 15px
end
|
1.1. Area Element¶
The area element defines an anchor ( a part of the information of the media element) that may be used in relationships with other objects.
Area = "area" * Id * (Comentario + Propriedade)^0 * "end"
- Anchors can represent:
- Spatial portions of images (begin, end, first, last)
- Temporal portions of continuous media content (begin, end, coords, first, last)
- Textual segments
For example, a temporal portion of a video can used like the example below. When the media1 gets in 20s, media2 will start.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | port pBody media1
media media1
src: "medias/video1.jpg"
area area1
begin: 20s
end
end
media media2
src: "medias/image2.jpg"
end
onBegin media1.area1 do
start media2 end
end
|