es/Dynamic X

Dynamic X es un sistema avanzado de manejo de carga dinámica cuyo propósito es otorgar soporte a la transferencia de gráficos y paletas de colores a la VRAM y CGRAM respectivamente. Este sistema vendría a reemplazar al Dynamic Z V3.7 que a su ves es un reemplazo del DSX.

Funcionalidades

• Cargar Poses Dinámicamente: Permite cargar poses para Sprites Dinámicos desde cualquier código ASM.
• Dibujar Poses: Permite dibujar cualquier pose que este registrada en el sistema en cualquier lugar de la pantalla y desde cualquier código ASM. La forma de dibujar esta totalmente optimizada para cada pose, básicamente todas las poses que tienen características similares, usan la misma rutina grafica para optimizar ciclos y que sea lo más eficiente posible, además de disminuir considerablemente la cantidad de ROM utilizada en rutinas graficas, ya que, 1 rutina grafica puede dibujar cientos de poses distintas que pertenecen a distintos Sprites.
• Cargar Gráficos a la VRAM.
• Cargar Paletas de Colores a la CGRAM.
• Asignación Automática de Paletas: Cuando un Sprite carga una paleta, puede pedir al sistema que le asigne una paleta de forma automatizada, este buscara una paleta libre y podrá ser usada por el Sprite, en caso que la paleta ya este cargada en la CGRAM cargada entonces le dará al Sprite esa paleta. El sistema informa si no hay paletas disponibles, de esta manera, se puede evitar que el Sprite intente funcionar con paletas erróneas.
• Efectos de Paletas de Colores: Se puede editar las paletas que están cargadas para que cambien atributos como el Hue (Tinte), la Saturación y el Brillo, se pueden ponderar con un color preestablecido o también quitarle potencia a ciertos canales RGB o HSL.
• Registro de Gráficos y Paletas: El sistema permite insertar gráficos y paletas en el ROM, al hacerlo quedan disponibles la posición en que fueron guardados en el ROM y además puedes saber el ID con que fue registrado en el sistema, puedes utilizar ese ID para cargar dinámicamente esos gráficos. Dynamic X se hará cargo de eliminar los gráficos y paletas guardados previamente por el sistema e insertar los nuevos gráficos y paletas en un lugar libre en la ROM.

Funcionalidades que pueden tener problemas de compatibilidad

• Gráficos Custom para el Player: Dynamic X permite tanto cambiar los gráficos del player usando un EXGFX similar al GFX32 estando limitado a que use el tamaño y la cantidad de poses del juego Vanilla o simplemente deshabilitar completamente la carga dinámica de gráficos del player, yoshi o podoboos para hacer tu propia rutina dinámica para un player custom sin limitaciones de tamaño o cantidad de poses. Esta funcionalidad permite cambiar los gráficos en cualquier momento, por lo que podrías usar distintos players en distintos niveles o en distintas zonas del mismo nivel.
• Paletas Custom para el Player: Dynamic X te permite cambiar la paleta de colores del player libremente.
• Optimizaciones del DMA del Player: Dynamic X disminuye considerablemente los ciclos utilizados por el NMI handler, ya que, los gráficos del player, yoshi y podoboos solo son cargados en la VRAM cuando son requeridos, no siempre como ocurre en el juego Vanilla. Esto además te deja algunos tiles extras en el SP1 en niveles que no utilicen a yoshi o podoboos, incluso un tile extra en niveles que no usen la capa.

Requisitos

• .Net 7

Instalación

Pasos Previos si se utiliza SA-1

1. Abrir sa1.asm.
2. Ir a la Linea:

   !DSX		= 1
   

3. Cambiar por:

   !DSX		= 0
   

4. Reinstalar SA-1.

Pasos Generales

1. Poner todos los archivos con extensión ".framesinfo" en la carpeta "FramesInfo".
2. Poner todos los archivos con extensión ".dynamicinfo" en la carpeta "DynamicInfo".
3. Poner todos los archivos de GFXs y Paletas de colores en la carpeta "DynamicResources".

Usando el Tool Directamente

1. Abrir DynamicXTool.exe.
2. Escribir la ubicación del ROM que se desea modificar, otra opción es arrastrar el ROM a la consola. Si presionas Enter y no has hecho una instalación previa, entonces enviara error, si has hecho una instalación previa entonces usara el path utilizado en la instalación previa.
3. Escribir la ubicación donde se guardara el resultado de la instalación, Si presionas Enter utilizara la ubicación del paso anterior.
4. Escribir la ubicación de la carpeta de Pixi, esto es para instalar los defines. Si presionas Enter se va a saltar este paso o en caso que hayas definido la ubicación en una instalación previa, entonces utilizara esa.
5. Escribir la ubicación de la carpeta de Uberasm Tool, esto es para instalar los defines. Si presionas Enter se va a saltar este paso o en caso que hayas definido la ubicación en una instalación previa, entonces utilizara esa.
6. Escribir la ubicación de la carpeta de GPS, esto es para instalar los defines. Si presionas Enter se va a saltar este paso o en caso que hayas definido la ubicación en una instalación previa, entonces utilizara esa.
7. A continuación el tool te preguntara si deseas cambiar los settings, si escribes "Yes" o "Y" te empezara a preguntar por cada feature por separado, responde "Yes" o "Y" por cada uno que desees instalar y "No", "N" o presionar Enter por cada uno que no quieras instalar, Si escribes "No", "N" o presionas Enter utilizara settings default (todos los features que no tienen problemas de compatibilidad) o si cambiaste los settings en una instalación previa utilizara esos settings.
8. Cuando la instalación termine, re-instala todos los tools o parches que dependan de los recursos dinámicos instalados.

Usando el Tool Desde Consola

Debes llamar el comando:

DynamicXTool "<rom_path>" "<output_path>"

• <rom_path>: Es la ubicación del rom que deseas modificar.
• <output_path>: (optativo) Es la ubicación donde se guardara el resultado. Si no se pone este parametro se utilizara el <rom_path> como ubicación.

El ROM se instalara con los settings default si nunca se ha hecho una instalación previa, si se ha hecho una instalación previa, entonces se usaran los settings usados en esa instalación.

Settings

En caso de querer cambiar los settings manualmente debes abrir el archivo settings.json que se vera así:

{
}

Debes cambiar los parámetros según los settings que desees.