Public Types | Public Slots | Signals | Public Member Functions | Static Public Member Functions | Protected Types | Protected Slots | Protected Member Functions | Static Protected Member Functions | Protected Attributes | Static Protected Attributes | List of all members
ImageLayer Class Reference

#include <ImageLayer.h>

Inheritance diagram for ImageLayer:
Inheritance graph
Collaboration diagram for ImageLayer:
Collaboration graph

Public Types

enum  VerticalPosition { PositionTop, PositionMiddle, PositionBottom }
 
enum  SnapType { SnapLeft, SnapRight, SnapNeighbouring }
 
enum  ColourSignificance {
  ColourAbsent, ColourIrrelevant, ColourDistinguishes, ColourAndBackgroundSignificant,
  ColourHasMeaningfulValue
}
 

Public Slots

void showLayer (LayerGeometryProvider *, bool show)
 Change the visibility status (dormancy) of the layer in the given view. More...
 

Signals

void modelChanged (ModelId)
 
void modelCompletionChanged (ModelId)
 
void modelAlignmentCompletionChanged (ModelId)
 
void modelChangedWithin (ModelId, sv_frame_t startFrame, sv_frame_t endFrame)
 
void modelReplaced ()
 
void layerParametersChanged ()
 
void layerParameterRangesChanged ()
 
void layerMeasurementRectsChanged ()
 
void layerNameChanged ()
 
void verticalZoomChanged ()
 

Public Member Functions

 ImageLayer ()
 
virtual ~ImageLayer ()
 
void paint (LayerGeometryProvider *v, QPainter &paint, QRect rect) const override
 Paint the given rectangle of this layer onto the given view using the given painter, superimposing it on top of any existing material in that view. More...
 
QString getFeatureDescription (LayerGeometryProvider *v, QPoint &) const override
 
bool snapToFeatureFrame (LayerGeometryProvider *v, sv_frame_t &frame, int &resolution, SnapType snap, int ycoord) const override
 !! too much overlap with TimeValueLayer/TimeInstantLayer/TextLayer More...
 
void drawStart (LayerGeometryProvider *v, QMouseEvent *) override
 
void drawDrag (LayerGeometryProvider *v, QMouseEvent *) override
 
void drawEnd (LayerGeometryProvider *v, QMouseEvent *) override
 
void editStart (LayerGeometryProvider *v, QMouseEvent *) override
 
void editDrag (LayerGeometryProvider *v, QMouseEvent *) override
 
void editEnd (LayerGeometryProvider *v, QMouseEvent *) override
 
void moveSelection (Selection s, sv_frame_t newStartFrame) override
 
void resizeSelection (Selection s, Selection newSize) override
 
void deleteSelection (Selection s) override
 
void copy (LayerGeometryProvider *v, Selection s, Clipboard &to) override
 
bool paste (LayerGeometryProvider *v, const Clipboard &from, sv_frame_t frameOffset, bool interactive) override
 Paste from the given clipboard onto the layer at the given frame offset. More...
 
bool editOpen (LayerGeometryProvider *, QMouseEvent *) override
 Open an editor on the item under the mouse (e.g. More...
 
ModelId getModel () const override
 Return the ID of the model represented in this layer. More...
 
void setModel (ModelId model)
 
PropertyList getProperties () const override
 
QString getPropertyLabel (const PropertyName &) const override
 
PropertyType getPropertyType (const PropertyName &) const override
 
int getPropertyRangeAndValue (const PropertyName &, int *min, int *max, int *deflt) const override
 
QString getPropertyValueLabel (const PropertyName &, int value) const override
 
void setProperty (const PropertyName &, int value) override
 
ColourSignificance getLayerColourSignificance () const override
 This should return the degree of meaning associated with colour in this layer. More...
 
bool isLayerScrollable (const LayerGeometryProvider *v) const override
 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. More...
 
bool isLayerEditable () const override
 This should return true if the layer can be edited by the user. More...
 
int getCompletion (LayerGeometryProvider *) const override
 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. More...
 
bool getValueExtents (double &min, double &max, bool &logarithmic, QString &unit) const override
 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. More...
 
void toXml (QTextStream &stream, QString indent="", QString extraAttributes="") const override
 
int getVerticalScaleWidth (LayerGeometryProvider *, bool, QPainter &) const override
 
void setLayerDormant (const LayerGeometryProvider *v, bool dormant) override
 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). More...
 
void setProperties (const QXmlAttributes &attributes) override
 Set the particular properties of a layer (those specific to the subclass) from a set of XML attributes. More...
 
virtual bool addImage (sv_frame_t frame, QString url)
 
ModelId getSourceModel () const
 Return the ID of the source model for the model represented in this layer. More...
 
virtual ModelId getExportModel (LayerGeometryProvider *) const
 Return the ID of a model representing the contents of this layer in a form suitable for export to a tabular file format such as CSV. More...
 
virtual const ZoomConstraint * getZoomConstraint () const
 Return a zoom constraint object defining the supported zoom levels for this layer. More...
 
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). More...
 
virtual void setSynchronousPainting (bool)
 Enable or disable synchronous painting. More...
 
virtual VerticalPosition getPreferredTimeRulerPosition () const
 
virtual VerticalPosition getPreferredFrameCountPosition () const
 
virtual bool hasLightBackground () const
 
QString getPropertyContainerIconName () const override
 
QString getPropertyContainerName () const override
 
virtual void setPresentationName (QString name)
 
virtual bool isPresentationNameSet () const
 
virtual QString getLayerPresentationName () const
 
virtual QPixmap getLayerPresentationPixmap (QSize) const
 
virtual void paintVerticalScale (LayerGeometryProvider *, bool, QPainter &, QRect) const
 
virtual int getHorizontalScaleHeight (LayerGeometryProvider *, QPainter &) const
 
virtual bool getCrosshairExtents (LayerGeometryProvider *, QPainter &, QPoint, std::vector< QRect > &) const
 
virtual void paintCrosshairs (LayerGeometryProvider *, QPainter &, QPoint) const
 
virtual void paintMeasurementRects (LayerGeometryProvider *, QPainter &, bool showFocus, QPoint focusPoint) const
 
virtual bool nearestMeasurementRectChanged (LayerGeometryProvider *, QPoint prev, QPoint now) const
 
virtual QString getLabelPreceding (sv_frame_t) const
 
virtual bool snapToSimilarFeature (LayerGeometryProvider *, sv_frame_t &, int &resolution, SnapType) const
 Adjust the given frame to snap to the next feature that has "effectively" the same value as the feature prior to the given frame, if possible. More...
 
virtual void eraseStart (LayerGeometryProvider *, QMouseEvent *)
 
virtual void eraseDrag (LayerGeometryProvider *, QMouseEvent *)
 
virtual void eraseEnd (LayerGeometryProvider *, QMouseEvent *)
 
virtual void splitStart (LayerGeometryProvider *, QMouseEvent *)
 
virtual void splitEnd (LayerGeometryProvider *, QMouseEvent *)
 
virtual void addNote (LayerGeometryProvider *, QMouseEvent *)
 
virtual void measureStart (LayerGeometryProvider *, QMouseEvent *)
 
virtual void measureDrag (LayerGeometryProvider *, QMouseEvent *)
 
virtual void measureEnd (LayerGeometryProvider *, QMouseEvent *)
 
virtual void measureDoubleClick (LayerGeometryProvider *, QMouseEvent *)
 
virtual bool haveCurrentMeasureRect () const
 
virtual void deleteCurrentMeasureRect ()
 
virtual bool isLayerOpaque () const
 This should return true if the layer completely obscures any underlying layers. More...
 
virtual QString getError (LayerGeometryProvider *) const
 Return an error string if any errors have occurred while loading or processing data for the given view. More...
 
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. More...
 
virtual void addMeasurementRect (const QXmlAttributes &)
 Add a measurement rectangle from the given XML attributes (presumably taken from a measurement element). More...
 
