Specification.h

Go to the documentation of this file.

/*******************************************************************************
 * Copyright 2009-2016 Jörg Müller
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 ******************************************************************************/
 
#pragma once

 
#include "Audaspace.h"

#define AUD_FORMAT_SIZE(format) (format & 0x0F)
#define AUD_DEVICE_SAMPLE_SIZE(specs) (specs.channels * (specs.format & 0x0F))
#define AUD_SAMPLE_SIZE(specs) (specs.channels * sizeof(sample_t))

#define AUD_COMPARE_SPECS(s1, s2) ((s1.rate == s2.rate) && (s1.channels == s2.channels))

#define AUD_CHANNEL_BIT(channel) (0x01 << channel)
 
AUD_NAMESPACE_BEGIN

enum SampleFormat
{
    FORMAT_INVALID = 0x00,      
    FORMAT_U8      = 0x01,      
    FORMAT_S16     = 0x12,      
    FORMAT_S24     = 0x13,      
    FORMAT_S32     = 0x14,      
    FORMAT_FLOAT32 = 0x24,      
    FORMAT_FLOAT64 = 0x28       
};

enum Channels
{
    CHANNELS_INVALID    = 0,    
    CHANNELS_MONO       = 1,    
    CHANNELS_STEREO     = 2,    
    CHANNELS_STEREO_LFE = 3,    
    CHANNELS_SURROUND4  = 4,    
    CHANNELS_SURROUND5  = 5,    
    CHANNELS_SURROUND51 = 6,    
    CHANNELS_SURROUND61 = 7,    
    CHANNELS_SURROUND71 = 8 
};

enum Channel
{
    CHANNEL_FRONT_LEFT = 0,
    CHANNEL_FRONT_RIGHT,
    CHANNEL_FRONT_CENTER,
    CHANNEL_LFE,
    CHANNEL_REAR_LEFT,
    CHANNEL_REAR_RIGHT,
    CHANNEL_REAR_CENTER,
    CHANNEL_SIDE_LEFT,
    CHANNEL_SIDE_RIGHT,
    CHANNEL_MAX
};

enum class ResampleQuality
{
    FASTEST = 0, 
    LOW,         
    MEDIUM,      
    HIGH         
};

typedef double SampleRate;

constexpr SampleRate RATE_INVALID = 0;          
constexpr SampleRate RATE_8000    = 8000;       
constexpr SampleRate RATE_16000   = 16000;      
constexpr SampleRate RATE_11025   = 11025;      
constexpr SampleRate RATE_22050   = 22050;      
constexpr SampleRate RATE_32000   = 32000;      
constexpr SampleRate RATE_44100   = 44100;      
constexpr SampleRate RATE_48000   = 48000;      
constexpr SampleRate RATE_88200   = 88200;      
constexpr SampleRate RATE_96000   = 96000;      
constexpr SampleRate RATE_192000  = 192000;     

struct Specs
{
    SampleRate rate;

    Channels channels;
};

struct DeviceSpecs
{
    SampleFormat format;
 
    union
    {
        struct
        {
            SampleRate rate;

            Channels channels;
        };
        Specs specs;
    };
};
 
AUD_NAMESPACE_END