/*
    Spectroscopic Toolkit version 1.92 by Pieter Suurmond, september 7, 2006.

    Copyright (c) 2000-2006 - Pieter Suurmond

    Permission is hereby granted, free of charge, to any person obtaining
    a copy of this software and associated documentation files
    (the "Software"), to deal in the Software without restriction,
    including without limitation the rights to use, copy, modify, merge,
    publish, distribute, sublicense, and/or sell copies of the Software,
    and to permit persons to whom the Software is furnished to do so,
    subject to the following conditions:

    The above copyright notice and this permission notice shall be
    included in all copies or substantial portions of the Software.

    Any person wishing to distribute modifications to the Software is
    requested to send the modifications to the original developer so that
    they can be incorporated into the canonical version.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
    EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
    IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
    ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
    CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
    WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


    To produce graphic scores (from the wavelet linked list) in JPEG-format.
    Subdirectory gt/ contains my minimal graphic toolkit. Unfortunately, the good old
    'gd1.2', written by Tom Boutell, 1994, Cold Spring Harbor Labs, could no longer be
    used because of Unisys patent on LZW-compression. Now using compression from IJG.
*/

/*-----------------------------------------------------------------------------------------*/
short scoreWAVELETS(ENGINEp     E,
                    const char* filename,
                    int         xpix,
                    int         ypix,
                    short       envelopeTracking,
                    const char* title,
                    FILE*       msg);
/*
    Draws graphic musical score from the given linked list with wavelets in ENGINE E.
    Also reads samplerate constants and envelope tables for visualisation.
    Specify desired dimensions of the image with arguments xpix and ypix.
    When argument envelopeTracking is nonzero, envelope shapes are visualised by
    greyscales. When envelopeTracking is zero, only average amplitude (not its' 
    evolution in time) will be greyscaled.
    Title may be NULL, or a pointer to a null-terminated ASCII string in which case 
    it is printed in the topleft corner of the image.
    Argument msg may be NULL, stdout, stderr, or some text filepointer.
    Returns zero on success, nonzero on failures.
*/

/*-----------------------------------------------------------------------------------------*/
short visualiseTables(ENGINEp E, int width, int height, FILE* msg);
/*
      Saves to disk 4 image files, visualising all tables used in ENGINE E.
      All images have the same size.
      Filenames: env......
      Returns 0 on success, nonzero on failures.
      Argument msg may be NULL, stdout, stderr, or some (text)filepointer.
*/