_host_object_media_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.
  
 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) 2024 Audiokinetic Inc.
 *******************************************************************************/
  
 /**
  * \brief Wwise Authoring Plug-ins - API for retrieving and handling data files, as used in the plug-in.
  * \file AK/Wwise/Plugin/HostObjectMedia.h
  */
  
 #pragma once
  
 #include "PluginInfoGenerator.h"
  
 #include <AK/SoundEngine/Common/AkTypes.h>
  
 /**
  * Plug-in object media interface. Can be used to normalize media file handling inside the project.
  */
 struct ak_wwise_plugin_host_object_media_v1
 #ifdef __cplusplus
     : public ak_wwise_plugin_base_interface
 #endif
 {
 #ifndef __cplusplus
     ak_wwise_plugin_base_interface m_baseInterface;
 #endif
  
 #ifdef __cplusplus
     /// Base host-provided instance type for ak_wwise_plugin_host_object_media_v1.
     using Instance = ak_wwise_plugin_host_object_media_instance_v1;
  
     ak_wwise_plugin_host_object_media_v1() :
         ak_wwise_plugin_base_interface(AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_OBJECT_MEDIA, 1)
     {}
 #endif
  
     /**
      * \brief Requests to set the specified file as a data input file.
      * 
      * This will copy the file in the project under the file name specified in in_pszFilePathToImport, and
      * create or replace a Media Source at the given index.
      * 
      * \aknote
      *      You must add up indexes sequentially. If you have 0-14 indexes, adding a new one at 40 will create it at 15.
      *      If you want to have empty spaces for indexes, add empty media sources with a nullptr in_pszFilePathToImport
      *      sequentially. Pass <code>(unsigned int)-1</code> as the in_Index to insert at the end of the list.
      * \endaknote
      * 
      * \akwarning
      *      You should not put the same file in two different indexes.
      * \endakwarning
      * 
      * \param[in] in_this Current instance of this interface.
      * \param[in] in_pszFilePathToImport (Optional) File path. Can be nullptr if the plug-in generates this file, or
      *            if the file is not yet available.
      * \param[in] in_Index Media source index. If higher than or equal to the current media source count, will
      *            add a new index.
      * \param[in] in_bReplace True to replace a file under the same name. False will succeed if the file already exists.
      * \return true if succeeded.
      */
     bool(*SetMediaSource)(
         struct ak_wwise_plugin_host_object_media_instance_v1* in_this,
         const AkOSChar * in_pszFilePathToImport,
         unsigned int in_Index,
         bool in_bReplace
     );
  
     /**
      * \brief Requests to remove the specified index file as data input file.
      * 
      * This will not renumber the supplemental index, it will merely remove the file from that index, if existing.
      * 
      * \param[in] in_this Current instance of this interface.
      * \param[in] in_Index Media source index to remove.
      */
     void(*RemoveMediaSource)(
         struct ak_wwise_plugin_host_object_media_instance_v1* in_this,
         unsigned int in_Index
     );
  
     /**
      * \brief Retrieve the number of media source indexes.
      * 
      * \param[in] in_this Current instance of this interface.
      * \return Count of media sources.
      */
     unsigned int(*GetMediaSourceCount)(
         const struct ak_wwise_plugin_host_object_media_instance_v1* in_this
     );
  
     /**
      * \brief Retrieve the file name of the source plug-in data at the specified index, as provided in SetMediaSource.
      * 
      * Used to allow the plug-in to display this information. This is the file name, and doesn't include any path.
      * 
      * \akwarning
      *      If you do not provide a buffer big enough to write the full string, the function will fail and return
      *      0. Make sure to use a buffer big enough to write the entire string, such as your platform's
      *      max path size.
      * \endakwarning
      * 
      * \param[in] in_this Current instance of this interface.
      * \param[out] out_pszFileName Buffer that will contain the file name.
      * \param[in] in_uiBufferSize Size of the provided string buffer.
      * \param[in] in_Index Media source index to query.
      * \return Number of characters written to the buffer. 0 means no file, or failure.
      */
     unsigned int(*GetMediaSourceFileName)(
         const struct ak_wwise_plugin_host_object_media_instance_v1* in_this,
         AkOSChar * out_pszFileName,
         unsigned int in_uiBufferSize,
         unsigned int in_Index
     );
  
     /**
      * \brief Retrieve the full file path of the source plug-in data at the specified index.
      * 
      * This is the path name of the data file, as kept in the project directory.
      * 
      * \akwarning
      *      If you do not provide a buffer big enough to write the full string, the function will fail and return
      *      0. Make sure to use a buffer big enough to write the entire string, such as your platform's
      *      max path size.
      * \endakwarning
      * 
      * \param[in] in_this Current instance of this interface.
      * \param[out] out_pszFilePath Buffer that will contain the original file path.
      * \param[in] in_uiBufferSize Size of the provided string buffer.
      * \param[in] in_Index Media source index to query.
      * \return Number of characters written to the buffer. 0 means no file, or failure.
      */
     unsigned int(*GetMediaSourceOriginalFilePath)(
         const struct ak_wwise_plugin_host_object_media_instance_v1* in_this,
         AkOSChar * out_pszFilePath,
         unsigned int in_uiBufferSize,
         unsigned int in_Index
     );
  
     /**
      * \brief Retrieve the full file path of the converted plug-in data at the specified index.
      * 
      * \akwarning
      *      If you do not provide a buffer big enough to write the full string, the function will fail and return
      *      0. Make sure to use a buffer big enough to write the entire string, such as your platform's
      *      max path size.
      * \endakwarning
      * 
      * \param[in] in_this Current instance of this interface.
      * \param[out] out_pszFilePath Buffer that will contain the converted file path.
      * \param[in] in_uiBufferSize Size of the provided string buffer.
      * \param[in] in_guidPlatform GUID of the platform to query.
      * \param[in] in_Index Media source index to query.
      * \return Number of characters written to the buffer. 0 means no file, or failure.
      */
     unsigned int(*GetMediaSourceConvertedFilePath)(
         const struct ak_wwise_plugin_host_object_media_instance_v1* in_this,
         AkOSChar * out_pszFilePath,
         unsigned int in_uiBufferSize,
         const GUID* in_guidPlatform,
         unsigned int in_Index
     );
  
     /**
      * \brief Request Wwise to perform any required conversion on the data.
      *
      * \sa
      * - \ref AK::Wwise::Plugin::MediaConverter.
      * 
      * \param[in] in_this Current instance of this interface.
      * \param[in] in_Index Media source index to invalidate.
      */
     void(*InvalidateMediaSource)(
         struct ak_wwise_plugin_host_object_media_instance_v1* in_this,
         unsigned int in_Index
     );
  
     /**
      * \brief Obtain the Original directory for the plug-in.
      * 
      * \akwarning
      *      If you do not provide a buffer big enough to write the full string, the function will fail and return
      *      0. Make sure to use a buffer big enough to write the entire string, such as your platform's
      *      max path size.
      * \endakwarning
      * 
      * \param[in] in_this Current instance of this interface.
      * \param[out] out_pszDirectory Buffer that will contain the path.
      * \param[in] in_uiBufferSize Size of the provided string buffer.
      * \return Number of characters written to the buffer. 0 means a failure.
      */
     unsigned int(*GetOriginalDirectory)(
         const struct ak_wwise_plugin_host_object_media_instance_v1* in_this,
         AkOSChar * out_pszDirectory,
         unsigned int in_uiBufferSize
     );
  
     /**
      * \brief Obtain the Converted directory for the plug-in and platform.
      * 
      * \akwarning
      *      If you do not provide a buffer big enough to write the full string, the function will fail and return
      *      0. Make sure to use a buffer big enough to write the entire string, such as your platform's
      *      max path size.
      * \endakwarning
      * 
      * \param[in] in_this Current instance of this interface.
      * \param[out] out_pszDirectory Buffer that will contain the path.
      * \param[in] in_uiBufferSize Size of the provided string buffer.
      * \param[in] in_guidPlatform GUID of the platform to query.
      * \return Number of characters written to the buffer. 0 means a failure.
      */
     unsigned int(*GetConvertedDirectory)(
         const struct ak_wwise_plugin_host_object_media_instance_v1* in_this,
         AkOSChar * out_pszDirectory,
         unsigned int in_uiBufferSize,
         const GUID* in_guidPlatform
     );
 };
  
  
 struct ak_wwise_plugin_notifications_object_media_v1
 #ifdef __cplusplus
     : public ak_wwise_plugin_base_interface
 #endif
 {
 #ifndef __cplusplus
     ak_wwise_plugin_base_interface m_baseInterface;
 #endif
  
 #ifdef __cplusplus
     /// Base instance type for receiving notifications on related object media's changes.
     using Instance = ak_wwise_plugin_notifications_object_media_instance_v1;
  
     ak_wwise_plugin_notifications_object_media_v1() :
         ak_wwise_plugin_base_interface(AK_WWISE_PLUGIN_INTERFACE_TYPE_NOTIFICATIONS_OBJECT_MEDIA, 1)
     {}
 #endif
  
     /**
      * \brief This function is called by Wwise when any of the plug-in media changes.
      * 
      * It is called when plugin media is added, removed or changes. This function is also called during undo or redo operations.
      * 
      * \sa
      * - \ref effectplugin_media_managing
      * 
      * \param[in] in_this Current instance of this interface.
      */
     void(*NotifyPluginMediaChanged)(struct ak_wwise_plugin_notifications_object_media_instance_v1* in_this);
 };
  
  
 #define AK_WWISE_PLUGIN_HOST_OBJECT_MEDIA_V1_ID() \
     AK_WWISE_PLUGIN_BASE_INTERFACE_FROM_ID(AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_OBJECT_MEDIA, 1)
 #define AK_WWISE_PLUGIN_HOST_OBJECT_MEDIA_V1_CTOR() \
 { \
     .m_baseInterface = AK_WWISE_PLUGIN_HOST_OBJECT_MEDIA_V1_ID() \
 }
  
 #define AK_WWISE_PLUGIN_NOTIFICATIONS_OBJECT_MEDIA_V1_ID() \
     AK_WWISE_PLUGIN_BASE_INTERFACE_FROM_ID(AK_WWISE_PLUGIN_INTERFACE_TYPE_NOTIFICATIONS_OBJECT_MEDIA, 1)
 #define AK_WWISE_PLUGIN_NOTIFICATIONS_OBJECT_MEDIA_V1_CTOR(/* ak_wwise_plugin_info* */ in_pluginInfo, /* void* */ in_data) \
 { \
     .m_baseInterface = AK_WWISE_PLUGIN_BASE_INTERFACE_CTOR(AK_WWISE_PLUGIN_NOTIFICATIONS_OBJECT_MEDIA_V1_ID(), in_pluginInfo, in_data) \
 }
  
  
 #ifdef __cplusplus
 namespace AK::Wwise::Plugin
 {
     namespace V1
     {
         using CHostObjectMedia = ak_wwise_plugin_host_object_media_v1;
  
         /// \copydoc ak_wwise_plugin_host_object_media_v1
         class ObjectMedia : public CBaseInstanceGlue<CHostObjectMedia>
         {
         public:
             using Interface = CHostObjectMedia;
  
             /**
              * \brief The interface type, as requested by this plug-in.
              */
             enum : InterfaceTypeValue
             {
                 /**
                  * \brief The interface type, as requested by this plug-in.
                  */
                 k_interfaceType = AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_OBJECT_MEDIA
             };
             /**
              * \brief The interface version, as requested by this plug-in.
              */
             enum : InterfaceVersion
             {
                 /**
                  * \brief The interface version, as requested by this plug-in.
                  */
                 k_interfaceVersion = 1
             };
  
             /**
              * \brief Requests to set the specified file as a data input file.
              * 
              * This will copy the file in the project under the file name specified in in_pszFilePathToImport, and
              * create or replace a Media Source at the given index.
              * 
              * \aknote
              *      You must add up indexes sequentially. If you have 0-14 indexes, adding a new one at 40 will create it at 15.
              *      If you want to have empty spaces for indexes, add empty media sources with a nullptr in_pszFilePathToImport
              *      sequentially. Pass <code>(unsigned int)-1</code> as the in_Index to insert at the end of the list.
              * \endaknote
              * 
              * \akwarning
              *      You should not put the same file in two different indexes.
              * \endakwarning
              * 
              * \param[in] in_pszFilePathToImport (Optional) File path. Can be nullptr if the plug-in generates this file, or
              *            if the file is not yet available.
              * \param[in] in_Index Media source index. If higher than or equal to the current media source count, will
              *            add a new index.
              * \param[in] in_bReplace True to replace a file under the same name. False will succeed if the file already exists.
              * \return true if succeeded.
              */
             inline bool SetMediaSource(
                 const AkOSChar * in_pszFilePathToImport,
                 unsigned int in_Index,
                 bool in_bReplace
             )
             {
                 return MKBOOL(g_cinterface->SetMediaSource(this, in_pszFilePathToImport, in_Index, in_bReplace));
             }
  
             /**
              * \brief Requests to remove the specified index file as data input file.
              * 
              * This will not renumber the supplemental index, it will merely remove the file from that index, if existing.
              * 
              * \param[in] in_Index Media source index to remove.
              */
             inline void RemoveMediaSource(
                 unsigned int in_Index
             )
             {
                 g_cinterface->RemoveMediaSource(this, in_Index);
             }
  
             /**
              * \brief Retrieve the number of media source indexes.
              * 
              * \return Count of media sources.
              */
             inline unsigned int GetMediaSourceCount() const
             {
                 return g_cinterface->GetMediaSourceCount(this);
             }
  
             /**
              * \brief Retrieve the file name of the source plug-in data at the specified index, as provided in SetMediaSource.
              * 
              * Used to allow the plug-in to display this information. This is the file name, and doesn't include any path.
              * 
              * \akwarning
              *      If you do not provide a buffer big enough to write the full string, the function will fail and return
              *      0. Make sure to use a buffer big enough to write the entire string, such as your platform's
              *      max path size.
              * \endakwarning
              * 
              * \param[out] out_pszFileName Buffer that will contain the file name.
              * \param[in] in_uiBufferSize Size of the provided string buffer.
              * \param[in] in_Index Media source index to query.
              * \return Number of characters written to the buffer. 0 means no file, or failure.
              */
             inline unsigned int GetMediaSourceFileName(
                 AkOSChar * out_pszFileName,
                 unsigned int in_uiBufferSize,
                 unsigned int in_Index
             ) const
             {
                 return g_cinterface->GetMediaSourceFileName(this, out_pszFileName, in_uiBufferSize, in_Index);
             }
  
             /**
              * \brief Retrieve the full file path of the source plug-in data at the specified index.
              * 
              * This is the path name of the data file, as kept in the project directory.
              * 
              * \akwarning
              *      If you do not provide a buffer big enough to write the full string, the function will fail and return
              *      0. Make sure to use a buffer big enough to write the entire string, such as your platform's
              *      max path size.
              * \endakwarning
              * 
              * \param[out] out_pszFilePath Buffer that will contain the original file path.
              * \param[in] in_uiBufferSize Size of the provided string buffer.
              * \param[in] in_Index Media source index to query.
              * \return Number of characters written to the buffer. 0 means no file, or failure.
              */
             inline unsigned int GetMediaSourceOriginalFilePath(
                 AkOSChar * out_pszFilePath,
                 unsigned int in_uiBufferSize,
                 unsigned int in_Index
             ) const
             {
                 return g_cinterface->GetMediaSourceOriginalFilePath(this, out_pszFilePath, in_uiBufferSize, in_Index);
             }
  
             /**
              * \brief Retrieve the full file path of the converted plug-in data at the specified index.
              * 
              * \akwarning
              *      If you do not provide a buffer big enough to write the full string, the function will fail and return
              *      0. Make sure to use a buffer big enough to write the entire string, such as your platform's
              *      max path size.
              * \endakwarning
              * 
              * \param[out] out_pszFilePath Buffer that will contain the converted file path.
              * \param[in] in_uiBufferSize Size of the provided string buffer.
              * \param[in] in_guidPlatform GUID of the platform to query.
              * \param[in] in_Index Media source index to query.
              * \return Number of characters written to the buffer. 0 means no file, or failure.
              */
             inline unsigned int GetMediaSourceConvertedFilePath(
                 AkOSChar * out_pszFilePath,
                 unsigned int in_uiBufferSize,
                 const GUID& in_guidPlatform,
                 unsigned int in_Index
             ) const
             {
                 return g_cinterface->GetMediaSourceConvertedFilePath(this, out_pszFilePath, in_uiBufferSize, &in_guidPlatform, in_Index);
             }
  
             /**
              * \brief Request Wwise to perform any required conversion on the data.
              * 
              * \sa
              * - \ref AK::Wwise::Plugin::MediaConverter.
              * 
              * \param[in] in_Index Media source index to invalidate.
              */
             inline void InvalidateMediaSource(
                 unsigned int in_Index
             )
             {
                 return g_cinterface->InvalidateMediaSource(this, in_Index);
             }
  
             /**
              * \brief Obtain the Original directory for the plug-in.
              * 
              * \akwarning
              *      If you do not provide a buffer big enough to write the full string, the function will fail and return
              *      0. Make sure to use a buffer big enough to write the entire string, such as your platform's
              *      max path size.
              * \endakwarning
              * 
              * \param[out] out_pszDirectory Buffer that will contain the path.
              * \param[in] in_uiBufferSize Size of the provided string buffer.
              * \return Number of characters written to the buffer. 0 means a failure.
              */
             inline unsigned int GetOriginalDirectory(
                 AkOSChar * out_pszDirectory,
                 unsigned int in_uiBufferSize
             ) const
             {
                 return g_cinterface->GetOriginalDirectory(this, out_pszDirectory, in_uiBufferSize);
             }
  
             /**
              * \brief Obtain the Converted directory for the plug-in and platform.
              * 
              * \akwarning
              *      If you do not provide a buffer big enough to write the full string, the function will fail and return
              *      0. Make sure to use a buffer big enough to write the entire string, such as your platform's
              *      max path size.
              * \endakwarning
              * 
              * \param[out] out_pszDirectory Buffer that will contain the path.
              * \param[in] in_uiBufferSize Size of the provided string buffer.
              * \param[in] in_guidPlatform GUID of the platform to query.
              * \return Number of characters written to the buffer. 0 means a failure.
              */
             inline unsigned int GetConvertedDirectory(
                 AkOSChar * out_pszDirectory,
                 unsigned int in_uiBufferSize,
                 const GUID& in_guidPlatform
             ) const
             {
                 return g_cinterface->GetConvertedDirectory(this, out_pszDirectory, in_uiBufferSize, &in_guidPlatform);
             }
         };
  
         namespace Notifications
         {
             using CObjectMedia_ = ak_wwise_plugin_notifications_object_media_v1;
  
             /// \copydoc ak_wwise_plugin_notifications_object_media_v1
             class ObjectMedia_ : public CObjectMedia_::Instance
             {
             public:
                 /**
                  * \copydoc CObjectMedia_::Instance
                  */
                 using Instance = CObjectMedia_::Instance;
  
                 /**
                  * \brief The interface type, as provided by this plug-in.
                  */
                 enum : InterfaceTypeValue
                 {
                     /**
                      * \brief The interface type, as provided by this plug-in.
                      */
                     k_interfaceType = AK_WWISE_PLUGIN_INTERFACE_TYPE_NOTIFICATIONS_OBJECT_MEDIA
                 };
                 /**
                  * \brief The interface version, as provided by this plug-in.
                  */
                 enum : InterfaceVersion
                 {
                     /**
                      * \brief The interface version, as provided by this plug-in.
                      */
                     k_interfaceVersion = 1
                 };
  
                 /**
                  * \brief The C interface, fulfilled by your plug-in.
                  */
                 struct Interface : public CObjectMedia_
                 {
                     using Instance = ObjectMedia_;
                     Interface()
                     {
                         CObjectMedia_::NotifyPluginMediaChanged = [](
                             struct ak_wwise_plugin_notifications_object_media_instance_v1* in_this)
                         {
                             static_cast<Instance*>(in_this)->NotifyPluginMediaChanged();
                         };
                     }
                 };
  
                 InterfacePtr GetInterfacePointer() {
                     static Interface g_interface;
                     return &g_interface;
                 }
                 CObjectMedia_::Instance* GetInstancePointer() {
                     return this;
                 }
                 const CObjectMedia_::Instance* GetInstancePointer() const {
                     return this;
                 }
  
                 ObjectMedia_() :
                     CObjectMedia_::Instance()
                 {
                 }
  
                 virtual ~ObjectMedia_() {}
  
                 /**
                  * \brief This function is called by Wwise when any of the plug-in media changes.
                  *
                  * It is called when plugin media is added, removed or changes. This function is also called during undo or redo operations.
                  *
                  * \sa
                  * - \ref effectplugin_media_managing
                  */
                 virtual void NotifyPluginMediaChanged() {}
             };
         } // of namespace Notifications
  
         /**
          * \brief Requests a ObjectMedia interface, provided as m_objectMedia variable.
          * 
          * Deriving your plug-in class from RequestObjectMedia will automatically request both ObjectMedia and
          * Notifications::ObjectMedia_ interfaces. From this point, you will be able to derive from the virtual
          * functions as defined in Notifications::ObjectMedia_, and access the host-provided functions in the
          * \c m_objectMedia variable.
          */
         using RequestObjectMedia = RequestedHostInterface<ObjectMedia>;
  
     } // of namespace V1
  
     /// Latest version of the C ObjectMedia interface.
     using CHostObjectMedia = V1::CHostObjectMedia;
     /// Latest version of the C++ ObjectMedia interface.
     using ObjectMedia = V1::ObjectMedia;
     /// Latest version of the requested C++ ObjectMedia interface.
     using RequestObjectMedia = V1::RequestObjectMedia;
  
     namespace Notifications
     {
         /// Latest version of the C ObjectMedia notification interface.
         using CObjectMedia = V1::Notifications::CObjectMedia_;
         /// Latest version of the C++ ObjectMedia notification interface.
         using ObjectMedia = V1::Notifications::ObjectMedia_;
     }
  
     AK_WWISE_PLUGIN_SPECIALIZE_HOST_INTERFACE(ObjectMedia, objectMedia,, public Notifications::ObjectMedia);
     AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_CLASS(ObjectMedia);
     AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION(ObjectMedia);
     AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_CLASS(Notifications::ObjectMedia);
     AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION(Notifications::ObjectMedia);
 } // of namespace AK::Wwise::Plugin
  
 #endif

