Version
menu_open
link
Wwise SDK 2022.1.7
HostObjectStore.h
Go to the documentation of this file.
1 /*******************************************************************************
2 The content of this file includes portions of the AUDIOKINETIC Wwise Technology
3 released in source code form as part of the SDK installer package.
4 
5 Commercial License Usage
6 
7 Licensees holding valid commercial licenses to the AUDIOKINETIC Wwise Technology
8 may use this file in accordance with the end user license agreement provided
9 with the software or, alternatively, in accordance with the terms contained in a
10 written agreement between you and Audiokinetic Inc.
11 
12 Apache License Usage
13 
14 Alternatively, this file may be used under the Apache License, Version 2.0 (the
15 "Apache License"); you may not use this file except in compliance with the
16 Apache License. You may obtain a copy of the Apache License at
17 http://www.apache.org/licenses/LICENSE-2.0.
18 
19 Unless required by applicable law or agreed to in writing, software distributed
20 under the Apache License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
21 OR CONDITIONS OF ANY KIND, either express or implied. See the Apache License for
22 the specific language governing permissions and limitations under the License.
23 
24  Copyright (c) 2023 Audiokinetic Inc.
25 *******************************************************************************/
26 
27 /**
28  * \brief Wwise Authoring Plug-ins - API for storing objects not in the plug-in XML.
29  * \file AK/Wwise/Plugin/HostObjectStore.h
30  */
31 
32 #pragma once
33 
34 #include "HostPropertySet.h"
35 
36 
37 /**
38  * \brief Custom inner property set interface.
39  *
40  * The Object Store contains named lists, and those named lists each contains a vector of inner property sets.
41  *
42  * For example, you can create a list named "Property curve points" and have 12 inner property sets with coordinates,
43  * configuration and information for the 12 user-created curve points.
44  *
45  * Inner property sets can be created from any inner types, as defined in the plug-in's XML definition file
46  * <code>InnerTypes</code> section. Your lists should contain recognizable types, as there is no way to poll the
47  * type of the created object. This system was created with a one-list-one-type design pattern; however, there is
48  * no actual restriction in using different types in a same list.
49  *
50  * You can define as many named lists as required. You should consider creating different inner property sets or
51  * lists for each platform if the property set indexes aren't linked.
52  *
53  * You can create new inner property set with \ref CreatePropertySet, and insert it in a list's index with
54  * \ref InsertPropertySet.
55  *
56  * You can also subscribe to notifications through ak_wwise_plugin_notifications_object_store_v1 in order to be
57  * informed when some inner property set changed.
58  *
59  * \aknote
60  * In order to manage property sets, you must make sure to use \ref AK::Wwise::Plugin::RequestPropertySet in
61  * your plug-in.
62  * \endaknote
63  *
64  * \aknote
65  * Historical naming convention described it as "inner object" and "inner type". For simplicity,
66  * since we are talking about property sets, the naming has been standardized to "inner property set".
67  * However, the names are interchangeable and are still being used.
68  * \endaknote
69  *
70  * \sa
71  * - \ref wwiseplugin_objectstore
72  * - \ref wwiseplugin_xml_properties_tag
73  * - \ref ak_wwise_plugin_notifications_object_store_v1
74  */
75 struct ak_wwise_plugin_host_object_store_v1
76 #ifdef __cplusplus
77  : public ak_wwise_plugin_base_interface
78 #endif
79 {
80 #ifndef __cplusplus
81  ak_wwise_plugin_base_interface m_baseInterface;
82 #endif
83 
84 #ifdef __cplusplus
85  /// Base host-provided instance type for ak_wwise_plugin_host_object_store_v1.
86  using Instance = ak_wwise_plugin_host_object_store_instance_v1;
87 
88  ak_wwise_plugin_host_object_store_v1() :
89  ak_wwise_plugin_base_interface(AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_OBJECT_STORE, 1)
90  {}
91 #endif
92 
93  /**
94  * \brief Inserts an inner property set into the specified list at the specified position.
95  *
96  * To create a new inner property set, use \ref CreatePropertySet . You can then insert
97  * that particular inner property set in the named list <code>in_pszListName</code>, at the
98  * <code>in_uiIndex</code> position, so it will be stored in the project data. Existing object positions
99  * equal to or higher than <code>in_uiIndex</code> will be incremented as required.
100  *
101  * Named lists are created automatically, there is no limitation for naming. However, you should use the
102  * standardized naming convention for better memory usage in Wwise Authoring. List ordering is
103  * arbitrary.
104  *
105  * \aknote
106  * You must add up indexes sequentially. If you have 0-14 indexes, adding a new one at 40 will
107  * create it at 15. Pass <code>(unsigned int)-1</code> as the in_uiIndex to insert at the end of
108  * the list.
109  * \endaknote
110  *
111  * \akwarning
112  * Never reuse the same inner property set under two different indexes or lists. If you are
113  * uncertain, or if you want to move it elsewhere, use \ref RemovePropertySet before
114  * inserting it elsewhere.
115  * \endakwarning
116  *
117  * \sa
118  * - \ref ak_wwise_plugin_notifications_object_store_v1::NotifyInnerObjectAddedRemoved
119  *
120  * \param[in] in_this Current instance of this interface.
121  * \param[in] in_pszListName Name of the affected list. That list will be created or appended depending
122  * on the situation.
123  * \param[in] in_uiIndex Inner property set index in the list. If higher than or equal to the current
124  * object count in that list, will add a new index. Otherwise, increments previous object's
125  * indexes to make room for this new inner property set.
126  * \param[in] in_pPropertySet The inner property set to include in the list's index. This property set
127  * must be created with \ref CreatePropertySet and not used elsewhere.
128  */
129  void(*InsertPropertySet)(
130  struct ak_wwise_plugin_host_object_store_instance_v1* in_this,
131  const char * in_pszListName,
132  unsigned int in_uiIndex,
133  const struct ak_wwise_plugin_host_property_set_instance_v1* in_pPropertySet
134  );
135 
136  /**
137  * \brief Removes an inner property set from any list, without deleting the object itself.
138  *
139  * This is useful if you still need the object internally, or if you want to move that object to another
140  * list or index.
141  *
142  * If a list doesn't contain any items anymore, the list will automatically be deleted.
143  *
144  * The function \ref DeletePropertySet must be used if you still keep that reference without being
145  * reinserted through \ref InsertPropertySet. For normal deletion, you should execute
146  * \ref DeletePropertySet function directly, and it will remove any usage automatically.
147  *
148  * \sa
149  * - \ref ak_wwise_plugin_notifications_object_store_v1::NotifyInnerObjectAddedRemoved
150  *
151  * \param[in] in_this Current instance of this interface.
152  * \param[in] in_pPropertySet The inner property set to remove from any list's index. The object is not
153  * deleted.
154  * \return true if successful
155  */
156  bool(*RemovePropertySet)(
157  struct ak_wwise_plugin_host_object_store_instance_v1* in_this,
158  const struct ak_wwise_plugin_host_property_set_instance_v1* in_pPropertySet
159  );
160 
161  /**
162  * \brief Gets an inner property set inside the specified list at the specified position.
163  *
164  * Wwise Authoring handles the object's lifetime as long as it's inserted. You should not call
165  * \ref DeletePropertySet unless you want to remove it from your plug-in instance's objects.
166  *
167  * \aknote
168  * In order to manage property sets, you must make sure to use
169  * \ref AK::Wwise::Plugin::RequestPropertySet.
170  * \endaknote
171  *
172  * \param[in] in_this Current instance of this interface.
173  * \param[in] in_pszListName Name of the polled list. If the list doesn't exist, the function will
174  * return nullptr.
175  * \param[in] in_uiIndex Inner property set index in the list. If higher than or equal to the current
176  * object count in that list, the function will return nullptr.
177  * \return The requested inner property set, or nullptr if not existing.
178  */
179  struct ak_wwise_plugin_host_property_set_instance_v1*(*GetPropertySet)(
180  const struct ak_wwise_plugin_host_object_store_instance_v1* in_this,
181  const char * in_pszListName,
182  unsigned int in_uiIndex
183  );
184 
185  /**
186  * \brief Gets the number of inserted indexes inside the specified list.
187  *
188  * If the list doesn't exist, 0 will be returned.
189  *
190  * \param[in] in_this Current instance of this interface.
191  * \param[in] in_pszListName Name of the polled list. If the list doesn't exist, the function will
192  * return 0.
193  * \return The number of inner property sets inside the list in_pszListName.
194  */
195  unsigned int(*GetPropertySetCount)(
196  const struct ak_wwise_plugin_host_object_store_instance_v1* in_this,
197  const char * in_pszListName
198  );
199 
200  /**
201  * \brief Creates a new inner property set.
202  *
203  * An inner property set must be defined as a particular <code>InnerType</code> in the plug-in's XML
204  * definition file.
205  *
206  * When this object is created, it is not bound to any list. As such, this is the only moment
207  * where it is under the plug-in's responsibility. You should either call
208  * \ref InsertPropertySet or \ref DeletePropertySet on it to make sure the plug-in doesn't cause
209  * a memory leak.
210  *
211  * \sa
212  * - \ref wwiseplugin_objectstore
213  * - \ref wwiseplugin_xml_properties_tag
214  *
215  * \param[in] in_this Current instance of this interface.
216  * \param[in] in_pszType The requested InnerType, as defined in the plug-in's XML definition file.
217  * \return A new inner property set instance.
218  */
219  struct ak_wwise_plugin_host_property_set_instance_v1*(*CreatePropertySet)(
220  struct ak_wwise_plugin_host_object_store_instance_v1* in_this,
221  const char * in_pszType
222  );
223 
224  /**
225  * \brief Frees the inner property set.
226  *
227  * It will also remove the object from its list if the object has been inserted. As such, you are not
228  * required to call \ref RemovePropertySet beforehand.
229  *
230  * \akwarning
231  * Do not use the in_pPropertySet after calling this function.
232  * \endakwarning
233  *
234  * \sa
235  * - \ref ak_wwise_plugin_notifications_object_store_v1::NotifyInnerObjectAddedRemoved
236  *
237  * \param[in] in_this Current instance of this interface.
238  * \param[in] in_pPropertySet The inner property set to permanently delete.
239  */
240  void(*DeletePropertySet)(
241  struct ak_wwise_plugin_host_object_store_instance_v1* in_this,
242  struct ak_wwise_plugin_host_property_set_instance_v1* in_pPropertySet
243  );
244 
245  /**
246  * \brief Returns the number of inner property set lists to be used with GetListName.
247  *
248  * \param[in] in_this Current instance of this interface.
249  * \return Number of property set lists, or 0 if there are none.
250  */
251  unsigned int(*GetListCount)(
252  const struct ak_wwise_plugin_host_object_store_instance_v1* in_this
253  );
254 
255  /**
256  * \brief Gets the name of the list at the specified position.
257  *
258  * List ordering is arbitrary and can vary between Wwise Authoring versions or project loads.
259  *
260  * \akwarning
261  * If you do not provide a buffer big enough to write the full string, the function will fail and
262  * return 0. Make sure to use a buffer big enough to write the entire string, depending
263  * on your own naming convention.
264  * \endakwarning
265  *
266  * \param[in] in_this Current instance of this interface.
267  * \param[in] in_uiListIndex Index of the list name to retrieve.
268  * \param[out] out_pszListName Pointer to a buffer that will contain the list name.
269  * \param[in] in_uiBufferSize Size of the provided buffer. If the buffer is not big enough for the
270  * entire name alongside a string ending suffix, the function will return 0 and no string
271  * will be copied.
272  * \return Number of characters written to the buffer, zero if failed.
273  */
274  unsigned int(*GetListName)(
275  const struct ak_wwise_plugin_host_object_store_instance_v1* in_this,
276  unsigned int in_uiListIndex,
277  char * out_pszListName,
278  unsigned int in_uiBufferSize
279  );
280 };
281 
282 
283 /**
284  * \brief Interface able to receive notifications for custom inner property sets.
285  *
286  * \aknote
287  * In order to manage property sets, you must make sure to use \ref AK::Wwise::Plugin::RequestPropertySet in
288  * your plug-in.
289  * \endaknote
290  *
291  * \sa
292  * - \ref wwiseplugin_objectstore
293  * - \ref ak_wwise_plugin_host_object_store_v1
294  */
295 struct ak_wwise_plugin_notifications_object_store_v1
296 #ifdef __cplusplus
297  : public ak_wwise_plugin_base_interface
298 #endif
299 {
300 #ifndef __cplusplus
301  ak_wwise_plugin_base_interface m_baseInterface;
302 #endif
303 
304 #ifdef __cplusplus
305  /// Base instance type for receiving notifications on related Object Store's changes.
306  using Instance = ak_wwise_plugin_notifications_object_store_instance_v1;
307 
308  ak_wwise_plugin_notifications_object_store_v1() :
309  ak_wwise_plugin_base_interface(AK_WWISE_PLUGIN_INTERFACE_TYPE_NOTIFICATIONS_OBJECT_STORE, 1)
310  {}
311 #endif
312 
313  /**
314  * \brief Called when an inner property set's data has changed.
315  *
316  * For example, data can change through interaction with a UI control bound to a property,
317  * or through undo/redo operations.
318  *
319  * \sa
320  * - \ref wwiseplugin_objectstore_notifications
321  *
322  * \param[in] in_this Current instance of this interface.
323  * \param[in] in_pPSet The inner property set that changed.
324  * \param[in] in_guidPlatform The unique ID of the queried platform.
325  * \param[in] in_pszPropertyName The name of the property that changed.
326  */
327  void(*NotifyInnerObjectPropertyChanged)(
328  struct ak_wwise_plugin_notifications_object_store_instance_v1* in_this,
329  struct ak_wwise_plugin_host_property_set_instance_v1* in_pPSet,
330  const GUID * in_guidPlatform,
331  const char * in_pszPropertyName
332  );
333 
334  /**
335  * \brief Called when an inner property set has changed.
336  *
337  * For example, at a backend data refresh, a UI control bound to a property, or through
338  * undo/redo operations.
339  *
340  * \sa
341  * - \ref wwiseplugin_objectstore_notifications
342  *
343  * \param[in] in_this Current instance of this interface.
344  * \param[in] in_pPSet The inner property set that was added or removed.
345  * \param[in] in_uiIndex The insertion/removal index inside a named list.
346  * \param[in] in_eOperation InnerObjectAdded or InnerObjectRemoved.
347  */
348  void(*NotifyInnerObjectAddedRemoved)(
349  struct ak_wwise_plugin_notifications_object_store_instance_v1* in_this,
350  struct ak_wwise_plugin_host_property_set_instance_v1* in_pPSet,
351  unsigned int in_uiIndex,
352  AK::Wwise::Plugin::NotifyInnerObjectOperation in_eOperation
353  );
354 };
355 
356 
357 #define AK_WWISE_PLUGIN_HOST_OBJECT_STORE_V1_ID() \
358  AK_WWISE_PLUGIN_BASE_INTERFACE_FROM_ID(AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_OBJECT_STORE, 1)
359 #define AK_WWISE_PLUGIN_HOST_OBJECT_STORE_V1_CTOR() \
360 { \
361  .m_baseInterface = AK_WWISE_PLUGIN_HOST_OBJECT_STORE_V1_ID() \
362 }
363 
364 #define AK_WWISE_PLUGIN_NOTIFICATIONS_OBJECT_STORE_V1_ID() \
365  AK_WWISE_PLUGIN_BASE_INTERFACE_FROM_ID(AK_WWISE_PLUGIN_INTERFACE_TYPE_NOTIFICATIONS_OBJECT_STORE, 1)
366 #define AK_WWISE_PLUGIN_NOTIFICATIONS_OBJECT_STORE_V1_CTOR(/* ak_wwise_plugin_info* */ in_pluginInfo, /* void* */ in_data) \
367 { \
368  .m_baseInterface = AK_WWISE_PLUGIN_BASE_INTERFACE_CTOR(AK_WWISE_PLUGIN_NOTIFICATIONS_OBJECT_STORE_V1_ID(), in_pluginInfo, in_data) \
369 }
370 
371 
372 #ifdef __cplusplus
373 namespace AK::Wwise::Plugin
374 {
375  namespace V1
376  {
377  using CHostObjectStore = ak_wwise_plugin_host_object_store_v1;
378 
379  /// \copydoc ak_wwise_plugin_host_object_store_v1
380  class ObjectStore : public CBaseInstanceGlue<CHostObjectStore>
381  {
382  public:
383  using Interface = CHostObjectStore;
384 
385  /**
386  * \brief The interface type, as requested by this plug-in.
387  */
388  enum : InterfaceTypeValue
389  {
390  /**
391  * \brief The interface type, as requested by this plug-in.
392  */
393  k_interfaceType = AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_OBJECT_STORE
394  };
395  /**
396  * \brief The interface version, as requested by this plug-in.
397  */
398  enum : InterfaceVersion
399  {
400  /**
401  * \brief The interface version, as requested by this plug-in.
402  */
403  k_interfaceVersion = 1
404  };
405 
406  /**
407  * \brief Inserts an inner property set into the specified list at the specified position.
408  *
409  * To create a new inner property set, use \ref CreatePropertySet . You can then insert
410  * that particular inner property set in the named list <code>in_pszListName</code>, at the
411  * <code>in_uiIndex</code> position, so it will be stored in the project data. Existing object positions
412  * equal to or higher than <code>in_uiIndex</code> will be incremented as required.
413  *
414  * Named lists are created automatically, there is no limitation for naming. However, you should use the
415  * standardized naming convention for better memory usage in Wwise Authoring. List ordering is
416  * arbitrary.
417  *
418  * \aknote
419  * You must add up indexes sequentially. If you have 0-14 indexes, adding a new one at 40 will
420  * create it at 15. Pass <code>(unsigned int)-1</code> as the in_uiIndex to insert at the end of
421  * the list.
422  * \endaknote
423  *
424  * \akwarning
425  * Never reuse the same inner property set under two different indexes or lists. If you are
426  * uncertain, or if you want to move it elsewhere, use \ref RemovePropertySet before
427  * inserting it elsewhere.
428  * \endakwarning
429  *
430  * \sa
431  * - \ref ak_wwise_plugin_notifications_object_store_v1::NotifyInnerObjectAddedRemoved
432  *
433  * \param[in] in_pszListName Name of the affected list. That list will be created or appended depending
434  * on the situation.
435  * \param[in] in_uiIndex Inner property set index in the list. If higher than or equal to the current
436  * object count in that list, will add a new index. Otherwise, increments previous object's
437  * indexes to make room for this new inner property set.
438  * \param[in] in_propertySet The inner property set to include in the list's index. This property set
439  * must be created with \ref CreatePropertySet and not used elsewhere.
440  */
441  inline void InsertPropertySet(
442  const char * in_pszListName,
443  unsigned int in_uiIndex,
444  const PropertySet& in_propertySet
445  )
446  {
447  g_cinterface->InsertPropertySet(this, in_pszListName, in_uiIndex, &in_propertySet);
448  }
449 
450  /**
451  * \brief Removes an inner property set from any list, without deleting the object itself.
452  *
453  * This is useful if you still need the object internally, or if you want to move that object to another
454  * list or index.
455  *
456  * If a list doesn't contain any items anymore, the list will automatically be deleted.
457  *
458  * The function \ref DeletePropertySet must be used if you still keep that reference without being
459  * reinserted through \ref InsertPropertySet. For normal deletion, you should execute
460  * \ref DeletePropertySet function directly, and it will remove any usage automatically.
461  *
462  * \sa
463  * - \ref ak_wwise_plugin_notifications_object_store_v1::NotifyInnerObjectAddedRemoved
464  *
465  * \param[in] in_propertySet The inner property set to remove from any list's index. The object is not
466  * deleted.
467  * \return true if successful
468  */
469  inline bool RemovePropertySet(
470  const PropertySet& in_propertySet
471  )
472  {
473  return MKBOOL(g_cinterface->RemovePropertySet(this, &in_propertySet));
474  }
475 
476  /**
477  * \brief Gets an inner property set inside the specified list at the specified position.
478  *
479  * Wwise Authoring handles the object's lifetime as long as it's inserted. You should not call
480  * \ref DeletePropertySet unless you want to remove it from your plug-in instance's objects.
481  *
482  * \aknote
483  * In order to manage property sets, you must make sure to use
484  * \ref AK::Wwise::Plugin::RequestPropertySet.
485  * \endaknote
486  *
487  * \param[in] in_pszListName Name of the polled list. If the list doesn't exist, the function will
488  * return nullptr.
489  * \param[in] in_uiIndex Inner property set index in the list. If higher than or equal to the current
490  * object count in that list, the function will return nullptr.
491  * \return The requested inner property set, or nullptr if not existing.
492  */
493  inline PropertySet* GetPropertySet(
494  const char * in_pszListName,
495  unsigned int in_uiIndex
496  ) const
497  {
498  return static_cast<PropertySet*>(g_cinterface->GetPropertySet(this, in_pszListName, in_uiIndex));
499  }
500 
501  /**
502  * \brief Gets the number of inserted indexes inside the specified list.
503  *
504  * If the list doesn't exist, 0 will be returned.
505  *
506  * \param[in] in_pszListName Name of the polled list. If the list doesn't exist, the function will
507  * return 0.
508  * \return The number of inner property sets inside the list in_pszListName.
509  */
510  inline unsigned int GetPropertySetCount(
511  const char * in_pszListName
512  ) const
513  {
514  return g_cinterface->GetPropertySetCount(this, in_pszListName);
515  }
516 
517  /**
518  * \brief Creates a new inner property set.
519  *
520  * An inner property set must be defined as a particular <code>InnerType</code> in the plug-in's XML
521  * definition file.
522  *
523  * When this object is created, it is not bound to any list. As such, this is the only moment
524  * where it is under the plug-in's responsibility. You should either call
525  * \ref InsertPropertySet or \ref DeletePropertySet on it to make sure the plug-in doesn't cause
526  * a memory leak.
527  *
528  * \sa
529  * - \ref wwiseplugin_objectstore
530  * - \ref wwiseplugin_xml_properties_tag
531  *
532  * \param[in] in_pszType The requested InnerType, as defined in the plug-in's XML definition file.
533  * \return A new inner property set instance.
534  */
535  inline PropertySet* CreatePropertySet(
536  const char * in_pszType
537  )
538  {
539  return static_cast<PropertySet*>(g_cinterface->CreatePropertySet(this, in_pszType));
540  }
541 
542  /**
543  * \brief Frees the inner property set.
544  *
545  * It will also remove the object from its list if the object has been inserted. As such, you are not
546  * required to call \ref RemovePropertySet beforehand.
547  *
548  * \akwarning
549  * Do not use the in_pPropertySet after calling this function.
550  * \endakwarning
551  *
552  * \sa
553  * - \ref ak_wwise_plugin_notifications_object_store_v1::NotifyInnerObjectAddedRemoved
554  *
555  * \param[in] in_pPropertySet The inner property set to permanently delete.
556  */
557  inline void DeletePropertySet(
558  PropertySet* in_pPropertySet
559  )
560  {
561  g_cinterface->DeletePropertySet(this, in_pPropertySet);
562  }
563 
564  /**
565  * \brief Returns the number of inner property set lists to be used with GetListName.
566  *
567  * \return Number of property set lists, or 0 if there are none.
568  */
569  inline unsigned int GetListCount(
570  ) const
571  {
572  return g_cinterface->GetListCount(this);
573  }
574 
575  /**
576  * \brief Gets the name of the list at the specified position.
577  *
578  * List ordering is arbitrary and can vary between Wwise Authoring versions or project loads.
579  *
580  * \akwarning
581  * If you do not provide a buffer big enough to write the full string, the function will fail and
582  * return 0. Make sure to use a buffer big enough to write the entire string, depending
583  * on your own naming convention.
584  * \endakwarning
585  *
586  * \param[in] in_uiListIndex Index of the list name to retrieve.
587  * \param[out] out_pszListName Pointer to a buffer that will contain the list name.
588  * \param[in] in_uiBufferSize Size of the provided buffer. If the buffer is not big enough for the
589  * entire name alongside a string ending suffix, the function will return 0 and no string
590  * will be copied.
591  * \return Number of characters written to the buffer, zero if failed.
592  */
593  inline unsigned int GetListName(
594  unsigned int in_uiListIndex,
595  char * out_pszListName,
596  unsigned int in_uiBufferSize
597  ) const
598  {
599  return g_cinterface->GetListName(this, in_uiListIndex, out_pszListName, in_uiBufferSize);
600  }
601  };
602 
603  namespace Notifications
604  {
605  using CObjectStore_ = ak_wwise_plugin_notifications_object_store_v1;
606 
607  /// \copydoc ak_wwise_plugin_notifications_object_store_v1
608  class ObjectStore_ : public CObjectStore_::Instance
609  {
610  public:
611  /**
612  * \copydoc CObjectStore_::Instance
613  */
614  using Instance = CObjectStore_::Instance;
615 
616  /**
617  * \brief The interface type, as provided by this plug-in.
618  */
619  enum : InterfaceTypeValue
620  {
621  /**
622  * \brief The interface type, as provided by this plug-in.
623  */
624  k_interfaceType = AK_WWISE_PLUGIN_INTERFACE_TYPE_NOTIFICATIONS_OBJECT_STORE
625  };
626  /**
627  * \brief The interface version, as provided by this plug-in.
628  */
629  enum : InterfaceVersion
630  {
631  /**
632  * \brief The interface version, as provided by this plug-in.
633  */
634  k_interfaceVersion = 1
635  };
636 
637  /**
638  * \brief The C interface, fulfilled by your plug-in.
639  */
640  struct Interface : public CObjectStore_
641  {
642  using Instance = ObjectStore_;
643  Interface()
644  {
645  CObjectStore_::NotifyInnerObjectPropertyChanged = [](
646  struct ak_wwise_plugin_notifications_object_store_instance_v1* in_this,
647  struct ak_wwise_plugin_host_property_set_instance_v1* in_pPSet,
648  const GUID * in_guidPlatform,
649  const char * in_pszPropertyName)
650  {
651  static_cast<Instance*>(in_this)->NotifyInnerObjectPropertyChanged(
652  *static_cast<PropertySet*>(in_pPSet),
653  *in_guidPlatform,
654  in_pszPropertyName);
655  };
656  CObjectStore_::NotifyInnerObjectAddedRemoved = [](
657  struct ak_wwise_plugin_notifications_object_store_instance_v1* in_this,
658  struct ak_wwise_plugin_host_property_set_instance_v1* in_pPSet,
659  unsigned int in_uiIndex,
660  NotifyInnerObjectOperation in_eOperation)
661  {
662  static_cast<Instance*>(in_this)->NotifyInnerObjectAddedRemoved(
663  *static_cast<PropertySet*>(in_pPSet),
664  in_uiIndex,
665  in_eOperation);
666  };
667  }
668  };
669 
670  InterfacePtr GetInterfacePointer() {
671  static Interface g_interface;
672  return &g_interface;
673  }
674  CObjectStore_::Instance* GetInstancePointer() {
675  return this;
676  }
677  const CObjectStore_::Instance* GetInstancePointer() const {
678  return this;
679  }
680 
681  ObjectStore_() :
682  CObjectStore_::Instance()
683  {
684  }
685 
686  virtual ~ObjectStore_() {}
687 
688  /**
689  * \brief Called when an inner property set's data has changed.
690  *
691  * For example, data can change through interaction with a UI control bound to a property,
692  * or through undo/redo operations.
693  *
694  * \sa
695  * - \ref wwiseplugin_objectstore_notifications
696  *
697  * \param[in] in_PSet The inner property set that changed.
698  * \param[in] in_guidPlatform The unique ID of the queried platform.
699  * \param[in] in_pszPropertyName The name of the property that changed.
700  */
701  virtual void NotifyInnerObjectPropertyChanged(
702  PropertySet& in_PSet,
703  const GUID& in_guidPlatform,
704  const char* in_pszPropertyName
705  ) {}
706 
707  /**
708  * \brief Called when an inner property set has changed.
709  *
710  * For example, at a backend data refresh, a UI control bound to a property, or through
711  * undo/redo operations.
712  *
713  * \sa
714  * - \ref wwiseplugin_objectstore_notifications
715  *
716  * \param[in] in_PSet The inner property set that was added or removed.
717  * \param[in] in_uiIndex The insertion/removal index inside a named list.
718  * \param[in] in_eOperation InnerObjectAdded or InnerObjectRemoved.
719  */
720  virtual void NotifyInnerObjectAddedRemoved(
721  PropertySet& in_PSet,
722  unsigned int in_uiIndex,
723  NotifyInnerObjectOperation in_eOperation
724  ) {}
725  };
726  } // of namespace Notifications
727 
728  /**
729  * \brief Requests an ObjectStore interface, provided as m_objectStore variable.
730  *
731  * Deriving your plug-in class from RequestObjectStore will automatically request both ObjectStore and
732  * Notifications::ObjectStore_ interfaces. From this point, you will be able to derive from the virtual
733  * functions, as defined in Notifications::ObjectStore_, and access the host-provided functions in the
734  * \c m_objectStore variable.
735  */
736  using RequestObjectStore = RequestedHostInterface<ObjectStore>;
737 
738  } // of namespace V1
739 
740  /// Latest version of the C ObjectStore interface.
741  using CHostObjectStore = V1::CHostObjectStore;
742  /// Latest version of the C++ ObjectStore interface.
743  using ObjectStore = V1::ObjectStore;
744  /// Latest version of the requested C++ ObjectStore interface.
745  using RequestObjectStore = V1::RequestObjectStore;
746 
747  namespace Notifications
748  {
749  /// Latest version of the C ObjectStore notification interface.
750  using CObjectStore = V1::Notifications::CObjectStore_;
751  /// Latest version of the C++ ObjectStore notification interface.
752  using ObjectStore = V1::Notifications::ObjectStore_;
753  }
754 
755  AK_WWISE_PLUGIN_SPECIALIZE_HOST_INTERFACE(ObjectStore, objectStore,, public Notifications::ObjectStore);
756  AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_CLASS(ObjectStore);
757  AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION(ObjectStore);
758  AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_CLASS(Notifications::ObjectStore);
759  AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION(Notifications::ObjectStore);
760 
761 } // of namespace AK::Wwise::Plugin
762 
763 #endif
ak_wwise_plugin_host_object_store_v1
Custom inner property set interface.
Definition: HostObjectStore.h:79
AK.Wwise::Plugin::V1::Notifications::CObjectStore_
ak_wwise_plugin_notifications_object_store_v1 CObjectStore_
Definition: HostObjectStore.h:605
AK.Wwise::Plugin::V1::Notifications::ObjectStore_::GetInstancePointer
CObjectStore_::Instance * GetInstancePointer()
Definition: HostObjectStore.h:674
AK.Wwise::Plugin::V1::ObjectStore::k_interfaceType
@ k_interfaceType
The interface type, as requested by this plug-in.
Definition: HostObjectStore.h:393
AK.Wwise::Plugin::V1::ObjectStore::GetPropertySetCount
unsigned int GetPropertySetCount(const char *in_pszListName) const
Gets the number of inserted indexes inside the specified list.
Definition: HostObjectStore.h:510
AK.Wwise::Plugin::V1::Notifications::ObjectStore_::Interface::Interface
Interface()
Definition: HostObjectStore.h:643
AK.Wwise::Plugin::CBaseInterfaceGlue< CHostObjectStore >::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::InterfaceVersion
decltype(BaseInterface::m_version) InterfaceVersion
PluginInfoGenerator: Type for the m_version value in BaseInterface.
Definition: PluginInfoGenerator.h:50
AK.Wwise::Plugin::V1::ObjectStore::GetListName
unsigned int GetListName(unsigned int in_uiListIndex, char *out_pszListName, unsigned int in_uiBufferSize) const
Gets the name of the list at the specified position.
Definition: HostObjectStore.h:593
AK.Wwise::Plugin::V1::ObjectStore
Custom inner property set interface.
Definition: HostObjectStore.h:381
ak_wwise_plugin_host_object_store_v1::GetListName
unsigned int(* GetListName)(const struct ak_wwise_plugin_host_object_store_instance_v1 *in_this, unsigned int in_uiListIndex, char *out_pszListName, unsigned int in_uiBufferSize)
Gets the name of the list at the specified position.
Definition: HostObjectStore.h:274
AK.Wwise::Plugin::V1::CHostObjectStore
ak_wwise_plugin_host_object_store_v1 CHostObjectStore
Definition: HostObjectStore.h:377
AK.Wwise::Plugin::Notifications::ObjectStore
V1::Notifications::ObjectStore_ ObjectStore
Latest version of the C++ ObjectStore notification interface.
Definition: HostObjectStore.h:752
HostPropertySet.h
Wwise Authoring Plug-ins - Plug-in API for property sets.
AK.Wwise::Plugin::V1::Notifications::ObjectStore_::k_interfaceVersion
@ k_interfaceVersion
The interface version, as provided by this plug-in.
Definition: HostObjectStore.h:634
AK.Wwise::Plugin::NotifyInnerObjectOperation
NotifyInnerObjectOperation
Type of operation for the NotifyInnerObjectAddedRemoved function.
Definition: PluginDef.h:77
AK.Wwise::Plugin::V1::Notifications::ObjectStore_::ObjectStore_
ObjectStore_()
Definition: HostObjectStore.h:681
AK.Wwise::Plugin::V1::Notifications::ObjectStore_::NotifyInnerObjectAddedRemoved
virtual void NotifyInnerObjectAddedRemoved(PropertySet &in_PSet, unsigned int in_uiIndex, NotifyInnerObjectOperation in_eOperation)
Called when an inner property set has changed.
Definition: HostObjectStore.h:720
AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_OBJECT_STORE
@ AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_OBJECT_STORE
2021.1 Object Store host service. ak_wwise_plugin_host_object_store_v1
Definition: PluginBaseInterface.h:79
ak_wwise_plugin_host_object_store_v1::GetPropertySetCount
unsigned int(* GetPropertySetCount)(const struct ak_wwise_plugin_host_object_store_instance_v1 *in_this, const char *in_pszListName)
Gets the number of inserted indexes inside the specified list.
Definition: HostObjectStore.h:195
AK.Wwise::Plugin::V1::ObjectStore::InsertPropertySet
void InsertPropertySet(const char *in_pszListName, unsigned int in_uiIndex, const PropertySet &in_propertySet)
Inserts an inner property set into the specified list at the specified position.
Definition: HostObjectStore.h:441
ak_wwise_plugin_notifications_object_store_v1::ak_wwise_plugin_notifications_object_store_v1
ak_wwise_plugin_notifications_object_store_v1()
Definition: HostObjectStore.h:308
AK.Wwise::Plugin::V1::Notifications::ObjectStore_::NotifyInnerObjectPropertyChanged
virtual void NotifyInnerObjectPropertyChanged(PropertySet &in_PSet, const GUID &in_guidPlatform, const char *in_pszPropertyName)
Called when an inner property set's data has changed.
Definition: HostObjectStore.h:701
AK.Wwise::Plugin::V1::ObjectStore::RemovePropertySet
bool RemovePropertySet(const PropertySet &in_propertySet)
Removes an inner property set from any list, without deleting the object itself.
Definition: HostObjectStore.h:469
ak_wwise_plugin_notifications_object_store_v1::NotifyInnerObjectAddedRemoved
void(* NotifyInnerObjectAddedRemoved)(struct ak_wwise_plugin_notifications_object_store_instance_v1 *in_this, struct ak_wwise_plugin_host_property_set_instance_v1 *in_pPSet, unsigned int in_uiIndex, AK::Wwise::Plugin::NotifyInnerObjectOperation in_eOperation)
Called when an inner property set has changed.
Definition: HostObjectStore.h:348
AK.Wwise::Plugin::V1::RequestObjectStore
RequestedHostInterface< ObjectStore > RequestObjectStore
Requests an ObjectStore interface, provided as m_objectStore variable.
Definition: HostObjectStore.h:736
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:980
AK.Wwise::Plugin::V1::ObjectStore::DeletePropertySet
void DeletePropertySet(PropertySet *in_pPropertySet)
Frees the inner property set.
Definition: HostObjectStore.h:557
AK.Wwise::Plugin::V1::Notifications::ObjectStore_
Interface able to receive notifications for custom inner property sets.
Definition: HostObjectStore.h:609
ak_wwise_plugin_notifications_object_store_v1::Instance
ak_wwise_plugin_notifications_object_store_instance_v1 Instance
Base instance type for receiving notifications on related Object Store's changes.
Definition: HostObjectStore.h:306
ak_wwise_plugin_host_object_store_v1::GetPropertySet
struct ak_wwise_plugin_host_property_set_instance_v1 *(* GetPropertySet)(const struct ak_wwise_plugin_host_object_store_instance_v1 *in_this, const char *in_pszListName, unsigned int in_uiIndex)
Gets an inner property set inside the specified list at the specified position.
Definition: HostObjectStore.h:179
AK.Wwise::Plugin::V1::ObjectStore::CreatePropertySet
PropertySet * CreatePropertySet(const char *in_pszType)
Creates a new inner property set.
Definition: HostObjectStore.h:535
ak_wwise_plugin_notifications_object_store_instance_v1
Base instance type for receiving notifications on related Object Store's changes.
Definition: PluginDef.h:834
ak_wwise_plugin_host_object_store_v1::CreatePropertySet
struct ak_wwise_plugin_host_property_set_instance_v1 *(* CreatePropertySet)(struct ak_wwise_plugin_host_object_store_instance_v1 *in_this, const char *in_pszType)
Creates a new inner property set.
Definition: HostObjectStore.h:219
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::V1::ObjectStore::k_interfaceVersion
@ k_interfaceVersion
The interface version, as requested by this plug-in.
Definition: HostObjectStore.h:403
ak_wwise_plugin_notifications_object_store_v1
Interface able to receive notifications for custom inner property sets.
Definition: HostObjectStore.h:299
ak_wwise_plugin_notifications_object_store_v1::NotifyInnerObjectPropertyChanged
void(* NotifyInnerObjectPropertyChanged)(struct ak_wwise_plugin_notifications_object_store_instance_v1 *in_this, struct ak_wwise_plugin_host_property_set_instance_v1 *in_pPSet, const GUID *in_guidPlatform, const char *in_pszPropertyName)
Called when an inner property set's data has changed.
Definition: HostObjectStore.h:327
ak_wwise_plugin_host_object_store_v1::ak_wwise_plugin_host_object_store_v1
ak_wwise_plugin_host_object_store_v1()
Definition: HostObjectStore.h:88
AK.Wwise::Plugin::V1::PropertySet
Interface used to interact with property sets.
Definition: HostPropertySet.h:1052
AK.Wwise::Plugin::AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION
AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION(AudioPlugin)
AK.Wwise::Plugin::V1::ObjectStore::GetPropertySet
PropertySet * GetPropertySet(const char *in_pszListName, unsigned int in_uiIndex) const
Gets an inner property set inside the specified list at the specified position.
Definition: HostObjectStore.h:493
ak_wwise_plugin_host_object_store_v1::RemovePropertySet
bool(* RemovePropertySet)(struct ak_wwise_plugin_host_object_store_instance_v1 *in_this, const struct ak_wwise_plugin_host_property_set_instance_v1 *in_pPropertySet)
Removes an inner property set from any list, without deleting the object itself.
Definition: HostObjectStore.h:156
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::ObjectStore_::Interface
The C interface, fulfilled by your plug-in.
Definition: HostObjectStore.h:641
ak_wwise_plugin_host_object_store_v1::GetListCount
unsigned int(* GetListCount)(const struct ak_wwise_plugin_host_object_store_instance_v1 *in_this)
Returns the number of inner property set lists to be used with GetListName.
Definition: HostObjectStore.h:251
AK.Wwise::Plugin::V1::Notifications::ObjectStore_::k_interfaceType
@ k_interfaceType
The interface type, as provided by this plug-in.
Definition: HostObjectStore.h:624
AK.Wwise::Plugin::V1::Notifications::ObjectStore_::~ObjectStore_
virtual ~ObjectStore_()
Definition: HostObjectStore.h:686
AK.Wwise::Plugin::V1::ObjectStore::GetListCount
unsigned int GetListCount() const
Returns the number of inner property set lists to be used with GetListName.
Definition: HostObjectStore.h:569
ak_wwise_plugin_host_property_set_instance_v1
Base host-provided instance type for ak_wwise_plugin_host_property_set_v1.
Definition: PluginDef.h:645
ak_wwise_plugin_host_object_store_instance_v1
Base host-provided instance type for ak_wwise_plugin_host_object_store_v1.
Definition: PluginDef.h:636
ak_wwise_plugin_host_object_store_v1::InsertPropertySet
void(* InsertPropertySet)(struct ak_wwise_plugin_host_object_store_instance_v1 *in_this, const char *in_pszListName, unsigned int in_uiIndex, const struct ak_wwise_plugin_host_property_set_instance_v1 *in_pPropertySet)
Inserts an inner property set into the specified list at the specified position.
Definition: HostObjectStore.h:129
MKBOOL
#define MKBOOL(cond)
Definition: PluginHelpers.h:74
AK_WWISE_PLUGIN_INTERFACE_TYPE_NOTIFICATIONS_OBJECT_STORE
@ AK_WWISE_PLUGIN_INTERFACE_TYPE_NOTIFICATIONS_OBJECT_STORE
2021.1 Object Store modification notification. ak_wwise_plugin_notifications_object_store_v1
Definition: PluginBaseInterface.h:66
AK_WWISE_PLUGIN_SPECIALIZE_HOST_INTERFACE
#define AK_WWISE_PLUGIN_SPECIALIZE_HOST_INTERFACE(in_name, in_varname,...)
PluginInfoGenerator: Creates a C++ host specialization for interface class specified in in_name,...
Definition: PluginInfoGenerator.h:237
ak_wwise_plugin_host_object_store_v1::DeletePropertySet
void(* DeletePropertySet)(struct ak_wwise_plugin_host_object_store_instance_v1 *in_this, struct ak_wwise_plugin_host_property_set_instance_v1 *in_pPropertySet)
Frees the inner property set.
Definition: HostObjectStore.h:240
AK.Wwise::Plugin::AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_CLASS
AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_CLASS(AudioPlugin)
GUID
Definition: PluginHelpers.h:45
AK.Wwise::Plugin::V1::Notifications::ObjectStore_::GetInstancePointer
const CObjectStore_::Instance * GetInstancePointer() const
Definition: HostObjectStore.h:677
AK.Wwise::Plugin::V1::Notifications::ObjectStore_::GetInterfacePointer
InterfacePtr GetInterfacePointer()
Definition: HostObjectStore.h:670

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise