Archivos de esta coleccin.
Necesarios para ejecucin:
MMCE.inc  	: archivo principal
MMCE_IM1.gif	: imagen relieve frontal de medalla
MMCE_IM2.gif	: imagen posterior relieve reflejada de medalla
Extras para visualizacin de manual html, no necesita conservarlos
MMCE.html	: instrucciones en html
MMCE_Thumbnail.jpg	: dibujo del objeto en pequeo
MMCE.jpg		: resultado con mejor resolucion
MMCE_logoPOVht.jpg	: logo de POV-Ray
MMCE_fp32ht.jpg		: logo de FreePascal
MMCE_freedosht.jpg	: logo de FreeDOS
MMCE_faltaht.jpg	: imagen de LibreN3D
MMCE_backht.jpg		: fondo de texto html
MMCE_cc-LGPL-a.png	: logo de GNU LGPG
Extras adicionales
MMCE.pov		: archivo de prueba
MMCE_readme.txt		: este documento

Lo que sigue, puede leerse con mayor facilidad con MMCE.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.

MMCE   
Instrucciones para  "MMCE.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 "MMCE.inc" (MedallaMetalCongresoEucaristico) dibuja 
una medallita que la Iglesia Catlica puso a la venta, con motivo del Congreso 
Eucaristico 2015 en Costa Rica.  Gracias a las herramientas POVRay resulta muy 
simple de hacer.  Posee una macro detallada que permite adaptar facilmente otros 
modelos.  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 "MMCE.inc", "MMCE_IM1.gif" y "MMCE_IM2.gif" en dicho 
  subdirectorio;  nicamente stos tres 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 "MMCE.pov" puede ejecutarse sin ningn proceso de 
instalacin.  Unicamente debera estar ubicado en el mismo folder que 
"MMCE.inc", "MMCE_IM1.gif" y "MMCE_IM2.gif".  




Instrucciones bsicas

       

       Medalla   

 Muy fcil de usar, tan simple como incluir el archivo y ubicar el objeto.  El 
siguiente ejemplo ilustra el procedimiento bsico. 

    #include "stdinc.inc"
    #include "stdcam.inc"
    #include "MMCE.inc"
    
    object      {
      MMCE_Medalla() 
      translate      <-1.68, 1.18,-3.75>           
    }

La macro fundamental carece de parmetros. 
    #macro MMCE_Medalla()

La siguiente macro permite modificar fcilmente algunas caractersticas. 
    #macro MMCE_MedallaMetalCongresoEucaristico
              ( VisibleArgolla, BanderaTexturaRelieve, 
                ImagenFrontal, ImagenPosteriorEspejo, 
                TexturaPrincipal, TexturaRelieve, TexturaArgolla ) 
VisibleArgolla 
  : "on" dibuja el aro sujetador, "off" no lo dibuja.  Default es "on". 
  BanderaTexturaRelieve : "on" aplica TexturaRelieve por diferencia, "off" se 
  ignora.  Desgasta el relieve para pintar la zona superior.  Fue planeado para 
  medallas con tres niveles de profundidad, incluyendo el cero.  Default es 
  "on". ImagenFrontal : Imagen GIF vista desde Z-, aplicada como height_field 
  con un water_level cercano a cero exacto.  La zona eliminada debera calzar 
  con la correspondiente zona en ImagenPosteriorReflejo.  Default es 
  MMCE_GIFFrontal. ImagenPosteriorReflejo : Imagen GIF ubicada en Z+, pero vista 
  reflejada en un espejo desde Z-.  El efecto espejo provoca la conveniente 
  propiedad que water_level calce con la correspondiente zona en ImagenFrontal. 
   Default es MMCE_GIFPosteriorEspejo. TexturaPrincipal : Textura principal a 
  aplicar a la medalla.  Default es MMCE_TexturaPrincipal. TexturaRelieve : 
  Textura opcional que se aplica por diferencia a los relieves cercanos a uno en 
  los height_field de la medalla.  Se ignora si asigna "off" a 
  BanderaTexturaRelieve.  Default es MMCE_TexturaRelieve. TexturaArgolla : 
  Textura que se aplica a la argolla.  Default es MMCE_TexturaArgolla. 