ak_wwise_plugin_host_object_media_v1::ak_wwise_plugin_host_object_media_v1

ak_wwise_plugin_host_object_media_v1()

Definition: HostObjectMedia.h:54

AK.Wwise::Plugin::V1::ObjectMedia::RemoveMediaSource

void RemoveMediaSource(unsigned int in_Index)

Requests to remove the specified index file as data input file.

Definition: HostObjectMedia.h:363

AK.Wwise::Plugin::V1::Notifications::ObjectMedia_::Interface

The C interface, fulfilled by your plug-in.

Definition: HostObjectMedia.h:553

AK.Wwise::Plugin::V1::ObjectMedia::GetMediaSourceConvertedFilePath

unsigned int GetMediaSourceConvertedFilePath(AkOSChar *out_pszFilePath, unsigned int in_uiBufferSize, const GUID &in_guidPlatform, unsigned int in_Index) const

Retrieve the full file path of the converted plug-in data at the specified index.

Definition: HostObjectMedia.h:445

AK.Wwise::Plugin::V1::Notifications::ObjectMedia_::k_interfaceVersion

@ k_interfaceVersion

The interface version, as provided by this plug-in.

Definition: HostObjectMedia.h:546

AK.Wwise::Plugin::V1::Notifications::ObjectMedia_::GetInterfacePointer

