3.1.2  Añadiendo archivos de inclusión estándar

Usando nuestro editor de textos favorito, creamos un archivo llamado demo.pov. Observa que algunas versiones de POV-Ray vienen con su propio editor de textos incorporado, cuyo uso puede ser más práctico. Hecho esto, tecleamos en el archivo el siguiente texto, teniendo cuidado en utilizar correctamente mayúsculas y minúsculas, ya que POV-Ray distingue entre ambas.

  #include "colors.inc"    // Los archivos de inclusión contienen
  #include "stones.inc"    // elementos de escena predefinidos

La primera sentencia "include" lee las definiciones de algunos colores útiles. La segunda lee una colección de texturas de piedras.

POV-Ray viene dotado de muchos archivos de inclusión estándar. Otros de interés son:

  
  #include "textures.inc"    // elementos de escena predefinidos
  #include "shapes.inc"
  #include "glass.inc"
  #include "metals.inc"
  #include "woods.inc"

Éstos leen respectivamente texturas, formas, cristales, metales y maderas predefinidas. Es una buena idea darles un vistazo para ver algunas de las posibles formas y texturas disponibles.

Deberíamos incluir sólo los archivos que realmente necesitamos en la escena. Muchos de estos archivos de inclusión que vienen con POV-Ray son realmente largos, y haríamos mejor en ahorrar tiempo de análisis y memoria si no los necesitamos. En los siguientes ejemplos, sólo usaremos los archivos de inclusión colors.inc y stones.inc.

Podemos tener tantos archivos de inclusión como necesitemos en un archivo de escena. Los archivos de inclusión pueden incluir a su vez más archivos de inclusión, pero estamos limitados a anidar sólo hasta diez (10) niveles de profundidad.

Los nombres de archivo especificados en las sentencias "include", se buscan primero en el directorio actual. Si no puede encontrarlo en éste, POV-Ray lo buscará en cualquiera de las trayectorias de librerías que hayas especificado. Las trayectorias de librerías son opciones que se establecen mediante el parámetro de línea de comandos +L o la opción Library_Path. Véase el capítulo "Configurando las opciones de POV-Ray" para más información acerca de las trayectorias de librerías.

Ya que es más útil mantener los archivos de inclusión en un directorio diferente, la instalación típica de POV-Ray los coloca en el directorio \povray3\include. Si obtienes un mensaje de error diciendo que POV-Ray no puede abrir "colors.inc" o cualquier otro archivo de inclusión, fíjate si has especificado la trayectoria de librerías adecuadamente.