com.zebra.sdk.common.card.graphics

Class ZebraCardGraphics

Object

com.zebra.sdk.common.card.graphics.ZebraCardGraphics

All Implemented Interfaces:

ZebraGraphics, ZebraGraphicsI, Cloneable

public class ZebraCardGraphics
extends Object
implements ZebraGraphics, Cloneable

Used to construct the graphics for Card printers.

Constructor Summary

Constructors

Constructor and Description
ZebraCardGraphics(ZebraCardPrinter genericPrinter) Public Constructor to construct the ZebraCardGraphics object.

Method Summary

Methods

Modifier and Type	Method and Description
void	clear() Clears user set parameters.
Object	clone()
void	close() Releases all the resources.
byte[]	convertImageToRGB(byte[] imageData) Converts the image to RGB format.
ZebraCardImageI	createImage() Generates the final bitmap image.
ZebraCardImageI	createImage(String colorProfileName) Generates the final bitmap image.
byte[]	cropImage(byte[] imageData, int x, int y, int width, int height) Crops an image to supplied dimensions and returns the cropped image data.
void	drawEllipse(int x, int y, int width, int height, int lineThickness, java.awt.Color lineColor, java.awt.Color fillColor) Draws an ellipse at the specified coordinates
void	drawImage(byte[] imageData, ImagePosition position, int width, int height, float transparency, RotationType rotation) Draws the image at the specified image position in the rectangle.
void	drawImage(byte[] imageData, int x, int y, int width, int height, float transparency, RotationType rotation) Draws the image into the specified rectangle.
void	drawImage(byte[] imageData, int x, int y, int width, int height, RotationType rotation) Draws the image into the specified rectangle
void	drawLine(int x1, int y1, int x2, int y2, float lineThickness, java.awt.Color lineColor) Draws a Line from the specified coordinates.
void	drawRectangle(int x, int y, int width, int height, float lineThickness, java.awt.Color lineColor, java.awt.Color fillColor) Draws a rectangle at the specified coordinates
void	drawRoundedRectangle(int x, int y, int width, int height, float radius, float lineThickness, java.awt.Color lineColor, java.awt.Color fillColor) Draws a round-cornered rectangle at the specified coordinates.
void	drawText(String text, int x, int y, java.awt.Color textColor) Draws the text at the specified x and y coordinates.
void	drawText(String text, int x, int y, int angle, java.awt.Color textColor) Draws the text at the specified x and y coordinates and center rotates the text to the specified angle
void	drawText(String text, int x, int y, int width, int height, int angle, java.awt.Color textColor) Draws the text into the specified rectangle.
void	drawText(String text, int x, int y, int width, int height, int angle, java.awt.Color textColor, boolean shrinkToFit) Draws the text into the specified rectangle.
void	drawText(String text, int x, int y, int width, int height, int angle, TextAlignment horizontal, TextAlignment vertical, java.awt.Color textColor) Draws the text into the specified rectangle.
void	drawText(String text, int x, int y, int width, int height, int angle, TextAlignment horizontal, TextAlignment vertical, java.awt.Color textColor, boolean shrinkToFit) Draws the text into the specified rectangle.
ExtractedImages	extractBlackImageData(byte[] imageData, int redThreshold, int greenThreshold, int blueThreshold) Separates the monochrome and color data from the specified image data using the specified threshold values.
byte[]	extractHalfPanelImageData(byte[] imageData) Attempts to identify and extract the color and non-color half panel regions of the source image.
java.awt.Graphics2D	getGraphics2D() Returns the awt Graphics2D class
PrinterModel	getPrinterModel() Returns the printer model.
PrintType	getPrintType() Returns the type of print to be performed for the given image data.
java.awt.image.BufferedImage	imageDataToImage(byte[] imageData) Creates a BufferedImage object from the raw bitmap data.
byte[]	imageToImageData(java.awt.image.BufferedImage image) Converts a BufferedImage into it's raw image data
void	initialize(int maxWidth, int maxHeight, OrientationType orientation, PrintType printType, java.awt.Color fillColor) Initializes the drawing surface.
void	initialize(int maxWidth, int maxHeight, OrientationType orientation, PrintType printType, Integer fillColor) Initializes the drawing surface if the specified maxWidth or maxHeight is 0 then the maximum values for the specified printer model will be used
void	monochromeConversionType(MonochromeConversion type) Sets the monochrome conversion type to be used during ZebraGraphicsI.createImage().
byte[]	rotateImage(byte[] imageData, int width, int height, RotationType type) Rotates the image and then resizes the image.
byte[]	rotateImage(byte[] imageData, RotationType type) Rotates the image.
void	setBrightnessLevel(int level) Sets the brightness correction level to be applied during ZebraGraphicsI.createImage()
void	setColorScale(int red, int green, int blue) Sets the color scale correction values for red, green, and blue pixel values during ZebraGraphicsI.createImage()
void	setContrastLevel(int level) Sets the contrast correction level to be applied during ZebraGraphicsI.createImage()
void	setFont(java.awt.Font font) Sets the font type to be used during drawText operations.
void	setGammaLevel(int level) Sets the gamma correction level to be applied during ZebraGraphicsI.createImage()
void	setPrinterModel(PrinterModel model) Sets the printer model.
void	setRenderingHints(java.awt.RenderingHints renderingHints) Adds to the RenderingHints to be used during draw operations.
void	setSaturationLevel(int level) Sets the saturation correction level to be applied during ZebraGraphicsI.createImage()