InterfacePtr GetInterfacePointer()

Definition: HostObjectMedia.h:565

ak_wwise_plugin_notifications_object_media_v1::NotifyPluginMediaChanged

void(* NotifyPluginMediaChanged)(struct ak_wwise_plugin_notifications_object_media_instance_v1 *in_this)

This function is called by Wwise when any of the plug-in media changes.

Definition: HostObjectMedia.h:271

AK.Wwise::Plugin::V1::ObjectMedia::GetConvertedDirectory

unsigned int GetConvertedDirectory(AkOSChar *out_pszDirectory, unsigned int in_uiBufferSize, const GUID &in_guidPlatform) const

Obtain the Converted directory for the plug-in and platform.

Definition: HostObjectMedia.h:505

ak_wwise_plugin_host_object_media_v1::GetMediaSourceFileName

unsigned int(* GetMediaSourceFileName)(const struct ak_wwise_plugin_host_object_media_instance_v1 *in_this, AkOSChar *out_pszFileName, unsigned int in_uiBufferSize, unsigned int in_Index)

Retrieve the file name of the source plug-in data at the specified index, as provided in SetMediaSour...

Definition: HostObjectMedia.h:130

AK.Wwise::Plugin::V1::Notifications::ObjectMedia_

Definition: HostObjectMedia.h:521

