rusty_link 0.4.9

Rust bindings for Ableton Link through the official C Wrapper (abl_link)
Documentation 
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

/* Copyright 2022, Ableton AG, Berlin. All rights reserved.
 *
 *  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.
 *
 *  This program 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 General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 *  If you would like to incorporate Link into a proprietary software application,
 *  please contact <link-devs@ableton.com>.
 */


#pragma once

#include <array>
#include <atomic>
#include <cassert>
#include <cstdint>
#include <optional>

namespace ableton
{
namespace util
{

template <typename T>
struct TripleBuffer
{
public:
  TripleBuffer()
    : mBuffers{{{}, {}, {}}}
  {
    assert(mState.is_lock_free());
  }

  explicit TripleBuffer(const T& initial)
    : mBuffers{{initial, initial, initial}}
  {
    assert(mState.is_lock_free());
  }

  TripleBuffer(const TripleBuffer&) = delete;
  TripleBuffer& operator=(const TripleBuffer&) = delete;

  T read() noexcept
  {
    loadReadBuffer();
    return mBuffers[mReadIndex];
  }

  std::optional<T> readNew()
  {
    if (loadReadBuffer())
    {
      return std::optional<T>(mBuffers[mReadIndex]);
    }
    return std::nullopt;
  }

  template <typename U>
  void write(U&& value)
  {
    mBuffers[mWriteIndex] = std::forward<U>(value);

    const auto prevState =
      mState.exchange(makeState(mWriteIndex, true), std::memory_order_acq_rel);

    mWriteIndex = backIndex(prevState);
  }

private:
  bool loadReadBuffer()
  {
    auto state = mState.load(std::memory_order_acquire);
    auto isNew = isNewWrite(state);
    if (isNew)
    {
      const auto prevState =
        mState.exchange(makeState(mReadIndex, false), std::memory_order_acq_rel);

      mReadIndex = backIndex(prevState);
    }
    return isNew;
  }

  using BackingState = uint32_t;

  static constexpr bool isNewWrite(const BackingState state)
  {
    return (state & 0x0000FFFFu) != 0;
  }

  static constexpr uint32_t backIndex(const BackingState state) { return state >> 16; }

  static constexpr BackingState makeState(const uint32_t backBufferIndex,
                                          const bool isWrite)
  {
    return (backBufferIndex << 16) | uint32_t(isWrite);
  }

  std::atomic<BackingState> mState{makeState(1u, false)}; // Reader and writer
  uint32_t mReadIndex = 0u;                               // Reader only
  uint32_t mWriteIndex = 2u;                              // Writer only

  std::array<T, 3> mBuffers{};
};

} // namespace util
} // namespace ableton