com.deltaxml.cores9api.config

Class SVGConfiguration

java.lang.Object

com.deltaxml.cores9api.config.SVGConfiguration

public class SVGConfiguration
extends java.lang.Object

Specifies configuration options for SVG comparison. These configuration options can be specified on a DocumentComparator to configure its behaviour when comparing SVG.

Since:

12.2

Constructor Summary

Constructors

Constructor and Description
SVGConfiguration() Constructor.

Method Summary

Modifier and Type	Method and Description
void	enableNumericTolerance(boolean value) Sets whether to use a numeric tolerance.
double	getFallbackChangePercentage() Sets the fallback change percentage setting for SVG comparison results.
java.lang.String	getInputASVGMarkupStyle() Returns the Input A SVG markup style setting for SVG comparison results.
java.lang.String	getInputBSVGMarkupStyle() Returns the Input B SVG markup style setting for SVG comparison results.
java.lang.String	getNumericToleranceValue() Sets the numeric tolerance value for SVG comparison results.
SVGGranularity	getSVGComparisonGranularity() Returns the granularity setting for SVG comparison results.
java.lang.String	getXpathToReferencedSVG() Returns the XPath to the referenced SVG.
java.lang.String	getZIndexSVGMarkupStyle() Returns the Input Z SVG markup style setting for SVG comparison results.
boolean	isEnabled() Determines whether SVG comparison is enabled.
boolean	isFallbackEnabled() Determines whether to fallback to SVGGranularity.ADJACENT.
boolean	isNumericToleranceEnabled() Determines whether to use numeric tolerance.
boolean	isZIndexEnabled() Determines whether to recognise moves and show Z-index changes in SVG Comparisons.
void	setEnabled(boolean value) Sets whether the DocumentComparator should do SVG comparison.
void	setFallback(boolean value) Sets whether to fallback to SVGGranularity.DETAILED.
void	setFallbackChangePercentage(double fallbackChangePercentage) Sets fallback change percentage setting for SVG comparison results.
void	setInputASVGMarkupStyle(java.lang.String inputASVGMarkupStyle) Sets the Input A SVG markup style setting for SVG comparison results.
void	setInputBSVGMarkupStyle(java.lang.String inputBSVGMarkupStyle) Sets the Input B SVG markup style setting for SVG comparison results.
void	setNumericToleranceValue(java.lang.String numericToleranceValue) Sets the numeric tolerance value for SVG comparison results.
void	setSVGComparisonGranularity(SVGGranularity svgComparisonGranularity) Sets the granularity at which the differences between two SVG images will be represented.
void	setXpathToReferencedSVG(java.lang.String xPathToReferencedSVG) Sets XPath to the referenced SVG.
void	setZIndex(boolean value) Sets whether the DocumentComparator should show Z-Index changes in a SVG comparison.
void	setZIndexSVGMarkupStyle(java.lang.String zIndexSVGMarkupStyle) Sets the Z Index SVG markup style setting for SVG comparison results.

Methods inherited from class java.lang.Object

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

Constructor Detail

SVGConfiguration

public SVGConfiguration()

Constructor.

Method Detail

setEnabled

public void setEnabled(boolean value)

Sets whether the DocumentComparator should do SVG comparison.

SVG comparison is recommended as it will use SVG XML-aware features when comparing two SVG images to ensure that the result can be rendered.

Parameters:

value - whether to use SVG comparison

isEnabled

public boolean isEnabled()

Determines whether SVG comparison is enabled.

Returns:

a boolean describing the enabled state of SVG comparison

setSVGComparisonGranularity

public void setSVGComparisonGranularity(SVGGranularity svgComparisonGranularity)

Sets the granularity at which the differences between two SVG images will be represented. The default is SVGComparisonGranularity.DETAILED_ADJACENT.

Parameters:

svgComparisonGranularity - an instance of SVGGranularity

getSVGComparisonGranularity

public SVGGranularity getSVGComparisonGranularity()

Returns the granularity setting for SVG comparison results.

Returns:

an instance of SVGGranularity

setZIndex

public void setZIndex(boolean value)

Sets whether the DocumentComparator should show Z-Index changes in a SVG comparison.

Z-Index changes in SVG comparisons are recommended as it will recognise Z-index changes and render the changes with an alternate colour.

Parameters:

value - whether to use SVG comparison

isZIndexEnabled

public boolean isZIndexEnabled()