ak_wwise_plugin_host_object_media_instance_v1

Base host-provided instance type for ak_wwise_plugin_host_object_media_v1.

Definition: PluginDef.h:660

AK.Wwise::Plugin::CBaseInterfaceGlue< CHostObjectMedia >::g_cinterface

static GluedInterface * g_cinterface

The unique instance of the CInterface interface. Defined at nullptr first, overridden by the Host onc...

Definition: PluginInfoGenerator.h:89

ak_wwise_plugin_host_object_media_v1::RemoveMediaSource

void(* RemoveMediaSource)(struct ak_wwise_plugin_host_object_media_instance_v1 *in_this, unsigned int in_Index)

Requests to remove the specified index file as data input file.

Definition: HostObjectMedia.h:98

AK.Wwise::Plugin::V1::Notifications::ObjectMedia_::ObjectMedia_

ObjectMedia_()

Definition: HostObjectMedia.h:576

AK.Wwise::Plugin::InterfaceVersion

decltype(BaseInterface::m_version) InterfaceVersion

PluginInfoGenerator: Type for the m_version value in BaseInterface.

Definition: PluginInfoGenerator.h:50

AK.Wwise::Plugin::V1::ObjectMedia::InvalidateMediaSource

void InvalidateMediaSource(unsigned int in_Index)

