CDE/cde/lib/DtHelp/il/ilscaleint.h

/*
 * CDE - Common Desktop Environment
 *
 * Copyright (c) 1993-2012, The Open Group. All rights reserved.
 *
 * These libraries and programs are free software; you can
 * redistribute them and/or modify them under the terms of the GNU
 * Lesser General Public License as published by the Free Software
 * Foundation; either version 2 of the License, or (at your option)
 * any later version.
 *
 * These libraries and programs are distributed in the hope that
 * they will be useful, but WITHOUT ANY WARRANTY; without even the
 * implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
 * PURPOSE. See the GNU Lesser General Public License for more
 * details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with these libraries and programs; if not, write
 * to the Free Software Foundation, Inc., 51 Franklin Street, Fifth
 * Floor, Boston, MA 02110-1301 USA
 */
/* $XConsortium: ilscaleint.h /main/3 1995/10/23 16:00:23 rswiston $ */
/**---------------------------------------------------------------------
***	
***    (c)Copyright 1991 Hewlett-Packard Co.
***    
***                             RESTRICTED RIGHTS LEGEND
***    Use, duplication, or disclosure by the U.S. Government is subject to
***    restrictions as set forth in sub-paragraph (c)(1)(ii) of the Rights in
***    Technical Data and Computer Software clause in DFARS 252.227-7013.
***                             Hewlett-Packard Company
***                             3000 Hanover Street
***                             Palo Alto, CA 94304 U.S.A.
***    Rights for non-DOD U.S. Government Departments and Agencies are as set
***    forth in FAR 52.227-19(c)(1,2).
***
***-------------------------------------------------------------------*/

#ifndef ILSCALEINT_H
#define ILSCALEINT_H

     /* PRIVATE definitions shared between scaling code, e.g. /ilc/ilscale.c .
        NO OTHER CODE SHOULD INCLUDE THIS FILE !
     */


        /*  In /ilc/ilbigray.c : */

    /*  Called by ilScale().
        Adds an element to "pipe" to scale the pipe image to "dstWidth" by "dstHeight"
        which both must be > 0.  The input pipe image must be a bitonal,
        bit-per-pixel image, with the given "blackIsZero".  "pInfo" points to the
        pipe info, "dstWidth/Height" is the (> 0) size to scale to, and nGrayLevels
        is the number of levels of gray.  The output image is a gray image.
            Only a scale down in both directions is allowed; the following must be true:
        srcWidth must be >= dstWidth and srcHeight must be >= dstHeight!
    */
IL_EXTERN void _ilScaleBitonalToGray (
    ilPipe              pipe,
    unsigned long       dstWidth,
    unsigned long       dstHeight,
    unsigned long       nGrayLevels,
    ilBool              blackIsZero,
    ilPipeInfo         *pInfo
    );

    /*  Called by ilScale().
        Adds an element to "pipe" to scale the pipe image to "dstWidth" by "dstHeight"
        which both must be > 0.  The input pipe image must be a bitonal,
        bit-per-pixel image, with _any_ "blackIsZero".  The resulting image is of the 
        same type. "pInfo" points to the pipe info, "dstWidth/Height" is the (> 0) size 
        to scale to.
            Only a scale down in both directions is allowed; the following must be true:
        srcWidth must be >= dstWidth and srcHeight must be >= dstHeight!
            Logically the same as ilScaleBitonalToGray(): a gray byte is produced for
        each destination pixel, using 256 levels of gray.  If that byte is 
        >= "*pGrayThreshold"; a white pixel is written; else a black pixel is written.
            NOTE: the value at "*pGrayThreshold" is read each time the pipe is executed
        (during Init()); the caller change its value and get different results without
        recreating the pipe.  If "pGrayThreshold" is NULL, a default value is used.
    */
IL_EXTERN void _ilAreaScaleBitonal (
    ilPipe              pipe,
    unsigned long       dstWidth,
    unsigned long       dstHeight,
    int                *pGrayThreshold,
    ilPipeInfo         *pInfo
    );

IL_EXTERN void _ilScaleSample (
    ilPipe              pipe,
    int                 Ncomponents,
    unsigned long       dstWidth,
    unsigned long       dstHeight,
    unsigned long       nLevels,
    ilBool              blackIsZero,
    ilPipeInfo         *pInfo
    );



#endif