org.lsst.ccs.drivers.reb

Class ImageClient

java.lang.Object

org.lsst.ccs.drivers.reb.ImageClient

public class ImageClient
extends Object

Java interface to the image client routines

Author:

Owen Saxton

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ImageClient.Listener Defines the data listener.
class	ImageClient.ReadThread Thread that obtains the image data for the listener.

Constructor Summary

Constructors

Constructor and Description
ImageClient()

Method Summary

Modifier and Type	Method and Description
Image	awaitImage(Image image) Awaits an image.
void	clearListener() Clears the data listener.
void	close() Closes a connection.
static void	deleteImageMetadataRef(Image image) Deletes an image's metadata reference.
protected void	finalize() Finalizer.
void	open(int id) Opens a connection using the default network interface.
void	open(int id, String ifc) Opens a connection using the specified network interface.
boolean	readImage(Image image) Reads an image.
void	resetFrontEnd() Resets the front end system.
void	setListener(ImageClient.Listener listener, Image image) Sets the data listener.

Methods inherited from class java.lang.Object

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

Constructor Detail

ImageClient

public ImageClient()

Method Detail

finalize

protected void finalize()
                 throws Throwable

Finalizer.

Overrides:

finalize in class Object

Throws:

Throwable

open

public void open(int id)
          throws REBException

Opens a connection using the default network interface.

Parameters:

id - The ID of the REB to connect to

Throws:

REBException

open

public void open(int id,
                 String ifc)
          throws REBException

Opens a connection using the specified network interface.

Parameters:

id - The ID of the REB to connect to

ifc - The name of the network interface to use. If null or empty, the default interface is used.

Throws:

REBException

close

public void close()
           throws REBException

Closes a connection.

Throws:

REBException

awaitImage

public Image awaitImage(Image image)
                 throws REBException

Awaits an image. Waits until a new image has been generated.

Parameters:

image - An Image object in which to save the reference and metadata for the new image, or null if a new image object is to be created.

Returns:

The Image object containing the new image reference and metadata.

Throws:

REBException

readImage

public boolean readImage(Image image)
                  throws REBException

Reads an image. Gets the pixel data for an image.

Parameters:

image - The Image object containing the valid metadata for an image. If the contained pixel data byte array is not null and is large enough, the pixel data us stored there. Otherwise a new array is created.

Returns:

True if the pixel data was successfully read, false otherwise.

Throws:

REBException

deleteImageMetadataRef

public static void deleteImageMetadataRef(Image image)

Deletes an image's metadata reference. Deletes referenced C++ object.

Parameters:

image - The image whose metadata reference is to be deleted.

resetFrontEnd

public void resetFrontEnd()
                   throws REBException

Resets the front end system.

Throws:

REBException

setListener

public void setListener(ImageClient.Listener listener,
                        Image image)

Sets the data listener. Sets the data listener object, whose class must implement the Listener interface, and therefore must contain the processImage method. This method is called with a complete Image object as its argument whenever a new image becomes available.

Parameters:

listener - The listener object to be set as the listener. Any existing listener is replaced.

image - An image object to be used to contain received images, or null if a new object is to be created each time.

clearListener

public void clearListener()

Clears the data listener. Clears the data listener object if it exists.