summaryrefslogtreecommitdiffstats
path: root/src/InputInterface.h
blob: d2fcf972d8fad58acaa54c765614286953c44e01 (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
/* ------------------------------------------------------------------
 * Copyright (C) 2017 Matthias P. Braendli
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
 * express or implied.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 * -------------------------------------------------------------------
 */
/*! \section Input intefrace definition
 *
 * This describes the interface all inputs must implement.
 */

#pragma once

#include <stdint.h>
#include <stdio.h>

class InputInterface {
    public:
        /*! Open the input interface. In case of failure, throws a
         * runtime_error.
         */
        virtual void prepare(void) = 0;

        /*! Return true if the input detected some sort of fault or
         *  abnormal termination
         */
        virtual bool fault_detected(void) const = 0;

        /*! Tell the input that it shall read from source and fill the queue.
         *  The num_samples argument is an indication on how many bytes
         *  the encoder needs.
         *  Some inputs fill the queue from another thread, in which case
         *  this function might only serve as indication that data gets
         *  consumed.
         *
         *  A return value of true means data was read, a return value of
         *  false means a normal termination of the input (e.g. end of file)
         */
        virtual bool read_source(size_t num_bytes) = 0;
};