/*
    PZT_poze_graph.h API specifying drawing functions for POZE objects.
    PoZeTools v 0.53, december 19, 2006. Copyright (c) 2002-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 ON INFRINGEMENT. 
    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.
*/

/*----------------------------------------------------------------------------*/
/*
    Writes jpeg-image of the supplied poles, zeros and gain in 'pz' to stream 
    'fp'. Argument 'title' may be NULL.
*/
int POZE_jpeg_z_plane(const POZE*   pz,
                      int           width,
                      int           height,
                      const char*   title,
                      int           q,               /* JPEG quality (0-100). */
                      FILE*         fp);             /* Destination stream.   */

/*----------------------------------------------------------------------------*/
/*
    Generates jpeg-image of the frequency response draw from the supplied gain,
    poles and zeros, in the current directory. Argument 'title' may be NULL.
*/
int POZE_jpeg_response_freq(const POZE* pz,
                            int         width,
                            int         height,
                            const char* title,
                            int         q,      /* JPEG quality. */
                            FILE*       fp);    /* Destination. */

/*----------------------------------------------------------------------------*/
/*
    Draws everything, based on the supplied Z-plane description, in one single
    jpeg-image (poles, zeros, gain, response, etc) and outputs to stream 'fp.'
*/
int POZE_jpeg_combined_freq(const POZE* pz,
                            int         log_freq,   /* 0 for lin scale. */
                            int         width,
                            int         height,
                            const char* title,
                            int         q,          /* JPEG quality. */
                            FILE*       fp);        /* Destination. */