Methods inherited from class Object

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

Constructor Detail

ZebraCardGraphics

public ZebraCardGraphics(ZebraCardPrinter genericPrinter)
                  throws ConnectionException,
                         ZebraCardException

Public Constructor to construct the ZebraCardGraphics object.

Parameters:

genericPrinter - an instance of a zebra card printer.

Throws:

ConnectionException - if the device is busy or an error occurs communicating with the printer.

ZebraCardException - if a printer error occurs.

Method Detail

getPrinterModel

public PrinterModel getPrinterModel()

Returns the printer model.

Returns:

the printer model.

getGraphics2D

public java.awt.Graphics2D getGraphics2D()

Returns the awt Graphics2D class

Returns:

the awt Graphics2D class.

getPrintType

public PrintType getPrintType()

Returns the type of print to be performed for the given image data.

Returns:

the print type.

setPrinterModel

public void setPrinterModel(PrinterModel model)

Description copied from interface: ZebraGraphicsI

Sets the printer model.

Specified by:

setPrinterModel in interface ZebraGraphicsI

Parameters:

model - the printer model type.

See Also:

ZebraGraphicsI.setPrinterModel(PrinterModel)

setFont

public void setFont(java.awt.Font font)

Description copied from interface: ZebraGraphics

Sets the font type to be used during drawText operations.

Specified by:

setFont in interface ZebraGraphics

Parameters:

font - the font of the text to be drawn.

See Also:

ZebraGraphics.setFont(Font)

setRenderingHints

public void setRenderingHints(java.awt.RenderingHints renderingHints)

Description copied from interface: ZebraGraphics

Adds to the RenderingHints to be used during draw operations.

Specified by:

setRenderingHints in interface ZebraGraphics

Parameters:

renderingHints - the rendering hints.

See Also:

ZebraGraphics.setRenderingHints(RenderingHints)

initialize

public void initialize(int maxWidth,
              int maxHeight,
              OrientationType orientation,
              PrintType printType,
              Integer fillColor)

Description copied from interface: ZebraGraphicsI

Initializes the drawing surface

• if the specified maxWidth or maxHeight is 0 then the maximum values for the specified printer model will be used

Specified by:

initialize in interface ZebraGraphicsI

Parameters:

maxWidth - the maximum width of the image (limited based on printer model).

maxHeight - the maximum height of the image (limited based on printer model).

orientation - the orientation of the image.

printType - the type of print to be performed.

fillColor - the RGB background fill color.

See Also:

ZebraGraphicsI.initialize(int, int, OrientationType, PrintType, Integer)

initialize

public void initialize(int maxWidth,
              int maxHeight,
              OrientationType orientation,
              PrintType printType,
              java.awt.Color fillColor)

Description copied from interface: ZebraGraphics

Initializes the drawing surface.

• If the specified maxWidth or maxHeight is 0 then the maximum values for the specified printer model will be used.

