Archivos de esta coleccin.
Necesarios para ejecucin:
D7OR.inc  	: archivo principal
D7OR_IM1.gif	: portada auxiliar "Nudos Iniciales"
Extras para visualizacin de manual html, no necesita conservarlos
D7OR.html	: instrucciones en html
D7OR_Thumbnail.jpg	
			: dibujo del objeto en pequeo
D7OR.jpg		: resultado con mejor resolucion
D7OR_logoPOVht.jpg	: logo de POV-Ray
D7OR_fp32ht.jpg		: logo de FreePascal
D7OR_freedosht.jpg	: logo de FreeDOS
D7OR_faltaht.jpg	: imagen de LibreN3D
D7OR_backht.jpg		: fondo de texto html
D7OR_cc-LGPL-a.png	: logo de GNU LGPG
Extras adicionales
D7OR.pov		: archivo de prueba
D7OR_IMP.gif		: imagen utilizada en ejemplos de prueba
D7OR_readme.txt		: este documento

Lo que sigue, puede leerse con mayor facilidad con D7OR.html, y su despliegue preferido...
Esta copia es para usuarios que prefieran las instrucciones en formato TXT, o si en el futuro
el lenguaje html queda descontinuado.

D7OR
Instrucciones para "D7OR.inc" v1.0 

Donacin de Rafael Angel Campos Vargas, en el ao 2015, 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. 
   
  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 versin actual v1.0 de "D7OR.inc" (Disco700MBOnlyRead) dibuja una caja para 
CD con disco.  Se puede modificar la imagen y otras caractersticas.  Algunas 
macros internas no fueron documentadas para ahorra tiempo, puesto que se 
consideraron de poco inters para el usuario final.  Es compatible con POVRay 
3.1. 
Indice de pgina: 
  Instalacin de Archivos

  Instrucciones bsicas

  Caractersticas del objeto

  Modificadores

  Notas y Advertencias

  Sugerencias de modificacin

  Sobre LibreN3D




Instalacin de Archivos
El procedimiento siguiente es completamente optativo, corresponde simplemente al 
estndard de la Biblioteca de objetos POV-Ray. 
  Cree el subdirectorio "ObjectCollections".  Se sugiere un subdirectorio del 
  folder POV-Ray, creado por el instalador en algunas versiones en la seccin de 
  documentos o bien en la de cdigo. 
  Copie los archivo "D7OR.inc" y "D7OR_IM1.gif" en dicho subdirectorio;  
  nicamente stos dos son necesarios.  En cuanto a la documentacin y dems 
  puede colocarla si desea en el mismo subdirectorio, el estndar ha sido 
  diseado para evitar problemas de compatibilidad. 
  Actualice los archivos buscados por POV-Ray, en algn 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 
  cmo, probablemente convenga leer el manual de referencia en la seccin 
  "Command-line options".   Cada sistema operativo presenta sus propias 
  variantes. 
Nota:  El archivo de prueba "D7OR.pov" puede ejecutarse sin ningn proceso de 
instalacin.  Unicamente debera estar ubicado en el mismo folder que "D7OR.inc" 
y "D7OR_IM1.gif". 



Instrucciones bsicas
       
      Caja para CD 
Muy fcil de usar, tan simple como incluir el archivo y ubicar el objeto.  
Conviene elevar el valor de la variable global max_trace_level para mejorar la 
calidad de la imagen final. 
    #include "stdinc.inc"
    #include "stdcam.inc"
    #include "D7OR.inc"
    
    global_settings             {  
      max_trace_level           8
    }
    
    object      {
      D7OR_CajaCD( on, 20, "" ) 
      translate                 <-1.9375,+1.6375,-4.8500>
    }
La macro fundamental tiene tres parmetros. 
    #macro D7OR_CajaCD( BanderaDisco, AnguloAbrir, NombreImagenGIF )
BanderaDisco : 
  "on" dibuja el CD interior.  "off" no lo dibuja. 
  AnguloAbrir : 
  Angulo en grados de apertura de la caja. 
  NombreImagenGIF : 
  Para cambiar fcilmente la portada del disco.  Indique el nombre del archivo 
  GIF como String.  Si utiliza "" sin nombre, se dibuja la portada de "Nudos 
  Iniciales". 
