Audiokinetic

Wwise SDK 2018.1.11
 /*******************************************************************************

 The content of this file includes portions of the AUDIOKINETIC Wwise Technology

 released in source code form as part of the SDK installer package.

 Commercial License Usage

 Licensees holding valid commercial licenses to the AUDIOKINETIC Wwise Technology

 may use this file in accordance with the end user license agreement provided 

 with the software or, alternatively, in accordance with the terms contained in a

 written agreement between you and Audiokinetic Inc.

 Apache License Usage

 Alternatively, this file may be used under the Apache License, Version 2.0 (the 

 "Apache License"); you may not use this file except in compliance with the 

 Apache License. You may obtain a copy of the Apache License at 

 http://www.apache.org/licenses/LICENSE-2.0.

 Unless required by applicable law or agreed to in writing, software distributed

 under the Apache License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES

 OR CONDITIONS OF ANY KIND, either express or implied. See the Apache License for

 the specific language governing permissions and limitations under the License.

   Version: <VERSION>  Build: <BUILDNUMBER>

   Copyright (c) <COPYRIGHTYEAR> Audiokinetic Inc.

 *******************************************************************************/

 #ifndef _AK_BANKREADHELPERS_H_

 #define _AK_BANKREADHELPERS_H_

 /// Read data from bank and advance pointer.

 template< typename T > 

 inline T ReadBankData( 

                         AkUInt8*& in_rptr 

 #ifdef _DEBUG

                         ,AkUInt32& in_rSize

 #endif

                         )

 {

     T l_Value;

 #if defined(AK_IOS) || defined(AK_ANDROID) || defined(AK_LINUX) || defined(__EMSCRIPTEN__) || defined (AK_NX)

     typedef struct {T t;} __attribute__((__packed__)) packedStruct;

     l_Value = ((packedStruct *)in_rptr)->t;

 #else

     l_Value = *( ( T* )in_rptr );

 #endif

     in_rptr += sizeof( T );

 #ifdef _DEBUG

     in_rSize -= sizeof( T );

 #endif

     return l_Value;

 }

 template< typename T >

 inline T ReadVariableSizeBankData(

     AkUInt8*& in_rptr

 #ifdef _DEBUG

     , AkUInt32& in_rSize

 #endif

     )

 {

     AkUInt32 l_Value = 0;

     AkUInt8 currentByte = *in_rptr;

     ++in_rptr;

 #ifdef _DEBUG

     --in_rSize;

 #endif

     l_Value = (currentByte & 0x7F);

     while (0x80 & currentByte)

     {

         currentByte = *in_rptr;

         ++in_rptr;

 #ifdef _DEBUG

         --in_rSize;

 #endif

         l_Value = l_Value << 7;

         l_Value |= (currentByte & 0x7F);

     }

     return (T)l_Value;

 }

 inline char * ReadBankStringUtf8( 

                         AkUInt8*& in_rptr 

 #ifdef _DEBUG

                         ,AkUInt32& in_rSize

 #endif

                         ,AkUInt32& out_uStringSize )

 {

     out_uStringSize = ReadBankData<AkUInt32>( in_rptr 

 #ifdef _DEBUG

                         ,in_rSize

 #endif

                         );

     char * pString = 0;

     if ( out_uStringSize > 0 )

     {

         pString = reinterpret_cast<char*>( in_rptr );

         in_rptr += out_uStringSize;

 #ifdef _DEBUG

         in_rSize -= out_uStringSize;

 #endif

     }

     return pString;

 }

 /// Read unaligned memory, const version

 template< typename T >

 inline T ReadUnaligned( const AkUInt8* in_rptr, AkUInt32 in_bytesToSkip = 0 )

 {

 #ifdef _DEBUG

     AkUInt32 size = sizeof(T);

 #endif

     AkUInt8* ptr = const_cast<AkUInt8*>(in_rptr) + in_bytesToSkip;

     return ReadBankData<T>(ptr

 #ifdef _DEBUG

     , size

 #endif

     );

 }

 #ifdef __EMSCRIPTEN__

 /// Handle reading float not aligned on proper memory boundaries (banks are byte packed).

 inline AkReal64 AlignFloat(AkReal64* ptr)

 {

     AkReal64 LocalValue;

     // Forcing the char copy instead of the memcpy, as memcpy was optimized....

     char* pSource = (char*)ptr;

     char* pDest = (char*)&LocalValue;

     for( int i = 0; i < 8; ++i)

     {

         pDest[i] = pSource[i];

     }

     //memcpy( &LocalValue, ptr, sizeof( AkReal64 ) );

     return LocalValue;

 }

 /// Read data from bank and advance pointer.

 template<> 

 inline AkReal64 ReadBankData<AkReal64>( 

     AkUInt8*& in_rptr

 #ifdef _DEBUG

     ,AkUInt32& in_rSize

 #endif

     )

 {

     AkReal64 l_Value = AlignFloat( (AkReal64*)in_rptr );

     in_rptr += sizeof( AkReal64 );

 #ifdef _DEBUG

     in_rSize -= sizeof( AkReal64 );

 #endif

     return l_Value;

 }

 #endif

 #if (defined(AK_IOS) && defined(_DEBUG)) // bug with iOS SDK 4.3 in Debug only

 /// Type conversion helper on some platforms.

 template < typename TO, typename FROM >

 inline TO union_cast( FROM value )

 {

     union { FROM from; TO to; } convert;

     convert.from = value;

     return convert.to;

 }

 /// Handle reading float not aligned on proper memory boundaries (banks are byte packed).

 inline AkReal32 AlignFloat( AkReal32* ptr )

 {

     AkUInt32 *puint = reinterpret_cast<AkUInt32 *>( ptr );

     volatile AkUInt32 uint = *puint;

     return union_cast<AkReal32>( uint );

 }

 /// Read data from bank and advance pointer.

 template<> 

 inline AkReal32 ReadBankData<AkReal32>( 

                                        AkUInt8*& in_rptr

 #ifdef _DEBUG

                                        ,AkUInt32& in_rSize

 #endif

                                        )

 {

     AkReal32 l_Value = AlignFloat( ( AkReal32* )in_rptr );

     in_rptr += sizeof( AkReal32 );

 #ifdef _DEBUG

     in_rSize -= sizeof( AkReal32 );

 #endif

     return l_Value;

 }

 /// Handle reading float not aligned on proper memory boundaries (banks are byte packed).

 inline AkReal64 AlignFloat( AkReal64* ptr )

 {

     AkUInt64 *puint = reinterpret_cast<AkUInt64 *>( ptr );

     volatile AkUInt64 uint = *puint;

     return union_cast<AkReal64>( uint );

 }

 /// Read data from bank and advance pointer.

 template<> 

 inline AkReal64 ReadBankData<AkReal64>( 

                                        AkUInt8*& in_rptr

 #ifdef _DEBUG

                                        ,AkUInt32& in_rSize

 #endif

                                        )

 {

     AkReal64 l_Value = AlignFloat( ( AkReal64* )in_rptr );

     in_rptr += sizeof( AkReal64 );

 #ifdef _DEBUG

     in_rSize -= sizeof( AkReal64 );

 #endif

     return l_Value;

 }

 #endif

 #ifdef _DEBUG

 /// Read and return bank data of a given type, incrementing running pointer and decrementing block size for debug tracking purposes

 #define READBANKDATA( _Type, _Ptr, _Size )      \

         ReadBankData<_Type>( _Ptr, _Size )

 #define READVARIABLESIZEBANKDATA( _Type, _Ptr, _Size )      \

         ReadVariableSizeBankData<_Type>( _Ptr, _Size )

 /// Read and return non-null-terminatd UTF-8 string stored in bank, and its size.

 #define READBANKSTRING_UTF8( _Ptr, _Size, _out_StringSize )     \

         ReadBankStringUtf8( _Ptr, _Size, _out_StringSize )

 /// Read and return non-null-terminatd string stored in bank, and its size.

 #define READBANKSTRING( _Ptr, _Size, _out_StringSize )      \

         ReadBankStringUtf8( _Ptr, _Size, _out_StringSize ) //same as UTF-8 for now.

 /// Skip over some bank data  of a given type, incrementing running pointer and decrementing block size for debug tracking purposes

 #define SKIPBANKDATA( _Type, _Ptr, _Size )      \

         ( _Ptr ) += sizeof( _Type );    \

         ( _Size ) -= sizeof( _Type )

 /// Skip over some bank data by a given size in bytes, incrementing running pointer and decrementing block size for debug tracking purposes

 #define SKIPBANKBYTES( _NumBytes, _Ptr, _Size ) \

         ( _Ptr ) += _NumBytes;      \

         ( _Size ) -= _NumBytes

 #else

 /// Read and return bank data of a given type, incrementing running pointer and decrementing block size for debug tracking purposes

 #define READBANKDATA( _Type, _Ptr, _Size )      \

         ReadBankData<_Type>( _Ptr )

 #define READVARIABLESIZEBANKDATA( _Type, _Ptr, _Size )      \

         ReadVariableSizeBankData<_Type>( _Ptr )

 #define READBANKSTRING_UTF8( _Ptr, _Size, _out_StringSize )     \

         ReadBankStringUtf8( _Ptr, _out_StringSize )

 #define READBANKSTRING( _Ptr, _Size, _out_StringSize )      \

         ReadBankStringUtf8( _Ptr, _out_StringSize )

 /// Skip over some bank data  of a given type, incrementing running pointer and decrementing block size for debug tracking purposes

 #define SKIPBANKDATA( _Type, _Ptr, _Size )      \

         ( _Ptr ) += sizeof( _Type )

 /// Skip over some bank data by a given size in bytes, incrementing running pointer and decrementing block size for debug tracking purposes

 #define SKIPBANKBYTES( _NumBytes, _Ptr, _Size ) \

         ( _Ptr ) += _NumBytes;

 #endif

 #define GETBANKDATABIT( _Data, _Shift ) \

     (((_Data) >> (_Shift)) & 0x1)

 /// Helper macro to determine whether the full content of a block of memory was properly parsed

 #ifdef _DEBUG

     #define CHECKBANKDATASIZE( _DATASIZE_, _ERESULT_ ) AKASSERT( _DATASIZE_ == 0 || _ERESULT_ != AK_Success );

 #else

     #define CHECKBANKDATASIZE(_DATASIZE_, _ERESULT_ )

 #endif

 #endif //_AK_BANKREADHELPERS_H_
Cette page a-t-elle été utile ?

Besoin d'aide ?

Des questions ? Des problèmes ? Besoin de plus d'informations ? Contactez-nous, nous pouvons vous aider !
Visitez notre page d'Aide
Décrivez-nous de votre projet. Nous sommes là pour vous aider.

Enregistrez votre projet et nous vous aiderons à démarrer sans aucune obligation !
Partir du bon pied avec Wwise