Reads and Writes WAV format audio files. More...

#include "juce_WavAudioFormat.h"

Inheritance diagram for juce::WavAudioFormat:

Public Member Functions
	WavAudioFormat ()
	Creates a format object.

	~WavAudioFormat () override
	Destructor.

Array< int >	getPossibleSampleRates () override
	Returns a set of sample rates that the format can read and write.

Array< int >	getPossibleBitDepths () override
	Returns a set of bit depths that the format can read and write.

bool	canDoStereo () override
	Returns true if the format can do 2-channel audio.

bool	canDoMono () override
	Returns true if the format can do 1-channel audio.

bool	isChannelLayoutSupported (const AudioChannelSet &channelSet) override
	Returns true if the channel layout is supported by this format.

AudioFormatReader *	createReaderFor (InputStream *sourceStream, bool deleteStreamIfOpeningFails) override
	Tries to create an object that can read from a stream containing audio data in this format.

MemoryMappedAudioFormatReader *	createMemoryMappedReader (const File &) override
	Attempts to create a MemoryMappedAudioFormatReader, if possible for this format.

MemoryMappedAudioFormatReader *	createMemoryMappedReader (FileInputStream *) override

AudioFormatWriter *	createWriterFor (OutputStream *streamToWriteTo, double sampleRateToUse, unsigned int numberOfChannels, int bitsPerSample, const StringPairArray &metadataValues, int qualityOptionIndex) override
	Tries to create an object that can write to a stream with this audio format.

AudioFormatWriter *	createWriterFor (OutputStream *streamToWriteTo, double sampleRateToUse, const AudioChannelSet &channelLayout, int bitsPerSample, const StringPairArray &metadataValues, int qualityOptionIndex) override
	Tries to create an object that can write to a stream with this audio format.

bool	replaceMetadataInFile (const File &wavFile, const StringPairArray &newMetadata)
	Utility function to replace the metadata in a wav file with a new set of values.

virtual AudioFormatWriter *	createWriterFor (OutputStream *streamToWriteTo, double sampleRateToUse, unsigned int numberOfChannels, int bitsPerSample, const StringPairArray &metadataValues, int qualityOptionIndex)=0
	Tries to create an object that can write to a stream with this audio format.

virtual AudioFormatWriter *	createWriterFor (OutputStream *streamToWriteTo, double sampleRateToUse, const AudioChannelSet &channelLayout, int bitsPerSample, const StringPairArray &metadataValues, int qualityOptionIndex)
	Tries to create an object that can write to a stream with this audio format.

Public Member Functions inherited from juce::AudioFormat
virtual	~AudioFormat ()
	Destructor.

const String &	getFormatName () const
	Returns the name of this format.

virtual StringArray	getFileExtensions () const
	Returns all the file extensions that might apply to a file of this format.

virtual bool	canHandleFile (const File &fileToTest)
	Returns true if this the given file can be read by this format.

virtual bool	isCompressed ()
	Returns true if the format uses compressed data.

virtual StringArray	getQualityOptions ()
	Returns a list of different qualities that can be used when writing.

Static Public Member Functions
static StringPairArray	createBWAVMetadata (const String &description, const String &originator, const String &originatorRef, Time dateAndTime, int64 timeReferenceSamples, const String &codingHistory)
	Utility function to fill out the appropriate metadata for a BWAV file.

Static Public Attributes
static const char *const	bwavDescription
	Metadata property name used in BWAV chunks.

static const char *const	bwavOriginator
	Metadata property name used in BWAV chunks.

static const char *const	bwavOriginatorRef
	Metadata property name used in BWAV chunks.

static const char *const	bwavOriginationDate
	Metadata property name used in BWAV chunks.

static const char *const	bwavOriginationTime
	Metadata property name used in BWAV chunks.

static const char *const	bwavCodingHistory
	Metadata property name used in BWAV chunks.

static const char *const	bwavTimeReference
	Metadata property name used in BWAV chunks.

static const char *const	acidOneShot
	Metadata property name used in acid chunks.

static const char *const	acidRootSet
	Metadata property name used in acid chunks.

static const char *const	acidStretch
	Metadata property name used in acid chunks.

static const char *const	acidDiskBased
	Metadata property name used in acid chunks.

static const char *const	acidizerFlag
	Metadata property name used in acid chunks.

static const char *const	acidRootNote
	Metadata property name used in acid chunks.

static const char *const	acidBeats
	Metadata property name used in acid chunks.

static const char *const	acidDenominator
	Metadata property name used in acid chunks.

