Archivos de esta coleccin.
Necesarios para ejecucin:
PEUS.inc  	: archivo principal
PEUS_AU1.inc	: archivo auxiliar de macros
PEUS_AU2.inc	: archivo auxiliar para blobs
Extras para visualizacin de manual html, no necesita conservarlos
PEUS.html	: instrucciones en html
PEUS_Thumbnail.jpg	
			: dibujo del objeto en pequeo
PEUS.jpg		: resultado con mejor resolucion
PEUS_logoPOVht.jpg	: logo de POV-Ray
PEUS_fp32ht.jpg		: logo de FreePascal
PEUS_freedosht.jpg	: logo de FreeDOS
PEUS_faltaht.jpg	: imagen de LibreN3D
PEUS_backht.jpg		: fondo de texto html
PEUS_cc-LGPL-a.png	: logo de GNU LGPG
PEUS_BlobC              : imagen para Blob Sculptor
Extras adicionales
PEUS.pov		: archivo de prueba
PEUS_readme.txt		: este documento

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

PEUS
Instrucciones para "PEUS.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

El mango de la pala fue creado originalmente mediante el programa "Blob Sculptor 
2.0b".  Lamentablemente la ltima versin fue en 1994.  Es completamente 
compatible con FreeDOS y WindowsXP.
Si le interesa obtener una copia del programa, puede buscarla en los siguientes 
enlaces:

      www.rocketjam.com/povmod.html
      www.personal.uni-jena.de/~p6sepa/software.htm 

La versin actual v1.0 de "PEUS.inc" (PalaExcavadoraUsoSuelo) dibuja una pala 
corriente de labranza.  Ofrece una macro para cambiar las caractersticas 
principales y texturas.  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 "PEUS.inc", "PEUS_AU1.inc", y "PEUS_AU2.inc" 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 "PEUS.pov" puede ejecutarse sin ningn proceso de 
instalacin.  Unicamente debera estar ubicado en el mismo folder que 
"PEUS.inc", "PEUS_AU1.inc", y "PEUS_AU2.inc". 



Instrucciones bsicas
       
      Pala 
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 "PEUS.inc"
    
    object      {
      PEUS_Pala() 
      translate                 <-1.812, 1.0125,-4.25>        
    }
La macro fundamental no tiene parmetros. 
    #macro PEUS_Pala() 
La siguiente macro dibuja el objeto con mucho mayor control de las 
caractersticas. 
    #macro PEUS_PalaExcavadoraUsoSuelo( BocaPala, AnguloPala,
                LargoPala, LargoSoporte, DiametroMadera,
                FraccionUnion, FraccionAgarre,
                TexturaPala, TexturaSoporteMetal,
                TexturaUnionMetalMadera, TexturaMadera,
                TexturaAgarre, TexturaAgarre2 )
BocaPala : 
  Vector para describir las dimensiones de la boca de pala, a partir de un 
  objeto unitario.  Default es <150,212,43>*L. 
  AnguloPala : 
  Inclinacin de la boca de pala, respecto al soporte.  Default es 22.5 grados. 
  LargoPala : 
  Referencia para el largo total de la pala.  Default es 744*L. 
  LargoSoporte : 
  Referencia para el largo del soporte dela pala.  Default es 494*L. 
  DiametroMadera : 
  Diametro de la madera cilndrica de soporte.  Default es 27*L. 
  FraccionUnion : 
  Fraccin propia relativa del tamao de la unin soporte-pala, respecto al 
  largo del soporte.  Default es 0.10. 
  FraccionAgarre : 
  Referencia como fraccin propia relativa del tamao del mango respecto al 
  largo del soporte.  Default es 0.175. 
  TexturaPala : 
  Textura de la boca de pala.  Default es PEUS_TexturaPala. 
  TexturaSoporteMetal : 
  Textura de soporte directo de boca de pala.  Default es 
  PEUS_TexturaSoporteMetal. 
  TexturaUnionMetalMadera : 
  Textura de la unin metal-madera del soporte.  Default es 
  PEUS_TexturaUnionMetalMadera. 
  TexturaMadera : 
  Textura de la madera del brazo de la pala.  Default es PEUS_TexturaMadera. 
  TexturaAgarre : 
  Textura del mango.  Default es PEUS_TexturaAgarre. 
  TexturaAgarre2 : 
  Textura del mango en contacto con la mano.  Default es PEUS_TexturaAgarre2. 
En el siguiente ejemplo utilizamos la macro detallada, para generar el mismo 
objeto original: 
    #include "stdinc.inc"
    #include "stdcam.inc"
    #include "PEUS.inc"   
    #include "textures.inc"
    
    object      {
      PEUS_PalaExcavadoraUsoSuelo( <0.15,0.218,0.043>, 
          22.5, 0.744, 0.494, 0.027, 0.1, 0.175,
          PEUS_TexturaPala, PEUS_TexturaSoporteMetal,
          PEUS_TexturaUnionMetalMadera, PEUS_TexturaMadera,  
          PEUS_TexturaAgarre, PEUS_TexturaAgarre2 )    
      translate                 <-1.812, 1.0125,-4.25>        
    }
