fr.emn.reactiveinput.devices
Class DInputRecorder

java.lang.Object
  extended byfr.emn.reactiveinput.AbstractDevice
      extended byfr.emn.reactiveinput.AbstractMutableDevice
          extended byfr.emn.reactiveinput.devices.DInputRecorder
All Implemented Interfaces:
Device, MutableDevice, Processor, RecordCacheListener

public class DInputRecorder
extends AbstractMutableDevice
implements RecordCacheListener

Titre :

Description :

Copyright : Copyright (c) 2002

Société :

Version:
1.0
Author:
non attribuable

Field Summary
protected  SlotDefinition[] definitions
           
protected  java.util.LinkedList events
           
protected  java.io.File file
           
protected  java.lang.String[] inNames
           
 In[] ins
           
 int MAX_SLOTS
           
 int MIN_SLOTS
           
protected  java.lang.String[] outNames
           
 Out[] outs
           
protected  SlotEvent[] tickEvents
           
 
Fields inherited from class fr.emn.reactiveinput.AbstractDevice
currIndex
 
Fields inherited from interface fr.emn.reactiveinput.Device
AUTO_PROPERTIES
 
Constructor Summary
DInputRecorder()
           
 
Method Summary
protected  void addSlots(int num, boolean dynamic)
           
 void cacheUpdated(java.lang.Object k)
           
 void close()
          Closes the device.
 java.io.File getFile()
           
 java.lang.String[] getInNames()
           
 Slot[] getMutationTriggers()
          Returns the mutation triggers for this mutable device, i.e. all input or output slots that trigger a mutation when it is connected to another type.
 int getNumSlots()
           
 java.lang.String[] getOutNames()
           
 boolean getRecordWhenSignal()
           
 boolean hasExternalOutput()
          Specifies whether this device has external (implicit) output or not.
 void init()
          Initializes device's output values.
 boolean isOpenable()
          This device has only optional slots (which allows "holes"), but is not considered openable if nothing is connected.
 boolean isReadyForCache()
           
 void mutate()
          Performs a mutation on this device.
 Processor open(OpenContext context)
          Ensures that the device will be ready for processing or producing data, and returns the Processor object that will process data, or null if an error occured.
protected  void removeSlots(int num)
           
 void reset()
           
 void save()
           
 void setFile(java.io.File f)
           
 void setInNames(java.lang.String[] _inNames)
           
 void setNumSlots(int num)
           
 void setOutNames(java.lang.String[] _outNames)
           
 void setRecordWhenSignal(boolean b)
           
 void update()
          Updates device's output values.
 
Methods inherited from class fr.emn.reactiveinput.AbstractMutableDevice
addMutableIn, addMutableIn, addMutableIn, addMutableOut, addMutableOut, remove
 
Methods inherited from class fr.emn.reactiveinput.AbstractDevice
addIn, addIn, addOut, copy, doDisable, doEnable, finalize, getError, getIndex, getInfo, getIns, getName, getOuts, getProperties, hasExternalInput, insertAt, insertAtEnd, insertBefore, isCopiable, isEnabled, setEnabled, setInfo, setInfo, setLastError, setName
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface fr.emn.reactiveinput.Device
copy, getError, getInfo, getIns, getName, getOuts, getProperties, hasExternalInput, isCopiable, setEnabled
 

Field Detail

MIN_SLOTS

public final int MIN_SLOTS
See Also:
Constant Field Values

MAX_SLOTS

public final int MAX_SLOTS
See Also:
Constant Field Values

ins

public final In[] ins

outs

public final Out[] outs

definitions

protected SlotDefinition[] definitions

tickEvents

protected SlotEvent[] tickEvents

events

protected java.util.LinkedList events

file

protected java.io.File file

inNames

protected java.lang.String[] inNames

outNames

protected java.lang.String[] outNames
Constructor Detail

DInputRecorder

public DInputRecorder()
Method Detail

isReadyForCache

public boolean isReadyForCache()
Specified by:
isReadyForCache in interface RecordCacheListener

cacheUpdated

public void cacheUpdated(java.lang.Object k)
Specified by:
cacheUpdated in interface RecordCacheListener