Specified by:

initialize in interface ZebraGraphics

Parameters:

maxWidth - the maximum width of the image (limited based on printer model)

maxHeight - the maximum height of the image (limited based on printer model)

orientation - the orientation of the image.

printType - the type of print to be performed for the given image data.

fillColor - the RGB background fill color.

See Also:

ZebraGraphics.initialize(int, int, OrientationType, PrintType, Color)

close

public void close()

Description copied from interface: ZebraGraphicsI

Releases all the resources.

Specified by:

close in interface ZebraGraphicsI

See Also:

ZebraGraphicsI.close()

clear

public void clear()

Description copied from interface: ZebraGraphicsI

Clears user set parameters.

• Note: Will not reset parameters passed in during initialization

Specified by:

clear in interface ZebraGraphicsI

See Also:

ZebraGraphicsI.clear()

createImage

public ZebraCardImageI createImage()
                            throws java.io.IOException

Description copied from interface: ZebraGraphicsI

Generates the final bitmap image.

Specified by:

createImage in interface ZebraGraphicsI

Returns:

ZebraCardImageI instance containing the bitmap image data.

Throws:

java.io.IOException - if an error occurs during reading/writing.

See Also:

ZebraGraphicsI.createImage()

createImage

public ZebraCardImageI createImage(String colorProfileName)
                            throws java.io.IOException

Description copied from interface: ZebraGraphics

Generates the final bitmap image.

Specified by:

createImage in interface ZebraGraphics

Parameters:

colorProfileName - ICC profile to apply to the image.

• 24bpp image format only.
• Ignored if empty or null.

Returns:

ZebraCardImageI containing the bitmap image data.

Throws:

java.io.IOException - if an error occurs creating the image.

See Also:

ZebraGraphics.createImage(String)

convertImageToRGB

public byte[] convertImageToRGB(byte[] imageData)
                         throws java.io.IOException

Description copied from interface: ZebraGraphicsI

Converts the image to RGB format.

Specified by:

convertImageToRGB in interface ZebraGraphicsI

Parameters:

imageData - the source image data.

Returns:

byte[] the RGB image data.

Throws:

java.io.IOException - if an error occurs during reading/writing.

See Also:

ZebraGraphicsI.convertImageToRGB(byte[])

rotateImage

public byte[] rotateImage(byte[] imageData,
                 RotationType type)
                   throws java.io.IOException

Description copied from interface: ZebraGraphicsI

Rotates the image.

Specified by:

rotateImage in interface ZebraGraphicsI

Parameters:

imageData - the source image data.

type - the rotation type.

Returns:

byte[] the rotated image data.

Throws:

java.io.IOException - if an error occurs during reading/writing.

See Also:

ZebraGraphicsI.rotateImage(byte[], RotationType)

rotateImage

public byte[] rotateImage(byte[] imageData,
                 int width,
                 int height,
                 RotationType type)
                   throws java.io.IOException

Description copied from interface: ZebraGraphicsI

Rotates the image and then resizes the image.

Specified by:

rotateImage in interface ZebraGraphicsI

Parameters:

imageData - the source image data.

width - the rotated image width.

height - the rotated image height.

type - the rotation type.

Returns:

byte[] the rotated image data.

Throws:

java.io.IOException - if an error occurs during reading/writing.

See Also:

ZebraGraphicsI.rotateImage(byte[], int, int, RotationType)

cropImage

public byte[] cropImage(byte[] imageData,
               int x,
               int y,
               int width,
               int height)
                 throws java.io.IOException

Description copied from interface: ZebraGraphicsI

Crops an image to supplied dimensions and returns the cropped image data.

Specified by:

cropImage in interface ZebraGraphicsI

Parameters:

imageData - byte[] containing the raw bitmap data.

x - the x-offset of new image.

y - the y-offset of new image.

width - the width of the cropped image.

height - the height of the cropped image.

Returns:

byte[] containing the cropped image data.

Throws:

java.io.IOException - if an error occurs reading the image data.

See Also:

ZebraGraphicsI.cropImage(byte[], int, int, int, int)

setBrightnessLevel

public void setBrightnessLevel(int level)

