A Simple Button Macro

If your animations include a lot of science fiction work, or other instances where a push button is part of the scene, this short macro will do a bit of the work for you.
#macro RoundButton(pB, pT, rB, rE, dD, fM)
  #local hB = vlength(pT - pB);
  #local vY = vnormalize(pT - pB);
  #local vX = vnormalize(vcross(vY, <vY.y,vY.z,-vY.x>));
  #local vZ = vnormalize(vcross(vX, vY));
  #if (fM)
    merge
  #else
    union
  #end
  {
  #if (dD < 0)
  #local rD = (2 * rB * rE - rB * rB - rE * rE - dD * dD) / 2 / dD - rE;
    difference {
      lathe { 5, <0,0>, <rB,0>, <rB, hB - rE>, <rB - rE, hB - rE>, <0, hB + rD + dD> }
      sphere { y * (hB + rD + dD), rD }
      bounded_by { cylinder { 0, y * hB, rB } }
    }
  #elseif (dD > 0)
    #local hB = hB - dD;
    #local rD = (rB * rB + rE * rE + dD * dD - 2 * rB * rE) / 2 / dD + rE;
    intersection {
      lathe { 6, <0,0>, <rB,0>, <rB, hB - rE>, <rB - rE, hB - rE>,
        <rB - rE, hB - rE> + 2 * <rB - rE, rD - rE - dD> * rE / (rD - rE),
        <0, rD + rE> }
      sphere { y * (hB + dD - rD), rD }
      bounded_by { cylinder { 0, y * (hB + dD), rB } }
    }
  #else
    cylinder { 0, y * (hB - rE), rB }
    cylinder { y * (hB - 2 * rE), y * hB, (rB - rE) }
  #end
  torus { rB - rE, rE translate y * (hB - rE) }
  matrix <vX.x,vX.y,vX.z, vY.x,vY.y,vY.z, vZ.x,vZ.y,vZ.z, pB.x,pB.y,pB.z>
  }
#end
The button it creates is round, with a rounded edge, and you can make the face flat, dimpled, or protruding. The parameters have the following meaning:
  • pB is a vector that specifies the bottom of the button.
  • pT is a vector that specifies the top of the button.
  • rB is a scalar that specifies the radius of the button.
  • rE is a scalar that specifies the radius of the top edge of the button.
  • dD is a scalar that specifies whether the button is dimpled (for a negative value), flat (a value of zero), or bulging (a positive value).
  • fM specifies whether the pieces of the button will be held in a merge object or a union object. Set this to 1 (or some other non-zero value) if the button's texture will have some transparency, otherwise set it to 0.
    • The resulting button will fit entirely in the cylinder running from pB to pT with a radius of rB.
    To use the macro, place the call to the macro in an object and apply any desired texturing and transformations in that:
    object {
  RoundButton(<0, 0, 0>, <0, .25, 0>, .75, .03, -.02, 0)
  texture { pigment { red 1 } finish { ambient .1 diffuse .9 } }
  translate { ButtonTransform }
}
    This will produce a red button that is 1.5 units across, .25 units tall, with a slightly-rounded edge and a shallow dimple on the face. ButtonTransform will need to be defined in the preceding scripting so that the button can be placed however you need it.
    The chief value of this macro comes from the edge radius and bulge/dimple parameters, because they provide fire-and-forget support for the small but important details. We could use a simple cylinder object to model the button, but real-life push buttons don't have the infinitely-sharp edges that idealized cylinders do, and they often don't have perfectly flat faces, either. Modeling the most common details, and getting everything right so that there are no visible seams between the parts that make up the whole, takes a bit of math that can be easily automated in code.

    Comments

    Post a Comment

    Popular posts from this blog

    Transition Macros

    As part of my animation work I have a set of macros which simplify moving objects from one location to another, or in some other way allow me to transition an object from one state to another. Linear Changes There are going to be times when you want to fade a scene to black or from black, or fade between two scenes. You will want things to be at a starting state up until the motion or change begins, and for it to be at a certain place when the motion ends, and for it to stay there, and for the movement in between those times to occur at a steady rate. When that is the case, a macro like the following will come in handy: #macro Transition(tNow, tStart, pStart, tEnd, pEnd) #if (tNow <= tStart) (pStart) #elseif(tNow >= tEnd) (pEnd) #else (pStart + (pEnd - pStart) * (tNow - tStart) / (tEnd - tStart)) #end #end Call this macro with the parameters set to the following values: tNow : Set this to the current time of the animation (or the time for which you
    Read more

    Titling Made Simple

    Titling is an important part of any animation. Well-done titling adds a touch of professionalism to your work. There are a lot of instances in which you will want to have some kind of titling in your POV-Ray scenes. There are two approaches you can employ to add titling: In-scene titling and post-processed titling. In-scene Titling The first approach has the advantage that it requires only one render. Its disadvantages are: The artist has to make sure that the other scene elements do not obscure the titling; If the titling is changed then the scene has to be entirely re-rendered; The method does not work well (if at all) in scenes where there is a camera effect in place (such as focal blur). In my earlier post about the main scene file , I invoke the scenery file and the titling file separately, so that the scenery file can specify the basic camera parameters, and the latter file can use these settings to place the titling exactly where it needs to be to appear in the re
    Read more

    Star Field Generator

    A lot of POV-Ray users are fans of science fiction, and for this reason will want to create scenes set in space, or if not a fan of science fiction will want an appropraite background for scenes set at night. Whatever the reason, a method for adding a starry backdrop to a scene is a useful addition to your POV-Ray library. A lot of the attempts that have been released make use of a POV-Ray texture, usually a marble pattern that is mostly black with with just enough white (or other light colors) to create the appearance of stars against a black background. This works because it uses the pattern as essentially a random number generator, with a high threshold for turning a pixel on. This can work but for animation work it has several drawbacks: A pattern that generates a scattering of stars at one resolution will have different results at another resolution, most likely fewer stars at lower resolutions, and bands of white matching the underlying pattern used to simulate the effect at
    Read more