ex_rtmidi下載ex_rtmidi源代碼下載

ex_rtmidi

其他源碼

1.0.0

下載

Exrtmidi

RTMIDI庫的長生不老藥包裝紙。部分受Python-rtmidi的啟發。

警告：該庫被認為是實驗性/阿爾帕之前的，直到解決以下一些問題。

需要幫助

如果您想提供幫助，請考慮檢查“問題”選項卡。

該庫的工作原理，但我不是C ++程序員。歡迎任何貢獻，但在這些特定領域的幫助將有很長的路要走：

C ++
- 主要的
  - src/ex_rtmidi_{output,input}.cpp可以更好地利用OOP和模板來減少代碼重複
  - 一般重構可以更好地遵循C ++約定
  - 審核安全代碼（即：避免撞擊光束）。理想情況下，在上述重構之後
    - src/ex_rtmidi_input.cpp中的input_callback和attach_listener需要一個好外觀。同樣，預先一個重構是可以選擇的
  - 審核Makefile/添加對Linux和Windows的支持作為構建目標
- 次要的
  - detach_listener如果沒有聽眾
長生不老藥
- 主要的
  - 輸入/輸出的init方法比NIF的建議需要更長的時間。請參閱lib/ex_rtmidi/{output,input}.ex註釋
- 次要的
  - 不支持RTMIDI的openVirtualPort
  - 可以添加更多用於解析消息的便利方法
  - 將Mix.Tasks.Compile.Rtmidi移出mix.exs 。請參閱mix.exs中的評論
一般的
- 主要的
  - 沒有直接的NIF的C ++測試或測試。理想情況下，將添加一個可以進行測試的Dockerfile
  - 求解上述後，應添加github ci
- 次要的
  - 添加一個碼頭工具以幫助當地開發和測試
  - 為常見用例添加示例目錄

建築學

C ++是一種OO語言，而長生不老藥不是。我對是否在功能上表達更大的表達或與OO慣例一致。最後，選擇了一種更具功能的方法。

為了創建一個RTMIDI實例，使用實例標識符調用init方法。在C ++中，實例作為一個值存儲在標識符為密鑰的地圖中。未來對RTMIDI實例方法的調用需要傳遞標識符，以了解要定位的實例。

NIFS主要是Erlang構造，因此您會看到Elixir包裝紙對Charlist進行了很多匯聚。這是因為Erlang的字符串是Elixir中的Charlist，因此NIF字符串方法實際上採用並返回Charlists而不是String.t() 。

輸入端口上的聽眾將C ++作為PID傳遞。收到消息後，NIF解析並將消息傳遞到異步到指定的PID。

為什麼？

我更喜歡長生不老藥而不是python
模式匹配的MIDI消息非常適合
長輩的過程機制（尤其是Genservers）是食用MIDI輸入的理想選擇

安裝

直到解決了一些更緊迫的C ++問題之前，我不想推廣此圖書館以供公眾使用。在此之前，您必須從Github獲得它：

 def deps do
  [
    { :ex_rtmidi , git: "https://github.com/kieraneglin/ex_rtmidi" }
  ]
end

用法

當前，該庫採取比您預期的更簡單的處理消息方法。您可能會從小型包裝器中獲得價值，這些包裝器在發送和解析針對用例的量身定制的消息中獲得了價值。

我概述了一些基本用例，但是您應該看到lib/ex_rtmidi/{output,input}.ex 。

輸出

 alias ExRtmidi.Output

{ :ok , instance } = Output . init ( :my_instance_name ) # Instance name can be whatever you want - it's unrelated to available MIDI devices

Output . get_port_count ( instance ) 
# iex> {:ok, 2}

Output . get_ports ( instance )
# iex> {:ok, ["IAC Midi", "Dummy MIDI"]}

Output . open_port ( instance , 0 ) # Or `Output.open_port(instance, "IAC Midi")`
# iex> :ok

Output . send_message ( instance , [ 0x90 , 60 , 100 ] )
# iex> :ok

Output . close_port ( instance )
# iex> :ok

消息

有一個用於MIDI消息的包裝器可以改善創建消息的體驗。這主要用於輸出，尚未移植以解構傳入消息（請參閱“需要的幫助”部分）。

有關消息的完整列表，請參見lib/ex_rtmidi/message/spec.ex 。

 alias ExRtmidi.Output
alias ExRtmidi.Message

# Assume `init` has been run and a port has been opened as in the instance above

message = Message . compose ( :note_on , channel: 0 , note: 60 , velocity: 100 )

Output . send_message ( instance , message )

輸入

 # In midi_input_server.ex
defmodule MidiInputServer do
  use GenServer

  def init ( state \ [ ] ) do
    { :ok , state }
  end

  def handle_info ( { :midi_input , midi_message } , state ) do
    IO . inspect ( midi_message )

    { :noreply , state }
  end
end

# In another file

alias ExRtmidi.Input

# Much of setup including init, listing ports, and opening a port is the same as in the Output example above.
# Setup will be omitted for brevity.  Assume we have an instance at our disposal.

{ :ok , midi_listener_pid } = GenServer . start_link ( MidiInputServer , [ ] )

# You should attach the listener before opening the port to ensure no messages get missed
Input . attach_listener ( instance , midi_listener_pid )
# iex> :ok

Input . open_port ( instance )
# iex> :ok

# Messages will be handled from this point on
# When you're done, be sure to detatch the listener before closing the port
Input . detatch_listener ( instance )
# iex> :ok

Input . close_port ( instance )
# iex> :ok