Logo POVRay...
Instrucciones para "BMME.inc" v1.0

Donación de Rafael Angel Campos Vargas, en el año 2018, 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 "BMME.inc" (BatidoraManualMotorizadaElectrica) dibuja una batidora de mano para cocina. Pueden girarse las aspas y permite algunos cambios menores, pero es muy poco flexible. Es compatible con POV-Ray 3.1.

Parte importante de la estructura principal del aparato, se desarrolló con la ayuda del programa Epspline.exe para Windows.  Herramienta auxiliar POV-Ray para modelar los tipos prism y lathe.  Si le interesa obtener una copia del programa, puede buscarla en el siguiente enlace:
Epspline...
agalena.nfshost.com/b1/

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
  7. Sobre LibreN3D

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 archivos "BMME.inc" y "BMME_AU1.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 "BMME.pov" puede ejecutarse sin ningún proceso de instalación.  Unicamente debería estar ubicado en el mismo folder que "BMME.inc" y "BMME_AU1.inc".


Instrucciones básicas

Batidora
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 "BMME.inc"
    
    object      {
      BMME_Batidora( 0.0)
      translate         <-1.925,+1.575,-4.700>    
    }

La macro principal tiene solo un parámetro.

    #macro BMME_Batidora( GiroAspas )
GiroAspas :
Ángulo para rotar las aspas de la batidora.

La siguiente macro permite mucha mayor flexibilidad.

    #macro BMME_BatidoraManualMotorizadaElectrica
            ( GiroAspas, LateralBatidora, FrenteBatidora, AltoBatidora,
              SeparacionAspas, FraccionPosAspas,
              LargoAspas, DiametroSoporte, FraccionAspas, DiametroAspas,
              TexturaPrincipal, TexturaDecorativa, TexturaTexto, TexturaMetalica )
GiroAspas :
Ángulo para rotar las aspas de la batidora.
LateralBatidora :
Largo en X de la batidora desde el frente hasta su parte posterior. Valor por defecto 127*L.
FrenteBatidora :
Ancho frontal en Z de la batidora. Valor por defecto 64*L.
AltoBatidora :
Alto del aparato sin aspas en Y. Valor por defecto 94*L.
SeparacionAspas :
Separación entre las aspas. Valor por defecto 27*L.
FraccionPosAspas :
Fracción para ubicar lateralmente las aspas a partir del frente. Valor por defecto 0.35.
LargoAspas :
Largo externo visible de las aspas. Valor por defecto 113*L.
DiametroSoporte :
Diámetro de los cilindros metálicos que soportan las aspas. Valor por defecto 3.6*L.
FraccionAspas :
Fracción del cilindro de aspas que se encuentre ocupado por las aspas. Valor por defecto 0.516.
DiametroAspas :
Diámetro efectivo abarcado por las aspas. Valor por defecto 27*L.
TexturaPrincipal :
Textura principal de la batidora. Valor por defecto BMME_TexturaPrincipal.
TexturaDecorativa :
Textura del lomo superior de la batidora. Valor por defecto BMME_TexturaDecorativa.
TexturaTexto :
Textura del logo de marca. Valor por defecto BMME_TexturaTexto.
TexturaMetalica :
Textura de las aspas. Valor por defecto BMME_TexturaMetalica.

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 "BMME.inc"
    
    object      {
      BMME_BatidoraManualMotorizadaElectrica( 0.0, 
          0.127, 0.064, 0.094, 0.027, 0.35, 0.113, 0.0036, 0.516, 0.027,
          BMME_TexturaPrincipal, BMME_TexturaDecorativa,
          BMME_TexturaTexto, BMME_TexturaMetalica )
      translate         <-1.925,+1.575,-4.700>    
    }


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.  La batidora por defecto tiene las siguientes dimensiones:
    Mínimo      	= <  -64, -122,  -32 >*L
    Máximo      	= <  +64,  +89,  +32 >*L

El frente del objeto mira hacia X+, es casi simétrico con respecto al plano XY.

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

BMME_DefectoTexturaPrincipal
Textura principal del aparato.
BMME_DefectoTexturaDecorativa
Textura del lomo superior de la batidora.
BMME_DefectoTexturaTexto
Textura del logo de marca.
BMME_DefectoTexturaMetalica
Textura de las aspas.


Modificadores

La siguiente es la lista de los modificadores permitidos en la unidad.

    #declare BMME_StringLogo			= "POV-Ray"
Mensaje para el logo de marca.

    #declare BMME_TexturaPrincipal		=	 
		texture  { BMME_DefectoTexturaPrincipal		}
Textura principal del aparato.

    #declare BMME_TexturaDecorativa		=	 
		texture  { BMME_DefectoTexturaDecorativa	}
Textura del lomo superior de la batidora.

    #declare BMME_TexturaTexto			=	 
		texture  { BMME_DefectoTexturaTexto		}
Textura para el logo de marca.

    #declare BMME_TexturaMetalica		=	 
		texture  { BMME_DefectoTexturaMetalica		}
Textura para las aspas.

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 "BMME.inc"
    #include "textures.inc"

    #declare BMME_StringLogo        = "PRISM-LATHE" 
    #declare BMME_TexturaPrincipal  = PinkAlabaster
    #declare BMME_TexturaDecorativa = Sandalwood
    #declare BMME_TexturaTexto      = Gold_Texture
    #declare BMME_TexturaMetalica   = Brass_Texture
    
    object      {
      BMME_Batidora( 0.0 )  
      rotate            180*y
      translate         <-1.925,+1.575,-4.700>    
    }


Notas y Advertencias

El cuerpo principal de la batidora es muy poco flexible, la mayor variabilidad se encuentra en el diseño de las aspas. Puede deformarlas y reubicarlas para crear la apariencia de otros aparatos.

Conviene que los parámetros SeparacionAspas y DiametroAspas tengan el mismo valor o muy parecido, para lograr una mejor mezcla de los alimentos.

Las aspas tienen una porción interna no visible, casi de la tercera parte del tamaño total.


Sugerencias de modificación


Sobre LibreN3D

Algo hace falta En la actualidad dedico casi unas dos horas todos los días, para desarrollar mis proyectos de animación con el compilador FreePascal para FreeDOS.  Mi propuesta original fue filmar animaciones de "baja" calidad, con progreso lento y paulatino. Desconocía en ese entonces del programa POV-Ray.  Creo que con ayuda de dicho proyecto, podría lograr mucho mejores resultados desde un principio.  Confío que dentro de algunos años pueda lograr animaciones completas de aceptable calidad.   En la actualidad, intento agregarle características elásticas a los objetos.  He tenido numerosos retrasos, así que todavía no funciona.  Lo siento...(24/abril/2018), pero me siento muy seguro de que pronto lo lograré.  De momento, no tiene interface con el usuario, pero se encuentra en desarrollo como intérprete de renglón al estilo DOS.

Me sería de muchísima ayuda, que el grupo POV-Ray siguiera desarrollando la versión para DOS.   Los siguientes son enlaces que podrían ser de utilidad para el interesado en los proyectos FreePascal y FreeDOS.
Logo FreeDOS...
Descarga sistema operativo FreeDOS
Logo FreePascal...
Descarga compilador FreePascal