2.5  Notación y Suposiciones Básicas

A lo largo de la sección de tutorial y referencia de este documento, se usa la siguiente notación para marcar palabras claves del lenguaje de descripción de escena, parámetros de línea de comando, palabras claves de archivos INI y nombres de archivos.

palabra clave monoespaciado negrita Palabras claves y signos de puntuación de POV-Ray
+W640 +H480 monoespaciado negrita parámetros de linea de comando
C:\MYFILE.POV monoespaciado nombres de archivo, directorios, rutas
SYNTAX_ITEM cursiva, mayúscula ítem de sintaxis requerido
[SYNTAX_ITEM] cursiva, mayúscula, corchetes ítem de sintaxis opcional
SYNTAX_ITEM... cursiva, mayúscula, elipsis uno o más ítem de sintaxis
[SYNTAX_ITEM...] cursiva, mayúscula, corchetes, elipsis cero o más ítem de sintaxis
Value_1 cursiva, mayúsculas y minúsculas valor flotante o expresión
<Value_1> cursiva, mayúsculas y minúsculas, parénteris angulares valor vector o expresión
[ ITEM ] negrita, corchete ITEM adjunto en corchetes requeridos
ITEM1 | ITEM2 barra vertical elección del ITEM1 o ITEM2

En la versión en ASCII plano del documento, no hay diferencia visible entre las diferentes notaciones.

Nota: POV-Ray es un programa de línea de comandos en UNIX y otros sistemas operativos basados en texto, y es un programa controlado por menús en las plataformas Windows y Macintosh. Algunos de estos sistemas operativos usan carpetas para guardar archivos, mientras que otros usan directorios. Algunos separan las carpetas y subcarpetas con un carácter barra (/), otros con carácter barra invertida (\), u otros.

Hemos intentado hacer esta documentación tan genérica como es posible, pero algunas veces nos tenemos que referir a carpetas, archivos, opciones, etc. y no hay manera de escapar al problema. He aquí algunas suposiciones que efectuamos...

1) Instaló POV-Ray en el directorio "C:\POVRAY35". En MS-Dos este es probablemente el caso, pero para Unix puede ser "/usr/povray3", o para Windows puede ser "C:\Program Files\POV-Ray for Windows v3.5", mientras para Mac puede ser "MyHD:Apps:POV-Ray 35:", o puede haber usado otra unidad o directorio. Así, si le decimos que "Los archivos de inclusión están guardados en el directorio \povray35\include," asumimos que usted puede traducirlo a algo como "::POVRAY35:INCLUDE" o "C:\Program Files\POV-Ray for Windows v3.5\include" o lo que sea apropiado para su plataforma, sistema operativo e instalación.

2) POV-Ray usa archivos INI y/o parámetros de línea de comando (si están disponibles) para elegir opciones en todas las versiones, pero Windows y Mac también tienen cajas de diálogo o menús de elección para configurar opciones. Describiremos las opciones asumiendo que se están usando parámetros o archivos INI cuando se describe lo que hacen las opciones. Nos hemos preocupado de usar la misma terminología tanto en el diseño de los menús y diálogos como en la descripción de parámetros o palabras claves de archivos INI. Vea la documentación específica de su versión acerca de menús y diálogos.

3) Usted está leyendo este texto usando un lector de ayuda, ayuda incluida, navegador de Internet, salida de impresión formateada, o un archivo de texto plano. Asumimos que usted sabe cómo manejarse en el medio que está utilizando. Cuando digamos "Vea el capitulo "Configurando las opciones de POV-Ray", asumimos que usted puede hacer click, navegar, dar vuelta a la página o lo que sea para llegar hasta allí.