Logo POVRay...
Instrucciones para "TYCJ.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 "TYCJ.inc" (TransplantadorYCucharaJardin) dibuja un transplantador y una cuchara para jardinería doméstica. Posee una macro para modificar las características principales, pero es muy poco flexible. Es compatible con POV-Ray 3.1.

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 los archivo "TYCJ.inc" y "TYCJ_STS.inc" en dicho subdirectorio;  únicamente estos dos son necesarios.  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 "TYCJ.pov" puede ejecutarse sin ningún proceso de instalación.  Unicamente debería estar ubicado en el mismo folder que "TYCJ.inc" y "TYCJ_STS.inc".


Instrucciones básicas

Transplantador
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 "TYCJ.inc"
    
    object     	{ 
      TYCJ_Transplantador( ) 
      translate         <-1.98,+1.63,-4.75>    
    }
    object     	{ 
      TYCJ_CucharaJardin( ) 
      translate         <-1.88,+1.63,-4.75>    
    }

Las dos macros principales no tienen parámetros. Esta dibuja el Transplantador.

    #macro TYCJ_Transplantador( )

Para dibujar la cuchara para jardinería se utiliza la siguiente macro.

    #macro TYCJ_CucharaJardin( )

Puede controlarse el dibujo de las cucharas con mayor detalle con la siguiente macro:

    #macro TYCJ_TransplantadorYCucharaJardin( LargoBastidor,
        DiametroMayorBastidor, DiametroMenorBastidor,
        LargoHoja, AireHoja, RetrocesoLateralHoja,
        EntradaHoja, AnchoEntradaHoja, DesnivelHoja, AnchoHoja,
        MaterialCuchara, MaterialMetalico,
        MaterialMadera, MaterialAgarradera )
LargoBastidor :
Largo del mango. Valor por defecto 125*L.
DiametroMayorBastidor :
Diámetro mayor del mango. Valor por defecto 25*L.
DiametroMenorBastidor :
Diámetro menor del mango. Valor por defecto 14.6*L.
LargoHoja :
Largo en Y de la cuchara. Valor por defecto 113.5*L.
AireHoja :
Referencia para la separación entre el bastidor y la cuchara. Valor por defecto 18*L.
RetrocesoLateralHoja :
En los laterales la hoja se devuelve hacia el mango esta distancia. Valor por defecto 9*L (transplantador) y 0*L (cuchara).
EntradaHoja :
Distancia desde el mango al punto de menor profundidad de la hoja. Valor por defecto 18*L (transplantador) y 27.2*L (cuchara).
DesnivelHoja :
Profundidad en Z de la hoja. Valor por defecto 22.7*L (transplantador) y 27.2*L (cuchara).
AnchoHoja :
Ancho frontal de la hoja. Valor por defecto 38.6*L (transplantador) y 61.3*L (cuchara).
MaterialCuchara :
Material de las varillas. Valor por defecto TYCJ_MaterialCuchara.
MaterialMetalico :
Material de la argolla metálica de unión. Valor por defecto TYCJ_MaterialMetalico.
MaterialMadera :
Material del mango de madera. Valor por defecto TYCJ_MaterialMadera.
MaterialAgarradera :
Material de la agarradera de caucho. Valor por defecto TYCJ_MaterialAgarradera.

El siguiente ejemplo dibuja el mismo objeto por defecto.

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

    #include "stdinc.inc"
    #include "stdcam.inc"
    #include "TYCJ.inc"
    
    object     	{ 
      TYCJ_TransplantadorYCucharaJardin( 0.125, 0.025, 0.0146,
          0.1135, 0.018, 0.009, 0.0363, 0.018, 0.0227, 0.0386,
          TYCJ_MaterialCuchara, TYCJ_MaterialMetalico,
          TYCJ_MaterialMadera, TYCJ_MaterialAgarradera )
      translate         <-1.98,+1.63,-4.75>    
    }
    object     	{ 
      TYCJ_TransplantadorYCucharaJardin( 0.125, 0.025, 0.0146,
          0.1135, 0.018, 0, 0.0397, 0.0272, 0.0272, 0.0613,
          TYCJ_MaterialCuchara, TYCJ_MaterialMetalico,
          TYCJ_MaterialMadera, TYCJ_MaterialAgarradera )
      translate         <-1.88,+1.63,-4.75>    
    }


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.  Las cucharas tienen las siguientes coordenadas:
    Mínimo          = < -AnchoHoja/2, -LargoBastidor, -DesnivelHoja            >
    Máximo          = <  AnchoHoja/2,      LargoHoja,  DiametroMayorBastidor/2 >
    Transplantador
    Mínimo          = < -19.3, -125  , -22.7 >*L
    Máximo          = <  19.3,  113.5,  12.5 >*L
    Cuchara Jardín
    Mínimo          = < -30.7, -125  , -27.2 >*L
    Máximo          = <  30.7,  113.5,  12.5 >*L

Los dientes se curvan hacia Z-. El punto de unión entre el bastidor y las cucharas se encuentra en el origen de coordenadas.

Se generan las siguientes declaraciones que no deberían modificarse.  Para su correcta modificación consulte la sección Modificadores.

TYCJ_DefectoMaterialCuchara
Material de las cucharas.
TYCJ_DefectoMaterialMetalico
Material de la argolla metálica de unión.
TYCJ_DefectoMaterialMadera
Material del mango de madera.
TYCJ_DefectoMaterialAgarradera
Material de la agarradera de caucho.


Modificadores

La siguiente es la lista de los modificadores permitidos en la unidad. Cuando se indique, será el valor establecido por defecto.

    #declare TYCJ_Subdivisions			= 2;
Permite cambiar el grado de subdivisión de las cucharas. El total de smooth_triangle generados crece exponencialmente, además por causas no bien comprendidas el resultado es algo desagradable al incrementar este número.

    #declare TYCJ_MaterialCuchara		=
		material  { TYCJ_DefectoMaterialCuchara			}
Material de las cucharas.

    #declare TYCJ_MaterialMetalico		=
		material  { TYCJ_DefectoMaterialMetalico		}
Material de la argolla metálico de unión.

    #declare TYCJ_MaterialMadera		=
		material  { TYCJ_DefectoMaterialMadera			}
Material del mango de madera.

    #declare TYCJ_MaterialAgarradera		=
		material  { TYCJ_DefectoMaterialAgarradera       	}
Material de la agarradera de caucho.

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 "TYCJ.inc"
    #include "textures.inc"   
    
    #declare TYCJ_Subdivisions		= 0;
    #declare TYCJ_MaterialCuchara       =
      material { texture { PinkAlabaster } }
    #declare TYCJ_MaterialMetalico      =
      material { texture { Copper_Texture } }
    #declare TYCJ_MaterialMadera        =
      material { M_Green_Glass }
    #declare TYCJ_MaterialAgarradera    =
      material { texture { Yellow_Pine } }
    
    object     	{ 
      TYCJ_Transplantador()
      translate         <-1.98,+1.63,-4.75>    
    }
    object     	{ 
      TYCJ_CucharaJardin()
      translate         <-1.88,+1.63,-4.75>    
    }


Notas y Advertencias

Al variar los parámetros debe hacerlo en forma consistente para lograr buenos resultados.

Es dudosa la utilidad de aumentar la subdivisión más de 3 veces, debido a la aparición de sombras y líneas extrañas.

Las normales se definieron perpendicular a la superficie, la subdivisión no corrige matemáticamente los vértices en los laterales de este objeto.


Sugerencias de modificación