<area>¶
El elemento <area> permite definir un ancla de contenido (un subconjunto de unidades de información del contenido de un <media> elemento) que pueden usarse en relaciones con otros objetos en una aplicación NCL.
Los anclajes de contenido pueden representar:
- porciones espaciales de imágenes: a través del atributo coords;
- porciones temporales de contenido multimedia continuo (audio, vídeo, etc.): a través de los atributos begin y end, o basándose en el número de muestras de audio o fotogramas de vídeo, hasta el primero y último atributo, que indica el inicio y el final. muestra/marco;
- porciones temporales y espaciales de videos: a través de las coords, atributos comienzo y fin; o a través del coords, primero y último atributos;
- segmentos textuales: a través de beginText, beginPosition, Atributos endText y endPosition, que definen el cadenas de inicio y fin, y su aparición en el texto respectivamente;
- una cadena que utiliza el reproductor multimedia para identificar una región de contenido (por ejemplo, una función o método en un objeto multimedia imperativo, un interfaz en un objeto de medios declarativo, como un ancla HTML, un puerto en un objeto multimedia con una aplicación NCL como contenido, etc.): a través del atributo etiqueta;
- un clip en el contenido de un objeto hipermedia declarativo: usando el clip atributo.
Cada elemento <media>, <context>, <body> y <switch> tiene un ancla de contenido con una región que representa todo el contenido del Nodo definido por defecto. Este ancla se llama "ancla de contenido completo". Excepto para objetos multimedia con contenido de código imperativo (por ejemplo, aquellos cuyo tipo MIME es "application/x-ncl-NCLua"), cada vez que un componente NCL se hace referencia sin especificar uno de sus anclajes, todo el contenido ancla se supone.
Sintaxis¶
| Elemento | Atributos | Contenido | Padre |
|---|---|---|---|
| <area> | id, coords, begin, end, beginText, endText, beginPosition, endPosition, primero, último, etiqueta, clip | -- | <media> |
Atributos¶
| Nombre | Valor | Descripción |
|---|---|---|
| id | Puede recibir cualquier valor de cadena que comience con una letra o un guión bajo y que solo contenga letras, dígitos, "." y "_". | El atributo id identifica de forma única al elemento dentro de un documento. |
| coords | Una lista de valores de la forma "left-x, top-y, right-x, bottom-y" donde cada valor es:
|
El atributo coords especifica la posición de un área rectangular en la pantalla. Las coordenadas son relativas a la esquina superior izquierda del contenido del objeto. Los valores están separados por comas. El orden de los valores es "left-x", "top-y", "right-x" y "bottom-y". Cuando "left-x" y "right-x" se expresan como un porcentaje, el valor es relativo a la propiedad de ancho (width) del objeto multimedia. Cuando "top-y" y "bottom-y" se expresan como un porcentaje, el valor es relativo a la propiedad de altura (height) del objeto multimedia. |
| begin | Excepto para el elemento <media> del tipo "application/x-ncl-time", el atributo begin debe especificarse de acuerdo con una de las siguientes sintaxis:
Para el elemento <media> del tipo "application/x-ncl-time", el atributo begin debe especificarse de acuerdo con la siguiente sintaxis: "Year:Month:Day:Hours:Minutes:Seconds.Fraction", según la zona horaria del país. El agente de usuario NCL es responsable de traducir el valor de la zona horaria del país al correspondiente a UTC. Si se define el atributo end, pero sin una definición explícita para el atributo begin, el inicio de la presentación de todo el contenido multimedia se considerará como el inicio del ancla. En el caso de un elemento multimedia del tipo "application/x-ncl-time", el atributo begin siempre debe estar definido y asume un valor UTC absoluto. |
El atributo begin especifica el inicio del ancla temporal. |
| end | Igual que para begin. | El atributo end especifica el fin del ancla temporal. |
| beginText | Cadena. Si no se define el inicio de la región del ancla de contenido, se asume el inicio del contenido de texto. |
Los atributos beginText y beginPosition especifican el inicio del ancla de texto. El atributo beginText define una cadena en el texto. |
| endText | Cadena. | Los atributos endText y endPosition especifican el fin del ancla de texto. El atributo endText define una cadena en el texto. |
| beginPosition | Entero positivo. El valor predeterminado es 1. | Los atributos beginText y beginPosition especifican el inicio del ancla de texto. El atributo beginPosition define la aparición de la cadena en el texto. |
| endPosition | Entero positivo. El valor predeterminado es la posición del último carácter en la cadena. | Los atributos endText y endPosition especifican el fin del ancla de texto. El atributo endPosition define la aparición de la cadena en el texto. |
| first | El atributo first debe especificarse de acuerdo con una de las siguientes sintaxis:
Si se define el atributo last, pero sin una definición explícita para el atributo first, el inicio de la presentación de todo el contenido multimedia se considerará como el inicio del ancla. |
-- |
| last | El atributo last debe especificarse de acuerdo con una de las siguientes sintaxis:
Si se define el atributo first, pero no se especifica el atributo last, el final de la presentación de todo el contenido multimedia se asumirá como el fin del ancla. |
-- |
| label | Cadena. | El atributo label identifica una región de contenido, por ejemplo, una función en un objeto multimedia imperativo, una interfaz en un objeto multimedia declarativo, como un ancla HTML, o un puerto en un objeto multimedia con una aplicación NCL como contenido, etc. |
| clip | Cadena. El valor depende del tipo de objeto hipermedia declarativo. Para objetos multimedia NCL, el valor de clip es una terna "(chainId,beginOffset,endOffset)" que utiliza el reproductor multimedia NCL para identificar un elemento <port> de aplicación NCL a través del cual comienza una cadena temporal, y el tiempo de inicio y fin en esta cadena temporal. Para elementos <media> con contenido de código NCL se definen los siguientes valores predeterminados:
|
El atributo clip identifica un clip de flujo en el contenido de un objeto hipermedia declarativo. |