Definição e uso¶
O elemento <area> permite definir uma âncora de conteúdo (um subconjunto de unidades de informação do conteúdo de um elemento <media>) que podem ser usadas em relacionamentos com outros objetos em uma aplicação NCL.
As âncoras de conteúdo podem representar:
- porções espaciais de imagens: através do atributo coords;
- porções temporais de conteúdo de mídia contínua (áudio, vídeo, etc.): através dos atributos begin e end, ou com base no número de amostras de áudio ou quadros de vídeo, através do primeiro e últimos atributos, que indicam o início e o final amostra/quadro;
- porções temporais e espaciais dos vídeos: através das coordenadas, atributos begin e end; ou através do atributos coords, primeiro e último;
- segmentos textuais: através de beginText, beginPosition, Atributos endText e endPosition, que definem o strings de início e fim e sua ocorrência no texto respectivamente;
- uma string usada pelo media player para identificar uma região de conteúdo (por exemplo, uma função ou método em um objeto de mídia imperativo, um interface em um objeto de mídia declarativo, como uma âncora HTML, uma porta em um objeto de mídia com uma aplicação NCL como conteúdo, etc.): através do atributo rótulo;
- um clipe no conteúdo de um objeto hipermídia declarativo: usando o clipe atributo.
Cada elemento <media>, <context>, <body> e <switch> tem uma âncora de conteúdo com uma região que representa todo o conteúdo do nó definido por padrão. Essa âncora é chamada de "âncora de todo o conteúdo". Exceto para objetos de mídia com conteúdo de código imperativo (por exemplo, aqueles cujo tipo MIME é "application/x-ncl-NCLua"), toda vez que um componente NCL é referido sem especificar uma de suas âncoras, toda a âncora de conteúdo é assumido.
Sintaxe¶
| Elemento | Atributos | Conteúdo | Pai |
|---|---|---|---|
| <area> | id, coords, begin, end, beginText, endText, beginPosition, endPosition, first, last, label, clip | -- | <media> |
Atributos¶
| Name | Value | Description |
|---|---|---|
| id | It may receive any string value that begins with a letter or an underscore and that only contains letters, digits, <".">, and <"_">. | The id attribute uniquely identifies the element within a document. |
| coords | A list of values of the form "left-x, top-y, right-x, bottom-y" where each value is either:
|
The coords attribute specifies the position of a rectangular area on the screen. Coordinates are relative to the top, left corner of the object content. The values are separated by commas. The order of values is "left-x", "top-y", "right-x", and "bottom-y". When the "left-x" and "right-x" are expressed as a percentage, the value is relative to the width property of the media object. When the "top-y" and "bottom-y" are expressed as a percentage, the value is relative to the height property of the media object. |
| begin | Except for the <media> element of the "application/x-ncl-time" type, the begin attribute shall be specified according with one of the following syntax:
For the <media> element of the "application/x-ncl-time" type, the begin attribute shall be specified according with the following syntax: <" If the end attribute is defined, but without an explicit definition for the begin attribute, the start of the whole media content presentation shall be considered as the anchor beginning. In the case of a media element of the "application/x-ncl-time" type, the begin attribute must always be defined and it assumes an absolute UTC value. |
The begin attribute specifies the beginning of the temporal anchor. |
| end | Same as for begin. | The end attribute specifies the end of the temporal anchor. |
| beginText | String. If the beginning of the content anchor region is not defined, the beginning of the text content is assumed. |
The beginText and beginPosition attributes specifies the beginning of the text anchor. The beginText defines a string in the text. |
| endText | String. | The endText and endPosition attributes specifies the end of the text anchor. The endText defines a string in the text. |
| beginPosition | Positive integer. The default value is 1. | The beginText and beginPosition attributes specifies the beginning of the text anchor. The beginPosition defines the occurrence of the string in the text. |
| endPosition | Positive integer. The default value is the position of the last character in string. | The endText and the endPosition attributes specifies the end of the text anchor. The endPosition defines the occurrence of the string in the text. |
| first | The first attribute shall be specified according with one of the following syntax:
If the last attribute is defined, but without an explicit definition for the first attribute, the start of the whole media content presentation shall be considered as the anchor beginning. |
-- |
| last | The last attribute shall be specified according with one of the following syntax:
If the first attribute is defined, but the last attribute is not specified, the end of the whole media content presentation shall be assumed as the anchor ending. |
-- |
| label | String. | The label attribute identifies a content region, for example, a function in an imperative media object, or an interface in a declarative media object, like an HTML anchor, or a port in a media object with an NCL application as content, etc. |
| clip | String. The value depends on the declarative hypermedia object type. For NCL media objects, the clip value is a triple <"(chainId,beginOffset,endOffset)"> that is used by the NCL media player to identify an NCL application <port> through which a temporal chain begins, and the beginning and the end time in this temporal chain. For <media> elements with NCL code content the following defaults are defined:
|
The clip identifies a stream clip in the content of a declarative hypermedia object |