|
JUCE-7.0.12-0-g4f43011b96 JUCE-7.0.12-0-g4f43011b96
JUCE — C++ application framework with suport for VST, VST3, LV2 audio plug-ins
« « « Anklang Documentation |
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"
Public Member Functions | |
| AudioFormatManager () | |
| Creates an empty format manager. | |
| ~AudioFormatManager () | |
| Destructor. | |
| void | registerFormat (AudioFormat *newFormat, bool makeThisTheDefaultFormat) |
| Adds a format to the manager's list of available file types. | |
| void | registerBasicFormats () |
| Handy method to make it easy to register the formats that come with JUCE. | |
| void | clearFormats () |
| Clears the list of known formats. | |
| int | getNumKnownFormats () const |
| Returns the number of currently registered file formats. | |
| AudioFormat * | getKnownFormat (int index) const |
| Returns one of the registered file formats. | |
| AudioFormat ** | begin () noexcept |
| Iterator access to the list of known formats. | |
| AudioFormat *const * | begin () const noexcept |
| Iterator access to the list of known formats. | |
| AudioFormat ** | end () noexcept |
| Iterator access to the list of known formats. | |
| AudioFormat *const * | end () const noexcept |
| Iterator access to the list of known formats. | |
| AudioFormat * | findFormatForFileExtension (const String &fileExtension) const |
| Looks for which of the known formats is listed as being for a given file extension. | |
| AudioFormat * | getDefaultFormat () const |
| Returns the format which has been set as the default one. | |
| String | getWildcardForAllFormats () const |
| Returns a set of wildcards for file-matching that contains the extensions for all known formats. | |
| AudioFormatReader * | createReaderFor (const File &audioFile) |
| Searches through the known formats to try to create a suitable reader for this file. | |
| AudioFormatReader * | createReaderFor (std::unique_ptr< InputStream > audioFileStream) |
| Searches through the known formats to try to create a suitable reader for this stream. | |
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.
@tags{Audio}
Definition at line 41 of file juce_AudioFormatManager.h.
| juce::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.
Definition at line 29 of file juce_AudioFormatManager.cpp.
| juce::AudioFormatManager::~AudioFormatManager | ( | ) |
Destructor.
Definition at line 30 of file juce_AudioFormatManager.cpp.
|
noexcept |
Iterator access to the list of known formats.
Definition at line 86 of file juce_AudioFormatManager.h.
|
noexcept |
Iterator access to the list of known formats.
Definition at line 83 of file juce_AudioFormatManager.h.
| void juce::AudioFormatManager::clearFormats | ( | ) |
Clears the list of known formats.
Definition at line 80 of file juce_AudioFormatManager.cpp.
| AudioFormatReader * juce::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.
Definition at line 120 of file juce_AudioFormatManager.cpp.
| AudioFormatReader * juce::AudioFormatManager::createReaderFor | ( | std::unique_ptr< 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.
Definition at line 135 of file juce_AudioFormatManager.cpp.
|
noexcept |
Iterator access to the list of known formats.
Definition at line 92 of file juce_AudioFormatManager.h.
|
noexcept |
Iterator access to the list of known formats.
Definition at line 89 of file juce_AudioFormatManager.h.
| AudioFormat * juce::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.
Definition at line 90 of file juce_AudioFormatManager.cpp.
| AudioFormat * juce::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.
Definition at line 88 of file juce_AudioFormatManager.cpp.
| AudioFormat * juce::AudioFormatManager::getKnownFormat | ( | int | index | ) | const |
Returns one of the registered file formats.
Definition at line 87 of file juce_AudioFormatManager.cpp.
| int juce::AudioFormatManager::getNumKnownFormats | ( | ) | const |
Returns the number of currently registered file formats.
Definition at line 86 of file juce_AudioFormatManager.cpp.
| String juce::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.
Definition at line 102 of file juce_AudioFormatManager.cpp.
| void juce::AudioFormatManager::registerBasicFormats | ( | ) |
Handy method to make it easy to register the formats that come with JUCE.
This will add WAV and AIFF to the list, along with any other formats enabled in either the Projucer or your application's preprocessor definitions.
Definition at line 54 of file juce_AudioFormatManager.cpp.
| void juce::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.
Definition at line 33 of file juce_AudioFormatManager.cpp.