Archivos de esta coleccin.
Necesarios para ejecucin:
JFSG.inc  	: archivo principal
JFSG_Au1.inc	: archivo auxiliar generado por Epspline.exe
Extras para visualizacin de manual html, no necesita conservarlos
JFSG.html	: instrucciones en html
JFSG_Thumbnail.jpg	
			: dibujo del objeto en pequeo
JFSG.jpg		: resultado con mejor resolucion
JFSG_logoPOVht.jpg	: logo de POV-Ray
JFSG_fp32ht.jpg		: logo de FreePascal
JFSG_freedosht.jpg	: logo de FreeDOS
JFSG_faltaht.jpg	: imagen de LibreN3D
JFSG_backht.jpg		: fondo de texto html
JFSG_cc-LGPL-a.png	: logo de GNU LGPG
JFSG_Epspline.jpg	: icono Epspline
Extras adicionales
JFSG.pov		: archivo de prueba
JFSG_readme.txt		: este documento

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

JFSG
Instrucciones para "JFSG.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 original del joystick, se desarroll con el programa Epspline.exe 
para Windows.  Herramienta auxiliar POVRay para modelar los tipos prism y lathe. 
 Si le interesa obtener una copia del programa, puede buscarla en el siguiente 
enlace:

      agalena.nfshost.com/b1/


La versin actual v1.0 de "JFSG.inc" (JoystickForSomeGames) dibuja un joystick 
para juegos de computadora, muy poco flexible.  No se dibujaron los cales o 
puede considerarlo inhalmbrico si lo prefiere.  Permite redefinir las 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 "JFSG.inc" y "JFSG_AU1.inc" 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 "JFSG.pov" puede ejecutarse sin ningn proceso de 
instalacin.  Unicamente debera estar ubicado en el mismo folder que "JFSG.inc" 
y "JFSG_AU1.inc". 



Instrucciones bsicas
       
      Joystick 
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 "JFSG.inc"
    
    object      {
      JFSG_JoystickForSomeGames() 
      translate                <-1.9375,1.6375,-4.75>
    }
La macro carece de parmetros. 
    #macro JFSG_JoystickForSomeGames( )



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: 
    Altura Y                    = + 1*L..-45*L
    Frente X                    = 108*L
    Profundidad Z               = -78*L (desde el plano)
El joystick se dibuja de "espaldas" a un jugador que mire desde el eje Z- hacia 
el origen, con gravedad Y-. 
Se generan las siguientes declaraciones que no deberan modificarse.  Para su 
correcta modificacin consultar la seccin Modificadores. 
  JFSG_DefaultTexturaPrincipal 
  Textura principal del joystick. 
  JFSG_DefaultTexturaBotones 
  Textura de los botones. 
  JFSG_DefaultTexturaBotonesLaterales 
  Textura de los botones laterales. 



Modificadores
La siguiente es la lista de los modificadores permitidos en la unidad. 
    #declare JFSG_TexturaPrincipal		=
	texture  { JFSG_DefaultTexturaPrincipal }
Textura principal del joystick. 
    #declare JFSG_TexturaBotones		=
        texture  { JFSG_DefaultTexturaBotones }
Textura de los botones. 
    #declare JFSG_TexturaBotonesLaterales	=
	texture  { JFSG_DefaultTexturaBotonesLaterales }
Textura de los botones laterales. 
A manera de ejemplo del uso de los modificadores: 
    #include "stdinc.inc"
    #include "stdcam.inc"
    #include "JFSG.inc"  
    #include "stones.inc"
    #include "textures.inc" 
    
    #declare JFSG_TexturaPrincipal      = T_Stone31
    
    #declare JFSG_TexturaBotones        = texture { pigment { Red_Marble } }
    
    #declare JFSG_TexturaBotonesLaterales       = T_Stone26
    
    object      {
      JFSG_JoystickForSomeGames()    
      rotate                    90*y
      translate                <-1.9375,1.6375,-4.75>
    }



Notas y Advertencias
La estructura bsica consiste en la interseccin de tres prismas en modo cbico. 
 Los puntos se colocaron al ojo, no debera esperar el usuario simetra 
matemtica. 
En la estructura original el cable surge de la parte delantera del joystick 
entre los botones laterales. 
Las texturas redefinidas se aplicarn una nica vez sin ninguna operacin 
matricial adicional. 



Sugerencias de modificacin
  Aumentar la flexibilidad en el diseo del joystick. 
  Agregar variables para facilitar la interaccin con personajes. 
  Incorporar parmetros para apretar los botones. 



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...(16/setiembre/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: 09/16/2014 14:14:24

