|
|
|
/*
|
|
|
|
*
|
|
|
|
* $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 <tqframe.h>
|
|
|
|
#include <tqptrlist.h>
|
|
|
|
|
|
|
|
#include <k3bmsf.h>
|
|
|
|
|
|
|
|
|
|
|
|
class TQPainter;
|
|
|
|
|
|
|
|
|
|
|
|
class K3bAudioEditorWidget : public TQFrame
|
|
|
|
{
|
|
|
|
Q_OBJECT
|
|
|
|
|
|
|
|
|
|
|
|
public:
|
|
|
|
K3bAudioEditorWidget( TQWidget* parent = 0, const char* name = 0 );
|
|
|
|
~K3bAudioEditorWidget();
|
|
|
|
|
|
|
|
TQSize sizeHint() const;
|
|
|
|
TQSize 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 TQString& toolTip = TQString(),
|
|
|
|
const TQBrush& brush = TQBrush() );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* \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
|
|
|
|
*/
|
|
|
|
TQValueList<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 TQString& toolTip = TQString(), const TQColor& color = TQColor() );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @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 TQColorGroup::Highlight
|
|
|
|
*/
|
|
|
|
void setSelectedRangeBrush( const TQBrush& );
|
|
|
|
const TQBrush& 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( TQMouseEvent* e );
|
|
|
|
void mouseReleaseEvent( TQMouseEvent* e );
|
|
|
|
void mouseDoubleClickEvent( TQMouseEvent* e );
|
|
|
|
void mouseMoveEvent( TQMouseEvent* e );
|
|
|
|
void drawContents( TQPainter* );
|
|
|
|
void drawAll( TQPainter*, const TQRect& );
|
|
|
|
void drawRange( TQPainter* p, const TQRect&, Range* r );
|
|
|
|
void drawMarker( TQPainter* p, const TQRect&, 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 TQPoint& p ) const;
|
|
|
|
Range* findRangeEdge( const TQPoint& p, bool* end = 0 ) const;
|
|
|
|
Marker* findMarker( const TQPoint& p ) const;
|
|
|
|
void setSelectedRange( Range* );
|
|
|
|
|
|
|
|
int m_maxMarkers;
|
|
|
|
K3b::Msf m_length;
|
|
|
|
TQPtrList<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
|