static const char *const	acidNumerator
	Metadata property name used in acid chunks.

static const char *const	acidTempo
	Metadata property name used in acid chunks.

static const char *const	riffInfoArchivalLocation
	Metadata property name used in INFO chunks.

static const char *const	riffInfoArtist
	Metadata property name used in INFO chunks.

static const char *const	riffInfoBaseURL
	Metadata property name used in INFO chunks.

static const char *const	riffInfoCinematographer
	Metadata property name used in INFO chunks.

static const char *const	riffInfoComment
	Metadata property name used in INFO chunks.

static const char *const	riffInfoComment2
	Metadata property name used in INFO chunks.

static const char *const	riffInfoComments
	Metadata property name used in INFO chunks.

static const char *const	riffInfoCommissioned
	Metadata property name used in INFO chunks.

static const char *const	riffInfoCopyright
	Metadata property name used in INFO chunks.

static const char *const	riffInfoCostumeDesigner
	Metadata property name used in INFO chunks.

static const char *const	riffInfoCountry
	Metadata property name used in INFO chunks.

static const char *const	riffInfoCropped
	Metadata property name used in INFO chunks.

static const char *const	riffInfoDateCreated
	Metadata property name used in INFO chunks.

static const char *const	riffInfoDateTimeOriginal
	Metadata property name used in INFO chunks.

static const char *const	riffInfoDefaultAudioStream
	Metadata property name used in INFO chunks.

static const char *const	riffInfoDimension
	Metadata property name used in INFO chunks.

static const char *const	riffInfoDirectory
	Metadata property name used in INFO chunks.

static const char *const	riffInfoDistributedBy
	Metadata property name used in INFO chunks.

static const char *const	riffInfoDotsPerInch
	Metadata property name used in INFO chunks.

static const char *const	riffInfoEditedBy
	Metadata property name used in INFO chunks.

static const char *const	riffInfoEighthLanguage
	Metadata property name used in INFO chunks.

static const char *const	riffInfoEncodedBy
	Metadata property name used in INFO chunks.

static const char *const	riffInfoEndTimecode
	Metadata property name used in INFO chunks.

static const char *const	riffInfoEngineer
	Metadata property name used in INFO chunks.

static const char *const	riffInfoFifthLanguage
	Metadata property name used in INFO chunks.

static const char *const	riffInfoFirstLanguage
	Metadata property name used in INFO chunks.

static const char *const	riffInfoFourthLanguage
	Metadata property name used in INFO chunks.

static const char *const	riffInfoGenre
	Metadata property name used in INFO chunks.

static const char *const	riffInfoKeywords
	Metadata property name used in INFO chunks.

static const char *const	riffInfoLanguage
	Metadata property name used in INFO chunks.

static const char *const	riffInfoLength
	Metadata property name used in INFO chunks.

static const char *const	riffInfoLightness
	Metadata property name used in INFO chunks.

static const char *const	riffInfoLocation
	Metadata property name used in INFO chunks.

static const char *const	riffInfoLogoIconURL
	Metadata property name used in INFO chunks.

static const char *const	riffInfoLogoURL
	Metadata property name used in INFO chunks.

static const char *const	riffInfoMedium
	Metadata property name used in INFO chunks.

static const char *const	riffInfoMoreInfoBannerImage
	Metadata property name used in INFO chunks.

static const char *const	riffInfoMoreInfoBannerURL
	Metadata property name used in INFO chunks.

static const char *const	riffInfoMoreInfoText
	Metadata property name used in INFO chunks.

static const char *const	riffInfoMoreInfoURL
	Metadata property name used in INFO chunks.

static const char *const	riffInfoMusicBy
	Metadata property name used in INFO chunks.

static const char *const	riffInfoNinthLanguage
	Metadata property name used in INFO chunks.

static const char *const	riffInfoNumberOfParts
	Metadata property name used in INFO chunks.

static const char *const	riffInfoOrganisation
	Metadata property name used in INFO chunks.

static const char *const	riffInfoPart
	Metadata property name used in INFO chunks.

static const char *const	riffInfoProducedBy
	Metadata property name used in INFO chunks.

static const char *const	riffInfoProductName
	Metadata property name used in INFO chunks.

static const char *const	riffInfoProductionDesigner
	Metadata property name used in INFO chunks.

static const char *const	riffInfoProductionStudio
	Metadata property name used in INFO chunks.

static const char *const	riffInfoRate
	Metadata property name used in INFO chunks.

