// Блок, содержащий коды ошибок
#define  EFOPEN -1  // ошибка открытия файла
#define  EFREAD 11  // ошибка чтения файла
#define   EHEAD -2  // ошибка заголовка
#define    EGEN 9   // ошибка gen ?
#define  ENOARG 3   // ошибка номера аргумента
#define EACSDND 4   // ошибка ... sound ???
#define ENUDATA 0   // ошибка номера данных

// Блок, содержащий сообщения, выводимые при соответствующих ошибках
#define   MEHEAD "Unavailable .WAV"         // Недоступный wav файл
#define    MEGEN "Error!"               // Ошибка
#define   MEEXIT "Press any key to exit..."     // Нажмите любую клавишу, чтобы выйти
#define MENUDATA "No data in file"          // Данные отсутствуют в файле

// отображаем инструкции для запуска и восспроизведения файла
#define  MENOARG "Use next:\nplaywav <WAVFILE> [clock multiplier] [w] - play file <WAVFILE>\n\
:if w - show waveform graph only\n\
:clock multiplier - 650000 by default"

/*
    Одна хитрая вещь, связанная с секциями файла RIFF, состоит в том, что адреса начала секций должны быть выровнены на размер слова (2 байта). Это означает, что общий размер секции должен быть кратен 2. Если секция содержит нечетное число байт данных (невыравненное до 2 байт), то добавляется дополнительный нулевой байт данных в конец данных секции. Этот дополнительный байт не учитывается в размере секции заголовка, таким образом программа всегда должна учитывать выравнивание для расчета смещения начала следующей секции.
*/

// ??? Блок, содержащий необходимые константы для распознавания wav-файла по его заголовку   // кажись, это смещения в памяти для чанков
#define   RIFFID 0x46464952     // RIFF константа, которая обозначает тип  Содержит символы “RIFF”
#define   FORMAT 0x45564157     // WAVE что означает этот "FORMAT"?      Содержит символы “wave”
#define    FMTID 0x20746d66     // fmt      Содержит символы “fmt”
#define   DATAID 0x61746164     // data     Содержит символы “data”
#define   FACTID 0x74636166     // "fact"  Секция fact содержит информацию о содержимом WAV-файла, зависящую от кода компрессии. Она требуется для всех форматов WAVE со сжатием, и требуется, если данные сигнала содержатся внутри секции списка (LIST) "wavl", но не требуется для несжатого формата PCM WAVE (код компрессии 1), который содержит аудиоданные в секции "data".

#define PCMAUDIO 1
// PCM/uncompressed
//PCM Audio (импульсно-кодовая модуляция) (Pulse Code Modulation) = 1 обозначает, что совершается линейное квантование амплитуды
// Аудио формат, полный список можно получить здесь. Для PCM = 1 (то есть, Линейное квантование). Значения, отличающиеся от 1, обозначают некоторый формат сжатия.

/*
    Приведем таблицу основных форматов сжатия wav-файлов:
    Код  Описание
    0 (0x0000)  Unknown
    1 (0x0001)  PCM/uncompressed
    2 (0x0002)  Microsoft ADPCM
    6 (0x0006)  ITU G.711 a-law
    7 (0x0007)  ITU G.711 µ-law
    17 (0x0011) IMA ADPCM
    20 (0x0016) ITU G.723 ADPCM (Yamaha)
    49 (0x0031) GSM 6.10
    64 (0x0040) ITU G.721 ADPCM
    80 (0x0050) MPEG
    65,536 (0xFFFF) Experimental

    Общеиспользуемые коды сжатия
    (Common Wave Compression Codes)
*/

#define TOPHEADSIZE 44          // размер заголовока (кол-во байт, используемых для заголовка) смещение на 44 байт является началом блока, содержащего аудио-данные (непосредственно, музыка The actual sound data.)
#define SIZEOFEXTENSION 0       // ???? разобраться подробнее  !!! размер расширения ??? размер всех дополнительных байт формата, необходимых для поддержки специфических форматов звука, если он не содержит несжатых данных PCM

#define  FMTPCMSIZE 16          // ??? fmt pulse code modulation размер )(размер фмт импульсно-кодовой модуляции) ???
/*
16        4   Subchunk1Size    16 for PCM.  This is the size of the
                               rest of the Subchunk which follows this number.
*/

#define FMTFACTSIZE 18          // fmt — unix-утилита, переформатирует каждый абзац в файле(ах) и выводит на стандартный вывод.  ????
#define SPKPORT 0x61            // Определение порта спикера, клавиатуры и некоторых других устройств (61-й порт)
#define ONESECOND 650000        // Одна секунда ???