Description copied from interface: ZebraGraphicsI

Sets the brightness correction level to be applied during ZebraGraphicsI.createImage()

Specified by:

setBrightnessLevel in interface ZebraGraphicsI

Parameters:

level - the brightness level.

• Range: -25 to 25
• Values passed in (-25 to 25) will be converted to a range of -127 to 127 before being applied to each pixel (e.g. a value of 25 will correspond to an actual offset of 127).

See Also:

ZebraGraphicsI.setBrightnessLevel(int)

setContrastLevel

public void setContrastLevel(int level)

Description copied from interface: ZebraGraphicsI

Sets the contrast correction level to be applied during ZebraGraphicsI.createImage()

Specified by:

setContrastLevel in interface ZebraGraphicsI

Parameters:

level - the contrast level.

• Range: -25 to 25
• Values passed in (-25 to 25) will be converted to a range of -127 to 127 before being applied to each pixel (e.g. a value of 25 will correspond to an actual offset of 127).

See Also:

ZebraGraphicsI.setContrastLevel(int)

setGammaLevel

public void setGammaLevel(int level)

Description copied from interface: ZebraGraphicsI

Sets the gamma correction level to be applied during ZebraGraphicsI.createImage()

Specified by:

setGammaLevel in interface ZebraGraphicsI

Parameters:

level - the gamma level.

• Range: -25 to 25

See Also:

ZebraGraphicsI.setGammaLevel(int)

setSaturationLevel

public void setSaturationLevel(int level)

Description copied from interface: ZebraGraphicsI

Sets the saturation correction level to be applied during ZebraGraphicsI.createImage()

Specified by:

setSaturationLevel in interface ZebraGraphicsI

Parameters:

level - the saturation correction level.

• Range: -25 to 25

See Also:

ZebraGraphicsI.setSaturationLevel(int)

setColorScale

public void setColorScale(int red,
                 int green,
                 int blue)

Description copied from interface: ZebraGraphicsI

Sets the color scale correction values for red, green, and blue pixel values during ZebraGraphicsI.createImage()

Specified by:

setColorScale in interface ZebraGraphicsI

Parameters:

red - the red pixel correction value.

green - the green pixel correction value.

blue - the blue pixel correction value.

• Range: -25 to 25
• Values passed in (-25 to 25) will be converted to a range of -127 to 127 before being applied to each pixel (e.g. a value of 25 will correspond to an actual offset of 127).

See Also:

ZebraGraphicsI.setColorScale(int, int, int)

monochromeConversionType

public void monochromeConversionType(MonochromeConversion type)

Description copied from interface: ZebraGraphicsI

Sets the monochrome conversion type to be used during ZebraGraphicsI.createImage().

• Valid for ribbon types of 1bpp and 8bpp only.

Specified by:

monochromeConversionType in interface ZebraGraphicsI

Parameters:

type - the type of monochrome conversion to perform.

See Also:

ZebraGraphicsI.monochromeConversionType(MonochromeConversion)

drawImage

public void drawImage(byte[] imageData,
             int x,
             int y,
             int width,
             int height,
             RotationType rotation)
               throws java.io.IOException,
                      IllegalArgumentException

Description copied from interface: ZebraGraphicsI

Draws the image into the specified rectangle

Specified by:

drawImage in interface ZebraGraphicsI

Parameters:

imageData - the bitmap image data

x - the x coordinate.

y - the y coordinate.

width - the width of the rectangle.

• if 0 then the width of the specified image will be used

height - the height of the rectangle.

• if 0 then the height of the specified image will be used

rotation - the rotation of the image.

Throws:

java.io.IOException - if an error occurs during reading/writing.

IllegalArgumentException - if an argument passed in is not valid.

See Also:

ZebraGraphicsI.drawImage(byte[], int, int, int, int, RotationType)

drawImage

public void drawImage(byte[] imageData,
             int x,
             int y,
             int width,
             int height,
             float transparency,
             RotationType rotation)
               throws java.io.IOException,
                      IllegalArgumentException

Description copied from interface: ZebraGraphics

Draws the image into the specified rectangle.

Specified by:

drawImage in interface ZebraGraphics

Parameters:

imageData - the bitmap image data.

