clipgenerator

Class ClipControl

java.lang.Object

PamController.PamControlledUnit

clipgenerator.ClipControl

All Implemented Interfaces:

ClipDisplayParent, PamSettings

public class ClipControl
extends PamControlledUnit
implements PamSettings, ClipDisplayParent

The clip generator is used to generate short sound clips around detections. In principle, it can be triggered by just about any dataunit which is a subclass of AcousticDataUnit, i.e. one having both a start time and a duration.

The clip generator configuration contains a budget of how many clips it can make for each possible trigger and will, based on usage, decide in a semi random way whether or not to make a clip on the arrival of each detection.

Trigger specific settings also include a pre and post sample time.

Author:

Doug Gillespie

Constructor Summary

Constructors

Constructor and Description
ClipControl(java.lang.String unitName)

Method Summary

Methods

Modifier and Type	Method and Description
javax.swing.JMenuItem	createDetectionMenu(java.awt.Frame parentFrame) Create a JMenu object containing MenuItems associated with PamProcesses
javax.swing.JMenuItem	createDisplayMenu(java.awt.Frame parentFrame) Create a JMenu object containing MenuItems associated with the view
void	displayOptions(java.awt.Frame parentFrame)
void	displaySettingChange()
ClipGenSetting	findClipGenSetting(java.lang.String clipDataName) Find the clip generator settings for a specific data stream.
ClipDisplayPanel	generateNewPanel()
ClipDataBlock	getClipDataBlock()
ClipDisplayDecorations	getClipDecorations(ClipDisplayUnit clipDisplayUnit) Add additional functionality and controls to a clip display unit
ClipProcess	getClipProcess()
java.lang.String	getDisplayName() A name (though I don't think this ever gets used by current displays)
java.util.ArrayList<PamDataBlock>	getPotentialTriggers() Get a list of datablocks which might trigger a clip generation.
java.io.Serializable	getSettingsReference()
long	getSettingsVersion()
void	notifyModelChanged(int changeType) General notification when the PAMGAURD model changes.
boolean	removeUnit() Called to remove a unit.
boolean	restoreSettings(PamControlledUnitSettings pamControlledUnitSettings)

Methods inherited from class PamController.PamControlledUnit

addOfflineTaskGroup, addOtherRelatedMenuItems, addPamProcess, addRelatedMenuItems, addXMLParameter, addXMLParameter, addXMLParameter, addXMLParameter, canClose, canPlayViewerSound, createFileMenu, createHelpMenu, fillXMLElement, flushDataBlockBuffers, getFrameNumber, getGuiFrame, getModuleSummary, getNumOfflineTaskGroups, getNumPamProcesses, getOfflineTaskGroup, getPamController, getPamModuleInfo, getPamProcess, getPamView, getShortUnitType, getSidePanel, getTabClipCopier, getTabPanel, getTabSpecificMenuBar, getToolbarComponent, getUnitName, getUnitType, getVerboseLevel, gotoTab, isViewer, pamClose, pamHasStopped, pamToStart, playViewerSound, removePamProcess, rename, saveViewerData, setFrameNumber, setPamController, setPamModuleInfo, setPamView, setSidePanel, setTabPanel, setupControlledUnit, stopViewerSound, terminalPrint, terminalPrintln, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface PamController.PamSettings

getUnitName, getUnitType

Constructor Detail

ClipControl

public ClipControl(java.lang.String unitName)

Method Detail

createDetectionMenu

public javax.swing.JMenuItem createDetectionMenu(java.awt.Frame parentFrame)

Description copied from class: PamControlledUnit

Create a JMenu object containing MenuItems associated with PamProcesses

Overrides:

createDetectionMenu in class PamControlledUnit

Parameters:

parentFrame - The owner frame of the menu

Returns:

reference to a JMenu which can be added to an existing menu or menu bar

Note that if multiple views are to use the same menu, then they should each create a new menu (by setting Create to true) the first time they call this method.

createDisplayMenu

public javax.swing.JMenuItem createDisplayMenu(java.awt.Frame parentFrame)

Description copied from class: PamControlledUnit

Create a JMenu object containing MenuItems associated with the view

Overrides:

createDisplayMenu in class PamControlledUnit

Returns:

reference to a JMenu which can be added to an existing menu or menu bar

Note that if multiple views are to use the same menu, then they should each create a new menu (by setting Create to true) the first time they call this method.

displayOptions

public void displayOptions(java.awt.Frame parentFrame)

getSettingsReference

public java.io.Serializable getSettingsReference()

Specified by:

getSettingsReference in interface PamSettings

Returns:

The serialisable object that will be stored

getSettingsVersion

public long getSettingsVersion()

Specified by:

getSettingsVersion in interface PamSettings

Returns:

An integer version number for the settings

restoreSettings

public boolean restoreSettings(PamControlledUnitSettings pamControlledUnitSettings)

Specified by:

restoreSettings in interface PamSettings

Returns:

true if successful The object performs final checks (if needed) and then casts the settings data pamcontrolledunitSettings.settings into the correct type and uses as required

notifyModelChanged

public void notifyModelChanged(int changeType)

Description copied from class: PamControlledUnit

General notification when the PAMGAURD model changes.

Overrides:

notifyModelChanged in class PamControlledUnit

Parameters:

changeType - type of change

getPotentialTriggers

public java.util.ArrayList<PamDataBlock> getPotentialTriggers()

Get a list of datablocks which might trigger a clip generation.

Returns:

list of triggering data blocks.

getClipProcess

public ClipProcess getClipProcess()

Returns:

the clipProcess

generateNewPanel

public ClipDisplayPanel generateNewPanel()

removeUnit

public boolean removeUnit()

Description copied from class: PamControlledUnit

Called to remove a unit.

Overrides:

removeUnit in class PamControlledUnit

Returns:

try (not used)

getClipDataBlock

public ClipDataBlock getClipDataBlock()

Specified by:

getClipDataBlock in interface ClipDisplayParent

Returns:

the data block who's clips are to be displayed

getDisplayName

public java.lang.String getDisplayName()

Description copied from interface: ClipDisplayParent

A name (though I don't think this ever gets used by current displays)

Specified by:

getDisplayName in interface ClipDisplayParent

Returns:

display name

getClipDecorations

public ClipDisplayDecorations getClipDecorations(ClipDisplayUnit clipDisplayUnit)

Description copied from interface: ClipDisplayParent

Add additional functionality and controls to a clip display unit

Specified by:

getClipDecorations in interface ClipDisplayParent

Parameters:

clipDisplayUnit - display unit to decorate.

findClipGenSetting

public ClipGenSetting findClipGenSetting(java.lang.String clipDataName)

Find the clip generator settings for a specific data stream.

Parameters:

dataName - data name for the data block.

Returns:

clip generator settings, or null if none active.

displaySettingChange

public void displaySettingChange()

Specified by:

displaySettingChange in interface ClipDisplayParent