ImageLayer Class Reference

#include <ImageLayer.h>

Inherits Layer.

Inheritance diagram for ImageLayer:

[legend]Collaboration diagram for ImageLayer:

Detailed Description

Definition at line 33 of file ImageLayer.h.

Public Types

enum VerticalPosition { PositionTop, PositionMiddle, PositionBottom }

enum SnapType { SnapLeft, SnapRight, SnapNearest, SnapNeighbouring }

enum ColourSignificance {
  ColourAbsent, ColourIrrelevant, ColourDistinguishes, ColourAndBackgroundSignificant,
  ColourHasMeaningfulValue
}

enum PropertyType {
  ToggleProperty, RangeProperty, ValueProperty, ColourProperty,
  UnitsProperty, InvalidProperty
}

typedef QString PropertyName

typedef std::vector< PropertyName > PropertyList

Public Slots

void showLayer (View *, bool show)

virtual void setProperty (const PropertyName &, int value)

Set a property.

virtual void setProperty (QString nameString, QString valueString)

Set a property using a fuzzy match.

virtual void setPropertyWithCommand (const PropertyName &, int value)

Set a property using a command, supporting undo and redo.

virtual void setPropertyWithCommand (QString nameString, QString valueString)

As above, but using a command.

Signals

void modelChanged ()

void modelChanged (size_t startFrame, size_t endFrame)

void modelCompletionChanged ()

void modelAlignmentCompletionChanged ()

void modelReplaced ()

void layerParametersChanged ()

void layerParameterRangesChanged ()

void layerMeasurementRectsChanged ()

void layerNameChanged ()

void verticalZoomChanged ()

void propertyChanged (PropertyContainer::PropertyName)

Public Member Functions

ImageLayer ()

virtual ~ImageLayer ()

virtual void paint (View *v, QPainter &paint, QRect rect) const

virtual QString getFeatureDescription (View *v, QPoint &) const

virtual bool snapToFeatureFrame (View *v, int &frame, size_t &resolution, SnapType snap) const

!! too much overlap with TimeValueLayer/TimeInstantLayer/TextLayer

virtual void drawStart (View *v, QMouseEvent *)

virtual void drawDrag (View *v, QMouseEvent *)

virtual void drawEnd (View *v, QMouseEvent *)

virtual void editStart (View *v, QMouseEvent *)

virtual void editDrag (View *v, QMouseEvent *)

virtual void editEnd (View *v, QMouseEvent *)

virtual void moveSelection (Selection s, size_t newStartFrame)

virtual void resizeSelection (Selection s, Selection newSize)

virtual void deleteSelection (Selection s)

virtual void copy (View *v, Selection s, Clipboard &to)

virtual bool paste (View *v, const Clipboard &from, int frameOffset, bool interactive)

Paste from the given clipboard onto the layer at the given frame offset.

virtual bool editOpen (View *, QMouseEvent *)

