ImageGear for C and C++ on Windows v19.3 - Updated
IG_ISIS_drv_chop_before_driver
API Reference Guide > ISIS Component API Reference > ISIS Component Functions Reference > Pipe Functions > IG_ISIS_drv_chop_before_driver

Break a pipe into two pipes.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_ISIS_drv_chop_before_driver(
        HISISDRV hPipe,
        HISISDRV hChopee
);

Arguments:

Name Type Description
hPipe HISISDRV The pipe handle (which is usually the handle of the head driver of the pipe).
hChopee HISISDRV The driver handle before which to break the pipe.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

The IG_ISIS_drv_chop_before_driver function unlinks the driver you specify and all following drivers in a pipe. This leaves one pipe consisting of all the drivers up to but not including the driver you specified, and another pipe starting with the driver you specified and drivers that follow it.

Use IG_ISIS_drv_chop_before_driver to break an ISIS pipe into two independent pipes. After calling this function, you are left with two pipes in memory-one consisting of the original pipe up to but not including the driver referenced by hChopee, and one starting with hChopee and all drivers that followed it in the original pipe.

See Also:

IG_ISIS_drv_append

IG_ISIS_drv_chop_tail

IG_ISIS_drv_get_tail