Request Wwise to perform any required conversion on the data.

Definition: HostObjectMedia.h:463

AK.Wwise::Plugin::V1::ObjectMedia::GetOriginalDirectory

unsigned int GetOriginalDirectory(AkOSChar *out_pszDirectory, unsigned int in_uiBufferSize) const

Obtain the Original directory for the plug-in.

Definition: HostObjectMedia.h:483

ak_wwise_plugin_host_object_media_v1::SetMediaSource

bool(* SetMediaSource)(struct ak_wwise_plugin_host_object_media_instance_v1 *in_this, const AkOSChar *in_pszFilePathToImport, unsigned int in_Index, bool in_bReplace)

Requests to set the specified file as a data input file.

Definition: HostObjectMedia.h:83

AkOSChar

char AkOSChar

Generic character string.

Definition: AkTypes.h:60

ak_wwise_plugin_notifications_object_media_v1::Instance

ak_wwise_plugin_notifications_object_media_instance_v1 Instance

Base instance type for receiving notifications on related object media's changes.

Definition: HostObjectMedia.h:254

AK.Wwise::Plugin::V1::ObjectMedia::k_interfaceVersion

@ k_interfaceVersion

The interface version, as requested by this plug-in.

Definition: HostObjectMedia.h:321

AK.Wwise::Plugin::V1::ObjectMedia::GetMediaSourceCount

