El formato de objeto .animated

■ Contenidos

• 1. Vista general
• 2. Secciones
• 3. Lista de operadores para notación aritmética
• 4. Lista de funciones
• 5. Lista de variables
• 6. Rendimiento
• 7. Consejos
• 8. Funciones de ejemplo
• 9. Gramática Formal

■ 1. Vista general

El formato .ANIMATED de objeto es un formato contenido habilitandote de referir otros objetos (B3D/CSV/X) y de aplicar animación en ellos. Esto también permite agrupar otros objetos (incluyendo otros objetos .ANIMATED) sin animarlos.

Los objetos animados también pueden ser usados en rutas CSV/RW (a menos que este explicita mente deshabilitado por algunos comandos), así como los objetos externos del tren por extensions.cfg, y así como la cabina 3D por el archivo panel.animated.

● Fundamento

La animación es realizada por las siguientes directrices:

• Cambios de estado - básicamente habilitando de cambiar entre diferentes objetos en cualquier tiempo.
• Traslación - moviendo objetos en tres direcciones independientes
• Rotación - rotando objetos sobre los tres ejes independientes
• Saltos de textura - habilitando el salto de coordenadas de textura en objetos en dos direcciones independientes

● Una pequeña formalidad

El archivo es un texto plano codificado en cualquier arbitrario [codificación] (/es_mx/information/encodings.html), Sin embargo, UTF-8 con un byte de orden marca es la opción preferida. El modelo de análisis para números es Strict. El nombre de archivo es arbitrario, pero debe tener la extensión .animated. El archivo es interpretado por cada linea, desde arriba hasta abajo.

■ 2. Secciones

● La sección [Include]

Puedes usar la sección [Include] solo para incluir otros objetos, pero sin animarlos. Esto te permite de usar el archivo de objetos ANIMADOS como un contenedor de grupo de otros objetos. Puede haber cualquier cantidad de secciones [Include] dentro del archivo.

Esto inicia la sección.

Defina una serie de objetos B3D/CSV/X/ANIMATED que deben ser incluidas como son.

Esto defina la posición de los objetos, basicamente te permite de separarlos con respecto al resto de los archivos de objeto ANIMADOS.

---

● La sección [Object]

Puedes usar la sección [Object] para crear una sola animación. Esto requiere de configurar un estado a través de los parámetros de Estados, y de usar cualquier combinación de funciones que desees, lo cual provee control sobre la animación. Puede haber cualquier cantidad de secciones [Object] dentro del archivo.

Esto inicia la sección.

Defina la posición del objeto. Esto básicamente corresponde a un comando TranslateALL en el archivo CSV/B3D respectivamente, pero es realizado después de que cualquiera de las funciones es realizada. Por ejemplo, si deseas usar rotación, entonces ten en consideración que la rotación es efectuada sobre el origen (0,0,0). El comando Posición permite de re-posicionar el objeto después de que la rotación es realizada.

Carga n objetos de extensión CSV/B3D/X. Por favor tenga en cuenta que el primer archivo indicado posee estado de indice 0. Usa múltiples archivos solo si deseas usar el cambio de estados.

Esto defina la función para cambiar de estado. El resultado de la fórmula Formula es redondeado al entero mas cercano. Si el entero esta entre 0 y n-1, donde n es el numero de estados definido por los Estados, el estado respectivo es mostrado , de otra manera, ningún objeto es mostrado. Puedes hacer uso del ultimo si deseas que sea un objeto de encendido/apagado con un solo estado.

Esto defina la dirección para la función TranslateXFunction, TranslateYFunction y TranslateZFunction, respectivamente. Las direcciones predeterminadas son:

TranslateXDirection = 1, 0, 0
TranslateYDirection = 0, 1, 0
TranslateZDirection = 0, 0, 1

Esto significa que la función TranslateXFunction se moverá hacia la derecha predeterminado, TranslateYFunction hacia arriba y TranslateZFunction hacia adelante, también es por eso que TranslateXFunction y así sucesivamente llevan sus nombres. Si usted define otras direcciones, entonces simplemente piensa que las tres funciones y sus direcciones asociadas como tres maneras independientes para si mover el objeto en esa dirección

