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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
/*
* Copyright (C) 2020 Linux Studio Plugins Project <https://lsp-plug.in/>
* (C) 2020 Vladimir Sadovnikov <sadko4u@gmail.com>
*
* This file is part of lsp-ws-lib
* Created on: 16 авг. 2019 г.
*
* lsp-ws-lib is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* any later version.
*
* lsp-ws-lib is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with lsp-ws-lib. If not, see <https://www.gnu.org/licenses/>.
*/
#ifndef LSP_PLUG_IN_WS_IDATASOURCE_H_
#define LSP_PLUG_IN_WS_IDATASOURCE_H_
#include <lsp-plug.in/ws/version.h>
#include <lsp-plug.in/common/types.h>
#include <lsp-plug.in/io/IInStream.h>
namespace lsp
{
namespace ws
{
/**
* Data source interface, implements some data binding which can be present in
* different formats depending on the MIME type.
*
* This should ALWAYS be a dynamically-allocated object respectively to
* the release() method which will perform delete of the object when number of
* references reaches non-positive value.
*
* IDataSource should ALWAYS implement fetch() and sink() methods, not one of them.
*/
class LSP_WS_LIB_PUBLIC IDataSource
{
private:
IDataSource & operator = (const IDataSource &);
IDataSource(const IDataSource &);
protected:
ssize_t nReferences;
char **vMimes;
public:
explicit IDataSource(const char *const *mimes);
virtual ~IDataSource();
public:
/**
* Return NULL-terminated list of supported MIME types
* @return number of supported MIME types
*/
inline const char * const *mime_types() const { return vMimes; };
/**
* Initiate transfer of the contents of the data source to the specified data fetch.
* Fetcher may be performed in asynchronous mode
*
* @param mime requested MIME type
* @param fetch pointer to store pointer to the fetching interface
* @return status of operation
*/
virtual io::IInStream *open(const char *mime);
/**
* Acquire data source for usage
* @return number of references
*/
size_t acquire();
/**
* Get number of references to the data source
* @return number of references to the data source
*/
inline size_t references() const { return nReferences; };
/**
* Release data source
* @return number of references to the data source
*/
size_t release();
};
} /* namespace ctl */
} /* namespace lsp */
#endif /* LSP_PLUG_IN_WS_IDATASOURCE_H_ */
|