unsigned int GetMediaSourceCount() const

Retrieve the number of media source indexes.

Definition: HostObjectMedia.h:375

ak_wwise_plugin_host_object_media_v1::GetMediaSourceOriginalFilePath

unsigned int(* GetMediaSourceOriginalFilePath)(const struct ak_wwise_plugin_host_object_media_instance_v1 *in_this, AkOSChar *out_pszFilePath, unsigned int in_uiBufferSize, unsigned int in_Index)

Retrieve the full file path of the source plug-in data at the specified index.

Definition: HostObjectMedia.h:154

PluginInfoGenerator.h

Wwise Authoring Plug-ins - C++ class helper to automatically determine the plug-in interfaces used in...

AK.Wwise::Plugin::CBaseInstanceGlue

PluginInfoGenerator: Associates an existing C Interface with a variable that can be used....

Definition: PluginInfoGenerator.h:104

AK.Wwise::Plugin::InterfacePtr

CInterfacePtr InterfacePtr

Definition: PluginDef.h:1057

ak_wwise_plugin_host_object_media_v1::GetOriginalDirectory

unsigned int(* GetOriginalDirectory)(const struct ak_wwise_plugin_host_object_media_instance_v1 *in_this, AkOSChar *out_pszDirectory, unsigned int in_uiBufferSize)