Determines whether to recognise moves and show Z-index changes in SVG Comparisons.

Returns:

a boolean describing the enabled state of SVG comparison Z-Index change recognition

setFallback

public void setFallback(boolean value)

Sets whether to fallback to SVGGranularity.DETAILED. SVG comparison granularity will fallback to SVGGranularity.ADJACENT if SVG exceeds the number changed elements defined by FallbackChangePercentage.

Parameters:

value - whether to use SVG comparison

isFallbackEnabled

public boolean isFallbackEnabled()

Determines whether to fallback to SVGGranularity.ADJACENT.

Returns:

a boolean describing the enabled state of SVG comparison fallback

setFallbackChangePercentage

public void setFallbackChangePercentage(double fallbackChangePercentage)

Sets fallback change percentage setting for SVG comparison results. The default value is 30.00%.

Parameters:

fallbackChangePercentage - a value for fallback change percentage

getFallbackChangePercentage

public double getFallbackChangePercentage()

Sets the fallback change percentage setting for SVG comparison results.

Returns:

an instance of SVGGranularity

setInputASVGMarkupStyle

public void setInputASVGMarkupStyle(java.lang.String inputASVGMarkupStyle)

Sets the Input A SVG markup style setting for SVG comparison results. The default is "red" and XML Compare expects the style in the same format.

Parameters:

inputASVGMarkupStyle - the Input A SVG markup style

getInputASVGMarkupStyle

public java.lang.String getInputASVGMarkupStyle()

Returns the Input A SVG markup style setting for SVG comparison results.

Returns:

the Input A SVG markup style

setInputBSVGMarkupStyle

public void setInputBSVGMarkupStyle(java.lang.String inputBSVGMarkupStyle)

Sets the Input B SVG markup style setting for SVG comparison results. The default is "green" and XML Compare expects the style in the same format.

Parameters:

inputBSVGMarkupStyle - the Input B SVG markup style

getInputBSVGMarkupStyle

public java.lang.String getInputBSVGMarkupStyle()

Returns the Input B SVG markup style setting for SVG comparison results.

Returns:

the Input B SVG markup style

setZIndexSVGMarkupStyle

public void setZIndexSVGMarkupStyle(java.lang.String zIndexSVGMarkupStyle)

Sets the Z Index SVG markup style setting for SVG comparison results. The default is "purple" and XML Compare expects the style in the same format.

Parameters:

zIndexSVGMarkupStyle - the Input Z SVG markup style

getZIndexSVGMarkupStyle

public java.lang.String getZIndexSVGMarkupStyle()

Returns the Input Z SVG markup style setting for SVG comparison results.

Returns:

the Input Z SVG markup style

setNumericToleranceValue

public void setNumericToleranceValue(java.lang.String numericToleranceValue)

Sets the numeric tolerance value for SVG comparison results. The default value is 1%.

Parameters:

numericToleranceValue - a value for SVG numeric tolerance either fixed value or percentage

getNumericToleranceValue

public java.lang.String getNumericToleranceValue()

Sets the numeric tolerance value for SVG comparison results.

Returns:

the string value of the SVG numeric tolerance

enableNumericTolerance

public void enableNumericTolerance(boolean value)

Sets whether to use a numeric tolerance. SVG comparison will check co-ordinate values are within specified tolerance and therefore can be considered having negligable change.

Parameters:

value - whether to use in SVG comparison

isNumericToleranceEnabled

public boolean isNumericToleranceEnabled()

Determines whether to use numeric tolerance.

Returns:

a boolean describing the enabled state of SVG comparison numeric tolerance

setXpathToReferencedSVG

public void setXpathToReferencedSVG(java.lang.String xPathToReferencedSVG)

Sets XPath to the referenced SVG. This is a xpath to an attribute referencing SVG relative to its parent element. For example. with an HTML input documents, XPath to the referenced SVG will be *:img/@src. This configuration assumes SVG can be created at the same place as that of it's reference. It also assumes that SVG doesn't require a container around it. For example, if the DITA files are compared using XML Compare then this configuration will not work as DITA expects an SVG within a svg-container element. While applying SVG comparison to format like DITA XML Compare will need a special filter to consider svg-container.

Parameters:

xPathToReferencedSVG - XPath to the referenced SVG.

getXpathToReferencedSVG

public java.lang.String getXpathToReferencedSVG()

Returns the XPath to the referenced SVG.

Returns:

the XPath to the referenced SVG.