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

Aritmética

Funcionalidad	Descripción	a + b
Suma[a,b, ...]	Representa adición	a - b
Sustraer[a,b]	Representa sustracción	-a
Menos[a]	Convierte a negativo el número	a * b
Por[a,b,...]	Representa multiplicación	a / b
Dividir[a,b]	Representa división

⚠

The logical not and multiplication operator are not at the same precedence level as a lot of other languages. For example !a + !b is !(!a + !(b)) not (!a) + (!b) as expected, similarly 1 * 2 / 3 is 1 * (2 / 3) not (1 * 2) / 3
Please also note that some combinations of prefix and infix operators are not recognised. For example a*-b is not accepted. Use a*(-b) or -a*b instead.