Open an editor on the item under the mouse (e.g.

virtual const Model * getModel () const

void setModel (ImageModel *model)

virtual PropertyList getProperties () const

Get a list of the names of all the supported properties on this container.

virtual QString getPropertyLabel (const PropertyName &) const

virtual PropertyType getPropertyType (const PropertyName &) const

virtual int getPropertyRangeAndValue (const PropertyName &, int *min, int *max, int *deflt) const

virtual QString getPropertyValueLabel (const PropertyName &, int value) const

virtual void setProperty (const PropertyName &, int value)

virtual ColourSignificance getLayerColourSignificance () const

This should return the degree of meaning associated with colour in this layer.

virtual bool isLayerScrollable (const View *v) const

This should return true if the layer can safely be scrolled automatically by a given view (simply copying the existing data and then refreshing the exposed area) without altering its meaning.

virtual bool isLayerEditable () const

This should return true if the layer can be edited by the user.

virtual int getCompletion (View *) const

Return the proportion of background work complete in drawing this view, as a percentage -- in most cases this will be the value returned by pointer from a call to the underlying model's isReady(int *) call.

virtual bool getValueExtents (float &min, float &max, bool &logarithmic, QString &unit) const

Return the minimum and maximum values for the y axis of the model in this layer, as well as whether the layer is configured to use a logarithmic y axis display.

virtual void toXml (QTextStream &stream, QString indent="", QString extraAttributes="") const

Convert the layer's data (though not those of the model it refers to) into XML for file output.

virtual void setLayerDormant (const View *v, bool dormant)

Indicate that a layer is not currently visible in the given view and is not expected to become visible in the near future (for example because the user has explicitly removed or hidden it).

void setProperties (const QXmlAttributes &attributes)

Set the particular properties of a layer (those specific to the subclass) from a set of XML attributes.

virtual bool addImage (long frame, QString url)

virtual Model * getModel ()

virtual const ZoomConstraint * getZoomConstraint () const

Return a zoom constraint object defining the supported zoom levels for this layer.

virtual bool supportsOtherZoomLevels () const

Return true if this layer can handle zoom levels other than those supported by its zoom constraint (presumably less efficiently or accurately than the officially supported zoom levels).

virtual VerticalPosition getPreferredTimeRulerPosition () const

virtual VerticalPosition getPreferredFrameCountPosition () const

virtual bool hasLightBackground () const

virtual QString getPropertyContainerIconName () const

virtual QString getPropertyContainerName () const

virtual void setPresentationName (QString name)

virtual QString getLayerPresentationName () const

virtual QPixmap getLayerPresentationPixmap (QSize) const

virtual int getVerticalScaleWidth (View *, QPainter &) const

virtual void paintVerticalScale (View *, QPainter &, QRect) const

virtual bool getCrosshairExtents (View *, QPainter &, QPoint, std::vector< QRect > &) const

virtual void paintCrosshairs (View *, QPainter &, QPoint) const

virtual void paintMeasurementRects (View *, QPainter &, bool showFocus, QPoint focusPoint) const

virtual bool nearestMeasurementRectChanged (View *, QPoint prev, QPoint now) const

virtual void eraseStart (View *, QMouseEvent *)

virtual void eraseDrag (View *, QMouseEvent *)

virtual void eraseEnd (View *, QMouseEvent *)

virtual void measureStart (View *, QMouseEvent *)

virtual void measureDrag (View *, QMouseEvent *)

virtual void measureEnd (View *, QMouseEvent *)

virtual void measureDoubleClick (View *, QMouseEvent *)

virtual bool haveCurrentMeasureRect () const

virtual void deleteCurrentMeasureRect ()

virtual bool isLayerOpaque () const

This should return true if the layer completely obscures any underlying layers.

virtual void setObjectName (const QString &name)

virtual void toBriefXml (QTextStream &stream, QString indent="", QString extraAttributes="") const

Produce XML containing the layer's ID and type.

virtual void addMeasurementRect (const QXmlAttributes &)

Add a measurement rectangle from the given XML attributes (presumably taken from a measurement element).

virtual bool isLayerDormant (const View *v) const

Return whether the layer is dormant (i.e.

virtual PlayParameters * getPlayParameters ()

virtual bool needsTextLabelHeight () const

virtual bool hasTimeXAxis () const

virtual bool getDisplayExtents (float &, float &) const

Return the minimum and maximum values within the displayed range for the y axis, if only a subset of the whole range of the model (returned by getValueExtents) is being displayed.

virtual bool setDisplayExtents (float, float)

Set the displayed minimum and maximum values for the y axis to the given range, if supported.

virtual bool getXScaleValue (const View *v, int x, float &value, QString &unit) const

Return the value and unit at the given x coordinate in the given view.

virtual bool getYScaleValue (const View *, int, float &, QString &) const

Return the value and unit at the given y coordinate in the given view.

virtual bool getYScaleDifference (const View *v, int y0, int y1, float &diff, QString &unit) const

Return the difference between the values at the given y coordinates in the given view, and the unit of the difference.

virtual int getVerticalZoomSteps (int &) const

Get the number of vertical zoom steps available for this layer.

virtual int getCurrentVerticalZoomStep () const

Get the current vertical zoom step.

virtual void setVerticalZoomStep (int)

Set the vertical zoom step.

virtual RangeMapper * getNewVerticalZoomRangeMapper () const

Create and return a range mapper for vertical zoom step values.

virtual QString getPropertyLabel (const PropertyName &) const =0

Return the human-readable (and i18n'ised) name of a property.

virtual PropertyType getPropertyType (const PropertyName &) const

Return the type of the given property, or InvalidProperty if the property is not supported on this container.

virtual QString getPropertyIconName (const PropertyName &) const

Return an icon for the property, if any.

virtual QString getPropertyGroupName (const PropertyName &) const

If this property has something in common with other properties on this container, return a name that can be used to group them (in order to save screen space, for example).

virtual int getPropertyRangeAndValue (const PropertyName &, int *min, int *max, int *deflt) const

Return the minimum and maximum values for the given property and its current value in this container.

virtual QString getPropertyValueLabel (const PropertyName &, int value) const

If the given property is a ValueProperty, return the display label to be used for the given value for that property.

virtual RangeMapper * getNewPropertyRangeMapper (const PropertyName &) const

If the given property is a RangeProperty, return a new RangeMapper object mapping its integer range onto an underlying floating point value range for human-intelligible display, if appropriate.

virtual QString toXmlString (QString indent="", QString extraAttributes="") const

Convert this exportable object to XML in a string.

Static Public Member Functions

static QString encodeEntities (QString)

static QString encodeColour (QColor)

static int getObjectExportId (const void *)

Protected Types

typedef std::map< QString,
QImage > ImageMap

!! how to reap no-longer-used images?

typedef std::map< const View *,
ImageMap > ViewImageMap

typedef std::map< QString,
FileSource * > FileSourceMap

typedef std::set< MeasureRect > MeasureRectSet

Protected Slots

void checkAddRemotes ()

void remoteFileReady ()

Protected Member Functions

ImageModel::PointList getLocalPoints (View *v, int x, int y) const

bool getImageOriginalSize (QString name, QSize &size) const

!! how to reap no-longer-used images?

QImage getImage (View *v, QString name, QSize maxSize) const

void drawImage (View *v, QPainter &paint, const ImageModel::Point &p, int x, int nx) const

QString getLocalFilename (QString img) const

void checkAddRemote (QString img) const

void connectSignals (const Model *)

virtual size_t alignToReference (View *v, size_t frame) const

virtual size_t alignFromReference (View *v, size_t frame) const

bool clipboardHasDifferentAlignment (View *v, const Clipboard &clip) const

void addMeasureRectToSet (const MeasureRect &r)

void deleteMeasureRectFromSet (const MeasureRect &r)

void updateMeasurePixrects (View *v) const

virtual void updateMeasureRectYCoords (View *v, const MeasureRect &r) const

virtual void setMeasureRectYCoord (View *v, MeasureRect &r, bool start, int y) const

virtual void setMeasureRectFromPixrect (View *v, MeasureRect &r, QRect pixrect) const

MeasureRectSet::const_iterator findFocusedMeasureRect (QPoint) const

void paintMeasurementRect (View *v, QPainter &paint, const MeasureRect &r, bool focus) const

virtual bool convertPropertyStrings (QString nameString, QString valueString, PropertyName &name, int &value)

Protected Attributes

ViewImageMap m_scaled

FileSourceMap m_remoteFiles

ImageModel * m_model

bool m_editing

QPoint m_editOrigin

ImageModel::Point m_originalPoint

ImageModel::Point m_editingPoint

ImageModel::EditCommand * m_editingCommand

MeasureRectSet m_measureRects

MeasureRect m_draggingRect

bool m_haveDraggingRect

bool m_haveCurrentMeasureRect

QPoint m_currentMeasureRectPoint

QString m_presentationName

Static Protected Attributes

static ImageMap m_images

static QMutex m_imageMapMutex

Member Typedef Documentation

typedef std::map<QString, QImage> ImageLayer::ImageMap [protected]

!! how to reap no-longer-used images?

Definition at line 116 of file ImageLayer.h.

typedef std::map<const View *, ImageMap> ImageLayer::ViewImageMap [protected]

Definition at line 117 of file ImageLayer.h.

typedef std::map<QString, FileSource *> ImageLayer::FileSourceMap [protected]

Definition at line 118 of file ImageLayer.h.

typedef std::set<MeasureRect> Layer::MeasureRectSet [protected, inherited]

Definition at line 529 of file Layer.h.

typedef QString PropertyContainer::PropertyName [inherited]

Definition at line 35 of file PropertyContainer.h.

typedef std::vector<PropertyName> PropertyContainer::PropertyList [inherited]

Definition at line 36 of file PropertyContainer.h.

Member Enumeration Documentation

enum Layer::VerticalPosition [inherited]

Enumerator:

PositionTop
PositionMiddle
PositionBottom

Definition at line 79 of file Layer.h.

enum Layer::SnapType [inherited]

Enumerator:

SnapLeft
SnapRight
SnapNearest
SnapNeighbouring

Definition at line 123 of file Layer.h.

enum Layer::ColourSignificance [inherited]

Enumerator:

ColourAbsent
ColourIrrelevant
ColourDistinguishes
ColourAndBackgroundSignificant
ColourHasMeaningfulValue

Definition at line 242 of file Layer.h.

enum PropertyContainer::PropertyType [inherited]

Enumerator:

ToggleProperty
RangeProperty
ValueProperty
ColourProperty
UnitsProperty
InvalidProperty

Definition at line 38 of file PropertyContainer.h.

Constructor & Destructor Documentation

ImageLayer::ImageLayer ( )

Definition at line 44 of file ImageLayer.cpp.

ImageLayer::~ImageLayer ( ) [virtual]

Definition at line 54 of file ImageLayer.cpp.

References m_remoteFiles.

Member Function Documentation

void ImageLayer::paint	(	View *	v,
		QPainter &	paint,
		QRect	rect
	)			const `[virtual]`

Implements Layer.

Definition at line 282 of file ImageLayer.cpp.

References drawImage(), View::getBackground(), View::getForeground(), View::getFrameForX(), SparseModel< PointType >::getPoints(), SparseModel< PointType >::getSampleRate(), View::getXForFrame(), SparseModel< PointType >::isOK(), and m_model.

QString ImageLayer::getFeatureDescription	(	View *	v,
		QPoint &
	)			const `[virtual]`

Reimplemented from Layer.

Definition at line 171 of file ImageLayer.cpp.

References RealTime::frame2RealTime(), getLocalPoints(), SparseModel< PointType >::getSampleRate(), SparseModel< PointType >::isReady(), and m_model.

bool ImageLayer::snapToFeatureFrame	(	View *	v,
		int &	frame,
		size_t &	resolution,
		SnapType	snap
	)			const `[virtual]`

!! too much overlap with TimeValueLayer/TimeInstantLayer/TextLayer

Reimplemented from Layer.

Definition at line 210 of file ImageLayer.cpp.

References getLocalPoints(), SparseModel< PointType >::getPoints(), SparseModel< PointType >::getResolution(), View::getXForFrame(), m_model, Layer::SnapLeft, Layer::SnapNeighbouring, Layer::SnapRight, and Layer::snapToFeatureFrame().

void ImageLayer::drawStart	(	View *	v,
		QMouseEvent *
	)			`[virtual]`

Reimplemented from Layer.

Definition at line 558 of file ImageLayer.cpp.

References View::getFrameForX(), SparseModel< PointType >::getResolution(), m_editing, m_editingCommand, m_editingPoint, m_model, and m_originalPoint.

void ImageLayer::drawDrag	(	View *	v,
		QMouseEvent *
	)			`[virtual]`

Reimplemented from Layer.

Definition at line 582 of file ImageLayer.cpp.

References View::getFrameForX(), SparseModel< PointType >::getResolution(), m_editing, m_editingCommand, m_editingPoint, and m_model.

void ImageLayer::drawEnd	(	View *	v,
		QMouseEvent *
	)			`[virtual]`

Reimplemented from Layer.

Definition at line 598 of file ImageLayer.cpp.

References checkAddRemote(), ImageDialog::getImage(), ImageDialog::getLabel(), m_editing, m_editingCommand, m_editingPoint, and m_model.

void ImageLayer::editStart	(	View *	v,
		QMouseEvent *
	)			`[virtual]`

Reimplemented from Layer.

Definition at line 643 of file ImageLayer.cpp.

References getLocalPoints(), m_editing, m_editingCommand, m_editingPoint, m_editOrigin, m_model, and m_originalPoint.

void ImageLayer::editDrag	(	View *	v,
		QMouseEvent *
	)			`[virtual]`

Reimplemented from Layer.

Definition at line 665 of file ImageLayer.cpp.

References View::getFrameForX(), SparseModel< PointType >::getResolution(), m_editing, m_editingCommand, m_editingPoint, m_editOrigin, m_model, and m_originalPoint.

void ImageLayer::editEnd	(	View *	v,
		QMouseEvent *
	)			`[virtual]`

Reimplemented from Layer.

Definition at line 685 of file ImageLayer.cpp.

References m_editing, m_editingCommand, and m_model.

void ImageLayer::moveSelection	(	Selection	s,
		size_t	newStartFrame
	)			`[virtual]`

Reimplemented from Layer.

Definition at line 728 of file ImageLayer.cpp.

References Selection::contains(), ImagePoint::frame, Selection::getEndFrame(), SparseModel< PointType >::getPoints(), Selection::getStartFrame(), and m_model.

void ImageLayer::resizeSelection	(	Selection	s,
		Selection	newSize
	)			`[virtual]`

Reimplemented from Layer.

Definition at line 753 of file ImageLayer.cpp.

References Selection::contains(), Selection::getEndFrame(), SparseModel< PointType >::getPoints(), Selection::getStartFrame(), and m_model.

void ImageLayer::deleteSelection ( Selection s ) [virtual]

Reimplemented from Layer.

Definition at line 787 of file ImageLayer.cpp.

References Selection::contains(), Selection::getEndFrame(), SparseModel< PointType >::getPoints(), Selection::getStartFrame(), and m_model.

void ImageLayer::copy	(	View *	v,
		Selection	s,
		Clipboard &	to
	)			`[virtual]`

Reimplemented from Layer.

Definition at line 806 of file ImageLayer.cpp.

References Clipboard::addPoint(), Layer::alignToReference(), Selection::contains(), Selection::getEndFrame(), SparseModel< PointType >::getPoints(), Selection::getStartFrame(), and m_model.

bool ImageLayer::paste	(	View *	v,
		const Clipboard &	from,
		int	frameOffset,
		bool	interactive
	)			`[virtual]`

Paste from the given clipboard onto the layer at the given frame offset.

If interactive is true, the layer may ask the user about paste options through a dialog if desired, and may return false if the user cancelled the paste operation. This function should return true if a paste actually occurred.

Reimplemented from Layer.

Definition at line 824 of file ImageLayer.cpp.

References Layer::alignFromReference(), Layer::clipboardHasDifferentAlignment(), Clipboard::getPoints(), and m_model.

bool ImageLayer::editOpen	(	View *	v,
		QMouseEvent *	e
	)			`[virtual]`

Open an editor on the item under the mouse (e.g.

on double-click). If there is no item or editing is not supported, return false.

Reimplemented from Layer.

Definition at line 699 of file ImageLayer.cpp.

References CommandHistory::addCommand(), checkAddRemote(), ImageDialog::getImage(), CommandHistory::getInstance(), ImageDialog::getLabel(), getLocalPoints(), and m_model.

virtual const Model* ImageLayer::getModel ( ) const [inline, virtual]

Implements Layer.

Definition at line 67 of file ImageLayer.h.

References m_model.

void ImageLayer::setModel ( ImageModel * model )

Definition at line 63 of file ImageLayer.cpp.

References Layer::connectSignals(), m_model, and Layer::modelReplaced().

Layer::PropertyList ImageLayer::getProperties ( ) const [virtual]

Get a list of the names of all the supported properties on this container.

These should be fixed (i.e. not internationalized).

Reimplemented from PropertyContainer.

Definition at line 74 of file ImageLayer.cpp.

References PropertyContainer::getProperties().

QString ImageLayer::getPropertyLabel ( const PropertyName & ) const [virtual]

Definition at line 80 of file ImageLayer.cpp.

Layer::PropertyType ImageLayer::getPropertyType ( const PropertyName & ) const [virtual]

Definition at line 86 of file ImageLayer.cpp.

References PropertyContainer::getPropertyType().

int ImageLayer::getPropertyRangeAndValue	(	const PropertyName &	,
		int *	min,
		int *	max,
		int *	deflt
	)			const `[virtual]`

Definition at line 92 of file ImageLayer.cpp.

References PropertyContainer::getPropertyRangeAndValue().

QString ImageLayer::getPropertyValueLabel	(	const PropertyName &	,
		int	value
	)			const `[virtual]`

Definition at line 99 of file ImageLayer.cpp.

References PropertyContainer::getPropertyValueLabel().

void ImageLayer::setProperty	(	const PropertyName &	,
		int	value
	)			`[virtual]`

Definition at line 106 of file ImageLayer.cpp.

References PropertyContainer::setProperty().

virtual ColourSignificance ImageLayer::getLayerColourSignificance ( ) const [inline, virtual]

This should return the degree of meaning associated with colour in this layer.

If ColourAbsent, the layer does not use colour. If ColourIrrelevant, the layer is coloured and the colour may be set by the user, but it doesn't really matter what the colour is (for example, in a time ruler layer). If ColourDistinguishes, then the colour is used to distinguish this layer from other similar layers (e.g. for data layers). If ColourAndBackgroundSignificant, then the layer should be given greater weight than ColourDistinguishes layers when choosing a background colour (e.g. for waveforms). If ColourHasMeaningfulValue, colours are actually meaningful -- the view will then show selections using unfilled rectangles instead of translucent filled rectangles, so as not to disturb the colours underneath.

Implements Layer.

Definition at line 79 of file ImageLayer.h.

References Layer::ColourAbsent.

bool ImageLayer::isLayerScrollable ( const View * v ) const [virtual]

This should return true if the layer can safely be scrolled automatically by a given view (simply copying the existing data and then refreshing the exposed area) without altering its meaning.

For the view widget as a whole this is usually not possible because of invariant (non-scrolling) material displayed over the top, but the widget may be able to optimise scrolling better if it is known that individual views can be scrolled safely in this way.

Reimplemented from Layer.

Definition at line 118 of file ImageLayer.cpp.

virtual bool ImageLayer::isLayerEditable ( ) const [inline, virtual]

This should return true if the layer can be edited by the user.

If this is the case, the appropriate edit tools may be made available by the application and the layer's drawStart/Drag/End and editStart/Drag/End methods should be implemented.

Reimplemented from Layer.

Definition at line 85 of file ImageLayer.h.

virtual int ImageLayer::getCompletion ( View * ) const [inline, virtual]

Return the proportion of background work complete in drawing this view, as a percentage -- in most cases this will be the value returned by pointer from a call to the underlying model's isReady(int *) call.

The view may choose to show a progress meter if it finds that this returns < 100 at any given moment.

Reimplemented from Layer.

Definition at line 87 of file ImageLayer.h.

References SparseModel< PointType >::getCompletion(), and m_model.

bool ImageLayer::getValueExtents	(	float &	min,
		float &	max,
		bool &	logarithmic,
		QString &	unit
	)			const `[virtual]`

Return the minimum and maximum values for the y axis of the model in this layer, as well as whether the layer is configured to use a logarithmic y axis display.

Also return the unit for these values if known.

This function returns the "normal" extents for the layer, not necessarily the extents actually in use in the display.

Implements Layer.

Definition at line 112 of file ImageLayer.cpp.

void ImageLayer::toXml	(	QTextStream &	stream,
		QString	indent = `""`,
		QString	extraAttributes = `""`
	)			const `[virtual]`

Convert the layer's data (though not those of the model it refers to) into XML for file output.

This class implements the basic name/type/model-id output; subclasses will typically call this superclass implementation with extra attributes describing their particular properties.

Reimplemented from Layer.

Definition at line 966 of file ImageLayer.cpp.

References Layer::toXml().

void ImageLayer::setLayerDormant	(	const View *	v,
		bool	dormant
	)			`[virtual]`

Indicate that a layer is not currently visible in the given view and is not expected to become visible in the near future (for example because the user has explicitly removed or hidden it).

The layer may respond by (for example) freeing any cache memory it is using, until next time its paint method is called, when it should set itself un-dormant again.

A layer class that overrides this function must also call this class's implementation.

Reimplemented from Layer.

Definition at line 482 of file ImageLayer.cpp.

References m_imageMapMutex, m_images, and m_scaled.

void ImageLayer::setProperties ( const QXmlAttributes & attributes ) [virtual]

Set the particular properties of a layer (those specific to the subclass) from a set of XML attributes.

This is the effective inverse of the toXml method.

Implements Layer.

Definition at line 973 of file ImageLayer.cpp.

bool ImageLayer::addImage	(	long	frame,
		QString	url
	)			`[virtual]`

Definition at line 625 of file ImageLayer.cpp.

References getLocalFilename(), m_model, and m_remoteFiles.

Referenced by MainWindowBase::openImage().

void ImageLayer::checkAddRemotes ( ) [protected, slot]

Definition at line 927 of file ImageLayer.cpp.

References checkAddRemote(), SparseModel< PointType >::getPoints(), and m_model.

void ImageLayer::remoteFileReady ( ) [protected, slot]

Definition at line 939 of file ImageLayer.cpp.

References m_imageMapMutex, m_images, m_remoteFiles, m_scaled, and Layer::modelChanged().

Referenced by checkAddRemote().

ImageModel::PointList ImageLayer::getLocalPoints	(	View *	v,
		int	x,
		int	y
	)			const `[protected]`

Definition at line 125 of file ImageLayer.cpp.

References SparseModel< PointType >::getPoints(), View::getXForFrame(), m_model, and m_scaled.

Referenced by editOpen(), editStart(), getFeatureDescription(), and snapToFeatureFrame().

bool ImageLayer::getImageOriginalSize	(	QString	name,
		QSize &	size
	)			const `[protected]`

!! how to reap no-longer-used images?

Definition at line 500 o


Public Types
enum	VerticalPosition { PositionTop, PositionMiddle, PositionBottom }
enum	SnapType { SnapLeft, SnapRight, SnapNearest, SnapNeighbouring }
enum	ColourSignificance { ColourAbsent, ColourIrrelevant, ColourDistinguishes, ColourAndBackgroundSignificant, ColourHasMeaningfulValue }
enum	PropertyType { ToggleProperty, RangeProperty, ValueProperty, ColourProperty, UnitsProperty, InvalidProperty }
typedef QString	PropertyName
typedef std::vector< PropertyName >	PropertyList
Public Slots
void	showLayer (View *, bool show)
virtual void	setProperty (const PropertyName &, int value)
	Set a property.
virtual void	setProperty (QString nameString, QString valueString)
	Set a property using a fuzzy match.
virtual void	setPropertyWithCommand (const PropertyName &, int value)
	Set a property using a command, supporting undo and redo.
virtual void	setPropertyWithCommand (QString nameString, QString valueString)
	As above, but using a command.
Signals
void	modelChanged ()
void	modelChanged (size_t startFrame, size_t endFrame)
void	modelCompletionChanged ()
void	modelAlignmentCompletionChanged ()
void	modelReplaced ()
void	layerParametersChanged ()
void	layerParameterRangesChanged ()
void	layerMeasurementRectsChanged ()
void	layerNameChanged ()
void	verticalZoomChanged ()
void	propertyChanged (PropertyContainer::PropertyName)
Public Member Functions
	ImageLayer ()
virtual	~ImageLayer ()
virtual void	paint (View *v, QPainter &paint, QRect rect) const
virtual QString	getFeatureDescription (View *v, QPoint &) const
virtual bool	snapToFeatureFrame (View *v, int &frame, size_t &resolution, SnapType snap) const
	!! too much overlap with TimeValueLayer/TimeInstantLayer/TextLayer
virtual void	drawStart (View v, QMouseEvent )
virtual void	drawDrag (View v, QMouseEvent )
virtual void	drawEnd (View v, QMouseEvent )
virtual void	editStart (View v, QMouseEvent )
virtual void	editDrag (View v, QMouseEvent )
virtual void	editEnd (View v, QMouseEvent )
virtual void	moveSelection (Selection s, size_t newStartFrame)
virtual void	resizeSelection (Selection s, Selection newSize)
virtual void	deleteSelection (Selection s)
virtual void	copy (View *v, Selection s, Clipboard &to)
virtual bool	paste (View *v, const Clipboard &from, int frameOffset, bool interactive)
	Paste from the given clipboard onto the layer at the given frame offset.
virtual bool	editOpen (View , QMouseEvent )
	Open an editor on the item under the mouse (e.g.
virtual const Model *	getModel () const
void	setModel (ImageModel *model)
virtual PropertyList	getProperties () const
	Get a list of the names of all the supported properties on this container.
virtual QString	getPropertyLabel (const PropertyName &) const
virtual PropertyType	getPropertyType (const PropertyName &) const
virtual int	getPropertyRangeAndValue (const PropertyName &, int min, int max, int *deflt) const
virtual QString	getPropertyValueLabel (const PropertyName &, int value) const
virtual void	setProperty (const PropertyName &, int value)
virtual ColourSignificance	getLayerColourSignificance () const
	This should return the degree of meaning associated with colour in this layer.
virtual bool	isLayerScrollable (const View *v) const
	This should return true if the layer can safely be scrolled automatically by a given view (simply copying the existing data and then refreshing the exposed area) without altering its meaning.
virtual bool	isLayerEditable () const
	This should return true if the layer can be edited by the user.
virtual int	getCompletion (View *) const
	Return the proportion of background work complete in drawing this view, as a percentage -- in most cases this will be the value returned by pointer from a call to the underlying model's isReady(int *) call.
virtual bool	getValueExtents (float &min, float &max, bool &logarithmic, QString &unit) const
	Return the minimum and maximum values for the y axis of the model in this layer, as well as whether the layer is configured to use a logarithmic y axis display.
virtual void	toXml (QTextStream &stream, QString indent="", QString extraAttributes="") const
	Convert the layer's data (though not those of the model it refers to) into XML for file output.
virtual void	setLayerDormant (const View *v, bool dormant)
	Indicate that a layer is not currently visible in the given view and is not expected to become visible in the near future (for example because the user has explicitly removed or hidden it).
void	setProperties (const QXmlAttributes &attributes)
	Set the particular properties of a layer (those specific to the subclass) from a set of XML attributes.
virtual bool	addImage (long frame, QString url)
virtual Model *	getModel ()
virtual const ZoomConstraint *	getZoomConstraint () const
	Return a zoom constraint object defining the supported zoom levels for this layer.
virtual bool	supportsOtherZoomLevels () const
	Return true if this layer can handle zoom levels other than those supported by its zoom constraint (presumably less efficiently or accurately than the officially supported zoom levels).
virtual VerticalPosition	getPreferredTimeRulerPosition () const
virtual VerticalPosition	getPreferredFrameCountPosition () const
virtual bool	hasLightBackground () const
virtual QString	getPropertyContainerIconName () const
virtual QString	getPropertyContainerName () const
virtual void	setPresentationName (QString name)
virtual QString	getLayerPresentationName () const
virtual QPixmap	getLayerPresentationPixmap (QSize) const
virtual int	getVerticalScaleWidth (View *, QPainter &) const
virtual void	paintVerticalScale (View *, QPainter &, QRect) const
virtual bool	getCrosshairExtents (View *, QPainter &, QPoint, std::vector< QRect > &) const
virtual void	paintCrosshairs (View *, QPainter &, QPoint) const
virtual void	paintMeasurementRects (View *, QPainter &, bool showFocus, QPoint focusPoint) const
virtual bool	nearestMeasurementRectChanged (View *, QPoint prev, QPoint now) const
virtual void	eraseStart (View , QMouseEvent )
virtual void	eraseDrag (View , QMouseEvent )
virtual void	eraseEnd (View , QMouseEvent )
virtual void	measureStart (View , QMouseEvent )
virtual void	measureDrag (View , QMouseEvent )
virtual void	measureEnd (View , QMouseEvent )
virtual void	measureDoubleClick (View , QMouseEvent )
virtual bool	haveCurrentMeasureRect () const
virtual void	deleteCurrentMeasureRect ()
virtual bool	isLayerOpaque () const
	This should return true if the layer completely obscures any underlying layers.
virtual void	setObjectName (const QString &name)
virtual void	toBriefXml (QTextStream &stream, QString indent="", QString extraAttributes="") const
	Produce XML containing the layer's ID and type.
virtual void	addMeasurementRect (const QXmlAttributes &)
	Add a measurement rectangle from the given XML attributes (presumably taken from a measurement element).
virtual bool	isLayerDormant (const View *v) const
	Return whether the layer is dormant (i.e.
virtual PlayParameters *	getPlayParameters ()
virtual bool	needsTextLabelHeight () const
virtual bool	hasTimeXAxis () const
virtual bool	getDisplayExtents (float &, float &) const
	Return the minimum and maximum values within the displayed range for the y axis, if only a subset of the whole range of the model (returned by getValueExtents) is being displayed.
virtual bool	setDisplayExtents (float, float)
	Set the displayed minimum and maximum values for the y axis to the given range, if supported.
virtual bool	getXScaleValue (const View *v, int x, float &value, QString &unit) const
	Return the value and unit at the given x coordinate in the given view.
virtual bool	getYScaleValue (const View *, int, float &, QString &) const
	Return the value and unit at the given y coordinate in the given view.
virtual bool	getYScaleDifference (const View *v, int y0, int y1, float &diff, QString &unit) const
	Return the difference between the values at the given y coordinates in the given view, and the unit of the difference.
virtual int	getVerticalZoomSteps (int &) const
	Get the number of vertical zoom steps available for this layer.
virtual int	getCurrentVerticalZoomStep () const
	Get the current vertical zoom step.
virtual void	setVerticalZoomStep (int)
	Set the vertical zoom step.
virtual RangeMapper *	getNewVerticalZoomRangeMapper () const
	Create and return a range mapper for vertical zoom step values.
virtual QString	getPropertyLabel (const PropertyName &) const =0
	Return the human-readable (and i18n'ised) name of a property.
virtual PropertyType	getPropertyType (const PropertyName &) const
	Return the type of the given property, or InvalidProperty if the property is not supported on this container.
virtual QString	getPropertyIconName (const PropertyName &) const
	Return an icon for the property, if any.
virtual QString	getPropertyGroupName (const PropertyName &) const
	If this property has something in common with other properties on this container, return a name that can be used to group them (in order to save screen space, for example).
virtual int	getPropertyRangeAndValue (const PropertyName &, int min, int max, int *deflt) const
	Return the minimum and maximum values for the given property and its current value in this container.
virtual QString	getPropertyValueLabel (const PropertyName &, int value) const
	If the given property is a ValueProperty, return the display label to be used for the given value for that property.
virtual RangeMapper *	getNewPropertyRangeMapper (const PropertyName &) const
	If the given property is a RangeProperty, return a new RangeMapper object mapping its integer range onto an underlying floating point value range for human-intelligible display, if appropriate.
virtual QString	toXmlString (QString indent="", QString extraAttributes="") const
	Convert this exportable object to XML in a string.
Static Public Member Functions
static QString	encodeEntities (QString)
static QString	encodeColour (QColor)
static int	getObjectExportId (const void *)
Protected Types
typedef std::map< QString, QImage >	ImageMap
	!! how to reap no-longer-used images?
typedef std::map< const View *, ImageMap >	ViewImageMap
typedef std::map< QString, FileSource * >	FileSourceMap
typedef std::set< MeasureRect >	MeasureRectSet
Protected Slots
void	checkAddRemotes ()
void	remoteFileReady ()
Protected Member Functions
ImageModel::PointList	getLocalPoints (View *v, int x, int y) const
bool	getImageOriginalSize (QString name, QSize &size) const
	!! how to reap no-longer-used images?
QImage	getImage (View *v, QString name, QSize maxSize) const
void	drawImage (View *v, QPainter &paint, const ImageModel::Point &p, int x, int nx) const
QString	getLocalFilename (QString img) const
void	checkAddRemote (QString img) const
void	connectSignals (const Model *)
virtual size_t	alignToReference (View *v, size_t frame) const
virtual size_t	alignFromReference (View *v, size_t frame) const
bool	clipboardHasDifferentAlignment (View *v, const Clipboard &clip) const
void	addMeasureRectToSet (const MeasureRect &r)
void	deleteMeasureRectFromSet (const MeasureRect &r)
void	updateMeasurePixrects (View *v) const
virtual void	updateMeasureRectYCoords (View *v, const MeasureRect &r) const
virtual void	setMeasureRectYCoord (View *v, MeasureRect &r, bool start, int y) const
virtual void	setMeasureRectFromPixrect (View *v, MeasureRect &r, QRect pixrect) const
MeasureRectSet::const_iterator	findFocusedMeasureRect (QPoint) const
void	paintMeasurementRect (View *v, QPainter &paint, const MeasureRect &r, bool focus) const
virtual bool	convertPropertyStrings (QString nameString, QString valueString, PropertyName &name, int &value)
Protected Attributes
ViewImageMap	m_scaled
FileSourceMap	m_remoteFiles
ImageModel *	m_model
bool	m_editing
QPoint	m_editOrigin
ImageModel::Point	m_originalPoint
ImageModel::Point	m_editingPoint
ImageModel::EditCommand *	m_editingCommand
MeasureRectSet	m_measureRects
MeasureRect	m_draggingRect
bool	m_haveDraggingRect
bool	m_haveCurrentMeasureRect
QPoint	m_currentMeasureRectPoint
QString	m_presentationName
Static Protected Attributes
static ImageMap	m_images
static QMutex	m_imageMapMutex