-
Notifications
You must be signed in to change notification settings - Fork 407
IEffectMatrices
DirectXTK | Effects |
---|
This abstract interface allows setting rendering matrices. This interface is implemented by all built-in effects, but is not required for all effects (i.e. a valid effect can implement IEffect and not implement IEffectMatrices).
There are two methods used in DirectX Tool Kit. For simple cases, just maintain a reference directly to the desired effect class:
std::shared_ptr<BasicEffect> effect;
...
effect->SetWorld( world );
effect->SetView( view );
effect->SetProjection( projection );
If you are setting all three matrices at once, you can use:
effect->SetMatrices(world, view, projection);
For more general cases where a number of effect classes can be in use (such as Model which uses a mix of BasicEffect, DualTextureEffect, and/or SkinnedEffect), use Run-Time Type Information (RTTI) to obtain the interface.
std::shared_ptr<IEffect> effect;
...
auto imatrices = dynamic_cast<IEffectMatrices*>( effect.get() );
if ( imatrices )
{
imatrices->SetMatrices( world, view, projection );
}
For the specific case of IEffectMatrices, you could try to make the assumption that all effects in use implement IEffectMatrices and make use of a
reinterpret_cast<>
or old-school C-style cast instead ofdynamic_cast<>
, however this will not work sinceIEffectMatrices
is not derived fromIEffect
. You would have to assume a specific class of effect instead.
The matrices used by effects can be left-handed or right-handed coordinates, but are always in row-major form.
As an optimization, most shaders actually consume matrices in column-major form, so effects implementations will transpose them as needed when setting them into the constant buffer.
The effects implementations will lazily update various computations (such as inverses and concatenations of matrices), so that changing only one of the three matrices can be less computationally expensive than changing all three.
Most BasicEffect shaders make no particular distinction between the view, and projection matrices. You can, for example, provide the combined view*projection
matrix with SetProjection and leave the others identity with the same results.
The BasicEffect shaders require the world matrix to be distinct from the view and projection matrices for doing proper transforms of normals into world coordinates.
All content and source code for this package are subject to the terms of the MIT License.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
- Universal Windows Platform apps
- Windows desktop apps
- Windows 11
- Windows 10
- Xbox One
- Xbox Series X|S
- x86
- x64
- ARM64
- Visual Studio 2022
- Visual Studio 2019 (16.11)
- clang/LLVM v12 - v18
- MinGW 12.2, 13.2
- CMake 3.20