getRecordWhenSignal

public boolean getRecordWhenSignal()

setRecordWhenSignal

public void setRecordWhenSignal(boolean b)

getFile

public java.io.File getFile()

setFile

public void setFile(java.io.File f)

addSlots

protected void addSlots(int num,
                        boolean dynamic)

getMutationTriggers

public Slot[] getMutationTriggers()
Description copied from class: AbstractMutableDevice
Returns the mutation triggers for this mutable device, i.e. all input or output slots that trigger a mutation when it is connected to another type.

Specified by:
getMutationTriggers in interface MutableDevice
Specified by:
getMutationTriggers in class AbstractMutableDevice

getNumSlots

public int getNumSlots()

hasExternalOutput

public boolean hasExternalOutput()
Description copied from interface: Device
Specifies whether this device has external (implicit) output or not.

Return false if the device has no border effects. Most of input and processing devices are in this case.

Return true if the device has border effects, such as graphical feedback, or control of some external value. Examples of devices with external output are application-interfacing devices and all user feedback devices.

This method can be used by the editor for the device's graphical representation. However this makes no difference for the reactive machine.

Specified by:
hasExternalOutput in interface Device
Overrides:
hasExternalOutput in class AbstractDevice

isOpenable

public boolean isOpenable()
This device has only optional slots (which allows "holes"), but is not considered openable if nothing is connected.

Specified by:
isOpenable in interface Device
Overrides:
isOpenable in class AbstractDevice

mutate

public void mutate()
Performs a mutation on this device. This method is called when a connection is made (or deleted) on a mutation trigger.

DInputRecorder creates a new slot if the last slot has been connected, or removes it if it has been disconnected.

Specified by:
mutate in interface MutableDevice
Specified by:
mutate in class AbstractMutableDevice

open

public Processor open(OpenContext context)
Description copied from interface: Device
Ensures that the device will be ready for processing or producing data, and returns the Processor object that will process data, or null if an error occured.

Some devices may need to perform some more or less heavy initialization (such as allocating resources or opening a stream) before being able to process or produce data. This is the case for most input devices, and some I/O and output devices. All these initializations must be done in the open() method.

Because these initializations are subject to fail, open() may return null even if isOpenable() returns true. In all cases, returning a non-null Processor means that the device is now able to process or produce data.

RE-OPENING A DEVICE:

Devices always stay open during reconfiguration, in order to avoid unnecessary deallocation and reallocation of resources. However, some devices will need to be re-open before re-starting the configuration. So open() is always called on all devices before re-starting.

If open() is called on a device that is already open, it may have no effect (and the current Processor is returned), or the device may be re-open if something has changed in its configuration.

Using a Processor as a return value allows the use of different processors, each adapted to a specific device configuration.

Specified by:
open in interface Device
Overrides:
open in class AbstractDevice
See Also:
Processor, Device.open()

close

public void close()
Description copied from interface: Device
Closes the device. Called when the device is not used any more.

Deallocate resources here.

Specified by:
close in interface Device
Overrides:
close in class AbstractDevice

removeSlots

protected void removeSlots(int num)

setNumSlots

public void setNumSlots(int num)

reset

public void reset()

save

public void save()

init

public void init()
Description copied from class: AbstractDevice
Initializes device's output values.

Subclass init() and update() methods if you want the device to process the data itself. Otherwise, subclass getProcessor() method to use extern processors. By default, this method calls update(). Subclass this method if you'd like to make a specific initialization routine.

Specified by:
init in interface Processor
Overrides:
init in class AbstractDevice
See Also:
Processor.init()

update

public void update()
Description copied from class: AbstractDevice
Updates device's output values.

Subclass init() and update() methods if you want the device to process the data itself. Otherwise, subclass getProcessor() method to use extern processors.

Specified by:
update in interface Processor
Overrides:
update in class AbstractDevice
See Also:
Processor.update()

getInNames

public java.lang.String[] getInNames()

setInNames

public void setInNames(java.lang.String[] _inNames)

getOutNames

public java.lang.String[] getOutNames()

setOutNames

public void setOutNames(java.lang.String[] _outNames)