diff options
Diffstat (limited to 'src/projects/k3baudioeditorwidget.h')
| -rw-r--r-- | src/projects/k3baudioeditorwidget.h | 220 |
1 files changed, 220 insertions, 0 deletions
diff --git a/src/projects/k3baudioeditorwidget.h b/src/projects/k3baudioeditorwidget.h new file mode 100644 index 0000000..6e939d7 --- /dev/null +++ b/src/projects/k3baudioeditorwidget.h @@ -0,0 +1,220 @@ +/* + * + * $Id: k3baudioeditorwidget.h 620140 2007-01-05 12:02:29Z trueg $ + * Copyright (C) 2004-2007 Sebastian Trueg <trueg@k3b.org> + * + * This file is part of the K3b project. + * Copyright (C) 1998-2007 Sebastian Trueg <trueg@k3b.org> + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * See the file "COPYING" for the exact licensing terms. + */ + +#ifndef _K3B_AUDIO_EDITOR_WIDGET_H_ +#define _K3B_AUDIO_EDITOR_WIDGET_H_ + +#include <qframe.h> +#include <qptrlist.h> + +#include <k3bmsf.h> + + +class QPainter; + + +class K3bAudioEditorWidget : public QFrame +{ + Q_OBJECT + + public: + K3bAudioEditorWidget( QWidget* parent = 0, const char* name = 0 ); + ~K3bAudioEditorWidget(); + + QSize sizeHint() const; + QSize minimumSizeHint() const; + + /** + * For now the Editor has only one parameter: the length data. + */ + void setLength( const K3b::Msf& length ); + + const K3b::Msf length() const; + + /** + * Add a user editable range. + * @param startFixed if true the range's start cannot be changed by the user, only with modifyRange + * @param endFixed if true the range's end cannot be changed by the user, only with modifyRange + * @param brush if not specified or it has the NoBrush style one is chosen automatically. + * + * @return -1 on error or an identifier on success (be aware that the highest value for end is length-1) + */ + int addRange( const K3b::Msf& start, const K3b::Msf& end, + bool startFixed = false, bool endFixed = false, + const QString& toolTip = QString::null, + const QBrush& brush = QBrush() ); + + /** + * \returns the identifier of the range which spans over x position \a pos or + * 0 if no range is defined in this region. + */ + int findRange( int pos ) const; + + /** + * Searches for a range edge at x position \a pos. + * \return The ranges identifier if an edge could be found or 0 if there is no + * range edge at the position. + */ + int findRangeEdge( int pos, bool* end = 0 ) const; + + /** + * @returns false if the range does not exist or end was bigger than start. + */ + bool modifyRange( int identifier, const K3b::Msf& start, const K3b::Msf& end ); + + /** + * @returns false if the range does not exist. + */ + bool removeRange( int identifier ); + + K3b::Msf rangeStart( int identifier ) const; + K3b::Msf rangeEnd( int identifier ) const; + + /** + * \return A list of all ranges' identifiers sorted ascending by start + * offset + */ + QValueList<int> allRanges() const; + + void setMaxNumberOfMarkers( int ); + + /** + * @param fixed if true the marker cannot be changed by the user, only with moveMarker + * @return -1 on error or an identifier on success. + */ + int addMarker( const K3b::Msf& pos, bool fixed = false, + const QString& toolTip = QString::null, const QColor& color = QColor() ); + + /** + * @return false if the marker does not exist. + */ + bool removeMarker( int identifier ); + + /** + * @return false if the marker does not exist. + */ + bool moveMarker( int identifier, const K3b::Msf& ); + + void enableMouseAtSignal( bool b ) { m_mouseAt = b; } + + /** + * By default ranges can overlap. If overlapping ranges are not allowed + * the editor widget will modify and delete ranges accordingly. + * + * Caution: So far setting this will not check if ranges already overlap. + */ + void setAllowOverlappingRanges( bool b ); + + /** + * Range selection is by default disabled. If it is enabled the editor visually + * highlights the last clicked range. + * + * \sa setSelectedRange + */ + void enableRangeSelection( bool b ); + + bool allowOverlappingRanges() const; + bool rangeSelectedEnabled() const; + + void setSelectedRange( int id ); + + /** + * \return The identifier of the currently selected range or 0 + * if none is selected. + */ + int selectedRange() const; + + K3b::Msf posToMsf( int x ) const; + int msfToPos( const K3b::Msf& msf ) const; + + /** + * Set the brush to paint the selected range. Default is QColorGroup::Highlight + */ + void setSelectedRangeBrush( const QBrush& ); + const QBrush& selectedRangeBrush() const; + + signals: + /** + * Emitted when enabled. + */ + void mouseAt( const K3b::Msf& ); + + /** + * Emitted when the user changed a range. + * This signal is not emitted when a range is changed via modifyRange. + */ + void rangeChanged( int identifier, const K3b::Msf& start, const K3b::Msf& end ); + void rangeRemoved( int ); + + void selectedRangeChanged( int ); + + /** + * Emitted when the user moves a marker. + * This signal is not emitted when a marker is changed via moveMarker. + */ + void markerMoved( int identifier, const K3b::Msf& pos ); + void markerAdded( int identifier, const K3b::Msf& pos ); + void markerRemoved( int identifier ); + + private: + class Range; + class RangeList; + class Marker; + class ToolTip; + + class Private; + Private* d; + + void mousePressEvent( QMouseEvent* e ); + void mouseReleaseEvent( QMouseEvent* e ); + void mouseDoubleClickEvent( QMouseEvent* e ); + void mouseMoveEvent( QMouseEvent* e ); + void drawContents( QPainter* ); + void drawAll( QPainter*, const QRect& ); + void drawRange( QPainter* p, const QRect&, Range* r ); + void drawMarker( QPainter* p, const QRect&, Marker* m ); + + /** + * Makes sure that \a r does not overlap any other range by modifying and + * deleting other ranges. + */ + void fixupOverlappingRanges( Range* r ); + + Range* getRange( int i ) const; + Marker* getMarker( int i ) const; + Range* findRange( const QPoint& p ) const; + Range* findRangeEdge( const QPoint& p, bool* end = 0 ) const; + Marker* findMarker( const QPoint& p ) const; + void setSelectedRange( Range* ); + + int m_maxMarkers; + K3b::Msf m_length; + QPtrList<Marker> m_markers; + int m_idCnt; + bool m_mouseAt; + + /** + * Margin around the timethingy + */ + int m_margin; + + Range* m_draggedRange; + bool m_draggingRangeEnd; + Marker* m_draggedMarker; + + ToolTip* m_toolTip; +}; + +#endif |