// playmode values
#define    ARGPLAY 1            // аргумент (воспроизведения воспроизведение в стандартном режиме с частотой по умолчанию)
#define ARGSETTIME 2            // аргумент (Установка времени устанавливаем частоту или время) ???

/*
http://microsin.net/programming/ARM/struct-and-typedef-struct-difference.html

В чем разница между struct и typedef struct?   Печать
Добавил(а) microsin
Давайте попробуем разобраться, в чем разница между двумя определениями структур (далее перевод [1]):

struct Foo { ... };
и

typedef struct { ... } Foo;
[C++]

С точки зрения объявления переменных Foo на языке C++ нет разницы, как определить Foo. После того, как Foo была определена либо через struct, либо через typedef struct, можно объявлять переменные Foo так:

Foo bar;
Однако между struct и typedef struct различие есть, и оно тонкое. Дело в том, что struct определяет новый тип. В отличие от этого typedef struct никакого типа не определяет, он только создает ссылку (alias) с именем Foo (ни в коем случае не новый тип) на неименованный тип struct.

Спецификатор typedef. Имя, заданное с участием спецификатора typedef, становится специальным именем. В области действия этой декларации typedef-имя синтаксически эквивалентно ключевому слову и именам типа, связанного с идентификатором. Таким образом, typedef-name является синонимом другого типа. Так что typedef-имя НЕ СОЗДАЕТ НОВЫЙ ТИП, как это делается при декларации класса или enum.

Если декларация определяет неименованный класс (или перечисление enum), первое typedef-имя, заданное в декларации, типа класса (или типа enum) используется для обозначения типа класса (или типа enum) только для целей линковки.
*/

// В языке С, если не использовать typedef, то придется при каждом объявлении переменной данного типа приписывать слева слово "struct"

/*
Таким образом, тонкие отличия есть только в C++, и это пережиток от языка C, где применение struct и typedef struct имеет значение. На языке C есть два разных пространств имен типов: пространство имен тегов struct/union/enum, и пространство имен typedef. Если Вы просто напишете в программе:

struct Foo { ... };
Foo x;
то получите ошибку компиляции, потому что Foo определен только в пространстве имен тегов. Вы должны декларировать переменную x так:

struct Foo x;
В любой момент, когда Вы хотите обратиться к Foo, Вы всегда должны вызывать struct Foo. Это быстро раздражает, тогда Вы можете добавить typedef:

struct Foo { ... };
typedef struct Foo Foo;
Теперь оба выражения, и struct Foo (в пространстве имен тегов) и просто Foo (в пространстве имен typedef), относятся к одному и тому же, и Вы можете свободно декларировать объекты с типом Foo без ключевого слова struct.

Конструкция

typedef struct Foo { ... } Foo;
Является просто объединением декларации структуры и typedef.

И, наконец, конструкция

typedef struct { ... } Foo;
декларирует безымянную структуру, и создает для нее typedef. Так что для такой конструкции у Вас нет имени Foo в пространстве имен тегов, имя Foo есть только в пространстве имен typedef. Это означает, что предварительное декларирование невозможно. Если Вы хотите применить предварительное декларирование, то нужно задать имя для пространства имен тегов.

*/

/*
        WAVE – это формат хранения оцифрованных аудио данных. Данный формат поддерживает данные различной битности, с различной частотой выборки и числом каналов. Данный формат весьма популярен на платформах стандарта IBM PC (и совместимых с ним).
        Этот формат подразумевает хранение аудио данных в особых блоках, которые называют чанками (chunks).


        Форматы данных
        ID = array[1..4] of Char; - идентификатор чанка.


        Все данные хранятся в виде 8-ми битовых чисел, расположенных таким образом, что младшая часть слова данных записывается первой (little-endian)
        Byte    :  | байт 0 |.
        Word  :  | байт 0 | байт 1 |
        Integer : | байт 0 | байт 1 | байт 2 | | байт 3 |

        /*


            Секция fact содержит информацию о содержимом WAV-файла, зависящую от кода компрессии. Она требуется для всех форматов WAVE со сжатием, и требуется, если данные сигнала содержатся внутри секции списка (LIST) "wavl", но не требуется для несжатого формата PCM WAVE (код компрессии 1), который содержит аудиоданные в секции "data".

            Смещение    Размер    Описание    Величина
            0x00    4   Chunk ID    "fact" (0x66616374)
            0x04    4   Chunk Data Size зависит от формата
            0x08    Данные, зависящие от формата (Format Dependant Data)

            Формат секции Fact

            Данные, зависящие от формата (Format Dependant Data)
            В настоящий момент задано только одно поле для данных, зависящих от формата. Это единственное 4-байтное значение, которое указывает число выборок в секции данных аудиосигнала. Эта величина может использоваться вместе с количеством выборок в секунду (Samples Per Second value) указанном в секции формата - для вычисления продолжительности звучания сигнала в секундах.

            По мере появления новых форматов WAVE секция fact будет расширена с добавлением полей после поля числа выборок. Программы могут использовать размер секции fact для определения, какие поля представлены в секции.
*/


