Sentencia de definición
para '.ini' de localidad
DEF_OPCIONES


Permite definir un sistema de opciones para que el jugador seleccione una de entre cuatro posibles. Se puede usar para plantear opciones al jugador y en función de lo que responda procesar una serie de comandos.


Sintaxis:

DEF_OPCIONES
NUM_OPCIONES número_opciones
TITULO color, texto_título
TEXTO_PREGUNTA color, texto_pregunta
TEXTO_PREGUNTA color, texto_pregunta
TEXTO_PREGUNTA color, texto_pregunta
TEXTO_PREGUNTA color, texto_pregunta

TEXTO_OPCION_A color, texto_respuesta_A
TEXTO_OPCION_A color, texto_respuesta_A
TEXTO_OPCION_A color, texto_respuesta_A
TEXTO_OPCION_A color, texto_respuesta_A

TEXTO_OPCION_B color, texto_respuesta_B
TEXTO_OPCION_B color, texto_respuesta_B
TEXTO_OPCION_B color, texto_respuesta_B
TEXTO_OPCION_B color, texto_respuesta_B

TEXTO_OPCION_C color, texto_respuesta_C
TEXTO_OPCION_C color, texto_respuesta_C
TEXTO_OPCION_C color, texto_respuesta_C
TEXTO_OPCION_C color, texto_respuesta_C

TEXTO_OPCION_D color, texto_respuesta_D
TEXTO_OPCION_D color, texto_respuesta_D
TEXTO_OPCION_D color, texto_respuesta_D
TEXTO_OPCION_D color, texto_respuesta_D
FIN_DEF_OPCIONES


Significado de los parámetros de esta sentencia:

  • número_opciones: Número del sistema de opciones que queremos definir (entre 1 y 8).
    Podemos definir hasta 8 sistemas de opciones diferentes por localidad. Puedes asignar el número de sistema de opciones que quieras del 1 al 8 mientras no lo hayas utilizado para otra definición de opciones en la misma localidad. Este número de sistema de opciones nos servirá de referencia para controlar las opciones, en tiempo de juego, mediante comandos.

  • color, texto_título: Número de color y texto del título del sistema de opciones que estamos definiendo (máximo 32 caracteres).
    Nos permite situar un texto como título del sistema de opciones. Lo podemos usar, por ejemplo, para mostrar el texto 'Selecciona una opción' o 'Elige una opción' o 'Tú eliges' o lo que queramos.
    Este texto aparecerá en la pantalla táctil, justo encima de las letras de opciones que podrá seleccionar el jugador.

  • color, texto_pregunta: Número de color y una de las líneas de texto que formará la pregunta o cuestión que le plantearemos al jugador (máximo 27 caracteres por línea).
    Puedes entrar hasta 4 líneas. Si no necesitas tantas líneas, no es necesario que uses todos los parámetros TEXTO_PREGUNTA.

  • color, texto_respuesta_A: Número de color y una de las líneas de texto que formará la primera opción (máximo 27 caracteres por línea).
    Puedes entrar hasta 4 líneas por opción (hasta 4 opciones). Si no necesitas tantas líneas ni tantas opciones, no es necesario que uses todos los parámetros TEXTO_OPCION_...
    En estas líneas debes explicar al jugador cada una de las opciones que tiene en ese momento, como por ejemplo elegir un camino, una puerta, un objeto, una acción (atacar o huir), una respuesta a un personaje, que palanca quiere accionar, etc...


    Cuando hagamos aparecer un sistema de opciones, las líneas de texto de las opciones aparecerán en la pantalla no táctil junto a una letra (A, B, C o D), mientras que en la pantalla táctil aparecerán esas mismas letras para que el jugador pueda elegir entre las cuatro opciones posibles.


    Ejemplo 1:
    Definir un sistema de opciones en la localidad 19 que muestre 4 opciones al jugador.
    En el fichero '.ini' de la localidad 19 ('loc019a.ini'), incluiremos la siguiente sentencia:
    DEF_OPCIONES
      NUM_OPCIONES 5
      TITULO 2, ***** (Elige una opción) *****
      TEXTO_PREGUNTA 0, Te encuentras con un zombie
      TEXTO_PREGUNTA 0, que está comiendo.
      TEXTO_PREGUNTA 0, ¿Qúe haces con el zombie?
    
      TEXTO_OPCION_A 5, Le cortas el cuello con
      TEXTO_OPCION_A 5, el machete
    
      TEXTO_OPCION_B 1, Le das una patada y sigues
      TEXTO_OPCION_B 1, tu camino
    
      TEXTO_OPCION_C 6, Le envenenas la comida
    
      TEXTO_OPCION_D 2, Sigues avanzando sin
      TEXTO_OPCION_D 2, hacerle caso
    FIN_DEF_OPCIONES

    Con las líneas de este ejemplo, quedará definido este sistema de opciones solamente para la localidad 19. Si quieres definir este diálogo para otra localidad, no hay ningún problema, pero tendrás que repetir la definición en el fichero '.ini' de esa localidad.

    La definición ya la tenemos hecha, pero con sólo hacer esto nuestro sistema de opciones nunca aparecerá en pantalla, de eso se encargará el comando 'MOSTRAR_OPCIONES', que tendrás que usar en el momento que tu aventura lo requiera para plantear las opciones al jugador según las circunstancias adecuadas de la trama de tu aventura.
    Si por ejemplo quieres que este sistema de opciones se muestre cada vez que el jugador entre en la localidad, sólo tendríamos que incluir estas líneas de comandos en el fichero '.ini' de la localidad 19:
    IF COND EVENTO_LOCALIDAD=SI
      COMANDO MOSTRAR_OPCIONES 5
    ENDIF


    Cuando el jugador haya realizado su elección, tendremos en la variable del sistema llamada OPCION_SELECCIONADA la letra que el jugador haya elegido.
    Modificando el ejemplo anterior podremos ver en la consola de texto la letra que se selecciona el jugador en cada momento:

    IF COND EVENTO_LOCALIDAD=SI
      COMANDO MOSTRAR_OPCIONES 5
      COMANDO TEXTO_CONSOLA Opción=%OPCION_SELECCIONADA%
    ENDIF



    Ya te puedes imaginar las posibilidades que ofrece este sistema de presentar y controlar opciones si lo combinas con condiciones y comandos adecuados en cada situación de tu aventura gráfica.


    Debes usar tantas definiciones 'DEF_OPCIONES' como sistemas de opciones diferentes quieras definir en la localidad. Tendrás que definir solamente los sistemas de opciones que vayas a usar en esa localidad, ni uno más ni uno menos.



    Consulta la estructura de datos del fichero fichero .ini de la localidad para saber en que orden debes incluir esta sentencia dentro del fichero.