En el siguiente ejemplo utilizamos la macro detallada, para generar el mismo 
objeto original: 
    #include "stdinc.inc"
    #include "stdcam.inc"
    #include "MMCE.inc"
    
    object      {
      MMCE_MedallaMetalCongresoEucaristico( on, on, 
          MMCE_GIFFrontal, MMCE_GIFPosteriorEspejo,  
          MMCE_TexturaPrincipal, MMCE_TexturaRelieve, MMCE_TexturaArgolla )
      translate      <-1.68, 1.18,-3.75>           
    }





Caractersticas del objeto
 La medalla sin su argolla se encuentra contenida en una esfera casi centrada en 
el origen de radio 0.5.  Su grosor en Z aproximado es ligeramente mayor a unos 
0.04 unidades POVRay.  
 Se generan las siguientes declaraciones que no deberan modificarse.  Para su 
correcta modificacin consultar la seccin Modificadores. 
  MMCE_DefaultTexturaPrincipal Textura principal de la medalla. 
  MMCE_DefaultTexturaRelieve Textura por diferencia para el relieve decorado 
  mayor. MMCE_DefaultTexturaArgolla Textura que se aplica a la argolla. 




Modificadores
 La siguiente es la lista de los modificadores permitidos en la unidad. 
    #declare MMCE_GIFFrontal			= "MMCE_IM1.gif";
 Imagen que se aplica al 
frente Z-. 

    #declare MMCE_GIFPosteriorEspejo		= "MMCE_IM2.gif";
 Imagen que se aplica 
en zona posterior Z+ vista como reflejo en un espejo.  De esta forma se logra 
que calce la zona water_level de ambos hieght_field. 

    #declare MMCE_TexturaPrincipal		=
	texture { MMCE_DefaultTexturaPrincipal }

 Textura principal de la medalla. 

    #declare MMCE_TexturaRelieve		=
	texture { MMCE_DefaultTexturaRelieve }

 Textura por diferencia para el relieve decorado mayor. 

    #declare MMCE_TexturaArgolla		=
	texture { MMCE_DefaultTexturaArgolla }

 Textura que se aplica a la argolla. 

    #declare MMCE_POV3_1			= off;
 Para activar modo de compatibilidad con 
POVRay 3.1.  En algunas versiones se activar automticamente.  En este archivo 
no cumple ninguna funcin. 
A manera de ejemplo del uso de los modificadores: 
    #include "stdinc.inc"
    #include "stdcam.inc"
    #include "MMCE.inc"
    #include "textures.inc"  
    
    #declare MMCE_TexturaPrincipal      =
      texture                           { 
        average
        texture_map                     {
          [ 0.5 MMCE_DefaultTexturaPrincipal ]
          [ 0.5 Rust ]
        }
      }  
      
    #declare MMCE_TexturaRelieve        = PinkAlabaster
    #declare MMCE_TexturaArgolla        = Chrome_Texture
        
    object      {
      MMCE_Medalla() 
      translate      <-1.68, 1.18,-3.75>           
    }





Notas y Advertencias
 Las imgenes por defecto tienen una resolucin 320x320, hemos obtenido
 resultados decepcionantes con valores bajos por 48x48 o similar.  Conviene que 
la imagen tenga un borde de unos cuantos pixeles a nivel cero. 
Al sustituir la figura es probable que la argolla resulte flotando en el aire. 
 Debido a ello se introdujo un parmetro para eliminarla. 

Tome en cuenta que el parmetro TexturaRelieve se aplica por diferencia y
 produce un desgaste de las tonalidades grises mayores. 





Sugerencias de modificacin
  Agregar una cadena opcional.
  Incluir mayor cantidad de diseos por defecto.
  Adaptar la macro para modelos ms complicados, por ejemplo, crucifijos con
   motivos religiosos.





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...(20/enero/2015), 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: 01/20/2015 16:07:40
 


