jack2 codebase
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

189 lines
6.6KB

  1. /*
  2. Copyright (C) 2001 Paul Davis
  3. Copyright (C) 2004-2006 Grame
  4. This program is free software; you can redistribute it and/or modify
  5. it under the terms of the GNU General Public License as published by
  6. the Free Software Foundation; either version 2 of the License, or
  7. (at your option) any later version.
  8. This program is distributed in the hope that it will be useful,
  9. but WITHOUT ANY WARRANTY; without even the implied warranty of
  10. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  11. GNU General Public License for more details.
  12. You should have received a copy of the GNU General Public License
  13. along with this program; if not, write to the Free Software
  14. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  15. */
  16. #ifndef __JackClient__
  17. #define __JackClient__
  18. #include "JackClientInterface.h"
  19. #include "JackThread.h"
  20. #include "JackConstants.h"
  21. #include "JackSynchro.h"
  22. #include "types.h"
  23. #include "transport_types.h"
  24. #include "varargs.h"
  25. #include <list>
  26. namespace Jack
  27. {
  28. class JackClientChannelInterface;
  29. class JackGraphManager;
  30. class JackServer;
  31. class JackEngine;
  32. class JackSynchro;
  33. struct JackClientControl;
  34. struct JackEngineControl;
  35. class JackSyncInterface;
  36. typedef void (*JackShutdownCallback)(void *arg);
  37. /*!
  38. \brief The base class for clients: share part of the implementation for JackInternalClient and JackLibClient.
  39. */
  40. class JackClient : public JackClientInterface, public JackRunnableInterface
  41. {
  42. protected:
  43. JackProcessCallback fProcess;
  44. JackGraphOrderCallback fGraphOrder;
  45. JackXRunCallback fXrun;
  46. JackShutdownCallback fShutdown;
  47. JackThreadInitCallback fInit;
  48. JackBufferSizeCallback fBufferSize;
  49. JackClientRegistrationCallback fClientRegistration;
  50. JackFreewheelCallback fFreewheel;
  51. JackPortRegistrationCallback fPortRegistration;
  52. JackPortConnectCallback fPortConnect;
  53. JackTimebaseCallback fTimebase;
  54. JackSyncCallback fSync;
  55. void* fProcessArg;
  56. void* fGraphOrderArg;
  57. void* fXrunArg;
  58. void* fShutdownArg;
  59. void* fInitArg;
  60. void* fBufferSizeArg;
  61. void* fClientRegistrationArg;
  62. void* fFreewheelArg;
  63. void* fPortRegistrationArg;
  64. void* fPortConnectArg;
  65. void* fTimebaseArg;
  66. void* fSyncArg;
  67. int fConditionnal;
  68. char fServerName[64];
  69. JackThread* fThread; /*! Thread to execute the Process function */
  70. JackClientChannelInterface* fChannel;
  71. JackSynchro** fSynchroTable;
  72. std::list<jack_port_id_t> fPortList;
  73. int StartThread();
  74. void SetupDriverSync(bool freewheel);
  75. bool IsActive();
  76. void CallSyncCallback();
  77. void CallTimebaseCallback();
  78. int RequestNewPos(jack_position_t* pos);
  79. virtual int ClientNotifyImp(int refnum, const char* name, int notify, int sync, int value1, int value);
  80. // Fons Adriaensen thread model
  81. inline bool WaitFirstSync();
  82. inline void ExecuteThread();
  83. inline bool WaitSync();
  84. inline void SignalSync();
  85. inline int CallProcessCallback();
  86. inline int End();
  87. inline int Error();
  88. public:
  89. JackClient();
  90. JackClient(JackSynchro** table);
  91. virtual ~JackClient();
  92. virtual int Open(const char* server_name, const char* name, jack_options_t options, jack_status_t* status) = 0;
  93. virtual int Close();
  94. virtual JackGraphManager* GetGraphManager() const = 0;
  95. virtual JackEngineControl* GetEngineControl() const = 0;
  96. // Notifications
  97. virtual int ClientNotify(int refnum, const char* name, int notify, int sync, int value1, int value2);
  98. virtual int Activate();
  99. virtual int Deactivate();
  100. // Context
  101. virtual int SetBufferSize(jack_nframes_t buffer_size);
  102. virtual int SetFreeWheel(int onoff);
  103. virtual void ShutDown();
  104. virtual pthread_t GetThreadID();
  105. // Port management
  106. virtual int PortRegister(const char* port_name, const char* port_type, unsigned long flags, unsigned long buffer_size);
  107. virtual int PortUnRegister(jack_port_id_t port);
  108. virtual int PortConnect(const char* src, const char* dst);
  109. virtual int PortDisconnect(const char* src, const char* dst);
  110. virtual int PortConnect(jack_port_id_t src, jack_port_id_t dst);
  111. virtual int PortDisconnect(jack_port_id_t src);
  112. virtual int PortIsMine(jack_port_id_t port_index);
  113. // Transport
  114. virtual int ReleaseTimebase();
  115. virtual int SetSyncCallback(JackSyncCallback sync_callback, void* arg);
  116. virtual int SetSyncTimeout(jack_time_t timeout);
  117. virtual int SetTimebaseCallback(int conditional, JackTimebaseCallback timebase_callback, void* arg);
  118. virtual int TransportLocate(jack_nframes_t frame);
  119. virtual jack_transport_state_t TransportQuery(jack_position_t* pos);
  120. virtual jack_nframes_t GetCurrentTransportFrame();
  121. virtual int TransportReposition(jack_position_t* pos);
  122. virtual void TransportStart();
  123. virtual void TransportStop();
  124. // Callbacks
  125. virtual void OnShutdown(JackShutdownCallback callback, void *arg);
  126. virtual int SetProcessCallback(JackProcessCallback callback, void* arg);
  127. virtual int SetXRunCallback(JackXRunCallback callback, void* arg);
  128. virtual int SetInitCallback(JackThreadInitCallback callback, void* arg);
  129. virtual int SetGraphOrderCallback(JackGraphOrderCallback callback, void* arg);
  130. virtual int SetBufferSizeCallback(JackBufferSizeCallback callback, void* arg);
  131. virtual int SetClientRegistrationCallback(JackClientRegistrationCallback callback, void* arg);
  132. virtual int SetFreewheelCallback(JackFreewheelCallback callback, void* arg);
  133. virtual int SetPortRegistrationCallback(JackPortRegistrationCallback callback, void* arg);
  134. virtual int SetPortConnectCallback(JackPortConnectCallback callback, void *arg);
  135. // Internal clients
  136. virtual char* GetInternalClientName(int ref);
  137. virtual int InternalClientHandle(const char* client_name, jack_status_t* status);
  138. virtual int InternalClientLoad(const char* client_name, jack_options_t options, jack_status_t* status, jack_varargs_t* va);
  139. virtual void InternalClientUnload(int ref, jack_status_t* status);
  140. // Fons Adriaensen thread model
  141. virtual jack_nframes_t Wait(int status);
  142. // JackRunnableInterface interface
  143. bool Init();
  144. bool Execute();
  145. };
  146. // Each "side" server and client will implement this to get the shared graph manager, engine control and inter-process synchro table.
  147. extern JackGraphManager* GetGraphManager();
  148. extern JackEngineControl* GetEngineControl();
  149. extern JackSynchro** GetSynchroTable();
  150. } // end of namespace
  151. #endif