transport.cc

Go to the documentation of this file.

 // This Source Code Form is licensed MPL-2.0: http://mozilla.org/MPL/2.0
#include "transport.hh"
#include "utils.hh"
#include "internal.hh"
 
namespace Ase {
 
// == SpeakerArrangement ==
// Count the number of channels described by the SpeakerArrangement.
uint8
speaker_arrangement_count_channels (SpeakerArrangement spa)
{
  const uint64_t bits = uint64_t (speaker_arrangement_channels (spa));
  if_constexpr (sizeof (bits) == sizeof (long))
    return __builtin_popcountl (bits);
  return __builtin_popcountll (bits);
}
 
// Check if the SpeakerArrangement describes auxillary channels.
bool
speaker_arrangement_is_aux (SpeakerArrangement spa)
{
  return uint64_t (spa) & uint64_t (SpeakerArrangement::AUX);
}
 
// Retrieve the bitmask describing the SpeakerArrangement channels.
SpeakerArrangement
speaker_arrangement_channels (SpeakerArrangement spa)
{
  const uint64_t bits = uint64_t (spa) & uint64_t (speaker_arrangement_channels_mask);
  return SpeakerArrangement (bits);
}
 
const char*
speaker_arrangement_bit_name (SpeakerArrangement spa)
{
  switch (spa)
    { // https://wikipedia.org/wiki/Surround_sound
    case SpeakerArrangement::NONE:                  return "-";
      // case SpeakerArrangement::MONO:                 return "Mono";
    case SpeakerArrangement::FRONT_LEFT:            return "FL";
    case SpeakerArrangement::FRONT_RIGHT:           return "FR";
    case SpeakerArrangement::FRONT_CENTER:          return "FC";
    case SpeakerArrangement::LOW_FREQUENCY:         return "LFE";
    case SpeakerArrangement::BACK_LEFT:             return "BL";
    case SpeakerArrangement::BACK_RIGHT:                return "BR";
    case SpeakerArrangement::AUX:                       return "AUX";
    case SpeakerArrangement::STEREO:                    return "Stereo";
    case SpeakerArrangement::STEREO_21:                 return "Stereo-2.1";
    case SpeakerArrangement::STEREO_30:                 return "Stereo-3.0";
    case SpeakerArrangement::STEREO_31:                 return "Stereo-3.1";
    case SpeakerArrangement::SURROUND_50:           return "Surround-5.0";
    case SpeakerArrangement::SURROUND_51:           return "Surround-5.1";
#if 0 // TODO: dynamic multichannel support
    case SpeakerArrangement::FRONT_LEFT_OF_CENTER:      return "FLC";
    case SpeakerArrangement::FRONT_RIGHT_OF_CENTER:     return "FRC";
    case SpeakerArrangement::BACK_CENTER:               return "BC";
    case SpeakerArrangement::SIDE_LEFT:                 return "SL";
    case SpeakerArrangement::SIDE_RIGHT:            return "SR";
    case SpeakerArrangement::TOP_CENTER:            return "TC";
    case SpeakerArrangement::TOP_FRONT_LEFT:            return "TFL";
    case SpeakerArrangement::TOP_FRONT_CENTER:          return "TFC";
    case SpeakerArrangement::TOP_FRONT_RIGHT:           return "TFR";
    case SpeakerArrangement::TOP_BACK_LEFT:         return "TBL";
    case SpeakerArrangement::TOP_BACK_CENTER:           return "TBC";
    case SpeakerArrangement::TOP_BACK_RIGHT:            return "TBR";
    case SpeakerArrangement::SIDE_SURROUND_50:          return "Side-Surround-5.0";
    case SpeakerArrangement::SIDE_SURROUND_51:          return "Side-Surround-5.1";
#endif
    }
  return nullptr;
}
 
std::string
speaker_arrangement_desc (SpeakerArrangement spa)
{
  const bool isaux = speaker_arrangement_is_aux (spa);
  const SpeakerArrangement chan = speaker_arrangement_channels (spa);
  const char *chname = SpeakerArrangement::MONO == chan ? "Mono" : speaker_arrangement_bit_name (chan);
  std::string s (chname ? chname : "<INVALID>");
  if (isaux)
    s = std::string (speaker_arrangement_bit_name (SpeakerArrangement::AUX)) + "(" + s + ")";
  return s;
}
 
} // Ase