static const char *const	riffInfoRated
	Metadata property name used in INFO chunks.

static const char *const	riffInfoRating
	Metadata property name used in INFO chunks.

static const char *const	riffInfoRippedBy
	Metadata property name used in INFO chunks.

static const char *const	riffInfoSecondaryGenre
	Metadata property name used in INFO chunks.

static const char *const	riffInfoSecondLanguage
	Metadata property name used in INFO chunks.

static const char *const	riffInfoSeventhLanguage
	Metadata property name used in INFO chunks.

static const char *const	riffInfoSharpness
	Metadata property name used in INFO chunks.

static const char *const	riffInfoSixthLanguage
	Metadata property name used in INFO chunks.

static const char *const	riffInfoSoftware
	Metadata property name used in INFO chunks.

static const char *const	riffInfoSoundSchemeTitle
	Metadata property name used in INFO chunks.

static const char *const	riffInfoSource
	Metadata property name used in INFO chunks.

static const char *const	riffInfoSourceFrom
	Metadata property name used in INFO chunks.

static const char *const	riffInfoStarring_ISTR
	Metadata property name used in INFO chunks.

static const char *const	riffInfoStarring_STAR
	Metadata property name used in INFO chunks.

static const char *const	riffInfoStartTimecode
	Metadata property name used in INFO chunks.

static const char *const	riffInfoStatistics
	Metadata property name used in INFO chunks.

static const char *const	riffInfoSubject
	Metadata property name used in INFO chunks.

static const char *const	riffInfoTapeName
	Metadata property name used in INFO chunks.

static const char *const	riffInfoTechnician
	Metadata property name used in INFO chunks.

static const char *const	riffInfoThirdLanguage
	Metadata property name used in INFO chunks.

static const char *const	riffInfoTimeCode
	Metadata property name used in INFO chunks.

static const char *const	riffInfoTitle
	Metadata property name used in INFO chunks.

static const char *const	riffInfoTrackNo
	Metadata property name used in INFO chunks.

static const char *const	riffInfoTrackNumber
	Metadata property name used in INFO chunks.

static const char *const	riffInfoURL
	Metadata property name used in INFO chunks.

static const char *const	riffInfoVegasVersionMajor
	Metadata property name used in INFO chunks.

static const char *const	riffInfoVegasVersionMinor
	Metadata property name used in INFO chunks.

static const char *const	riffInfoVersion
	Metadata property name used in INFO chunks.

static const char *const	riffInfoWatermarkURL
	Metadata property name used in INFO chunks.

static const char *const	riffInfoWrittenBy
	Metadata property name used in INFO chunks.

static const char *const	riffInfoYear
	Metadata property name used in INFO chunks.

static const char *const	aswgContentType
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgProject
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgOriginator
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgOriginatorStudio
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgNotes
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgSession
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgState
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgEditor
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgMixer
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgFxChainName
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgChannelConfig
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgAmbisonicFormat
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgAmbisonicChnOrder
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgAmbisonicNorm
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgMicType
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgMicConfig
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgMicDistance
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgRecordingLoc
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgIsDesigned
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgRecEngineer
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgRecStudio
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgImpulseLocation
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgCategory
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgSubCategory
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgCatId
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgUserCategory
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgUserData
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgVendorCategory
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgFxName
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgLibrary
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgCreatorId
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgSourceId
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgRmsPower
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgLoudness
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgLoudnessRange
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgMaxPeak
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgSpecDensity
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgZeroCrossRate
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgPapr
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgText
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgEfforts
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgEffortType
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgProjection
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgLanguage
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgTimingRestriction
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgCharacterName
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgCharacterGender
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgCharacterAge
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgCharacterRole
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgActorName
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgActorGender
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgDirector
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgDirection
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgFxUsed
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgUsageRights
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgIsUnion
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgAccent
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgEmotion
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgComposor
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgArtist
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgSongTitle
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgGenre
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgSubGenre
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgProducer
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgMusicSup
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgInstrument
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgMusicPublisher
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgRightsOwner
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgIsSource
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgIsLoop
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgIntensity
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgIsFinal
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgOrderRef
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgIsOst
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgIsCinematic
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgIsLicensed
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgIsDiegetic
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgMusicVersion
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgIsrcId
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgTempo
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgTimeSig
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgInKey
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgBillingCode
	Metadata property name used in ASWG/iXML chunks.

static const char *const	aswgVersion
	Metadata property name used in ASWG/iXML chunks.

static const char *const	ISRC
	Metadata property name used when reading an ISRC code from an AXML chunk.