Una palita para nios. 
    #include "stdinc.inc"
    #include "stdcam.inc"
    #include "PEUS.inc"   
    #include "textures.inc"
    
    object      {
      PEUS_PalaExcavadoraUsoSuelo( <0.15,0.218,0.005>*2, 
          10, 0.744, 0.200, 0.050, 0.1, 0.35,
          PEUS_TexturaPala, PEUS_TexturaSoporteMetal,
          PEUS_TexturaUnionMetalMadera, PEUS_TexturaMadera,  
          PEUS_TexturaAgarre, PEUS_TexturaPala )    
      translate                 <-1.812, 1.0125,-4.25>        
    }



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: 
    Alto			=  760*L
    Frente en X			=  150*L
    Profundidad en Z		= -110*L.. 35*L 
Se dibuja semicentrado sobre el plano XZ.  El eje de la pala en Y, con boca 
hacia Z-, gravedad Y-. 
Se generan las siguientes declaraciones que no deberan modificarse.  Para su 
correcta modificacin consultar la seccin Modificadores. 
  PEUS_DefaultTexturaPala 
  Textura de la boca de pala. 
  PEUS_DefaultTexturaSoporteMetal 
  Textura de soporte directo de boca de pala. 
  PEUS_DefaultTexturaUnionMetalMadera 
  Textura de la unin metal-madera del soporte. 
  PEUS_DefaultTexturaMadera 
  Textura de la madera del brazo de la pala. 
  PEUS_DefaultTexturaAgarre 
  Textura del mango. 
  PEUS_DefaultTexturaAgarre2 
  Textura del mango en contacto con la mano. 



Modificadores
La siguiente es la lista de los modificadores permitidos en la unidad. 
    #declare PEUS_FF				= 3;
Controla el grado de subdivisin para la aproximacin del relieve de la pala.  
Casi siempre un valor unitario funcionar bien.  Tomar en cuenta que cada unidad 
multiplica por cuatro el detalle.  Esta variable requiere declararse antes de 
#include "PEUS.inc". 
    #declare PEUS_TexturaPala			=
	texture  { PEUS_DefaultTexturaPala }
Textura de la boca de pala. 
    #declare PEUS_TexturaSoporteMetal		=
        texture  { PEUS_DefaultTexturaSorpoteMetal }
Textura de soporte directo de boca de pala. 
    #declare PEUS_TexturaUnionMetalMadera	=
	texture  { PEUS_DefaultTexturaUnionMetalMadera }
Textura de la unin metal-madera del soporte. 
    #declare PEUS_TexturaMadera			=
	texture  { PEUS_DefaultTexturaMadera }
Textura de la madera del brazo de la pala. 
    #declare PEUS_TexturaAgarre			=
	texture  { PEUS_DefaultTexturaAgarre }
Textura del mango. 
    #declare PEUS_TexturaAgarre2		=
	texture  { PEUS_DefaultTexturaAgarre2 }
Textura del mango en contacto con la mano. 
    #declare PEUS_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"
    #declare PEUS_FF				= 1;
    #include "PEUS.inc"     
    #include "textures.inc"                   
    
    #declare PEUS_TexturaPala                   = 
      texture                   {  
        average
        texture_map             {  
          [ 0.5 PEUS_DefaultTexturaPala ]
          [ 0.5 Rust ]
        }
      }
    #declare PEUS_TexturaSoporteMetal           =
      texture                   {  
        average
        texture_map             {    
          [ 0.5 PEUS_DefaultTexturaSoporteMetal ]
          [ 0.5 Rust ]
        }
      }        
    #declare PEUS_TexturaUnionMetalMadera       = PinkAlabaster
    #declare PEUS_TexturaMadera                 = Sandalwood
    #declare PEUS_TexturaAgarre                 = Copper_Texture
    #declare PEUS_TexturaAgarre2                = Silver_Texture
    
    object      {
      PEUS_Pala()    
      translate                 <-1.812, 1.0125,-4.25>        
    }



Notas y Advertencias
Si cambia los parmetros estructurales, intente modificaciones progresivas en 
forma consistente. 
En algunas combinaciones de parmetros es probable que se desprenda el mango, o 
la boca de pala.  Intente engordar el cilindro central, o cambiar las fracciones 
propias que describen el soporte. 
El grado de subdivisin para el recubrimiento de la pala podr reducirse a uno 
sin problemas.  Las diferencias se perciben en el acercamiento.  A diferencia de 
los dems modificadores, el grado de subdivisin debera declararse antes del 
#include "PEUS.inc" respectivo. 



Sugerencias de modificacin
  Aumentar la flexibilidad en el diseo de la pala. 
  Agregar variables para facilitar la interaccin con personajes. 
  Por la naturaleza de su uso, conviene adaptar la pala para permitir cierta 
  elasticidad. 



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/agosto/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: 08/19/2014 16:11:16
