5.2.5  Salida de Texto

La salida de texto es importante, ya que POV-Ray la utiliza para mantenerte informado sobre lo que va a hacer, lo que está haciendo y lo que ha hecho. El programa divide sus mensajes de texto en 7 salidas diferentes. Algunas versiones de POV-Ray codifican con colores los distintos tipos de salidas de texto, e incluso ver varias páginas de mensajes anteriores. Todas las versiones te permiten activar o desactivar algunas de estas salidas de texto, o redireccionarlas a uno o más ficheros. Esta sección detalla las opciones que te permiten controlar la salida de texto.

5.2.5.1  Tipos de salidas de texto

Existen siete tipos de salida textual distintos, que POV-Ray utiliza en la salida de texto general. En algunas versiones, cada tipo se codifica con un color distinto. El texto de cada una de estas salidas se visualiza cuando corresponde, con lo que a menudo se mezclan entre sí en la salida general. La distinción sólo es importante si se desea desactivar alguna de estas salidas o redireccionarlas hacia archivos de texto. En algunos sistemas, puede que sea posible revisar los distintos tipos por separado, en sus respectivas memorias intermedias.

He aquí una descripción de cada tipo:

Banner: Esta salida visualiza el cartel con la firma del programa, el Copyright, la lista de colaboradores y algunas pantallas de ayuda. No puede ser desactivada ni redireccionada a un fichero, sobre todo porque la mayoría del texto se visualiza antes de que se lean las opciones e interruptores. Así, no puedes usar una opción ni un interruptor para controlarla. Sí existen algunos interruptores para visualizar las pantallas de ayuda, que se describen en la sección "Interruptores de las pantallas de ayuda".

Debug: Esta salida recoge los mensajes de depuración. Fue creada en un principio para uso de los desarrolladores, pero ésta y otras salidas pueden ser usadas por el usuario para mostrar mensajes desde dentro de sus escenas. Mira en la sección "Salida de Mensajes" para más detalles. Esta salida puede ser activada y/o redirigida a un archivo de texto.

Fatal: Esta salida visualiza los mensajes de error fatal. Después de mostrar este texto, POV-Ray finalizará. Cuando el error es un error de análisis de la escenas, se te mostrarán varias líneas del texto de la escena que tienen que ver con el error. Esta salida puede ser desactivada y/o redirigida a un archivo de texto.

Render: Esta salida muestra información acerca de las opciones que has especificado para trazar la escena. Incluye todas las opciones importantes, como el nombre de las escena, resolución, ajustes de animación, anti-alias y otros. Esta salida puede ser desactivada y/o redirigida a un archivo de texto.

Statistics: Esta salida recoge las estadísticas después de trazar el fotograma. Ello incluye la información acerca del número de rayos trazados, el tiempo empleado en el proceso y otros datos. Puede ser desactivada y/o redirigida a un archivo de texto.

Status: Esta salida visualiza mensajes de estado en directo, que informan de lo que POV-Ray está haciendo en cada momento. En algunos sistemas, esta salida se visualiza en una línea de estado al pie de la pantalla. Esta salida no puede ser redirigida a un archivo ya que no sería realmente útil para nada. El texto que muestra la opción Verbose o el interruptor +V se dirige a esta salida, así que en parte puede ser desactivada.

Warning: Esta salida muestra mensajes de alerta durante el análisis del archivo de la escena, así como otro tipo de avisos. Aun así, POV-Ray puede continuar trazando la escena. Serás informado de si POV-Ray ha asumido valores en la escena para poder proceder. En general, cada vez que veas un mensaje de alerta debes asumir que en futuras versiones de POV-Ray puede que no se permita la acción sobre la que se alerta. Así que debes intentar eliminar estos mensajes para que tu escena pueda funcionar con futuras versiones de POV-Ray. Esta salida puede ser desactivada y/o redirigida a un archivo de texto.

5.2.5.2  Salida de Texto de la Consola

Debug_Console=booleano Activa o desactiva la visualización de mensajes de depuración de la consola
+GD Igual que Debug_Console=On
-GD Igual que Debug_Console=Off
Fatal_Console=booleano Activa o desactiva la visualización de mensajes fatales de la consola.
+GF Igual que Fatal_Console=On
-GF Igual que Fatal_Console=Off
Render_Console=booleano Activa o desactiva la visualización de información sobre el trazado en la consola
+GR Igual que Render_Console=On
-GR Igual que Render_Console=Off
Statistic_Console=booleano Activa o desactiva la visualización del texto de estadísticas en la consola
+GS Igual que Statistic_Console=On
-GS Igual que Statistic_Console=Off
Warning_Console=booleano Activa o desactiva la visualización en la consola de los mensajes de alerta
+GW Igual que Warning_Console=On
-GW Igual que Warning_Console=Off
All_Console=booleano Activa o desactiva las salidas "debug", "fatal", "render", "statistic" y "warning" hacia la consola.
+GA Igual que All_Console=On
-GA Igual que All_Console=Off