En el siguiente ejemplo cambiamos la portada del disco: 
    #include "stdinc.inc"
    #include "stdcam.inc"
    #include "D7OR.inc"
    
    global_settings             {  
      max_trace_level           8
    }
    
    object      {
      D7OR_CajaCD( on, 0, "D7OR_IMP.gif" ) 
      translate                 <-1.9375,+1.6375,-4.8500>
    }



Caractersticas del objeto
Mis dibujos estn en unidades L (Lisa).  1 L equivale a 0.055063 pulgadas 
definido como 0.001 para POVRAY.  El objeto tiene las siguientes 
caractersticas: 
    PuntoMinimo			= < 0, 0, -GruesoCaja >
    PuntoMaximo			= < LargoCaja, AltoCaja, 0 >
    LargoCaja			= 100*L
    AltoCaja			=  87*L
    GruesoCaja			=   7*L
El frente del disco mira hacia Z-.  El eje de giro cercano al eje Y, gravedad 
Y-. 
Se generan las siguientes declaraciones que no deberan modificarse.  Para su 
correcta modificacin consultar la seccin Modificadores. 
  D7OR_DefaultMaterialPrincipal 
  Material principal de la caja. 
  D7OR_DefaultMaterialDecoradoPrincipal 
  Material para el decorado lateral, superior e inferior. 
  D7OR_DefaultMaterialSoporte 
  Material para el soporte interno del disco. 
  D7OR_DefaultTexturaCaratulaDisco 
  Textura del papel para la cara frontal de la caja. 
  D7OR_DefaultTexturaLabelPosterior 
  Textura del papel para la caja posterior de la caja. 
  D7OR_DefaultTexturaLabelLateralDerecha 
  Textura del papel para el lateral derecho de la caja. 
  D7OR_DefaultTexturaLabelLateralIzquierda 
  Textura del papel para el lateral izquierdo de la caja. 
  D7OR_DefaultTexturaCentralDisco 
  Textura para el centro del disco CD. 
  D7OR_DefaultTexturaMetalDisco 
  Textura metlica del disco CD. 
  D7OR_DefaultTexturaLabelFrente 
  Textura para la etiqueta del disco CD. 



Modificadores
La siguiente es la lista de los modificadores permitidos en la unidad. 
    #declare D7OR_MaterialPrincipal		=
	texture  { D7OR_DefaultMaterialPrincipal }
Material principal de la caja. 
    #declare D7OR_MaterialDecoradoPrincipal	=
        texture  { D7OR_DefaultMaterialDecoradoPrincipal }
Material para el decorado lateral, superior e inferior. 
    #declare D7OR_MaterialSoporte		=
	texture  { D7OR_DefaultMaterialSoporte }
Material para el soporte interno del disco. 
    #declare D7OR_TexturaCaratulaDisco		=
	texture  { D7OR_DefaultTexturaCaratulaDisco }
Textura del papel para la cara frontal de la caja. 
    #declare D7OR_TexturaLabelPosterior		=
	texture  { D7OR_DefaultTexturaLabelPosterior }
Textura del papel para la cara posterior de la caja. 
    #declare D7OR_TexturaLabelLateralDerecha	=
	texture  { D7OR_DefaultTexturaLabelLateralDerecha }
Textura del papel para el lateral derecho de la caja. 
    #declare D7OR_TexturaLabelLateralIzquierda	=
	texture  { D7OR_DefaultTexturaLabelLateralIzquierda }
Textura del papel para el lateral izquierdo de la caja. 
    #declare D7OR_TexturaCentralDisco		=
	texture  { D7OR_DefaultTexturaCentrarDisco }
Textura para el centro del disco CD. 
    #declare D7OR_TexturaMetalDisco		=
	texture  { D7OR_DefaultTexturaMetalDisco }