Obtain the Original directory for the plug-in.

Definition: HostObjectMedia.h:213

ak_wwise_plugin_host_object_media_v1::GetConvertedDirectory

unsigned int(* GetConvertedDirectory)(const struct ak_wwise_plugin_host_object_media_instance_v1 *in_this, AkOSChar *out_pszDirectory, unsigned int in_uiBufferSize, const GUID *in_guidPlatform)

Obtain the Converted directory for the plug-in and platform.

Definition: HostObjectMedia.h:234

AK.Wwise::Plugin::V1::ObjectMedia::SetMediaSource

bool SetMediaSource(const AkOSChar *in_pszFilePathToImport, unsigned int in_Index, bool in_bReplace)

Requests to set the specified file as a data input file.

Definition: HostObjectMedia.h:347

AK.Wwise::Plugin::V1::RequestObjectMedia

RequestedHostInterface< ObjectMedia > RequestObjectMedia

Requests a ObjectMedia interface, provided as m_objectMedia variable.

Definition: HostObjectMedia.h:603

AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_OBJECT_MEDIA

@ AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_OBJECT_MEDIA

2021.1 Object Media host service. ak_wwise_plugin_host_object_media_v1

Definition: PluginBaseInterface.h:78

AK.Wwise::Plugin::V1::Notifications::CObjectMedia_

