_i_source_control_utilities_8h

Wwise SDK 2025.1.4

 /*******************************************************************************
 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.
  
   Copyright (c) 2025 Audiokinetic Inc.
 *******************************************************************************/
  
 /// \file
 /// Wwise source control plug-in utilities interface, used to create custom dialogs, display the progress dialog, and get
 /// the registry path needed to save the plug-in configuration.
  
 #ifndef _AK_WWISE_ISOURCECONTROLUTILITIES_H
 #define _AK_WWISE_ISOURCECONTROLUTILITIES_H
  
 #include AK/SoundEngine/Common/AkTypes.h>
  
 #include "ISourceControlDialogBase.h"
 #include "ISourceControlProgress.h"
  
 // Audiokinetic namespace
 namespace AK
 {
     // Audiokinetic Wwise namespace
     namespace Wwise
     {
         /// Wwise source control utilities interface. This interface is provided when the plug-in is initialized.
         /// With this interface, you can display a progress dialog, create custom dialogs, display message boxes, and
         /// save the plug-in configuration to the registry.
         class ISourceControlUtilities
         {
         public:
             /// Get a pointer to an AK::Wwise::ISourceControlProgress interface, so you can display a simple progress dialog for the operation.
             /// \warning This function is not thread-safe.
             /// \return A pointer to an AK::Wwise::ISourceControlOperationProgress interface.
             virtual ISourceControlProgress* GetProgress() = 0;
  
             /// This function does the same thing as the standard \c MessageBox function, except that this one will
             /// be displayed with the Wwise UI look and feel.
             /// \warning This function is not thread-safe.
             /// \return The window results of the dialog
             virtual int MessageBox(
                 HWND in_hWnd,                   ///
                 LPCWSTR in_pszText,             ///
                 LPCWSTR in_pszCaption,          ///
                 UINT in_uiType                  ///
                 ) = 0;
  
             /// This function show a dialog with a edit field and allow the user enter input string
             /// \warning This function is not thread-safe.
             /// \return The window results of the dialog: IDOK or IDCANCEL
             virtual int PromptMessage(
                 HWND in_hWnd,                   ///
                 LPCWSTR in_pszText,             ///
                 LPCWSTR in_pszCaption,          ///
                 LPWSTR out_pszInput,            ///
                 UINT in_uiInputSize,            ///
                 bool in_bIsPassword             ///
                 ) = 0;
  
             /// Show a browse for folder dialog.
             /// \warning This function is not thread-safe.
             /// \return The resulting path is set in out_pszChoosenPath
             /// \return True if user clicked OK, false if user clicked Cancel
             virtual bool ShowBrowseForFolderDialog(
                 LPCWSTR in_pszDialogTitle,          ///
                 LPWSTR out_pszChoosenPath,          ///
                 UINT in_uiChoosenPathSize,          ///
                 LPCWSTR in_pszRootPath = NULL       ///
                 ) = 0;
  
             /// This function does the same thing as the CDialog::DoModal function.
             /// \warning This function is not thread-safe.
             /// \return The window results of the dialog (e.g. IDOK)
             virtual INT_PTR CreateModalCustomDialog( 
                 ISourceControlDialogBase* in_pDialog    ///
                                                         ///
                 ) = 0;
  
             /// Set DWORD value in user preferences.
             /// \warning This function is not thread-safe.
             virtual void SetUserPreferenceDword(
                 LPCWSTR in_pszPreference,       ///
                 DWORD in_dwValue                ///
                 ) = 0;
  
             /// Get DWORD value in user preferences.
             /// \warning This function is not thread-safe.
             virtual void GetUserPreferenceDword(
                 LPCWSTR in_pszPreference,       ///
                 DWORD& io_dwValue               ///
                 ) = 0;
  
             /// Set string value in user preferences.
             /// \warning This function is not thread-safe.
             virtual void SetUserPreferenceString(
                 LPCWSTR in_pszPreference,       ///
                 LPCWSTR in_pszValue             ///
                 ) = 0;
  
             /// Get string value from user preferences.
             /// \warning This function is not thread-safe.
             virtual void GetUserPreferenceString(
                 LPCWSTR in_pszPreference,       ///
                 LPWSTR io_pszValue,             ///
                 DWORD in_dwSize                 ///
                 ) = 0;
  
             /// Get the root path for a move operation.
             /// The input file can either be a work unit or a source file
             /// \warning This function is not thread-safe.
             /// \return Nothing as return value.  The out_pszRootPath will contain the path.
             virtual void GetMoveRootPath(
                 LPCWSTR in_pszFullPath,         ///
                 LPWSTR out_pszRootPath,         ///
                 UINT in_uiRootPathSize          ///
                 ) = 0;
  
             /// Create a AK style list control with 3 columns:
             /// - Filename
             /// - Status
             /// - Owner
             /// You must create a static control in the resources delimitating the region of the list control and
             /// pass the control ID of it.
             /// \note DestroyFileStatusListControl must be called when handling WM_DESTROY in WindowProc
             /// \warning This function is not thread-safe.
             virtual void CreateFileStatusListControl(
                 HWND in_hWndParent,                 ///
                 UINT in_idStatic,                   ///
                 const WCHAR** in_ppFilenameList,    ///
                 unsigned int in_uiFilenameListCount ///
                 ) = 0;
  
             /// Retrieve if the current operation was marked as to be cancelled.
             /// \return True if the user requested to cancel the current operation.
             virtual bool IsCancelRequested() const = 0;
  
             /// Log a message into the Source Control channel
             /// \note This message will be visible to users in the Log view
             virtual void LogMessage(LPCWSTR in_pszMessage) = 0;
         };
     }
 }
  
 #endif // _AK_WWISE_ISOURCECONTROLUTILITIES_H

