mirror of https://github.com/mosra/magnum.git
Vladimír Vondruš
13 years ago
108 changed files with 4420 additions and 354 deletions
|
After Width: | Height: | Size: 8.0 KiB |
@ -0,0 +1,202 @@
|
||||
/* |
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
namespace Magnum { |
||||
/** @page getting-started Getting started |
||||
@brief Get started with %Magnum in matter of minutes. |
||||
|
||||
@tableofcontents |
||||
|
||||
@section getting-started-download Download, build and install Magnum |
||||
|
||||
Get latest version from GitHub and install it. Read full guide on |
||||
@ref building "how to download, build and install Magnum" on platform of your |
||||
choice. For our first project we will use GLUT toolkit, don't forget to enable |
||||
it for building using `WITH_GLUTAPPLICATION` CMake parameter. |
||||
|
||||
@section getting-started-bootstrap Download bootstrap project |
||||
|
||||
Setting up a new project can be pretty gruesome and nobody likes repeating the |
||||
same process every time. %Magnum provides "bootstrap" project structures for |
||||
many use cases, helping you get up and running in no time. |
||||
|
||||
The [bootstrap repository](https://github.com/mosra/magnum-bootstrap) is |
||||
located on GitHub. The `master` branch contains just an README file and the |
||||
actual bootstrap projects are in various other branches, each covering some |
||||
particular use case. For your first project you would need the `base` branch, |
||||
which contains only the essential files you need. Download the branch [as an |
||||
archive](https://github.com/mosra/magnum-bootstrap/archive/base.zip) and |
||||
extract it somewhere. Do it rather than cloning the full repository, as it's |
||||
better to init your own repository from scratch to avoid having the history |
||||
polluted. |
||||
|
||||
@section getting-started-review Review project structure |
||||
|
||||
The base project consists of just seven files in two subfolders. %Magnum uses |
||||
CMake build system, see @ref cmake for more information. |
||||
|
||||
modules/FindCorrade.cmake |
||||
modules/FindMagnum.cmake |
||||
modules/FindGLEW.cmake |
||||
src/MyApplication.cpp |
||||
src/CMakeLists.txt |
||||
CMakeLists.txt |
||||
.gitignore |
||||
|
||||
In root there is pre-filled `.gitignore` for your Git project and also |
||||
project-wide `CMakeLists.txt`. It just sets up project name, specifies module |
||||
directory and delegates everything important to `CMakeLists.txt` in `src/` |
||||
subdirectory. |
||||
@code |
||||
cmake_minimum_required(VERSION 2.8.8) |
||||
project(MyApplication) |
||||
|
||||
set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} "${CMAKE_SOURCE_DIR}/modules/") |
||||
|
||||
add_subdirectory(src) |
||||
@endcode |
||||
|
||||
Directory `modules/` contains CMake modules for finding the needed |
||||
dependencies. Unlike modules for finding e.g. GLUT and OpenGL, which are part |
||||
of standard CMake installation, these aren't part of it and thus must be |
||||
distributed with the project. These files are just verbatim copied from %Magnum |
||||
repository. |
||||
|
||||
Directory `src/` contains the actual project. To keep things simple, the |
||||
project consists of just one source file with the most minimal code possible: |
||||
@code |
||||
#include <Platform/GlutApplication.h> |
||||
#include <DefaultFramebuffer.h> |
||||
|
||||
using namespace Magnum; |
||||
|
||||
class MyApplication: public Platform::Application { |
||||
public: |
||||
explicit MyApplication(const Arguments& arguments); |
||||
|
||||
protected: |
||||
void viewportEvent(const Vector2i& size) override; |
||||
void drawEvent() override; |
||||
}; |
||||
|
||||
MyApplication::MyApplication(const Arguments& arguments): Platform::Application(arguments) {} |
||||
|
||||
void MyApplication::viewportEvent(const Vector2i& size) { |
||||
defaultFramebuffer.setViewport({{}, size}); |
||||
} |
||||
|
||||
void MyApplication::drawEvent() { |
||||
defaultFramebuffer.clear(FramebufferClear::Color); |
||||
swapBuffers(); |
||||
} |
||||
|
||||
MAGNUM_APPLICATION_MAIN(MyApplication) |
||||
@endcode |
||||
|
||||
The application essentially does nothing, just clears properly sized screen |
||||
framebuffer to default (black) color and then does buffer swap to actually |
||||
display it on the screen. `CMakeLists.txt` finds %Magnum, sets up compiler |
||||
flags, creates the executable and links it to all needed libraries: |
||||
@code |
||||
find_package(Magnum REQUIRED GlutApplication) |
||||
|
||||
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${CORRADE_CXX_FLAGS}") |
||||
include_directories(${MAGNUM_INCLUDE_DIRS} ${MAGNUM_APPLICATION_INCLUDE_DIRS}) |
||||
|
||||
add_executable(MyApplication MyApplication.cpp) |
||||
target_link_libraries(MyApplication |
||||
${MAGNUM_LIBRARIES} |
||||
${MAGNUM_APPLICATION_LIBRARIES}) |
||||
@endcode |
||||
|
||||
In the following tutorials the code will be explained more thoroughly. |
||||
|
||||
@section getting-started-build Build it and run |
||||
|
||||
In Linux (and other Unix-based OSs) you can build the example using the |
||||
following three commands: create out-of-source build directory, run cmake in it |
||||
and then run make. The application binary will then appear in src/ subdirectory |
||||
of build dir: |
||||
|
||||
mkdir -p build && cd build |
||||
cmake .. |
||||
make |
||||
./src/MyApplication |
||||
|
||||
On Windows, if you don't want to touch the command-line, the easiest way is to |
||||
open root `CMakeLists.txt` in QtCreator, let it import the project and then |
||||
just build and run the application. If CMake isn't able to find the |
||||
dependencies or the building fails for some reason, you might want to look at |
||||
@ref building-windows-troubleshooting. |
||||
|
||||
@image html getting-started.png |
||||
@image latex getting-started.png |
||||
|
||||
Now you can try to change something in the code. Without going too deep into |
||||
the concepts of graphics programming, we can change clear color to something |
||||
else and also print basic information about the GPU the engine is running on. |
||||
First include the needed headers: |
||||
@code |
||||
#include <Color.h> |
||||
#include <Context.h> |
||||
#include <Renderer.h> |
||||
@endcode |
||||
|
||||
And in the constructor (which is currently empty) change the clear color and |
||||
print something to debug output: |
||||
@code |
||||
Renderer::setClearColor({0.07f, 0.44f, 0.73f}); |
||||
|
||||
Debug() << "Hello! This application is running on" << Context::current()->version() |
||||
<< "using" << Context::current()->rendererString(); |
||||
@endcode |
||||
|
||||
After rebuilding and starting the application, the clear color changes to |
||||
blueish one and something like this would be printed to the console: |
||||
@code |
||||
Hello! This application is running on OpenGL 3.3 using Geforce GT 330M |
||||
@endcode |
||||
|
||||
@image html getting-started-blue.png |
||||
@image latex getting-started-blue.png |
||||
|
||||
@section getting-started-tutorials Follow tutorials and learn the principles |
||||
|
||||
Now that you have your first application up and running, the best way to |
||||
continue is to render your first triangle in @ref example-index "step-by-step tutorial". |
||||
Then you can dig deeper and try other examples, read about |
||||
@ref features "fundamental principles" in the documentation and start |
||||
experimenting on your own! |
||||
|
||||
@section getting-started-more Additional information |
||||
|
||||
- @subpage building |
||||
- @subpage building-plugins |
||||
- @subpage building-integration |
||||
- @subpage cmake |
||||
- @subpage cmake-plugins |
||||
- @subpage cmake-integration |
||||
|
||||
*/ |
||||
} |
||||
|
After Width: | Height: | Size: 8.0 KiB |
@ -0,0 +1,97 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "AbstractImporter.h" |
||||
|
||||
#include <fstream> |
||||
#include <Containers/Array.h> |
||||
#include <Utility/Assert.h> |
||||
|
||||
namespace Magnum { namespace Audio { |
||||
|
||||
AbstractImporter::AbstractImporter() = default; |
||||
|
||||
AbstractImporter::AbstractImporter(PluginManager::AbstractManager* manager, std::string plugin): PluginManager::AbstractPlugin(manager, std::move(plugin)) {} |
||||
|
||||
bool AbstractImporter::openData(Containers::ArrayReference<const unsigned char> data) { |
||||
CORRADE_ASSERT(features() & Feature::OpenData, |
||||
"Audio::AbstractImporter::openData(): feature not supported", nullptr); |
||||
|
||||
close(); |
||||
doOpenData(data); |
||||
return isOpened(); |
||||
} |
||||
|
||||
void AbstractImporter::doOpenData(Containers::ArrayReference<const unsigned char>) { |
||||
CORRADE_ASSERT(false, "Audio::AbstractImporter::openData(): feature advertised but not implemented", ); |
||||
} |
||||
|
||||
bool AbstractImporter::openFile(const std::string& filename) { |
||||
close(); |
||||
doOpenFile(filename); |
||||
return isOpened(); |
||||
} |
||||
|
||||
void AbstractImporter::doOpenFile(const std::string& filename) { |
||||
CORRADE_ASSERT(features() & Feature::OpenData, "Audio::AbstractImporter::openFile(): not implemented", ); |
||||
|
||||
/* Open file */ |
||||
std::ifstream in(filename.data(), std::ios::binary); |
||||
if(!in.good()) { |
||||
Error() << "Trade::AbstractImporter::openFile(): cannot open file" << filename; |
||||
return; |
||||
} |
||||
|
||||
/* Create array to hold file contents */ |
||||
in.seekg(0, std::ios::end); |
||||
Containers::Array<unsigned char> data(in.tellg()); |
||||
|
||||
/* Read data, close */ |
||||
in.seekg(0, std::ios::beg); |
||||
in.read(reinterpret_cast<char*>(data.begin()), data.size()); |
||||
in.close(); |
||||
|
||||
doOpenData(data); |
||||
} |
||||
|
||||
void AbstractImporter::close() { |
||||
if(isOpened()) doClose(); |
||||
} |
||||
|
||||
Buffer::Format AbstractImporter::format() const { |
||||
CORRADE_ASSERT(isOpened(), "Audio::AbstractImporter::format(): no file opened", {}); |
||||
return doFormat(); |
||||
} |
||||
|
||||
UnsignedInt AbstractImporter::frequency() const { |
||||
CORRADE_ASSERT(isOpened(), "Audio::AbstractImporter::frequency(): no file opened", {}); |
||||
return doFrequency(); |
||||
} |
||||
|
||||
Containers::Array<unsigned char> AbstractImporter::data() { |
||||
CORRADE_ASSERT(isOpened(), "Audio::AbstractImporter::data(): no file opened", {}); |
||||
return doData(); |
||||
} |
||||
|
||||
}} |
||||
@ -0,0 +1,163 @@
|
||||
#ifndef Magnum_Audio_AbstractImporter_h |
||||
#define Magnum_Audio_AbstractImporter_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
/** @file Audio/AbstractImporter.h
|
||||
* @brief Class Magnum::Audio::AbstractImporter |
||||
*/ |
||||
|
||||
#include <PluginManager/AbstractPlugin.h> |
||||
|
||||
#include "Magnum.h" |
||||
#include "Audio/Buffer.h" |
||||
|
||||
namespace Magnum { namespace Audio { |
||||
|
||||
/**
|
||||
@brief Base for audio importer plugins |
||||
|
||||
@section Audio-AbstractImporter-subclassing Subclassing |
||||
|
||||
Plugin implements function doFeatures(), doIsOpened(), one of or both |
||||
doOpenData() and doOpenFile() functions, function doClose() and data access |
||||
functions doFormat(), doFrequency() and doData(). |
||||
|
||||
You don't need to do most of the redundant sanity checks, these things are |
||||
checked by the implementation: |
||||
|
||||
- Functions doOpenData() and doOpenFile() are called after the previous file |
||||
was closed, function doClose() is called only if there is any file opened. |
||||
- Function doOpenData() is called only if @ref Feature "Feature::OpenData" |
||||
is supported. |
||||
- All `do*()` implementations working on opened file are called only if |
||||
there is any file opened. |
||||
*/ |
||||
class MAGNUM_AUDIO_EXPORT AbstractImporter: public PluginManager::AbstractPlugin { |
||||
CORRADE_PLUGIN_INTERFACE("cz.mosra.magnum.Audio.AbstractImporter/0.1") |
||||
|
||||
public: |
||||
/**
|
||||
* @brief Features supported by this importer |
||||
* |
||||
* @see Features, features() |
||||
*/ |
||||
enum class Feature: UnsignedByte { |
||||
/** Opening files from raw data using openData() */ |
||||
OpenData = 1 << 0 |
||||
}; |
||||
|
||||
/**
|
||||
* @brief Features supported by this importer |
||||
* |
||||
* @see features() |
||||
*/ |
||||
typedef Containers::EnumSet<Feature, UnsignedByte> Features; |
||||
|
||||
/** @brief Default constructor */ |
||||
explicit AbstractImporter(); |
||||
|
||||
/** @brief Plugin manager constructor */ |
||||
explicit AbstractImporter(PluginManager::AbstractManager* manager, std::string plugin); |
||||
|
||||
/** @brief Features supported by this importer */ |
||||
Features features() const { return doFeatures(); } |
||||
|
||||
/** @brief Whether any file is opened */ |
||||
bool isOpened() const { return doIsOpened(); } |
||||
|
||||
/**
|
||||
* @brief Open raw data |
||||
* |
||||
* Closes previous file, if it was opened, and tries to open given |
||||
* file. Available only if @ref Feature "Feature::OpenData" is |
||||
* supported. Returns `true` on success, `false` otherwise. |
||||
* @see features(), openFile() |
||||
*/ |
||||
bool openData(Containers::ArrayReference<const unsigned char> data); |
||||
|
||||
/**
|
||||
* @brief Open file |
||||
* |
||||
* Closes previous file, if it was opened, and tries to open given |
||||
* file. Returns `true` on success, `false` otherwise. |
||||
* @see features(), openData() |
||||
*/ |
||||
bool openFile(const std::string& filename); |
||||
|
||||
/** @brief Close file */ |
||||
void close(); |
||||
|
||||
/** @{ @name Data access */ |
||||
|
||||
/** @brief Sample format */ |
||||
Buffer::Format format() const; |
||||
|
||||
/** @brief Sample frequency */ |
||||
UnsignedInt frequency() const; |
||||
|
||||
/** @brief Sample data */ |
||||
Containers::Array<unsigned char> data(); |
||||
|
||||
/*@}*/ |
||||
|
||||
#ifndef DOXYGEN_GENERATING_OUTPUT |
||||
private: |
||||
#else |
||||
protected: |
||||
#endif |
||||
/** @brief Implementation for features() */ |
||||
virtual Features doFeatures() const = 0; |
||||
|
||||
/** @brief Implementation for isOpened() */ |
||||
virtual bool doIsOpened() const = 0; |
||||
|
||||
/** @brief Implementation for openData() */ |
||||
virtual void doOpenData(Containers::ArrayReference<const unsigned char> data); |
||||
|
||||
/**
|
||||
* @brief Implementation for openFile() |
||||
* |
||||
* If @ref Feature "Feature::OpenData" is supported, default |
||||
* implementation opens the file and calls doOpenData() with its |
||||
* contents. |
||||
*/ |
||||
virtual void doOpenFile(const std::string& filename); |
||||
|
||||
/** @brief Implementation for close() */ |
||||
virtual void doClose() = 0; |
||||
|
||||
/** @brief Implementation for format() */ |
||||
virtual Buffer::Format doFormat() const = 0; |
||||
|
||||
/** @brief Implementation for frequency() */ |
||||
virtual UnsignedInt doFrequency() const = 0; |
||||
|
||||
/** @brief Implementation for data() */ |
||||
virtual Containers::Array<unsigned char> doData() = 0; |
||||
}; |
||||
|
||||
}} |
||||
|
||||
#endif |
||||
@ -0,0 +1,49 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include <type_traits> |
||||
#include <al.h> |
||||
|
||||
#include "Types.h" |
||||
|
||||
namespace Magnum { namespace Audio { |
||||
|
||||
/* Verify types */ |
||||
static_assert(std::is_same<ALubyte, UnsignedByte>::value, "ALubyte is not the same as UnsignedByte"); |
||||
static_assert(std::is_same<ALbyte, Byte>::value, "ALbyte is not the same as Byte"); |
||||
static_assert(std::is_same<ALushort, UnsignedShort>::value, "ALushort is not the same as UnsignedShort"); |
||||
static_assert(std::is_same<ALshort, Short>::value, "ALshort is not the same as Short"); |
||||
static_assert(std::is_same<ALuint, UnsignedInt>::value, "ALuint is not the same as UnsignedInt"); |
||||
static_assert(std::is_same<ALint, Int>::value, "ALint is not the same as Int"); |
||||
static_assert(std::is_same<ALsizei, Int>::value, "ALsizei is not the same as Int"); |
||||
static_assert(std::is_same<ALfloat, Float>::value, "ALfloat is not the same as Float"); |
||||
#ifndef MAGNUM_TARGET_GLES |
||||
static_assert(std::is_same<ALdouble, Double>::value, "ALdouble is not the same as Double"); |
||||
#endif |
||||
|
||||
/* Verify boolean values */ |
||||
static_assert(AL_FALSE == false, "AL_FALSE is not the same as false"); |
||||
static_assert(AL_TRUE == true, "AL_TRUE is not the same as true"); |
||||
|
||||
}} |
||||
@ -0,0 +1,41 @@
|
||||
#ifndef Magnum_Audio_Audio_h |
||||
#define Magnum_Audio_Audio_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
/** @file
|
||||
* @brief Forward declarations for Magnum::Audio namespace |
||||
*/ |
||||
|
||||
namespace Magnum { namespace Audio { |
||||
|
||||
class AbstractImporter; |
||||
class Buffer; |
||||
class Context; |
||||
class Source; |
||||
/* Renderer used only statically */ |
||||
|
||||
}} |
||||
|
||||
#endif |
||||
@ -0,0 +1,44 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "Buffer.h" |
||||
|
||||
#include <Utility/Debug.h> |
||||
|
||||
namespace Magnum { namespace Audio { |
||||
|
||||
Debug operator<<(Debug debug, const Buffer::Format value) { |
||||
switch(value) { |
||||
#define _c(value) case Buffer::Format::value: return debug << "Audio::Buffer::Format::" #value; |
||||
_c(Mono8) |
||||
_c(Mono16) |
||||
_c(Stereo8) |
||||
_c(Stereo16) |
||||
#undef _c |
||||
} |
||||
|
||||
return debug << "Audio::Buffer::Format::(invalid)"; |
||||
} |
||||
|
||||
}} |
||||
@ -0,0 +1,120 @@
|
||||
#ifndef Magnum_Audio_Buffer_h |
||||
#define Magnum_Audio_Buffer_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
/** @file
|
||||
* @brief Class Magnum::Audio::Buffer |
||||
*/ |
||||
|
||||
#include <utility> |
||||
#include <al.h> |
||||
#include <Containers/Array.h> |
||||
|
||||
#include "Magnum.h" |
||||
#include "Audio/magnumAudioVisibility.h" |
||||
|
||||
namespace Magnum { namespace Audio { |
||||
|
||||
/** @brief Sample buffer */ |
||||
class Buffer { |
||||
public: |
||||
/**
|
||||
* @brief Sample format |
||||
* |
||||
* @note Multi-channel format is played without 3D spatialization |
||||
* (useful for background music) |
||||
* @see @ref setData() |
||||
*/ |
||||
enum class Format: ALenum { |
||||
Mono8 = AL_FORMAT_MONO8, /**< 8-bit unsigned mono */ |
||||
Mono16 = AL_FORMAT_MONO16, /**< 16-bit signed mono */ |
||||
Stereo8 = AL_FORMAT_STEREO8, /**< 8-bit interleaved unsigned stereo */ |
||||
Stereo16 = AL_FORMAT_STEREO16 /**< 16-bit interleaved signed stereo */ |
||||
}; |
||||
|
||||
/**
|
||||
* @brief Constructor |
||||
* |
||||
* Creates OpenAL buffer object. |
||||
* @see @fn_al{GenBuffers} |
||||
*/ |
||||
explicit Buffer() { alGenBuffers(1, &_id); } |
||||
|
||||
/**
|
||||
* @brief Destructor |
||||
* |
||||
* Deletes OpenAL buffer object. |
||||
* @see @fn_al{DeleteBuffers} |
||||
*/ |
||||
~Buffer() { if(_id) alDeleteBuffers(1, &_id); } |
||||
|
||||
/** @brief Copying is not allowed */ |
||||
Buffer(const Buffer&) = delete; |
||||
|
||||
/** @brief Move constructor */ |
||||
Buffer(Buffer&& other); |
||||
|
||||
/** @brief Copying is not allowed */ |
||||
Buffer& operator=(const Buffer&) = delete; |
||||
|
||||
/** @brief Move assignment */ |
||||
Buffer& operator=(Buffer&& other); |
||||
|
||||
/** @brief OpenAL buffer ID */ |
||||
ALuint id() const { return _id; } |
||||
|
||||
/**
|
||||
* @brief Set buffer data |
||||
* @param format Sample format |
||||
* @param data Data |
||||
* @param frequency Frequency |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* @see @fn_al{BufferData} |
||||
*/ |
||||
Buffer& setData(Format format, Containers::ArrayReference<const void> data, ALsizei frequency) { |
||||
alBufferData(_id, ALenum(format), data, data.size(), frequency); |
||||
return *this; |
||||
} |
||||
|
||||
private: |
||||
ALuint _id; |
||||
}; |
||||
|
||||
/** @debugoperator{Magnum::Audio::Buffer} */ |
||||
Debug MAGNUM_AUDIO_EXPORT operator<<(Debug debug, Buffer::Format value); |
||||
|
||||
inline Buffer::Buffer(Buffer&& other): _id(other._id) { |
||||
other._id = 0; |
||||
} |
||||
|
||||
inline Buffer& Buffer::operator=(Buffer&& other) { |
||||
std::swap(_id, other._id); |
||||
return *this; |
||||
} |
||||
|
||||
}} |
||||
|
||||
#endif |
||||
@ -0,0 +1,55 @@
|
||||
# |
||||
# This file is part of Magnum. |
||||
# |
||||
# Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
# |
||||
# Permission is hereby granted, free of charge, to any person obtaining a |
||||
# copy of this software and associated documentation files (the "Software"), |
||||
# to deal in the Software without restriction, including without limitation |
||||
# the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
# and/or sell copies of the Software, and to permit persons to whom the |
||||
# Software is furnished to do so, subject to the following conditions: |
||||
# |
||||
# The above copyright notice and this permission notice shall be included |
||||
# in all copies or substantial portions of the Software. |
||||
# |
||||
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
# DEALINGS IN THE SOFTWARE. |
||||
# |
||||
|
||||
find_package(OpenAL REQUIRED) |
||||
|
||||
include_directories(${OPENAL_INCLUDE_DIR}) |
||||
|
||||
set(MagnumAudio_SOURCES |
||||
AbstractImporter.cpp |
||||
Audio.cpp |
||||
Buffer.cpp |
||||
Context.cpp |
||||
Renderer.cpp |
||||
Source.cpp) |
||||
|
||||
set(MagnumAudio_HEADERS |
||||
AbstractImporter.h |
||||
Audio.h |
||||
Buffer.h |
||||
Context.h |
||||
Renderer.h |
||||
Source.h |
||||
|
||||
magnumAudioVisibility.h) |
||||
|
||||
add_library(MagnumAudio ${SHARED_OR_STATIC} ${MagnumAudio_SOURCES}) |
||||
target_link_libraries(MagnumAudio ${CORRADE_PLUGINMANAGER_LIBRARIES} ${OPENAL_LIBRARY}) |
||||
|
||||
install(TARGETS MagnumAudio DESTINATION ${MAGNUM_LIBRARY_INSTALL_DIR}) |
||||
install(FILES ${MagnumAudio_HEADERS} DESTINATION ${MAGNUM_INCLUDE_INSTALL_DIR}/Audio) |
||||
|
||||
if(BUILD_TESTS) |
||||
add_subdirectory(Test) |
||||
endif() |
||||
@ -0,0 +1,65 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "Context.h" |
||||
|
||||
#include <alc.h> |
||||
#include <Utility/Assert.h> |
||||
#include <Utility/Debug.h> |
||||
|
||||
#include "Magnum.h" |
||||
|
||||
namespace Magnum { namespace Audio { |
||||
|
||||
Context* Context::_current = nullptr; |
||||
|
||||
Context::Context() { |
||||
CORRADE_ASSERT(!_current, "Audio::Context: context already created", ); |
||||
|
||||
/* Open default device */ |
||||
const ALCchar* const defaultDevice = alcGetString(nullptr, ALC_DEFAULT_DEVICE_SPECIFIER); |
||||
_device = alcOpenDevice(defaultDevice); |
||||
if(!_device) { |
||||
Error() << "Audio::Context: cannot open sound device" << defaultDevice; |
||||
std::exit(1); |
||||
} |
||||
|
||||
_context = alcCreateContext(_device, nullptr); |
||||
if(!_context) { |
||||
Error() << "Audio::Context: cannot create context:" << alcGetError(_device); |
||||
std::exit(1); |
||||
} |
||||
|
||||
alcMakeContextCurrent(_context); |
||||
_current = this; |
||||
} |
||||
|
||||
Context::~Context() { |
||||
CORRADE_INTERNAL_ASSERT(_current == this); |
||||
|
||||
alcDestroyContext(_context); |
||||
alcCloseDevice(_device); |
||||
} |
||||
|
||||
}} |
||||
@ -0,0 +1,95 @@
|
||||
#ifndef Magnum_Audio_Context_h |
||||
#define Magnum_Audio_Context_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
/** @file
|
||||
* @brief Class Magnum::Audio::Context |
||||
*/ |
||||
|
||||
#include <al.h> |
||||
#include <string> |
||||
|
||||
#include "Audio/magnumAudioVisibility.h" |
||||
|
||||
#ifndef DOXYGEN_GENERATING_OUTPUT |
||||
typedef struct ALCdevice_struct ALCdevice; |
||||
typedef struct ALCcontext_struct ALCcontext; |
||||
#endif |
||||
|
||||
namespace Magnum { namespace Audio { |
||||
|
||||
/**
|
||||
@brief OpenAL context |
||||
*/ |
||||
class MAGNUM_AUDIO_EXPORT Context { |
||||
public: |
||||
/** @brief Current context */ |
||||
static Context* current() { return _current; } |
||||
|
||||
/**
|
||||
* @brief Constructor |
||||
* |
||||
* Creates OpenAL context. |
||||
*/ |
||||
explicit Context(); |
||||
|
||||
/**
|
||||
* @brief Destructor |
||||
* |
||||
* Destroys OpenAL context. |
||||
*/ |
||||
~Context(); |
||||
|
||||
/**
|
||||
* @brief Vendor string |
||||
* |
||||
* @see rendererString(), @fn_al{GetString} with @def_al{VENDOR} |
||||
*/ |
||||
std::string vendorString() const { return alGetString(AL_VENDOR); } |
||||
|
||||
/**
|
||||
* @brief %Renderer string |
||||
* |
||||
* @see vendorString(), @fn_al{GetString} with @def_al{RENDERER} |
||||
*/ |
||||
std::string rendererString() const { return alGetString(AL_RENDERER); } |
||||
|
||||
/**
|
||||
* @brief Version string |
||||
* |
||||
* @see @fn_al{GetString} with @def_al{VERSION} |
||||
*/ |
||||
std::string versionString() const { return alGetString(AL_VERSION); } |
||||
|
||||
private: |
||||
static Context* _current; |
||||
|
||||
ALCdevice* _device; |
||||
ALCcontext* _context; |
||||
}; |
||||
|
||||
}} |
||||
|
||||
#endif |
||||
@ -0,0 +1,46 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "Renderer.h" |
||||
|
||||
#include <Utility/Debug.h> |
||||
|
||||
namespace Magnum { namespace Audio { |
||||
|
||||
Debug operator<<(Debug debug, const Renderer::Error value) { |
||||
switch(value) { |
||||
#define _c(value) case Renderer::Error::value: return debug << "Audio::Renderer::Error::" #value; |
||||
_c(NoError) |
||||
_c(InvalidName) |
||||
_c(InvalidEnum) |
||||
_c(InvalidValue) |
||||
_c(InvalidOperation) |
||||
_c(OutOfMemory) |
||||
#undef _c |
||||
} |
||||
|
||||
return debug << "Audio::Renderer::Error::(invalid)"; |
||||
} |
||||
|
||||
}} |
||||
@ -0,0 +1,202 @@
|
||||
#ifndef Magnum_Audio_Renderer_h |
||||
#define Magnum_Audio_Renderer_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
/** @file
|
||||
* @brief Class Magnum::Audio::Renderer |
||||
*/ |
||||
|
||||
#include <al.h> |
||||
|
||||
#include "Math/Vector3.h" |
||||
#include "Magnum.h" |
||||
#include "Audio/magnumAudioVisibility.h" |
||||
|
||||
namespace Magnum { namespace Audio { |
||||
|
||||
/** @brief Global renderer configuration */ |
||||
class Renderer { |
||||
public: |
||||
Renderer() = delete; |
||||
|
||||
/**
|
||||
* @brief Error status |
||||
* |
||||
* @see error() |
||||
*/ |
||||
enum class Error: ALenum { |
||||
NoError = AL_NO_ERROR, /**< No error occured */ |
||||
InvalidName = AL_INVALID_NAME, /**< Invalid name parameter */ |
||||
InvalidEnum = AL_INVALID_ENUM, /**< Invalid enum parameter */ |
||||
InvalidValue = AL_INVALID_VALUE, /**< Invalid enum value parameter */ |
||||
InvalidOperation = AL_INVALID_OPERATION, /**< Illegal call */ |
||||
OutOfMemory = AL_OUT_OF_MEMORY /**< Unable to allocate memory */ |
||||
}; |
||||
|
||||
/** @brief Error status */ |
||||
static Error error() { return Error(alGetError()); } |
||||
|
||||
/** @{ @name Listener positioning */ |
||||
|
||||
/**
|
||||
* @brief Set listener position |
||||
* |
||||
* Default is `{0.0f, 0.0f, 0.0f}`. |
||||
* @see @fn_al{Listenerfv} with @def_al{POSITION} |
||||
*/ |
||||
static void setListenerPosition(const Vector3& position) { |
||||
alListenerfv(AL_POSITION, position.data()); |
||||
} |
||||
|
||||
/** @overload
|
||||
* @see @fn_al{Listeneriv} with @def_al{POSITION} |
||||
*/ |
||||
static void setListenerPosition(const Vector3i& position) { |
||||
alListeneriv(AL_POSITION, position.data()); |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set listener orientation |
||||
* |
||||
* The values must be linearly independent and don't need to be |
||||
* normalized. Default is -Z and +Y. |
||||
* @see @fn_al{Listenerfv} with @def_al{ORIENTATION} |
||||
*/ |
||||
static void setListenerOrientation(const Vector3& forward, const Vector3& up); |
||||
|
||||
/** @overload
|
||||
* @see @fn_al{Listeneriv} with @def_al{ORIENTATION} |
||||
*/ |
||||
static void setListenerOrientation(const Vector3i& forward, const Vector3i& up); |
||||
|
||||
/**
|
||||
* @brief Set listener velocity |
||||
* |
||||
* Default is `{0.0f, 0.0f, 0.0f}`. |
||||
* @see @fn_al{Listenerfv} with @def_al{VELOCITY} |
||||
*/ |
||||
static void setListenerVelocity(const Vector3& velocity) { |
||||
alListenerfv(AL_VELOCITY, velocity.data()); |
||||
} |
||||
|
||||
/** @overload
|
||||
* @see @fn_al{Listeneriv} with @def_al{VELOCITY} |
||||
*/ |
||||
static void setListenerVelocity(const Vector3i& velocity) { |
||||
alListeneriv(AL_VELOCITY, velocity.data()); |
||||
} |
||||
|
||||
/*@}*/ |
||||
|
||||
/** @{ @name Global behavior */ |
||||
|
||||
/**
|
||||
* @brief Distance model |
||||
* |
||||
* @see setDistanceModel() |
||||
*/ |
||||
enum class DistanceModel: ALenum { |
||||
/** No distance attenuation calculation */ |
||||
None = AL_NONE, |
||||
|
||||
/** Inverse distance */ |
||||
Inverse = AL_INVERSE_DISTANCE, |
||||
|
||||
/** Inverse distance, clamped */ |
||||
InverseClamped = AL_INVERSE_DISTANCE_CLAMPED, |
||||
|
||||
/** Linear distance */ |
||||
Linear = AL_LINEAR_DISTANCE, |
||||
|
||||
/** Linear distance, clamped */ |
||||
LinearClamped = AL_LINEAR_DISTANCE_CLAMPED, |
||||
|
||||
/** Exponential distance */ |
||||
Exponent = AL_EXPONENT_DISTANCE, |
||||
|
||||
/** Exponential distance, clamped */ |
||||
ExponentClamped = AL_EXPONENT_DISTANCE_CLAMPED |
||||
}; |
||||
|
||||
/**
|
||||
* @brief Set listener gain |
||||
* |
||||
* Default is `1.0f`, which means that the sound is unattenuated. |
||||
* If set to `0.0f`, all sound is muted. |
||||
* @see @fn_al{Listenerf} with @def_al{GAIN} |
||||
*/ |
||||
static void setListenerGain(Float gain) { |
||||
alListenerf(AL_GAIN, gain); |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set Doppler factor |
||||
* |
||||
* Default is `1.0f`. If set to `0.0f`, the effect is disabled. |
||||
* @see @ref setSpeedOfSound(), @fn_al{DopplerFactor} |
||||
*/ |
||||
static void setDopplerFactor(Float factor) { |
||||
alDopplerFactor(factor); |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set speed of sound |
||||
* |
||||
* Default is `343.3f` (meters per second). |
||||
* @see @ref setDopplerFactor(), @fn_al{SpeedOfSound} |
||||
*/ |
||||
static void setSpeedOfSound(Float speed) { |
||||
alSpeedOfSound(speed); |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set distance model |
||||
* |
||||
* Default is @ref DistanceModel "DistanceModel::InverseClamped". |
||||
* @see @fn_al{DistanceModel} |
||||
*/ |
||||
static void setDistanceModel(DistanceModel model) { |
||||
alDistanceModel(ALenum(model)); |
||||
} |
||||
|
||||
/*@}*/ |
||||
}; |
||||
|
||||
/** @debugoperator{Magnum::Audio::Renderer} */ |
||||
Debug MAGNUM_AUDIO_EXPORT operator<<(Debug debug, Renderer::Error value); |
||||
|
||||
inline void Renderer::setListenerOrientation(const Vector3& forward, const Vector3& up) { |
||||
const Vector3 data[] = {forward, up}; |
||||
alListenerfv(AL_ORIENTATION, data[0].data()); |
||||
} |
||||
|
||||
inline void Renderer::setListenerOrientation(const Vector3i& forward, const Vector3i& up) { |
||||
const Vector3i data[] = {forward, up}; |
||||
alListeneriv(AL_ORIENTATION, data[0].data()); |
||||
} |
||||
|
||||
}} |
||||
|
||||
#endif |
||||
@ -0,0 +1,123 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "Source.h" |
||||
|
||||
#include "Audio/Buffer.h" |
||||
|
||||
namespace Magnum { namespace Audio { |
||||
|
||||
/** @todo C++14: use VLA to avoid unnecessary allocations */ |
||||
|
||||
Source& Source::setBuffer(Buffer* buffer) { |
||||
alSourcei(_id, AL_BUFFER, buffer ? buffer->id() : 0); |
||||
return *this; |
||||
} |
||||
|
||||
namespace { |
||||
|
||||
const ALuint* sourceIds(const std::initializer_list<Source*>& sources) { |
||||
ALuint* const ids = new ALuint[sources.size()]; |
||||
for(auto it = sources.begin(); it != sources.end(); ++it) { |
||||
CORRADE_INTERNAL_ASSERT(*it); |
||||
ids[it-sources.begin()] = (*it)->id(); |
||||
} |
||||
return ids; |
||||
} |
||||
|
||||
const ALuint* sourceIds(const std::vector<Source*>& sources) { |
||||
ALuint* const ids = new ALuint[sources.size()]; |
||||
for(auto it = sources.begin(); it != sources.end(); ++it) { |
||||
CORRADE_INTERNAL_ASSERT(*it); |
||||
ids[it-sources.begin()] = (*it)->id(); |
||||
} |
||||
return ids; |
||||
} |
||||
|
||||
} |
||||
|
||||
/** @todo Okay, this is too much code copying even for me */ |
||||
|
||||
void Source::play(std::initializer_list<Source*> sources) { |
||||
const ALuint* const ids = sourceIds(sources); |
||||
alSourcePlayv(sources.size(), ids); |
||||
delete[] ids; |
||||
} |
||||
|
||||
void Source::play(const std::vector<Source*>& sources) { |
||||
const ALuint* const ids = sourceIds(sources); |
||||
alSourcePlayv(sources.size(), ids); |
||||
delete[] ids; |
||||
} |
||||
|
||||
void Source::pause(std::initializer_list<Source*> sources) { |
||||
const ALuint* const ids = sourceIds(sources); |
||||
alSourcePausev(sources.size(), ids); |
||||
delete[] ids; |
||||
} |
||||
|
||||
void Source::pause(const std::vector<Source*>& sources) { |
||||
const ALuint* const ids = sourceIds(sources); |
||||
alSourcePausev(sources.size(), ids); |
||||
delete[] ids; |
||||
} |
||||
|
||||
void Source::stop(std::initializer_list<Source*> sources) { |
||||
const ALuint* const ids = sourceIds(sources); |
||||
alSourceStopv(sources.size(), ids); |
||||
delete[] ids; |
||||
} |
||||
|
||||
void Source::stop(const std::vector<Source*>& sources) { |
||||
const ALuint* const ids = sourceIds(sources); |
||||
alSourceStopv(sources.size(), ids); |
||||
delete[] ids; |
||||
} |
||||
|
||||
void Source::rewind(std::initializer_list<Source*> sources) { |
||||
const ALuint* const ids = sourceIds(sources); |
||||
alSourceRewindv(sources.size(), ids); |
||||
delete[] ids; |
||||
} |
||||
|
||||
void Source::rewind(const std::vector<Source*>& sources) { |
||||
const ALuint* const ids = sourceIds(sources); |
||||
alSourceRewindv(sources.size(), ids); |
||||
delete[] ids; |
||||
} |
||||
|
||||
Debug operator<<(Debug debug, const Source::State value) { |
||||
switch(value) { |
||||
#define _c(value) case Source::State::value: return debug << "Audio::Source::State::" #value; |
||||
_c(Initial) |
||||
_c(Playing) |
||||
_c(Paused) |
||||
_c(Stopped) |
||||
#undef _c |
||||
} |
||||
|
||||
return debug << "Audio::Source::State::(invalid)"; |
||||
} |
||||
|
||||
}} |
||||
@ -0,0 +1,596 @@
|
||||
#ifndef Magnum_Audio_Source_h |
||||
#define Magnum_Audio_Source_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
/** @file
|
||||
* @brief Class Magnum::Audio::Source |
||||
*/ |
||||
|
||||
#include <initializer_list> |
||||
#include <vector> |
||||
#include <al.h> |
||||
|
||||
#include "Math/Vector3.h" |
||||
#include "Magnum.h" |
||||
#include "Audio/Audio.h" |
||||
#include "Audio/magnumAudioVisibility.h" |
||||
|
||||
namespace Magnum { namespace Audio { |
||||
|
||||
/**
|
||||
@brief %Source |
||||
|
||||
Manages positional audio source. |
||||
@todo Expose convenient API for buffer queuing |
||||
*/ |
||||
class MAGNUM_AUDIO_EXPORT Source { |
||||
public: |
||||
/**
|
||||
* @brief Constructor |
||||
* |
||||
* Creates OpenAL source object. |
||||
* @see @fn_al{GenSources} |
||||
*/ |
||||
explicit Source() { alGenSources(1, &_id); } |
||||
|
||||
/**
|
||||
* @brief Destructor |
||||
* |
||||
* Deletes OpenAL source object. |
||||
* @see @fn_al{DeleteSources} |
||||
*/ |
||||
~Source() { if(_id) alDeleteSources(1, &_id); } |
||||
|
||||
/** @brief Copying is not allowed */ |
||||
Source(const Source&) = delete; |
||||
|
||||
/** @brief Move constructor */ |
||||
Source(Source&& other); |
||||
|
||||
/** @brief Copying is not allowed */ |
||||
Source& operator=(const Source&) = delete; |
||||
|
||||
/** @brief Move assignment */ |
||||
Source& operator=(Source&& other); |
||||
|
||||
/** @brief OpenAL source ID */ |
||||
ALuint id() const { return _id; } |
||||
|
||||
/** @{ @name Source positioning */ |
||||
|
||||
/**
|
||||
* @brief Set position |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Default is `{0.0f, 0.0f, 0.0f}`. |
||||
* @see @ref setRelative(), @fn_al{Sourcefv} with @def_al{POSITION} |
||||
*/ |
||||
Source& setPosition(const Vector3& position) { |
||||
alSourcefv(_id, AL_POSITION, position.data()); |
||||
return *this; |
||||
} |
||||
|
||||
/** @overload
|
||||
* @see @fn_al{Sourceiv} with @def_al{POSITION} |
||||
*/ |
||||
Source& setPosition(const Vector3i& position) { |
||||
alSourceiv(_id, AL_POSITION, position.data()); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set velocity |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Default is `{0.0f, 0.0f, 0.0f}`. |
||||
* @see @ref setRelative(), @fn_al{Sourcefv} with @def_al{VELOCITY} |
||||
*/ |
||||
Source& setVelocity(const Vector3& velocity) { |
||||
alSourcefv(_id, AL_VELOCITY, velocity.data()); |
||||
return *this; |
||||
} |
||||
|
||||
/** @overload
|
||||
* @see @fn_al{Sourceiv} with @def_al{VELOCITY} |
||||
*/ |
||||
Source& setVelocity(const Vector3i& velocity) { |
||||
alSourceiv(_id, AL_VELOCITY, velocity.data()); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Interpret source relatively to listener |
||||
* |
||||
* When enabled, source position, direction and velocity will be |
||||
* interpreted relatively to listener. Default is `false`. |
||||
* @see @ref setPosition(), @ref setDirection(), @ref setVelocity(), |
||||
* @fn_al{Sourcei} with @def_al{SOURCE_RELATIVE} |
||||
*/ |
||||
Source& setRelative(bool relative) { |
||||
alSourcei(_id, AL_SOURCE_RELATIVE, relative); |
||||
return *this; |
||||
} |
||||
|
||||
/*@}*/ |
||||
|
||||
/** @{ @name Source behavior */ |
||||
|
||||
/**
|
||||
* @brief Set gain |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Default is `1.0f`, which means that the sound is unattenuated. |
||||
* If set to `0.0f`, the source is muted. |
||||
* @see @ref setMinGain(), @ref setMaxGain(), @fn_al{Sourcef} with |
||||
* @def_al{GAIN} |
||||
*/ |
||||
Source& setGain(Float gain) { |
||||
alSourcef(_id, AL_GAIN, gain); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set min gain |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* If effective gain is lower than min gain, min gain is used. Note |
||||
* that this is done before listener gain is applied. Default is |
||||
* `0.0f`. |
||||
* @see @ref setMinGain(), @ref setGain(), @fn_al{Sourcef} with |
||||
* @def_al{MIN_GAIN} |
||||
*/ |
||||
Source& setMinGain(Float gain) { |
||||
alSourcef(_id, AL_MIN_GAIN, gain); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set max gain |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* If effective gain is higher than max gain, max gain is used. Note |
||||
* that this is done before listener gain is applied. Default is |
||||
* `1.0f`. If set to `0.0f`, the source is muted. |
||||
* @see @ref setMinGain(), @ref setGain(), @fn_al{Sourcef} with |
||||
* @def_al{MIN_GAIN} |
||||
*/ |
||||
Source& setMaxGain(Float gain) { |
||||
alSourcef(_id, AL_MAX_GAIN, gain); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set reference distance |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Default is `1.0f`. |
||||
* @see @ref setRolloffFactor(), @fn_al{Sourcef} with |
||||
* @def_al{REFERENCE_DISTANCE} |
||||
*/ |
||||
Source& setReferenceDistance(Float distance) { |
||||
alSourcef(_id, AL_REFERENCE_DISTANCE, distance); |
||||
return *this; |
||||
} |
||||
|
||||
/** @overload
|
||||
* @see @fn_al{Sourcei} with @def_al{REFERENCE_DISTANCE} |
||||
*/ |
||||
Source& setReferenceDistance(Int distance) { |
||||
alSourcei(_id, AL_REFERENCE_DISTANCE, distance); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set rolloff factor |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Default is `1.0f`. |
||||
* @see @ref setReferenceDistance(), @fn_al{Sourcef} with |
||||
* @def_al{ROLLOFF_FACTOR} |
||||
*/ |
||||
Source& setRolloffFactor(Float factor) { |
||||
alSourcef(_id, AL_ROLLOFF_FACTOR, factor); |
||||
return *this; |
||||
} |
||||
|
||||
/** @overload
|
||||
* @see @fn_al{Sourcei} with @def_al{ROLLOFF_FACTOR} |
||||
*/ |
||||
Source& setRolloffFactor(Int factor) { |
||||
alSourcei(_id, AL_ROLLOFF_FACTOR, factor); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set max distance |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Default is max representable value. |
||||
* @see @fn_al{Sourcef} with @def_al{MAX_DISTANCE} |
||||
*/ |
||||
Source& setMaxDistance(Float distance) { |
||||
alSourcef(_id, AL_MAX_DISTANCE, distance); |
||||
return *this; |
||||
} |
||||
|
||||
/** @overload
|
||||
* @see @fn_al{Sourcei} with @def_al{MAX_DISTANCE} |
||||
*/ |
||||
Source& setMaxDistance(Int distance) { |
||||
alSourcef(_id, AL_MAX_DISTANCE, distance); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set direction |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Default is `{0.0f, 0.0f, 0.0f}`, which means that the source is not |
||||
* directional. |
||||
* @see @ref setInnerConeAngle(), @ref setOuterConeAngle(), |
||||
* @ref setRelative(), @fn_al{Sourcefv} with @def_al{DIRECTION} |
||||
*/ |
||||
Source& setDirection(const Vector3& direction) { |
||||
alSourcefv(_id, AL_DIRECTION, direction.data()); |
||||
return *this; |
||||
} |
||||
|
||||
/** @overload
|
||||
* @see @fn_al{Sourceiv} with @def_al{DIRECTION} |
||||
*/ |
||||
Source& setDirection(const Vector3i& direction) { |
||||
alSourceiv(_id, AL_DIRECTION, direction.data()); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set inner cone angle |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Has effect only if the source is directional. Default is |
||||
* `360.0_degf`. |
||||
* @see @ref setOuterConeAngle(), @ref setDirection(), @fn_al{Sourcef} |
||||
* with @def_al{CONE_INNER_ANGLE} |
||||
*/ |
||||
Source& setInnerConeAngle(Deg angle) { |
||||
alSourcef(_id, AL_CONE_INNER_ANGLE, Float(angle)); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set outer cone angle |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Has effect only if the source is directional. Default is |
||||
* `360.0_degf`. |
||||
* @see @ref setInnerConeAngle(), @ref setDirection(), |
||||
* @ref setOuterConeGain() @fn_al{Sourcef} with |
||||
* @def_al{CONE_OUTER_ANGLE} |
||||
*/ |
||||
Source& setOuterConeAngle(Deg angle) { |
||||
alSourcef(_id, AL_CONE_OUTER_ANGLE, Float(angle)); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set outer cone gain multiplier |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* The factor with which the gain is multiplied outside the outer cone. |
||||
* Default is `0.0f`. |
||||
* @see @ref setGain(), @ref setOuterConeAngle(), @fn_al{Sourcef} with |
||||
* @def_al{CONE_OUTER_GAIN} |
||||
*/ |
||||
Source& setOuterConeGain(Float multiplier) { |
||||
alSourcef(_id, AL_CONE_OUTER_ANGLE, multiplier); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set pitch |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Default is `1.0f`. |
||||
* @see @fn_al{Sourcef} with @def_al{PITCH} |
||||
*/ |
||||
Source& setPitch(Float pitch) { |
||||
alSourcef(_id, AL_PITCH, pitch); |
||||
return *this; |
||||
} |
||||
|
||||
/*@}*/ |
||||
|
||||
/** @{ @name Buffer management */ |
||||
|
||||
/**
|
||||
* @brief %Source type |
||||
* |
||||
* @see @ref type() |
||||
*/ |
||||
enum class Type: ALint { |
||||
Undetermined = AL_UNDETERMINED, /**< Undetermined (default) */ |
||||
Static = AL_STATIC, /**< Static source */ |
||||
Streaming = AL_STREAMING /**< Streaming source */ |
||||
}; |
||||
|
||||
/**
|
||||
* @brief Source type |
||||
* |
||||
* @see @ref setBuffer(), @fn_al{GetSourcei} with @def_al{SOURCE_TYPE} |
||||
*/ |
||||
Type type() const; |
||||
|
||||
/**
|
||||
* @brief Attach buffer |
||||
* @param buffer Buffer to attach or `nullptr` |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* If an buffer is attached, changes source type to |
||||
* @ref Type "Type::Static", if detached, changes source type to |
||||
* @ref Type "Type::Undetermined". The buffer must be already filled |
||||
* with data. |
||||
* @see @ref type(), @fn_al{Sourcei} with @def_al{BUFFER} |
||||
*/ |
||||
Source& setBuffer(Buffer* buffer); |
||||
|
||||
/*@}*/ |
||||
|
||||
/** @{ @name State management */ |
||||
|
||||
/**
|
||||
* @brief %Source state |
||||
* |
||||
* @see @ref state(), @ref play(), @ref pause(), @ref stop(), |
||||
* @ref rewind() |
||||
*/ |
||||
enum class State: ALint { |
||||
Initial = AL_INITIAL, /**< Initial state (default) */ |
||||
Playing = AL_PLAYING, /**< The source is playing */ |
||||
Paused = AL_PAUSED, /**< The source is paused */ |
||||
Stopped = AL_STOPPED /**< The source is stopped */ |
||||
}; |
||||
|
||||
/**
|
||||
* @brief Play more sources at once |
||||
* |
||||
* The operation is guaranteed to be done for all sources at the same |
||||
* time. `nullptr` is not allowed. |
||||
* @see @ref play(), @ref pause(std::initializer_list<Source*>), |
||||
* @ref stop(std::initializer_list<Source*>), |
||||
* @ref rewind(std::initializer_list<Source*>), |
||||
* @fn_al{SourcePlayv} |
||||
*/ |
||||
static void play(std::initializer_list<Source*> sources); |
||||
static void play(const std::vector<Source*>& sources); /**< @overload */ |
||||
|
||||
/**
|
||||
* @brief Pause more sources at once |
||||
* |
||||
* The operation is guaranteed to be done for all sources at the same |
||||
* time. `nullptr` is not allowed. |
||||
* @see @ref pause(), @ref play(std::initializer_list<Source*>), |
||||
* @ref stop(std::initializer_list<Source*>), |
||||
* @ref rewind(std::initializer_list<Source*>), |
||||
* @fn_al{SourcePausev} |
||||
*/ |
||||
static void pause(std::initializer_list<Source*> sources); |
||||
static void pause(const std::vector<Source*>& sources); /**< @overload */ |
||||
|
||||
/**
|
||||
* @brief Stop more sources at once |
||||
* |
||||
* The operation is guaranteed to be done for all sources at the same |
||||
* time. `nullptr` is not allowed. |
||||
* @see @ref stop(), @ref play(std::initializer_list<Source*>), |
||||
* @ref pause(std::initializer_list<Source*>), |
||||
* @ref rewind(std::initializer_list<Source*>), |
||||
* @fn_al{SourceStopv} |
||||
*/ |
||||
static void stop(std::initializer_list<Source*> sources); |
||||
static void stop(const std::vector<Source*>& sources); /**< @overload */ |
||||
|
||||
/**
|
||||
* @brief Rewind more sources at once |
||||
* |
||||
* The operation is guaranteed to be done for all sources at the same |
||||
* time. `nullptr` is not allowed. |
||||
* @see @ref rewind(), @ref play(std::initializer_list<Source*>), |
||||
* @ref pause(std::initializer_list<Source*>), |
||||
* @ref stop(std::initializer_list<Source*>), |
||||
* @fn_al{SourceRewindv} |
||||
*/ |
||||
static void rewind(std::initializer_list<Source*> sources); |
||||
static void rewind(const std::vector<Source*>& sources); /**< @overload */ |
||||
|
||||
/**
|
||||
* @brief State |
||||
* |
||||
* @see @ref play(), @ref pause(), @ref stop(), @ref rewind(), |
||||
* @fn_al{GetSourcei} with @def_al{SOURCE_STATE} |
||||
*/ |
||||
State state() const; |
||||
|
||||
/**
|
||||
* @brief Play |
||||
* |
||||
* @see @ref play(std::initializer_list<Source*>), @ref state(), |
||||
* @ref pause(), @ref stop(), @ref rewind(), @fn_al{SourcePlay} |
||||
*/ |
||||
void play() { alSourcePlay(_id); } |
||||
|
||||
/**
|
||||
* @brief Pause |
||||
* |
||||
* @see @ref pause(std::initializer_list<Source*>), @ref state(), |
||||
* @ref play(), @ref stop(), @ref rewind(), @fn_al{SourcePause} |
||||
*/ |
||||
void pause() { alSourcePause(_id); } |
||||
|
||||
/**
|
||||
* @brief Stop |
||||
* |
||||
* @see @ref stop(std::initializer_list<Source*>), @ref state(), |
||||
* @ref play(), @ref pause(), @ref rewind(), @fn_al{SourceStop} |
||||
*/ |
||||
void stop() { alSourceStop(_id); } |
||||
|
||||
/**
|
||||
* @brief Rewind |
||||
* |
||||
* @see @ref rewind(std::initializer_list<Source*>), @ref state(), |
||||
* @ref play(), @ref pause(), @ref stop(), @fn_al{SourceRewind} |
||||
*/ |
||||
void rewind() { alSourceRewind(_id); } |
||||
|
||||
/**
|
||||
* @brief Whether the source is looping |
||||
* |
||||
* @see @fn_al{GetSourcei} with @def_al{LOOPING} |
||||
*/ |
||||
bool isLooping() const; |
||||
|
||||
/**
|
||||
* @brief Set source looping |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Default is `false`. |
||||
* @see @fn_al{Sourcei} with @def_al{LOOPING} |
||||
*/ |
||||
Source& setLooping(bool loop) { |
||||
alSourcei(_id, AL_LOOPING, loop); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Offset in seconds |
||||
* |
||||
* @see @ref offsetInBytes(), @ref offsetInSamples(), |
||||
* @fn_al{GetSourcef} with @def_al{SEC_OFFSET} |
||||
*/ |
||||
Float offsetInSeconds() const; |
||||
|
||||
/**
|
||||
* @brief Set offset in seconds |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* @see @ref setOffsetInBytes(), @ref setOffsetInSamples(), |
||||
* @fn_al{Sourcef} with @def_al{SEC_OFFSET} |
||||
*/ |
||||
Source& setOffsetInSeconds(Float offset) { |
||||
alSourcef(_id, AL_SEC_OFFSET, offset); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Offset in bytes |
||||
* |
||||
* @see @ref offsetInSeconds(), @ref offsetInSamples(), |
||||
* @fn_al{GetSourcei} with @def_al{BYTE_OFFSET} |
||||
*/ |
||||
Int offsetInBytes() const; |
||||
|
||||
/**
|
||||
* @brief Set offset in bytes |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* @see @ref setOffsetInSeconds(), @ref setOffsetInSamples(), |
||||
* @fn_al{Sourcei} with @def_al{SEC_OFFSET} |
||||
*/ |
||||
Source& setOffsetInBytes(Int offset) { |
||||
alSourcei(_id, AL_BYTE_OFFSET, offset); |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Offset in samples |
||||
* |
||||
* @see @ref offsetInSeconds(), @ref offsetInBytes(), |
||||
* @fn_al{GetSourcei} with @def_al{SAMPLE_OFFSET} |
||||
*/ |
||||
Int offsetInSamples() const; |
||||
|
||||
/**
|
||||
* @brief Set offset in samples |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* @see @ref setOffsetInSeconds(), @ref setOffsetInBytes(), |
||||
* @fn_al{Sourcei} with @def_al{SEC_OFFSET} |
||||
*/ |
||||
Source& setOffsetInSamples(Int offset) { |
||||
alSourcei(_id, AL_SAMPLE_OFFSET, offset); |
||||
return *this; |
||||
} |
||||
|
||||
/*@}*/ |
||||
|
||||
private: |
||||
ALuint _id; |
||||
}; |
||||
|
||||
/** @debugoperator{Magnum::Audio::Source} */ |
||||
Debug MAGNUM_AUDIO_EXPORT operator<<(Debug debug, Source::State value); |
||||
|
||||
inline Source::Source(Source&& other): _id(other._id) { |
||||
other._id = 0; |
||||
} |
||||
|
||||
inline Source& Source::operator=(Source&& other) { |
||||
std::swap(_id, other._id); |
||||
return *this; |
||||
} |
||||
|
||||
auto Source::state() const -> State { |
||||
ALint state; |
||||
alGetSourcei(_id, AL_SOURCE_STATE, &state); |
||||
return State(state); |
||||
} |
||||
|
||||
inline bool Source::isLooping() const { |
||||
ALint looping; |
||||
alGetSourcei(_id, AL_LOOPING, &looping); |
||||
return looping; |
||||
} |
||||
|
||||
inline Float Source::offsetInSeconds() const { |
||||
Float offset; |
||||
alGetSourcef(_id, AL_SEC_OFFSET, &offset); |
||||
return offset; |
||||
} |
||||
|
||||
inline Int Source::offsetInBytes() const { |
||||
Int offset; |
||||
alGetSourcei(_id, AL_BYTE_OFFSET, &offset); |
||||
return offset; |
||||
} |
||||
|
||||
inline Int Source::offsetInSamples() const { |
||||
Int offset; |
||||
alGetSourcei(_id, AL_SAMPLE_OFFSET, &offset); |
||||
return offset; |
||||
} |
||||
|
||||
}} |
||||
|
||||
#endif |
||||
@ -0,0 +1,76 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include <Containers/Array.h> |
||||
#include <TestSuite/Tester.h> |
||||
#include <Utility/Directory.h> |
||||
|
||||
#include "Audio/AbstractImporter.h" |
||||
|
||||
#include "testConfigure.h" |
||||
|
||||
namespace Magnum { namespace Audio { namespace Test { |
||||
|
||||
class AbstractImporterTest: public TestSuite::Tester { |
||||
public: |
||||
explicit AbstractImporterTest(); |
||||
|
||||
void openFile(); |
||||
}; |
||||
|
||||
AbstractImporterTest::AbstractImporterTest() { |
||||
addTests({&AbstractImporterTest::openFile}); |
||||
} |
||||
|
||||
void AbstractImporterTest::openFile() { |
||||
class DataImporter: public Audio::AbstractImporter { |
||||
public: |
||||
explicit DataImporter(): opened(false) {} |
||||
|
||||
private: |
||||
Features doFeatures() const override { return Feature::OpenData; } |
||||
bool doIsOpened() const override { return opened; } |
||||
void doClose() override {} |
||||
|
||||
void doOpenData(Containers::ArrayReference<const unsigned char> data) override { |
||||
opened = (data.size() == 1 && data[0] == 0xa5); |
||||
} |
||||
|
||||
Buffer::Format doFormat() const override { return {}; } |
||||
UnsignedInt doFrequency() const override { return {}; } |
||||
Corrade::Containers::Array<unsigned char> doData() override { return nullptr; } |
||||
|
||||
bool opened; |
||||
}; |
||||
|
||||
/* doOpenFile() should call doOpenData() */ |
||||
DataImporter importer; |
||||
CORRADE_VERIFY(!importer.isOpened()); |
||||
importer.openFile(Utility::Directory::join(AUDIO_TEST_DIR, "file.bin")); |
||||
CORRADE_VERIFY(importer.isOpened()); |
||||
} |
||||
|
||||
}}} |
||||
|
||||
CORRADE_TEST_MAIN(Magnum::Audio::Test::AbstractImporterTest) |
||||
@ -0,0 +1,51 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include <sstream> |
||||
#include <TestSuite/Tester.h> |
||||
|
||||
#include "Audio/Buffer.h" |
||||
|
||||
namespace Magnum { namespace Audio { namespace Test { |
||||
|
||||
class BufferTest: public TestSuite::Tester { |
||||
public: |
||||
explicit BufferTest(); |
||||
|
||||
void debugFormat(); |
||||
}; |
||||
|
||||
BufferTest::BufferTest() { |
||||
addTests({&BufferTest::debugFormat}); |
||||
} |
||||
|
||||
void BufferTest::debugFormat() { |
||||
std::ostringstream out; |
||||
Debug(&out) << Buffer::Format::Stereo16; |
||||
CORRADE_COMPARE(out.str(), "Audio::Buffer::Format::Stereo16\n"); |
||||
} |
||||
|
||||
}}} |
||||
|
||||
CORRADE_TEST_MAIN(Magnum::Audio::Test::BufferTest) |
||||
@ -0,0 +1,33 @@
|
||||
# |
||||
# This file is part of Magnum. |
||||
# |
||||
# Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
# |
||||
# Permission is hereby granted, free of charge, to any person obtaining a |
||||
# copy of this software and associated documentation files (the "Software"), |
||||
# to deal in the Software without restriction, including without limitation |
||||
# the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
# and/or sell copies of the Software, and to permit persons to whom the |
||||
# Software is furnished to do so, subject to the following conditions: |
||||
# |
||||
# The above copyright notice and this permission notice shall be included |
||||
# in all copies or substantial portions of the Software. |
||||
# |
||||
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
# DEALINGS IN THE SOFTWARE. |
||||
# |
||||
|
||||
configure_file(${CMAKE_CURRENT_SOURCE_DIR}/testConfigure.h.cmake |
||||
${CMAKE_CURRENT_BINARY_DIR}/testConfigure.h) |
||||
|
||||
include_directories(${CMAKE_CURRENT_BINARY_DIR}) |
||||
|
||||
corrade_add_test(AudioAbstractImporterTest AbstractImporterTest.cpp LIBRARIES MagnumAudio) |
||||
corrade_add_test(AudioBufferTest BufferTest.cpp LIBRARIES MagnumAudio) |
||||
corrade_add_test(AudioRendererTest RendererTest.cpp LIBRARIES MagnumAudio) |
||||
corrade_add_test(AudioSourceTest SourceTest.cpp LIBRARIES MagnumAudio) |
||||
@ -0,0 +1,51 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include <sstream> |
||||
#include <TestSuite/Tester.h> |
||||
|
||||
#include "Audio/Renderer.h" |
||||
|
||||
namespace Magnum { namespace Audio { namespace Test { |
||||
|
||||
class RendererTest: public TestSuite::Tester { |
||||
public: |
||||
explicit RendererTest(); |
||||
|
||||
void debugError(); |
||||
}; |
||||
|
||||
RendererTest::RendererTest() { |
||||
addTests({&RendererTest::debugError}); |
||||
} |
||||
|
||||
void RendererTest::debugError() { |
||||
std::ostringstream out; |
||||
Debug(&out) << Renderer::Error::InvalidOperation; |
||||
CORRADE_COMPARE(out.str(), "Audio::Renderer::Error::InvalidOperation\n"); |
||||
} |
||||
|
||||
}}} |
||||
|
||||
CORRADE_TEST_MAIN(Magnum::Audio::Test::RendererTest) |
||||
@ -0,0 +1,51 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include <sstream> |
||||
#include <TestSuite/Tester.h> |
||||
|
||||
#include "Audio/Source.h" |
||||
|
||||
namespace Magnum { namespace Audio { namespace Test { |
||||
|
||||
class SourceTest: public TestSuite::Tester { |
||||
public: |
||||
explicit SourceTest(); |
||||
|
||||
void debugState(); |
||||
}; |
||||
|
||||
SourceTest::SourceTest() { |
||||
addTests({&SourceTest::debugState}); |
||||
} |
||||
|
||||
void SourceTest::debugState() { |
||||
std::ostringstream out; |
||||
Debug(&out) << Source::State::Playing; |
||||
CORRADE_COMPARE(out.str(), "Audio::Source::State::Playing\n"); |
||||
} |
||||
|
||||
}}} |
||||
|
||||
CORRADE_TEST_MAIN(Magnum::Audio::Test::SourceTest) |
||||
@ -0,0 +1,25 @@
|
||||
/* |
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#define AUDIO_TEST_DIR "${CMAKE_CURRENT_SOURCE_DIR}" |
||||
@ -0,0 +1,35 @@
|
||||
#ifndef Magnum_Audio_magnumAudioVisibility_h |
||||
#define Magnum_Audio_magnumAudioVisibility_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include <Utility/Visibility.h> |
||||
|
||||
#ifdef MagnumAudio_EXPORTS |
||||
#define MAGNUM_AUDIO_EXPORT CORRADE_VISIBILITY_EXPORT |
||||
#else |
||||
#define MAGNUM_AUDIO_EXPORT CORRADE_VISIBILITY_IMPORT |
||||
#endif |
||||
|
||||
#endif |
||||
@ -0,0 +1,116 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "CapsuleRenderer.h" |
||||
|
||||
#include "MeshView.h" |
||||
#include "DebugTools/ResourceManager.h" |
||||
#include "DebugTools/ShapeRenderer.h" |
||||
#include "Primitives/Capsule.h" |
||||
#include "Shapes/Capsule.h" |
||||
#include "Shaders/Flat.h" |
||||
#include "Trade/MeshData2D.h" |
||||
#include "Trade/MeshData3D.h" |
||||
|
||||
#include "DebugTools/Implementation/CapsuleRendererTransformation.h" |
||||
|
||||
namespace Magnum { namespace DebugTools { namespace Implementation { |
||||
|
||||
AbstractCapsuleRenderer<2>::AbstractCapsuleRenderer(): AbstractShapeRenderer<2>("capsule2d", "capsule2d-vertices", "capsule2d-indices") { |
||||
constexpr UnsignedInt rings = 10; |
||||
if(!wireframeMesh) createResources(Primitives::Capsule2D::wireframe(rings, 1, 1.0f)); |
||||
|
||||
/* Bottom hemisphere */ |
||||
if(!(bottom = ResourceManager::instance().get<MeshView>("capsule2d-bottom"))) { |
||||
auto view = new MeshView(wireframeMesh); |
||||
view->setIndexRange(0, rings*4, 0, rings*2+1); |
||||
ResourceManager::instance().set(bottom.key(), view, ResourceDataState::Final, ResourcePolicy::Manual); |
||||
} |
||||
|
||||
/* Cylinder */ |
||||
if(!(cylinder = ResourceManager::instance().get<MeshView>("capsule2d-cylinder"))) { |
||||
auto view = new MeshView(wireframeMesh); |
||||
view->setIndexRange(rings*4, 4, rings*2+1, rings*2+3); |
||||
ResourceManager::instance().set(cylinder.key(), view, ResourceDataState::Final, ResourcePolicy::Manual); |
||||
} |
||||
|
||||
/* Top hemisphere */ |
||||
if(!(top = ResourceManager::instance().get<MeshView>("capsule2d-top"))) { |
||||
auto view = new MeshView(wireframeMesh); |
||||
view->setIndexRange(rings*4+4, rings*4, rings*2+3, rings*4+4); |
||||
ResourceManager::instance().set(top.key(), view, ResourceDataState::Final, ResourcePolicy::Manual); |
||||
} |
||||
} |
||||
|
||||
AbstractCapsuleRenderer<3>::AbstractCapsuleRenderer(): AbstractShapeRenderer<3>("capsule3d", "capsule3d-vertices", "capsule3d-indices") { |
||||
constexpr UnsignedInt rings = 10; |
||||
constexpr UnsignedInt segments = 40; |
||||
if(!wireframeMesh) createResources(Primitives::Capsule3D::wireframe(rings, 1, segments, 1.0f)); |
||||
|
||||
/* Bottom hemisphere */ |
||||
if(!(bottom = ResourceManager::instance().get<MeshView>("capsule3d-bottom"))) { |
||||
auto view = new MeshView(wireframeMesh); |
||||
view->setIndexRange(0, rings*8, 0, rings*4+1); |
||||
ResourceManager::instance().set(bottom.key(), view, ResourceDataState::Final, ResourcePolicy::Manual); |
||||
} |
||||
|
||||
/* Cylinder */ |
||||
if(!(cylinder = ResourceManager::instance().get<MeshView>("capsule3d-cylinder"))) { |
||||
auto view = new MeshView(wireframeMesh); |
||||
view->setIndexRange(rings*8, segments*4+8, rings*4+1, rings*4+segments*2+5); |
||||
ResourceManager::instance().set(cylinder.key(), view, ResourceDataState::Final, ResourcePolicy::Manual); |
||||
} |
||||
|
||||
/* Top */ |
||||
if(!(top = ResourceManager::instance().get<MeshView>("capsule3d-top"))) { |
||||
auto view = new MeshView(wireframeMesh); |
||||
view->setIndexRange(rings*8+segments*4+8, rings*8, rings*4+segments*2+5, rings*8+segments*2+6); |
||||
ResourceManager::instance().set(top.key(), view, ResourceDataState::Final, ResourcePolicy::Manual); |
||||
} |
||||
} |
||||
|
||||
template<UnsignedInt dimensions> CapsuleRenderer<dimensions>::CapsuleRenderer(const Shapes::Implementation::AbstractShape<dimensions>& capsule): capsule(static_cast<const Shapes::Implementation::Shape<Shapes::Capsule<dimensions>>&>(capsule).shape) {} |
||||
|
||||
template<UnsignedInt dimensions> void CapsuleRenderer<dimensions>::draw(Resource<ShapeRendererOptions>& options, const typename DimensionTraits<dimensions, Float>::MatrixType& projectionMatrix) { |
||||
std::array<typename DimensionTraits<dimensions, Float>::MatrixType, 3> transformations = Implementation::capsuleRendererTransformation<dimensions>(capsule.a(), capsule.b(), capsule.radius()); |
||||
AbstractShapeRenderer<dimensions>::wireframeShader->setColor(options->color()) |
||||
.use(); |
||||
|
||||
/* Bottom */ |
||||
AbstractShapeRenderer<dimensions>::wireframeShader->setTransformationProjectionMatrix(projectionMatrix*transformations[0]); |
||||
AbstractCapsuleRenderer<dimensions>::bottom->draw(); |
||||
|
||||
/* Cylinder */ |
||||
AbstractShapeRenderer<dimensions>::wireframeShader->setTransformationProjectionMatrix(projectionMatrix*transformations[1]); |
||||
AbstractCapsuleRenderer<dimensions>::cylinder->draw(); |
||||
|
||||
/* Top */ |
||||
AbstractShapeRenderer<dimensions>::wireframeShader->setTransformationProjectionMatrix(projectionMatrix*transformations[2]); |
||||
AbstractCapsuleRenderer<dimensions>::top->draw(); |
||||
} |
||||
|
||||
template class CapsuleRenderer<2>; |
||||
template class CapsuleRenderer<3>; |
||||
|
||||
}}} |
||||
@ -0,0 +1,66 @@
|
||||
#ifndef Magnum_DebugTools_Implementation_CapsuleRenderer_h |
||||
#define Magnum_DebugTools_Implementation_CapsuleRenderer_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "AbstractShapeRenderer.h" |
||||
|
||||
#include "Shapes/Shapes.h" |
||||
|
||||
#include "corradeCompatibility.h" |
||||
|
||||
namespace Magnum { namespace DebugTools { namespace Implementation { |
||||
|
||||
template<UnsignedInt dimensions> class AbstractCapsuleRenderer; |
||||
|
||||
template<> class AbstractCapsuleRenderer<2>: public AbstractShapeRenderer<2> { |
||||
public: |
||||
explicit AbstractCapsuleRenderer(); |
||||
|
||||
protected: |
||||
Resource<MeshView> bottom, cylinder, top; |
||||
}; |
||||
|
||||
template<> class AbstractCapsuleRenderer<3>: public AbstractShapeRenderer<3> { |
||||
public: |
||||
explicit AbstractCapsuleRenderer(); |
||||
|
||||
protected: |
||||
Resource<MeshView> bottom, cylinder, top; |
||||
}; |
||||
|
||||
template<UnsignedInt dimensions> class CapsuleRenderer: public AbstractCapsuleRenderer<dimensions> { |
||||
public: |
||||
explicit CapsuleRenderer(const Shapes::Implementation::AbstractShape<dimensions>& capsule); |
||||
CapsuleRenderer(const Shapes::Implementation::AbstractShape<dimensions>&&) = delete; |
||||
|
||||
void draw(Resource<ShapeRendererOptions>& options, const typename DimensionTraits<dimensions, Float>::MatrixType& projectionMatrix) override; |
||||
|
||||
private: |
||||
const Shapes::Capsule<dimensions>& capsule; |
||||
}; |
||||
|
||||
}}} |
||||
|
||||
#endif |
||||
@ -0,0 +1,106 @@
|
||||
#ifndef Magnum_DebugTools_Implementation_ForceRendererTransformation_h |
||||
#define Magnum_DebugTools_Implementation_ForceRendererTransformation_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include <array> |
||||
|
||||
#include "Math/Functions.h" |
||||
#include "Math/Matrix3.h" |
||||
#include "Math/Matrix4.h" |
||||
#include "Magnum.h" |
||||
#include "DimensionTraits.h" |
||||
|
||||
namespace Magnum { namespace DebugTools { namespace Implementation { |
||||
|
||||
template<UnsignedInt dimensions> std::array<typename DimensionTraits<dimensions, Float>::MatrixType, 3> capsuleRendererTransformation(const typename DimensionTraits<dimensions, Float>::VectorType& a, const typename DimensionTraits<dimensions, Float>::VectorType& b, Float radius); |
||||
|
||||
template<> std::array<Matrix3, 3> capsuleRendererTransformation<2>(const Vector2& a, const Vector2& b, const Float radius) { |
||||
/* Vector from capsule center to top hemisphere center */ |
||||
const Vector2 direction = 0.5f*(b - a); |
||||
const Float length = direction.length(); |
||||
|
||||
/* Capsule rotation and distance to caps after they are scaled to proper
|
||||
radius (if nonzero cylinder length) */ |
||||
Matrix3 rotation; |
||||
Vector2 capDistance; |
||||
if(length >= Math::TypeTraits<Float>::epsilon()) { |
||||
rotation.up() = direction/length; |
||||
rotation.right() = rotation.up().perpendicular(); |
||||
CORRADE_INTERNAL_ASSERT(rotation.right().isNormalized()); |
||||
|
||||
capDistance = direction*(radius/length); |
||||
} |
||||
|
||||
/* Scaling and translation of all parts */ |
||||
const auto rotationScaling = rotation*Matrix3::scaling(Vector2(radius)); |
||||
return {{ |
||||
Matrix3::translation(a+capDistance)*rotationScaling, |
||||
Matrix3::translation(0.5f*(a + b))*rotation*Matrix3::scaling({radius, length}), |
||||
Matrix3::translation(b-capDistance)*rotationScaling |
||||
}}; |
||||
} |
||||
|
||||
template<> std::array<Matrix4, 3> capsuleRendererTransformation<3>(const Vector3& a, const Vector3& b, const Float radius) { |
||||
/* Vector from capsule center to top hemisphere center */ |
||||
const Vector3 direction = 0.5f*(b - a); |
||||
const Float length = direction.length(); |
||||
|
||||
/* Capsule rotation and distance to caps after they are scaled to proper
|
||||
radius (if nonzero cylinder length) */ |
||||
Matrix4 rotation; |
||||
Vector3 capDistance; |
||||
if(length >= Math::TypeTraits<Float>::epsilon()) { |
||||
const Vector3 directionNormalized = direction/length; |
||||
const Float dot = Vector3::dot(directionNormalized, Vector3::zAxis()); |
||||
|
||||
/* Direction is parallel to Z axis, special rotation case */ |
||||
if(Math::abs(dot) > 1.0f - Math::TypeTraits<Float>::epsilon()) { |
||||
rotation.up() = dot*Vector3::zAxis(); |
||||
rotation.right() = Vector3::xAxis(); |
||||
rotation.backward() = -dot*Vector3::yAxis(); |
||||
|
||||
/* Common case */ |
||||
} else { |
||||
rotation.up() = directionNormalized; |
||||
rotation.right() = Vector3::cross(rotation.up(), Vector3::zAxis()).normalized(); |
||||
rotation.backward() = Vector3::cross(rotation.right(), rotation.up()); |
||||
CORRADE_INTERNAL_ASSERT(rotation.up().isNormalized() && rotation.backward().isNormalized()); |
||||
} |
||||
|
||||
capDistance = directionNormalized*radius; |
||||
} |
||||
|
||||
/* Scaling and translation of all parts */ |
||||
const auto rotationScaling = rotation*Matrix4::scaling(Vector3(radius)); |
||||
return {{ |
||||
Matrix4::translation(a+capDistance)*rotationScaling, |
||||
Matrix4::translation(0.5f*(a + b))*rotation*Matrix4::scaling({radius, length, radius}), |
||||
Matrix4::translation(b-capDistance)*rotationScaling |
||||
}}; |
||||
} |
||||
|
||||
}}} |
||||
|
||||
#endif |
||||
@ -0,0 +1,61 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "CylinderRenderer.h" |
||||
|
||||
#include "Mesh.h" |
||||
#include "DebugTools/ShapeRenderer.h" |
||||
#include "Shapes/Cylinder.h" |
||||
#include "Primitives/Cylinder.h" |
||||
#include "Primitives/Square.h" |
||||
#include "Shaders/Flat.h" |
||||
#include "Trade/MeshData2D.h" |
||||
#include "Trade/MeshData3D.h" |
||||
|
||||
#include "DebugTools/Implementation/CylinderRendererTransformation.h" |
||||
|
||||
namespace Magnum { namespace DebugTools { namespace Implementation { |
||||
|
||||
AbstractCylinderRenderer<2>::AbstractCylinderRenderer(): AbstractShapeRenderer<2>("cylinder2d", "cylinder2d-vertices", {}) { |
||||
if(!wireframeMesh) createResources(Primitives::Square::wireframe()); |
||||
} |
||||
|
||||
AbstractCylinderRenderer<3>::AbstractCylinderRenderer(): AbstractShapeRenderer<3>("cylinder3d", "cylinder3d-vertices", "cylinder3d-indices") { |
||||
if(!wireframeMesh) createResources(Primitives::Cylinder::wireframe(1, 40, 1.0f)); |
||||
} |
||||
|
||||
template<UnsignedInt dimensions> CylinderRenderer<dimensions>::CylinderRenderer(const Shapes::Implementation::AbstractShape<dimensions>& cylinder): cylinder(static_cast<const Shapes::Implementation::Shape<Shapes::Cylinder<dimensions>>&>(cylinder).shape) {} |
||||
|
||||
template<UnsignedInt dimensions> void CylinderRenderer<dimensions>::draw(Resource<ShapeRendererOptions>& options, const typename DimensionTraits<dimensions, Float>::MatrixType& projectionMatrix) { |
||||
AbstractShapeRenderer<dimensions>::wireframeShader->setTransformationProjectionMatrix(projectionMatrix* |
||||
Implementation::cylinderRendererTransformation<dimensions>(cylinder.a(), cylinder.b(), cylinder.radius())) |
||||
.setColor(options->color()) |
||||
.use(); |
||||
AbstractShapeRenderer<dimensions>::wireframeMesh->draw(); |
||||
} |
||||
|
||||
template class CylinderRenderer<2>; |
||||
template class CylinderRenderer<3>; |
||||
|
||||
}}} |
||||
@ -0,0 +1,60 @@
|
||||
#ifndef Magnum_DebugTools_Implementation_CylinderRenderer_h |
||||
#define Magnum_DebugTools_Implementation_CylinderRenderer_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "AbstractShapeRenderer.h" |
||||
|
||||
#include "Shapes/Shapes.h" |
||||
|
||||
#include "corradeCompatibility.h" |
||||
|
||||
namespace Magnum { namespace DebugTools { namespace Implementation { |
||||
|
||||
template<UnsignedInt dimensions> class AbstractCylinderRenderer; |
||||
|
||||
template<> class AbstractCylinderRenderer<2>: public AbstractShapeRenderer<2> { |
||||
public: |
||||
explicit AbstractCylinderRenderer(); |
||||
}; |
||||
|
||||
template<> class AbstractCylinderRenderer<3>: public AbstractShapeRenderer<3> { |
||||
public: |
||||
explicit AbstractCylinderRenderer(); |
||||
}; |
||||
|
||||
template<UnsignedInt dimensions> class CylinderRenderer: public AbstractCylinderRenderer<dimensions> { |
||||
public: |
||||
explicit CylinderRenderer(const Shapes::Implementation::AbstractShape<dimensions>& cylinder); |
||||
CylinderRenderer(const Shapes::Implementation::AbstractShape<dimensions>&&) = delete; |
||||
|
||||
void draw(Resource<ShapeRendererOptions>& options, const typename DimensionTraits<dimensions, Float>::MatrixType& projectionMatrix) override; |
||||
|
||||
private: |
||||
const Shapes::Cylinder<dimensions>& cylinder; |
||||
}; |
||||
|
||||
}}} |
||||
|
||||
#endif |
||||
@ -0,0 +1,88 @@
|
||||
#ifndef Magnum_DebugTools_Implementation_ForceRendererTransformation_h |
||||
#define Magnum_DebugTools_Implementation_ForceRendererTransformation_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "Math/Functions.h" |
||||
#include "Math/Matrix3.h" |
||||
#include "Math/Matrix4.h" |
||||
#include "Magnum.h" |
||||
#include "DimensionTraits.h" |
||||
|
||||
namespace Magnum { namespace DebugTools { namespace Implementation { |
||||
|
||||
template<UnsignedInt dimensions> typename DimensionTraits<dimensions, Float>::MatrixType cylinderRendererTransformation(const typename DimensionTraits<dimensions, Float>::VectorType& a, const typename DimensionTraits<dimensions, Float>::VectorType& b, Float radius); |
||||
|
||||
template<> Matrix3 cylinderRendererTransformation<2>(const Vector2& a, const Vector2& b, const Float radius) { |
||||
/* Vector from cylinder center to top hemisphere center */ |
||||
const Vector2 direction = 0.5f*(b - a); |
||||
const Float length = direction.length(); |
||||
|
||||
/* Capsule rotation and distance to caps after they are scaled to proper
|
||||
radius (if nonzero cylinder length) */ |
||||
Matrix3 rotation; |
||||
if(length >= Math::TypeTraits<Float>::epsilon()) { |
||||
rotation.up() = direction/length; |
||||
rotation.right() = rotation.up().perpendicular(); |
||||
CORRADE_INTERNAL_ASSERT(rotation.right().isNormalized()); |
||||
} |
||||
|
||||
/* Scaling and translation */ |
||||
return Matrix3::translation(0.5f*(a + b))*rotation*Matrix3::scaling({radius, length}); |
||||
} |
||||
|
||||
template<> Matrix4 cylinderRendererTransformation<3>(const Vector3& a, const Vector3& b, const Float radius) { |
||||
/* Vector from cylinder center to top hemisphere center */ |
||||
const Vector3 direction = 0.5f*(b - a); |
||||
const Float length = direction.length(); |
||||
|
||||
/* Capsule rotation and distance to caps after they are scaled to proper
|
||||
radius (if nonzero cylinder length) */ |
||||
Matrix4 rotation; |
||||
if(length >= Math::TypeTraits<Float>::epsilon()) { |
||||
const Vector3 directionNormalized = direction/length; |
||||
const Float dot = Vector3::dot(directionNormalized, Vector3::zAxis()); |
||||
|
||||
/* Direction is parallel to Z axis, special rotation case */ |
||||
if(Math::abs(dot) > 1.0f - Math::TypeTraits<Float>::epsilon()) { |
||||
rotation.up() = dot*Vector3::zAxis(); |
||||
rotation.right() = Vector3::xAxis(); |
||||
rotation.backward() = -dot*Vector3::yAxis(); |
||||
|
||||
/* Common case */ |
||||
} else { |
||||
rotation.up() = directionNormalized; |
||||
rotation.right() = Vector3::cross(rotation.up(), Vector3::zAxis()).normalized(); |
||||
rotation.backward() = Vector3::cross(rotation.right(), rotation.up()); |
||||
CORRADE_INTERNAL_ASSERT(rotation.up().isNormalized() && rotation.backward().isNormalized()); |
||||
} |
||||
} |
||||
|
||||
/* Scaling and translation */ |
||||
return Matrix4::translation(0.5f*(a + b))*rotation*Matrix4::scaling({radius, length, radius}); |
||||
} |
||||
|
||||
}}} |
||||
|
||||
#endif |
||||
@ -0,0 +1,177 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include <TestSuite/Tester.h> |
||||
|
||||
#include "DebugTools/Implementation/CapsuleRendererTransformation.h" |
||||
|
||||
namespace Magnum { namespace DebugTools { namespace Test { |
||||
|
||||
class CapsuleRendererTest: public TestSuite::Tester { |
||||
public: |
||||
explicit CapsuleRendererTest(); |
||||
|
||||
void zeroLength2D(); |
||||
void common2D(); |
||||
|
||||
void zeroLength3D(); |
||||
void parallel3D(); |
||||
void antiParallel3D(); |
||||
void common3D(); |
||||
}; |
||||
|
||||
CapsuleRendererTest::CapsuleRendererTest() { |
||||
addTests({&CapsuleRendererTest::zeroLength2D, |
||||
&CapsuleRendererTest::common2D, |
||||
|
||||
&CapsuleRendererTest::zeroLength3D, |
||||
&CapsuleRendererTest::parallel3D, |
||||
&CapsuleRendererTest::antiParallel3D, |
||||
&CapsuleRendererTest::common3D}); |
||||
} |
||||
|
||||
void CapsuleRendererTest::zeroLength2D() { |
||||
const Vector2 a(0.5f, 3.0f); |
||||
std::array<Matrix3, 3> transformation = Implementation::capsuleRendererTransformation<2>(a, a, 3.5f); |
||||
|
||||
const auto scaling = Math::Matrix<2, Float>::fromDiagonal(Vector2(3.5f)); |
||||
CORRADE_COMPARE(transformation[0].rotationScaling(), scaling); |
||||
CORRADE_COMPARE(transformation[1].rotationScaling(), (Math::Matrix<2, Float>::fromDiagonal({3.5f, 0.0f}))); |
||||
CORRADE_COMPARE(transformation[2].rotationScaling(), scaling); |
||||
|
||||
CORRADE_COMPARE(transformation[0].translation(), a); |
||||
CORRADE_COMPARE(transformation[1].translation(), a); |
||||
CORRADE_COMPARE(transformation[2].translation(), a); |
||||
} |
||||
|
||||
void CapsuleRendererTest::common2D() { |
||||
const Vector2 a(0.5f, 3.0f); |
||||
const Vector2 b(7.5f, -1.0f); |
||||
std::array<Matrix3, 3> transformation = Implementation::capsuleRendererTransformation<2>(a, b, 3.5f); |
||||
|
||||
/* Vector from capsule center to top hemisphere center */ |
||||
const Vector2 up(3.5f, -2.0f); |
||||
CORRADE_COMPARE(transformation[0].up(), up.resized(3.5f)); |
||||
CORRADE_COMPARE(transformation[1].up(), up); |
||||
CORRADE_COMPARE(transformation[2].up(), up.resized(3.5f)); |
||||
|
||||
const auto right = Vector2(4.0f, 7.0f).resized(3.5f); |
||||
CORRADE_COMPARE(transformation[0].right(), right); |
||||
CORRADE_COMPARE(transformation[1].right(), right); |
||||
CORRADE_COMPARE(transformation[2].right(), right); |
||||
|
||||
/* Orthogonality */ |
||||
CORRADE_COMPARE(Vector2::dot(transformation[0].up(), transformation[0].right()), 0.0f); |
||||
|
||||
const Vector2 capDistance = up.resized(3.5f); |
||||
CORRADE_COMPARE(transformation[0].translation(), a+capDistance); |
||||
CORRADE_COMPARE(transformation[1].translation(), 0.5f*(a + b)); |
||||
CORRADE_COMPARE(transformation[2].translation(), b-capDistance); |
||||
} |
||||
|
||||
void CapsuleRendererTest::zeroLength3D() { |
||||
const Vector3 a(0.5f, 3.0f, 7.0f); |
||||
std::array<Matrix4, 3> transformation = Implementation::capsuleRendererTransformation<3>(a, a, 3.5f); |
||||
|
||||
const auto scaling = Math::Matrix<3, Float>::fromDiagonal(Vector3(3.5f)); |
||||
CORRADE_COMPARE(transformation[0].rotationScaling(), scaling); |
||||
CORRADE_COMPARE(transformation[1].rotationScaling(), (Math::Matrix<3, Float>::fromDiagonal({3.5f, 0.0f, 3.5f}))); |
||||
CORRADE_COMPARE(transformation[2].rotationScaling(), scaling); |
||||
|
||||
CORRADE_COMPARE(transformation[0].translation(), a); |
||||
CORRADE_COMPARE(transformation[1].translation(), a); |
||||
CORRADE_COMPARE(transformation[2].translation(), a); |
||||
} |
||||
|
||||
void CapsuleRendererTest::parallel3D() { |
||||
const Vector3 a(0.5f, 3.0f, 7.0f); |
||||
const Vector3 b(0.5f, 3.0f, 11.0f); |
||||
std::array<Matrix4, 3> transformation = Implementation::capsuleRendererTransformation<3>(a, b, 3.5f); |
||||
|
||||
const auto rotation = Matrix4::rotationX(Deg(90.0f)); |
||||
const auto scaling = (rotation*Matrix4::scaling(Vector3(3.5f))).rotationScaling(); |
||||
CORRADE_COMPARE(transformation[0].rotationScaling(), scaling); |
||||
CORRADE_COMPARE(transformation[1].rotationScaling(), |
||||
(rotation*Matrix4::scaling({3.5f, 2.0f, 3.5f})).rotationScaling()); |
||||
CORRADE_COMPARE(transformation[2].rotationScaling(), scaling); |
||||
|
||||
const auto capDistance = Vector3::zAxis(3.5f); |
||||
CORRADE_COMPARE(transformation[0].translation(), a+capDistance); |
||||
CORRADE_COMPARE(transformation[1].translation(), a+Vector3::zAxis(2.0f)); |
||||
CORRADE_COMPARE(transformation[2].translation(), b-capDistance); |
||||
} |
||||
|
||||
void CapsuleRendererTest::antiParallel3D() { |
||||
const Vector3 a(0.5f, 3.0f, 7.0f); |
||||
const Vector3 b(0.5f, 3.0f, 3.0f); |
||||
std::array<Matrix4, 3> transformation = Implementation::capsuleRendererTransformation<3>(a, b, 3.5f); |
||||
|
||||
const auto rotation = Matrix4::rotationX(-Deg(90.0f)); |
||||
const auto rotationScaling = (rotation*Matrix4::scaling(Vector3(3.5f))).rotationScaling(); |
||||
CORRADE_COMPARE(transformation[0].rotationScaling(), rotationScaling); |
||||
CORRADE_COMPARE(transformation[1].rotationScaling(), |
||||
(rotation*Matrix4::scaling({3.5f, 2.0f, 3.5f})).rotationScaling()); |
||||
CORRADE_COMPARE(transformation[2].rotationScaling(), rotationScaling); |
||||
|
||||
const auto capDistance = Vector3::zAxis(-3.5f); |
||||
CORRADE_COMPARE(transformation[0].translation(), a+capDistance); |
||||
CORRADE_COMPARE(transformation[1].translation(), a+Vector3::zAxis(-2.0f)); |
||||
CORRADE_COMPARE(transformation[2].translation(), b-capDistance); |
||||
} |
||||
|
||||
void CapsuleRendererTest::common3D() { |
||||
const Vector3 a(0.5f, 3.0f, 7.0f); |
||||
const Vector3 b(7.5f, -1.0f, 1.5f); |
||||
std::array<Matrix4, 3> transformation = Implementation::capsuleRendererTransformation<3>(a, b, 3.5f); |
||||
|
||||
/* Vector from capsule center to top hemisphere center */ |
||||
const Vector3 up(3.5f, -2.0f, -2.75f); |
||||
CORRADE_COMPARE(transformation[0].up(), up.resized(3.5f)); |
||||
CORRADE_COMPARE(transformation[1].up(), up); |
||||
CORRADE_COMPARE(transformation[2].up(), up.resized(3.5f)); |
||||
|
||||
const auto right = Vector3(-2.0f, -3.5f, 0.0f).resized(3.5f); |
||||
CORRADE_COMPARE(transformation[0].right(), right); |
||||
CORRADE_COMPARE(transformation[1].right(), right); |
||||
CORRADE_COMPARE(transformation[2].right(), right); |
||||
|
||||
const auto backward = Vector3(9.625f, -5.5f, 16.25f).resized(3.5f); |
||||
CORRADE_COMPARE(transformation[0].backward(), backward); |
||||
CORRADE_COMPARE(transformation[1].backward(), backward); |
||||
CORRADE_COMPARE(transformation[2].backward(), backward); |
||||
|
||||
/* Orthogonality */ |
||||
CORRADE_COMPARE(Vector3::dot(transformation[0].up(), transformation[0].right()), 0.0f); |
||||
CORRADE_COMPARE(Vector3::dot(transformation[0].up(), transformation[0].backward()), 0.0f); |
||||
CORRADE_COMPARE(Vector3::dot(transformation[0].right(), transformation[0].backward()), 0.0f); |
||||
|
||||
const Vector3 capDistance = up.resized(3.5f); |
||||
CORRADE_COMPARE(transformation[0].translation(), a+capDistance); |
||||
CORRADE_COMPARE(transformation[1].translation(), 0.5f*(a + b)); |
||||
CORRADE_COMPARE(transformation[2].translation(), b-capDistance); |
||||
} |
||||
|
||||
}}} |
||||
|
||||
CORRADE_TEST_MAIN(Magnum::DebugTools::Test::CapsuleRendererTest) |
||||
@ -0,0 +1,125 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include <TestSuite/Tester.h> |
||||
|
||||
#include "DebugTools/Implementation/CylinderRendererTransformation.h" |
||||
|
||||
namespace Magnum { namespace DebugTools { namespace Test { |
||||
|
||||
class CylinderRendererTest: public TestSuite::Tester { |
||||
public: |
||||
explicit CylinderRendererTest(); |
||||
|
||||
void zeroLength2D(); |
||||
void common2D(); |
||||
|
||||
void zeroLength3D(); |
||||
void parallel3D(); |
||||
void antiParallel3D(); |
||||
void common3D(); |
||||
}; |
||||
|
||||
CylinderRendererTest::CylinderRendererTest() { |
||||
addTests({&CylinderRendererTest::zeroLength2D, |
||||
&CylinderRendererTest::common2D, |
||||
|
||||
&CylinderRendererTest::zeroLength3D, |
||||
&CylinderRendererTest::parallel3D, |
||||
&CylinderRendererTest::antiParallel3D, |
||||
&CylinderRendererTest::common3D}); |
||||
} |
||||
|
||||
void CylinderRendererTest::zeroLength2D() { |
||||
const Vector2 a(0.5f, 3.0f); |
||||
const Matrix3 transformation = Implementation::cylinderRendererTransformation<2>(a, a, 3.5f); |
||||
|
||||
CORRADE_COMPARE(transformation.rotationScaling(), (Math::Matrix<2, Float>::fromDiagonal({3.5f, 0.0f}))); |
||||
CORRADE_COMPARE(transformation.translation(), a); |
||||
} |
||||
|
||||
void CylinderRendererTest::common2D() { |
||||
const Vector2 a(0.5f, 3.0f); |
||||
const Vector2 b(7.5f, -1.0f); |
||||
const Matrix3 transformation = Implementation::cylinderRendererTransformation<2>(a, b, 3.5f); |
||||
|
||||
/* Rotation + scaling, test orthogonality */ |
||||
CORRADE_COMPARE(transformation.up(), Vector2(3.5f, -2.0f)); |
||||
CORRADE_COMPARE(transformation.right(), Vector2(4.0f, 7.0f).resized(3.5f)); |
||||
CORRADE_COMPARE(Vector2::dot(transformation.up(), transformation.right()), 0.0f); |
||||
|
||||
CORRADE_COMPARE(transformation.translation(), 0.5f*(a + b)); |
||||
} |
||||
|
||||
void CylinderRendererTest::zeroLength3D() { |
||||
const Vector3 a(0.5f, 3.0f, 7.0f); |
||||
const Matrix4 transformation = Implementation::cylinderRendererTransformation<3>(a, a, 3.5f); |
||||
|
||||
CORRADE_COMPARE(transformation.rotationScaling(), (Math::Matrix<3, Float>::fromDiagonal({3.5f, 0.0f, 3.5f}))); |
||||
CORRADE_COMPARE(transformation.translation(), a); |
||||
} |
||||
|
||||
void CylinderRendererTest::parallel3D() { |
||||
const Vector3 a(0.5f, 3.0f, 7.0f); |
||||
const Vector3 b(0.5f, 3.0f, 11.0f); |
||||
const Matrix4 transformation = Implementation::cylinderRendererTransformation<3>(a, b, 3.5f); |
||||
|
||||
CORRADE_COMPARE(transformation.rotationScaling(), |
||||
(Matrix4::rotationX(Deg(90.0f))*Matrix4::scaling({3.5f, 2.0f, 3.5f})).rotationScaling()); |
||||
|
||||
CORRADE_COMPARE(transformation.translation(), a+Vector3::zAxis(2.0f)); |
||||
} |
||||
|
||||
void CylinderRendererTest::antiParallel3D() { |
||||
const Vector3 a(0.5f, 3.0f, 7.0f); |
||||
const Vector3 b(0.5f, 3.0f, 3.0f); |
||||
const Matrix4 transformation = Implementation::cylinderRendererTransformation<3>(a, b, 3.5f); |
||||
|
||||
CORRADE_COMPARE(transformation.rotationScaling(), |
||||
(Matrix4::rotationX(-Deg(90.0f))*Matrix4::scaling({3.5f, 2.0f, 3.5f})).rotationScaling()); |
||||
|
||||
CORRADE_COMPARE(transformation.translation(), a+Vector3::zAxis(-2.0f)); |
||||
} |
||||
|
||||
void CylinderRendererTest::common3D() { |
||||
const Vector3 a(0.5f, 3.0f, 7.0f); |
||||
const Vector3 b(7.5f, -1.0f, 1.5f); |
||||
const Matrix4 transformation = Implementation::cylinderRendererTransformation<3>(a, b, 3.5f); |
||||
|
||||
/* Rotation + scaling */ |
||||
CORRADE_COMPARE(transformation.up(), Vector3(3.5f, -2.0f, -2.75f)); |
||||
CORRADE_COMPARE(transformation.right(), Vector3(-2.0f, -3.5f, 0.0f).resized(3.5f)); |
||||
CORRADE_COMPARE(transformation.backward(), Vector3(9.625f, -5.5f, 16.25f).resized(3.5f)); |
||||
|
||||
/* Orthogonality */ |
||||
CORRADE_COMPARE(Vector3::dot(transformation.up(), transformation.right()), 0.0f); |
||||
CORRADE_COMPARE(Vector3::dot(transformation.up(), transformation.backward()), 0.0f); |
||||
CORRADE_COMPARE(Vector3::dot(transformation.right(), transformation.backward()), 0.0f); |
||||
|
||||
CORRADE_COMPARE(transformation.translation(), 0.5f*(a + b)); |
||||
} |
||||
|
||||
}}} |
||||
|
||||
CORRADE_TEST_MAIN(Magnum::DebugTools::Test::CylinderRendererTest) |
||||
@ -0,0 +1,43 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "MeshView.h" |
||||
|
||||
#include "Mesh.h" |
||||
|
||||
namespace Magnum { |
||||
|
||||
MeshView& MeshView::setIndexRange(Int first, Int count, UnsignedInt start, UnsignedInt end) { |
||||
_indexOffset = first*_original->indexSize(); |
||||
_indexCount = count; |
||||
_indexStart = start; |
||||
_indexEnd = end; |
||||
return *this; |
||||
} |
||||
|
||||
void MeshView::draw() { |
||||
_original->drawInternal(_firstVertex, _vertexCount, _indexOffset, _indexCount, _indexStart, _indexEnd); |
||||
} |
||||
|
||||
} |
||||
@ -0,0 +1,139 @@
|
||||
#ifndef Magnum_MeshView_h |
||||
#define Magnum_MeshView_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
/** @file
|
||||
* @brief Class Magnum::MeshView |
||||
*/ |
||||
|
||||
#include "Magnum.h" |
||||
#include "magnumVisibility.h" |
||||
|
||||
#ifndef DOXYGEN_GENERATING_OUTPUT |
||||
typedef std::ptrdiff_t GLintptr; |
||||
#endif |
||||
|
||||
namespace Magnum { |
||||
|
||||
/**
|
||||
@brief %Mesh view |
||||
|
||||
Allows different interpretation of given @ref Mesh data via different vertex or |
||||
index count and offset. It is then possible to reuse one mesh buffer |
||||
configuration for different views. %Mesh primitive, index type, attribute |
||||
bindings and attached buffers are reused from original mesh. |
||||
|
||||
The same rules as in Mesh apply, i.e. if the view has non-zero index count, it |
||||
is treated as indexed mesh, otherwise it is treated as non-indexed mesh. If |
||||
both index and vertex count is zero, the view is treated as empty and no draw |
||||
commands are issued when calling draw(). |
||||
|
||||
You must ensure that the original mesh remains available for whole view |
||||
lifetime. |
||||
@todo Might cause issues when there are more data than just indices in index |
||||
buffer (wrongly computed offset) |
||||
*/ |
||||
class MAGNUM_EXPORT MeshView { |
||||
public: |
||||
/**
|
||||
* @brief Constructor |
||||
* @param original Original, already configured mesh |
||||
*/ |
||||
explicit MeshView(Mesh& original); |
||||
|
||||
/** @brief Copy constructor */ |
||||
MeshView(const MeshView& other) = default; |
||||
|
||||
/** @brief Movement is not allowed */ |
||||
MeshView(MeshView&& other) = delete; |
||||
|
||||
/** @brief Copy assignment */ |
||||
MeshView& operator=(const MeshView&) = default; |
||||
|
||||
/** @brief Movement is not allowed */ |
||||
MeshView& operator=(MeshView&& other) = delete; |
||||
|
||||
/**
|
||||
* @brief Set vertex range |
||||
* @param first First vertex |
||||
* @param count Vertex count |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Default is zero @p offset and zero @p count. If index range is |
||||
* non-zero, vertex range is ignored, see main class documentation for |
||||
* more information. |
||||
*/ |
||||
MeshView& setVertexRange(Int first, Int count) { |
||||
_firstVertex = first; |
||||
_vertexCount = count; |
||||
return *this; |
||||
} |
||||
|
||||
/**
|
||||
* @brief Set index range |
||||
* @param first First index |
||||
* @param count Index count |
||||
* @param start Minimum array index contained in the buffer |
||||
* @param end Maximum array index contained in the buffer |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Specifying `0` for both @p start and @p end behaves the same as |
||||
* @ref setIndexRange(Int, Int). |
||||
*/ |
||||
MeshView& setIndexRange(Int first, Int count, UnsignedInt start, UnsignedInt end); |
||||
|
||||
/**
|
||||
* @brief Set index range |
||||
* @param first First index |
||||
* @param count Index count |
||||
* @return Reference to self (for method chaining) |
||||
* |
||||
* Prefer to use @ref setIndexRange(Int, Int, UnsignedInt, UnsignedInt) |
||||
* for better performance. |
||||
*/ |
||||
MeshView& setIndexRange(Int first, Int count) { |
||||
return setIndexRange(first, count, 0, 0); |
||||
} |
||||
|
||||
/**
|
||||
* @brief Draw the mesh |
||||
* |
||||
* See @ref Mesh::draw() for more information. |
||||
*/ |
||||
void draw(); |
||||
|
||||
private: |
||||
Mesh* _original; |
||||
|
||||
Int _firstVertex, _vertexCount, _indexCount; |
||||
GLintptr _indexOffset; |
||||
UnsignedInt _indexStart, _indexEnd; |
||||
}; |
||||
|
||||
inline MeshView::MeshView(Mesh& original): _original(&original), _firstVertex(0), _vertexCount(0), _indexCount(0), _indexOffset(0), _indexStart(0), _indexEnd(0) {} |
||||
|
||||
} |
||||
|
||||
#endif |
||||
@ -0,0 +1,58 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "Cylinder.h" |
||||
|
||||
#include "Math/Functions.h" |
||||
#include "Math/Matrix3.h" |
||||
#include "Math/Matrix4.h" |
||||
#include "Math/Geometry/Distance.h" |
||||
#include "Magnum.h" |
||||
#include "Shapes/Point.h" |
||||
#include "Shapes/Sphere.h" |
||||
|
||||
using namespace Magnum::Math::Geometry; |
||||
|
||||
namespace Magnum { namespace Shapes { |
||||
|
||||
template<UnsignedInt dimensions> Cylinder<dimensions> Cylinder<dimensions>::transformed(const typename DimensionTraits<dimensions, Float>::MatrixType& matrix) const { |
||||
return Cylinder<dimensions>(matrix.transformPoint(_a), matrix.transformPoint(_b), matrix.uniformScaling()*_radius); |
||||
} |
||||
|
||||
template<UnsignedInt dimensions> bool Cylinder<dimensions>::operator%(const Point<dimensions>& other) const { |
||||
return Distance::linePointSquared(_a, _b, other.position()) < |
||||
Math::pow<2>(_radius); |
||||
} |
||||
|
||||
template<UnsignedInt dimensions> bool Cylinder<dimensions>::operator%(const Sphere<dimensions>& other) const { |
||||
return Distance::linePointSquared(_a, _b, other.position()) < |
||||
Math::pow<2>(_radius+other.radius()); |
||||
} |
||||
|
||||
#ifndef DOXYGEN_GENERATING_OUTPUT |
||||
template class MAGNUM_SHAPES_EXPORT Cylinder<2>; |
||||
template class MAGNUM_SHAPES_EXPORT Cylinder<3>; |
||||
#endif |
||||
|
||||
}} |
||||
@ -0,0 +1,117 @@
|
||||
#ifndef Magnum_Shapes_Cylinder_h |
||||
#define Magnum_Shapes_Cylinder_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
/** @file
|
||||
* @brief Class Magnum::Shapes::Cylinder, typedef Magnum::Shapes::Cylinder2D, Magnum::Shapes::Cylinder3D |
||||
*/ |
||||
|
||||
#include "Math/Vector3.h" |
||||
#include "DimensionTraits.h" |
||||
#include "Shapes/Shapes.h" |
||||
#include "Shapes/magnumShapesVisibility.h" |
||||
|
||||
namespace Magnum { namespace Shapes { |
||||
|
||||
/**
|
||||
@brief Infinite cylinder defined by line and radius |
||||
|
||||
Unlike other elements the cylinder expects uniform scaling. See @ref shapes for |
||||
brief introduction. |
||||
@see @ref Cylinder2D, @ref Cylinder3D, @ref Capsule |
||||
@todo Store the radius as squared value to avoid sqrt/pow? Will complicate |
||||
collision detection with sphere. |
||||
*/ |
||||
template<UnsignedInt dimensions> class MAGNUM_SHAPES_EXPORT Cylinder { |
||||
public: |
||||
enum: UnsignedInt { |
||||
Dimensions = dimensions /**< Dimension count */ |
||||
}; |
||||
|
||||
/**
|
||||
* @brief Constructor |
||||
* |
||||
* Creates zero-sized cylinder at origin. |
||||
*/ |
||||
constexpr /*implicit*/ Cylinder(): _radius(0.0f) {} |
||||
|
||||
/** @brief Constructor */ |
||||
constexpr /*implicit*/ Cylinder(const typename DimensionTraits<dimensions, Float>::VectorType& a, const typename DimensionTraits<dimensions, Float>::VectorType& b, Float radius): _a(a), _b(b), _radius(radius) {} |
||||
|
||||
/** @brief Transformed shape */ |
||||
Cylinder<dimensions> transformed(const typename DimensionTraits<dimensions, Float>::MatrixType& matrix) const; |
||||
|
||||
/** @brief First point */ |
||||
constexpr typename DimensionTraits<dimensions, Float>::VectorType a() const { |
||||
return _a; |
||||
} |
||||
|
||||
/** @brief Set first point */ |
||||
void setA(const typename DimensionTraits<dimensions, Float>::VectorType& a) { |
||||
_a = a; |
||||
} |
||||
|
||||
/** @brief Second point */ |
||||
constexpr typename DimensionTraits<dimensions, Float>::VectorType b() const { |
||||
return _b; |
||||
} |
||||
|
||||
/** @brief Set second point */ |
||||
void setB(const typename DimensionTraits<dimensions, Float>::VectorType& b) { |
||||
_b = b; |
||||
} |
||||
|
||||
/** @brief Radius */ |
||||
constexpr Float radius() const { return _radius; } |
||||
|
||||
/** @brief Set radius */ |
||||
void setRadius(Float radius) { _radius = radius; } |
||||
|
||||
/** @brief Collision with point */ |
||||
bool operator%(const Point<dimensions>& other) const; |
||||
|
||||
/** @brief Collision with sphere */ |
||||
bool operator%(const Sphere<dimensions>& other) const; |
||||
|
||||
private: |
||||
typename DimensionTraits<dimensions, Float>::VectorType _a, _b; |
||||
Float _radius; |
||||
}; |
||||
|
||||
/** @brief Infinite two-dimensional cylinder */ |
||||
typedef Cylinder<2> Cylinder2D; |
||||
|
||||
/** @brief Infinite three-dimensional cylinder */ |
||||
typedef Cylinder<3> Cylinder3D; |
||||
|
||||
/** @collisionoperator{Point,Cylinder} */ |
||||
template<UnsignedInt dimensions> inline bool operator%(const Point<dimensions>& a, const Cylinder<dimensions>& b) { return b % a; } |
||||
|
||||
/** @collisionoperator{Sphere,Cylinder} */ |
||||
template<UnsignedInt dimensions> inline bool operator%(const Sphere<dimensions>& a, const Cylinder<dimensions>& b) { return b % a; } |
||||
|
||||
}} |
||||
|
||||
#endif |
||||
@ -0,0 +1,85 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "Math/Matrix3.h" |
||||
#include "Math/Matrix4.h" |
||||
#include "Magnum.h" |
||||
#include "Shapes/Cylinder.h" |
||||
#include "Shapes/Point.h" |
||||
#include "Shapes/Sphere.h" |
||||
|
||||
#include "ShapeTestBase.h" |
||||
|
||||
namespace Magnum { namespace Shapes { namespace Test { |
||||
|
||||
class CylinderTest: public TestSuite::Tester { |
||||
public: |
||||
CylinderTest(); |
||||
|
||||
void transformed(); |
||||
void transformedAverageScaling(); |
||||
void collisionPoint(); |
||||
void collisionSphere(); |
||||
}; |
||||
|
||||
CylinderTest::CylinderTest() { |
||||
addTests({&CylinderTest::transformed, |
||||
&CylinderTest::collisionPoint, |
||||
&CylinderTest::collisionSphere}); |
||||
} |
||||
|
||||
void CylinderTest::transformed() { |
||||
const Shapes::Cylinder3D cylinder({1.0f, 2.0f, 3.0f}, {-1.0f, -2.0f, -3.0f}, 7.0f); |
||||
|
||||
const auto transformed = cylinder.transformed(Matrix4::scaling(Vector3(2.0f))*Matrix4::rotation(Deg(90.0f), Vector3::zAxis())); |
||||
CORRADE_COMPARE(transformed.a(), Vector3(-4.0f, 2.0f, 6.0f)); |
||||
CORRADE_COMPARE(transformed.b(), Vector3(4.0f, -2.0f, -6.0f)); |
||||
CORRADE_COMPARE(transformed.radius(), 14.0f); |
||||
} |
||||
|
||||
void CylinderTest::collisionPoint() { |
||||
Shapes::Cylinder3D cylinder({-1.0f, -1.0f, 0.0f}, {1.0f, 1.0f, 0.0f}, 2.0f); |
||||
Shapes::Point3D point({2.0f, 0.0f, 0.0f}); |
||||
Shapes::Point3D point1({1.0f, 3.1f, 0.0f}); |
||||
Shapes::Point3D point2({2.9f, -1.0f, 0.0f}); |
||||
|
||||
VERIFY_COLLIDES(cylinder, point); |
||||
VERIFY_COLLIDES(cylinder, point1); |
||||
VERIFY_NOT_COLLIDES(cylinder, point2); |
||||
} |
||||
|
||||
void CylinderTest::collisionSphere() { |
||||
Shapes::Cylinder3D cylinder({-1.0f, -1.0f, 0.0f}, {1.0f, 1.0f, 0.0f}, 2.0f); |
||||
Shapes::Sphere3D sphere({3.0f, 0.0f, 0.0f}, 0.9f); |
||||
Shapes::Sphere3D sphere1({1.0f, 4.1f, 0.0f}, 1.0f); |
||||
Shapes::Sphere3D sphere2({3.5f, -1.0f, 0.0f}, 0.6f); |
||||
|
||||
VERIFY_COLLIDES(cylinder, sphere); |
||||
VERIFY_COLLIDES(cylinder, sphere1); |
||||
VERIFY_NOT_COLLIDES(cylinder, sphere2); |
||||
} |
||||
|
||||
}}} |
||||
|
||||
CORRADE_TEST_MAIN(Magnum::Shapes::Test::CylinderTest) |
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in new issue