ak_wwise_plugin_notifications_object_media_v1 CObjectMedia_

Definition: HostObjectMedia.h:517

AK.Wwise::Plugin::V1::CHostObjectMedia

ak_wwise_plugin_host_object_media_v1 CHostObjectMedia

Definition: HostObjectMedia.h:295

AK.Wwise::Plugin::V1::Notifications::ObjectMedia_::NotifyPluginMediaChanged

virtual void NotifyPluginMediaChanged()

This function is called by Wwise when any of the plug-in media changes.

Definition: HostObjectMedia.h:591

AK.Wwise::Plugin::InterfaceTypeValue

std::underlying_type< InterfaceType >::type InterfaceTypeValue

PluginInfoGenerator: Underlying storage type for the m_interface value in BaseInterface.

Definition: PluginInfoGenerator.h:49

ak_wwise_plugin_host_object_media_v1

Definition: HostObjectMedia.h:45

AK.Wwise::Plugin::V1::Notifications::ObjectMedia_::Interface::Interface

Interface()

Definition: HostObjectMedia.h:555

AK.Wwise::Plugin::V1::Notifications::ObjectMedia_::GetInstancePointer

CObjectMedia_::Instance * GetInstancePointer()

Definition: HostObjectMedia.h:569

AK.Wwise::Plugin::AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION

AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION(AudioPlugin)

AK.Wwise::Plugin::RequestedHostInterface< ObjectMedia >

Definition: HostObjectMedia.h:622

AkTypes.h

ak_wwise_plugin_base_interface

Interface description and base class for every Wwise Authoring plug-in interface.

Definition: PluginBaseInterface.h:120

AK.Wwise::Plugin::V1::Notifications::ObjectMedia_::k_interfaceType

@ k_interfaceType

The interface type, as provided by this plug-in.

Definition: HostObjectMedia.h:536

ak_wwise_plugin_notifications_object_media_v1::ak_wwise_plugin_notifications_object_media_v1

ak_wwise_plugin_notifications_object_media_v1()

Definition: HostObjectMedia.h:256

ak_wwise_plugin_host_object_media_v1::GetMediaSourceConvertedFilePath

unsigned int(* GetMediaSourceConvertedFilePath)(const struct ak_wwise_plugin_host_object_media_instance_v1 *in_this, AkOSChar *out_pszFilePath, unsigned int in_uiBufferSize, const GUID *in_guidPlatform, unsigned int in_Index)

Retrieve the full file path of the converted plug-in data at the specified index.

Definition: HostObjectMedia.h:177

AK.Wwise::Plugin::V1::ObjectMedia::k_interfaceType

@ k_interfaceType

The interface type, as requested by this plug-in.

Definition: HostObjectMedia.h:311

AK.Wwise::Plugin::V1::Notifications::ObjectMedia_::GetInstancePointer

const CObjectMedia_::Instance * GetInstancePointer() const

Definition: HostObjectMedia.h:572

MKBOOL

#define MKBOOL(cond)

Definition: PluginHelpers.h:79