static const char *const	internationalStandardRecordingCode
	Metadata property name used when reading and writing ISRC codes to/from AXML chunks.

static const char *const	tracktionLoopInfo
	Metadata property name used when reading a WAV file with a Tracktion chunk.

Additional Inherited Members
Protected Member Functions inherited from juce::AudioFormat
	AudioFormat (String formatName, StringArray fileExtensions)
	Creates an AudioFormat object.

	AudioFormat (StringRef formatName, StringRef fileExtensions)
	Creates an AudioFormat object.

Detailed Description

Reads and Writes WAV format audio files.

See also: AudioFormat

@tags{Audio}

Definition at line 37 of file juce_WavAudioFormat.h.

Constructor & Destructor Documentation

◆ WavAudioFormat()

juce::WavAudioFormat::WavAudioFormat ( )

Creates a format object.

Definition at line 1943 of file juce_WavAudioFormat.cpp.

◆ ~WavAudioFormat()

juce::WavAudioFormat::~WavAudioFormat ( )

override

Destructor.

Definition at line 1944 of file juce_WavAudioFormat.cpp.

Member Function Documentation

◆ canDoMono()

bool juce::WavAudioFormat::canDoMono ( )

overridevirtual

Returns true if the format can do 1-channel audio.

Implements juce::AudioFormat.

Definition at line 1958 of file juce_WavAudioFormat.cpp.

◆ canDoStereo()

bool juce::WavAudioFormat::canDoStereo ( )

overridevirtual

Returns true if the format can do 2-channel audio.

Implements juce::AudioFormat.

Definition at line 1957 of file juce_WavAudioFormat.cpp.

◆ createBWAVMetadata()

StringPairArray juce::WavAudioFormat::createBWAVMetadata	(	const String &	description,
		const String &	originator,
		const String &	originatorRef,
		Time	dateAndTime,
		int64	timeReferenceSamples,
		const String &	codingHistory
	)

static

Utility function to fill out the appropriate metadata for a BWAV file.

This just makes it easier than using the property names directly, and it fills out the time and date in the right format.

Definition at line 58 of file juce_WavAudioFormat.cpp.

◆ createMemoryMappedReader() [1/2]

MemoryMappedAudioFormatReader * juce::WavAudioFormat::createMemoryMappedReader ( const File & file )

overridevirtual

Attempts to create a MemoryMappedAudioFormatReader, if possible for this format.

If the format does not support this, the method will return nullptr;

Reimplemented from juce::AudioFormat.

Definition at line 1997 of file juce_WavAudioFormat.cpp.

◆ createMemoryMappedReader() [2/2]

MemoryMappedAudioFormatReader * juce::WavAudioFormat::createMemoryMappedReader ( FileInputStream * fin )

overridevirtual

Reimplemented from juce::AudioFormat.

Definition at line 2002 of file juce_WavAudioFormat.cpp.

◆ createReaderFor()

AudioFormatReader * juce::WavAudioFormat::createReaderFor	(	InputStream *	sourceStream,
		bool	deleteStreamIfOpeningFails
	)

overridevirtual

Tries to create an object that can read from a stream containing audio data in this format.

The reader object that is returned can be used to read from the stream, and should then be deleted by the caller.

Parameters

sourceStream	the stream to read from - the AudioFormatReader object that is returned will delete this stream when it no longer needs it.
deleteStreamIfOpeningFails	if no reader can be created, this determines whether this method should delete the stream object that was passed-in. (If a valid reader is returned, it will always be in charge of deleting the stream, so this parameter is ignored)

See also: AudioFormatReader

Implements juce::AudioFormat.

Definition at line 1976 of file juce_WavAudioFormat.cpp.

◆ createWriterFor() [1/4]

AudioFormatWriter * juce::AudioFormat::createWriterFor	(	OutputStream *	streamToWriteTo,
		double	sampleRateToUse,
		const AudioChannelSet &	channelLayout,
		int	bitsPerSample,
		const StringPairArray &	metadataValues,
		int	qualityOptionIndex
	)

virtual

Tries to create an object that can write to a stream with this audio format.

The writer object that is returned can be used to write to the stream, and should then be deleted by the caller.

If the stream can't be created for some reason (e.g. the parameters passed in here aren't suitable), this will return nullptr.

Parameters

