    //
    // Grue's Icon library, mark I.
    //
    // -I'd like to add multiple icon sourcefiles, variable sized icons, and other neat things
    // in the future, but in all honesty I'll probably only finish the basic library.
    //
    // To the intrested, feel free to flesh this out into something more useful, and many cookies
    // shall be yours.
    //

    // extracts the first dimension of a flat-indexed 2 dimensionally array given
    // the second dimension's maximum value and the value of the flat index you
    // wish to extract the first dimension's value from.
    //
    int x_from_flat( int flatval, int yMax )

    // extracts the second dimension of a flat-indexed 2 dimensionally array given
    // the second dimension's maximum value and the value of the flat index you
    // wish to extract the second dimension's value from.
    //
    int y_from_flat( int flatval, int yMax )

    #define ICON_WIDTH	16
    #define ICON_HEIGHT	16

    // returns the number of icons that live inside the given source image.
    int icon_max( int src_img )

    // Initializes the icon library.
    void icon_init( string src_file )

    // Returns an imageshell refernce to the specified icon.
    // does not do bounds checking.
    //
    // remember to FreeImage() the imageshell reference when you are done with it.
    int icon_get( int idx )