org.sikuli.script

Class ScreenImage

java.lang.Object

org.sikuli.script.ScreenImage

public class ScreenImage
extends Object

stores a BufferedImage usually ceated by screen capture, the screen rectangle it was taken from and the filename, where it is stored as PNG (only if requested)

Field Summary

Fields

Modifier and Type	Field and Description
protected String	_filename
protected BufferedImage	_img
protected Rectangle	_roi
int	h x, y, w, h of the stored ROI
int	w x, y, w, h of the stored ROI
int	x x, y, w, h of the stored ROI
int	y x, y, w, h of the stored ROI

Constructor Summary

Constructors

Constructor and Description
ScreenImage(Rectangle roi, BufferedImage img) create ScreenImage with given

Method Summary

Methods

Modifier and Type	Method and Description
String	getFile() stores the image as PNG file in the standard temp folder with a created filename (sikuli-image-#unique-random#.png) if not yet stored before
String	getFile(String path) stores the image as PNG file in the given path with a created filename (sikuli-image-#unique-random#.png)
String	getFile(String path, String name) stores the image as PNG file in the given path with the given filename
String	getFilename() Deprecated. use getFile() instead
BufferedImage	getImage()
Rectangle	getROI()

Methods inherited from class java.lang.Object

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

Field Detail

x

public int x

x, y, w, h of the stored ROI

y

public int y

x, y, w, h of the stored ROI

w

public int w

x, y, w, h of the stored ROI

h

public int h

x, y, w, h of the stored ROI

_roi

protected Rectangle _roi

_img

protected BufferedImage _img

_filename

protected String _filename

Constructor Detail

ScreenImage

public ScreenImage(Rectangle roi,
           BufferedImage img)

create ScreenImage with given

Parameters:

roi - the rectangle it was taken from

img - the BufferedImage

Method Detail

getFilename

@Deprecated
public String getFilename()
                   throws IOException

Deprecated. use getFile() instead

creates the PNG tempfile only when needed.

Returns:

absolute path to stored tempfile

Throws:

IOException

getFile

public String getFile()

stores the image as PNG file in the standard temp folder with a created filename (sikuli-image-#unique-random#.png) if not yet stored before

Returns:

absolute path to stored file

Throws:

IOException

getFile

public String getFile(String path)

stores the image as PNG file in the given path with a created filename (sikuli-image-#unique-random#.png)

Parameters:

path - valid path string

Returns:

absolute path to stored file

Throws:

IOException

getFile

public String getFile(String path,
             String name)

stores the image as PNG file in the given path with the given filename

Parameters:

path - valid path string

name - filename (.png is added if not present)

Returns:

absolute path to stored file

Throws:

IOException

getImage

public BufferedImage getImage()

Returns:

the stored image in memory

getROI

public Rectangle getROI()

Returns:

the screen rectangle, the iamge was created from