2015-05-24 04:55:12 +00:00
|
|
|
// Copyright 2008 Dolphin Emulator Project
|
2021-07-05 01:22:19 +00:00
|
|
|
// SPDX-License-Identifier: GPL-2.0-or-later
|
2008-12-08 04:46:09 +00:00
|
|
|
|
2009-03-28 08:57:34 +00:00
|
|
|
// ---------------------------------------------------------------------------------
|
|
|
|
// Class: WaveFileWriter
|
|
|
|
// Description: Simple utility class to make it easy to write long 16-bit stereo
|
2008-10-08 18:57:33 +00:00
|
|
|
// audio streams to disk.
|
|
|
|
// Use Start() to start recording to a file, and AddStereoSamples to add wave data.
|
|
|
|
// The float variant will convert from -1.0-1.0 range and clamp.
|
|
|
|
// Alternatively, AddSamplesBE for big endian wave data.
|
|
|
|
// If Stop is not called when it destructs, the destructor will call Stop().
|
2009-03-28 08:57:34 +00:00
|
|
|
// ---------------------------------------------------------------------------------
|
2008-12-08 04:46:09 +00:00
|
|
|
|
2014-02-10 18:54:46 +00:00
|
|
|
#pragma once
|
2008-12-08 04:46:09 +00:00
|
|
|
|
2015-12-03 01:00:48 +00:00
|
|
|
#include <array>
|
2014-03-12 19:33:41 +00:00
|
|
|
#include <string>
|
2017-01-15 20:46:32 +00:00
|
|
|
|
2014-09-08 01:06:58 +00:00
|
|
|
#include "Common/CommonTypes.h"
|
2020-09-15 10:29:41 +00:00
|
|
|
#include "Common/IOFile.h"
|
2008-12-08 04:46:09 +00:00
|
|
|
|
Remove NonCopyable
The class NonCopyable is, like the name says, supposed to disallow
copying. But should it allow moving?
For a long time, NonCopyable used to not allow moving. (It declared
a deleted copy constructor and assigment operator without declaring
a move constructor and assignment operator, making the compiler
implicitly delete the move constructor and assignment operator.)
That's fine if the classes that inherit from NonCopyable don't need
to be movable or if writing the move constructor and assignment
operator by hand is fine, but that's not the case for all classes,
as I discovered when I was working on the DirectoryBlob PR.
Because of that, I decided to make NonCopyable movable in c7602cc,
allowing me to use NonCopyable in DirectoryBlob.h. That was however
an unfortunate decision, because some of the classes that inherit
from NonCopyable have incorrect behavior when moved by default-
generated move constructors and assignment operators, and do not
explicitly delete the move constructors and assignment operators,
relying on NonCopyable being non-movable.
So what can we do about this? There are four solutions that I can
think of:
1. Make NonCopyable non-movable and tell DirectoryBlob to suck it.
2. Keep allowing moving NonCopyable, and expect that classes that
don't support moving will delete the move constructor and
assignment operator manually. Not only is this inconsistent
(having classes disallow copying one way and disallow moving
another way), but deleting the move constructor and assignment
operator manually is too easy to forget compared to how tricky
the resulting problems are.
3. Have one "MovableNonCopyable" and one "NonMovableNonCopyable".
It works, but it feels rather silly...
4. Don't have a NonCopyable class at all. Considering that deleting
the copy constructor and assignment operator only takes two lines
of code, I don't see much of a reason to keep NonCopyable. I
suppose that there was more of a point in having NonCopyable back
in the pre-C++11 days, when it wasn't possible to use "= delete".
I decided to go with the fourth one (like the commit title says).
The implementation of the commit is fairly straight-forward, though
I would like to point out that I skipped adding "= delete" lines
for classes whose only reason for being uncopyable is that they
contain uncopyable classes like File::IOFile and std::unique_ptr,
because the compiler makes such classes uncopyable automatically.
2017-08-04 21:57:12 +00:00
|
|
|
class WaveFileWriter
|
2008-10-08 18:57:33 +00:00
|
|
|
{
|
|
|
|
public:
|
|
|
|
WaveFileWriter();
|
|
|
|
~WaveFileWriter();
|
2008-12-08 04:46:09 +00:00
|
|
|
|
Remove NonCopyable
The class NonCopyable is, like the name says, supposed to disallow
copying. But should it allow moving?
For a long time, NonCopyable used to not allow moving. (It declared
a deleted copy constructor and assigment operator without declaring
a move constructor and assignment operator, making the compiler
implicitly delete the move constructor and assignment operator.)
That's fine if the classes that inherit from NonCopyable don't need
to be movable or if writing the move constructor and assignment
operator by hand is fine, but that's not the case for all classes,
as I discovered when I was working on the DirectoryBlob PR.
Because of that, I decided to make NonCopyable movable in c7602cc,
allowing me to use NonCopyable in DirectoryBlob.h. That was however
an unfortunate decision, because some of the classes that inherit
from NonCopyable have incorrect behavior when moved by default-
generated move constructors and assignment operators, and do not
explicitly delete the move constructors and assignment operators,
relying on NonCopyable being non-movable.
So what can we do about this? There are four solutions that I can
think of:
1. Make NonCopyable non-movable and tell DirectoryBlob to suck it.
2. Keep allowing moving NonCopyable, and expect that classes that
don't support moving will delete the move constructor and
assignment operator manually. Not only is this inconsistent
(having classes disallow copying one way and disallow moving
another way), but deleting the move constructor and assignment
operator manually is too easy to forget compared to how tricky
the resulting problems are.
3. Have one "MovableNonCopyable" and one "NonMovableNonCopyable".
It works, but it feels rather silly...
4. Don't have a NonCopyable class at all. Considering that deleting
the copy constructor and assignment operator only takes two lines
of code, I don't see much of a reason to keep NonCopyable. I
suppose that there was more of a point in having NonCopyable back
in the pre-C++11 days, when it wasn't possible to use "= delete".
I decided to go with the fourth one (like the commit title says).
The implementation of the commit is fairly straight-forward, though
I would like to point out that I skipped adding "= delete" lines
for classes whose only reason for being uncopyable is that they
contain uncopyable classes like File::IOFile and std::unique_ptr,
because the compiler makes such classes uncopyable automatically.
2017-08-04 21:57:12 +00:00
|
|
|
WaveFileWriter(const WaveFileWriter&) = delete;
|
|
|
|
WaveFileWriter& operator=(const WaveFileWriter&) = delete;
|
|
|
|
WaveFileWriter(WaveFileWriter&&) = delete;
|
|
|
|
WaveFileWriter& operator=(WaveFileWriter&&) = delete;
|
|
|
|
|
2022-07-03 22:07:06 +00:00
|
|
|
bool Start(const std::string& filename, u32 sample_rate_divisor);
|
2008-10-08 18:57:33 +00:00
|
|
|
void Stop();
|
2014-09-06 15:21:44 +00:00
|
|
|
|
2008-10-08 18:57:33 +00:00
|
|
|
void SetSkipSilence(bool skip) { skip_silence = skip; }
|
2022-07-03 22:07:06 +00:00
|
|
|
// big endian
|
|
|
|
void AddStereoSamplesBE(const short* sample_data, u32 count, u32 sample_rate_divisor,
|
|
|
|
int l_volume, int r_volume);
|
2013-12-11 13:43:58 +00:00
|
|
|
u32 GetAudioSize() const { return audio_size; }
|
2018-04-12 12:18:04 +00:00
|
|
|
|
2014-09-06 15:21:44 +00:00
|
|
|
private:
|
2015-12-03 01:00:48 +00:00
|
|
|
static constexpr size_t BUFFER_SIZE = 32 * 1024;
|
2016-06-24 08:43:46 +00:00
|
|
|
|
2014-09-06 15:21:44 +00:00
|
|
|
void Write(u32 value);
|
|
|
|
void Write4(const char* ptr);
|
2022-07-03 22:07:06 +00:00
|
|
|
|
|
|
|
File::IOFile file;
|
2016-06-11 22:52:45 +00:00
|
|
|
std::string basename;
|
2022-07-03 22:07:06 +00:00
|
|
|
u32 file_index = 0;
|
|
|
|
u32 audio_size = 0;
|
|
|
|
|
|
|
|
u32 current_sample_rate_divisor;
|
|
|
|
std::array<short, BUFFER_SIZE> conv_buffer{};
|
|
|
|
|
|
|
|
bool skip_silence = false;
|
2008-10-08 18:57:33 +00:00
|
|
|
};
|