doc.txt

Tiles Library

_Tiles Library_
=============

Files: _tiles.ss_

The tiles library allows you to combine existing images horizontally
and vertically (like putting floor tiles next to one another), as well
as to rotate and reflect them.

> image-above : image image ... -> image
       concatenates the specified images vertically, with the first one
       at the top and the last at the bottom.  The pinholes are lined up
       in the x dimension.  If you apply image-above to two images, the 
       pinhole of the result is halfway between the pinholes of the two
       images; if more than two, it's more complicated.

> image-above-align-left : image image ... -> image
    Like image-above, but lines up the left edges of all the images. 

> image-above-align-right : image image ... -> image
    Like image-above, but lines up the right edges of all the images. 

> image-beside : image image ... -> image
    produces an image with the first image to the left of the second,
    which in turn is to the left of the third, etc. The pinholes are lined
    up in the y dimension. If you apply image-beside to two images, the
    pinhole of the result is halfway between the pinholes of the two images;
    if more than two, it's more complicated. 

> image-beside-align-top : image image ... -> image
    Like image-beside, but lines up the top edges of all the images. 

> image-beside-align-bottom : image image ... -> image
    Like image-beside, but lines up the bottom edges of all the images. 

> reflect-vert : image -> image
    Reflects the given image top-to-bottom. 

> reflect-horiz : image -> image
    Reflects the given image left-to-right and bottom. 

> reflect-main-diag : image -> image
    Reflects the given image across the diagonal from top-left to
    bottom-right; in other words, it swaps top-right with bottom-left. 

> reflect-other-diag : image -> image
    Reflects the given image across the diagonal from top-right to
    bottom-left; in other words, it swaps top-left with bottom-right. 

> rotate-cw : image -> image
    Rotates the given image 90 degrees clockwise around its pinhole. 

> rotate-ccw : image -> image
    Rotates the given image 90 degrees counterclockwise around its pinhole. 

> rotate-180 : image -> image
    Rotates the given image 180 degrees around its pinhole. 

> show-pinhole : image -> image
    Adds a small black dot to the image so you can see where the pinhole
    is (useful in debugging).