blob: 4e4b33c2fa040c2233cd23ca6c015eb5e1f79c69 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
#pragma once
#include <QString>
#include <QStringList>
#include <QtDebug>
QT_FORWARD_DECLARE_CLASS(QUrl);
#include "sources/soundsource.h"
namespace mixxx {
// Providers for the same file extension are selected according
// to the priority for which they have been registered. Only
// a single provider will be registered for each file extension
// and priority.
enum class SoundSourceProviderPriority : int {
Lowest = 1,
Lower = 2,
Default = 3,
Higher = 4,
Highest = 5,
};
QDebug operator<<(QDebug dbg, SoundSourceProviderPriority arg);
/// Factory interface for SoundSources
///
/// The implementation of a SoundSourceProvider must be thread-safe, because
/// a single instance might be accessed concurrently from different threads.
class SoundSourceProvider {
public:
virtual ~SoundSourceProvider() = default;
/// A user-readable, unique display name that identifies
/// the corresponding SoundSource.
virtual QString getDisplayName() const = 0;
/// A list of supported file extensions in any order.
virtual QStringList getSupportedFileExtensions() const = 0;
/// The default cooperative priority of this provider compared to
/// others supporting the same file extension(s). Please note that
/// an application may override the returned value to support
/// customization.
///
/// The priority may vary with the file type that is currently
/// represented by the file extension.
virtual SoundSourceProviderPriority getPriorityHint(
const QString& supportedFileExtension) const {
Q_UNUSED(supportedFileExtension)
return SoundSourceProviderPriority::Default;
}
/// Creates a new SoundSource for the file referenced by the URL.
/// This function should return a nullptr pointer if it is already
/// able to decide that the file is not supported even though it
/// has one of the supported file extensions.
virtual SoundSourcePointer newSoundSource(const QUrl& url) = 0;
};
typedef std::shared_ptr<SoundSourceProvider> SoundSourceProviderPointer;
} // namespace mixxx
|