org.youscope.plugin.continousimaging

Interface ShortContinuousImagingJob

All Superinterfaces:

Component, ImageProducer, Job, java.rmi.Remote

public interface ShortContinuousImagingJob
extends Job, ImageProducer

Author:

Moritz Lang

Method Summary

Modifier and Type	Method and Description
java.lang.String	getCamera() Returns the name of the camera with which it is imaged.
java.lang.String[]	getCameras() Gets the cameras.
java.lang.String	getChannel() Gets the channel.
java.lang.String	getChannelGroup() Gets the channel group.
double	getExposure() Gets the exposure.
double[]	getExposures() Gets the exposures of the initialized cameras.
int	getImagingPeriod()
int	getNumImages() Returns the number of images which should be taken.
boolean	isBurstImaging() Returns if the imaging is done in burst mode.
void	setBurstImaging(boolean burst) Sets if the images are produced in burst mode.
void	setCamera(java.lang.String camera) Sets the camera with which it should be imaged.
void	setCameras(java.lang.String[] cameras) Sets the cameras with which it should be imaged.
void	setChannel(java.lang.String deviceGroup, java.lang.String channel) Sets the channel.
void	setExposure(double exposure) Sets the exposure.
void	setExposures(double[] exposures) Sets the exposures of the cameras.
void	setImageDescription(java.lang.String description) Sets a short string describing the images which are made by this job.
void	setImagingPeriod(int imagingPeriod)
void	setNumImages(int numImages) Sets the number of images which should be taken.

Methods inherited from interface org.youscope.common.job.Job

addJobListener, executeJob, initializeJob, removeJobListener, uninitializeJob

Methods inherited from interface org.youscope.common.Component

addMessageListener, getName, getPositionInformation, getUUID, removeMessageListener, setName

Methods inherited from interface org.youscope.common.image.ImageProducer

addImageListener, getImageDescription, getNumberOfImages, removeImageListener

Method Detail

setChannel

void setChannel(java.lang.String deviceGroup,
                java.lang.String channel)
         throws java.rmi.RemoteException,
                MeasurementRunningException

Sets the channel.

Parameters:

deviceGroup - The device group where the channel is defined.

channel - The channel.

Throws:

java.rmi.RemoteException

MeasurementRunningException

getChannel

java.lang.String getChannel()
                     throws java.rmi.RemoteException

Gets the channel.

Returns:

The channel.

Throws:

java.rmi.RemoteException

getChannelGroup

java.lang.String getChannelGroup()
                          throws java.rmi.RemoteException

Gets the channel group.

Returns:

The channel group.

Throws:

java.rmi.RemoteException

setExposure

void setExposure(double exposure)
          throws java.rmi.RemoteException,
                 MeasurementRunningException

Sets the exposure. If more than one camera is initialized, it sets the exposure of all cameras. Set to -1 if exposure should not be set.

Parameters:

exposure - The exposure.

Throws:

java.rmi.RemoteException

MeasurementRunningException

getExposure

double getExposure()
            throws java.rmi.RemoteException

Gets the exposure. If more than one camera is initialized, returns the exposure of the first camera.

Returns:

The exposure.

Throws:

java.rmi.RemoteException

setExposures

void setExposures(double[] exposures)
           throws java.rmi.RemoteException,
                  MeasurementRunningException,
                  java.lang.IllegalArgumentException

Sets the exposures of the cameras. Should have the same size as cameras, otherwise an exception is thrown. Each element can be set to -1 to not set the exposure for the given camera.

Parameters:

exposures - The exposures.

Throws:

java.rmi.RemoteException

MeasurementRunningException

java.lang.IllegalArgumentException - Thrown if number of elements in exposure array is unequal to the number of cameras.

getExposures

double[] getExposures()
               throws java.rmi.RemoteException

Gets the exposures of the initialized cameras.

Returns:

The exposures.

Throws:

java.rmi.RemoteException

setCameras

void setCameras(java.lang.String[] cameras)
         throws java.rmi.RemoteException,
                MeasurementRunningException

Sets the cameras with which it should be imaged. If set to null, the default (currently initialized) camera is used. Each camera should only appear ones in the array. One element of the array can be NULL, such that the default camera is used.

Parameters:

cameras - Device names of the cameras

Throws:

java.rmi.RemoteException

MeasurementRunningException

setCamera

void setCamera(java.lang.String camera)
        throws java.rmi.RemoteException,
               MeasurementRunningException

Sets the camera with which it should be imaged. If set to null, the default (currently initialized) camera is used.

Parameters:

camera - Device name of the camera, or null to use default camera.

Throws:

java.rmi.RemoteException

MeasurementRunningException

getCameras

java.lang.String[] getCameras()
                       throws java.rmi.RemoteException

Gets the cameras.

Returns:

The cameras.

Throws:

java.rmi.RemoteException

getCamera

java.lang.String getCamera()
                    throws java.rmi.RemoteException

Returns the name of the camera with which it is imaged. Might return null if the default camera is used. If more than one camera is used, returns the first camera.

Returns:

The cameras.

Throws:

java.rmi.RemoteException

isBurstImaging

boolean isBurstImaging()
                throws java.rmi.RemoteException

Returns if the imaging is done in burst mode. This corresponds to that the job queries for all images in the image buffer, not only for the newest one, every time it is executed.

Returns:

True if in burst mode, false otherwise.

Throws:

java.rmi.RemoteException

setBurstImaging

void setBurstImaging(boolean burst)
              throws java.rmi.RemoteException,
                     MeasurementRunningException

Sets if the images are produced in burst mode. This corresponds to that the job queries for all images in the image buffer, not only for the newest one, every time it is executed. Default is false.

Parameters:

burst - True if burst imaging should be activated, false if not.

Throws:

java.rmi.RemoteException

MeasurementRunningException

setImageDescription

void setImageDescription(java.lang.String description)
                  throws java.rmi.RemoteException,
                         MeasurementRunningException

Sets a short string describing the images which are made by this job.

Parameters:

description - The description which should be returned for the images produced by this job, or null, to switch to the default description.

Throws:

java.rmi.RemoteException

MeasurementRunningException

setImagingPeriod

void setImagingPeriod(int imagingPeriod)
               throws java.rmi.RemoteException,
                      MeasurementRunningException

Parameters:

imagingPeriod - The time between two successive images.

Throws:

java.rmi.RemoteException

MeasurementRunningException

getImagingPeriod

int getImagingPeriod()
              throws java.rmi.RemoteException

Returns:

The time between two successive images.

Throws:

java.rmi.RemoteException

setNumImages

void setNumImages(int numImages)
           throws java.rmi.RemoteException,
                  MeasurementRunningException

Sets the number of images which should be taken.

Parameters:

numImages - Number of images to be taken.

Throws:

java.rmi.RemoteException

MeasurementRunningException

getNumImages

int getNumImages()
          throws java.rmi.RemoteException

Returns the number of images which should be taken.

Returns:

numImages Number of images to be taken.

Throws:

java.rmi.RemoteException