// Блок структур/типов данных, необхоидмых для работы с wav-файлом
// OK!
typedef struct {        // Структура верхней части заголовка wav-файла. Эта часть называется riff. Она содержит следующие поля:
    int id;             // id-номер. Он должен быть равен стандартному идентификатору "RIFF" или в шестнадцатиричной сис-ме 0x46464952
    int size;           // Это оставшийся размер цепочки, начиная с этой позиции. Иначе говоря, это размер файла – 8, то есть, исключены поля chunkId и chunkSize.
    int format;         // Содержит символы “WAVE” или в 16-тиричной 0x45564157
} whriff;               // wave head riff

// OK!
typedef struct {        // Структура, следующая за riff-ом. Текущая структура называется fmt - format. Она содержит в себе следующие поля:
    int id;                     // id-номер     Содержит символы “fmt “ или в 16-тиричной 0x20746d66 (обозначает как бы начало-заголовок данного раздела)
    int size;                   // 16 для формата PCM. Это оставшийся размер подцепочки заголовка, начиная с этой позиции.
    short int audioformat;      // аудио-формат    Аудио формат, полный список можно получить здесь: http://audiocoding.ru/assets/meta/2008-05-22-wav-file-structure/wav_formats.txt. Для PCM = 1 (то есть, Линейное квантование). Значения, отличающиеся от 1, обозначают некоторый формат сжатия.
    short int numchannels;      // Количество каналов. Моно = 1, Стерео = 2 и т.д.
    int samplerate;             // скорость выдачи выборок (самплов). По-другому - частота дискретизации. 8000 Гц, 44100 Гц и т.д.
    int byterate;               // количество бит, используемых для хранения одной секунды мультимедийного контента/Количество байт, переданных за секунду воспроизведения.
    short int blockalign;       // Количество байт для одного сэмпла, включая все каналы.
    short int bitspersample;    // кол-во бит на один сампл/Количество бит в сэмпле. Так называемая “глубина” или точность звучания. 8 бит, 16 бит и т.д.
} whfmt;                        // wave head format (структура, описывающая основные параметры wav-файла, которые хранятся в заголовке)

typedef struct { // ??? что это за аргумент  // можно ли его удалить???
    short int sizeofext;        // размер какого текста ???
    int id;                     // id-номер чего ???
    int size;                   // размер чего ????
    int samplelength;           // длина сэмпла ???
} whfact;                       // wave head fact????

// Для чего эта структура????
typedef struct {
    int id;                 // id-номер   ??
    int size;               // размер         ??
    int samplelength;       // длина сэмпла ???
} whfact2;                  // ????? что такое fact??

typedef struct {
    int id;             // id-номер
    int size;           // размер
} whdata;               // возможно wav head data

typedef struct {
    whriff riff;        // wave hear riff ???
    whfmt fmt;          // wave head format ????
    whdata data;        // wave head data -> data
} wavpcm;               // wav pulse code modulation

typedef struct {   // ????
    whriff riff;            // wave hear riff ???
    whfmt fmt;              // wave head format ????
    whfact fact;
    whdata data;            // wave head data ????
} wavfact;  // // название структуры вконце

typedef struct {
    whriff riff;        // wave head riff ???
    whfmt fmt;          // wave head format  ???
    whfact2 fact;
    whdata data;
} wavfact2;  // название структуры вконце

// http://stackoverflow.com/questions/13114241/c-union-struct-explanation
// http://www.codingunit.com/cplusplus-tutorial-structures-typedef-and-unions
// https://en.wikipedia.org/wiki/Typedef     // union


typedef struct {                    // Объединение  (одновременно может хранить значение только одного поля, значения всех остальных полей теряются)
    wavpcm pcm;                 // wav pulse code modulation ?????
} wavhead;                      // заголовок wav-файла