x - the x coordinate.

y - the y coordinate.

width - the width of the rectangle.

• If width is 0 then the width of the specified image will be used.

height - the height of the rectangle.

• If height is 0 then the height of the specified image will be used

transparency - the transparency level.

• 0.0f = completely opaque
• 100.0f = completely transparent

rotation - the rotation type for the image.

Throws:

java.io.IOException - if an error occurs reading the image data.

IllegalArgumentException - if the specified transparency level is outside of the valid range.

See Also:

ZebraGraphics.drawImage(byte[], int, int, int, int, float, RotationType)

drawImage

public void drawImage(byte[] imageData,
             ImagePosition position,
             int width,
             int height,
             float transparency,
             RotationType rotation)
               throws IllegalArgumentException,
                      java.io.IOException

Description copied from interface: ZebraGraphics

Draws the image at the specified image position in the rectangle.

Specified by:

drawImage in interface ZebraGraphics

Parameters:

imageData - the bitmap image data.

position - the position of the image in the rectangle.

width - the width of the rectangle.

• If width is 0 then the width of the specified image will be used.

height - the height of the rectangle.

• If height is 0 then the height of the specified image will be used.

transparency - the transparency level.

• 0.0f = completely opaque
• 100.0f = completely transparent

rotation - the rotation type.

Throws:

IllegalArgumentException - if the specified transparency level is outside of the valid range.

java.io.IOException - if an error occurs reading the image data.

See Also:

ZebraGraphics.drawImage(byte[], ImagePosition, int, int, float, RotationType)

drawText

public void drawText(String text,
            int x,
            int y,
            java.awt.Color textColor)

Description copied from interface: ZebraGraphics

Draws the text at the specified x and y coordinates.

Specified by:

drawText in interface ZebraGraphics

Parameters:

text - the text to be drawn.

x - the x coordinate.

y - the y coordinate.

textColor - the RGB color of the text to be drawn.

See Also:

ZebraGraphics.drawText(String, int, int, Color)

drawText

public void drawText(String text,
            int x,
            int y,
            int angle,
            java.awt.Color textColor)

Description copied from interface: ZebraGraphics

Draws the text at the specified x and y coordinates and center rotates the text to the specified angle

Specified by:

drawText in interface ZebraGraphics

Parameters:

text - the text to be drawn.

x - the x coordinate.

y - the y coordinate.

angle - the angle of the the text to be drawn (center rotated).

textColor - the RGB color of the text to be drawn.

See Also:

ZebraGraphics.drawText(String, int, int, int, Color)

drawText

public void drawText(String text,
            int x,
            int y,
            int width,
            int height,
            int angle,
            java.awt.Color textColor)
              throws IllegalArgumentException

Description copied from interface: ZebraGraphics

Draws the text into the specified rectangle.

Specified by:

drawText in interface ZebraGraphics

Parameters:

text - the text to be drawn.

x - the x coordinate.

y - the y coordinate.

width - the width of the rectangle.

height - the height of the rectangle.

angle - the angle of the the text to be drawn (center rotated).

textColor - the RGB color of the text to be drawn.

Throws:

IllegalArgumentException - if the specified width and height are not large enough to contain the text.

See Also:

ZebraGraphics.drawText(String, int, int, int, int, int, Color)

drawText

public void drawText(String text,
            int x,
            int y,
            int width,
            int height,
            int angle,
            java.awt.Color textColor,
            boolean shrinkToFit)
              throws IllegalArgumentException

Description copied from interface: ZebraGraphics

Draws the text into the specified rectangle.

Specified by:

drawText in interface ZebraGraphics

Parameters:

text - the text to be drawn.

x - the x coordinate.

y - the y coordinate.

width - the width of the rectangle.

height - the height of the rectangle.

angle - the angle of the the text to be drawn.

textColor - the RGB color of the text to be drawn.

shrinkToFit - True to adjust the font size to fit the specified width and height.

Throws:

IllegalArgumentException - if the specified width and height are not large enough to contain the text and shrinkToFit is false.

See Also:

ZebraGraphics.drawText(String, int, int, int, int, int, Color, boolean)

drawText

