2 Copyright (C) 2002 Paul Davis
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 #ifndef __ardour_types_h__
21 #define __ardour_types_h__
26 #include <boost/shared_ptr.hpp>
27 #include <sys/types.h>
31 #include <jack/types.h>
32 #include <jack/midiport.h>
33 #include "musictime/time.h"
36 #include "ardour/bbt_time.h"
37 #include "ardour/chan_count.h"
52 typedef jack_default_audio_sample_t Sample;
55 typedef uint32_t layer_t;
56 typedef uint64_t microseconds_t;
57 typedef jack_nframes_t pframes_t;
59 /* Any position measured in audio frames.
60 Assumed to be non-negative but not enforced.
62 typedef int64_t framepos_t;
64 /* Any distance from a given framepos_t.
65 Maybe positive or negative.
67 typedef int64_t frameoffset_t;
69 /* Any count of audio frames.
70 Assumed to be positive but not enforced.
72 typedef int64_t framecnt_t;
74 static const framepos_t max_framepos = INT64_MAX;
75 static const framecnt_t max_framecnt = INT64_MAX;
77 // a set of (time) intervals: first of pair is the offset within the region, second is the length of the interval
78 typedef std::list<std::pair<frameoffset_t,framecnt_t> > AudioIntervalResult;
79 // associate a set of intervals with regions (e.g. for silence detection)
80 typedef std::map<boost::shared_ptr<ARDOUR::Region>,AudioIntervalResult> AudioIntervalMap;
86 ConfigurationChanged = 0x1,
87 ConnectionsChanged = 0x2
90 IOChange () : type (NoChange) {}
91 IOChange (Type t) : type (t) {}
93 /** channel count of IO before a ConfigurationChanged, if appropriate */
94 ARDOUR::ChanCount before;
95 /** channel count of IO after a ConfigurationChanged, if appropriate */
96 ARDOUR::ChanCount after;
100 OverlapNone, // no overlap
101 OverlapInternal, // the overlap is 100% with the object
102 OverlapStart, // overlap covers start, but ends within
103 OverlapEnd, // overlap begins within and covers end
104 OverlapExternal // overlap extends to (at least) begin+end
107 ARDOUR::OverlapType coverage (framepos_t sa, framepos_t ea,
108 framepos_t sb, framepos_t eb);
110 /* policies for inserting/pasting material where overlaps
114 enum InsertMergePolicy {
115 InsertMergeReject, // no overlaps allowed
116 InsertMergeRelax, // we just don't care about overlaps
117 InsertMergeReplace, // replace old with new
118 InsertMergeTruncateExisting, // shorten existing to avoid overlap
119 InsertMergeTruncateAddition, // shorten new to avoid overlap
120 InsertMergeExtend // extend new (or old) to the range of old+new
124 * XXX: I don't think/hope these hex values matter anymore.
126 enum AutomationType {
127 NullAutomation = 0x0,
128 GainAutomation = 0x1,
130 PluginAutomation = 0x4,
131 SoloAutomation = 0x8,
132 MuteAutomation = 0x10,
133 MidiCCAutomation = 0x20,
134 MidiPgmChangeAutomation = 0x21,
135 MidiPitchBenderAutomation = 0x22,
136 MidiChannelPressureAutomation = 0x23,
137 MidiSystemExclusiveAutomation = 0x24,
138 FadeInAutomation = 0x40,
139 FadeOutAutomation = 0x80,
140 EnvelopeAutomation = 0x100
150 std::string auto_state_to_string (AutoState);
151 AutoState string_to_auto_state (std::string);
158 std::string auto_style_to_string (AutoStyle);
159 AutoStyle string_to_auto_style (std::string);
185 AllChannels = 0, ///< Pass through all channel information unmodified
186 FilterChannels, ///< Ignore events on certain channels
187 ForceChannel ///< Force all events to a certain channel
196 enum TimecodeFormat {
219 Timecode::Time timecode;
227 AnyTime() { type = Frames; frames = 0; }
235 AudioRange (framepos_t s, framepos_t e, uint32_t i) : start (s), end (e) , id (i) {}
237 framecnt_t length() { return end - start + 1; }
239 bool operator== (const AudioRange& other) const {
240 return start == other.start && end == other.end && id == other.id;
243 bool equal (const AudioRange& other) const {
244 return start == other.start && end == other.end;
247 OverlapType coverage (framepos_t s, framepos_t e) const {
248 return ARDOUR::coverage (start, end, s, e);
257 MusicRange (BBT_Time& s, BBT_Time& e, uint32_t i)
258 : start (s), end (e), id (i) {}
260 bool operator== (const MusicRange& other) const {
261 return start == other.start && end == other.end && id == other.id;
264 bool equal (const MusicRange& other) const {
265 return start == other.start && end == other.end;
270 Slowest = 6.6dB/sec falloff at update rate of 40ms
271 Slow = 6.8dB/sec falloff at update rate of 40ms
276 MeterFalloffSlowest = 1,
277 MeterFalloffSlow = 2,
278 MeterFalloffMedium = 3,
279 MeterFalloffFast = 4,
280 MeterFalloffFaster = 5,
281 MeterFalloffFastest = 6
287 MeterHoldMedium = 100,
327 enum CrossfadeModel {
338 enum ListenPosition {
343 enum AutoConnectOption {
345 AutoConnectPhysical = 0x1,
346 AutoConnectMaster = 0x2
349 struct InterThreadInfo {
350 InterThreadInfo () : done (false), cancel (false), progress (0), thread (0) {}
353 volatile bool cancel;
354 volatile float progress;
364 enum CDMarkerFormat {
381 typedef Sample PeakDatum;
406 enum ShuttleBehaviour {
416 typedef std::vector<boost::shared_ptr<Source> > SourceList;
426 struct TimeFXRequest : public InterThreadInfo {
428 : time_fraction(0), pitch_fraction(0),
429 quick_seek(false), antialias(false), opts(0) {}
431 float pitch_fraction;
436 int opts; // really RubberBandStretcher::Options
439 typedef std::list<framepos_t> AnalysisFeatureList;
441 typedef std::list<boost::shared_ptr<Route> > RouteList;
444 typedef std::vector<boost::shared_ptr<Bundle> > BundleList;
462 struct CleanupReport {
463 std::vector<std::string> paths;
467 enum PositionLockStyle {
472 /** A struct used to describe changes to processors in a route.
473 * This is useful because objects that respond to a change in processors
474 * can optimise what work they do based on details of what has changed.
476 struct RouteProcessorChange {
479 MeterPointChange = 0x1
482 RouteProcessorChange () : type (GeneralChange), meter_visibly_changed (true)
485 RouteProcessorChange (Type t) : type (t), meter_visibly_changed (true)
488 RouteProcessorChange (Type t, bool m) : type (t), meter_visibly_changed (m)
491 /** type of change; "GeneralChange" means anything could have changed */
493 /** true if, when a MeterPointChange has occurred, the change is visible to the user */
494 bool meter_visibly_changed;
498 AutoConnectOption input_ac; /* override the RC config for input auto-connection */
499 AutoConnectOption output_ac; /* override the RC config for output auto-connection */
500 uint32_t master_out_channels; /* how many channels for the master bus */
501 uint32_t requested_physical_in; /* now many of the available physical inputs to consider usable */
502 uint32_t requested_physical_out; /* now many of the available physical inputs to consider usable */
513 } // namespace ARDOUR
516 /* these cover types declared above in this header. See enums.cc
520 std::istream& operator>>(std::istream& o, ARDOUR::SampleFormat& sf);
521 std::istream& operator>>(std::istream& o, ARDOUR::HeaderFormat& sf);
522 std::istream& operator>>(std::istream& o, ARDOUR::AutoConnectOption& sf);
523 std::istream& operator>>(std::istream& o, ARDOUR::EditMode& sf);
524 std::istream& operator>>(std::istream& o, ARDOUR::MonitorModel& sf);
525 std::istream& operator>>(std::istream& o, ARDOUR::RemoteModel& sf);
526 std::istream& operator>>(std::istream& o, ARDOUR::ListenPosition& sf);
527 std::istream& operator>>(std::istream& o, ARDOUR::LayerModel& sf);
528 std::istream& operator>>(std::istream& o, ARDOUR::InsertMergePolicy& sf);
529 std::istream& operator>>(std::istream& o, ARDOUR::CrossfadeModel& sf);
530 std::istream& operator>>(std::istream& o, ARDOUR::SyncSource& sf);
531 std::istream& operator>>(std::istream& o, ARDOUR::ShuttleBehaviour& sf);
532 std::istream& operator>>(std::istream& o, ARDOUR::ShuttleUnits& sf);
533 std::istream& operator>>(std::istream& o, ARDOUR::TimecodeFormat& sf);
534 std::istream& operator>>(std::istream& o, ARDOUR::DenormalModel& sf);
535 std::istream& operator>>(std::istream& o, ARDOUR::WaveformScale& sf);
536 std::istream& operator>>(std::istream& o, ARDOUR::WaveformShape& sf);
537 std::istream& operator>>(std::istream& o, ARDOUR::PositionLockStyle& sf);
539 std::ostream& operator<<(std::ostream& o, const ARDOUR::SampleFormat& sf);
540 std::ostream& operator<<(std::ostream& o, const ARDOUR::HeaderFormat& sf);
541 std::ostream& operator<<(std::ostream& o, const ARDOUR::AutoConnectOption& sf);
542 std::ostream& operator<<(std::ostream& o, const ARDOUR::EditMode& sf);
543 std::ostream& operator<<(std::ostream& o, const ARDOUR::MonitorModel& sf);
544 std::ostream& operator<<(std::ostream& o, const ARDOUR::RemoteModel& sf);
545 std::ostream& operator<<(std::ostream& o, const ARDOUR::ListenPosition& sf);
546 std::ostream& operator<<(std::ostream& o, const ARDOUR::LayerModel& sf);
547 std::ostream& operator<<(std::ostream& o, const ARDOUR::InsertMergePolicy& sf);
548 std::ostream& operator<<(std::ostream& o, const ARDOUR::CrossfadeModel& sf);
549 std::ostream& operator<<(std::ostream& o, const ARDOUR::SyncSource& sf);
550 std::ostream& operator<<(std::ostream& o, const ARDOUR::ShuttleBehaviour& sf);
551 std::ostream& operator<<(std::ostream& o, const ARDOUR::ShuttleUnits& sf);
552 std::ostream& operator<<(std::ostream& o, const ARDOUR::TimecodeFormat& sf);
553 std::ostream& operator<<(std::ostream& o, const ARDOUR::DenormalModel& sf);
554 std::ostream& operator<<(std::ostream& o, const ARDOUR::WaveformScale& sf);
555 std::ostream& operator<<(std::ostream& o, const ARDOUR::WaveformShape& sf);
556 std::ostream& operator<<(std::ostream& o, const ARDOUR::PositionLockStyle& sf);
558 static inline ARDOUR::framepos_t
559 session_frame_to_track_frame (ARDOUR::framepos_t session_frame, double speed)
561 return (ARDOUR::framepos_t)( (double)session_frame * speed );
564 static inline ARDOUR::framepos_t
565 track_frame_to_session_frame (ARDOUR::framepos_t track_frame, double speed)
567 return (ARDOUR::framepos_t)( (double)track_frame / speed );
570 /* for now, break the rules and use "using" to make this "global" */
572 using ARDOUR::framepos_t;
575 #endif /* __ardour_types_h__ */