com.ingenico.sdk.customerscreen

Interface IImageDisplay

All Superinterfaces:

IIngenicoApi

All Known Implementing Classes:

ImageDisplay

public interface IImageDisplay
extends IIngenicoApi

Image Display Service Interface.

Usage example to display an image from a bitmap:

IImageDisplay imageDisplay = ImageDisplay.getInstance(context);

//Open imageDisplay session
ImageDisplayResult displayResult = imageDisplay.openSession();

//Get Bitmap with 320x240 resolution and size less than 64ko
Bitmap image = getBitmap();

//Post image bitmap to tetra screen
displayResult = imageDisplay.postImage(image);

//Close imageDisplay session
displayResult = imageDisplay.closeSession();

Usage example to generate and display an image:

String text = "Hello World Line 1\nHello World Line 2\nHello World Line 3";
int width = 320;
int height = 240;

IImageDisplay imageDisplay = ImageDisplay.getInstance(context);

// Open imageDisplay session
ImageDisplayResult displayResult = imageDisplay.openSession();

// Clear tetra screen
displayResult = imageDisplay.clear();

// New Bitmap with 320x240 resolution and size less than 64ko
Bitmap image = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);

Canvas canvas = new Canvas(image);
// New antialised Paint
Paint paint = new Paint(Paint.ANTI_ALIAS_FLAG);
// Text shadow GRAY Color
paint.setShadowLayer(1f, 0f, 1f, Color.DKGRAY);

// Draw a multiple lines string
int x = 0, y, sizeOff = 25, yOff = 50;
String[] lines = text.split("\n");
int[] colors = new int[lines.length];
int[] sizes = new int[lines.length];
Typeface[] typefaces = new Typeface[lines.length];

int[][] colorsRGB = new int[lines.length][3];
for (int i = 0; i < lines.length; ++i) {
    for (int j = 0; j < 3; ++j) {
        colorsRGB[i][j] = (int) Math.floor(Math.random() * 256);
    }
}

for (int i = 0; i < lines.length; ++i) {
    colors[i] = Color.rgb(colorsRGB[i][0], colorsRGB[i][1], colorsRGB[i][2]);
    sizes[i] = sizeOff;
    //NORMAL = 0; BOLD = 1; ITALIC = 2;
    typefaces[i] = Typeface.defaultFromStyle(i);

    sizeOff += 5;
}

Rect rect = new Rect();
y = yOff;
for (int i = 0; i < lines.length; ++i) {
    // Text color
    paint.setColor(colors[i]);
    // Text size in pixels
    paint.setTextSize(sizes[i]);
    // Text style
    paint.setTypeface(typefaces[i]);

    canvas.drawText(lines[i], x, y, paint);
    paint.getTextBounds(lines[i], 0, lines[i].length(), rect);
    y = y + rect.height() + 15; // Space between lines is 15
}

//Post image bitmap to tetra screen
displayResult = imageDisplay.postImage(image);

//Close imageDisplay session
displayResult = imageDisplay.closeSession();

Method Summary

Modifier and Type	Method and Description
ImageDisplayResult	clear() Clear the screen by using a white image.
ImageDisplayResult	closeSession() Close image display session.
ImageDisplayResult	openSession() Open image display session.
ImageDisplayResult	postImage(android.graphics.Bitmap image) Send the bitmap to the customer screen.

Methods inherited from interface com.ingenico.sdk.IIngenicoApi

connect, disconnect, isConnected

Method Detail

openSession

ImageDisplayResult openSession()
                        throws IngenicoException

Open image display session.

Throws:

IngenicoException - when session opening fails

closeSession

ImageDisplayResult closeSession()
                         throws IngenicoException

Close image display session.

Throws:

IngenicoException - when the session closing fails

clear

ImageDisplayResult clear()
                  throws IngenicoException

Clear the screen by using a white image.

Throws:

IngenicoException - when clearing the screen fails

postImage

ImageDisplayResult postImage(android.graphics.Bitmap image)
                      throws IngenicoException

Send the bitmap to the customer screen.

Parameters:

image - bitmap object to send

Throws:

IngenicoException - when the image display fails