virtual bool isLayerDormant (const LayerGeometryProvider *v) const
 Return whether the layer is dormant (i.e. More...
 
std::shared_ptr< PlayParameters > getPlayParameters () override
 Return the play parameters for this layer, if any. More...
 
virtual bool needsTextLabelHeight () const
 True if this layer will need to place text labels when it is painted. More...
 
virtual bool hasTimeXAxis () const
 Return true if the X axis on the layer is time proportional to audio frames, false otherwise. More...
 
virtual void zoomToRegion (const LayerGeometryProvider *, QRect)
 Update the X and Y axis scales, where appropriate, to focus on the given rectangular region. More...
 
virtual bool getDisplayExtents (double &, double &) const
 Return the minimum and maximum values within the visible area for the y axis of this layer. More...
 
virtual bool setDisplayExtents (double, double)
 Set the displayed minimum and maximum values for the y axis to the given range, if supported. More...
 
virtual bool adoptExtents (double, double, QString)
 Consider using the given value extents and units for this layer. More...
 
virtual bool getXScaleValue (const LayerGeometryProvider *v, int x, double &value, QString &unit) const
 Return the value and unit at the given x coordinate in the given view. More...
 
virtual bool getYScaleValue (const LayerGeometryProvider *, int, double &, QString &) const
 Return the value and unit at the given y coordinate in the given view. More...
 
virtual bool getYScaleDifference (const LayerGeometryProvider *v, int y0, int y1, double &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. More...
 
virtual int getVerticalZoomSteps (int &) const
 Get the number of vertical zoom steps available for this layer. More...
 
virtual int getCurrentVerticalZoomStep () const
 Get the current vertical zoom step. More...
 
virtual void setVerticalZoomStep (int)
 Set the vertical zoom step. More...
 
virtual RangeMapper * getNewVerticalZoomRangeMapper () const
 Create and return a range mapper for vertical zoom step values. More...
 
virtual bool canExistWithoutModel () const
 Return true if this layer type can function without a model being set. More...
 

Static Public Member Functions

static bool isImageFileSupported (QString url)
 

Protected Types

typedef std::map< QString, QImage > ImageMap
 !! how to reap no-longer-used images? More...
 
typedef std::map< const LayerGeometryProvider *, ImageMap > ViewImageMap
 
typedef std::map< QString, FileSource * > FileSourceMap
 
typedef std::set< MeasureRect > MeasureRectSet
 

Protected Slots

void checkAddSources ()
 
void fileSourceReady ()
 

Protected Member Functions

EventVector getLocalPoints (LayerGeometryProvider *v, int x, int y) const
 
bool getImageOriginalSize (QString name, QSize &size) const
 !! how to reap no-longer-used images? More...
 
QImage getImage (LayerGeometryProvider *v, QString name, QSize maxSize) const
 
void drawImage (LayerGeometryProvider *v, QPainter &paint, const Event &p, int x, int nx) const
 
void checkAddSourceAndConnect (QString img)
 
void finish (ChangeEventsCommand *command)
 
void connectSignals (ModelId)
 
virtual sv_frame_t alignToReference (LayerGeometryProvider *v, sv_frame_t frame) const
 
virtual sv_frame_t alignFromReference (LayerGeometryProvider *v, sv_frame_t frame) const
 
bool clipboardHasDifferentAlignment (LayerGeometryProvider *v, const Clipboard &clip) const
 
void addMeasureRectToSet (const MeasureRect &r)
 
void deleteMeasureRectFromSet (const MeasureRect &r)
 
void updateMeasurePixrects (LayerGeometryProvider *v) const
 
virtual void updateMeasureRectYCoords (LayerGeometryProvider *v, const MeasureRect &r) const
 
virtual void setMeasureRectYCoord (LayerGeometryProvider *v, MeasureRect &r, bool start, int y) const
 
virtual void setMeasureRectFromPixrect (LayerGeometryProvider *v, MeasureRect &r, QRect pixrect) const
 
MeasureRectSet::const_iterator findFocusedMeasureRect (QPoint) const
 
void paintMeasurementRect (LayerGeometryProvider *v, QPainter &paint, const MeasureRect &r, bool focus) const
 
bool valueExtentsMatchMine (LayerGeometryProvider *v) const
 

Static Protected Member Functions

static QString getLocalFilename (QString img)
 
static void checkAddSource (QString img, bool synchronise)
 

Protected Attributes

ViewImageMap m_scaled
 
ModelId m_model
 
bool m_editing
 
QPoint m_editOrigin
 
Event m_originalPoint
 
Event m_editingPoint
 
ChangeEventsCommand * 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 FileSourceMap m_fileSources
 
static QMutex m_staticMutex
 

Detailed Description

Definition at line 33 of file ImageLayer.h.

Member Typedef Documentation

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

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

Definition at line 120 of file ImageLayer.h.

typedef std::map<const LayerGeometryProvider *, ImageMap> ImageLayer::ViewImageMap
protected

Definition at line 121 of file ImageLayer.h.

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

Definition at line 122 of file ImageLayer.h.

typedef std::set<MeasureRect> Layer::MeasureRectSet
protectedinherited

Definition at line 692 of file Layer.h.

Member Enumeration Documentation

enum Layer::VerticalPosition
inherited
Enumerator
PositionTop 
PositionMiddle 
PositionBottom 

Definition at line 140 of file Layer.h.

enum Layer::SnapType
inherited
Enumerator
SnapLeft 
SnapRight 
SnapNeighbouring 

Definition at line 195 of file Layer.h.

enum Layer::ColourSignificance
inherited
Enumerator
ColourAbsent 
ColourIrrelevant 
ColourDistinguishes 
ColourAndBackgroundSignificant 
ColourHasMeaningfulValue 

Definition at line 348 of file Layer.h.

Constructor & Destructor Documentation

ImageLayer::ImageLayer ( )

Definition at line 50 of file ImageLayer.cpp.

ImageLayer::~ImageLayer ( )
virtual

Definition at line 56 of file ImageLayer.cpp.

References m_fileSources.

Member Function Documentation

void ImageLayer::paint ( LayerGeometryProvider *  ,
QPainter &  ,
QRect   
) const
overridevirtual

Paint the given rectangle of this layer onto the given view using the given painter, superimposing it on top of any existing material in that view.

The LayerGeometryProvider (an interface implemented by View) is provided here because it is possible for one layer to exist in more than one view, so the dimensions of the view may vary from one paint call to another (without any view having been resized).

Implements Layer.

Definition at line 260 of file ImageLayer.cpp.

References drawImage(), LayerGeometryProvider::getBackground(), LayerGeometryProvider::getForeground(), LayerGeometryProvider::getFrameForX(), LayerGeometryProvider::getPaintHeight(), LayerGeometryProvider::getPaintWidth(), LayerGeometryProvider::getXForFrame(), and m_model.

QString ImageLayer::getFeatureDescription ( LayerGeometryProvider *  v,
QPoint &  pos 
) const
overridevirtual

Reimplemented from Layer.

Definition at line 188 of file ImageLayer.cpp.

References getLocalPoints(), and m_model.

bool ImageLayer::snapToFeatureFrame ( LayerGeometryProvider *  v,
sv_frame_t &  frame,
int &  resolution,
SnapType  snap,
int  ycoord 
) const
overridevirtual

!! too much overlap with TimeValueLayer/TimeInstantLayer/TextLayer

Reimplemented from Layer.

Definition at line 228 of file ImageLayer.cpp.

References getLocalPoints(), LayerGeometryProvider::getXForFrame(), m_model, Layer::SnapLeft, Layer::SnapNeighbouring, and Layer::snapToFeatureFrame().

void ImageLayer::drawStart ( LayerGeometryProvider *  v,
QMouseEvent *  e 
)
overridevirtual

Reimplemented from Layer.

Definition at line 540 of file ImageLayer.cpp.

References finish(), LayerGeometryProvider::getFrameForX(), m_editing, m_editingCommand, m_editingPoint, m_model, and m_originalPoint.

void ImageLayer::drawDrag ( LayerGeometryProvider *  v,
QMouseEvent *  e 
)
overridevirtual

Reimplemented from Layer.

Definition at line 565 of file ImageLayer.cpp.

References LayerGeometryProvider::getFrameForX(), m_editing, m_editingCommand, m_editingPoint, and m_model.

void ImageLayer::drawEnd ( LayerGeometryProvider *  v,
QMouseEvent *   
)
overridevirtual

Reimplemented from Layer.

Definition at line 583 of file ImageLayer.cpp.

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

void ImageLayer::editStart ( LayerGeometryProvider *  v,
QMouseEvent *  e 
)
overridevirtual

Reimplemented from Layer.

Definition at line 646 of file ImageLayer.cpp.

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

void ImageLayer::editDrag ( LayerGeometryProvider *  v,
QMouseEvent *  e 
)
overridevirtual

Reimplemented from Layer.

Definition at line 669 of file ImageLayer.cpp.

References LayerGeometryProvider::getFrameForX(), m_editing, m_editingCommand, m_editingPoint, m_editOrigin, m_model, and m_originalPoint.

void ImageLayer::editEnd ( LayerGeometryProvider *  v,
QMouseEvent *   
)
overridevirtual

Reimplemented from Layer.

Definition at line 691 of file ImageLayer.cpp.

References finish(), m_editing, m_editingCommand, and m_model.

void ImageLayer::moveSelection ( Selection  s,
sv_frame_t  newStartFrame 
)
overridevirtual

Reimplemented from Layer.

Definition at line 737 of file ImageLayer.cpp.

References finish(), and m_model.

void ImageLayer::resizeSelection ( Selection  s,
Selection  newSize 
)
overridevirtual

Reimplemented from Layer.

Definition at line 759 of file ImageLayer.cpp.

References finish(), and m_model.

void ImageLayer::deleteSelection ( Selection  s)
overridevirtual

Reimplemented from Layer.

Definition at line 788 of file ImageLayer.cpp.

References finish(), and m_model.

void ImageLayer::copy ( LayerGeometryProvider *  v,
Selection  s,
Clipboard &  to 
)
overridevirtual

Reimplemented from Layer.

Definition at line 807 of file ImageLayer.cpp.

References Layer::alignToReference(), and m_model.

bool ImageLayer::paste ( LayerGeometryProvider *  ,
const Clipboard &  ,
sv_frame_t  ,
bool   
)
overridevirtual

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.

!! inadequate

Reimplemented from Layer.

Definition at line 821 of file ImageLayer.cpp.

References Layer::alignFromReference(), Layer::clipboardHasDifferentAlignment(), finish(), LayerGeometryProvider::getView(), and m_model.

bool ImageLayer::editOpen ( LayerGeometryProvider *  ,
QMouseEvent *   
)
overridevirtual

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 706 of file ImageLayer.cpp.

References checkAddSourceAndConnect(), finish(), ImageDialog::getImage(), ImageDialog::getLabel(), getLocalPoints(), and m_model.

ModelId ImageLayer::getModel ( ) const
inlineoverridevirtual

Return the ID of the model represented in this layer.

Implements Layer.

Definition at line 67 of file ImageLayer.h.

References getProperties(), getPropertyLabel(), getPropertyRangeAndValue(), getPropertyType(), getPropertyValueLabel(), m_model, setModel(), and setProperty().

Referenced by fileSourceReady().

void ImageLayer::setModel ( ModelId  model)

Definition at line 73 of file ImageLayer.cpp.

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

Referenced by getModel().

Layer::PropertyList ImageLayer::getProperties ( ) const
override

Definition at line 92 of file ImageLayer.cpp.

Referenced by getModel().

QString ImageLayer::getPropertyLabel ( const PropertyName &  ) const
override

Definition at line 98 of file ImageLayer.cpp.

Referenced by getModel().

Layer::PropertyType ImageLayer::getPropertyType ( const PropertyName &  name) const
override

Definition at line 104 of file ImageLayer.cpp.

Referenced by getModel().

int ImageLayer::getPropertyRangeAndValue ( const PropertyName &  name,
int *  min,
int *  max,
int *  deflt 
) const
override

Definition at line 110 of file ImageLayer.cpp.

Referenced by getModel().

QString ImageLayer::getPropertyValueLabel ( const PropertyName &  name,
int  value 
) const
override

Definition at line 117 of file ImageLayer.cpp.

Referenced by getModel().

void ImageLayer::setProperty ( const PropertyName &  name,
int  value 
)
override

Definition at line 124 of file ImageLayer.cpp.

Referenced by getModel().

ColourSignificance ImageLayer::getLayerColourSignificance ( ) const
inlineoverridevirtual

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, and isLayerScrollable().

bool ImageLayer::isLayerScrollable ( const LayerGeometryProvider *  ) const
overridevirtual

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 136 of file ImageLayer.cpp.

Referenced by getLayerColourSignificance().

bool ImageLayer::isLayerEditable ( ) const
inlineoverridevirtual

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.

References getCompletion(), getValueExtents(), and toXml().

int ImageLayer::getCompletion ( LayerGeometryProvider *  ) const
overridevirtual

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 65 of file ImageLayer.cpp.

References m_model.

Referenced by isLayerEditable().

bool ImageLayer::getValueExtents ( double &  min,
double &  max,
bool &  logarithmic,
QString &  unit 
) const
overridevirtual

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 (see getDisplayExtents).

Implements Layer.

Definition at line 130 of file ImageLayer.cpp.

Referenced by isLayerEditable().

void ImageLayer::toXml ( QTextStream &  stream,
QString  indent = "",
QString  extraAttributes = "" 
) const
override

Definition at line 988 of file ImageLayer.cpp.

References Layer::toXml().

Referenced by isLayerEditable().

int ImageLayer::getVerticalScaleWidth ( LayerGeometryProvider *  ,
bool  ,
QPainter &   
) const
inlineoverridevirtual

Implements Layer.

Definition at line 95 of file ImageLayer.h.

References addImage(), checkAddSources(), drawImage(), fileSourceReady(), getImage(), getImageOriginalSize(), getLocalPoints(), isImageFileSupported(), setLayerDormant(), and setProperties().

void ImageLayer::setLayerDormant ( const LayerGeometryProvider *  v,
bool  dormant 
)
overridevirtual

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 466 of file ImageLayer.cpp.

References m_images, m_scaled, and m_staticMutex.

Referenced by getVerticalScaleWidth().

void ImageLayer::setProperties ( const QXmlAttributes &  )
overridevirtual

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 995 of file ImageLayer.cpp.

Referenced by getVerticalScaleWidth().

bool ImageLayer::isImageFileSupported ( QString  url)
static

Definition at line 609 of file ImageLayer.cpp.

References getLocalFilename(), and m_staticMutex.

Referenced by getVerticalScaleWidth().

bool ImageLayer::addImage ( sv_frame_t  frame,
QString  url 
)
virtual

Definition at line 624 of file ImageLayer.cpp.

References finish(), getLocalFilename(), m_fileSources, m_model, and m_staticMutex.

Referenced by getVerticalScaleWidth().

void ImageLayer::checkAddSources ( )
protectedslot

Definition at line 939 of file ImageLayer.cpp.

References checkAddSourceAndConnect(), and m_model.

Referenced by getVerticalScaleWidth().

void ImageLayer::fileSourceReady ( )
protectedslot

Definition at line 952 of file ImageLayer.cpp.

References getModel(), m_fileSources, m_images, m_scaled, m_staticMutex, and Layer::modelChanged().

Referenced by checkAddSourceAndConnect(), and getVerticalScaleWidth().

EventVector ImageLayer::getLocalPoints ( LayerGeometryProvider *  v,
int  x,
int  y 
) const
protected

Definition at line 142 of file ImageLayer.cpp.

References LayerGeometryProvider::getXForFrame(), m_model, and m_scaled.

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

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

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

Definition at line 484 of file ImageLayer.cpp.

References getLocalFilename(), m_images, and m_staticMutex.

Referenced by drawImage(), and getVerticalScaleWidth().

QImage ImageLayer::getImage ( LayerGeometryProvider *  v,
QString  name,
QSize  maxSize 
) const
protected

Definition at line 503 of file ImageLayer.cpp.

References getLocalFilename(), m_images, m_scaled, and m_staticMutex.

Referenced by drawImage(), and getVerticalScaleWidth().

void ImageLayer::drawImage ( LayerGeometryProvider *  v,
QPainter &  paint,
const Event &  p,
int  x,
int  nx 
) const
protected

Definition at line 319 of file ImageLayer.cpp.

References getImage(), getImageOriginalSize(), and LayerGeometryProvider::getPaintHeight().

Referenced by getVerticalScaleWidth(), and paint().

QString ImageLayer::getLocalFilename ( QString  img)
staticprotected

Definition at line 891 of file ImageLayer.cpp.

References checkAddSource(), and m_fileSources.

Referenced by addImage(), getImage(), getImageOriginalSize(), and isImageFileSupported().

void ImageLayer::checkAddSource ( QString  img,
bool  synchronise 
)
staticprotected

Definition at line 918 of file ImageLayer.cpp.

References m_fileSources, and m_staticMutex.

Referenced by checkAddSourceAndConnect(), and getLocalFilename().

void ImageLayer::checkAddSourceAndConnect ( QString  img)
protected

Definition at line 906 of file ImageLayer.cpp.

References checkAddSource(), fileSourceReady(), m_fileSources, and m_staticMutex.

Referenced by checkAddSources(), drawEnd(), and editOpen().

void ImageLayer::finish ( ChangeEventsCommand *  command)
inlineprotected

Definition at line 141 of file ImageLayer.h.

References CommandHistory::addCommand(), and CommandHistory::getInstance().

Referenced by addImage(), deleteSelection(), drawEnd(), drawStart(), editEnd(), editOpen(), editStart(), moveSelection(), paste(), and resizeSelection().

ModelId Layer::getSourceModel ( ) const
inherited

Return the ID of the source model for the model represented in this layer.

If the model has no other source, or there is no model here, return None.

Definition at line 68 of file Layer.cpp.

References Layer::getModel().

Referenced by View::paintEvent().

virtual ModelId Layer::getExportModel ( LayerGeometryProvider *  ) const
inlinevirtualinherited

Return the ID of a model representing the contents of this layer in a form suitable for export to a tabular file format such as CSV.

In most cases this will be the same as returned by getModel(). The exceptions are those layers such as SpectrogramLayer, that are "only" alternative views of time-domain sample data. For such layers, getModel() will return the backing time-domain data, for example as a ReadOnlyWaveFileModel; but getExportModel() will return a model, possibly "local to" the layer, which adapts this into the form shown in the layer for a given view so that the export matches the layer's visible contents.

Because this is supposed to match the contents of the view rather than the backing model, it's necessary to pass in a view (or LayerGeometryProvider) so that the layer can retrieve its vertical extents for export.

Reimplemented in SpectrogramLayer, and Colour3DPlotLayer.

Definition at line 95 of file Layer.h.

References Layer::getModel().

virtual const ZoomConstraint* Layer::getZoomConstraint ( ) const
inlinevirtualinherited

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

If this returns zero, the layer will support any integer zoom level.

Reimplemented in SpectrogramLayer, Colour3DPlotLayer, and WaveformLayer.

Definition at line 104 of file Layer.h.

virtual bool Layer::supportsOtherZoomLevels ( ) const
inlinevirtualinherited

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).

If true, the layer will unenthusistically accept any integer zoom level from 1 to the maximum returned by its zoom constraint.

Definition at line 114 of file Layer.h.

References Layer::paint().

virtual void Layer::setSynchronousPainting ( bool  )
inlinevirtualinherited

Enable or disable synchronous painting.

If synchronous painting is enabled, a call to paint() must complete painting the entire rectangle before it returns. If synchronous painting is disabled (which should be the default), the paint() call may defer painting some regions if data is not yet available, by calling back on its view to schedule another update. Synchronous painting is necessary when rendering to an image. Simple layer types will always paint synchronously, and so may ignore this.

Reimplemented in SpectrogramLayer, and Colour3DPlotLayer.

Definition at line 138 of file Layer.h.

virtual VerticalPosition Layer::getPreferredTimeRulerPosition ( ) const
inlinevirtualinherited

Definition at line 143 of file Layer.h.

References Layer::PositionMiddle.

virtual VerticalPosition Layer::getPreferredFrameCountPosition ( ) const
inlinevirtualinherited

Reimplemented in SpectrogramLayer, and SpectrumLayer.

Definition at line 146 of file Layer.h.

References Layer::PositionBottom.

virtual bool Layer::hasLightBackground ( ) const
inlinevirtualinherited

Reimplemented in TimeValueLayer, Colour3DPlotLayer, SpectrogramLayer, SliceLayer, and SingleColourLayer.

Definition at line 149 of file Layer.h.

References Layer::getPropertyContainerIconName().

QString Layer::getPropertyContainerIconName ( ) const
overrideinherited

Definition at line 80 of file Layer.cpp.

References LayerFactory::getInstance(), and LayerFactory::getLayerIconName().

Referenced by LayerTreeModel::data(), and Layer::hasLightBackground().

QString Layer::getPropertyContainerName ( ) const
inlineoverrideinherited

Definition at line 155 of file Layer.h.

References Layer::getLayerPresentationName(), Layer::isPresentationNameSet(), Layer::m_presentationName, and Layer::setPresentationName().

void Layer::setPresentationName ( QString  name)
virtualinherited

Definition at line 87 of file Layer.cpp.

References Layer::m_presentationName.

Referenced by Layer::getPropertyContainerName().

bool Layer::isPresentationNameSet ( ) const
virtualinherited

Definition at line 93 of file Layer.cpp.

References Layer::m_presentationName.

Referenced by Layer::getPropertyContainerName().

QString Layer::getLayerPresentationName ( ) const
virtualinherited

Reimplemented in TimeRulerLayer.

Definition at line 99 of file Layer.cpp.

References LayerFactory::getInstance(), LayerFactory::getLayerPresentationName(), LayerFactory::getLayerType(), Layer::getModel(), and Layer::m_presentationName.

Referenced by Pane::drawVerticalScale(), FlexiNoteLayer::getAssociatedPitchModel(), Layer::getPropertyContainerName(), View::getScaleProvidingLayerForUnit(), and PropertyStack::repopulate().

virtual QPixmap Layer::getLayerPresentationPixmap ( QSize  ) const
inlinevirtualinherited

Reimplemented in SingleColourLayer.

Definition at line 165 of file Layer.h.

References Layer::getVerticalScaleWidth().

virtual void Layer::paintVerticalScale ( LayerGeometryProvider *  ,
bool  ,
QPainter &  ,
QRect   
) const
inlinevirtualinherited

Reimplemented in SpectrogramLayer, Colour3DPlotLayer, NoteLayer, WaveformLayer, RegionLayer, SliceLayer, TimeValueLayer, BoxLayer, and FlexiNoteLayer.

Definition at line 170 of file Layer.h.

Referenced by Pane::drawVerticalScale(), and Pane::render().

virtual int Layer::getHorizontalScaleHeight ( LayerGeometryProvider *  ,
QPainter &   
) const
inlinevirtualinherited

Reimplemented in SpectrumLayer.

Definition at line 173 of file Layer.h.

Referenced by SliceLayer::paint(), and SliceLayer::paintVerticalScale().

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

Reimplemented in SpectrogramLayer, and SpectrumLayer.

Definition at line 175 of file Layer.h.

virtual void Layer::paintCrosshairs ( LayerGeometryProvider *  ,
QPainter &  ,
QPoint   
) const
inlinevirtualinherited

Reimplemented in SpectrogramLayer, and SpectrumLayer.

Definition at line 179 of file Layer.h.

References Layer::nearestMeasurementRectChanged(), and Layer::paintMeasurementRects().

void Layer::paintMeasurementRects ( LayerGeometryProvider *  v,
QPainter &  paint,
bool  showFocus,
QPoint  focusPoint 
) const
virtualinherited

Definition at line 464 of file Layer.cpp.

References Layer::findFocusedMeasureRect(), Layer::m_currentMeasureRectPoint, Layer::m_draggingRect, Layer::m_haveCurrentMeasureRect, Layer::m_haveDraggingRect, Layer::m_measureRects, Layer::paintMeasurementRect(), and Layer::updateMeasurePixrects().

Referenced by Layer::paintCrosshairs(), and Pane::paintEvent().

bool Layer::nearestMeasurementRectChanged ( LayerGeometryProvider *  v,
QPoint  prev,
QPoint  now 
) const
virtualinherited

Definition at line 496 of file Layer.cpp.

References Layer::findFocusedMeasureRect(), and Layer::updateMeasurePixrects().

Referenced by Pane::mouseMoveEvent(), and Layer::paintCrosshairs().

virtual QString Layer::getLabelPreceding ( sv_frame_t  ) const
inlinevirtualinherited

Reimplemented in RegionLayer, TimeValueLayer, BoxLayer, and TimeInstantLayer.

Definition at line 191 of file Layer.h.

virtual bool Layer::snapToSimilarFeature ( LayerGeometryProvider *  ,
sv_frame_t &  ,
int &  resolution,
SnapType   
) const
inlinevirtualinherited

Adjust the given frame to snap to the next feature that has "effectively" the same value as the feature prior to the given frame, if possible.

The snap type must be SnapLeft (snap to the time of the next feature prior to the one preceding the given frame that has a similar value to it) or SnapRight (snap to the time of the next feature following the given frame that has a similar value to the feature preceding it). Other values are not permitted.

Return true if a suitable feature was found and frame adjusted accordingly. Return false if no suitable feature was available (and leave frame unmodified). If returning true, also return the resolution of the model in this layer in sample frames.

Reimplemented in RegionLayer, and TimeValueLayer.

Definition at line 251 of file Layer.h.

Referenced by TimeValueLayer::snapToSimilarFeature(), and RegionLayer::snapToSimilarFeature().

virtual void Layer::eraseStart ( LayerGeometryProvider *  ,
QMouseEvent *   
)
inlinevirtualinherited

Reimplemented in NoteLayer, RegionLayer, TimeValueLayer, BoxLayer, FlexiNoteLayer, TimeInstantLayer, and TextLayer.

Definition at line 268 of file Layer.h.

Referenced by Pane::mousePressEvent().

virtual void Layer::eraseDrag ( LayerGeometryProvider *  ,
QMouseEvent *   
)
inlinevirtualinherited

Reimplemented in NoteLayer, RegionLayer, TimeValueLayer, BoxLayer, FlexiNoteLayer, TimeInstantLayer, and TextLayer.

Definition at line 269 of file Layer.h.

Referenced by Pane::mouseMoveEvent().

virtual void Layer::eraseEnd ( LayerGeometryProvider *  ,
QMouseEvent *   
)
inlinevirtualinherited

Reimplemented in NoteLayer, RegionLayer, TimeValueLayer, BoxLayer, FlexiNoteLayer, TimeInstantLayer, and TextLayer.

Definition at line 270 of file Layer.h.

Referenced by Pane::mouseReleaseEvent().

virtual void Layer::splitStart ( LayerGeometryProvider *  ,
QMouseEvent *   
)
inlinevirtualinherited

Reimplemented in FlexiNoteLayer.

Definition at line 276 of file Layer.h.

Referenced by Pane::mousePressEvent().

virtual void Layer::splitEnd ( LayerGeometryProvider *  ,
QMouseEvent *   
)
inlinevirtualinherited

Reimplemented in FlexiNoteLayer.

Definition at line 277 of file Layer.h.

Referenced by Pane::mouseReleaseEvent().

virtual void Layer::addNote ( LayerGeometryProvider *  ,
QMouseEvent *   
)
inlinevirtualinherited

Reimplemented in FlexiNoteLayer.

Definition at line 278 of file Layer.h.

References Layer::measureDoubleClick(), Layer::measureDrag(), Layer::measureEnd(), and Layer::measureStart().

Referenced by Pane::mouseDoubleClickEvent().

void Layer::measureStart ( LayerGeometryProvider *  v,
QMouseEvent *  e 
)
virtualinherited

Definition at line 390 of file Layer.cpp.

References Layer::MeasureRect::endFrame, LayerGeometryProvider::getFrameForX(), Layer::hasTimeXAxis(), Layer::MeasureRect::haveFrames, Layer::m_draggingRect, Layer::m_haveDraggingRect, Layer::MeasureRect::pixrect, Layer::setMeasureRectYCoord(), and Layer::MeasureRect::startFrame.

Referenced by Layer::addNote(), and Pane::mousePressEvent().

void Layer::measureDrag ( LayerGeometryProvider *  v,
QMouseEvent *  e 
)
virtualinherited

Definition at line 414 of file Layer.cpp.

References Layer::MeasureRect::endFrame, LayerGeometryProvider::getFrameForX(), Layer::MeasureRect::haveFrames, Layer::m_draggingRect, Layer::m_haveDraggingRect, Layer::MeasureRect::pixrect, and Layer::setMeasureRectYCoord().

Referenced by Layer::addNote(), Layer::measureEnd(), and Pane::mouseMoveEvent().

void Layer::measureEnd ( LayerGeometryProvider *  v,
QMouseEvent *  e 
)
virtualinherited

Definition at line 430 of file Layer.cpp.

References CommandHistory::addCommand(), CommandHistory::getInstance(), Layer::m_draggingRect, Layer::m_haveDraggingRect, Layer::measureDrag(), and Layer::MeasureRect::pixrect.

Referenced by Layer::addNote(), and Pane::mouseReleaseEvent().

void Layer::measureDoubleClick ( LayerGeometryProvider *  ,
QMouseEvent *   
)
virtualinherited

Reimplemented in SpectrogramLayer.

Definition at line 444 of file Layer.cpp.

Referenced by Layer::addNote(), and Pane::mouseDoubleClickEvent().

virtual bool Layer::haveCurrentMeasureRect ( ) const
inlinevirtualinherited

Definition at line 289 of file Layer.h.

References Layer::deleteCurrentMeasureRect(), and Layer::m_haveCurrentMeasureRect.

void Layer::deleteCurrentMeasureRect ( )
virtualinherited

Definition at line 450 of file Layer.cpp.

References CommandHistory::addCommand(), Layer::findFocusedMeasureRect(), CommandHistory::getInstance(), Layer::m_currentMeasureRectPoint, Layer::m_haveCurrentMeasureRect, and Layer::m_measureRects.

Referenced by Layer::haveCurrentMeasureRect().

virtual bool Layer::isLayerOpaque ( ) const
inlinevirtualinherited

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

It's used to determine whether the view can safely draw any selection rectangles under the layer instead of over it, in the case where the layer is not scrollable and therefore needs to be redrawn each time (so that the selection rectangle can be cached).

Reimplemented in SpectrogramLayer.

Definition at line 346 of file Layer.h.

Referenced by Pane::drawVerticalScale().

virtual QString Layer::getError ( LayerGeometryProvider *  ) const
inlinevirtualinherited

Return an error string if any errors have occurred while loading or processing data for the given view.

Return the empty string if no error has occurred.

Reimplemented in SpectrogramLayer.

Definition at line 398 of file Layer.h.

References Layer::addMeasurementRect(), Layer::getPlayParameters(), Layer::isLayerDormant(), Layer::setLayerDormant(), Layer::setObjectName(), Layer::setProperties(), Layer::toBriefXml(), and Layer::toXml().

void Layer::setObjectName ( const QString &  name)
virtualinherited

Definition at line 122 of file Layer.cpp.

References Layer::layerNameChanged().

Referenced by LayerFactory::createLayer(), and Layer::getError().

void Layer::toBriefXml ( QTextStream &  stream,
QString  indent = "",
QString  extraAttributes = "" 
) const
virtualinherited

Produce XML containing the layer's ID and type.

This is used to refer to the layer in the display section of the SV session file, for a layer that has already been described in the data section.

Definition at line 691 of file Layer.cpp.

References LayerFactory::getInstance(), Layer::getModel(), and Layer::m_presentationName.

Referenced by Layer::getError().

void Layer::addMeasurementRect ( const QXmlAttributes &  attributes)
virtualinherited

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

Does not use a command.

Definition at line 333 of file Layer.cpp.

References Layer::addMeasureRectToSet(), Layer::MeasureRect::endFrame, Layer::MeasureRect::endY, Layer::MeasureRect::haveFrames, Layer::MeasureRect::pixrect, Layer::MeasureRect::startFrame, and Layer::MeasureRect::startY.

Referenced by Layer::getError().

bool Layer::isLayerDormant ( const LayerGeometryProvider *  v) const
virtualinherited

Return whether the layer is dormant (i.e.

hidden) in the given view.

Definition at line 144 of file Layer.cpp.

References Layer::m_dormancy, and Layer::m_dormancyMutex.

Referenced by LayerTreeModel::data(), Pane::drawVerticalScale(), Layer::getError(), View::getInteractionLayer(), View::getScaleProvidingLayerForUnit(), View::getVisibleExtentsForAnyUnit(), PropertyStack::propertyContainerPropertyChanged(), PropertyStack::repopulate(), Colour3DPlotLayer::setLayerDormant(), and SpectrogramLayer::setLayerDormant().

std::shared_ptr< PlayParameters > Layer::getPlayParameters ( )
overrideinherited

Return the play parameters for this layer, if any.

The return value is a shared_ptr that can be passed to (e.g.) PlayParameterRepository::EditCommand to change the parameters.

Definition at line 129 of file Layer.cpp.

References Layer::getModel().

Referenced by LayerTreeModel::data(), Layer::getError(), LayerTreeModel::LayerTreeModel(), LayerTreeModel::playParametersAudibilityChanged(), and LayerTreeModel::setData().

virtual bool Layer::needsTextLabelHeight ( ) const
inlinevirtualinherited

True if this layer will need to place text labels when it is painted.

The view will take into account how many layers are requesting this, and will provide a distinct y-coord to each layer on request via View::getTextLabelHeight().

Reimplemented in TimeValueLayer, SpectrumLayer, and TimeInstantLayer.

Definition at line 468 of file Layer.h.

virtual bool Layer::hasTimeXAxis ( ) const
inlinevirtualinherited

Return true if the X axis on the layer is time proportional to audio frames, false otherwise.

Almost all layer types return true here: the exceptions are spectrum and slice layers.

Reimplemented in SliceLayer.

Definition at line 475 of file Layer.h.

Referenced by Layer::getXScaleValue(), Layer::measureStart(), Pane::mouseMoveEvent(), Layer::setMeasureRectFromPixrect(), and Pane::zoomToRegion().

virtual void Layer::zoomToRegion ( const LayerGeometryProvider *  ,
QRect   
)
inlinevirtualinherited

Update the X and Y axis scales, where appropriate, to focus on the given rectangular region.

This should only be overridden by layers whose hasTimeXAxis() returns false - the pane handles zooming appropriately in every "normal" case.

Reimplemented in SliceLayer.

Definition at line 483 of file Layer.h.

References Layer::getValueExtents().

Referenced by Pane::zoomToRegion().

virtual bool Layer::getDisplayExtents ( double &  ,
double &   
) const
inlinevirtualinherited

Return the minimum and maximum values within the visible area for the y axis of this layer.

Return false if the layer has no display extents of its own. This could be because the layer is "auto-aligning" against another layer with the same units elsewhere in the view, or because the layer has no concept of a vertical scale at all.

Reimplemented in SpectrogramLayer, WaveformLayer, Colour3DPlotLayer, TimeValueLayer, FlexiNoteLayer, RegionLayer, NoteLayer, BoxLayer, and SliceLayer.

Definition at line 509 of file Layer.h.

Referenced by View::getScaleProvidingLayerForUnit(), Pane::getTopLayerDisplayExtents(), View::getVisibleExtentsForAnyUnit(), and View::getVisibleExtentsForUnit().

virtual bool Layer::setDisplayExtents ( double  ,
double   
)
inlinevirtualinherited

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

Return false if not supported on this layer (and set nothing). In most cases, layers that return false for getDisplayExtents should also return false for this function.

Reimplemented in SpectrogramLayer, Colour3DPlotLayer, TimeValueLayer, FlexiNoteLayer, NoteLayer, SpectrumLayer, and SliceLayer.

Definition at line 521 of file Layer.h.

Referenced by Pane::setTopLayerDisplayExtents(), FlexiNoteLayer::setVerticalRangeToNoteRange(), and Pane::zoomToRegion().

virtual bool Layer::adoptExtents ( double  ,
double  ,
QString   
)
inlinevirtualinherited

Consider using the given value extents and units for this layer.

This may be called on a new layer when added, to prepare it for editing, and the extents are those of the layer underneath it. May not be appropriate for most layer types.

Reimplemented in BoxLayer.

Definition at line 532 of file Layer.h.

References Layer::getXScaleValue().

bool Layer::getXScaleValue ( const LayerGeometryProvider *  v,
int  x,
double &  value,
QString &  unit 
) const
virtualinherited

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

This is for descriptive purposes using the measurement tool. The default implementation works correctly if the layer hasTimeXAxis().

Reimplemented in SpectrumLayer.

Definition at line 160 of file Layer.cpp.

References LayerGeometryProvider::getFrameForX(), Layer::getModel(), and Layer::hasTimeXAxis().

Referenced by Layer::adoptExtents(), and View::drawMeasurementRect().

virtual bool Layer::getYScaleValue ( const LayerGeometryProvider *  ,
int  ,
double &  ,
QString &   
) const
inlinevirtualinherited

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

Reimplemented in SpectrogramLayer, WaveformLayer, Colour3DPlotLayer, and SpectrumLayer.

Definition at line 550 of file Layer.h.

References Layer::getYScaleDifference().

Referenced by View::drawMeasurementRect(), and Layer::getYScaleDifference().

bool Layer::getYScaleDifference ( const LayerGeometryProvider *  v,
int  y0,
int  y1,
double &  diff,
QString &  unit 
) const
virtualinherited

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

The default implementation just calls getYScaleValue twice and returns the difference, with the same unit.

Reimplemented in WaveformLayer, and SpectrumLayer.

Definition at line 173 of file Layer.cpp.

References Layer::getYScaleValue().

Referenced by View::drawMeasurementRect(), SpectrumLayer::getYScaleDifference(), and Layer::getYScaleValue().

virtual int Layer::getVerticalZoomSteps ( int &  ) const
inlinevirtualinherited

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

If vertical zooming is not available, return 0. The meaning of "zooming" is entirely up to the layer – changing the zoom level may cause the layer to reset its display extents or change another property such as display gain. However, layers are advised for consistency to treat smaller zoom steps as "more distant" or "zoomed out" and larger ones as "closer" or "zoomed in".

Layers that provide this facility should also emit the verticalZoomChanged signal if their vertical zoom changes due to factors other than setVerticalZoomStep being called.

Reimplemented in SpectrogramLayer, WaveformLayer, Colour3DPlotLayer, TimeValueLayer, FlexiNoteLayer, NoteLayer, and SliceLayer.

Definition at line 578 of file Layer.h.

Referenced by Pane::updateHeadsUpDisplay(), Pane::updateVerticalPanner(), and Pane::verticalThumbwheelMoved().

virtual int Layer::getCurrentVerticalZoomStep ( ) const
inlinevirtualinherited

Get the current vertical zoom step.

A layer may support finer control over ranges etc than is available through the integer zoom step mechanism; if this one does, it should just return the nearest of the available zoom steps to the current settings.

Reimplemented in SpectrogramLayer, WaveformLayer, Colour3DPlotLayer, TimeValueLayer, FlexiNoteLayer, NoteLayer, and SliceLayer.

Definition at line 586 of file Layer.h.

Referenced by Pane::updateHeadsUpDisplay(), and Pane::verticalZoomChanged().

virtual void Layer::setVerticalZoomStep ( int  )
inlinevirtualinherited

Set the vertical zoom step.

The meaning of "zooming" is entirely up to the layer – changing the zoom level may cause the layer to reset its display extents or change another property such as display gain.

Reimplemented in SpectrogramLayer, WaveformLayer, Colour3DPlotLayer, TimeValueLayer, FlexiNoteLayer, NoteLayer, and SliceLayer.

Definition at line 594 of file Layer.h.

Referenced by Pane::verticalThumbwheelMoved().

virtual RangeMapper* Layer::getNewVerticalZoomRangeMapper ( ) const
inlinevirtualinherited

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

See the RangeMapper documentation for more details. The returned value is allocated on the heap and will be deleted by the caller.

Reimplemented in SpectrogramLayer, Colour3DPlotLayer, TimeValueLayer, FlexiNoteLayer, NoteLayer, and SliceLayer.

Definition at line 602 of file Layer.h.

Referenced by Pane::propertyContainerSelected(), and Pane::updateHeadsUpDisplay().

virtual bool Layer::canExistWithoutModel ( ) const
inlinevirtualinherited

Return true if this layer type can function without a model being set.

If false (the default), the layer will not be loaded from a session if its model cannot be found.

Reimplemented in WaveformLayer, and TimeRulerLayer.

Definition at line 609 of file Layer.h.

References Layer::alignFromReference(), Layer::alignToReference(), Layer::clipboardHasDifferentAlignment(), Layer::connectSignals(), Layer::layerMeasurementRectsChanged(), Layer::layerNameChanged(), Layer::layerParameterRangesChanged(), Layer::layerParametersChanged(), Layer::modelAlignmentCompletionChanged(), Layer::modelChanged(), Layer::modelChangedWithin(), Layer::modelCompletionChanged(), Layer::modelReplaced(), Layer::showLayer(), and Layer::verticalZoomChanged().

void Layer::showLayer ( LayerGeometryProvider *  view,
bool  show 
)
slotinherited

Change the visibility status (dormancy) of the layer in the given view.

Definition at line 153 of file Layer.cpp.

References Layer::layerParametersChanged(), and Layer::setLayerDormant().

Referenced by Layer::canExistWithoutModel(), ShowLayerCommand::execute(), LayerTreeModel::setData(), and ShowLayerCommand::unexecute().

void Layer::modelChanged ( ModelId  )
signalinherited

Referenced by Layer::canExistWithoutModel(), Layer::connectSignals(), fileSourceReady(), Colour3DPlotLayer::handleModelChanged(), RegionLayer::setModel(), Colour3DPlotLayer::setModel(), SpectrogramLayer::setModel(), BoxLayer::setProperty(), TimeValueLayer::setProperty(), RegionLayer::setProperty(), NoteLayer::setProperty(), and FlexiNoteLayer::setProperty().

void Layer::modelCompletionChanged ( ModelId  )
signalinherited

Referenced by Layer::canExistWithoutModel(), and Layer::connectSignals().

void Layer::modelAlignmentCompletionChanged ( ModelId  )
signalinherited

Referenced by Layer::canExistWithoutModel(), and Layer::connectSignals().

void Layer::modelChangedWithin ( ModelId  ,
sv_frame_t  startFrame,
sv_frame_t  endFrame 
)
signalinherited

Referenced by Layer::canExistWithoutModel(), Layer::connectSignals(), Colour3DPlotLayer::handleModelChangedWithin(), Colour3DPlotLayer::setModel(), and SpectrogramLayer::setModel().

void Layer::modelReplaced ( )
signalinherited

Referenced by Layer::canExistWithoutModel(), TimeRulerLayer::setModel(), WaveformLayer::setModel(), TextLayer::setModel(), setModel(), TimeInstantLayer::setModel(), BoxLayer::setModel(), TimeValueLayer::setModel(), Colour3DPlotLayer::setModel(), RegionLayer::setModel(), NoteLayer::setModel(), FlexiNoteLayer::setModel(), SpectrogramLayer::setModel(), and SliceLayer::setSliceableModel().

void Layer::layerParametersChanged ( )
signalinherited

Referenced by Layer::canExistWithoutModel(), SpectrogramLayer::preferenceChanged(), WaveformLayer::setAggressiveCacheing(), WaveformLayer::setAutoNormalize(), SingleColourLayer::setBaseColour(), SpectrogramLayer::setBinDisplay(), SliceLayer::setBinScale(), Colour3DPlotLayer::setBinScale(), SpectrogramLayer::setBinScale(), SpectrumLayer::setChannel(), SpectrogramLayer::setChannel(), WaveformLayer::setChannel(), WaveformLayer::setChannelMode(), Colour3DPlotLayer::setColourMap(), SpectrogramLayer::setColourMap(), SpectrogramLayer::setColourRotation(), Colour3DPlotLayer::setColourScale(), SpectrogramLayer::setColourScale(), SpectrogramLayer::setColourScaleMultiple(), SliceLayer::setDisplayExtents(), NoteLayer::setDisplayExtents(), FlexiNoteLayer::setDisplayExtents(), TimeValueLayer::setDisplayExtents(), Colour3DPlotLayer::setDisplayExtents(), SpectrogramLayer::setDisplayExtents(), TimeValueLayer::setDrawSegmentDivisions(), SliceLayer::setEnergyScale(), TimeValueLayer::setFillColourMap(), RegionLayer::setFillColourMap(), SliceLayer::setFillColourMap(), WaveformLayer::setGain(), Colour3DPlotLayer::setGain(), SliceLayer::setGain(), SpectrogramLayer::setGain(), Colour3DPlotLayer::setInvertVertical(), SpectrogramLayer::setMaxFrequency(), WaveformLayer::setMiddleLineHeight(), SpectrogramLayer::setMinFrequency(), SpectrumLayer::setModel(), WaveformLayer::setModel(), Colour3DPlotLayer::setNormalization(), SpectrogramLayer::setNormalization(), SliceLayer::setNormalize(), Colour3DPlotLayer::setNormalizeVisibleArea(), SpectrogramLayer::setNormalizeVisibleArea(), Colour3DPlotLayer::setOpaque(), SpectrumLayer::setOversampling(), SpectrogramLayer::setOversampling(), TimeInstantLayer::setPlotStyle(), SliceLayer::setPlotStyle(), TimeValueLayer::setPlotStyle(), RegionLayer::setPlotStyle(), SliceLayer::setSamplingMode(), WaveformLayer::setScale(), TimeValueLayer::setShowDerivative(), WaveformLayer::setShowMeans(), SpectrumLayer::setShowPeaks(), SliceLayer::setSliceableModel(), Colour3DPlotLayer::setSmooth(), SliceLayer::setThreshold(), SpectrogramLayer::setThreshold(), BoxLayer::setVerticalScale(), NoteLayer::setVerticalScale(), RegionLayer::setVerticalScale(), FlexiNoteLayer::setVerticalScale(), TimeValueLayer::setVerticalScale(), Colour3DPlotLayer::setVerticalZoomStep(), SpectrumLayer::setWindowHopLevel(), SpectrogramLayer::setWindowHopLevel(), SpectrumLayer::setWindowSize(), SpectrogramLayer::setWindowSize(), SpectrumLayer::setWindowType(), SpectrogramLayer::setWindowType(), and Layer::showLayer().

void Layer::layerParameterRangesChanged ( )
signalinherited

Referenced by Layer::canExistWithoutModel(), SliceLayer::setPlotStyle(), TimeValueLayer::setPlotStyle(), and RegionLayer::setPlotStyle().

void Layer::layerMeasurementRectsChanged ( )
signalinherited

Referenced by Layer::addMeasureRectToSet(), Layer::canExistWithoutModel(), and Layer::deleteMeasureRectFromSet().

void Layer::layerNameChanged ( )
signalinherited

Referenced by Layer::canExistWithoutModel(), and Layer::setObjectName().

void Layer::verticalZoomChanged ( )
signalinherited

Referenced by Layer::canExistWithoutModel(), SpectrogramLayer::setDisplayExtents(), WaveformLayer::setGain(), and SpectrogramLayer::setProperty().

void Layer::connectSignals ( ModelId  modelId)
protectedinherited

Definition at line 49 of file Layer.cpp.

References Layer::modelAlignmentCompletionChanged(), Layer::modelChanged(), Layer::modelChangedWithin(), and Layer::modelCompletionChanged().

Referenced by Layer::canExistWithoutModel(), WaveformLayer::setModel(), TextLayer::setModel(), setModel(), TimeInstantLayer::setModel(), BoxLayer::setModel(), TimeValueLayer::setModel(), Colour3DPlotLayer::setModel(), RegionLayer::setModel(), NoteLayer::setModel(), FlexiNoteLayer::setModel(), SpectrogramLayer::setModel(), and SliceLayer::setSliceableModel().

sv_frame_t Layer::alignToReference ( LayerGeometryProvider *  v,
sv_frame_t  frame 
) const
protectedvirtualinherited

Definition at line 187 of file Layer.cpp.

References View::alignToReference(), Layer::getModel(), and LayerGeometryProvider::getView().

Referenced by Layer::canExistWithoutModel(), Layer::clipboardHasDifferentAlignment(), TextLayer::copy(), copy(), TimeInstantLayer::copy(), BoxLayer::copy(), TimeValueLayer::copy(), RegionLayer::copy(), FlexiNoteLayer::copy(), and NoteLayer::copy().

sv_frame_t Layer::alignFromReference ( LayerGeometryProvider *  v,
sv_frame_t  frame 
) const
protectedvirtualinherited

Definition at line 198 of file Layer.cpp.

References View::alignFromReference(), Layer::getModel(), and LayerGeometryProvider::getView().

Referenced by Layer::canExistWithoutModel(), TextLayer::paste(), paste(), TimeInstantLayer::paste(), BoxLayer::paste(), TimeValueLayer::paste(), RegionLayer::paste(), FlexiNoteLayer::paste(), and NoteLayer::paste().

bool Layer::clipboardHasDifferentAlignment ( LayerGeometryProvider *  v,
const Clipboard &  clip 
) const
protectedinherited

Definition at line 209 of file Layer.cpp.

References Layer::alignToReference().

Referenced by Layer::canExistWithoutModel(), TextLayer::paste(), paste(), TimeInstantLayer::paste(), BoxLayer::paste(), TimeValueLayer::paste(), RegionLayer::paste(), FlexiNoteLayer::paste(), and NoteLayer::paste().

void Layer::addMeasureRectToSet ( const MeasureRect &  r)
inlineprotectedinherited

Definition at line 682 of file Layer.h.

References Layer::layerMeasurementRectsChanged(), and Layer::m_measureRects.

Referenced by Layer::addMeasurementRect().

void Layer::deleteMeasureRectFromSet ( const MeasureRect &  r)
inlineprotectedinherited

Definition at line 687 of file Layer.h.

References Layer::layerMeasurementRectsChanged(), and Layer::m_measureRects.

void Layer::updateMeasurePixrects ( LayerGeometryProvider *  v) const
protectedinherited

Definition at line 507 of file Layer.cpp.

References LayerGeometryProvider::getEndFrame(), LayerGeometryProvider::getStartFrame(), LayerGeometryProvider::getXForFrame(), Layer::m_measureRects, and Layer::updateMeasureRectYCoords().

Referenced by Layer::nearestMeasurementRectChanged(), and Layer::paintMeasurementRects().

void Layer::updateMeasureRectYCoords ( LayerGeometryProvider *  v,
const MeasureRect &  r 
) const
protectedvirtualinherited

Reimplemented in SpectrogramLayer.

Definition at line 546 of file Layer.cpp.

References Layer::MeasureRect::endY, LayerGeometryProvider::getPaintHeight(), Layer::MeasureRect::pixrect, and Layer::MeasureRect::startY.

Referenced by Layer::updateMeasurePixrects().

void Layer::setMeasureRectYCoord ( LayerGeometryProvider *  v,
MeasureRect &  r,
bool  start,
int  y 
) const
protectedvirtualinherited

Reimplemented in SpectrogramLayer.

Definition at line 554 of file Layer.cpp.

References Layer::MeasureRect::endY, LayerGeometryProvider::getPaintHeight(), and Layer::MeasureRect::startY.

Referenced by Layer::measureDrag(), Layer::measureStart(), and Layer::setMeasureRectFromPixrect().

void Layer::setMeasureRectFromPixrect ( LayerGeometryProvider *  v,
MeasureRect &  r,
QRect  pixrect 
) const
protectedvirtualinherited

Definition at line 565 of file Layer.cpp.

References Layer::MeasureRect::endFrame, LayerGeometryProvider::getFrameForX(), Layer::hasTimeXAxis(), Layer::MeasureRect::haveFrames, Layer::MeasureRect::pixrect, Layer::setMeasureRectYCoord(), and Layer::MeasureRect::startFrame.

Referenced by SpectrogramLayer::measureDoubleClick().

Layer::MeasureRectSet::const_iterator Layer::findFocusedMeasureRect ( QPoint  focusPoint) const
protectedinherited

Definition at line 578 of file Layer.cpp.

References Layer::m_measureRects.

Referenced by Layer::deleteCurrentMeasureRect(), Layer::nearestMeasurementRectChanged(), and Layer::paintMeasurementRects().

void Layer::paintMeasurementRect ( LayerGeometryProvider *  v,
QPainter &  paint,
const MeasureRect &  r,
bool  focus 
) const
protectedinherited

Definition at line 605 of file Layer.cpp.

References LayerGeometryProvider::drawMeasurementRect(), Layer::MeasureRect::endFrame, LayerGeometryProvider::getEndFrame(), LayerGeometryProvider::getPaintWidth(), LayerGeometryProvider::getStartFrame(), LayerGeometryProvider::getXForFrame(), Layer::MeasureRect::haveFrames, Layer::MeasureRect::pixrect, and Layer::MeasureRect::startFrame.

Referenced by Layer::paintMeasurementRects().

bool Layer::valueExtentsMatchMine ( LayerGeometryProvider *  v) const
protectedinherited

Definition at line 628 of file Layer.cpp.

References Layer::getValueExtents(), and LayerGeometryProvider::getVisibleExtentsForUnit().

Referenced by TimeValueLayer::getVerticalScaleWidth(), and NoteLayer::getVerticalScaleWidth().

Member Data Documentation

ImageLayer::ImageMap ImageLayer::m_images
staticprotected

Definition at line 124 of file ImageLayer.h.

Referenced by fileSourceReady(), getImage(), getImageOriginalSize(), and setLayerDormant().

ImageLayer::FileSourceMap ImageLayer::m_fileSources
staticprotected

Definition at line 125 of file ImageLayer.h.

Referenced by addImage(), checkAddSource(), checkAddSourceAndConnect(), fileSourceReady(), getLocalFilename(), and ~ImageLayer().

QMutex ImageLayer::m_staticMutex
staticprotected

Definition at line 126 of file ImageLayer.h.

Referenced by addImage(), checkAddSource(), checkAddSourceAndConnect(), fileSourceReady(), getImage(), getImageOriginalSize(), isImageFileSupported(), and setLayerDormant().

ViewImageMap ImageLayer::m_scaled
mutableprotected

Definition at line 128 of file ImageLayer.h.

Referenced by fileSourceReady(), getImage(), getLocalPoints(), and setLayerDormant().

ModelId ImageLayer::m_model
protected

Definition at line 134 of file ImageLayer.h.

Referenced by addImage(), checkAddSources(), copy(), deleteSelection(), drawDrag(), drawEnd(), drawStart(), editDrag(), editEnd(), editOpen(), editStart(), getCompletion(), getFeatureDescription(), getLocalPoints(), getModel(), moveSelection(), paint(), paste(), resizeSelection(), setModel(), and snapToFeatureFrame().

bool ImageLayer::m_editing
protected

Definition at line 135 of file ImageLayer.h.

Referenced by drawDrag(), drawEnd(), drawStart(), editDrag(), editEnd(), and editStart().

QPoint ImageLayer::m_editOrigin
protected

Definition at line 136 of file ImageLayer.h.

Referenced by editDrag(), and editStart().

Event ImageLayer::m_originalPoint
protected

Definition at line 137 of file ImageLayer.h.

Referenced by drawStart(), editDrag(), and editStart().

Event ImageLayer::m_editingPoint
protected

Definition at line 138 of file ImageLayer.h.

Referenced by drawDrag(), drawEnd(), drawStart(), editDrag(), and editStart().

ChangeEventsCommand* ImageLayer::m_editingCommand
protected

Definition at line 139 of file ImageLayer.h.

Referenced by drawDrag(), drawEnd(), drawStart(), editDrag(), editEnd(), and editStart().

MeasureRectSet Layer::m_measureRects
protectedinherited

Definition at line 693 of file Layer.h.

Referenced by Layer::addMeasureRectToSet(), Layer::deleteCurrentMeasureRect(), Layer::deleteMeasureRectFromSet(), Layer::findFocusedMeasureRect(), Layer::paintMeasurementRects(), Layer::toXml(), and Layer::updateMeasurePixrects().

MeasureRect Layer::m_draggingRect
protectedinherited

Definition at line 694 of file Layer.h.

Referenced by Layer::measureDrag(), Layer::measureEnd(), Layer::measureStart(), and Layer::paintMeasurementRects().

bool Layer::m_haveDraggingRect
protectedinherited

Definition at line 695 of file Layer.h.

Referenced by Layer::measureDrag(), Layer::measureEnd(), Layer::measureStart(), and Layer::paintMeasurementRects().

bool Layer::m_haveCurrentMeasureRect
mutableprotectedinherited

Definition at line 696 of file Layer.h.

Referenced by Layer::deleteCurrentMeasureRect(), Layer::haveCurrentMeasureRect(), and Layer::paintMeasurementRects().

QPoint Layer::m_currentMeasureRectPoint
mutableprotectedinherited

Definition at line 697 of file Layer.h.

Referenced by Layer::deleteCurrentMeasureRect(), and Layer::paintMeasurementRects().

QString Layer::m_presentationName
protectedinherited

Definition at line 716 of file Layer.h.

Referenced by Layer::getLayerPresentationName(), Layer::getPropertyContainerName(), Layer::isPresentationNameSet(), Layer::setPresentationName(), Layer::toBriefXml(), and Layer::toXml().

The documentation for this class was generated from the following files:
Generated by   doxygen 1.8.11