Esto defina la función que moverá el objeto en la dirección respectiva. La Formula necesita retornar la cantidad de metros a mover desde la posición inicial. Los parámetros X, Y y Z en la respectiva dirección son multiplicados por el resultado de la Formula, así que puedes por ejemplo multiplicar la formula por 2 o la dirección por 2 si es que deseas doblar la velocidad del movimiento

Esto defina la dirección para la función RotateXFunction, RotateYFunction y RotateZFunction, respectivamente. Las direcciones predeterminadas son:

RotateXDirection = 1, 0, 0
RotateYDirection = 0, 1, 0
RotateZDirection = 0, 0, 1

Esto significa que la función RotateXFunction rotará sobre el eje X predeterminadamente, RotateYFunction sobre el eje Y, y RotateZFunction sobre el eje Z, también es por eso que RotateXFunction y asi sucesivamente llevan sus nombres. Si usted define otras direcciones, entonces simplemente piense de que estas tres funciones y sus direcciones asociadas como tres maneras independientes para asi rotar el objeto.

Esto defina la función para rotar a lo largo de la dirección respectiva en orden contra-reloj. La Formula necesita regresar el ángulo por el cual rotar en radianes. El orden que estas rotaciones son ejecutadas es: RotateXFunction (primero), RotateYFunction (después) and RotateZFunction (último). Si usted usa más de una función de rotación al momento, ten en mente este orden. De ser necesario, reescribe las direcciones predeterminadas para las rotaciones si necesitas un orden distinto.

Esto defina la amortiguación para la función correspondiente. Si no es usado, la amortiguación no será ejecutada. NaturalFrequency es un valor no negativo correspondiente a la frecuencia angular del supuesta oscilación sin amortiguación en radianes por segundo. DampingRatio es un valor no negativo indicando el tipo de amortiguación. Valores entre 0 y 1 representa baja amortiguación, 1 representa amortiguación crítica, y valores superiores a 1 representan sobre-amortiguación

Esto defina las direcciones para la función TextureShiftXFunction yTextureShiftYFunction, respectivamente. Las direcciones por defecto son:

TextureShiftXDirection = 1, 0
TextureShiftYDirection = 0, 1

Esto significa que TextureShiftXFunction cambiará la textura a la derecha por defecto, y TextureShiftYFunction hacia abajo, también es por eso que TextureShiftXFunction y así sucesivamente llevan sus nombres. Si usted defina otras direcciones, entonces simplemente piense que estas dos funciones y sus direcciones asociadas como dos maneras independientes de cambiar las texturas en los objetos.

Esto defina las funciones para cambiar las texturas en la dirección respectiva. La textura es cambiada por el valor retornado de Formula en coordenadas de textura. La parte entra del resultado es ignorada, y la parte fraccional de 0.5 representa mover la textura a la mitad. El comando SetTextureCoordinate en el objeto defina las coordenadas, que son después agregadas en el resultado de estas formulas.

Esto defina la función el cual mueve un objecto a lo largo de la vía de Rail 0. La Formula debe retornar la distancia en metros, para así el objeto sea movido, respetando las curvas y los cambios de altura de Rail 0

Valor = Timetable: Todas las caras mostrarán la imagen del itinerario configuradas por las rutas CSV/RW.
Valor = None: Las texturas originales se mostrarán en las caras (conducta predeterminada).

Esto defina la mínima cantidad de tiempo que necesita transcurrir para que la función sea actualizada. Un valor de 0 obliga a la función a ser actualizada cada cuadro por segundo. Por favor tenga en cuenta que los objetos fuera del rango visual puedan ser actualizados menos frecuentemente sin importar este parámetro. Usa RefreshRate cuando no necesites una animación suave (en orden de optimizar los recursos), o cuando deliberadamente quieras que el objeto este actualizado con un intervalo personalizado.

---

● La sección [Sound]

Puedes usar la sección [Sound] para agregar efectos de sonidos independientes a objetos animados.

Esto inicia la sección

Esto añade el efecto de sonido a ser reproducido.

Esto define la posición del sonido, relativo al centro del archivo animated.

Esto define el volumen inicial del sonido a la posición de origen. A valor de 1.0 representa el volumen nominal sin cambio del archivo de sonido.

