FileFormats.h File Reference

#include "Identifier.h"
#include "SampleFormat.h"
#include <memory>
#include <sndfile.h>

Include dependency graph for FileFormats.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	SFFileCloser
struct	SFFile

Functions
FILE_FORMATS_API int	sf_num_headers ()
	Get the number of container formats supported by libsndfile. More...
FILE_FORMATS_API wxString	sf_header_index_name (int format_num)
	Get the name of a container format from libsndfile. More...
FILE_FORMATS_API unsigned int	sf_header_index_to_type (int format_num)
FILE_FORMATS_API int	sf_num_encodings ()
	Get the number of data encodings libsndfile supports (in any container or none. More...
FILE_FORMATS_API wxString	sf_encoding_index_name (int encoding_num)
	Get the string name of the data encoding of the requested format. More...
FILE_FORMATS_API unsigned int	sf_encoding_index_to_subtype (int encoding_num)
FILE_FORMATS_API wxString	sf_header_name (int format)
	Get the string name of the specified container format. More...
FILE_FORMATS_API wxString	sf_header_shortname (int format)
	Get an abbreviated form of the string name of the specified format. More...
FILE_FORMATS_API wxString	sf_header_extension (int format)
	Get the most common file extension for the given format. More...
wxString	sf_encoding_name (int encoding_num)
	Get the string name of the specified data encoding. More...
int	sf_num_simple_formats ()
SF_FORMAT_INFO *	sf_simple_format (int i)
FILE_FORMATS_API bool	sf_subtype_more_than_16_bits (unsigned int format)
FILE_FORMATS_API bool	sf_subtype_is_integer (unsigned int format)
FILE_FORMATS_API int	sf_subtype_bytes_per_sample (unsigned int format)
FILE_FORMATS_API sampleFormat	sf_subtype_to_effective_format (unsigned int format)
	Choose the narrowest value in the sampleFormat enumeration for a given libsndfile format. More...
FILE_FORMATS_API FileExtensions	sf_get_all_extensions ()
wxString	sf_normalize_name (const char *name)
template<typename R , typename F , typename... Args>
R	SFCall (F fun, Args &&... args)

Function Documentation

sf_encoding_index_name()

FILE_FORMATS_API wxString sf_encoding_index_name

(

int

encoding_num

)

Get the string name of the data encoding of the requested format.

uses SFC_GET_FORMAT_SUBTYPE

Definition at line 79 of file FileFormats.cpp.

{
   SF_FORMAT_INFO format_info ;
 
   memset(&format_info, 0, sizeof(format_info));
   format_info.format = i;
   sf_command (NULL, SFC_GET_FORMAT_SUBTYPE,
               &format_info, sizeof (format_info));
   return sf_normalize_name(format_info.name);
}

References sf_normalize_name().

Referenced by anonymous_namespace{ExportPCM.cpp}::GetEncodings(), and ImportRawDialog::ImportRawDialog().

Here is the call graph for this function:

Here is the caller graph for this function:

sf_encoding_index_to_subtype()

FILE_FORMATS_API unsigned int sf_encoding_index_to_subtype

(

int

encoding_num

)

Definition at line 90 of file FileFormats.cpp.

{
   SF_FORMAT_INFO format_info ;
 
   memset(&format_info, 0, sizeof(format_info));
   format_info.format = i;
   sf_command (NULL, SFC_GET_FORMAT_SUBTYPE,
               &format_info, sizeof (format_info));
 
   return format_info.format & SF_FORMAT_SUBMASK;
}

Referenced by anonymous_namespace{ExportPCM.cpp}::GetEncodings(), and ImportRawDialog::ImportRawDialog().

Here is the caller graph for this function:

sf_encoding_name()

wxString sf_encoding_name

(

int

encoding_num

)

Get the string name of the specified data encoding.

AND encoding_num with SF_FORMAT_SUBMASK to get only the data encoding and then use SFC_GET_FORMAT_INFO to get the description

Parameters

encoding_num

the libsndfile encoding to get the name for (only the data encoding is used)

Definition at line 152 of file FileFormats.cpp.

{
   SF_FORMAT_INFO format_info;
 
   memset(&format_info, 0, sizeof(format_info));
   format_info.format = (encoding & SF_FORMAT_SUBMASK);
   sf_command(NULL, SFC_GET_FORMAT_INFO, &format_info, sizeof(format_info));
 
   return sf_normalize_name(format_info.name);
}

References sf_normalize_name().

Here is the call graph for this function:

sf_get_all_extensions()

FILE_FORMATS_API FileExtensions sf_get_all_extensions

(

)

Definition at line 236 of file FileFormats.cpp.

{
   FileExtensions exts;
   SF_FORMAT_INFO format_info;
   int count, k;
 
   memset(&format_info, 0, sizeof(format_info));
 
   sf_command(NULL, SFC_GET_FORMAT_MAJOR_COUNT,
              &count, sizeof(count));
 
   for(k=0; k<count; k++) {
      format_info.format = k;
      sf_command(NULL, SFC_GET_FORMAT_MAJOR,
                 &format_info, sizeof (format_info)) ;
 
      exts.push_back(LAT1CTOWX(format_info.extension));
   }
 
   // Some other extensions that are often sound files
   // but aren't included by libsndfile
 
   exts.insert( exts.end(), {
      wxT("aif") , // AIFF file with a DOS-style extension
      wxT("ircam") ,
      wxT("snd") ,
      wxT("svx") ,
      wxT("svx8") ,
      wxT("sv16") ,
   } );
 
   return exts;
}

References exts, and LAT1CTOWX.

sf_header_extension()

FILE_FORMATS_API wxString sf_header_extension

(

int

format

)

Get the most common file extension for the given format.

AND the given format with SF_FORMAT_TYPEMASK to get just the container format, then retrieve the most common extension using SFC_GET_FORMAT_INFO.

Parameters

format

the libsndfile format to get the name for (only the container part is used)

Definition at line 141 of file FileFormats.cpp.

{
   SF_FORMAT_INFO format_info;
 
   memset(&format_info, 0, sizeof(format_info));
   format_info.format = (format & SF_FORMAT_TYPEMASK);
   sf_command(NULL, SFC_GET_FORMAT_INFO, &format_info, sizeof(format_info));
 
   return LAT1CTOWX(format_info.extension);
}

References anonymous_namespace{ExportPCM.cpp}::format, and LAT1CTOWX.

Referenced by ExportPCM::GetFormatInfo().

Here is the caller graph for this function:

sf_header_index_name()

FILE_FORMATS_API wxString sf_header_index_name

(

int

format_num

)

Get the name of a container format from libsndfile.

Uses SFC_GET_FORMAT_MAJOR in the sf_command() interface. Resulting C string from libsndfile is converted to a wxString

Parameters

format_num

The libsndfile format number for the container format required

Definition at line 42 of file FileFormats.cpp.

{
   SF_FORMAT_INFO format_info;
 
   memset(&format_info, 0, sizeof(format_info));
   format_info.format = format;
   sf_command(NULL, SFC_GET_FORMAT_MAJOR,
              &format_info, sizeof (format_info)) ;
 
   return LAT1CTOWX(format_info.name);
}

References anonymous_namespace{ExportPCM.cpp}::format, and LAT1CTOWX.

Referenced by anonymous_namespace{ExportPCM.cpp}::ExportOptionsSFEditor::ExportOptionsSFEditor().

Here is the caller graph for this function:

sf_header_index_to_type()

FILE_FORMATS_API unsigned int sf_header_index_to_type

(

int

format_num

)

Definition at line 54 of file FileFormats.cpp.

{
   SF_FORMAT_INFO format_info ;
 
   memset(&format_info, 0, sizeof(format_info));
   format_info.format = i;
   sf_command (NULL, SFC_GET_FORMAT_MAJOR,
               &format_info, sizeof (format_info));
 
   return format_info.format & SF_FORMAT_TYPEMASK;
}

Referenced by anonymous_namespace{ExportPCM.cpp}::ExportOptionsSFEditor::ExportOptionsSFEditor().

Here is the caller graph for this function:

sf_header_name()

FILE_FORMATS_API wxString sf_header_name

(

int

format

)

Get the string name of the specified container format.

AND format with SF_FORMAT_TYPEMASK to get only the container format and then use SFC_GET_FORMAT_INFO to get the description

Parameters

format

the libsndfile format to get the name for (only the container part is used)

Definition at line 106 of file FileFormats.cpp.

{
   SF_FORMAT_INFO format_info;
 
   memset(&format_info, 0, sizeof(format_info));
   format_info.format = (format & SF_FORMAT_TYPEMASK);
   sf_command(NULL, SFC_GET_FORMAT_INFO, &format_info, sizeof(format_info));
 
   return LAT1CTOWX(format_info.name);
}

References anonymous_namespace{ExportPCM.cpp}::format, and LAT1CTOWX.

Referenced by PCMImportFileHandle::GetFileDescription(), and PCMExportProcessor::Initialize().

Here is the caller graph for this function:

sf_header_shortname()

FILE_FORMATS_API wxString sf_header_shortname

(

int

format

)

Get an abbreviated form of the string name of the specified format.

Do sf_header_name() then truncate the string at the first space in the name to get just the first word of the format name.

Parameters

format

the libsndfile format to get the name for (only the container part is used)

Definition at line 117 of file FileFormats.cpp.

{
   SF_FORMAT_INFO format_info;
   int i;
   wxString s;
 
   memset(&format_info, 0, sizeof(format_info));
   format_info.format = (format & SF_FORMAT_TYPEMASK);
   sf_command(NULL, SFC_GET_FORMAT_INFO, &format_info, sizeof(format_info));
 
   MallocString<> tmp { strdup( format_info.name ) };
   i = 0;
   while(tmp[i]) {
      if (tmp[i]==' ')
         tmp[i] = 0;
      else
         i++;
   }
 
   s = LAT1CTOWX(tmp.get());
 
   return s;
}

References anonymous_namespace{ExportPCM.cpp}::format, and LAT1CTOWX.

Referenced by ExportPCM::GetFormatInfo(), anonymous_namespace{ExportPCM.cpp}::LoadEncoding(), and anonymous_namespace{ExportPCM.cpp}::SaveEncoding().

Here is the caller graph for this function:

sf_normalize_name()

wxString sf_normalize_name

(

const char *

name

)

Definition at line 270 of file FileFormats.cpp.

{
   wxString n = LAT1CTOWX(name);
 
   n.Replace(wxT("8 bit"), wxT("8-bit"));
   n.Replace(wxT("16 bit"), wxT("16-bit"));
   n.Replace(wxT("24 bit"), wxT("24-bit"));
   n.Replace(wxT("32 bit"), wxT("32-bit"));
   n.Replace(wxT("64 bit"), wxT("64-bit"));
 
   return n;
}

References LAT1CTOWX, name, and wxT().

Referenced by sf_encoding_index_name(), and sf_encoding_name().

Here is the call graph for this function:

Here is the caller graph for this function:

sf_num_encodings()

FILE_FORMATS_API int sf_num_encodings

(

)

Get the number of data encodings libsndfile supports (in any container or none.

Definition at line 70 of file FileFormats.cpp.

{
   int count ;
 
   sf_command (NULL, SFC_GET_FORMAT_SUBTYPE_COUNT, &count, sizeof (int)) ;
 
   return count;
}

Referenced by anonymous_namespace{ExportPCM.cpp}::GetEncodings(), and ImportRawDialog::ImportRawDialog().

Here is the caller graph for this function:

sf_num_headers()

FILE_FORMATS_API int sf_num_headers

(

)

Get the number of container formats supported by libsndfile.

Uses SFC_GET_FORMAT_MAJOR_COUNT in sf_command interface

Definition at line 32 of file FileFormats.cpp.

{
   int count;
 
   sf_command(NULL, SFC_GET_FORMAT_MAJOR_COUNT,
              &count, sizeof(count));
 
   return count;
}

Referenced by anonymous_namespace{ExportPCM.cpp}::ExportOptionsSFEditor::ExportOptionsSFEditor().

Here is the caller graph for this function:

sf_num_simple_formats()

int sf_num_simple_formats

(

)

Definition at line 163 of file FileFormats.cpp.

{
   int count ;
 
   sf_command (NULL, SFC_GET_SIMPLE_FORMAT_COUNT, &count, sizeof (int)) ;
 
   return count;
}

sf_simple_format()

SF_FORMAT_INFO * sf_simple_format

(

int

i

)

Definition at line 174 of file FileFormats.cpp.

{
   memset(&g_format_info, 0, sizeof(g_format_info));
 
   g_format_info.format = i;
   sf_command (NULL, SFC_GET_SIMPLE_FORMAT,
               &g_format_info, sizeof(g_format_info));
 
   return &g_format_info;
}

References g_format_info.

sf_subtype_bytes_per_sample()

FILE_FORMATS_API int sf_subtype_bytes_per_sample

(

unsigned int

format

)

Definition at line 202 of file FileFormats.cpp.

                                                    {
   unsigned int subtype = format & SF_FORMAT_SUBMASK;
   if( subtype == SF_FORMAT_PCM_S8 )
      return 1;
   if( subtype == SF_FORMAT_PCM_U8 )
      return 1;
   if( subtype == SF_FORMAT_PCM_16 )
      return 2;
   if( subtype == SF_FORMAT_PCM_24 )
      return 3;
   if( subtype == SF_FORMAT_PCM_32 )
      return 4;
   if( subtype == SF_FORMAT_FLOAT )
      return 4;
   if( subtype == SF_FORMAT_DOUBLE )
      return 8;
 
   // might be different to 2, but this is good enough for 
   // WAV and AIFF file size error trapping.
   return 2;
}

References anonymous_namespace{ExportPCM.cpp}::format.

Referenced by PCMExportProcessor::Initialize().

Here is the caller graph for this function:

sf_subtype_is_integer()

FILE_FORMATS_API bool sf_subtype_is_integer

(

unsigned int

format

)

Definition at line 194 of file FileFormats.cpp.

{
   unsigned int subtype = format & SF_FORMAT_SUBMASK;
   return (subtype == SF_FORMAT_PCM_16 ||
           subtype == SF_FORMAT_PCM_24 ||
           subtype == SF_FORMAT_PCM_32);
}

References anonymous_namespace{ExportPCM.cpp}::format.

Referenced by AUPImportFileHandle::AddSamples(), and PCMExportProcessor::Initialize().

Here is the caller graph for this function:

sf_subtype_more_than_16_bits()

FILE_FORMATS_API bool sf_subtype_more_than_16_bits

(

unsigned int

format

)

Definition at line 185 of file FileFormats.cpp.

{
   unsigned int subtype = format & SF_FORMAT_SUBMASK;
   return (subtype == SF_FORMAT_FLOAT ||
           subtype == SF_FORMAT_DOUBLE ||
           subtype == SF_FORMAT_PCM_24 ||
           subtype == SF_FORMAT_PCM_32);
}

References anonymous_namespace{ExportPCM.cpp}::format.

Referenced by AUPImportFileHandle::AddSamples(), PCMExportProcessor::Initialize(), and sf_subtype_to_effective_format().

Here is the caller graph for this function:

sf_subtype_to_effective_format()

FILE_FORMATS_API sampleFormat sf_subtype_to_effective_format

(

unsigned int

format

)

Choose the narrowest value in the sampleFormat enumeration for a given libsndfile format.

Definition at line 224 of file FileFormats.cpp.

{
   unsigned int subtype = format & SF_FORMAT_SUBMASK;
   if (subtype == SF_FORMAT_PCM_24)
      return int24Sample;
   else if (sf_subtype_more_than_16_bits(format))
      return widestSampleFormat;
   else
      return int16Sample;
}

References anonymous_namespace{ExportPCM.cpp}::format, int16Sample, int24Sample, sf_subtype_more_than_16_bits(), and widestSampleFormat.

Referenced by ImportRaw(), and PCMImportFileHandle::PCMImportFileHandle().

Here is the call graph for this function:

Here is the caller graph for this function:

SFCall()

template<typename R , typename F , typename... Args>

R SFCall ( F  fun, Args &&...  args  )

inline

Definition at line 132 of file FileFormats.h.

{
   //std::lock_guard<std::mutex> guard{ libSndFileMutex };
   return fun(std::forward<Args>(args)...);
}