/*
    union {
        members;
    }
    name of current union
*/

/*
http://programmersclub.ru/19/
ОБЪЕДИНЕНИЯ

Из урока 18 вы узнали, как группировать связанную информацию в одной переменной с помощью структур C++. По мере усложнения вашим программам могут потребоваться разные способы просмотра части информации. Кроме того, программе может потребоваться работать с двумя или несколькими значениями, используя при этом только одно значение в каждый момент времени. В таких случаях для хранения данных ваши программы могут использовать объединения. В данном уроке вы изучите, как создавать и использовать объединения для хранения информации. Как вы узнаете, объединения очень похожи на структуры, описанные в уроке 18. Прежде чем вы закончите этот урок, вы освоите следующие основные концепции:

Объединения C++ очень похожи на структуры, за исключением того, как C++ хранит их в памяти; кроме того, объединение может хранить значение только для одного элемента в каждый момент времени.
Объединение представляет собой структуру данных, подобную структуре C++, и состоит из частей, называемых элементами.
Объединение определяет шаблон, с помощью которого программы далее объявляют переменные.
Для обращения к определенному элементу объединения ваши программы используют оператор C++ точку.
Чтобы изменить значения элемента объединения внутри функции, ваша программа должна передать переменную объединения в функцию с помощью адреса.
Анонимное объединение представляет собой объединение, у которого нет имени (тэга).
Как вы узнаете, объединения очень похожи на структуры C++, однако способ, с помощью которого C++ хранит объединения, отличается от способа, с помощью которого C++ хранит структуры.

КАК C++ ХРАНИТ ОБЪЕДИНЕНИЯ

Внутри ваших программ объединения C++ очень похожи на структуры. Например, следующая структура определяет объединение с именем distance, содержащее два элемента:

union distance

{
   int miles;
   long meters;
};

Как и в случае со структурой, описание объединения не распределяет память. Вместо этого описание предоставляет шаблон для будущего объявления переменных. Чтобы объявить переменную объединения, вы можете использовать любой из следующих форматов:

union distance

{
   union distance

   {
      int miles; int miles;
      long meters; long meters;
   } japan, germany, franee;
};
distance japan, germany, franee;

Как видите, данное объединение содержит два элемента: miles и meters. Эти объявления создают переменные, которые позволяют вам хранить расстояния до указанных стран. Как и для структуры, ваша программа может присвоить значение любому элементу. Однако в отличие от структуры значение может быть присвоено только одному элементу в каждый момент времени. Когда вы объявляете объединение, компилятор C++ распределяет память для хранения самого большого элемента объединения. В случае объединения distance компилятор распределяет достаточно памяти для хранения значения типа long, как показано на рис. 19.

Рис. 19. C++ распределяет память, достаточную для хранения только самого большого элемента объединения.

Предположим, что ваша программа присваивает значение элементу miles, как показано ниже:

japan.miles = 12123;

Если далее ваша программа присваивает значение элементу meters, значение, присвоенное элементу miles, теряется.

Следующая программа USEUNION.CPP иллюстрирует использование объединения distance. Сначала программа присваивает значение элементу

miles и выводит это значение. Затем программа присваивает значение элементу meters. При этом значение элемента miles теряется:

#include <iostream.h>

void main(void)

{
   union distance

   {
      int miles;
      long meters;
   } walk;

   walk.miles = 5;
   cout << "Пройденное расстояние в милях " << walk.miles << endl;
   walk.meters = 10000;
   cout << "Пройденное расстояние в метрах " << walk.meters << endl;
}

Как видите, программа обращается к элементам объединения с помощью точки, аналогичная запись использовалась при обращении к элементам структуры в уроке 18.
*/

// Заголовки функций (allow run this functions from any place in .c file. For example, playwav64.c
void ShowErr(char, char*);          // Вывод ошибки (результат функции - число, аргументы - число и указатель на число (или символы))
char TopHeadCheck(wavhead*, whriff**, whfmt**); // проверка вершины заголовка
int DataHeadCheck(wavhead*, whriff*, whfmt*, whdata**, char);  // Проверка заголовка данных ???
int FileRead(FILE**, char*, int);                  // Чтение файла
void SetRawKbd(char);                       // установить необработанное...
char CheckArgs(short int);                  // Проврека каких-то аргументов
short int InitIOPorts(char);                    // Инициализация портов ввода-вывода
int InitWavFile(FILE**, char*, wavhead*, whfmt**);          // Какая-то инциализация wav-файла