com.itextpdf.io.util

Class ImageMagickHelper

java.lang.Object

com.itextpdf.io.util.ImageMagickHelper

public class ImageMagickHelper
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static String	MAGICK_COMPARE_ENVIRONMENT_VARIABLE The name of the environment variable with the command to execute ImageMagic comparison operations.

Constructor Summary

Constructors

Constructor and Description
ImageMagickHelper()
ImageMagickHelper(String newCompareExec)

Method Summary

Modifier and Type	Method and Description
String	getCliExecutionCommand() Returns a command that is used to run the utility.
boolean	runImageMagickImageCompare(String outImageFilePath, String cmpImageFilePath, String diffImageName) Runs imageMagick to visually compare images and generate difference output.
boolean	runImageMagickImageCompare(String outImageFilePath, String cmpImageFilePath, String diffImageName, String fuzzValue) Runs imageMagick to visually compare images with the specified fuzziness value and generate difference output.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MAGICK_COMPARE_ENVIRONMENT_VARIABLE

public static final String MAGICK_COMPARE_ENVIRONMENT_VARIABLE

The name of the environment variable with the command to execute ImageMagic comparison operations.

See Also:

Constant Field Values

Constructor Detail

ImageMagickHelper

public ImageMagickHelper()

ImageMagickHelper

public ImageMagickHelper(String newCompareExec)

Method Detail

getCliExecutionCommand

public String getCliExecutionCommand()

Returns a command that is used to run the utility. This command doesn't contain command parameters. Parameters are added on specific methods invocation.

Returns:

a string command

runImageMagickImageCompare

public boolean runImageMagickImageCompare(String outImageFilePath,
                                          String cmpImageFilePath,
                                          String diffImageName)
                                   throws IOException,
                                          InterruptedException

Runs imageMagick to visually compare images and generate difference output.

Parameters:

outImageFilePath - Path to the output image file

cmpImageFilePath - Path to the cmp image file

diffImageName - Path to the difference output image file

Returns:

boolean result of comparing: true - images are visually equal

Throws:

IOException - if there are file's reading/writing issues

InterruptedException - if there is thread interruption while executing ImageMagick.

runImageMagickImageCompare

public boolean runImageMagickImageCompare(String outImageFilePath,
                                          String cmpImageFilePath,
                                          String diffImageName,
                                          String fuzzValue)
                                   throws IOException,
                                          InterruptedException

Runs imageMagick to visually compare images with the specified fuzziness value and generate difference output.

Parameters:

outImageFilePath - Path to the output image file

cmpImageFilePath - Path to the cmp image file

diffImageName - Path to the difference output image file

fuzzValue - String fuzziness value to compare images. Should be formatted as string with integer or decimal number. Can be null, if it is not required to use fuzziness

Returns:

boolean result of comparing: true - images are visually equal

Throws:

IOException - if there are file's reading/writing issues

InterruptedException - if there is thread interruption while executing ImageMagick.