streamToWriteTo	the stream that the data will go to - this will be deleted by the AudioFormatWriter object when it's no longer needed. If no AudioFormatWriter can be created by this method, the stream will NOT be deleted, so that the caller can re-use it to try to open a different format, etc
sampleRateToUse	the sample rate for the file, which must be one of the ones returned by getPossibleSampleRates()
channelLayout	the channel layout for the file. Use isChannelLayoutSupported to check if the writer supports this layout.
bitsPerSample	the bits per sample to use - this must be one of the values returned by getPossibleBitDepths()
metadataValues	a set of metadata values that the writer should try to write to the stream. Exactly what these are depends on the format, and the subclass doesn't actually have to do anything with them if it doesn't want to. Have a look at the specific format implementation classes to see possible values that can be used
qualityOptionIndex	the index of one of compression qualities returned by the getQualityOptions() method. If there aren't any quality options for this format, just pass 0 in this parameter, as it'll be ignored

See also: AudioFormatWriter

Reimplemented from juce::AudioFormat.

Definition at line 187 of file juce_AudioFormat.cpp.

◆ createWriterFor() [2/4]

AudioFormatWriter * juce::WavAudioFormat::createWriterFor	(	OutputStream *	streamToWriteTo,
		double	sampleRateToUse,
		const AudioChannelSet &	channelLayout,
		int	bitsPerSample,
		const StringPairArray &	metadataValues,
		int	qualityOptionIndex
	)

overridevirtual

Tries to create an object that can write to a stream with this audio format.

The writer object that is returned can be used to write to the stream, and should then be deleted by the caller.

If the stream can't be created for some reason (e.g. the parameters passed in here aren't suitable), this will return nullptr.

Parameters

streamToWriteTo	the stream that the data will go to - this will be deleted by the AudioFormatWriter object when it's no longer needed. If no AudioFormatWriter can be created by this method, the stream will NOT be deleted, so that the caller can re-use it to try to open a different format, etc
sampleRateToUse	the sample rate for the file, which must be one of the ones returned by getPossibleSampleRates()
channelLayout	the channel layout for the file. Use isChannelLayoutSupported to check if the writer supports this layout.
bitsPerSample	the bits per sample to use - this must be one of the values returned by getPossibleBitDepths()
metadataValues	a set of metadata values that the writer should try to write to the stream. Exactly what these are depends on the format, and the subclass doesn't actually have to do anything with them if it doesn't want to. Have a look at the specific format implementation classes to see possible values that can be used
qualityOptionIndex	the index of one of compression qualities returned by the getQualityOptions() method. If there aren't any quality options for this format, just pass 0 in this parameter, as it'll be ignored

See also: AudioFormatWriter

Reimplemented from juce::AudioFormat.

Definition at line 2023 of file juce_WavAudioFormat.cpp.

◆ createWriterFor() [3/4]

AudioFormatWriter * juce::WavAudioFormat::createWriterFor	(	OutputStream *	streamToWriteTo,
		double	sampleRateToUse,
		unsigned int	numberOfChannels,
		int	bitsPerSample,
		const StringPairArray &	metadataValues,
		int	qualityOptionIndex
	)

overridevirtual

Tries to create an object that can write to a stream with this audio format.

The writer object that is returned can be used to write to the stream, and should then be deleted by the caller.

If the stream can't be created for some reason (e.g. the parameters passed in here aren't suitable), this will return nullptr.

Parameters

streamToWriteTo	the stream that the data will go to - this will be deleted by the AudioFormatWriter object when it's no longer needed. If no AudioFormatWriter can be created by this method, the stream will NOT be deleted, so that the caller can re-use it to try to open a different format, etc
sampleRateToUse	the sample rate for the file, which must be one of the ones returned by getPossibleSampleRates()
numberOfChannels	the number of channels
bitsPerSample	the bits per sample to use - this must be one of the values returned by getPossibleBitDepths()
metadataValues	a set of metadata values that the writer should try to write to the stream. Exactly what these are depends on the format, and the subclass doesn't actually have to do anything with them if it doesn't want to. Have a look at the specific format implementation classes to see possible values that can be used
qualityOptionIndex	the index of one of compression qualities returned by the getQualityOptions() method. If there aren't any quality options for this format, just pass 0 in this parameter, as it'll be ignored

See also: AudioFormatWriter

Implements juce::AudioFormat.

Definition at line 2015 of file juce_WavAudioFormat.cpp.

◆ createWriterFor() [4/4]

virtual AudioFormatWriter * juce::AudioFormat::createWriterFor	(	OutputStream *	streamToWriteTo,
		double	sampleRateToUse,
		unsigned int	numberOfChannels,
		int	bitsPerSample,
		const StringPairArray &	metadataValues,
		int	qualityOptionIndex
	)