Textura metlica del disco CD. 
    #declare D7OR_TexturaLabelFrente		=
	texture  { D7OR_DefaultTexturaLabelFrente }
Textura para la etiqueta del disco CD. 
    #declare D7OR_POV3_1			= off;
Para activar modo de compatibilidad con POVRay 3.1.  En algunas versiones se 
activar automticamente.  En esta versin no cumple ninguna funcin. 
A manera de ejemplo del uso de los modificadores: 
    #include "stdinc.inc"
    #include "stdcam.inc" 
    #include "textures.inc"
    #include "D7OR.inc"
    
    global_settings             {  
      max_trace_level           8
    }

    #declare D7OR_MaterialPrincipal              = material { M_Glass }  
        
    #declare D7OR_MaterialDecoradoPrincipal      = material { M_Ruby_Glass } 
    
    #declare D7OR_MaterialSoporte                = material { M_Yellow_Glass }
          
    #declare D7OR_TexturaCaratulaDisco           = texture  { PinkAlabaster }   
    
    #declare D7OR_TexturaLabelPosterior          = texture  { Lightning1 }
    
    #declare D7OR_TexturaLabelLateralDerecha     = texture  { pigment { Blue } }   
    
    #declare D7OR_TexturaLabelLateralIzquierda   = texture  { pigment { Green } }    
      
    #declare D7OR_TexturaCentralDisco            = texture  { Cork } 
    
    #declare D7OR_TexturaMetalDisco              = texture  { Aluminum }    

    #declare D7OR_TexturaLabelFrente             = texture  { pigment { Cyan } }
                        
    object      {
      D7OR_CajaCD( on, 90, "" )   
      rotate            60*y
      translate                 <-1.9375,+1.6375,-4.8500>
    }



Notas y Advertencias
En el interior del archivo existen macros que podran resultar tiles para 
modificar las caractersticas.  Tambin podra generar el disco CD en forma 
independiente. 
Las etiquetas del papel se disearon utilizando box { ... } divididos a la mitad 
por alguno de los planos cartesianos.  Utilice patrones checker para ubicar 
imgenes diferentes en ambas caras. 
Si no eleva el valor de la variable global max_trace_level, aparecen gran 
cantidad de rayas negras antiestticas. 



Sugerencias de modificacin
  Documentar el resto de las macros para facilitar el diseo de variantes 
  menores. 
  Facilitar la interaccin con el CD interno. 
  Facilitar el proceso de modificacin a ambos lados del papel. 



Sobre LibreN3D
 En la actualidad dedico casi unas dos horas todos los das, para desarrollar el 
programa de animacin LibreN3D con el compilador FreePascal para FreeDOS.  El 
objetivo era en un origen, realizar animaciones de "baja" calidad, con progreso 
lento y paulatino. Desconoca en ese entonces del programa POV-Ray.  Creo que 
con ayuda de dicho proyecto, podra lograr mucho mejores resultados desde un 
principio.  Confo que para el 2020 pueda lograr animaciones completas de 
aceptable calidad.   En la actualidad, intento agregarle caractersticas 
elsticas a los objetos.  He tenido numerosos retrasos, as que todava no 
funciona.  Lo siento...(18/noviembre/2014), pero me siento muy seguro de que 
pronto lo lograr.  De momento, no tiene interface con el usuario, pero se 
encuentra en desarrollo como intrprete de rengln al estilo DOS. 
Me sera de muchsima ayuda, que el grupo POV-Ray siguiera desarrollando la 
versin para DOS.   Los siguientes son enlaces que podran ser de utilidad para 
el interesado en los proyectos FreePascal y FreeDOS.   Lamentablemente en la 
actualidad son altamente inestables, debido probablemente a dificultades con la 
adaptacin al modo de 64 bits. 
      Descarga sistema operativo FreeDOS 

      Descarga compilador FreePascal 



Dedicado a Jess y Mara.
Sugerencias a :
RofoelCompos@hotmail.com
Apdo. 964-1250. Escaz, San Jos, Costa Rica
http://rofoelcompos.hi5.com
Ultima modificacin del documento: 11/18/2014 16:44:30
