468 lines
23 KiB
C++
468 lines
23 KiB
C++
//| Copyright: (C) 2020-2024 Kevin Larke <contact AT larke DOT org>
|
|
//| License: GNU GPL version 3.0 or above. See the accompanying LICENSE file.
|
|
#ifndef cwIo_h
|
|
#define cwIo_h
|
|
|
|
#include "cwTime.h"
|
|
#include "cwMidiDecls.h"
|
|
#include "cwSerialPortDecls.h"
|
|
#include "cwAudioDeviceDecls.h"
|
|
#include "cwSocketDecls.h"
|
|
#include "cwUiDecls.h"
|
|
|
|
namespace cw
|
|
{
|
|
namespace io
|
|
{
|
|
|
|
typedef handle<struct io_str> handle_t;
|
|
|
|
enum
|
|
{
|
|
kDisableFl = 0x00,
|
|
kEnableFl = 0x01,
|
|
kInFl = 0x02,
|
|
kOutFl = 0x04,
|
|
|
|
kMeterFl = 0x08
|
|
};
|
|
|
|
enum
|
|
{
|
|
kThreadTId,
|
|
kTimerTId,
|
|
kSerialTId,
|
|
kMidiTId,
|
|
kAudioTId,
|
|
kAudioMeterTId,
|
|
kSockTId,
|
|
kWebSockTId,
|
|
kUiTId,
|
|
kExecTId // callback from io::exec() which is inside the application main loop thread
|
|
};
|
|
|
|
typedef struct thread_msg_str
|
|
{
|
|
unsigned id;
|
|
void* arg;
|
|
} thread_msg_t;
|
|
|
|
typedef struct timer_msg_str
|
|
{
|
|
unsigned id; // timer id (as set in create)
|
|
unsigned index; // timer index as used by timer accessor functions
|
|
} timer_msg_t;
|
|
|
|
typedef struct serial_msg_str
|
|
{
|
|
const char* label; // label from cfg
|
|
unsigned userId; // defaults to index into internal serial cfg. array - reset vial serialDeviceSetId().
|
|
const void* dataA;
|
|
unsigned byteN;
|
|
} serial_msg_t;
|
|
|
|
typedef struct midi_msg_str
|
|
{
|
|
const midi::packet_t* pkt;
|
|
} midi_msg_t;
|
|
|
|
typedef audio::device::sample_t sample_t;
|
|
|
|
typedef struct audio_group_dev_str
|
|
{
|
|
const char* label; // User supplied label
|
|
unsigned userId; // User supplied id
|
|
const char* devName; // Audio device name
|
|
unsigned devIdx; // Audio device index
|
|
unsigned flags; // kInFl | kOutFl | kMeterFl
|
|
unsigned chIdx; // First channel of this device in i/oBufArray
|
|
unsigned chCnt; // Count of audio channels on this device
|
|
unsigned cbCnt; // Count of device driver callbacks
|
|
sample_t* meterA; // Meter values for this device.
|
|
|
|
std::atomic_uint readyCnt;// Used internally
|
|
|
|
struct audio_group_dev_str* link; //
|
|
} audio_group_dev_t;
|
|
|
|
typedef struct audio_msg_str
|
|
{
|
|
const char* label; // User provided label
|
|
unsigned groupIndex; // System supplied group index
|
|
unsigned userId; // User id
|
|
double srate; // Group sample rate.
|
|
unsigned dspFrameCnt; // Count of samples in each buffer pointed to by iBufArray[] and oBufArray[]
|
|
|
|
sample_t** iBufArray; // iBufArray[iBufChCnt] Array ptrs to buffers of size dspFrameCnt
|
|
unsigned iBufChCnt; // Count of elements in iBufArray[]
|
|
time::spec_t* iTimeStampPtr; //
|
|
audio_group_dev_t* iDevL; // Linked list of input devices which map directly to channels in iBufArray[]
|
|
|
|
sample_t** oBufArray; // oBufArray[oBufChCnt] Array of ptrs to buffers of size dspFrameCnt
|
|
unsigned oBufChCnt; //
|
|
time::spec_t* oTimeStampPtr; //
|
|
audio_group_dev_t* oDevL; // Linked list of output devices which map directly to channels in oBufArray[]
|
|
|
|
} audio_msg_t;
|
|
|
|
typedef struct socket_msg_str
|
|
{
|
|
sock::cbOpId_t cbId;
|
|
unsigned sockIdx;
|
|
unsigned userId;
|
|
unsigned connId;
|
|
const void* byteA;
|
|
unsigned byteN;
|
|
const struct sockaddr_in* srcAddr;
|
|
} socket_msg_t;
|
|
|
|
typedef struct ui_msg_str
|
|
{
|
|
ui::opId_t opId;
|
|
unsigned wsSessId;
|
|
unsigned parentAppId;
|
|
unsigned uuId;
|
|
unsigned appId;
|
|
unsigned chanId;
|
|
const ui::value_t* value;
|
|
} ui_msg_t;
|
|
|
|
typedef struct exec_msg_str
|
|
{
|
|
void* execArg;
|
|
} exec_msg_t;
|
|
|
|
typedef struct msg_str
|
|
{
|
|
unsigned tid;
|
|
bool asyncFl;
|
|
union
|
|
{
|
|
thread_msg_t* thread;
|
|
timer_msg_t* timer;
|
|
serial_msg_t* serial;
|
|
midi_msg_t* midi;
|
|
audio_msg_t* audio;
|
|
audio_group_dev_t* audioGroupDev; // audioMeterTId
|
|
socket_msg_t* sock;
|
|
ui_msg_t ui;
|
|
exec_msg_t exec;
|
|
} u;
|
|
} msg_t;
|
|
|
|
typedef rc_t (*cbFunc_t)( void* arg, const msg_t* m );
|
|
|
|
rc_t create(
|
|
handle_t& h,
|
|
const object_t* cfg, // configuration object
|
|
cbFunc_t cbFunc,
|
|
void* cbArg,
|
|
const ui::appIdMap_t* mapA = nullptr,
|
|
unsigned mapN = 0,
|
|
const char* cfgLabel = "io" );
|
|
|
|
rc_t destroy( handle_t& h );
|
|
|
|
rc_t start( handle_t h );
|
|
rc_t pause( handle_t h );
|
|
rc_t stop( handle_t h );
|
|
|
|
|
|
// Note that this call blocks on the the UI websocket handle for up to 'timeOutMs'.
|
|
// See ui:ws:exec().
|
|
rc_t exec( handle_t h, unsigned timeOutMs, void* execCbArg=nullptr );
|
|
|
|
bool isShuttingDown( handle_t h );
|
|
void report( handle_t h );
|
|
void hardwareReport( handle_t h );
|
|
void realTimeReport( handle_t h );
|
|
|
|
|
|
//----------------------------------------------------------------------------------------------------------
|
|
//
|
|
// Thread
|
|
//
|
|
rc_t threadCreate( handle_t h, unsigned id, bool asyncFl, void* arg, const char* label );
|
|
|
|
//----------------------------------------------------------------------------------------------------------
|
|
//
|
|
// Timer
|
|
//
|
|
|
|
rc_t timerCreate( handle_t h, const char* label, unsigned id, unsigned periodMicroSec, bool asyncFl );
|
|
rc_t timerDestroy( handle_t h, unsigned timerIdx );
|
|
|
|
unsigned timerCount( handle_t h );
|
|
unsigned timerLabelToIndex( handle_t h, const char* label );
|
|
unsigned timerIdToIndex( handle_t h, unsigned timerId );
|
|
const char* timerLabel( handle_t h, unsigned timerIdx );
|
|
unsigned timerId( handle_t h, unsigned timerIdx );
|
|
unsigned timerPeriodMicroSec( handle_t h, unsigned timerIdx );
|
|
rc_t timerSetPeriodMicroSec( handle_t h, unsigned timerIdx, unsigned periodMicroSec );
|
|
|
|
// Set an explicit next time to trigger. The 'time' argument will over ride the next periodic callback.
|
|
// Note that the most reliable way to use this function is by calling it in the timer callback
|
|
// so that it will deterine the time of the following callback.
|
|
rc_t timerSetNextTime( handle_t h, unsigned timerIdx, const time::spec_t& time );
|
|
|
|
rc_t timerStart( handle_t h, unsigned timerIdx );
|
|
rc_t timerStop( handle_t h, unsigned timerIdx );
|
|
|
|
//----------------------------------------------------------------------------------------------------------
|
|
//
|
|
// Serial
|
|
//
|
|
|
|
bool serialIsEnabled( handle_t h );
|
|
unsigned serialDeviceCount( handle_t h );
|
|
unsigned serialDeviceIndex( handle_t h, const char* label );
|
|
const char* serialDeviceLabel( handle_t h, unsigned devIdx );
|
|
unsigned serialDeviceId( handle_t h, unsigned devIdx ); // defaults to device index
|
|
void serialDeviceSetId( handle_t h, unsigned devIdx, unsigned id );
|
|
|
|
rc_t serialDeviceSend( handle_t h, unsigned devIdx, const void* byteA, unsigned byteN );
|
|
|
|
//----------------------------------------------------------------------------------------------------------
|
|
//
|
|
// MIDI
|
|
//
|
|
|
|
bool midiIsEnabled( handle_t h );
|
|
unsigned midiDeviceCount( handle_t h );
|
|
const char* midiDeviceName( handle_t h, unsigned devIdx );
|
|
unsigned midiDeviceIndex( handle_t h, const char* devName );
|
|
unsigned midiDevicePortCount( handle_t h, unsigned devIdx, bool inputFl );
|
|
const char* midiDevicePortName( handle_t h, unsigned devIdx, bool inputFl, unsigned portIdx );
|
|
unsigned midiDevicePortIndex( handle_t h, unsigned devIdx, bool inputFl, const char* portName );
|
|
rc_t midiDeviceSend( handle_t h, unsigned devIdx, unsigned portIdx, uint8_t status, uint8_t d0, uint8_t d1 );
|
|
|
|
unsigned midiDeviceMaxBufferMsgCount( handle_t h );
|
|
const midi::ch_msg_t* midiDeviceBuffer( handle_t h, unsigned& msgCntRef );
|
|
rc_t midiDeviceClearBuffer( handle_t h, unsigned msgCnt );
|
|
|
|
|
|
rc_t midiOpenMidiFile( handle_t h, unsigned devIdx, unsigned portIdx, const char* fname );
|
|
rc_t midiLoadMsgPacket( handle_t h, const midi::packet_t& pkt ); // Note: Set devIdx/portIdx via pkt.devIdx/pkt.portIdx
|
|
unsigned midiMsgCount( handle_t h, unsigned devIdx, unsigned portIdx );
|
|
rc_t midiSeekToMsg( handle_t h, unsigned devIdx, unsigned portIdx, unsigned msgIdx );
|
|
rc_t midiSetEndMsg( handle_t h, unsigned devIdx, unsigned portidx, unsigned msgIdx );
|
|
rc_t midiFileStart( handle_t h );
|
|
rc_t midiFileStop( handle_t h );
|
|
rc_t midiFilePause( handle_t h, bool pauseFl );
|
|
|
|
|
|
//----------------------------------------------------------------------------------------------------------
|
|
//
|
|
// Audio
|
|
//
|
|
|
|
bool audioIsEnabled( handle_t h );
|
|
unsigned audioDeviceCount( handle_t h );
|
|
unsigned audioActiveDeviceCount( handle_t h );
|
|
unsigned audioDeviceLabelToIndex( handle_t h, const char* label );
|
|
const char* audioDeviceLabel( handle_t h, unsigned devIdx );
|
|
rc_t audioDeviceSetUserId( handle_t h, unsigned devIdx, unsigned userId );
|
|
bool audioDeviceIsActive( handle_t h, unsigned devIdx );
|
|
const char* audioDeviceName( handle_t h, unsigned devIdx );
|
|
unsigned audioDeviceUserId( handle_t h, unsigned devIdx );
|
|
rc_t audioDeviceEnable( handle_t h, unsigned devIdx, bool inputFl, bool enableFl );
|
|
rc_t audioDeviceSeek( handle_t h, unsigned devIdx, bool inputFl, unsigned frameOffset );
|
|
double audioDeviceSampleRate( handle_t h, unsigned devIdx );
|
|
unsigned audioDeviceFramesPerCycle( handle_t h, unsigned devIdx );
|
|
unsigned audioDeviceChannelCount( handle_t h, unsigned devIdx, unsigned inOrOutFlag );
|
|
rc_t audioDeviceEnableMeters( handle_t h, unsigned devIdx, unsigned inOutEnaFlags );
|
|
const sample_t* audioDeviceMeters( handle_t h, unsigned devIdx, unsigned& chCntRef, unsigned inOrOutFlag );
|
|
rc_t audioDeviceEnableTone( handle_t h, unsigned devidx, unsigned inOutEnaFlags );
|
|
rc_t audioDeviceToneFlags( handle_t h, unsigned devIdx, unsigned inOrOutFlag, bool* toneFlA, unsigned chCnt );
|
|
rc_t audioDeviceEnableMute( handle_t h, unsigned devidx, unsigned inOutEnaFlags );
|
|
rc_t audioDeviceMuteFlags( handle_t h, unsigned devIdx, unsigned inOrOutFlag, bool* muteFlA, unsigned chCnt );
|
|
rc_t audioDeviceSetGain( handle_t h, unsigned devIdx, unsigned inOrOutFlag, double gain );
|
|
rc_t audioDeviceGain( handle_t h, unsigned devIdx, unsigned inOrOutFlag, double* gainA, unsigned chCnt );
|
|
|
|
unsigned audioGroupCount( handle_t h );
|
|
unsigned audioGroupLabelToIndex( handle_t h, const char* label );
|
|
const char* audioGroupLabel( handle_t h, unsigned groupIdx );
|
|
bool audioGroupIsEnabled( handle_t h, unsigned groupIdx );
|
|
unsigned audioGroupUserId( handle_t h, unsigned groupIdx );
|
|
rc_t audioGroupSetUserId( handle_t h, unsigned groupIdx, unsigned userId );
|
|
double audioGroupSampleRate( handle_t h, unsigned groupIdx );
|
|
unsigned audioGroupDspFrameCount( handle_t h, unsigned groupIdx );
|
|
rc_t audioGroupReconfigure( handle_t h, unsigned groupIdx, double srate, unsigned dspFrameN );
|
|
|
|
// Get the count of in or out devices assigned to this group.
|
|
unsigned audioGroupDeviceCount( handle_t h, unsigned groupIdx, unsigned inOrOutFl );
|
|
|
|
// Get the device index of each of the devices assigned to this group
|
|
unsigned audioGroupDeviceIndex( handle_t h, unsigned groupIdx, unsigned inOrOutFl, unsigned groupDeviceIdx );
|
|
|
|
//----------------------------------------------------------------------------------------------------------
|
|
//
|
|
// Socket
|
|
//
|
|
|
|
bool socketIsEnabled( handle_t h );
|
|
unsigned socketCount( handle_t h );
|
|
unsigned socketLabelToIndex( handle_t h, const char* label );
|
|
unsigned socketUserId( handle_t h, unsigned sockIdx );
|
|
rc_t socketSetUserId( handle_t h, unsigned sockIdx, unsigned userId );
|
|
const char* socketLabel( handle_t h, unsigned sockIdx );
|
|
const char* socketHostName( handle_t h, unsigned sockIdx );
|
|
const char* socketIpAddress( handle_t h, unsigned sockIdx );
|
|
unsigned socketInetAddress( handle_t h, unsigned sockIdx );
|
|
sock::portNumber_t socketPort( handle_t h, unsigned sockIdx );
|
|
rc_t socketPeername( handle_t h, unsigned sockIdx, struct sockaddr_in* addr );
|
|
|
|
bool socketIsConnected( handle_t h, unsigned sockIdx );
|
|
|
|
|
|
|
|
// Send to the remote endpoint represented by connId over a connected socket.
|
|
// 'connId' is an id, assigned by the framework, of a remote connected endpoint
|
|
// attached to a receiving local socket. It is passed to the application as part
|
|
// of the incoming data callback.
|
|
// If 'connId' is kInvalidId then this data is sent to all connected endpoints.
|
|
rc_t socketSend( handle_t h, unsigned sockIdx, unsigned connId, const void* data, unsigned dataByteCnt );
|
|
|
|
// Send a message to a specific remote node over an unconnected UDP socket.
|
|
// Use the function initAddr() to setup the 'sockaddr_in';
|
|
rc_t socketSend( handle_t h, unsigned sockIdx, const void* data, unsigned dataByteCnt, const struct sockaddr_in* remoteAddr );
|
|
rc_t socketSend( handle_t h, unsigned sockIdx, const void* data, unsigned dataByteCnt, const char* remoteAddr, sock::portNumber_t remotePort );
|
|
|
|
|
|
//----------------------------------------------------------------------------------------------------------
|
|
//
|
|
// UI
|
|
//
|
|
|
|
bool uiIsEnabled( handle_t h );
|
|
|
|
// Find id's associated with elements.
|
|
unsigned parentAndNameToAppId( handle_t h, unsigned parentAppId, const char* eleName );
|
|
unsigned parentAndNameToUuId( handle_t h, unsigned parentAppId, const char* eleName );
|
|
unsigned parentAndAppIdToUuId( handle_t h, unsigned parentAppId, unsigned appId );
|
|
const char* uiFindElementName( handle_t h, unsigned uuId );
|
|
unsigned uiFindElementAppId( handle_t h, unsigned uuId );
|
|
|
|
// Return the uuid of the first matching 'eleName' or 'appId'.
|
|
unsigned uiFindElementUuId( handle_t h, const char* eleName, unsigned chanId=kInvalidId );
|
|
unsigned uiFindElementUuId( handle_t h, unsigned appId, unsigned chanId=kInvalidId );
|
|
|
|
unsigned uiFindElementUuId( handle_t h, unsigned parentUuId, const char* eleName, unsigned chanId=kInvalidId );
|
|
unsigned uiFindElementUuId( handle_t h, unsigned parentUuId, unsigned appId, unsigned chanId=kInvalidId );
|
|
|
|
|
|
rc_t uiCreateFromObject( handle_t h, const object_t* o, unsigned parentUuId=kInvalidId, unsigned chanId=kInvalidId, const char* eleName=nullptr);
|
|
rc_t uiCreateFromFile( handle_t h, const char* fn, unsigned parentUuId=kInvalidId, unsigned chanId=kInvalidId );
|
|
rc_t uiCreateFromText( handle_t h, const char* text, unsigned parentUuId=kInvalidId, unsigned chanId=kInvalidId );
|
|
rc_t uiCreateFromRsrc( handle_t h, const char* label, unsigned parentUuId=kInvalidId, unsigned chanId=kInvalidId );
|
|
|
|
rc_t uiCreateDiv( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title );
|
|
rc_t uiCreateLabel( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title );
|
|
rc_t uiCreateButton( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title );
|
|
|
|
// Create check: w/o value. The value will be read from the engine via the UI 'echo' event.
|
|
// Create check: w/ value. The value will be sent to the engine as the new value of the associated varaible.
|
|
rc_t uiCreateCheck( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title );
|
|
rc_t uiCreateCheck( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title, bool value );
|
|
|
|
rc_t uiCreateSelect( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title );
|
|
rc_t uiCreateOption( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title );
|
|
|
|
rc_t uiCreateStrDisplay( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title );
|
|
rc_t uiCreateStrDisplay( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title, const char* value );
|
|
|
|
rc_t uiCreateStr( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title );
|
|
rc_t uiCreateStr( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title, const char* value );
|
|
|
|
rc_t uiCreateNumbDisplay(handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title, unsigned decPl );
|
|
rc_t uiCreateNumbDisplay(handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title, unsigned decPl, double value );
|
|
|
|
rc_t uiCreateNumb( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title, double minValue, double maxValue, double stepValue, unsigned decPl );
|
|
rc_t uiCreateNumb( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title, double minValue, double maxValue, double stepValue, unsigned decPl, double value );
|
|
|
|
rc_t uiCreateProg( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title, double minValue, double maxValue );
|
|
rc_t uiCreateProg( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title, double minValue, double maxValue, double value );
|
|
|
|
rc_t uiCreateLog( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title );
|
|
|
|
rc_t uiCreateVList( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title );
|
|
rc_t uiCreateHList( handle_t h, unsigned& uuIdRef, unsigned parentUuId, const char* eleName, unsigned appId, unsigned chanId, const char* clas, const char* title );
|
|
|
|
|
|
rc_t uiSetTitle( handle_t h, unsigned uuId, const char* title );
|
|
|
|
rc_t uiSetNumbRange( handle_t h, unsigned uuId, double minValue, double maxValue, double stepValue, unsigned decPl, double value );
|
|
rc_t uiSetProgRange( handle_t h, unsigned uuId, double minValue, double maxValue, double value );
|
|
rc_t uiSetLogLine( handle_t h, unsigned uuId, const char* text );
|
|
rc_t uiEmptyParent( handle_t h, unsigned uuId); // empty a list or selection menu of all children
|
|
|
|
rc_t uiSetClickable( handle_t h, unsigned uuId, bool clickableFl=true );
|
|
rc_t uiClearClickable( handle_t h, unsigned uuId );
|
|
bool uiIsClickable( handle_t h, unsigned uuId );
|
|
|
|
rc_t uiSetSelect( handle_t h, unsigned uuId, bool enableFl=true );
|
|
rc_t uiClearSelect( handle_t h, unsigned uuId );
|
|
bool uiIsSelected( handle_t h, unsigned uuId );
|
|
|
|
rc_t uiSetVisible( handle_t h, unsigned uuId, bool enableFl=true );
|
|
rc_t uiClearVisible( handle_t h, unsigned uuId );
|
|
bool uiIsVisible( handle_t h, unsigned uuId );
|
|
|
|
rc_t uiSetEnable( handle_t h, unsigned uuId, bool enableFl=true );
|
|
rc_t uiClearEnable( handle_t h, unsigned uuId );
|
|
bool uiIsEnabled( handle_t h, unsigned uuId );
|
|
|
|
rc_t uiSetOrderKey( handle_t h, unsigned uuId, int orderKey );
|
|
int uiGetOrderKey( handle_t h, unsigned uuId );
|
|
|
|
rc_t uiSetScrollTop( handle_t h, unsigned uuId );
|
|
|
|
// uiSetBlob() allocates internal memory and copies the contents of blob[blobByeN]
|
|
rc_t uiSetBlob( handle_t h, unsigned uuId, const void* blob, unsigned blobByteN );
|
|
const void* uiGetBlob( handle_t h, unsigned uuId, unsigned& blobByteN_Ref );
|
|
|
|
// On call bufByteN_Ref holds the size of buf in bytes, on return it is set to the count of bytes in buf[].
|
|
// If buf[] is not large enough to hold all bytes kBufTooSmallRC is returned.
|
|
rc_t uiGetBlob( handle_t h, unsigned uuId, void* buf, unsigned& bufByteN_Ref );
|
|
rc_t uiClearBlob( handle_t h, unsigned uuId );
|
|
|
|
// Register parent/child/name app id's
|
|
rc_t uiRegisterAppIdMap( handle_t h, const ui::appIdMap_t* map, unsigned mapN );
|
|
|
|
rc_t uiDestroyElement( handle_t h, unsigned uuId );
|
|
|
|
// Send a value from the application to the UI.
|
|
// Set wsSessId to kInvalidId to send to all sessions.
|
|
rc_t uiSendValue( handle_t h, unsigned uuId, bool value );
|
|
rc_t uiSendValue( handle_t h, unsigned uuId, int value );
|
|
rc_t uiSendValue( handle_t h, unsigned uuId, unsigned value );
|
|
rc_t uiSendValue( handle_t h, unsigned uuId, float value );
|
|
rc_t uiSendValue( handle_t h, unsigned uuId, double value );
|
|
rc_t uiSendValue( handle_t h, unsigned uuId, const char* value );
|
|
|
|
rc_t uiSendMsg( handle_t h, const char* msg );
|
|
|
|
|
|
typedef struct
|
|
{
|
|
time::spec_t note_on_input_ts;
|
|
time::spec_t note_on_output_ts;
|
|
time::spec_t audio_in_ts;
|
|
time::spec_t audio_out_ts;
|
|
sample_t audio_in_rms_max;
|
|
sample_t audio_out_rms_max;
|
|
} latency_meas_result_t;
|
|
|
|
void latency_measure_setup(handle_t h);
|
|
latency_meas_result_t latency_measure_result(handle_t h);
|
|
void latency_measure_report(handle_t h);
|
|
|
|
void uiRealTimeReport( handle_t h );
|
|
void uiReport( handle_t h );
|
|
|
|
}
|
|
}
|
|
|
|
|
|
#endif
|