Puedes suprimir la salida hacia la consola de los flujos "debug", "fatal", "render", "statistic" y "warning". Por ejemplo, la opción Statistic_Console=off o el interruptor -GS se pueden usar para desactivar el flujo de estadísticas. Con on o +GS podrías activarlo de nuevo. También puedes activar o desactivar estos cinco flujos a la vez, usando la opción All_Console o el interruptor +GA.

Nota: observa que estas opciones entran en vigor inmediatamente cuando se especifican. Obviamente, no afectarán a cualquier mensaje de error o de alerta que ocurra antes de que se lea la opción.

5.2.5.3  Redirigiendo salidas de texto hacia archivos

Debug_File=true Redirige la información textual de depuración hacia DEBUG.OUT
Debug_File=false Desactiva la salida a archivo de la información de depuración
Debug_File=file Redirige la información textual de depuración hacia el archivo file
+GDfile Igual que aplicar las opciones Debug_Console=On y Debug_File=file simultáneamente.
-GDfile Igual que aplicar las opciones Debug_Console=Off y Debug_File=file simultáneamente.
Fatal_File=true Redirige el texto de error fatal hacia FATAL.OUT
Fatal_File=false Desactiva la salida hacia archivo del texto de error fatal
Fatal_File=file Redirige la información textual de error fatal hacia el archivo file
+GFfile Igual que Fatal_Console=On, Fatal_File=file.
-GFfile Igual que Fatal_Console=Off, Fatal_File=file
Render_File=true Redirige la información textual de trazado hacia RENDER.OUT
Render_File=false Desactiva la salida de la información de trazado
Render_File=file Redirige la información textual de trazado hacia el archivo file
+GRfile Igual que Render_Console=On, Render_File=file
-GRfile Igual que Render_Console=Off, Render_File=file
Statistic_File=true Redirige el texto de estadísticas hacia STATS.OUT
Statistic_File=false Desactiva la salida a archivo de las estadísticas
Statistic_File=file Redirige las estadísticas hacia el archivo file
+GSfile Igual que Statistic_Console=On, Statistic_File=file
-GSfile Igual que Statistic_Console=Off, Statistic_File=file
Warning_File=true Redirige los mensajes de alerta hacia WARNING.OUT
Warning_File=false Desactiva la salida a archivo de los mensajes de alerta
Warning_File=file Redirige los mensajes de alerta hacia el archivo file
+GWfile Igual que Warning_Console=On, Warning_File=file
-GWfile Igual que Warning_Console=Off, Warning_File=file
All_File=true Redirige la información fatal, de depuración, trazado, estadísticas y alerta hacia ALLTEXT.OUT
All_File=false Desactiva la salida a archivo de la información fatal, de depuración, trazado, estadísticas y alerta.
All_File=file Redirige la información fatal, de depuración, trazado, estadísticas y alerta hacia el archivo file.
+GAfile Igual que All_Console=On, All_File=file
-GAfile Igual que All_Console=Off, All_File=file

Puede que quieras redirigir una de las salidas de texto a un archivo, para guardar la información fatal, de depuración, de trazado, las estadísticas o los mensajes de alerta. Por ejemplo, con la opción Statistic_File=s o el interruptor +GSs. Si la cadena s es true o cualquier otro valor cierto (true) válido, la salida se redirige a un archivo con un nombre por defecto. Los posibles valores true válidos son true, yes, on o 1. Si el valor es false (falso), se desactiva la redirección hacia archivo. Los valores falsos válidos son false, no, off o 0. Cualquier otra cadena especificada activa la salida a archivo y dicha cadena se interpreta como el nombre del archivo de salida.

De manera similar, puedes especificar esta misma cadena tras un interruptor, como +GSfile. También puedes redirigir los cinco tipos de salida hacia el mismo archivo con la opción All_File o el interruptor +GA. No puedes especificar el mismo nombre de archivo para dos o más tipos de salidas, ya que POV-Ray fallaría al intentar abrir el mismo archivo dos veces.

Nota: estas opciones entran en vigor inmediatamente cuando se especifican. Cualquier error o mensaje de alerta que ocurra antes de que se lea la opción, no se verá afectado.

5.2.5.4  Nivel de los mensajes de alerta

Warning_Level=n Permite desactivar distintos tipos de mensajes de alerta (warning).
+WLn Igual que Warning_Level=n

El nivel 0 desactiva todos los tipos de alertas. EL nivel 5 desactiva las alertas relacionadas con la version del lenguaje. El nivel por defecto es 10, que activa todos los tipos de alertas. El resto de niveles están reservados y no deben ser especificados.

5.2.5.5  Interruptores de las Pantallas de Ayuda

+H or +? Muestra la pantalla de ayuda número 0 si no hay más interruptores

Nota: No hay opciones de archivo INI equivalentes para estas opciones.

Después de mostrar las pantallas de ayuda, POV-Ray termina su ejecución. Como algunos sistemas operativos no permiten usar el interrogante como interruptor, puede que necesites usar el interruptor alternativo +H.

Nota: Este interruptor se usa también para especificar la altura de la imagen en píxeles. Así, el interruptor +H se interpreta como el interruptor de ayuda solamente si es el único en la línea de comandos.

La versiones de POV-Ray con interfaz gráfico, como las de Mac o Windows, contienen una ayuda en línea completa.