ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / ISIS Component API Reference / ISIS Component Functions Reference / Driver Communication and Setup Functions / IG_ISIS_drv_send_dither
In This Topic
    IG_ISIS_drv_send_dither
    In This Topic

    Send a downloadable dither pattern to the scanner.

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ACCUAPI IG_ISIS_drv_send_dither(
            HISISDRV hDriver,
            AT_MODE nTag
    );
    

    Arguments:

    Name Type Description
    hDriver HISISDRV The handle to the driver.
    nTag AT_MODE Specifies the downloadable dither tag whose value is to be sent to the scanner, either IG_ISIS_TAG_DITHERPATTERN_1 or IG_ISIS_TAG_DITHERPATTERN_2.

    Return Value:

    Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

    Supported Raster Image Formats:

    This function does not process image pixels.

    Remarks:

    The IG_ISIS_drv_send_dither function sends the downloadable dither pattern stored in one of the downloable dither tags down to the scanner.

    Before calling IG_ISIS_drv_send_dither, you should have already called IG_ISIS_drv_read_dither_file with the tag specified in nTag to obtain a downloadable dither pattern from the user or called IG_ISIS_tag_set_long on nTag to configure a downloadable dither pattern. Use IG_ISIS_drv_send_dither to actually forward the dither pattern data to the scanner hardware.

    See Also:

    IG_ISIS_drv_read_dither_file

    IG_ISIS_drv_read_gamma_file

    IG_ISIS_drv_send_gamma

    IG_ISIS_TAG_DITHER

    IG_ISIS_TAG_DITHER_PATTERN1

    IG_ISIS_TAG_DITHER_PATTERN2