Logo POVRay...
Instrucciones para "DHCM.inc" v1.0

Donación de Rafael Angel Campos Vargas, en el año 2020, a la Biblioteca de objetos de POV-Ray.  Este proyecto se encuentra actualmente suscrito a la patente LGPL;  para libre uso comercial y no comercial del software.

CC-GNU LGPL
The primary purpose of this collection is to make items publicly available under a common license that permits use, modification and re-distribution. To support this contributions are donated to the collection with consent for their use under the terms of the Creative Commons - Lesser General Purpose License (CC-GNU LGPL).
Chris Bartlett 2007

La versión actual v1.0 de "DHCM.inc" (DominoHechoConMoray) dibuja las fichas para un juego de dominó con la numeración 0 a 6. Muy poco flexible, permite modificar las texturas. Es compatible con POVRay 3.1.

Aunque existe una versión de Moray para DOS, este objeto fue creado originalmente mediante el programa Moray para Windows.  En la actualidad Moray forma parte del proyecto POVRay.  Si le interesa obtener una copia del programa, puede buscarla en el siguiente enlace:
Moray...
www.stmuc.com/moray/index.html

Indice de página:

  1. Instalación de Archivos
  2. Instrucciones básicas
  3. Características del objeto
  4. Modificadores
  5. Notas y Advertencias
  6. Sugerencias de modificación

Instalación de Archivos

El procedimiento siguiente es completamente optativo, corresponde simplemente al estándard de la Biblioteca de objetos POV-Ray.
  1. Cree el subdirectorio "ObjectCollections".  Se sugiere un subdirectorio del folder POV-Ray, creado por el instalador en algunas versiones en la sección de documentos o bien en la de código.
  2. Copie el archivo "DHCM.inc" en dicho subdirectorio;  únicamente este es necesario.  En cuanto a la documentación y demás puede colocarla si desea en el mismo subdirectorio, el estándar ha sido diseñado para evitar problemas de compatibilidad.
  3. Actualice los archivos buscados por POV-Ray, en algún archivo ini pertinente.  Por ejemplo "POVRay.ini";  agregue el comando Library_Path="C:\FDOS\POVRAY31\ObjectCollections"; o el que corresponda a su sistema operativo.  POV-Ray ofrece muchas formas de realizar esto.  Si no sabe cómo, probablemente convenga leer el manual de referencia en la sección "Command-line options".   Cada sistema operativo presenta sus propias variantes.
Nota:  El archivo de prueba "DHCM.pov" puede ejecutarse sin ningún proceso de instalación.  Unicamente debería estar ubicado en el mismo folder que "DHCM.inc".


Instrucciones básicas

Dominós
Muy fácil de usar, tan simple como incluir el archivo y ubicar el objeto.  El siguiente ejemplo ilustra el procedimiento básico.
    #if ( version >= 3.7 )
      #version 3.7;
    #end
    global_settings { assumed_gamma 1.0 }  

    #include "stdinc.inc"
    #include "stdcam.inc"
    #include "DHCM.inc"                    
    
    object     	{ 
      DHCM_Domino(1, 5)
      translate         <-2.00,+1.70,-4.90>    
    }

La macro principal tiene dos parámetros.

    #macro DHCM_Domino(UpNumber, DownNumber)            
UpNumber :
Número de puntos (0..6), para la mitad superior de la ficha.
DownNumber :
Número de puntos (0..6), para la mitad inferior de la ficha.


Características del objeto

Mis dibujos están en unidades mL o L (Lisa) según el contexto.  1 L equivale a 0.055063 pulgadas definido como 0.001 para POVRAY.  El monitor se encuentra entre las siguientes coordenadas:
    Mínimo          = <  -10,  -20,   -4 >*L
    Máximo          = <   10,   20,    0 >*L

La línea divisoria de la ficha paralela al eje X, frente hacia Z-, DownNumber hacia Y-.


Modificadores

La siguiente es la lista de los modificadores permitidos en la unidad, para utilizarlos debe redefinirlos antes de la inclusión del archivo.

    #declare DHCM_TexturaPrincipal		= texture { ... }
Textura principal del cuerpo de la ficha dominó.

    #declare DHCM_TexturaRelieve		= texture { ... }
Textura de los puntos y la línea divisoria.

    #declare DHCM_TexturaMetal			= texture { ... }
Textura del centro decorativo de la ficha.

El siguiente ejemplo ilustra el uso de los modificadores:

    #if ( version >= 3.7 )
      #version 3.7;
    #end
    global_settings { assumed_gamma 1.0 }  

    #include "stdinc.inc"
    #include "stdcam.inc"  
    #include "textures.inc" 
    
    #declare DHCM_TexturaPrincipal  = texture { DMFWood6 }  
    #declare DHCM_TexturaRelieve    = texture { Brass_Valley }   
    #declare DHCM_TexturaMetal      = texture { Chrome_Texture }
    #include "DHCM.inc"                    
    
    object     	{ 
      DHCM_Domino(1, 5)
      translate         <-2.00,+1.70,-4.90>    
    }


Notas y Advertencias

El original del objeto consistía en un paquete de 28 fichas de dominó. Se modificó en POVRay para dibujar las fichas en forma independiente.

Los elementos del dibujo se declaran antes de definir la macro. Por ello es necesario redefinir las texturas antes de la inclusión del archivo.

Su tamaño original era de unas pocas unidades POV-Ray, para esta biblioteca se escaló para ajustar el tamaño usual de mis otros objetos.


Sugerencias de modificación