virtual

Tries to create an object that can write to a stream with this audio format.

The writer object that is returned can be used to write to the stream, and should then be deleted by the caller.

If the stream can't be created for some reason (e.g. the parameters passed in here aren't suitable), this will return nullptr.

Parameters

streamToWriteTo	the stream that the data will go to - this will be deleted by the AudioFormatWriter object when it's no longer needed. If no AudioFormatWriter can be created by this method, the stream will NOT be deleted, so that the caller can re-use it to try to open a different format, etc
sampleRateToUse	the sample rate for the file, which must be one of the ones returned by getPossibleSampleRates()
numberOfChannels	the number of channels
bitsPerSample	the bits per sample to use - this must be one of the values returned by getPossibleBitDepths()
metadataValues	a set of metadata values that the writer should try to write to the stream. Exactly what these are depends on the format, and the subclass doesn't actually have to do anything with them if it doesn't want to. Have a look at the specific format implementation classes to see possible values that can be used
qualityOptionIndex	the index of one of compression qualities returned by the getQualityOptions() method. If there aren't any quality options for this format, just pass 0 in this parameter, as it'll be ignored

See also: AudioFormatWriter

Implements juce::AudioFormat.

◆ getPossibleBitDepths()

Array< int > juce::WavAudioFormat::getPossibleBitDepths ( )

overridevirtual

Returns a set of bit depths that the format can read and write.

Implements juce::AudioFormat.

Definition at line 1952 of file juce_WavAudioFormat.cpp.

◆ getPossibleSampleRates()

Array< int > juce::WavAudioFormat::getPossibleSampleRates ( )

overridevirtual

Returns a set of sample rates that the format can read and write.

Implements juce::AudioFormat.

Definition at line 1946 of file juce_WavAudioFormat.cpp.

◆ isChannelLayoutSupported()

bool juce::WavAudioFormat::isChannelLayoutSupported ( const AudioChannelSet & channelSet )

overridevirtual

Returns true if the channel layout is supported by this format.

Reimplemented from juce::AudioFormat.

Definition at line 1960 of file juce_WavAudioFormat.cpp.

◆ replaceMetadataInFile()

bool juce::WavAudioFormat::replaceMetadataInFile	(	const File &	wavFile,
		const StringPairArray &	newMetadata
	)

Utility function to replace the metadata in a wav file with a new set of values.

If possible, this cheats by overwriting just the metadata region of the file, rather than by copying the whole file again.

Definition at line 2073 of file juce_WavAudioFormat.cpp.

Member Data Documentation

◆ acidBeats

const char *const juce::WavAudioFormat::acidBeats

static

Metadata property name used in acid chunks.

Definition at line 88 of file juce_WavAudioFormat.h.

◆ acidDenominator

const char *const juce::WavAudioFormat::acidDenominator

static

Metadata property name used in acid chunks.

Definition at line 89 of file juce_WavAudioFormat.h.

◆ acidDiskBased

const char *const juce::WavAudioFormat::acidDiskBased

static

Metadata property name used in acid chunks.

Definition at line 85 of file juce_WavAudioFormat.h.

◆ acidizerFlag

const char *const juce::WavAudioFormat::acidizerFlag

static

Metadata property name used in acid chunks.

Definition at line 86 of file juce_WavAudioFormat.h.

◆ acidNumerator

const char *const juce::WavAudioFormat::acidNumerator

static

Metadata property name used in acid chunks.

Definition at line 90 of file juce_WavAudioFormat.h.

◆ acidOneShot

const char *const juce::WavAudioFormat::acidOneShot

static

Metadata property name used in acid chunks.

Definition at line 82 of file juce_WavAudioFormat.h.

◆ acidRootNote

const char *const juce::WavAudioFormat::acidRootNote

static

Metadata property name used in acid chunks.

Definition at line 87 of file juce_WavAudioFormat.h.

◆ acidRootSet

const char *const juce::WavAudioFormat::acidRootSet

static

Metadata property name used in acid chunks.

Definition at line 83 of file juce_WavAudioFormat.h.

◆ acidStretch

const char *const juce::WavAudioFormat::acidStretch

static

Metadata property name used in acid chunks.

Definition at line 84 of file juce_WavAudioFormat.h.

◆ acidTempo

const char *const juce::WavAudioFormat::acidTempo

static

Metadata property name used in acid chunks.

Definition at line 91 of file juce_WavAudioFormat.h.