Definition of data structures for AkAudioObject.

Definition: AkWwiseSDKVersion.cs:31

ISourceControlProgress.h

AK.Wwise::ISourceControlProgress

Definition: ISourceControlProgress.h:49

AK.Wwise::ISourceControlUtilities::ShowBrowseForFolderDialog

virtual bool ShowBrowseForFolderDialog(LPCWSTR in_pszDialogTitle, LPWSTR out_pszChoosenPath, UINT in_uiChoosenPathSize, LPCWSTR in_pszRootPath=NULL)=0

AK.Wwise::ISourceControlUtilities::GetMoveRootPath

virtual void GetMoveRootPath(LPCWSTR in_pszFullPath, LPWSTR out_pszRootPath, UINT in_uiRootPathSize)=0

AK.Wwise::ISourceControlUtilities::PromptMessage

virtual int PromptMessage(HWND in_hWnd, LPCWSTR in_pszText, LPCWSTR in_pszCaption, LPWSTR out_pszInput, UINT in_uiInputSize, bool in_bIsPassword)=0

AK.Wwise::ISourceControlUtilities::CreateFileStatusListControl

virtual void CreateFileStatusListControl(HWND in_hWndParent, UINT in_idStatic, const WCHAR **in_ppFilenameList, unsigned int in_uiFilenameListCount)=0

AK.Wwise::ISourceControlUtilities::SetUserPreferenceDword

virtual void SetUserPreferenceDword(LPCWSTR in_pszPreference, DWORD in_dwValue)=0

AK.Wwise::ISourceControlDialogBase

Definition: ISourceControlDialogBase.h:49

AK.Wwise::ISourceControlUtilities

Definition: ISourceControlUtilities.h:49

AK.Wwise::ISourceControlUtilities::GetUserPreferenceDword

virtual void GetUserPreferenceDword(LPCWSTR in_pszPreference, DWORD &io_dwValue)=0

AK.Wwise::ISourceControlUtilities::GetProgress

virtual ISourceControlProgress * GetProgress()=0

AK.Wwise::ISourceControlUtilities::GetUserPreferenceString

virtual void GetUserPreferenceString(LPCWSTR in_pszPreference, LPWSTR io_pszValue, DWORD in_dwSize)=0