_ak_error_message_translator_8h

Wwise SDK 2024.1.0

 /*******************************************************************************
 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.
  
   Copyright (c) 2024 Audiokinetic Inc.
 *******************************************************************************/
 #include <AK/SoundEngine/Common/AkSoundEngine.h>    // Sound engine
 #define AK_TRANSLATOR_MAX_NAME_SIZE 150
 #define AK_MAX_ERROR_LENGTH 1000
  
 // AkErrorMessageTranslator.h
 /// \file 
 /// Contains the interface for a message translator
 #pragma once
  
 class AkErrorMessageTranslator
 {
 public:
     AkErrorMessageTranslator() :
         m_isReadyForTranslation{ false },
         m_fallBackTranslator{ nullptr }
     {}
  
     /// ErrorMessageTranslator class destructor.
     virtual ~AkErrorMessageTranslator() {};
  
     /**
     Terminate the translator
     */
     virtual void Term() = 0;
  
     /**
     Sets the fallBackTranslator to the given fallback translator.
     The class that created the previously affected fallBackTranslator has
     the responsibilty to delete it.
     */
     void SetFallBackTranslator(AkErrorMessageTranslator* in_fallBackTranslator) { m_fallBackTranslator = in_fallBackTranslator; }
  
     /**
     Resolve names associated to the wwise tag(s) in the error message if possible
     @param[in]  in_pszError             The error message to translate
     @param[out] out_translatedPszError  The final result of the translation
     @param[in]  in_maxPszErrorSize      The maximum size of the translatedPszError and also the maximum size of the m_translationBuffer
     @param[in]  in_args                 The variable arguments used in the tranlsation
     @param[in]  in_uArgSize             The total size of variable arguments, in bytes
     @return     bool                    Whether or not the translation was successful
     */
     virtual bool Translate(const AkOSChar* in_pszError, AkOSChar* out_translatedPszError, AkInt32 in_maxPszErrorSize, char* in_args, AkUInt32 in_uArgSize);
  
 protected:
     struct TagInformation
     {
         const AkOSChar* m_pTag = nullptr;
         const AkOSChar* m_pStartBlock = nullptr;
         const char* m_args = nullptr;
         AkOSChar m_parsedInfo[AK_TRANSLATOR_MAX_NAME_SIZE] = { 0 };
         AkUInt32 m_argSize = 0;
         AkUInt16 m_len;
         bool m_infoIsParsed = false;
     };
  
     bool m_isReadyForTranslation;
     AkErrorMessageTranslator* m_fallBackTranslator;
  
     /**
     Copy the given string to the parsingInformation.
     @param[out]     out_parsedInfo          The modified translatedPszError
     @param[in]      in_maxSize              The maximum space in the parsedInfo buffer
     @param[in]      in_stringSize           The size of the string to print in the translatedPszError
     @param[in]      in_string               The string to print in the translatedPszError
     */
     void CharPrintResult(AkOSChar* out_parsedInfo, AkInt32 in_maxSize, AkInt32 in_stringSize, const char* in_string);
  
     /**
     A translator specific function to get some informations based on the given tag.
     If the information is found, modify the translatedPszError and position
     @param[in]      in_pTagList             The list of tag to parse
     @param[in]      in_uCount               The number of tags to parse.
     @param[out]     out_uTranslated         The number of tags already translated.
     @return         bool                    Whether or not all the tag were parsed
     */
     virtual bool GetInfo(TagInformation *in_pTagList, AkUInt32 in_uCount, AkUInt32& out_uTranslated) = 0;
 private:
     /**
     Extract all the tags from the pszError
     @param[in]  in_pszError             The error message to extract the tag from
     @param[in]  in_args                 The variable arguments used in the parsing
     @param[in]  in_uArgSize             The size of the arguments used in the parsing
     @param[out] out_tagList             The list of TagInformation with a standard tag
     @param[out] out_uCount              The number of tags in out_TagsList
     @param[out] out_uTranslated         The number of tags already translated in out_TagsList.
     @return     bool                    True if we need extra translation of the tags.
     */
     bool ExtractTags(const AkOSChar* in_pszError, char* in_args, AkUInt32 in_uArgSize, TagInformation* out_tagList, AkUInt32& out_uCount, AkUInt32& out_uTranslated);
 };

AkErrorMessageTranslator::TagInformation::m_pStartBlock

const AkOSChar * m_pStartBlock

Definition: AkErrorMessageTranslator.h:61

AkErrorMessageTranslator::Translate

virtual bool Translate(const AkOSChar *in_pszError, AkOSChar *out_translatedPszError, AkInt32 in_maxPszErrorSize, char *in_args, AkUInt32 in_uArgSize)

AkErrorMessageTranslator::GetInfo

virtual bool GetInfo(TagInformation *in_pTagList, AkUInt32 in_uCount, AkUInt32 &out_uTranslated)=0

AkUInt16

uint16_t AkUInt16

Unsigned 16-bit integer

Definition: AkNumeralTypes.h:37

AkSoundEngine.h

AkErrorMessageTranslator::TagInformation::m_len

AkUInt16 m_len

Definition: AkErrorMessageTranslator.h:65

AkErrorMessageTranslator

Definition: AkErrorMessageTranslator.h:24