Previous:Object Modifiers   Main Index   Next:Bounded_By



Clipped_By

The clipped_by statement is technically an object modifier but it provides a type of CSG similar to CSG intersection. The syntax is:

CLIPPED_BY:
clipped_by { UNTEXTURED_SOLID_OBJECT... } | clipped_by { bounded_by }

Where UNTEXTURED_SOLID_OBJECT is one or more solid objects which have had no texture applied. For example:

  object {

    My_Thing

    clipped_by{plane{y,0}}

  }

Every part of the object My_Thing that is inside the plane is retained while the remaining part is clipped off and discarded. In an intersection object the hole is closed off. With clipped_by it leaves an opening. For example the following figure shows object A being clipped by object B.

An object clipped by another object.

You may use clipped_by to slice off portions of any shape. In many cases it will also result in faster rendering times than other methods of altering a shape. Occasionally you will want to use the clipped_by and bounded_by options with the same object. The following shortcut saves typing and uses less memory.

  object {

    My_Thing

    bounded_by { box { <0,0,0>, <1,1,1> } }

    clipped_by { bounded_by }

  }

This tells POV-Ray to use the same box as a clip that was used as a bounds.



Previous:Object Modifiers   Main Index   Next:Bounded_By