public void drawText(String text,
            int x,
            int y,
            int width,
            int height,
            int angle,
            TextAlignment horizontal,
            TextAlignment vertical,
            java.awt.Color textColor)
              throws IllegalArgumentException

Description copied from interface: ZebraGraphics

Draws the text into the specified rectangle.

Specified by:

drawText in interface ZebraGraphics

Parameters:

text - the text to be drawn.

x - the x coordinate.

y - the y coordinate.

width - the width of the rectangle.

height - the height of the rectangle.

angle - the angle of the the text to be drawn.

horizontal - the horizontal alignment of the text.

vertical - the vertical alignment of the text.

textColor - the RGB color of the text to be drawn.

Throws:

IllegalArgumentException - if the specified width and height are not large enough to contain the text.

See Also:

ZebraGraphics.drawText(String, int, int, int, int, int, TextAlignment, TextAlignment, Color)

drawText

public void drawText(String text,
            int x,
            int y,
            int width,
            int height,
            int angle,
            TextAlignment horizontal,
            TextAlignment vertical,
            java.awt.Color textColor,
            boolean shrinkToFit)
              throws IllegalArgumentException

Description copied from interface: ZebraGraphics

Draws the text into the specified rectangle.

Specified by:

drawText in interface ZebraGraphics

Parameters:

text - the text to be drawn.

x - the x coordinate.

y - the y coordinate.

width - the width of the rectangle.

height - the height of the rectangle.

angle - the angle of the the text to be drawn.

horizontal - the horizontal alignment of the text.

vertical - the vertical alignment of the text.

textColor - the RGB color of the text to be drawn.

shrinkToFit - true to adjust the font size to fit the specified width and height.

Throws:

IllegalArgumentException - if the specified width and height are not large enough to contain the text and shrinkToFit is false.

See Also:

ZebraGraphics.drawText(String, int, int, int, int, int, TextAlignment, TextAlignment, Color, boolean)

drawLine

public void drawLine(int x1,
            int y1,
            int x2,
            int y2,
            float lineThickness,
            java.awt.Color lineColor)

Description copied from interface: ZebraGraphics

Draws a Line from the specified coordinates.

Specified by:

drawLine in interface ZebraGraphics

Parameters:

x1 - the X coordinate of the start point

y1 - the Y coordinate of the start point

x2 - the X coordinate of the end point

y2 - the Y coordinate of the end point

lineThickness - the thickness of the line.

lineColor - the RGB line color.

See Also:

ZebraGraphics.drawLine(int, int, int, int, float, Color)

drawRectangle

public void drawRectangle(int x,
                 int y,
                 int width,
                 int height,
                 float lineThickness,
                 java.awt.Color lineColor,
                 java.awt.Color fillColor)

Description copied from interface: ZebraGraphics

Draws a rectangle at the specified coordinates

Specified by:

drawRectangle in interface ZebraGraphics

Parameters:

x - the x coordinate.

y - the y coordinate.

width - the width of the rectangle.

height - the height of the rectangle.

lineThickness - the line thickness of the rectangle.

• the lineThickness will be ignored if the lineColor is null.

lineColor - the RGB line color of the rectangle.

• the lineColor will be ignored if null.

fillColor - the RGB fill color of the rectangle.

• the fillColor will be ignored if null.

See Also:

ZebraGraphics.drawRectangle(int, int, int, int, float, Color, Color)

drawRoundedRectangle

public void drawRoundedRectangle(int x,
                        int y,
                        int width,
                        int height,
                        float radius,
                        float lineThickness,
                        java.awt.Color lineColor,
                        java.awt.Color fillColor)

Description copied from interface: ZebraGraphics

Draws a round-cornered rectangle at the specified coordinates.

Specified by:

drawRoundedRectangle in interface ZebraGraphics

Parameters:

x - the x coordinate.

y - the y coordinate.

width - the width of the rectangle.

height - the height of the rectangle.

radius - the corner radius of the rectangle.

lineThickness - the line thickness of the rectangle.

• the lineThickness will be ignored if the lineColor is null.

lineColor - the RGB line color of the rectangle.

• the lineColor will be ignored if null.

fillColor - the RGB fill color of the rectangle.

• the fillColor will be ignored if null.

See Also:

