Originally committed to SVN as r3390.
This commit is contained in:
parent
0276b31225
commit
5501c42cb0
4 changed files with 568 additions and 0 deletions
|
@ -1791,6 +1791,14 @@
|
||||||
RelativePath="..\..\src\audio_karaoke.h"
|
RelativePath="..\..\src\audio_karaoke.h"
|
||||||
>
|
>
|
||||||
</File>
|
</File>
|
||||||
|
<File
|
||||||
|
RelativePath="..\..\src\audio_renderer.cpp"
|
||||||
|
>
|
||||||
|
</File>
|
||||||
|
<File
|
||||||
|
RelativePath="..\..\src\audio_renderer.h"
|
||||||
|
>
|
||||||
|
</File>
|
||||||
<File
|
<File
|
||||||
RelativePath="..\..\src\audio_spectrum.cpp"
|
RelativePath="..\..\src\audio_spectrum.cpp"
|
||||||
>
|
>
|
||||||
|
|
|
@ -200,6 +200,7 @@ aegisub_2_2_SOURCES = \
|
||||||
audio_provider_quicktime.cpp \
|
audio_provider_quicktime.cpp \
|
||||||
audio_provider_ram.cpp \
|
audio_provider_ram.cpp \
|
||||||
audio_provider_stream.cpp \
|
audio_provider_stream.cpp \
|
||||||
|
audio_renderer.cpp \
|
||||||
audio_spectrum.cpp \
|
audio_spectrum.cpp \
|
||||||
auto4_base.cpp \
|
auto4_base.cpp \
|
||||||
avisynth_wrap.cpp \
|
avisynth_wrap.cpp \
|
||||||
|
|
350
aegisub/src/audio_renderer.cpp
Normal file
350
aegisub/src/audio_renderer.cpp
Normal file
|
@ -0,0 +1,350 @@
|
||||||
|
// Copyright (c) 2009, Niels Martin Hansen
|
||||||
|
// All rights reserved.
|
||||||
|
//
|
||||||
|
// Redistribution and use in source and binary forms, with or without
|
||||||
|
// modification, are permitted provided that the following conditions are met:
|
||||||
|
//
|
||||||
|
// * Redistributions of source code must retain the above copyright notice,
|
||||||
|
// this list of conditions and the following disclaimer.
|
||||||
|
// * Redistributions in binary form must reproduce the above copyright notice,
|
||||||
|
// this list of conditions and the following disclaimer in the documentation
|
||||||
|
// and/or other materials provided with the distribution.
|
||||||
|
// * Neither the name of the Aegisub Group nor the names of its contributors
|
||||||
|
// may be used to endorse or promote products derived from this software
|
||||||
|
// without specific prior written permission.
|
||||||
|
//
|
||||||
|
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||||
|
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||||
|
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
|
||||||
|
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||||
|
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||||||
|
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||||||
|
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||||||
|
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||||
|
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||||
|
// POSSIBILITY OF SUCH DAMAGE.
|
||||||
|
//
|
||||||
|
// Aegisub Project http://www.aegisub.org/
|
||||||
|
//
|
||||||
|
// $Id$
|
||||||
|
|
||||||
|
/// @file audio_renderer.cpp
|
||||||
|
/// @brief Base classes for audio renderers (spectrum, waveform, ...)
|
||||||
|
/// @ingroup audio_ui
|
||||||
|
|
||||||
|
|
||||||
|
#include "audio_renderer.h"
|
||||||
|
#include <wx/bitmap.h>
|
||||||
|
#include <set>
|
||||||
|
|
||||||
|
|
||||||
|
/// @class AudioRendererBitmapCache
|
||||||
|
/// @brief Caches bitmaps of rendered audio at a specific resolution
|
||||||
|
///
|
||||||
|
/// Used internally by the AudioRenderer class.
|
||||||
|
class AudioRendererBitmapCache {
|
||||||
|
/// Width of cached bitmaps
|
||||||
|
int width;
|
||||||
|
/// Height of cached bitmaps
|
||||||
|
int height;
|
||||||
|
|
||||||
|
/// Memory size of each cached image, for cache management
|
||||||
|
size_t bytes_per_image;
|
||||||
|
|
||||||
|
// Cached bitmaps
|
||||||
|
// Intentionally not doxygened, too internal
|
||||||
|
struct CachedBitmap {
|
||||||
|
// The bitmap itself
|
||||||
|
wxBitmap bmp;
|
||||||
|
// "Timestamp" of last access (not necessarily related to any clocks)
|
||||||
|
int last_access;
|
||||||
|
|
||||||
|
CachedBitmap(wxBitmap bmp = wxBitmap()) : bmp(bmp), last_access(0) { }
|
||||||
|
~CachedBitmap() { }
|
||||||
|
|
||||||
|
bool operator < (const CachedBitmap &other) const { return last_access < other.last_access; }
|
||||||
|
};
|
||||||
|
|
||||||
|
typedef std::map<int, CachedBitmap> CacheType;
|
||||||
|
CacheType cache;
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// @brief Constructor
|
||||||
|
///
|
||||||
|
/// Does nothing.
|
||||||
|
AudioRendererBitmapCache();
|
||||||
|
|
||||||
|
/// @brief Destructor
|
||||||
|
///
|
||||||
|
/// Does nothing.
|
||||||
|
~AudioRendererBitmapCache();
|
||||||
|
|
||||||
|
/// @brief Age the cache, purging old items
|
||||||
|
/// @param max_size Maximum allowed cache size, in bytes
|
||||||
|
///
|
||||||
|
/// Purges the least recently used bitmaps to bring the cache size below max_size.
|
||||||
|
/// Aging is a somewhat expensive operation and should only be done once in a while.
|
||||||
|
///
|
||||||
|
/// If max_size is specified to 0, the cache will be entirely cleared in a fast manner.
|
||||||
|
void Age(size_t max_size);
|
||||||
|
|
||||||
|
/// @brief Change the size of cached images
|
||||||
|
/// @param new_width New width of images to cache
|
||||||
|
/// @param new_height New height of images to cache
|
||||||
|
///
|
||||||
|
/// Clears and re-initialises the cache.
|
||||||
|
void Resize(int new_width, int new_height);
|
||||||
|
|
||||||
|
/// @brief Retrieve an image from cache
|
||||||
|
/// @param bmp [out] Bitmap to return the image in
|
||||||
|
/// @param key Key to request the image for
|
||||||
|
/// @param timestamp Timestamp to use for cache age management
|
||||||
|
/// @return Returns false if the image had to be created in cache; if the return is
|
||||||
|
/// false, the consumer must draw into the returned bitmap.
|
||||||
|
///
|
||||||
|
/// Example:
|
||||||
|
/// @code
|
||||||
|
/// wxBitmap bmp;
|
||||||
|
/// if (!cache->Get(bmp, key, timestamp))
|
||||||
|
/// RenderBitmap(bmp);
|
||||||
|
/// // Use bmp
|
||||||
|
/// @endcode
|
||||||
|
///
|
||||||
|
/// The timestamp passed should never decrease between calls to the same cache.
|
||||||
|
///
|
||||||
|
/// The key has no inherent meaning to the cache.
|
||||||
|
bool Get(wxBitmap &bmp, int key, int timestamp);
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
AudioRendererBitmapCache::AudioRendererBitmapCache()
|
||||||
|
{
|
||||||
|
Resize(0, 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
AudioRendererBitmapCache::~AudioRendererBitmapCache()
|
||||||
|
{
|
||||||
|
// Nothing to do
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
void AudioRendererBitmapCache::Age(size_t max_size)
|
||||||
|
{
|
||||||
|
if (max_size == 0)
|
||||||
|
{
|
||||||
|
cache.clear();
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// @todo Make this faster than O(n^2)
|
||||||
|
|
||||||
|
size_t max_items = max_size / bytes_per_image;
|
||||||
|
|
||||||
|
while (cache.size() > max_items)
|
||||||
|
{
|
||||||
|
// Find the oldest item and remove it
|
||||||
|
CacheType::iterator next = cache.begin();
|
||||||
|
CacheType::iterator oldest = next;
|
||||||
|
while (++next != cache.end())
|
||||||
|
{
|
||||||
|
if (next->second.last_access < oldest->second.last_access)
|
||||||
|
oldest = next;
|
||||||
|
}
|
||||||
|
cache.erase(oldest);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
void AudioRendererBitmapCache::Resize(int new_width, int new_height)
|
||||||
|
{
|
||||||
|
Age(0);
|
||||||
|
|
||||||
|
width = new_width;
|
||||||
|
height = new_height;
|
||||||
|
|
||||||
|
// Assuming 32 bpp
|
||||||
|
// This probably isn't completely accurate, but just a reasonable approximation
|
||||||
|
bytes_per_image = sizeof(CachedBitmap) + width*height*4;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
bool AudioRendererBitmapCache::Get(wxBitmap &bmp, int key, int timestamp)
|
||||||
|
{
|
||||||
|
CacheType::iterator item = cache.find(key);
|
||||||
|
bool found = true;
|
||||||
|
|
||||||
|
if (item == cache.end())
|
||||||
|
{
|
||||||
|
cache[key] = CachedBitmap(wxBitmap(width, height, 32));
|
||||||
|
item = cache.find(key);
|
||||||
|
assert(item != cache.end());
|
||||||
|
found = false;
|
||||||
|
}
|
||||||
|
|
||||||
|
item->second.last_access = timestamp;
|
||||||
|
bmp = item->second.bmp;
|
||||||
|
|
||||||
|
return found;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
AudioRenderer::AudioRenderer()
|
||||||
|
: cache_bitmap_width(32) // arbitrary value for now
|
||||||
|
, bitmaps_normal(new AudioRendererBitmapCache)
|
||||||
|
, bitmaps_selected(new AudioRendererBitmapCache)
|
||||||
|
, cache_clock(0)
|
||||||
|
, cache_maxsize(0)
|
||||||
|
, renderer(0)
|
||||||
|
, provider(0)
|
||||||
|
{
|
||||||
|
// Make sure there's *some* values for those fields, and in the caches
|
||||||
|
SetSamplesPerPixel(1);
|
||||||
|
SetHeight(1);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
AudioRenderer::~AudioRenderer()
|
||||||
|
{
|
||||||
|
// Nothing to do, everything is auto-allocated
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
void AudioRenderer::SetSamplesPerPixel(int _pixel_samples)
|
||||||
|
{
|
||||||
|
pixel_samples = _pixel_samples;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
void AudioRenderer::SetHeight(int _pixel_height)
|
||||||
|
{
|
||||||
|
if (pixel_height == _pixel_height) return;
|
||||||
|
|
||||||
|
pixel_height = _pixel_height;
|
||||||
|
bitmaps_normal->Resize(cache_bitmap_width, pixel_height);
|
||||||
|
bitmaps_selected->Resize(cache_bitmap_width, pixel_height);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
void AudioRenderer::SetRenderer(AudioRendererBitmapProvider *_renderer)
|
||||||
|
{
|
||||||
|
if (renderer == _renderer) return;
|
||||||
|
|
||||||
|
if (renderer)
|
||||||
|
renderer->SetProvider(0);
|
||||||
|
|
||||||
|
renderer = _renderer;
|
||||||
|
bitmaps_normal->Age(0);
|
||||||
|
bitmaps_selected->Age(0);
|
||||||
|
|
||||||
|
if (renderer)
|
||||||
|
renderer->SetProvider(provider);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
void AudioRenderer::SetAudioProvider(AudioProvider *_provider)
|
||||||
|
{
|
||||||
|
if (provider == _provider) return;
|
||||||
|
|
||||||
|
provider = _provider;
|
||||||
|
bitmaps_normal->Age(0);
|
||||||
|
bitmaps_selected->Age(0);
|
||||||
|
|
||||||
|
if (renderer)
|
||||||
|
renderer->SetProvider(provider);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
wxBitmap AudioRenderer::GetCachedBitmap(int i, bool selected)
|
||||||
|
{
|
||||||
|
assert(provider);
|
||||||
|
assert(renderer);
|
||||||
|
|
||||||
|
// Pick the cache to use
|
||||||
|
AudioRendererBitmapCache *cache = (selected ? bitmaps_selected : bitmaps_normal).get();
|
||||||
|
|
||||||
|
wxBitmap bmp;
|
||||||
|
if (!cache->Get(bmp, i, cache_clock))
|
||||||
|
{
|
||||||
|
renderer->Render(bmp, i*cache_bitmap_width, selected);
|
||||||
|
}
|
||||||
|
|
||||||
|
assert(bmp.IsOk());
|
||||||
|
return bmp;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
void AudioRenderer::Render(wxDC &dc, wxPoint origin, int start, int length, bool selected)
|
||||||
|
{
|
||||||
|
assert(start >= 0);
|
||||||
|
assert(length >= 0);
|
||||||
|
|
||||||
|
assert(start >= 0);
|
||||||
|
|
||||||
|
if (!provider) return;
|
||||||
|
if (!renderer) return;
|
||||||
|
|
||||||
|
// Last absolute pixel strip to render
|
||||||
|
int end = start + length - 1;
|
||||||
|
// Figure out which range of bitmaps are required
|
||||||
|
int firstbitmap = start / cache_bitmap_width;
|
||||||
|
// And the offset in it to start its use at
|
||||||
|
int firstbitmapoffset = start % cache_bitmap_width;
|
||||||
|
// The last bitmap required
|
||||||
|
int lastbitmap = end / cache_bitmap_width;
|
||||||
|
// How many columns of the last bitmap to use
|
||||||
|
int lastbitmapoffset = end % cache_bitmap_width;
|
||||||
|
|
||||||
|
// Two basic cases now: Either firstbitmap is the same as lastbitmap, or they're different.
|
||||||
|
|
||||||
|
// origin is passed by value because we'll be using it as a local var to keep track
|
||||||
|
// of rendering progress!
|
||||||
|
|
||||||
|
if (firstbitmap == lastbitmap)
|
||||||
|
{
|
||||||
|
// These better be the same: The first to the last column of the single bitmap
|
||||||
|
// to use should equal the length of the area to render.
|
||||||
|
assert(lastbitmapoffset - firstbitmapoffset == length);
|
||||||
|
|
||||||
|
wxBitmap bmp = GetCachedBitmap(firstbitmap, selected);
|
||||||
|
wxMemoryDC bmpdc(bmp);
|
||||||
|
dc.Blit(origin, wxSize(length, pixel_height), &bmpdc, wxPoint(firstbitmapoffset, 0));
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
wxBitmap bmp;
|
||||||
|
|
||||||
|
{
|
||||||
|
bmp = GetCachedBitmap(firstbitmap, selected);
|
||||||
|
wxMemoryDC bmpdc(bmp);
|
||||||
|
dc.Blit(origin, wxSize(cache_bitmap_width-firstbitmapoffset, pixel_height),
|
||||||
|
&bmpdc, wxPoint(firstbitmapoffset, 0));
|
||||||
|
origin.x += cache_bitmap_width-firstbitmapoffset;
|
||||||
|
}
|
||||||
|
|
||||||
|
for (int i = 1; i < lastbitmap; ++i)
|
||||||
|
{
|
||||||
|
bmp = GetCachedBitmap(i, selected);
|
||||||
|
wxMemoryDC bmpdc(bmp);
|
||||||
|
dc.Blit(origin, wxSize(cache_bitmap_width, pixel_height), &bmpdc, wxPoint(0, 0));
|
||||||
|
origin.x += cache_bitmap_width;
|
||||||
|
}
|
||||||
|
|
||||||
|
{
|
||||||
|
bmp = GetCachedBitmap(lastbitmap, selected);
|
||||||
|
wxMemoryDC bmpdc(bmp);
|
||||||
|
dc.Blit(origin, wxSize(lastbitmapoffset, pixel_height), &bmpdc, wxPoint(0, 0));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (selected)
|
||||||
|
bitmaps_selected->Age(cache_maxsize);
|
||||||
|
else
|
||||||
|
bitmaps_normal->Age(cache_maxsize);
|
||||||
|
}
|
||||||
|
|
209
aegisub/src/audio_renderer.h
Normal file
209
aegisub/src/audio_renderer.h
Normal file
|
@ -0,0 +1,209 @@
|
||||||
|
// Copyright (c) 2009, Niels Martin Hansen
|
||||||
|
// All rights reserved.
|
||||||
|
//
|
||||||
|
// Redistribution and use in source and binary forms, with or without
|
||||||
|
// modification, are permitted provided that the following conditions are met:
|
||||||
|
//
|
||||||
|
// * Redistributions of source code must retain the above copyright notice,
|
||||||
|
// this list of conditions and the following disclaimer.
|
||||||
|
// * Redistributions in binary form must reproduce the above copyright notice,
|
||||||
|
// this list of conditions and the following disclaimer in the documentation
|
||||||
|
// and/or other materials provided with the distribution.
|
||||||
|
// * Neither the name of the Aegisub Group nor the names of its contributors
|
||||||
|
// may be used to endorse or promote products derived from this software
|
||||||
|
// without specific prior written permission.
|
||||||
|
//
|
||||||
|
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||||
|
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||||
|
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
|
||||||
|
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||||
|
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||||||
|
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||||||
|
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||||||
|
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||||
|
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||||
|
// POSSIBILITY OF SUCH DAMAGE.
|
||||||
|
//
|
||||||
|
// Aegisub Project http://www.aegisub.org/
|
||||||
|
//
|
||||||
|
// $Id$
|
||||||
|
|
||||||
|
/// @file audio_renderer.h
|
||||||
|
/// @see audio_renderer.cpp
|
||||||
|
/// @ingroup audio_ui
|
||||||
|
///
|
||||||
|
/// Base classes for audio renderers (spectrum, waveform, ...)
|
||||||
|
|
||||||
|
|
||||||
|
#include <wx/dc.h>
|
||||||
|
#include <wx/image.h>
|
||||||
|
#include <wx/gdicmn.h>
|
||||||
|
#include <memory>
|
||||||
|
|
||||||
|
|
||||||
|
// Some forward declarations for outside stuff
|
||||||
|
class AudioProvider;
|
||||||
|
|
||||||
|
// Forwards declarations for internal stuff
|
||||||
|
class AudioRendererBitmapCache;
|
||||||
|
class AudioRendererBitmapProvider;
|
||||||
|
|
||||||
|
|
||||||
|
/// @class AudioRenderer
|
||||||
|
/// @brief Renders audio to bitmap images for display on screen
|
||||||
|
///
|
||||||
|
/// Manages a bitmap cache and paints to device contexts.
|
||||||
|
///
|
||||||
|
/// To implement a new audio renderer, see AudioRendererBitmapProvider.
|
||||||
|
class AudioRenderer {
|
||||||
|
/// Horizontal zoom level, samples per pixel
|
||||||
|
int pixel_samples;
|
||||||
|
/// Vertical zoom level, height in pixels
|
||||||
|
int pixel_height;
|
||||||
|
|
||||||
|
/// Width of bitmaps to store in cache
|
||||||
|
const int cache_bitmap_width;
|
||||||
|
|
||||||
|
/// Cached bitmaps for normal audio ranges
|
||||||
|
std::auto_ptr<AudioRendererBitmapCache> bitmaps_normal;
|
||||||
|
/// Cached bitmaps for marked (selected) audio ranges
|
||||||
|
std::auto_ptr<AudioRendererBitmapCache> bitmaps_selected;
|
||||||
|
/// The "clock" used for cache aging, increased on each render operation
|
||||||
|
int cache_clock;
|
||||||
|
/// The maximum allowed size of the cache, in bytes
|
||||||
|
size_t cache_maxsize;
|
||||||
|
|
||||||
|
/// Actual renderer for bitmaps
|
||||||
|
AudioRendererBitmapProvider *renderer;
|
||||||
|
|
||||||
|
/// Audio provider to use as source
|
||||||
|
AudioProvider *provider;
|
||||||
|
|
||||||
|
/// @brief Make sure bitmap index i is in cache
|
||||||
|
/// @param i Index of bitmap to get into cache
|
||||||
|
/// @param selected Whether to get a "selected" state bitmap or not
|
||||||
|
/// @return The requested bitmap
|
||||||
|
///
|
||||||
|
/// Will attempt retrieving the requested bitmap from the cache, creating it
|
||||||
|
/// if the cache doesn't have it.
|
||||||
|
wxBitmap GetCachedBitmap(int i, bool selected);
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// @brief Constructor
|
||||||
|
///
|
||||||
|
/// Initialises audio rendering to a do-nothing state. An audio provider and bitmap
|
||||||
|
/// provider must be set before the audio renderer is functional.
|
||||||
|
AudioRenderer();
|
||||||
|
|
||||||
|
/// @brief Destructor
|
||||||
|
///
|
||||||
|
/// Only destroys internal data, audio provider and bitmap providers are
|
||||||
|
/// owned by the consumer of audio rendering.
|
||||||
|
~AudioRenderer();
|
||||||
|
|
||||||
|
/// @brief Set horizontal zoom
|
||||||
|
/// @param pixel_samples Audio samples per pixel to render at
|
||||||
|
///
|
||||||
|
/// Changing the zoom level invalidates all cached bitmaps.
|
||||||
|
void SetSamplesPerPixel(int pixel_samples);
|
||||||
|
|
||||||
|
/// @brief Set vertical zoom
|
||||||
|
/// @param pixel_height Height in pixels to render at
|
||||||
|
///
|
||||||
|
/// Changing the zoom level invalidates all cached bitmaps.
|
||||||
|
void SetHeight(int pixel_height);
|
||||||
|
|
||||||
|
/// @brief Get horizontal zoom
|
||||||
|
/// @return Audio samples per pixel rendering at
|
||||||
|
int GetSamplesPerPixel() const { return pixel_samples; }
|
||||||
|
|
||||||
|
/// @brief Get vertical zoom
|
||||||
|
/// @return Height in pixels rendering at
|
||||||
|
int GetHeight() const { return pixel_height; }
|
||||||
|
|
||||||
|
/// @brief Change renderer
|
||||||
|
/// @param renderer New renderer to use
|
||||||
|
///
|
||||||
|
/// The consumer of audio rendering is responsible for creating, managing and destroying
|
||||||
|
/// audio bitmap providers (renderers). If a renderer was previously set with this function
|
||||||
|
/// and a new one is set, the consumer of audio rendering is still responsible for the
|
||||||
|
/// life of the old renderer.
|
||||||
|
///
|
||||||
|
/// A bitmap provider must be assigned to a newly created audio renderer before it
|
||||||
|
/// can be functional.
|
||||||
|
///
|
||||||
|
/// Changing renderer invalidates all cached bitmaps.
|
||||||
|
///
|
||||||
|
/// The old renderer will have its audio provider reset to 0 and the new renderer will
|
||||||
|
/// have its audio provider set to the current. This is done in part to ensure that
|
||||||
|
/// the renderers have any internal caches cleared.
|
||||||
|
void SetRenderer(AudioRendererBitmapProvider *renderer);
|
||||||
|
|
||||||
|
/// @brief Change audio provider
|
||||||
|
/// @param provider New audio provider to use
|
||||||
|
///
|
||||||
|
/// The consumer of audio rendering is responsible for managing audio providers.
|
||||||
|
/// If an audio provider was previously assigned to the audio renderer and a
|
||||||
|
/// new one is assigned, the consumer of audio rendering is still responsible for
|
||||||
|
/// the life of the old audio provider.
|
||||||
|
///
|
||||||
|
/// An audio provider must be assigned to a newly created audio renderer before it
|
||||||
|
/// can be functional.
|
||||||
|
///
|
||||||
|
/// Changing audio provider invalidates all cached bitmaps.
|
||||||
|
///
|
||||||
|
/// If a renderer is set, this will also set the audio provider for the renderer.
|
||||||
|
void SetAudioProvider(AudioProvider *provider);
|
||||||
|
|
||||||
|
/// @brief Render audio to a device context
|
||||||
|
/// @param dc The device context to draw to
|
||||||
|
/// @param origin Top left corner to render at, in the DC's coordinates
|
||||||
|
/// @param start First pixel from beginning of the audio stream to render
|
||||||
|
/// @param length Number of pixels of audio to render
|
||||||
|
/// @param selected Whether to render the audio as being selected or not
|
||||||
|
///
|
||||||
|
/// The first audio sample rendered is start*pixel_samples, and the number
|
||||||
|
/// of audio samples rendered is length*pixel_samples.
|
||||||
|
void Render(wxDC &dc, wxPoint origin, int start, int length, bool selected);
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
/// @class AudioRendererBitmapProvider
|
||||||
|
/// @brief Base class for audio renderer implementations
|
||||||
|
///
|
||||||
|
/// Derive from this class to implement a way to render audio to images.
|
||||||
|
class AudioRendererBitmapProvider {
|
||||||
|
protected:
|
||||||
|
/// Audio provider to use for rendering
|
||||||
|
AudioProvider *provider;
|
||||||
|
/// Horizontal zoom in samples per pixel
|
||||||
|
int pixel_samples;
|
||||||
|
|
||||||
|
/// @brief Called when the audio provider changes
|
||||||
|
///
|
||||||
|
/// Implementations can override this method to do something when the audio provider is changed
|
||||||
|
virtual void OnSetProvider() { }
|
||||||
|
|
||||||
|
/// @brief Called when horizontal zoom changes
|
||||||
|
///
|
||||||
|
/// Implementations can override this method to do something when the horizontal zoom is changed
|
||||||
|
virtual void OnSetSamplesPerPixel() { }
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// @brief Rendering function
|
||||||
|
/// @param bmp Bitmap to render to
|
||||||
|
/// @param start First pixel from beginning of the audio stream to render
|
||||||
|
/// @param selected Whether to render the audio as being selected or not
|
||||||
|
///
|
||||||
|
/// Deriving classes must implement this method. The bitmap in bmp holds
|
||||||
|
/// the width and height to render.
|
||||||
|
virtual void Render(wxBitmap &bmp, int start, bool selected) = 0;
|
||||||
|
|
||||||
|
/// @brief Change audio provider
|
||||||
|
/// @param provider Audio provider to change to
|
||||||
|
void SetProvider(AudioProvider *provider);
|
||||||
|
/// @brief Change horizontal zoom
|
||||||
|
/// @param pixel_samples Samples per pixel to zoom to
|
||||||
|
void SetSamplesPerPixel(int pixel_samples);
|
||||||
|
};
|
Loading…
Reference in a new issue