JUCE  v5.1.1-3-g1a0b28c73
JUCE API
AudioFormatManager Class Reference

A class for keeping a list of available audio formats, and for deciding which one to use to open a given file. More...

#include <juce_AudioFormatManager.h>

Collaboration diagram for AudioFormatManager:

Public Member Functions

 AudioFormatManager ()
 Creates an empty format manager. More...
 
 ~AudioFormatManager ()
 Destructor. More...
 
AudioFormat ** begin () const noexcept
 Iterator access to the list of known formats. More...
 
void clearFormats ()
 Clears the list of known formats. More...
 
AudioFormatReadercreateReaderFor (const File &audioFile)
 Searches through the known formats to try to create a suitable reader for this file. More...
 
AudioFormatReadercreateReaderFor (InputStream *audioFileStream)
 Searches through the known formats to try to create a suitable reader for this stream. More...
 
AudioFormat ** end () const noexcept
 Iterator access to the list of known formats. More...
 
AudioFormatfindFormatForFileExtension (const String &fileExtension) const
 Looks for which of the known formats is listed as being for a given file extension. More...
 
AudioFormatgetDefaultFormat () const
 Returns the format which has been set as the default one. More...
 
AudioFormatgetKnownFormat (int index) const
 Returns one of the registered file formats. More...
 
int getNumKnownFormats () const
 Returns the number of currently registered file formats. More...
 
String getWildcardForAllFormats () const
 Returns a set of wildcards for file-matching that contains the extensions for all known formats. More...
 
void registerBasicFormats ()
 Handy method to make it easy to register the formats that come with Juce. More...
 
void registerFormat (AudioFormat *newFormat, bool makeThisTheDefaultFormat)
 Adds a format to the manager's list of available file types. More...
 

Private Attributes

int defaultFormatIndex
 
OwnedArray< AudioFormatknownFormats
 

Detailed Description

A class for keeping a list of available audio formats, and for deciding which one to use to open a given file.

After creating an AudioFormatManager object, you should call registerFormat() or registerBasicFormats() to give it a list of format types that it can use.

See also
AudioFormat

Constructor & Destructor Documentation

◆ AudioFormatManager()

AudioFormatManager::AudioFormatManager ( )

Creates an empty format manager.

Before it'll be any use, you'll need to call registerFormat() with all the formats you want it to be able to recognise.

◆ ~AudioFormatManager()

AudioFormatManager::~AudioFormatManager ( )

Destructor.

Member Function Documentation

◆ begin()

AudioFormat** AudioFormatManager::begin ( ) const
inlinenoexcept

Iterator access to the list of known formats.

◆ clearFormats()

void AudioFormatManager::clearFormats ( )

Clears the list of known formats.

◆ createReaderFor() [1/2]

AudioFormatReader* AudioFormatManager::createReaderFor ( const File audioFile)

Searches through the known formats to try to create a suitable reader for this file.

If none of the registered formats can open the file, it'll return nullptr. It's the caller's responsibility to delete the reader that is returned.

◆ createReaderFor() [2/2]

AudioFormatReader* AudioFormatManager::createReaderFor ( InputStream audioFileStream)

Searches through the known formats to try to create a suitable reader for this stream.

The stream object that is passed-in will be deleted by this method or by the reader that is returned, so the caller should not keep any references to it.

The stream that is passed-in must be capable of being repositioned so that all the formats can have a go at opening it.

If none of the registered formats can open the stream, it'll return nullptr. If it returns a reader, it's the caller's responsibility to delete the reader.

◆ end()

AudioFormat** AudioFormatManager::end ( ) const
inlinenoexcept

Iterator access to the list of known formats.

◆ findFormatForFileExtension()

AudioFormat* AudioFormatManager::findFormatForFileExtension ( const String fileExtension) const

Looks for which of the known formats is listed as being for a given file extension.

The extension may have a dot before it, so e.g. ".wav" or "wav" are both ok.

◆ getDefaultFormat()

AudioFormat* AudioFormatManager::getDefaultFormat ( ) const

Returns the format which has been set as the default one.

You can set a format as being the default when it is registered. It's useful when you want to write to a file, because the best format may change between platforms, e.g. AIFF is preferred on the Mac, WAV on Windows.

If none has been set as the default, this method will just return the first one in the list.

◆ getKnownFormat()

AudioFormat* AudioFormatManager::getKnownFormat ( int  index) const

Returns one of the registered file formats.

◆ getNumKnownFormats()

int AudioFormatManager::getNumKnownFormats ( ) const

Returns the number of currently registered file formats.

◆ getWildcardForAllFormats()

String AudioFormatManager::getWildcardForAllFormats ( ) const

Returns a set of wildcards for file-matching that contains the extensions for all known formats.

E.g. if might return "*.wav;*.aiff" if it just knows about wavs and aiffs.

◆ registerBasicFormats()

void AudioFormatManager::registerBasicFormats ( )

Handy method to make it easy to register the formats that come with Juce.

Currently, this will add WAV and AIFF to the list.

◆ registerFormat()

void AudioFormatManager::registerFormat ( AudioFormat newFormat,
bool  makeThisTheDefaultFormat 
)

Adds a format to the manager's list of available file types.

The object passed-in will be deleted by this object, so don't keep a pointer to it!

If makeThisTheDefaultFormat is true, then the getDefaultFormat() method will return this one when called.

Member Data Documentation

◆ defaultFormatIndex

int AudioFormatManager::defaultFormatIndex
private

◆ knownFormats

OwnedArray<AudioFormat> AudioFormatManager::knownFormats
private

The documentation for this class was generated from the following file: