2012-07-09 14:58:35 +02:00
|
|
|
/******************************************************************************\
|
2015-02-04 19:17:23 +01:00
|
|
|
* \copyright (c) 2004-2015
|
2012-12-31 13:45:28 +01:00
|
|
|
* \author Volker Fischer
|
2012-07-09 14:58:35 +02:00
|
|
|
*
|
|
|
|
|
2013-03-24 16:42:23 +01:00
|
|
|
\mainpage Jamulus source code documentation
|
2012-12-31 13:45:28 +01:00
|
|
|
|
|
|
|
\section intro_sec Introduction
|
|
|
|
|
2013-03-24 11:49:25 +01:00
|
|
|
The Jamulus software enables musicians to perform real-time jam sessions over the
|
|
|
|
internet. There is one server running the Jamulus server software which collects
|
|
|
|
the audio data from each Jamulus client, mixes the audio data and sends the mix
|
2012-12-31 13:45:28 +01:00
|
|
|
back to each client.
|
|
|
|
|
|
|
|
|
2012-07-09 14:58:35 +02:00
|
|
|
Prefix definitions for the GUI:
|
|
|
|
|
|
|
|
label: lbl
|
|
|
|
combo box: cbx
|
|
|
|
line edit: edt
|
|
|
|
list view: lvw
|
|
|
|
check box: chb
|
|
|
|
radio button: rbt
|
|
|
|
button: but
|
|
|
|
text view: txv
|
|
|
|
slider: sld
|
|
|
|
LED: led
|
|
|
|
group box: grb
|
|
|
|
pixmap label: pxl
|
|
|
|
LED bar: lbr
|
|
|
|
|
|
|
|
******************************************************************************
|
|
|
|
*
|
|
|
|
* 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, write to the Free Software Foundation, Inc.,
|
|
|
|
* 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
*
|
|
|
|
\******************************************************************************/
|
|
|
|
|
|
|
|
#if !defined ( GLOBAL_H__3B123453_4344_BB2B_23E7A0D31912__INCLUDED_ )
|
|
|
|
#define GLOBAL_H__3B123453_4344_BB2B_23E7A0D31912__INCLUDED_
|
|
|
|
|
2013-01-02 21:41:04 +01:00
|
|
|
#include <QString>
|
|
|
|
#include <QEvent>
|
|
|
|
#include <QDebug>
|
2012-07-09 14:58:35 +02:00
|
|
|
#include <stdio.h>
|
|
|
|
#include <math.h>
|
|
|
|
#include <string>
|
2012-12-31 13:45:28 +01:00
|
|
|
#ifndef _WIN32
|
|
|
|
# include <unistd.h> // solves a compile problem on recent Ubuntu
|
|
|
|
#endif
|
2012-07-09 14:58:35 +02:00
|
|
|
#ifdef HAVE_CONFIG_H
|
|
|
|
# include "config.h"
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
/* Definitions ****************************************************************/
|
|
|
|
// define this macro to get debug output
|
|
|
|
//#define _DEBUG_
|
|
|
|
#undef _DEBUG_
|
|
|
|
|
2014-02-23 10:46:25 +01:00
|
|
|
// define this macro if the version and operating system debugging shall
|
|
|
|
// be enabled in the client (the ping time column in the connect dialog then
|
|
|
|
// shows the requested information instead of the ping time)
|
|
|
|
#undef ENABLE_CLIENT_VERSION_AND_OS_DEBUGGING
|
|
|
|
|
2013-03-24 09:54:11 +01:00
|
|
|
// version and application name (use version from qt prject file)
|
2012-07-09 14:58:35 +02:00
|
|
|
#undef VERSION
|
2013-03-24 09:54:11 +01:00
|
|
|
#define VERSION APP_VERSION
|
2013-02-19 22:20:15 +01:00
|
|
|
#define APP_NAME "Jamulus"
|
2012-07-09 14:58:35 +02:00
|
|
|
|
|
|
|
// Windows registry key name of auto run entry for the server
|
2013-03-24 10:20:19 +01:00
|
|
|
#define AUTORUN_SERVER_REG_NAME "Jamulus server"
|
2012-07-09 14:58:35 +02:00
|
|
|
|
|
|
|
// default names of the ini-file for client and server
|
2013-03-24 10:20:19 +01:00
|
|
|
#define DEFAULT_INI_FILE_NAME "Jamulus.ini"
|
|
|
|
#define DEFAULT_INI_FILE_NAME_SERVER "Jamulusserver.ini"
|
2012-07-09 14:58:35 +02:00
|
|
|
|
|
|
|
// file name for logging file
|
2013-03-24 10:20:19 +01:00
|
|
|
#define DEFAULT_LOG_FILE_NAME "Jamulussrvlog.txt"
|
2012-07-09 14:58:35 +02:00
|
|
|
|
|
|
|
// default server address
|
2013-03-24 16:46:07 +01:00
|
|
|
#define DEFAULT_SERVER_ADDRESS "jamulus.dyndns.org"
|
2012-07-09 14:58:35 +02:00
|
|
|
#define SELECT_SERVER_ADDRESS(a, b) ((a) ? (DEFAULT_SERVER_ADDRESS) : (b))
|
|
|
|
|
|
|
|
// download URL
|
|
|
|
#define LLCON_DOWNLOAD_URL "http://sourceforge.net/projects/llcon/files"
|
|
|
|
|
|
|
|
// defined port number for client and server
|
|
|
|
#define LLCON_DEFAULT_PORT_NUMBER 22124
|
|
|
|
|
|
|
|
// system sample rate (the sound card and audio coder works on this sample rate)
|
|
|
|
#define SYSTEM_SAMPLE_RATE_HZ 48000 // Hz
|
|
|
|
|
|
|
|
// System block size, this is the block size on which the audio coder works.
|
|
|
|
// All other block sizes must be a multiple of this size
|
|
|
|
#define SYSTEM_FRAME_SIZE_SAMPLES 128
|
|
|
|
|
|
|
|
#define SYSTEM_BLOCK_DURATION_MS_FLOAT \
|
|
|
|
( static_cast<double> ( SYSTEM_FRAME_SIZE_SAMPLES ) / \
|
|
|
|
SYSTEM_SAMPLE_RATE_HZ * 1000 )
|
|
|
|
|
|
|
|
// define the allowed audio frame size factors (since the
|
|
|
|
// "SYSTEM_FRAME_SIZE_SAMPLES" is quite small, it may be that on some
|
|
|
|
// computers a larger value is required)
|
|
|
|
#define FRAME_SIZE_FACTOR_PREFERRED 1 // 128 (for frame size 128)
|
|
|
|
#define FRAME_SIZE_FACTOR_DEFAULT 2 // 256 (for frame size 128)
|
|
|
|
#define FRAME_SIZE_FACTOR_SAFE 4 // 512 (for frame size 128)
|
|
|
|
|
|
|
|
// low complexity CELT encoder (if defined)
|
|
|
|
#define USE_LOW_COMPLEXITY_CELT_ENC
|
|
|
|
|
2013-02-12 16:32:05 +01:00
|
|
|
// define the minimum allowed number of coded bytes for CELT (the encoder
|
|
|
|
// gets in trouble if the value is too low)
|
|
|
|
#define CELT_MINIMUM_NUM_BYTES 10
|
|
|
|
|
2012-07-09 14:58:35 +02:00
|
|
|
// define the maximum mono audio buffer size at a sample rate
|
|
|
|
// of 48 kHz, this is important for defining the maximum number
|
|
|
|
// of bytes to be expected from the network interface
|
2014-01-12 08:42:43 +01:00
|
|
|
|
|
|
|
// TODO check why this number is so large...?
|
|
|
|
|
2012-07-09 14:58:35 +02:00
|
|
|
#define MAX_MONO_AUD_BUFF_SIZE_AT_48KHZ 4096
|
|
|
|
|
|
|
|
// Maximum block size for network input buffer. Consider a maximum sample rate
|
|
|
|
// of 48 kHz and two audio channels and two bytes per sample.
|
|
|
|
#define MAX_SIZE_BYTES_NETW_BUF ( MAX_MONO_AUD_BUFF_SIZE_AT_48KHZ * 4 )
|
|
|
|
|
|
|
|
// minimum/maximum network buffer size (which can be chosen by slider)
|
|
|
|
#define MIN_NET_BUF_SIZE_NUM_BL 1 // number of blocks
|
|
|
|
#define MAX_NET_BUF_SIZE_NUM_BL 20 // number of blocks
|
|
|
|
#define AUTO_NET_BUF_SIZE_FOR_PROTOCOL ( MAX_NET_BUF_SIZE_NUM_BL + 1 ) // auto set parameter (only used for protocol)
|
|
|
|
|
|
|
|
// default network buffer size
|
|
|
|
#define DEF_NET_BUF_SIZE_NUM_BL 10 // number of blocks
|
|
|
|
|
2013-02-28 21:54:47 +01:00
|
|
|
// audio mixer fader maximum value
|
|
|
|
#define AUD_MIX_FADER_MAX 100
|
|
|
|
|
2012-07-09 14:58:35 +02:00
|
|
|
// maximum number of recognized sound cards installed in the system,
|
|
|
|
// definition for "no device"
|
2015-07-05 14:00:54 +02:00
|
|
|
#define MAX_NUMBER_SOUND_CARDS 129 // e.g. 16 inputs, 8 outputs + default entry (MacOS)
|
2012-07-09 14:58:35 +02:00
|
|
|
#define INVALID_SNC_CARD_DEVICE -1
|
|
|
|
|
|
|
|
// define the maximum number of audio channel for input/output we can store
|
|
|
|
// channel infos for (and therefore this is the maximum number of entries in
|
|
|
|
// the channel selection combo box regardless of the actual available number
|
|
|
|
// of channels by the audio device)
|
|
|
|
#define MAX_NUM_IN_OUT_CHANNELS 32
|
|
|
|
|
|
|
|
// maximum number of elemts in the server address combo box
|
|
|
|
#define MAX_NUM_SERVER_ADDR_ITEMS 6
|
|
|
|
|
2014-01-19 11:51:31 +01:00
|
|
|
// maximum number of fader settings to be stored (together with the fader tags)
|
|
|
|
#define MAX_NUM_STORED_FADER_SETTINGS 20
|
2013-02-24 10:03:57 +01:00
|
|
|
|
2012-07-09 14:58:35 +02:00
|
|
|
// defines for LED input level meter
|
|
|
|
#define NUM_STEPS_INP_LEV_METER 8
|
|
|
|
#define RED_BOUND_INP_LEV_METER 7
|
|
|
|
#define YELLOW_BOUND_INP_LEV_METER 5
|
|
|
|
|
|
|
|
// maximum number of internet connections (channels)
|
|
|
|
// if you want to change this paramter, there has to be done code modifications
|
|
|
|
// on other places, too! The code tag "MAX_NUM_CHANNELS_TAG" shows these places
|
|
|
|
// (just search for the tag in the entire code)
|
2013-09-08 22:15:21 +02:00
|
|
|
#define MAX_NUM_CHANNELS 20 // max number channels for server
|
2012-07-09 14:58:35 +02:00
|
|
|
|
|
|
|
// actual number of used channels in the server
|
|
|
|
// this parameter can safely be changed from 1 to MAX_NUM_CHANNELS
|
|
|
|
// without any other changes in the code
|
2014-03-11 20:39:44 +01:00
|
|
|
#define DEFAULT_USED_NUM_CHANNELS 10 // default used number channels for server
|
2012-07-09 14:58:35 +02:00
|
|
|
|
|
|
|
// maximum number of servers registered in the server list
|
|
|
|
#define MAX_NUM_SERVERS_IN_SERVER_LIST 100
|
|
|
|
|
|
|
|
// defines the time interval at which the ping time is updated in the GUI
|
|
|
|
#define PING_UPDATE_TIME_MS 500 // ms
|
|
|
|
|
|
|
|
// defines the time interval at which the ping time is updated for the server
|
|
|
|
// list
|
|
|
|
#define PING_UPDATE_TIME_SERVER_LIST_MS 2000 // ms
|
|
|
|
|
|
|
|
// time-out until a registered server is deleted from the server list if no
|
|
|
|
// new registering was made in minutes
|
|
|
|
#define SERVLIST_TIME_OUT_MINUTES 60 // minutes
|
|
|
|
|
|
|
|
// poll time for server list (to check if entries are time-out)
|
|
|
|
#define SERVLIST_POLL_TIME_MINUTES 1 // minute
|
|
|
|
|
|
|
|
// time interval for sending ping messages to servers in the server list
|
|
|
|
#define SERVLIST_UPDATE_PING_SERVERS_MS 59000 // ms
|
|
|
|
|
|
|
|
// time until a slave server registers in the server list
|
|
|
|
#define SERVLIST_REGIST_INTERV_MINUTES 15 // minutes
|
|
|
|
|
|
|
|
|
|
|
|
// length of the moving average buffer for response time measurement
|
|
|
|
#define TIME_MOV_AV_RESPONSE_SECONDS 30 // seconds
|
|
|
|
|
|
|
|
|
|
|
|
// Maximum length of fader tag and text message strings (Since for chat messages
|
|
|
|
// some HTML code is added, we also have to define a second length which includes
|
|
|
|
// this additionl HTML code. Right now the length of the HTML code is approx. 66
|
|
|
|
// character. Here, we add some headroom to this number)
|
|
|
|
#define MAX_LEN_FADER_TAG 16
|
|
|
|
#define MAX_LEN_CHAT_TEXT 1600
|
|
|
|
#define MAX_LEN_CHAT_TEXT_PLUS_HTML 1800
|
|
|
|
#define MAX_LEN_SERVER_NAME 20
|
|
|
|
#define MAX_LEN_SERVER_TOPIC 32
|
|
|
|
#define MAX_LEN_SERVER_CITY 20
|
2014-02-21 22:25:26 +01:00
|
|
|
#define MAX_LEN_VERSION_TEXT 20
|
2012-07-09 14:58:35 +02:00
|
|
|
|
|
|
|
// common tool tip bottom line text
|
|
|
|
#define TOOLTIP_COM_END_TEXT tr ( \
|
|
|
|
"<br><div align=right><font size=-1><i>" \
|
|
|
|
"For more information use the ""What's " \
|
|
|
|
"This"" help (? menu, right mouse button or Shift+F1)" \
|
|
|
|
"</i></font></div>" )
|
|
|
|
|
|
|
|
#define _MAXSHORT 32767
|
|
|
|
#define _MAXBYTE 255 // binary: 11111111
|
|
|
|
#define _MINSHORT ( -32768 )
|
|
|
|
|
|
|
|
#if HAVE_STDINT_H
|
|
|
|
# include <stdint.h>
|
|
|
|
#elif HAVE_INTTYPES_H
|
|
|
|
# include <inttypes.h>
|
|
|
|
#elif defined ( _WIN32 )
|
|
|
|
typedef __int64 int64_t;
|
|
|
|
typedef __int32 int32_t;
|
|
|
|
typedef __int16 int16_t;
|
|
|
|
typedef unsigned __int64 uint64_t;
|
|
|
|
typedef unsigned __int32 uint32_t;
|
|
|
|
typedef unsigned __int16 uint16_t;
|
|
|
|
typedef unsigned __int8 uint8_t;
|
|
|
|
#else
|
|
|
|
typedef long long int64_t;
|
|
|
|
typedef int int32_t;
|
|
|
|
typedef short int16_t;
|
|
|
|
typedef unsigned long long uint64_t;
|
|
|
|
typedef unsigned int uint32_t;
|
|
|
|
typedef unsigned short uint16_t;
|
|
|
|
typedef unsigned char uint8_t;
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
2014-01-03 09:54:49 +01:00
|
|
|
/* Pseudo enum definitions -------------------------------------------------- */
|
|
|
|
// definition for custom event
|
|
|
|
#define MS_PACKET_RECEIVED 0
|
|
|
|
|
2012-07-09 14:58:35 +02:00
|
|
|
|
|
|
|
/* Classes ********************************************************************/
|
|
|
|
class CGenErr
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
CGenErr ( QString strNewErrorMsg, QString strNewErrorType = "" ) :
|
|
|
|
strErrorMsg ( strNewErrorMsg ), strErrorType ( strNewErrorType ) {}
|
|
|
|
|
|
|
|
QString GetErrorText()
|
|
|
|
{
|
|
|
|
// return formatted error text
|
|
|
|
if ( strErrorType.isEmpty() )
|
|
|
|
{
|
|
|
|
return strErrorMsg;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
return strErrorType + ": " + strErrorMsg;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
protected:
|
|
|
|
QString strErrorMsg;
|
|
|
|
QString strErrorType;
|
|
|
|
};
|
|
|
|
|
2013-03-24 16:42:23 +01:00
|
|
|
class CCustomEvent : public QEvent
|
2012-07-09 14:58:35 +02:00
|
|
|
{
|
|
|
|
public:
|
2013-03-24 16:42:23 +01:00
|
|
|
CCustomEvent ( int iNewMeTy, int iNewSt, int iNewChN = 0 ) :
|
2012-07-09 14:58:35 +02:00
|
|
|
QEvent ( QEvent::Type ( QEvent::User + 11 ) ), iMessType ( iNewMeTy ), iStatus ( iNewSt ),
|
|
|
|
iChanNum ( iNewChN ) {}
|
|
|
|
|
|
|
|
int iMessType;
|
|
|
|
int iStatus;
|
|
|
|
int iChanNum;
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
/* Prototypes for global functions ********************************************/
|
|
|
|
// command line parsing, TODO do not declare functions globally but in a class
|
|
|
|
QString UsageArguments ( char** argv );
|
|
|
|
|
|
|
|
bool GetFlagArgument ( char** argv,
|
|
|
|
int& i,
|
|
|
|
QString strShortOpt,
|
|
|
|
QString strLongOpt );
|
|
|
|
|
|
|
|
bool GetStringArgument ( QTextStream& tsConsole,
|
|
|
|
int argc,
|
|
|
|
char** argv,
|
|
|
|
int& i,
|
|
|
|
QString strShortOpt,
|
|
|
|
QString strLongOpt,
|
|
|
|
QString& strArg );
|
|
|
|
|
|
|
|
bool GetNumericArgument ( QTextStream& tsConsole,
|
|
|
|
int argc,
|
|
|
|
char** argv,
|
|
|
|
int& i,
|
|
|
|
QString strShortOpt,
|
|
|
|
QString strLongOpt,
|
|
|
|
double rRangeStart,
|
|
|
|
double rRangeStop,
|
|
|
|
double& rValue);
|
|
|
|
|
|
|
|
#endif /* !defined ( GLOBAL_H__3B123453_4344_BB2B_23E7A0D31912__INCLUDED_ ) */
|