Esto define la velocidad inicial del sonido a la posición de origen. A valor de 1.0 representa el velocidad nominal sin cambio de grado de el archivo de sonido.

Esto defina el radio en metros desde el origen al que el efecto de sonido se reproduce a máximo volumen. El valor predeterminado es 30.

Esto define la función que controla el volumen de el sonido. Formula debe retornar un numero representando el volumen deseado, donde 1.0 representa el volumen nominal sin cambio de el sonido del archivo.

Esto define la función que controla la velocidad de el sonido. Formula debe retornar un numero representando el volumen deseado, donde 1.0 representa la velocidad nominal sin cambio de el sonido del archivo.

Esto defina la función el cual mueve el origen del sonido a lo largo de la vía de Rail 0. La Formula debe retornar la distancia en metros, para así el objeto sea movido, respetando las curvas y los cambios de altura de Rail 0.

---

● La sección [StateChangeSound]

Puedes usar la sección [StateChangeSound] para adjuntar efectos de sonidos a la sección de [Object] precedente.

Esto inicia la sección - Seguido inmediatamente de la sección [Object].

Esto carga el efecto de sonido para ser reproducido en todos los estados de cambio. Otra alternativa como lo es FileNames puede ser usada, el cual se describe a continuación:

Carga una lista de n sonidos, el cual corresponde a los estados de el objeto en la sección [Object] debajo. Si un estado no tiene efecto de sonido, el ítem de la lista debe dejarse en blanco.

Esto define la posición del sonido, relativo al centro del archivo animated.

Esto define el volumen del sonido a la posición de origen. A valor de 1.0 representa el volumen nominal sin cambio del archivo de sonido.

Esto define la velocidad del sonido a la posición de origen. A valor de 1.0 representa el velocidad nominal sin cambio de grado de el archivo de sonido.

Esto defina el radio en metros desde el origen al que el efecto de sonido se reproduce a máximo volumen. El valor predeterminado es 30.

Valor = 0: El efecto de sonido no será reproducido. Valor = 1: El efecto de sonido será reproducido.

This defines whether the sound effect defined above should be played when a the relevant state is shown.

Valor = 0: El efecto de sonido no será reproducido. Valor = 1: El efecto de sonido será reproducido.

This defines whether the sound effect defined above should be played when the relevant state is hidden.

---

---

● Sobre las formulas

Primero que todo, la notación aritmética, lo que puedes teclear dentro del parámetro Formula, es convertido en una notación funcional. Por cada notación aritmética, hay una notación funcional correspondiente. Algunas funciones no tienen un operador aritmético y solo pueden ser teclados en notación funcional. Para los operadores, la precedencia juega un rol importante. Puedes usar paréntesis para sobreponer el orden de precedencia así como generalmente en una fórmula matemática. Los nombres de las funciones no distinguen entre mayúsculas y minúsculas.

■ 3. Lista de operadores aritméticos de notación

● Aritmética básica

● Comparaciones

Todas las comparaciones devuelven 1 para verdadero y 0 para falso.

● Operadores lógicos

Todos los operadores tratan 0 como falso y cualquier otro valor como verdadero, y retornan 1 por verdadero y 0 por falso.

● Operador de precedencia

From highest precedence to lowest. Operators of same precedence are evaluated either left to right or right to left, depending on if they share a precedence with another operator.

■ 4. Lista de funciones

● Aritmética básica

● Funciones numéricas

● Funciones elementales

● Condicionales

■ 5. Lista de variables

● Primitivas

● Tiempo y camara

● Trenes

Generalmente, objetos adjuntados a un tren particular o coche retorna valores para los trenes y cobhes, a menos que sean estados. Para objetos de escenario, la referencia es el coche del conductor del tren más cercano ( no necesariamente el tren del jugador).

En algunos casos de las siguientes variables , IndiceCarro tiene el siguiente significado: 0 es el 1^er carro del frente, 1 es el 2^do carro del frente, etc., mientras que -1 es el 1^er carro desde la parte posterior, -2 es el 2^do carro desde la parte posterior, etc. En general los indices de los carros desde -cars hasta cars-1 representan carros existentes, donde cars es el numero de carros que el tren posee, mientras que valores que estén fuera de este rango representan carros que no existen. Todos los trenes tienen al menos 1 carro, indices -1 y 0 están garantizados que existan para cualquier tren.

