<property>¶
El elemento <property> define una propiedad o un grupo de propiedades para su padre <media>, <context>, <body> o <switch> elementos. Estas propiedades se pueden utilizar en relaciones con otros objetos. de una aplicación NCL, si el atributo externo de <property> El elemento tiene "verdadero" como valor.
El elemento <property> define el atributo de nombre, que indica el nombre de la propiedad o grupo de propiedades y el atributo de valor. el padre El elemento no puede tener más de un elemento <property> con el mismo valor del atributo de nombre.
El atributo valor es opcional y define un valor inicial para el propiedad declarada en el atributo nombre. Cuando el valor no es especificada, la propiedad se inicializa con el valor definido en el homónimo atributos de los elementos <descriptor> o <region> asociados con el elemento padre que define el <property>, o bien con un valor predeterminado (que depende del valor del atributo de nombre). cuando el El valor se especifica en el elemento <property>, tiene prioridad sobre el valor definido en los atributos homónimos de <descriptor> o <region> elementos asociados con el elemento principal que define el <property>.
Sintaxis¶
| Elemento | Atributos | Contenido | Padre |
|---|---|---|---|
| <property> | nombre, valor, externable | -- | <media> o <context> o <body> |
Atributos¶
| Nombre | Valor | Descripción |
|---|---|---|
| nombre | 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 nombre identifica de forma única la propiedad dentro de su elemento principal. |
| valor | Depende del valor del nombre. | El atributo valor define un valor inicial para el atributo nombre. |
| externable | "falso" o "verdadero". El valor predeterminado es: "verdadero" si la propiedad está definida en un elemento <property>, o "falso" si la propiedad está definida en un elemento <descriptor>. | El atributo externable determina si una propiedad puede (externable="true") o no (externable="false") usarse en relaciones. |
Propiedades predefinidas¶
Se utilizan varias palabras reservadas para especificar propiedades con valores predefinidos. semántica conocida por los jugadores de la NCL. Estas propiedades, su semántica, su Los valores posibles y sus valores predeterminados se presentan a continuación.
Propiedades predefinidas para todos los <media> elementos¶
| Nombre | Valor | Descripción |
|---|---|---|
| style | URI. | El localizador de un archivo de hoja de estilo que especifica otras propiedades para el objeto. |
| player | Cadena. | Identifica la herramienta de presentación que se utilizará. Si no se especifica, el reproductor está determinado por el tipo de objeto, definido por el atributo type del elemento <media>, o se infiere por la extensión de archivo del valor del atributo src del elemento <media>. |
| reusePlayer | "true" o "false". El valor predeterminado es "false". |
Especifica si se debe instanciar un nuevo reproductor ("false") o si se debe utilizar un reproductor ya instanciado ("true"). |
| playerLife | "close" o "keep". El valor predeterminado es "close". |
Especifica qué sucederá con la instancia del reproductor al final de la presentación del objeto. |
| deviceClass | "systemScreen(i)" o "systemAudio(i)", donde i es un entero no negativo. El valor predeterminado es la misma clase de dispositivo que ejecuta el reproductor NCL. |
Especifica la clase de dispositivo donde se presentará el objeto multimedia. Existen dos tipos diferentes de clases de dispositivos: activa y pasiva. En una clase activa, un dispositivo es capaz de ejecutar algunos reproductores multimedia para presentaciones de elementos <media>. En una clase pasiva, no se requiere que un dispositivo ejecute reproductores multimedia, solo que exhiba un mapa de bits o una secuencia de muestras de audio recibidas de otro dispositivo. Los valores "systemScreen(1)" y "systemAudio(1)" están reservados para clases pasivas, y "systemScreen(2)" y "systemAudio(2)" están reservados para clases activas. |
| explicitDur | La propiedad "explicitDur" se especifica de acuerdo con una de las siguientes sintaxis:
Para medios continuos, el valor predeterminado se establece en la duración del contenido; de lo contrario, debe establecerse en nulo (nil). |
Define la duración explícita de un objeto. |
| focusIndex | Entero positivo. Cuando esta propiedad no está definida, el objeto se considera como si no pudiera recibir foco. |
Especifica un índice para el elemento <media> al que se puede aplicar el foco. Nota: Cuando se selecciona un elemento en foco presionando la tecla de activación ("SELECT" o "ENTER"), el control de foco se pasará al renderizador (reproductor) del elemento <media>. El reproductor puede entonces seguir sus propias reglas de navegación. El control de foco volverá al reproductor NCL cuando se presione la tecla de retroceso (back). En este caso, el foco pasa al elemento identificado por la propiedad "service.currentFocus" del nodo de configuraciones (elemento <media> del tipo "application/x-ncl-settings"). |
| moveLeft | Entero positivo. | Especifica un valor igual al valor focusIndex asociado al elemento al que se debe aplicar el foco cuando se presiona la tecla de flecha izquierda. Cuando el foco se aplica a un elemento con la propiedad visible establecida en "false", o a un elemento que no se está presentando, el foco actual no se mueve. |
| moveRight | Entero positivo. | Especifica un valor igual al valor focusIndex asociado al elemento al que se debe aplicar el foco cuando se presiona la tecla de flecha derecha. Cuando el foco se aplica a un elemento con la propiedad visible establecida en "false", o a un elemento que no se está presentando, el foco actual no se mueve. |
| moveUp | Entero positivo. | Especifica un valor igual al valor focusIndex asociado al elemento al que se debe aplicar el foco cuando se presiona la tecla de flecha arriba. Cuando el foco se aplica a un elemento con la propiedad visible establecida en "false", o a un elemento que no se está presentando, el foco actual no se mueve. |
| moveDown | Entero positivo. | Especifica un valor igual al valor focusIndex asociado al elemento al que se debe aplicar el foco cuando se presiona la tecla de flecha abajo. Cuando el foco se aplica a un elemento con la propiedad visible establecida en "false", o a un elemento que no se está presentando, el foco actual no se mueve. |
Propiedades predefinidas para <media> elementos con contenido visual¶
| Nombre | Valor | Descripción |
|---|---|---|
| top | Un número real en el rango [0,100] que termina con el carácter "%" (por ejemplo, 30%), o un valor entero no negativo que especifica el atributo en píxeles. Para valores en píxeles, el calificador de unidad "px" puede omitirse. El valor predeterminado es "0%", si el valor de bottom no está especificado. |
Posición superior del contenido, expresada como un porcentaje de la dimensión de altura del dispositivo de exhibición, o como un valor absoluto. Coloca la posición superior del contenido a exhibir a la distancia especificada desde el borde superior del dispositivo de exhibición. |
| bottom | Si se especifican los valores "top" y "height", debe calcularse en función de estos valores. De lo contrario, debe ser un número real en el rango [0,100] que termina con el carácter "%" (por ejemplo, 30%), o un valor entero no negativo que especifica el atributo en píxeles. Para valores en píxeles, el calificador de unidad "px" puede omitirse. El valor predeterminado es "0%", si el valor del atributo no puede calcularse a partir de los atributos height y top. |
Posición inferior del contenido, expresada como un porcentaje de la dimensión de altura del dispositivo de exhibición, o como un valor absoluto. Coloca la posición inferior del contenido a exhibir a la distancia especificada desde el borde inferior del dispositivo de exhibición. |
| left | Un número real en el rango [0,100] que termina con el carácter "%" (por ejemplo, 30%), o un valor entero no negativo que especifica el atributo en píxeles. Para valores en píxeles, el calificador de unidad "px" puede omitirse. El valor predeterminado es "0%", si el valor de right no está especificado. |
Posición izquierda del contenido, expresada como un porcentaje de la dimensión de ancho del dispositivo de exhibición, o como un valor absoluto. Coloca la posición izquierda del contenido a exhibir a la distancia especificada desde el borde izquierdo del dispositivo de exhibición. |
| right | Si se especifican los valores left y width, debe calcularse en función de estos valores. De lo contrario, debe ser un número real en el rango [0,100] que termina con el carácter "%" (por ejemplo, 30%), o un valor entero no negativo que especifica el atributo en píxeles. Para valores en píxeles, el calificador de unidad "px" puede omitirse. El valor predeterminado es "0%", si el valor del atributo no puede calcularse a partir de los atributos width y left. |
Posición derecha del contenido, expresada como un porcentaje de la dimensión de ancho del dispositivo de exhibición, o como un valor absoluto. Coloca la posición derecha del contenido a exhibir a la distancia especificada desde el borde derecho del dispositivo de exhibición. |
| width | Un número real en el rango [0,100] que termina con el carácter "%" (por ejemplo, 30%), o un valor entero no negativo que especifica el atributo en píxeles. Para valores en píxeles, el calificador de unidad "px" puede omitirse. El valor predeterminado es "0%". |
Ancho del contenido a exhibir, expresado como un porcentaje de la dimensión de ancho del dispositivo de exhibición, o como un valor absoluto. |
| height | Un número real en el rango [0,100] que termina con el carácter "%" (por ejemplo, 30%), o un valor entero no negativo que especifica el atributo en píxeles. Para valores en píxeles, el calificador de unidad "px" puede omitirse. El valor predeterminado es "0%". |
Altura del contenido a exhibir, expresada como un porcentaje de la dimensión de altura del dispositivo de exhibición, o como un valor absoluto. |
| location | Consulte las propiedades "left" y "top". | Dos números separados por coma, cada uno siguiendo la regla especificada para las propiedades "left" y "top", respectivamente. |
| size | Consulte las propiedades "width" y "height". | Dos números separados por coma, cada uno siguiendo la regla especificada para las propiedades "width" y "height", respectivamente. |
| bounds | Consulte las propiedades "left", "top", "width" y "height". | Cuatro números separados por coma, cada uno siguiendo la regla especificada para las propiedades "left", "top", "width" y "height", respectivamente. |
| background | "white", "black", "silver", "gray", "red", "maroon", "fuchsia", "purple", "lime", "green", "yellow", "olive", "blue", "navy", "aqua" o "teal". También puede ser el valor reservado "transparent". El valor predeterminado es "transparent". |
El color de fondo utilizado para rellenar el área de una región donde se muestra el contenido multimedia que no está ocupada por el propio contenido. |
| rgbChromakey | Color RGB definido mediante notación hexadecimal (hex) para la combinación de valores de color Rojo, Verde y Azul (RGB). El valor más bajo que se puede asignar a una de las fuentes de luz es 0 (hex 00). El valor más alto es 255 (hex FF). También puede definirse mediante las palabras reservadas: "white", "black", "silver", "gray", "red", "maroon", "fuchsia", "purple", "lime", "green", "yellow", "olive", "blue", "navy", "aqua" o "teal". |
El color RGB que se establecerá como transparente. |
| visible | "true" o "false". El valor predeterminado es "false". |
Permite que la presentación del objeto sea visible u oculta. Cuando la propiedad visible asociada con un elemento <context> o <body> es igual a "true", se tiene en cuenta la propiedad visible de cada elemento secundario de la composición para definir cómo se exhibirá cada uno de ellos. Cuando la propiedad visible asociada con un elemento <context> o <body> es igual a "false", todos los elementos secundarios de la composición se exhiben como ocultos. Cabe señalar que un objeto con una propiedad visible igual a "false", es decir, un objeto exhibido como oculto, no puede tener ninguna de sus anclas de contenido seleccionada mientras el valor de la propiedad visible persista como "false". Cuando un documento tiene su elemento <body> con su propiedad visible establecida en "false" y su evento de presentación está en estado pausado, se dice que el documento está en espera (stand-by). En el estándar ISDB-T, cuando solo hay una aplicación en ejecución y esta aplicación está en stand-by, el video principal del servicio se dimensiona al 100% de la pantalla y el audio principal se establece al 100% de su volumen. |
| transparency | Un número real en el rango [0,1] o un número real en el rango [0,100] que termina con el carácter "%" (por ejemplo, "30%"). El valor predeterminado es "0%". |
Indica el grado de transparencia de la presentación de un objeto: "1" o "100%" significa transparencia total y "0" o "0%" significa opaco. |
| fit | "fill", "hidden", "meet", "meetBest" o "slice". El valor predeterminado es "fill". |
Indica cómo se presentará un objeto. "fill": escala el contenido multimedia del objeto para que toque todos los bordes del cuadro definido por las propiedades "width" y "height" del objeto. "hidden": si la "height" ("width") intrínseca del contenido multimedia es menor que la propiedad "height" ("width"), el objeto debe renderizarse comenzando desde el borde "top" ("left") y rellenar el resto de la "height" ("width") con el color de fondo; si la "height" ("width") intrínseca del contenido multimedia es mayor que la propiedad "height" ("width"), el objeto debe renderizarse comenzando desde el borde superior (izquierdo) hasta alcanzar la altura (ancho) definida en la propiedad; la parte del contenido multimedia debajo (a la derecha) de la altura (ancho) se recorta. "meet": escala el objeto multimedia visual preservando su relación de aspecto hasta que su altura o ancho sea igual al valor especificado por las propiedades "height" o "width". La esquina superior izquierda del contenido multimedia se posiciona en las coordenadas superiores izquierdas del cuadro; el espacio vacío a la derecha o abajo debe rellenarse con el color de fondo. "meetBest": la semántica es idéntica a "meet", excepto que la imagen no se escala más allá del 100% en ninguna dimensión. "slice": escala el contenido multimedia visual preservando su relación de aspecto hasta que su altura o ancho sean iguales al valor especificado en las propiedades "height" y "width" y el cuadro de presentación definido esté completamente lleno. Algunas partes del contenido pueden recortarse. El exceso de ancho se recorta desde la derecha del objeto multimedia. El exceso de altura se recorta desde la parte inferior del objeto multimedia. |
| scroll | "none", "horizontal", "vertical", "both" o "automatic". El valor predeterminado es 0. |
Permite especificar cómo se configura el desplazamiento (scroll) en una región de exhibición. |
| zIndex | Un número entero en el rango [0,255]. El valor predeterminado es 0. |
El atributo zIndex especifica la precedencia de superposición, donde los objetos con mayores valores de zIndex se apilan encima de los objetos con menores valores de zIndex. |
| plan | "video", "graphic" o "background". El valor predeterminado es "video" para medios cuyo atributo src hace referencia a un PES de un flujo de transporte, o "graphic" para todos los demás casos. |
Define en qué plano de una pantalla estructurada se colocará un objeto. |
| focusBorderColor | "white", "black", "silver", "gray", "red", "maroon", "fuchsia", "purple", "lime", "green", "yellow", "olive", "blue", "navy", "aqua" o "teal". El valor predeterminado está definido por la propiedad "default.focusBorderColor" del objeto settings. |
Define el color para decorar la región de la pantalla donde se presenta el objeto en foco, antes de ser seleccionado. |
| selBorderColor | "white", "black", "silver", "gray", "red", "maroon", "fuchsia", "purple", "lime", "green", "yellow", "olive", "blue", "navy", "aqua" o "teal". El valor predeterminado está definido por la propiedad "default.selBorderColor" del objeto settings. |
Define el color para decorar la región de la pantalla donde se presenta el objeto en foco, después de ser seleccionado. |
| focusBorderWidth | Entero. El valor predeterminado está definido por la propiedad "default.focusBorderWidth" del objeto settings. |
Ancho (en píxeles) aplicado al borde de un elemento en foco (0 significa que no aparecerá ningún borde, valores positivos significan que el borde está fuera del contenido del objeto y valores negativos significan que el borde se dibuja sobre el contenido del objeto). |
| focusBorderTransparency | Un valor real entre 0 y 1, o un valor real en el rango [0,100] que termina con el carácter "%" (por ejemplo, "30%"). El valor predeterminado está definido por la propiedad "default.focusBorderTransparency" del objeto settings. |
Transparencia aplicada al borde de un elemento en foco, con "1" o "100%" significando transparencia total y "0" o "0%" significando ninguna transparencia. |
| focusSrc | Los siguientes son valores válidos:
Para el atributo focusSrc cuyo valor identifica el esquema "sbtvd-ts", "isdb-ts" o "ts", el "program_number.component_tag" puede sustituirse por las siguientes palabras reservadas:
|
Especifica una fuente multimedia alternativa para presentarse, en lugar de la presentación actual, si un elemento recibe el foco. Este atributo sigue las mismas reglas que el atributo src del elemento <media>. |
| focusSelSrc | Igual que para focusSrc. | Especifica una fuente multimedia alternativa para presentarse, en lugar de la presentación actual, cuando se selecciona un elemento en foco presionando la tecla de activación ("SELECT" o "ENTER"). Este atributo sigue las mismas reglas que el atributo src del elemento <media>. |
| freeze | "true" o "false". El valor predeterminado es "false". | Define qué sucederá con un objeto al final de su presentación, si el contenido final se congela ("true") o no ("false"). El valor predeterminado es "false". |
| transIn, transOut | Lista de (type, subtype, dur, startProgress, endProgress, direction, fadeColor, horzRepeat, vertRepeat, borderWidth, borderColor) separados por punto y coma donde:
El valor predeterminado de la propiedad es la cadena vacía. Si se especifica un tipo de transición, entonces:
|
El valor de transIn y transOut es una lista de transiciones separadas por punto y coma. El propósito de la lista separada por punto y coma es permitir a los autores especificar un conjunto de transiciones de respaldo si la transición preferida no está disponible. La primera transición de la lista debe ejecutarse si el agente de usuario ha implementado esta transición. Si no está disponible, se debe ejecutar la segunda transición de la lista, y así sucesivamente. Los atributos type y subtype definen la transición. El atributo dur especifica la duración de la transición. El atributo startProgress especifica la cantidad de progreso de la transición en la que comenzar la ejecución. Por ejemplo, podemos querer comenzar un crossfade con la imagen de destino ya desvanecida en un 30%. En este caso, startProgress sería 0.3. El atributo endProgress especifica la cantidad de progreso de la transición en la que finalizar la ejecución. El valor de este atributo debe ser mayor o igual que el valor del atributo startProgress. Si endProgress es igual a startProgress, la transición permanece en un progreso fijo durante toda su duración. El atributo direction especifica la dirección en la que se ejecutará la transición. Tenga en cuenta que no todas las transiciones tendrán interpretaciones inversas significativas. Por ejemplo, un crossfade no es una transición geométrica y, por lo tanto, no tiene interpretación de dirección inversa. En las transiciones que no tienen interpretación inversa se debe ignorar el atributo direction y asumir el valor predeterminado "forward". Si el valor del atributo type es "fade" y el valor del atributo subtype es "fadeToColor" o "fadeFromColor", el atributo fadeColor especifica el color final o inicial del desvanecimiento. Si el valor del atributo type no es "fade", o el valor del atributo subtype no es "fadeToColor" o "fadeFromColor", se ignora el atributo fadeColor. Si el valor del atributo type no es "fade", se pueden especificar los siguientes atributos: El atributo horzRepeat especifica cuántas veces realizar el patrón de transición a lo largo del eje horizontal. El atributo vertRepeat especifica cuántas veces realizar el patrón de transición a lo largo del eje vertical. El atributo borderWidth especifica el ancho de un borde generado a lo largo de un borde de barrido (wipe). El atributo borderColor especifica el contenido del borde generado a lo largo de un borde de barrido (wipe). Si el valor de este atributo es un color, el borde generado se rellena con este color. Si el valor de este atributo es "blend", el borde generado es una mezcla aditiva (o desenfoque) de las fuentes multimedia. |
Propiedades predefinidas para <media> elementos con contenido multimedia continuo (solo lectura)¶
| Nombre | Valor | Descripción |
|---|---|---|
| ID de contenido | String. (Establecido solo por el reproductor NCL.) El valor predeterminado es nulo. |
La propiedad "contentId" está asociada a objetos de medios continuos cuyo contenido se define haciendo referencia a un flujo elemental. Tiene null como valor inicial y se establece en el valor del identificador transportado en el descriptor de referencia NPT (en un campo del mismo nombre: contentId), tan pronto como se inicia el objeto de medios continuos asociado. |
| en espera | "true" o "false". (Establecido solo por el reproductor NCL). El valor predeterminado es "falso". |
La propiedad "en espera" se establece en "verdadero" mientras que un contenido de objeto de medios continuos ya iniciado que hace referencia a una secuencia elemental es interrumpido temporalmente por otro contenido entrelazado, en la misma secuencia elemental. |
Propiedades predefinidas para <media> elementos con contenido audible¶
| Nombre | Valor | Descripción |
|---|---|---|
| nivel de sonido | Un número real en el rango [0,1] o un número real en el rango [0,100] que termina con el carácter "%" (por ejemplo, "30%"). El valor predeterminado es 1. |
Volumen de audio relativo al audio grabado. |
| nivel de equilibrio | Un número real en el rango [-1,1] o un número real en el rango [-100,100] que termina con el carácter "%" (por ejemplo, "30%"). El valor predeterminado es 0. |
Nivel de balance del audio (-1 a la izquierda y +1 a la derecha). |
| nivel de agudos | Un número real en el rango [0,1] o un número real en el rango [0,100] que termina con el carácter "%" (por ejemplo, "30%"). El valor predeterminado es 1. |
Configuración de agudos, relativa al audio grabado. |
| nivel de bajo | Un número real en el rango [0,1] o un número real en el rango [0,100] que termina con el carácter "%" (por ejemplo, "30%"). El valor predeterminado es 1. |
Configuración de graves, relativa al audio grabado. |
| congelar | "verdadero" o "falso". El valor predeterminado es "falso". |
Esta propiedad define lo que sucederá con un objeto al final de su presentación, si el contenido final está congelado ("verdadero") o no ("falso"). |
| transIn, transOut | Una lista del formato "(type,subtype,dur,startProgress,endProgress)" donde:
El valor predeterminado de la propiedad es la cadena vacía. Si se especifica una transición, entonces:
|
El tipo de transIn y transOut siempre es "fundido" y el subtipo siempre es "fundido" y está definido de forma predeterminada. El atributo dur especifica la duración de la transición. El atributo startProgress especifica la cantidad de progreso a través de la transición en la que comenzar la ejecución. El atributo endProgress especifica la cantidad de progreso a través de la transición en la que finalizar la ejecución. El valor de este atributo debe ser mayor o igual al valor del atributo startProgress. Si endProgress es igual a startProgress, entonces la transición permanece en un progreso fijo mientras dure la transición. |
Propiedades predefinidas para <media> elementos con contenido textual¶
| Nombre | Valor | Descripción |
|---|---|---|
| fontColor | "white", "black", "silver", "gray", "red", "maroon", "fuchsia", "purple", "lime", "green", "yellow", "olive", "blue", "navy", "aqua" o "teal". El valor predeterminado es "white". |
Define el color de la fuente. |
| fontFamily | Una lista priorizada de nombres de familias de fuentes y/o nombres de familias genéricas. Existen dos tipos de nombres de familias de fuentes:
El valor predeterminado de esta propiedad depende del sistema. |
Los valores de la lista están separados por una coma para indicar que son alternativas. |
| textAlign | "left", "right", "center" o "justify". El valor predeterminado es "left". |
Esta propiedad describe cómo se alinea el contenido de texto. |
| fontStyle | "normal" o "italic". El valor predeterminado es "normal". |
Define el estilo de la fuente. |
| fontSize | Entero positivo que termina con los caracteres "px" o "pt", para el tamaño relativo de la fuente expresado en píxeles, o el tamaño absoluto de la fuente expresado en puntos, respectivamente. El valor predeterminado de esta propiedad depende del sistema. |
Establece el tamaño de la fuente en un tamaño fijo en píxeles o en puntos. |
| fontVariant | "small-caps" o "normal". El valor predeterminado es "normal". |
Define un tipo de variación dentro de una familia de fuentes. |
| fontWeight | "normal" o "bold". El valor predeterminado es "normal". |
Esta propiedad selecciona el grosor (peso) de la fuente. |
| freeze | "true" o "false". El valor predeterminado es "false". |
Esta propiedad define qué sucederá con un objeto al final de su presentación, si el contenido final se congela ("true") o no ("false"). |
| transIn, transOut | Lista de (type, subtype, dur, startProgress, endProgress, direction, fadeColor, horzRepeat, vertRepeat, borderWidth, borderColor) separados por punto y coma donde:
El valor predeterminado de la propiedad es la cadena vacía. Si se especifica un tipo de transición, entonces:
|
El valor de transIn y transOut es una lista de transiciones separadas por punto y coma. El propósito de la lista separada por punto y coma es permitir a los autores especificar un conjunto de transiciones de respaldo si la transición preferida no está disponible. La primera transición de la lista debe ejecutarse si el agente de usuario ha implementado esta transición. Si no está disponible, se debe ejecutar la segunda transición de la lista, y así sucesivamente. Los atributos type y subtype definen la transición. El atributo dur especifica la duración de la transición. El atributo startProgress especifica la cantidad de progreso de la transición en la que comenzar la ejecución. Por ejemplo, podemos querer comenzar un crossfade con la imagen de destino ya desvanecida en un 30%. En este caso, startProgress sería 0.3. El atributo endProgress especifica la cantidad de progreso de la transición en la que finalizar la ejecución. El valor de este atributo debe ser mayor o igual que el valor del atributo startProgress. Si endProgress es igual a startProgress, la transición permanece en un progreso fijo durante toda su duración. El atributo direction especifica la dirección en la que se ejecutará la transición. Tenga en cuenta que no todas las transiciones tendrán interpretaciones inversas significativas. Por ejemplo, un crossfade no es una transición geométrica y, por lo tanto, no tiene interpretación de dirección inversa. En las transiciones que no tienen interpretación inversa se debe ignorar el atributo direction y asumir el valor predeterminado "forward". Si el valor del atributo type es "fade" y el valor del atributo subtype es "fadeToColor" o "fadeFromColor", el atributo fadeColor especifica el color final o inicial del desvanecimiento. Si el valor del atributo type no es "fade", o el valor del atributo subtype no es "fadeToColor" o "fadeFromColor", se ignora el atributo fadeColor. Si el valor del atributo type no es "fade", se pueden especificar los siguientes atributos: El atributo horzRepeat especifica cuántas veces realizar el patrón de transición a lo largo del eje horizontal. El atributo vertRepeat especifica cuántas veces realizar el patrón de transición a lo largo del eje vertical. El atributo borderWidth especifica el ancho de un borde generado a lo largo de un borde de barrido (wipe). El atributo borderColor especifica el contenido del borde generado a lo largo de un borde de barrido (wipe). Si el valor de este atributo es un color, el borde generado se rellena con este color. Si el valor de este atributo es "blend", el borde generado es una mezcla aditiva (o desenfoque) de las fuentes multimedia. |
Propiedades predefinidas para <media> elementos de "aplicación/x-ncl-settings" tipo¶
El grupo sistema. Conjunto de propiedades gestionadas por el sistema receptor. Se pueden leer, pero una NCL no puede cambiar sus valores. aplicación, un procedimiento Lua o cualquier otro código imperativo o declarativo procedimiento. Las aplicaciones nativas del receptor pueden cambiar estas propiedades. valores. Deben persistir durante todo el ciclo de vida del receptor.
| Nombre | Valor | Descripción |
|---|---|---|
| idioma.delsistema | Código ISO 639-1. | Idioma de audio. |
| sistema.caption | Código ISO 639-1. | Idioma de los subtítulos. |
| sistema.subtítulo | Código ISO 639-1. | Idioma de subtítulos. |
| sistema.returnBitRate(i) | Número real. | La velocidad de bits total del canal interactivo (i) en kilobytes por segundo. |
| sistema.tamañodepantalla | (Entero, Entero). | Tamaño de pantalla del dispositivo, en (líneas, píxeles/línea), cuando no se define una clase. |
| system.screenGraphicSize | (Entero, Entero). | Resolución establecida para el plano gráfico de la pantalla del dispositivo, en (líneas, píxeles/línea), cuando no se define una clase. |
| sistema.tipo de audio | "mono", "estéreo" o "5.1". | Tipo de dispositivo de audio, cuando no se define una clase. |
| sistema.tamañodepantalla(i) | (Entero, Entero). | Tamaño de pantalla de la clase (i) de dispositivos, en (líneas, píxeles/línea). |
| system.screenGraphicSize(i) | (Entero, Entero). | Resolución establecida para el plano gráfico de pantalla de la clase (i) de dispositivos, en (líneas, píxeles/línea). |
| sistema.audioType(i) | "mono", "estéreo" o "5.1". | Tipo de audio de la clase (i) de dispositivos. |
| sistema.devNumber(i) | Entero. | Número de dispositivos de exhibición registrados en la clase (i). |
| sistema.classType(i) | "pasivo" o "activo". | Tipo de clase (i). |
| system.parentDeviceRegion(i) | Cinco números separados por coma; cada uno siguiendo la regla de valor especificada para las propiedades "izquierda", "arriba", "ancho", "alto" y "zIndex", respectivamente. | Identifica un elemento <region> en otro <regionBase> asociado con el dispositivo principal que crea el mapa de bits enviado a los dispositivos de clase pasiva (i); en la región especificada también se debe exhibir el mapa de bits enviado. |
| sistema.info(i) | Cadena. | Lista de reproductores multimedia de clase (i). |
| sistema.númerodeclase | Entero. | Número de clases que se han definido. |
| sistema.CPU | Número real. | Rendimiento de la CPU en MIPS, respecto a su capacidad para ejecutar aplicaciones. |
| memoria.delsistema | Entero. | Espacio mínimo de memoria en megabytes proporcionado a las aplicaciones. |
| sistema.sistemaoperativo | Cadena (por definir). | Tipo de sistema operativo. |
| system.luaVersión | Cadena (por definir). | Versión del motor Lua soportada por el receptor. |
| sistema.ncl.versión | Cadena (por definir). | Versión en idioma NCL. |
| sistema.GingaNCL.versión | Cadena (por definir). | Versión del entorno Ginga-NCL. |
| sistema.xyz | Cadena. | Cualquier propiedad con el prefijo "sistema" está reservada para uso futuro. |
El grupo usuario. Conjunto de propiedades gestionadas por el sistema receptor. Se pueden leer, pero una NCL no puede cambiar sus valores. aplicación, un procedimiento Lua o cualquier otro código imperativo o declarativo procedimiento. Las aplicaciones nativas del receptor pueden cambiar las propiedades valores. Deben persistir durante todo el ciclo de vida del receptor.
| Nombre | Valor | Descripción |
|---|---|---|
| edad.usuario | Entero. | Edad del usuario. |
| ubicación.usuario | Cadena. | Ubicación del usuario. |
| usuario.género | "m" (masculino) o "f" (femenino). | Género de usuario. |
| usuario.xyz | Cadena. | Cualquier propiedad con el prefijo "usuario" está reservada para uso futuro. |
El grupo predeterminado. Conjunto de propiedades gestionadas por el receptor. sistema. Pueden ser leídos y modificados por una NCL. aplicación, un procedimiento Lua o cualquier otro código imperativo o declarativo procedimiento. Las aplicaciones nativas del receptor pueden cambiar las propiedades valores. Deben persistir durante todo el ciclo de vida del receptor; sin embargo, son se ajustan a sus valores iniciales cuando se sintoniza un nuevo canal.
| Nombre | Valor | Descripción |
|---|---|---|
| default.focusBorderColor | "blanco", "negro", "plateado", "gris", "rojo", "granate", "fucsia", "púrpura", "lima", "verde", "amarillo", "oliva", "azul", "azul marino", "aqua" o "verde azulado". | Color predeterminado aplicado al borde de un elemento enfocado. |
| default.selBorderColor | "blanco", "negro", "plateado", "gris", "rojo", "granate", "fucsia", "púrpura", "lima", "verde", "amarillo", "oliva", "azul", "azul marino", "aqua" o "verde azulado". | Color predeterminado aplicado al borde de un elemento enfocado cuando se activa. |
| default.focusBorderWidth | Entero. | Ancho predeterminado (en píxeles) aplicado al borde de un elemento enfocado. |
| default.focusBorderTransparency | Número en el rango [0,1] o [0,100], que termina con el carácter "%" (por ejemplo, "30%"), donde "1" o "100%" significa transparencia total y "0" o "0%" significa sin transparencia. | Transparencia predeterminada aplicada al borde de un elemento enfocado. |
| predeterminado.xyz | Cadena. | Cualquier propiedad con el prefijo "predeterminado" está reservada para uso futuro. |
El grupo servicio. Conjunto de propiedades gestionadas por el formateador NCL. Se pueden leer y cambiar sus valores mediante una aplicación NCL del mismo servicio. Se pueden leer pero no se pueden cambiar sus valores. mediante un procedimiento Lua o cualquier otro procedimiento de código imperativo o declarativo. Los cambios de variables deben realizarse mediante comandos NCL. Deben persistir en al menos durante el ciclo de vida del servicio.
| Nombre | Valor | Descripción |
|---|---|---|
| servicio.currentFocus | Entero. | El valor focusIndex del elemento <media> en foco. |
| servicio.currentKeyMaster | Cadena. | Identificador id del elemento <media> que controla las teclas de navegación; Si el elemento <media> no se presenta o no está en pausa, el control de la tecla de navegación pertenece al formateador NCL. |
| servicio.xyz | Cadena. | Cualquier propiedad con el prefijo "servicio" sigue las reglas especificadas para el grupo. |
El grupo si. Conjunto de propiedades gestionadas por el middleware. ellos pueden leerse, pero es posible que una NCL no cambie sus valores aplicación, un procedimiento Lua o cualquier otro código imperativo o declarativo procedimiento. Deben persistir al menos hasta la siguiente sintonización de canal.
| Nombre | Valor | Descripción |
|---|---|---|
| si.númeroDeServicios | Entero. | Número de servicios disponibles en el país para el canal sintonizado. Nota: El valor de esta variable debe obtenerse del número de tablas PMT especificadas en la tabla PAT del flujo de transporte recibido en el canal de sintonización (ver ISO/IEC 13818-1:2007). El valor de la variable debe tener en cuenta sólo las tablas PMT cuyos campos código_país, especificados en el descriptor_disponibilidad_país (ver Sección 8.3.6 de la ABNT NBR 15603-2:2007) relacionados con la tabla, son equivalentes al valor de la variable "usuario.ubicación" del nodo configuraciones. |
| si.numberOfPartialServices | Entero | Número de servicios 1-seg disponibles en el país para el canal sintonizado. Nota: El valor de esta variable debe obtenerse del número de tablas PMT especificadas en la tabla PAT del flujo de transporte recibido en el canal de sintonización (ver ISO/IEC 13818-1:2007). El valor de la variable debe tener en cuenta sólo las tablas PMT cuyos campos country_code, especificados en el country_availability_descriptor (ver Sección 8.3.6 de la ABNT NBR 15603-2:2007) relacionados con la tabla, son iguales al valor de la variable "user.location" del nodo settings, y cuyos campos program_number son equivalentes a los campos service_id del descriptor_recepción_parcial relacionado con las tablas NIT. |
| si.númerodecanal | Entero | Número del canal sintonizado. Nota: El valor de esta variable debe obtenerse del archivo remote_control_key_id del ts_information_descriptor (ver Sección 8.3.42 de la ABNT NBR 15603-2:2007) de la tabla NIT (ver Sección 7.2.4 de la ABNT NBR 15603-2:2007) que describe el servicio actual. |
| si.xyz | Cadena | Cualquier propiedad con el prefijo "si" sigue las reglas especificadas para el grupo. |
El grupo canal. Conjunto de propiedades gestionadas por el formateador NCL. Se pueden leer y cambiar sus valores mediante una aplicación NCL del mismo canal. Se pueden leer pero no se pueden cambiar sus valores. mediante un procedimiento Lua o cualquier otro procedimiento de código imperativo o declarativo de el mismo canal; Los cambios de variables deben realizarse mediante comandos NCL. ellos debe persistir al menos hasta la siguiente sintonización de canal.
| Nombre | Valor | Descripción |
|---|---|---|
| canal.keyCapture | Cadena | Solicitud de claves alfanuméricas para aplicaciones NCL. |
| canal.tecladovirtual | "verdadero" o "falso" | Solicitud de un teclado virtual para aplicaciones NCL. |
| canal.keyboardBounds | (Entero, Entero, Entero, Entero) | Región del teclado virtual (izquierda, arriba, ancho, alto). |
| canal.xyz | Cadena | Cualquier variable con el prefijo "canal" sigue las reglas especificadas para el grupo. |
El compartido. Conjunto de propiedades gestionadas por el formateador NCL. ellos se pueden leer y cambiar sus valores mediante una aplicación NCL. ellos pueden ser leídos, pero sus valores no pueden cambiarse mediante un procedimiento Lua o cualquier otro procedimiento de código imperativo o declarativo; Los cambios variables deben ser hecho usando comandos NCL. Deben persistir al menos durante el ciclo de vida. del servicio que los ha definido.
| Nombre | Valor | Descripción |
|---|---|---|
| compartido.xyz | Cadena | Cualquier propiedad con el prefijo "compartido" sigue las reglas especificadas para el grupo. |
Nombres reservados para la definición de color¶
| Color | Nombre | Hexadecimal | (R,G,B) | Tono | (Saturación, Luz) | (Saturación, Valor) |
|---|---|---|---|---|---|---|
| Blanco | #ffffff | (100%, 100%, 100%) | 0° | (0%, 100%) | (0%, 100%) | |
| Plata | #c0c0c0 | (75%, 75%, 75%) | 0° | (0%, 75%) | (0%, 75%) | |
| Gris | #808080 | (50%, 50%, 50%) | 0° | (0%, 50%) | (0%, 50%) | |
| Negro | #000000 | (0%, 0%, 0%) | 0° | (0%, 0%) | (0%, 0%) | |
| Rojo | #ff0000 | (100%, 0%, 0%) | 0° | (100%, 50%) | (100%, 100%) | |
| Granate | #800000 | (50%, 0%, 0%) | 0° | (100%, 25%) | (100%, 50%) | |
| Amarillo | #ffff00 | (100%, 100%, 0%) | 60° | (100%, 50%) | (100%, 100%) | |
| Oliva | #808000 | (50%, 50%, 0%) | 60° | (100%, 25%) | (100%, 50%) | |
| Lime | #00ff00 | (0%, 100%, 0%) | 120° | (100%, 50%) | (100%, 100%) | |
| Verde | #008000 | (0%, 50%, 0%) | 120° | (100%, 25%) | (100%, 50%) | |
| Aqua | #00ffff | (0%, 100%, 100%) | 180° | (100%, 50%) | (100%, 100%) | |
| Verde azulado | #008080 | (0%, 50%, 50%) | 180° | (100%, 25%) | (100%, 50%) | |
| Azul | #0000ff | (0%, 0%, 100%) | 240° | (100%, 50%) | (100%, 100%) | |
| Marina | #000080 | (0%, 0%, 50%) | 240° | (100%, 25%) | (100%, 50%) | |
| Fucsia | #ff00ff | (100%, 0%, 100%) | 300° | (100%, 50%) | (100%, 100%) | |
| Púrpura | #800080 | (50%, 0%, 50%) | 300° | (100%, 25%) | (100%, 50%) |