  COMMAND DISPLACE
-----------------------------------------------------------------
    Purpose: displacement-map (similar to Imagine's "Applique")
      Usage: displace(<objectID>,<destID>,<filename>,<magnitude>,
                      <x-translation>,<y-translation>[,<subgroup>]))
   Examples: displace(1,2,ram:pic,32,0,0)
             displace(1,2,ram:pic,32,10,0,sg)
             (Translate the brush 10 units into x-direction, restrict
              it to subgroup "sg".)
      Notes: 1. Advantages:
                 -Now it's possible to have an animated "applique"-
                  effect using an image-sequence (e.g. from a 2D
                  morph-program)

                  Loop-example:
                   load(1,plane)
                   for(i,1,60)
                    displace(1,2,pic.%,32,0,0,group1)
                    save(2,obj.%)
                   end

                 -The map can be restricted to a subgroup.
             2. The points are always moved into positive z-direction,
                <magnitude> specifies the maximum displacement.
             3. Because Dust only uses PPM-files you have to
                set up the parameter MODULEDIR if you want to
                have automatic conversion of IFF-images.

See also SHOWIMAGE and Parameters (MODULEDIR).