● Trenes (generalidades)

● Trenes (freno)

● Trenes (puertas)

● Trenes (otros)

Si pluginState[i] es usado con el sistema de seguridad ATS y ATC, el siguiente mapa de opciones para i puede ser aplicado:

● Secciones (señalización)

El contexto sección es definido cuando el objeto es posicionado usando Track.SigF.

■ 6. Rendimiento

Existen ciertos tipos de animaciones los cuales son menos costosos, y otros que son mas. También, los objetos adyacentes juegan un papel importante . Si quieres diseñar objetos animados con un mejor rendimiento posible para versiones futuras de openBVE, échale un vistazo a la siguiente tabla de rendimiento:

El rendimiento por lo general es mejor si el resultado de la función cambia sin frecuencia. Así que, incluso si habilitas el parámetro RefreshRate a cero, el rendimiento por lo general mejorará si el resultado de su formula es constante sobre largos periodos de tiempo. De otra manera, si cambia cada cuadro por segundo, el rendimiento por lo general empeorará.

Generalmente, debes evitar usar animaciones con caras parcialmente transparentes y enfocarte en caras opacas cuando sea posible. Tambien, intenta evitar los saltos de textura, y considera usar el cambio de estado o traslación donde sea posible.

■ 7. Sugerencias

• Generalmente hablando, trata de mantener la complejidad de las funciones lo mas bajo posible. Esto no es el aspecto más critico, aunque, la mayoría del impacto del rendimiento resultará cuando se aplique resultados a una función, por ejemplo. rotar el objeto, y no evaluando la función.
• Usa el parámetro RefreshRate cuando sea posible para así optimizar el rendimiento. Usualmente, puedes usar este parámetro cuando no necesites una animación suave, o cuando deliberadamente necesites que estas funciones solo se actualicen en intervalos.
• No uses estas funciones cuando siempre evalúas la misma constante. Por ejemplo, no uses RotateXFunction = 3.14159, gira el objeto adyacente en el CSV/B3D/X directamente.
• Cambios de estado son un método muy barato cuando el estado no cambia entre dos ejecuciones por el StateFunction. Si un cambio ocurre, esto es una operación relativamente costosa.
• Trata de optimizar las operaciones condicionales if . Especialmente trata de evitar la anidación de funciones if. De vez en cuando, hay una solución matemática elegante.
• Ciertas funciones, por ejemplo. Exp, Sin, Cos, etc. son relativamente costosas. Úsalas solo cuando sean absolutamente necesarias para un efecto. No incluyas operaciones innecesarias. Por ejemplo, el resultado de StateFunction es automáticamente redondeado hacia el entero más cercano, así que no apliques una función Round adicional explícito.
• Cuando trabajas con objetos del coche, ten en mente que algunas variables tienen un indice de coche opcional (CarIndex). Debes usar este indice si necesitas consultar el estado de un coche en particular ( es decir, no necesariamente el único objeto que puede ser adjuntado). Si, necesitas hacer una consulta el valor de un coche en particular del objeto que se plantea adjuntar, usa la variable sin el indice. Para objetos de escenario, por lo general no debes usar los indices del coche ya sea porque no puedes estar seguros de cuantos coches posee el tren consultado.

■ 8. Funciones de ejemplo

● Luz parpadeante

● Rotación de rueda

● Ciclo a través de una lista de objetos

● Señal (3-aspectos) para Track.Section(0; 2; 4)

● Emplear un retardo en señales de aproximación controlada.

If you want to create a signal that keeps being red until the train approaches it to some distance, then counts down a timer before it changes aspect to green, please refer to this post on the forum for a detailed explanation. Once you understand the concepts, you can use this code template:

Using an approach controlled delay with a semaphore signal requires a slight variant on this technique. As the result of the StateFunction is rounded, whereas that of the RotateFunction is not, a combination of both is required to achieve the desired effect.

■ 9. Gramática formal

La gramática formal del lenguaje puede no coincidir perfectamente con la implementación incluida en openBVE. Un ejemplo es a*-b el cual es válido bajo la gramática pero el analizador lo rechaza.