com.zebra.sdk.printer

Interface GraphicsUtil

All Known Subinterfaces:

ZebraPrinter, ZebraPrinterLinkOs

All Known Implementing Classes:

Profile

public interface GraphicsUtil

This is an utility class for printing images on a device.

package test.zebra.sdk.printer.examples;
 
 import java.io.IOException;
 
 import com.zebra.sdk.comm.Connection;
 import com.zebra.sdk.comm.ConnectionException;
 import com.zebra.sdk.comm.TcpConnection;
 import com.zebra.sdk.printer.ZebraPrinter;
 import com.zebra.sdk.printer.ZebraPrinterFactory;
 import com.zebra.sdk.printer.ZebraPrinterLanguageUnknownException;
 
 public class GraphicsUtilExample {
 
     public static void main(String[] args) throws Exception {
         Connection connection = new TcpConnection("192.168.1.32", TcpConnection.DEFAULT_ZPL_TCP_PORT);
         try {
             connection.open();
             ZebraPrinter printer = ZebraPrinterFactory.getInstance(connection);
             int x = 0;
             int y = 0;
             printer.printImage("/sdcard/sample.jpg", x, y);
         } catch (ConnectionException e) {
             e.printStackTrace();
         } catch (ZebraPrinterLanguageUnknownException e) {
             e.printStackTrace();
         } catch (IOException e) {
             e.printStackTrace();
         } finally {
             connection.close();
         }
     }
 
 }
 

Method Summary

Methods

Modifier and Type	Method and Description
void	printImage(String imageFilePath, int x, int y) Prints an image from the connecting device file system to the connected device as a monochrome image.
void	printImage(String imageFilePath, int x, int y, int width, int height, boolean insideFormat) Prints an image from the connecting device file system to the connected device as a monochrome image.
void	printImage(ZebraImageI image, int x, int y, int width, int height, boolean insideFormat) Prints an image to the connected device as a monochrome image.
void	storeImage(String deviceDriveAndFileName, String imageFullPath, int width, int height) Stores the specified image to the connected printer as a monochrome image.
void	storeImage(String deviceDriveAndFileName, ZebraImageI image, int width, int height) Stores the specified image to the connected printer as a monochrome image.

Method Detail

printImage

void printImage(String imageFilePath,
              int x,
              int y)
                throws ConnectionException,
                       java.io.IOException

Prints an image from the connecting device file system to the connected device as a monochrome image.
Note: if the image resolution is large (e.g. 1024x768) this method may take a long time to execute or throw an OutOfMemoryError exception.

Parameters:

imageFilePath - image file to be printed.

x - horizontal starting position in dots.

y - vertical starting position in dots.

Throws:

ConnectionException - if an I/O error occurs.

java.io.IOException - when the file could not be found, opened, or is an unsupported graphic

printImage

void printImage(String imageFilePath,
              int x,
              int y,
              int width,
              int height,
              boolean insideFormat)
                throws ConnectionException,
                       java.io.IOException

Prints an image from the connecting device file system to the connected device as a monochrome image.
Note: if the image resolution is large (e.g. 1024x768) this method may take a long time to execute or throw an OutOfMemoryError exception.

Parameters:

imageFilePath - image file to be printed.

x - horizontal starting position in dots.

y - vertical starting position in dots.

width - desired width of the printed image. Passing a value less than 1 will preserve original width.

height - desired height of the printed image. Passing a value less than 1 will preserve original height.

insideFormat - boolean value indicating whether this image should be printed by itself (false), or is part of a format being written to the connection (true).

Throws:

ConnectionException - if an I/O error occurs.

java.io.IOException - when the file could not be found, opened, or is an unsupported graphic

printImage

void printImage(ZebraImageI image,
              int x,
              int y,
              int width,
              int height,
              boolean insideFormat)
                throws ConnectionException

Prints an image to the connected device as a monochrome image.
Note: if the image resolution is large (e.g. 1024x768) this method may take a long time to execute or throw an OutOfMemoryError exception.

Parameters:

image - the image to be printed.

x - horizontal starting position in dots.

y - vertical starting position in dots.

width - desired width of the printed image. Passing a value less than 1 will preserve original width.

height - desired height of the printed image. Passing a value less than 1 will preserve original height.

insideFormat - boolean value indicating whether this image should be printed by itself (false), or is part of a format being written to the connection (true).

Throws:

ConnectionException - if an I/O error occurs.

storeImage

void storeImage(String deviceDriveAndFileName,
              ZebraImageI image,
              int width,
              int height)
                throws ConnectionException,
                       ZebraIllegalArgumentException

Stores the specified image to the connected printer as a monochrome image. The image will be stored on the printer at printerDriveAndFileName with the extension GRF. If a drive letter is not supplied, E will be used as the default (e.g. FILE becomes E:FILE.GRF). If an extension is supplied, it is ignored if it is not either BMP or PNG. If the extension is ignored, GRF will be used. If the image resolution is large (e.g. 1024x768) this method may take a long time to execute or throw an OutOfMemoryError exception.

Parameters:

deviceDriveAndFileName - path on the printer where the image will be stored.

image - the image to be stored on the printer.

width - desired width of the printed image, in dots. Passing -1 will preserve original width.

height - desired height of the printed image, in dots. Passing -1 will preserve original height.

Throws:

ConnectionException - if there is an issue communicating with the printer (e.g. the connection is not open).

ZebraIllegalArgumentException - if printerDriveAndFileName has an incorrect format.

storeImage

void storeImage(String deviceDriveAndFileName,
              String imageFullPath,
              int width,
              int height)
                throws ConnectionException,
                       ZebraIllegalArgumentException,
                       java.io.IOException

Stores the specified image to the connected printer as a monochrome image. The image will be stored on the printer at printerDriveAndFileName with the extension GRF. If a drive letter is not supplied, E will be used as the default (e.g. FILE becomes E:FILE.GRF). If an extension is supplied, it is ignored if it is not either BMP or PNG. If the extension is ignored, GRF will be used. If the image resolution is large (e.g. 1024x768) this method may take a long time to execute or throw an OutOfMemoryError exception.

Parameters:

deviceDriveAndFileName - path on the printer where the image will be stored.

imageFullPath - image file to be stored on the printer.

width - desired width of the printed image, in dots. Passing -1 will preserve original width.

height - desired height of the printed image, in dots. Passing -1 will preserve original height.

Throws:

ConnectionException - if there is an issue communicating with the printer (e.g. the connection is not open).

ZebraIllegalArgumentException - if printerDriveAndFileName has an incorrect format.

java.io.IOException - when the file could not be found, opened, or is an unsupported graphic