ZebraGraphics.drawRoundedRectangle(int, int, int, int, float, float, Color, Color)

drawEllipse

public void drawEllipse(int x,
               int y,
               int width,
               int height,
               int lineThickness,
               java.awt.Color lineColor,
               java.awt.Color fillColor)

Description copied from interface: ZebraGraphics

Draws an ellipse at the specified coordinates

Specified by:

drawEllipse in interface ZebraGraphics

Parameters:

x - the x coordinate of the upper left corner of the ellipse.

y - the y coordinate of the upper left corner of the ellipse.

width - the width of the ellipse.

height - the height of the ellipse.

lineThickness - the line thickness of the rectangle.

• the lineThickness will be ignored if the lineColor is null.

lineColor - the RGB line color of the rectangle.

• the lineColor will be ignored if null.

fillColor - the RGB fill color of the rectangle.

• the fillColor will be ignored if null.

See Also:

ZebraGraphics.drawEllipse(int, int, int, int, int, Color, Color)

extractBlackImageData

public ExtractedImages extractBlackImageData(byte[] imageData,
                                    int redThreshold,
                                    int greenThreshold,
                                    int blueThreshold)
                                      throws IllegalArgumentException,
                                             java.io.IOException

Description copied from interface: ZebraGraphicsI

Separates the monochrome and color data from the specified image data using the specified threshold values.

Specified by:

extractBlackImageData in interface ZebraGraphicsI

Parameters:

imageData - the 24bpp bitmap color image data.

redThreshold - the red pixel threshold value.

• Range: 0 to 255

greenThreshold - the green pixel threshold value.

• Range: 0 to 255

blueThreshold - the blue pixel threshold value.

• Range: 0 to 255

Returns:

Images images instance containing the extracted color and monochrome image data.

Throws:

IllegalArgumentException - if the redThreshold, greenThreshold, or blueThreshold level is outside of the valid range.

java.io.IOException - if an error occurs while reading the image data.

See Also:

ZebraGraphicsI.extractBlackImageData(byte[], int, int, int)

extractHalfPanelImageData

public byte[] extractHalfPanelImageData(byte[] imageData)
                                 throws IllegalArgumentException,
                                        java.io.IOException

Description copied from interface: ZebraGraphicsI

Attempts to identify and extract the color and non-color half panel regions of the source image.

• ZMotif Series 7 and ZC Series printers only.
• The printer model must be set prior to calling this method.

Specified by:

extractHalfPanelImageData in interface ZebraGraphicsI

Parameters:

imageData - the 24bpp bitmap color image data.

Returns:

byte[] the extracted half panel color image data.

Throws:

IllegalArgumentException - If imageData is invalid or the printer model is not supported.

java.io.IOException - if an error occurs while reading the image data.

See Also:

ZebraGraphicsI.extractHalfPanelImageData(byte[])

imageDataToImage

public java.awt.image.BufferedImage imageDataToImage(byte[] imageData)
                                              throws IllegalArgumentException,
                                                     java.io.IOException

Description copied from interface: ZebraGraphics

Creates a BufferedImage object from the raw bitmap data.

Specified by:

imageDataToImage in interface ZebraGraphics

Parameters:

imageData - the raw bitmap data.

Returns:

BufferedImage generated from the specified image data

Throws:

IllegalArgumentException - if the imageData is invalid.

java.io.IOException - if an error occurs reading the image data.

See Also:

ZebraGraphics.imageDataToImage(byte[])

imageToImageData

public byte[] imageToImageData(java.awt.image.BufferedImage image)
                        throws IllegalArgumentException,
                               java.io.IOException

Description copied from interface: ZebraGraphics

Converts a BufferedImage into it's raw image data

Specified by:

imageToImageData in interface ZebraGraphics

Parameters:

image - the BufferedImage.

Returns:

the raw image data from the specified buffered image.

Throws:

IllegalArgumentException - if the image is invalid.

java.io.IOException - if an error occurs reading the image data.

See Also:

ZebraGraphics.imageToImageData(BufferedImage)

clone

public Object clone()
             throws CloneNotSupportedException

Overrides:

clone in class Object

Throws:

CloneNotSupportedException

See Also:

Object.clone()