Previous:Command Line Switches   Main Index   Next:Using the POVINI Environment Variable

Usando archivos INI

Debido a que es dificultoso configurar mas que unas pocas opciones en una línea de comandos, tienes la posibilidad de poner múltiples opciones en uno o más archivos de texto. Estos archivos de inicialización o archivos INI tienen por defecto la extensión .ini. Versiones anteriores de POV-Ray los llamaban archivos default o archivos DEF. Puedes seguir usando los archivos DEF existentes con esta versión de POV-Ray.

La mayoría de las opciones que usas podrán ser almacenadas en archivos INI. Los interruptores de línea de comandos se recomiendan para aquellas opciones que puedes desactivar y activar frecuentemente mientras realizas pruebas de trazado en una escena que estas desarrollando. El archivo povray.ini es automáticamente leído si esta presente. Puedes especificar archivos INI adicionales en al línea de comandos simplemente tipeando el nombre del archivo en ella.
Por ejemplo:

          POVRAY MYOPTS.INI
Si no se da la extensión, entonces se asume que esta es .ini. POV-Ray sabe que no es un interruptor ya que no es precedido por un signo mas o menos. De hecho un error común entre los usuarios nuevos es olvidarse de poner el interruptor +I antes del nombre del archivo de entrada. Sin el interruptor, POV-Ray piensa que el archivo de escena simple.pov es un archivo INI. ¡No olvides! Si no hay un signo mas o menos precediendo a un interruptor de la línea de comandos, este es asumido como si fuera el nombre de un archivo INI.

Puedes tener múltiples archivos INI en la línea de comandos junto con interruptores. Por ejemplo:

  POVRAY MYOPTS +V OTHER
Esto lee las opciones desde myopts.ini, luego configura el interruptor +V, entonces lee las opciones desde other.ini.

Un archivo INI es un archivo de texto ASCII con opciones de la forma...

  Option_keyword=VALUE ; el texto luego del punto y coma es un comentario
Por ejemplo el INI equivalente al interruptor +Isimple.pov es...
  Input_File_Name=simple.pov
Las opciones son leídas de arriba hacia abajo en el archivo, pero en general pueden especificarse en cualquier orden. Si especificas mas de una opción, el valor previo es sobrescrito con la ultima especificación. La única excepción es la opción Library_Path=path. Unicamente pueden especificarse hasta un máximo de diez paths.

Casi todas las opciones de tipo INI tienen un interruptor +/- equivalente. La sección Referencia de las Opciones da una descripción detallada de todas las opciones de POV-Ray. Esta incluye tanto las configuraciones de tipo INI como los interruptores +/-.

The INI keywords are not case sensitive. Solamente se permite una opción por cada línea de texto. Puedes también incluir interruptores en tu archivo INI si esto te resulta más fácil. Puedes tener múltiples interruptores por cada línea pero asegúrate de no mezclar interruptores y opciones INI en la misma línea. Puedes anidar archivos INI simplemente poniendo el nombre del archivo en una línea del mismo sin ningun signo igual despues de el. El anidado puede tener una profundidad de hasta diez niveles.

Por ejemplo:

  ; Este es un ejemplo de un archivo INI. El total de esta línea es un comentario.
  ; Las líneas en blanco están permitidas.
  Input_File_Name=simple.pov ;Esto configura el nombre del archivo de entrada
  +W80 +H60 ; los interruptores +/- tradicionales también están permitidos
  MOREOPT   ; Lee MOREOPT.INI y continua con la línea siguiente
  +V        ; Otro interruptor
  ; ¡Eso es todo Amigos!


Los archivos INI pueden tener secciones etiquetadas, de este modo mas de un juego de opciones pueden se almacenadas en un solo archivo. Cada sección comienza con una etiqueta entre corchetes []. Por ejemplo:

  ; RES.INI
  ; Este ejemplo de archivo INI es utilizado para configurar la resolución.
  +W120 +H100  ; Esta sección no tiene etiqueta.
               ; Seleccionala con "RES"
  [Low]
  +W80 +H60    ; Esta sección tiene etiqueta.
               ; Seleccionala con "RES[Low]"
  [Med]
  +W320 +H200  ; Esta sección tiene etiqueta.
               ; Seleccionala con "RES[Med]"
  [High]
  +W640 +H480  ; Las Etiquetas pueden ir en mayúsculas o minúsculas.
               ; "RES[high]" funciona
  [Really High]
  +W800 +H600  ; Las etiquetas pueden contener espacios en blanco
Cuando especificas el archivo INI asegúrate de seguirlo con la etiqueta de sección entre corchetes. Por ejemplo...
  POVRAY RES[Med] +Imyfile.pov
POV-Ray lee res.ini y saltea todas las opciones hasta encontrar la etiqueta Med. Procesa las  opciones después de la etiqueta hasta que encuentra otra etiqueta y entonces la saltea. Si no se especifica una etiqueta en la línea de comandos entonces solo se lee la sección sin etiqueta que este al principio del archivo. Si se especifica una etiqueta, el área no etiquetada es ignorada.

Debido a que un espacio en blanco es considerado un delimitador para los interruptores de la línea de comandos, POV-Ray tiene dificultad para leer nombres de archivo o etiquetas que contienen espacios. La regla es que las opciones de estilo INI permiten espacios en archivos INI pero los interruptores no permiten los espacios ya sea en archivos INI o en la línea de commandos. Por ejemplo:

 +Imy file.pov               ;no funciona de ninguna forma

 Input_File=my file.pov      ;funciona solo en archivos INI
Para anidar archivos INI que contienen espacios en blanco en el nombre del archivo o de etiquetas usa la  opción Include_INI de esta forma:
  Input_File=my file.pov

  Include_Ini=my options[this section]

Previous:Command Line Switches   Main Index   Next:Using the POVINI Environment Variable

1