menu
search
language
English
Français
日本語
한국어
中文
Wwise
arrow_drop_down
Strata
arrow_drop_down
Solutions
arrow_drop_down
Learning
arrow_drop_down
Community
arrow_drop_down
Documentation
arrow_drop_down
Help
arrow_drop_down
Sign In
Download
 
Version
2021.1.14.8108
arrow_drop_down

2024.1.5.8803

2023.1.13.8732

2022.1.19.8584

2021.1.14.8108

2019.2.15.7667

2019.1.11.7296

2018.1.11.6987

2017.2.10.6745

2017.1.9.6501

2016.2.6.6153

2015.1.9.5624

menu_open
Wwise SDK 2021.1.14
HostPropertySet.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  Version: v2021.1.14 Build: 6590
25  Copyright (c) 2006-2023 Audiokinetic Inc.
26 *******************************************************************************/
27 
28 /**
29  * \brief Wwise Authoring Plug-ins - Plug-in API for property sets.
30  * \file AK/Wwise/Plugin/HostPropertySet.h
31  */
32 
33 #pragma once
34 
35 #include "PluginInfoGenerator.h"
36 
37 
38 /**
39  * \brief Interface used to interact with property sets.
40  *
41  * A property set is a dictionary of properties, as stored inside a user's Authoring project. Whenever a
42  * property name is specified, it corresponds to the property name as set in the plug-in's XML
43  * definition file.
44  *
45  * By default, Authoring will provide a property set, as defined in the XML definition file. It is
46  * possible to have more than one property set by requesting ak_wwise_plugin_host_object_store_v1, and
47  * adding \c InnerTypes in the XML definition file.
48  *
49  * This interface supports both the unique default property set, as well as Object Store's inner
50  * property sets.
51  *
52  * You can also subscribe to notifications through ak_wwise_plugin_notifications_property_set_v1 in order to
53  * be informed when some property set values changed.
54  *
55  * \aknote
56  * Most methods assume you acquired access to a platform as a GUID; either provided by the caller function,
57  * or retrieved through the Host interface.
58  *
59  * The usual providers of this GUID are \ref ak_wwise_plugin_audio_plugin_v1::GetBankParameters
60  * and \ref ak_wwise_plugin_audio_plugin_v1::GetPluginData method parameters.
61  *
62  * You can also poll up-to-date GUIDs from \ref ak_wwise_plugin_host_v1 methods, such as
63  * \ref ak_wwise_plugin_host_v1::GetCurrentPlatform.
64  *
65  * Finally, you can also provide GUID_NULL as a parameter, which will access data for all platforms at
66  * once (linked value). This is adequate only in certain cases where no platform-specific data is
67  * possible for a value. Using the current platform is always the preferred method of access.
68  * \endaknote
69  *
70  * \sa
71  * - \ref wwiseplugin_xml_properties_tag
72  * - \ref wwiseplugin_propertyset
73  * - \ref ak_wwise_plugin_notifications_property_set_v1
74  * - \ref ak_wwise_plugin_host_object_store_v1
75  */
76 struct ak_wwise_plugin_host_property_set_v1
77 #ifdef __cplusplus
78  : public ak_wwise_plugin_base_interface
79 #endif
80 {
81 #ifndef __cplusplus
82  ak_wwise_plugin_base_interface m_baseInterface;
83 #endif
84 
85 #ifdef __cplusplus
86  /// Base host-provided instance type for ak_wwise_plugin_host_property_set_v1.
87  using Instance = ak_wwise_plugin_host_property_set_instance_v1;
88  ak_wwise_plugin_host_property_set_v1() :
89  ak_wwise_plugin_base_interface(AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_PROPERTY_SET, 1)
90  {}
91 #endif
92 
93  /**
94  * \deprecated
95  * \brief Retrieves the value of a specific property as a variant.
96  *
97  * \akwarning
98  * This is a semi-private function. You should use the typed GetValue methods instead.
99  *
100  * \ref GetValueString, \ref GetValueInt64, \ref GetValueInt32, \ref GetValueInt16,
101  * \ref GetValueInt8, \ref GetValueUInt64, \ref GetValueUInt32, \ref GetValueUInt16,
102  * \ref GetValueUInt8, \ref GetValueReal64 \ref GetValueReal32, \ref GetValueBool
103  *
104  * The function can still be useful if you want to handle parameters as a black box, getting a
105  * value without knowing the type, and then setting that value elsewhere.
106  * \endakwarning
107  *
108  * \sa
109  * - \ref wwiseplugin_bank
110  *
111  * \param[in] in_this Current instance of this interface.
112  * \param[in] in_guidPlatform The unique ID of the queried platform.
113  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
114  * \param[out] out_varProperty The returned value of the property.
115  * \return true if successful.
116  */
117  bool(*GetValue)(
118  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
119  const GUID* in_guidPlatform,
120  const char * in_pszPropertyName,
121  AK::WwiseAuthoringAPI::AkVariantBase* out_varProperty
122  );
123 
124  /**
125  * \deprecated
126  * \brief Modifies the value of a specific property as a variant.
127  *
128  * Updates the property \c in_pszPropertyName to contain \c in_varProperty under the
129  * \c in_guidPlatform platform.
130  *
131  * The property type, as contained by \c in_varProperty, should be equal to the
132  * type as defined in the plug-in XML definition file.
133  *
134  * \aknote
135  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
136  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
137  *
138  * More than one platform will be affected if the property is linked
139  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
140  * \endaknote
141  *
142  * \akwarning
143  * This is a semi-private function. You should use the typed SetValue methods instead.
144  *
145  * \ref SetValueString, \ref SetValueInt64, \ref SetValueInt32, \ref SetValueInt16,
146  * \ref SetValueInt8, \ref SetValueUInt64, \ref SetValueUInt32, \ref SetValueUInt16,
147  * \ref SetValueUInt8, \ref SetValueReal64 \ref SetValueReal32, \ref SetValueBool
148  *
149  * The function can still be useful if you want to handle parameters as a black box, getting a
150  * value without knowing the type, and then setting that value elsewhere.
151  * \endakwarning
152  *
153  * \sa
154  * - \ref wwiseplugin_bank
155  *
156  * \param[in] in_this Current instance of this interface.
157  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
158  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
159  * \param[out] in_varProperty The new value of the property.
160  * \return true if successful.
161  */
162  bool(*SetValue)(
163  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
164  const GUID* in_guidPlatform,
165  const char * in_pszPropertyName,
166  const AK::WwiseAuthoringAPI::AkVariantBase* in_varProperty
167  );
168 
169  /**
170  * \brief Returns true if the specified property exists.
171  *
172  * \param[in] in_this Current instance of this interface.
173  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to check.
174  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
175  * \return true if property exists.
176  */
177  bool(*HasPropertyValue)(
178  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
179  const GUID* in_guidPlatform,
180  const char * in_pszPropertyName
181  );
182 
183  /**
184  * \brief Get the RTPC binding status for the specified property.
185  *
186  * \param[in] in_this Current instance of this interface.
187  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
188  * \return true if property is bound to an RTPC.
189  */
190  bool(*PropertyHasRTPC)(
191  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
192  const char * in_pszPropertyName
193  );
194 
195  /**
196  * \brief Returns whether the specified property is bound to a state object.
197  *
198  * \sa
199  * - \ref concept_state
200  *
201  * \param[in] in_this Current instance of this interface.
202  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
203  * \return true if property is bound to a state.
204  */
205  bool(*PropertyHasState)(
206  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
207  const char * in_pszPropertyName
208  );
209 
210  /**
211  * \brief Returns whether the specified property has at least some linked platforms.
212  *
213  * By default, all platforms are linked.
214  *
215  * \param[in] in_this Current instance of this interface.
216  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
217  * \return true if that particular property has some linked platforms.
218  */
219  bool(*PropertyHasLinked)(
220  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
221  const char * in_pszPropertyName
222  );
223 
224  /**
225  * \brief Returns whether the specified property has at least some platforms that are not linked.
226  *
227  * By default, all platforms are linked.
228  *
229  * \param[in] in_this Current instance of this interface.
230  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
231  * \return true if that particular property has some unlinked platforms.
232  */
233  bool(*PropertyHasUnlinked)(
234  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
235  const char * in_pszPropertyName
236  );
237 
238  /**
239  * \brief Returns whether the specified property's platform is linked.
240  *
241  * By default, all platforms are linked.
242  *
243  * \param[in] in_this Current instance of this interface.
244  * \param[in] in_guidPlatform The unique ID of the queried platform.
245  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
246  * \return true if the specified property specifically has the specified platform linked.
247  */
248  bool(*PropertyPlatformIsLinked)(
249  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
250  const GUID* in_guidPlatform,
251  const char * in_pszPropertyName
252  );
253 
254  /**
255  * \brief Returns the internal unique identifier of the corresponding object.
256  *
257  * For the plug-in property set, this is equivalent to the ID field in the project files.
258  *
259  * For inner property sets, as defined in Object Stores, that value is dynamic and only valid for
260  * this session.
261  *
262  * \aknote
263  * This value is provided mostly for information during the development process.
264  *
265  * The ID might change on Undo or Redo operations.
266  * \endaknote
267  *
268  * \param[in] in_this Current instance of this interface.
269  * \return GUID of the corresponding object.
270  */
271  const GUID*(*GetID)(
272  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this
273  );
274 
275  /**
276  * \brief Retrieves the type of a specific property.
277  *
278  * The return value can contain AK::WwiseAuthoringAPI::AkVariantTypeBase
279  * enumeration values.
280  *
281  * \param[in] in_this Current instance of this interface.
282  * \param[in] in_guidPlatform The unique ID of the queried platform.
283  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
284  * \return A AK::WwiseAuthoringAPI::AkVariantTypeBase value.
285  */
286  int (*GetType)(
287  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
288  const GUID* in_guidPlatform,
289  const char * in_pszPropertyName
290  );
291 
292  /**
293  * \brief Resets a property value to its default.
294  *
295  * This is different than setting the value to the default value. Once saved,
296  * this property set value line will disappear from the project file.
297  *
298  * \param[in] in_this Current instance of this interface.
299  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
300  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
301  * \return true if successful.
302  */
303  bool(*ClearValue)(
304  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
305  const GUID* in_guidPlatform,
306  const char * in_pszPropertyName
307  );
308 
309  /**
310  * \brief Modifies a property to a string value.
311  *
312  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
313  * \c in_guidPlatform platform.
314  *
315  * The plug-in XML definition file should define this property as a \c string in order to use
316  * this method.
317  *
318  * \aknote
319  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
320  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
321  *
322  * More than one platform will be affected if the property is linked
323  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
324  * \endaknote
325  *
326  * \sa
327  * - \ref wwiseplugin_bank
328  *
329  * \param[in] in_this Current instance of this interface.
330  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
331  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
332  * \param[out] in_propertyValue The new value of the property.
333  * \return true if successful.
334  */
335  bool(*SetValueString)(
336  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
337  const GUID* in_guidPlatform,
338  const char * in_pszPropertyName,
339  const char* in_propertyValue
340  );
341 
342  /**
343  * \brief Modifies a property to a 64-bit signed integer value.
344  *
345  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
346  * \c in_guidPlatform platform.
347  *
348  * The plug-in XML definition file should define this property as a \c int64 in order to use
349  * this method.
350  *
351  * \aknote
352  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
353  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
354  *
355  * More than one platform will be affected if the property is linked
356  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
357  * \endaknote
358  *
359  * \sa
360  * - \ref wwiseplugin_bank
361  *
362  * \param[in] in_this Current instance of this interface.
363  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
364  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
365  * \param[out] in_propertyValue The new value of the property.
366  * \return true if successful.
367  */
368  bool(*SetValueInt64)(
369  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
370  const GUID* in_guidPlatform,
371  const char * in_pszPropertyName,
372  int64_t in_propertyValue
373  );
374 
375  /**
376  * \brief Modifies a property to a 32-bit signed integer value.
377  *
378  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
379  * \c in_guidPlatform platform.
380  *
381  * The plug-in XML definition file should define this property as a \c int32 in order to use
382  * this method.
383  *
384  * \aknote
385  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
386  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
387  *
388  * More than one platform will be affected if the property is linked
389  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
390  * \endaknote
391  *
392  * \sa
393  * - \ref wwiseplugin_bank
394  *
395  * \param[in] in_this Current instance of this interface.
396  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
397  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
398  * \param[out] in_propertyValue The new value of the property.
399  * \return true if successful.
400  */
401  bool(*SetValueInt32)(
402  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
403  const GUID* in_guidPlatform,
404  const char * in_pszPropertyName,
405  int32_t in_propertyValue
406  );
407 
408  /**
409  * \brief Modifies a property to a 16-bit signed integer value.
410  *
411  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
412  * \c in_guidPlatform platform.
413  *
414  * The plug-in XML definition file should define this property as a \c int16 in order to use
415  * this method.
416  *
417  * \aknote
418  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
419  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
420  *
421  * More than one platform will be affected if the property is linked
422  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
423  * \endaknote
424  *
425  * \sa
426  * - \ref wwiseplugin_bank
427  *
428  * \param[in] in_this Current instance of this interface.
429  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
430  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
431  * \param[out] in_propertyValue The new value of the property.
432  * \return true if successful.
433  */
434  bool(*SetValueInt16)(
435  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
436  const GUID* in_guidPlatform,
437  const char * in_pszPropertyName,
438  int16_t in_propertyValue
439  );
440 
441  /**
442  * \brief Modifies a property to an 8-bit signed integer value. (Future use)
443  *
444  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
445  * \c in_guidPlatform platform.
446  *
447  * \akwarning
448  * The plug-in XML definition file doesn't currently provide a \c int8 value type.
449  * \endakwarning
450  *
451  * \aknote
452  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
453  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
454  *
455  * More than one platform will be affected if the property is linked
456  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
457  * \endaknote
458  *
459  * \sa
460  * - \ref wwiseplugin_bank
461  *
462  * \param[in] in_this Current instance of this interface.
463  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
464  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
465  * \param[out] in_propertyValue The new value of the property.
466  * \return true if successful.
467  */
468  bool(*SetValueInt8)(
469  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
470  const GUID* in_guidPlatform,
471  const char * in_pszPropertyName,
472  int8_t in_propertyValue
473  );
474 
475  /**
476  * \brief Modifies a property to a 64-bit unsigned integer value. (Future use)
477  *
478  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
479  * \c in_guidPlatform platform.
480  *
481  * \akwarning
482  * The plug-in XML definition file doesn't currently provide a \c uint64 value type.
483  * \endakwarning
484  *
485  * \aknote
486  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
487  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
488  *
489  * More than one platform will be affected if the property is linked
490  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
491  * \endaknote
492  *
493  * \sa
494  * - \ref wwiseplugin_bank
495  *
496  * \param[in] in_this Current instance of this interface.
497  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
498  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
499  * \param[out] in_propertyValue The new value of the property.
500  * \return true if successful.
501  */
502  bool(*SetValueUInt64)(
503  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
504  const GUID* in_guidPlatform,
505  const char * in_pszPropertyName,
506  uint64_t in_propertyValue
507  );
508 
509  /**
510  * \brief Modifies a property to a 32-bit unsigned integer value. (Future use)
511  *
512  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
513  * \c in_guidPlatform platform.
514  *
515  * \akwarning
516  * The plug-in XML definition file doesn't currently provide a \c uint32 value type.
517  * \endakwarning
518  *
519  * \aknote
520  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
521  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
522  *
523  * More than one platform will be affected if the property is linked
524  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
525  * \endaknote
526  *
527  * \sa
528  * - \ref wwiseplugin_bank
529  *
530  * \param[in] in_this Current instance of this interface.
531  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
532  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
533  * \param[out] in_propertyValue The new value of the property.
534  * \return true if successful.
535  */
536  bool(*SetValueUInt32)(
537  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
538  const GUID* in_guidPlatform,
539  const char * in_pszPropertyName,
540  uint32_t in_propertyValue
541  );
542 
543  /**
544  * \brief Modifies a property to a 16-bit unsigned integer value. (Future use)
545  *
546  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
547  * \c in_guidPlatform platform.
548  *
549  * \akwarning
550  * The plug-in XML definition file doesn't currently provide a \c uint16 value type.
551  * \endakwarning
552  *
553  * \aknote
554  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
555  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
556  *
557  * More than one platform will be affected if the property is linked
558  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
559  * \endaknote
560  *
561  * \sa
562  * - \ref wwiseplugin_bank
563  *
564  * \param[in] in_this Current instance of this interface.
565  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
566  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
567  * \param[out] in_propertyValue The new value of the property.
568  * \return true if successful.
569  */
570  bool(*SetValueUInt16)(
571  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
572  const GUID* in_guidPlatform,
573  const char * in_pszPropertyName,
574  uint16_t in_propertyValue
575  );
576 
577  /**
578  * \brief Modifies a property to an 8-bit unsigned integer value. (Future use)
579  *
580  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
581  * \c in_guidPlatform platform.
582  *
583  * \akwarning
584  * The plug-in XML definition file doesn't currently provide a \c uint8 value type.
585  * \endakwarning
586  *
587  * \aknote
588  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
589  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
590  *
591  * More than one platform will be affected if the property is linked
592  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
593  * \endaknote
594  *
595  * \sa
596  * - \ref wwiseplugin_bank
597  *
598  * \param[in] in_this Current instance of this interface.
599  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
600  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
601  * \param[out] in_propertyValue The new value of the property.
602  * \return true if successful.
603  */
604  bool(*SetValueUInt8)(
605  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
606  const GUID* in_guidPlatform,
607  const char * in_pszPropertyName,
608  uint8_t in_propertyValue
609  );
610 
611  /**
612  * \brief Modifies a property to a 64-bit floating point value.
613  *
614  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
615  * \c in_guidPlatform platform.
616  *
617  * The plug-in XML definition file should define this property as a \c Real64 in order to use
618  * this method.
619  *
620  * \aknote
621  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
622  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
623  *
624  * More than one platform will be affected if the property is linked
625  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
626  * \endaknote
627  *
628  * \sa
629  * - \ref wwiseplugin_bank
630  *
631  * \param[in] in_this Current instance of this interface.
632  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
633  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
634  * \param[out] in_propertyValue The new value of the property.
635  * \return true if successful.
636  */
637  bool(*SetValueReal64)(
638  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
639  const GUID* in_guidPlatform,
640  const char * in_pszPropertyName,
641  double in_propertyValue
642  );
643 
644  /**
645  * \brief Modifies a property to a 32-bit floating point value.
646  *
647  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
648  * \c in_guidPlatform platform.
649  *
650  * The plug-in XML definition file should define this property as a \c Real32 in order to use
651  * this method.
652  *
653  * \aknote
654  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
655  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
656  *
657  * More than one platform will be affected if the property is linked
658  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
659  * \endaknote
660  *
661  * \sa
662  * - \ref wwiseplugin_bank
663  *
664  * \param[in] in_this Current instance of this interface.
665  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
666  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
667  * \param[out] in_propertyValue The new value of the property.
668  * \return true if successful.
669  */
670  bool(*SetValueReal32)(
671  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
672  const GUID* in_guidPlatform,
673  const char * in_pszPropertyName,
674  float in_propertyValue
675  );
676 
677  /**
678  * \brief Modifies a property to a boolean value.
679  *
680  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
681  * \c in_guidPlatform platform.
682  *
683  * The plug-in XML definition file should define this property as a \c bool in order to use
684  * this method.
685  *
686  * \aknote
687  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
688  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
689  *
690  * More than one platform will be affected if the property is linked
691  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
692  * \endaknote
693  *
694  * \sa
695  * - \ref wwiseplugin_bank
696  *
697  * \param[in] in_this Current instance of this interface.
698  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
699  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
700  * \param[out] in_propertyValue The new value of the property.
701  * \return true if successful.
702  */
703  bool(*SetValueBool)(
704  struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
705  const GUID* in_guidPlatform,
706  const char * in_pszPropertyName,
707  bool in_propertyValue
708  );
709 
710  /**
711  * \brief Retrieves the string value of a specific property.
712  *
713  * The plug-in XML definition file should define this property as a \c string in order to use
714  * this method.
715  *
716  * \aknote
717  * The returned pointer is provided by Authoring, and contains a TLS copy of the property
718  * value string. It is guaranteed to be valid until the next Host function call. If you
719  * wish to retain this string, you should make a copy at the earliest convenience.
720  * \endaknote
721  *
722  * \sa
723  * - \ref wwiseplugin_bank
724  *
725  * \param[in] in_this Current instance of this interface.
726  * \param[in] in_guidPlatform The unique ID of the queried platform.
727  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
728  * \param[out] out_propertyValue The returned value of the property.
729  * The buffer is owned by Authoring and is valid until the next API call.
730  * \return true if successful.
731  */
732  bool(*GetValueString)(
733  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
734  const GUID* in_guidPlatform,
735  const char * in_pszPropertyName,
736  const char** out_propertyValue
737  );
738 
739  /**
740  * \brief Retrieves the 64-bit signed integer value of a specific property.
741  *
742  * The plug-in XML definition file should define this property as a \c int64 in order to use
743  * this method.
744  *
745  * \sa
746  * - \ref wwiseplugin_bank
747  *
748  * \param[in] in_this Current instance of this interface.
749  * \param[in] in_guidPlatform The unique ID of the queried platform.
750  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
751  * \param[out] out_propertyValue The returned value of the property.
752  * \return true if successful.
753  */
754  bool(*GetValueInt64)(
755  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
756  const GUID* in_guidPlatform,
757  const char * in_pszPropertyName,
758  int64_t* out_propertyValue
759  );
760 
761  /**
762  * \brief Retrieves the 32-bit signed integer value of a specific property.
763  *
764  * The plug-in XML definition file should define this property as a \c int32 in order to use
765  * this method.
766  *
767  * \sa
768  * - \ref wwiseplugin_bank
769  *
770  * \param[in] in_this Current instance of this interface.
771  * \param[in] in_guidPlatform The unique ID of the queried platform.
772  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
773  * \param[out] out_propertyValue The returned value of the property.
774  * \return true if successful.
775  */
776  bool(*GetValueInt32)(
777  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
778  const GUID* in_guidPlatform,
779  const char * in_pszPropertyName,
780  int32_t* out_propertyValue
781  );
782 
783  /**
784  * \brief Retrieves the 16-bit signed integer value of a specific property.
785  *
786  * The plug-in XML definition file should define this property as a \c int16 in order to use
787  * this method.
788  *
789  * \sa
790  * - \ref wwiseplugin_bank
791  *
792  * \param[in] in_this Current instance of this interface.
793  * \param[in] in_guidPlatform The unique ID of the queried platform.
794  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
795  * \param[out] out_propertyValue The returned value of the property.
796  * \return true if successful.
797  */
798  bool(*GetValueInt16)(
799  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
800  const GUID* in_guidPlatform,
801  const char * in_pszPropertyName,
802  int16_t* out_propertyValue
803  );
804 
805  /**
806  * \brief Retrieves the 8-bit signed integer value of a specific property. (Future use)
807  *
808  * \akwarning
809  * The plug-in XML definition file doesn't currently provide a \c int8 value type.
810  * \endakwarning
811  *
812  * \sa
813  * - \ref wwiseplugin_bank
814  *
815  * \param[in] in_this Current instance of this interface.
816  * \param[in] in_guidPlatform The unique ID of the queried platform.
817  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
818  * \param[out] out_propertyValue The returned value of the property.
819  * \return true if successful.
820  */
821  bool(*GetValueInt8)(
822  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
823  const GUID* in_guidPlatform,
824  const char * in_pszPropertyName,
825  int8_t* out_propertyValue
826  );
827 
828  /**
829  * \brief Retrieves the 64-bit unsigned integer value of a specific property. (Future use)
830  *
831  * \akwarning
832  * The plug-in XML definition file doesn't currently provide a \c uint64 value type.
833  * \endakwarning
834  *
835  * \sa
836  * - \ref wwiseplugin_bank
837  *
838  * \param[in] in_this Current instance of this interface.
839  * \param[in] in_guidPlatform The unique ID of the queried platform.
840  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
841  * \param[out] out_propertyValue The returned value of the property.
842  * \return true if successful.
843  */
844  bool(*GetValueUInt64)(
845  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
846  const GUID* in_guidPlatform,
847  const char * in_pszPropertyName,
848  uint64_t* out_propertyValue
849  );
850 
851  /**
852  * \brief Retrieves the 32-bit unsigned integer value of a specific property. (Future use)
853  *
854  * \akwarning
855  * The plug-in XML definition file doesn't currently provide a \c uint32 value type.
856  * \endakwarning
857  *
858  * \sa
859  * - \ref wwiseplugin_bank
860  *
861  * \param[in] in_this Current instance of this interface.
862  * \param[in] in_guidPlatform The unique ID of the queried platform.
863  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
864  * \param[out] out_propertyValue The returned value of the property.
865  * \return true if successful.
866  */
867  bool(*GetValueUInt32)(
868  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
869  const GUID* in_guidPlatform,
870  const char * in_pszPropertyName,
871  uint32_t* out_propertyValue
872  );
873 
874  /**
875  * \brief Retrieves the 16-bit unsigned integer value of a specific property. (Future use)
876  *
877  * \akwarning
878  * The plug-in XML definition file doesn't currently provide a \c uint16 value type.
879  * \endakwarning
880  *
881  * \sa
882  * - \ref wwiseplugin_bank
883  *
884  * \param[in] in_this Current instance of this interface.
885  * \param[in] in_guidPlatform The unique ID of the queried platform.
886  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
887  * \param[out] out_propertyValue The returned value of the property.
888  * \return true if successful.
889  */
890  bool(*GetValueUInt16)(
891  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
892  const GUID* in_guidPlatform,
893  const char * in_pszPropertyName,
894  uint16_t* out_propertyValue
895  );
896 
897  /**
898  * \brief Retrieves the 8-bit unsigned integer value of a specific property. (Future use)
899  *
900  * \akwarning
901  * The plug-in XML definition file doesn't currently provide a \c uint8 value type.
902  * \endakwarning
903  *
904  * \sa
905  * - \ref wwiseplugin_bank
906  *
907  * \param[in] in_this Current instance of this interface.
908  * \param[in] in_guidPlatform The unique ID of the queried platform.
909  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
910  * \param[out] out_propertyValue The returned value of the property.
911  * \return true if successful.
912  */
913  bool(*GetValueUInt8)(
914  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
915  const GUID* in_guidPlatform,
916  const char * in_pszPropertyName,
917  uint8_t* out_propertyValue
918  );
919 
920  /**
921  * \brief Retrieves the 64-bit floating point value of a specific property.
922  *
923  * The plug-in XML definition file should define this property as a \c Real64 in order to use
924  * this method.
925  *
926  * \sa
927  * - \ref wwiseplugin_bank
928  *
929  * \param[in] in_this Current instance of this interface.
930  * \param[in] in_guidPlatform The unique ID of the queried platform.
931  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
932  * \param[out] out_propertyValue The returned value of the property.
933  * \return true if successful.
934  */
935  bool(*GetValueReal64)(
936  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
937  const GUID* in_guidPlatform,
938  const char * in_pszPropertyName,
939  double* out_propertyValue
940  );
941 
942  /**
943  * \brief Retrieves the 32-bit floating point value of a specific property.
944  *
945  * The plug-in XML definition file should define this property as a \c Real32 in order to use
946  * this method.
947  *
948  * \sa
949  * - \ref wwiseplugin_bank
950  *
951  * \param[in] in_this Current instance of this interface.
952  * \param[in] in_guidPlatform The unique ID of the queried platform.
953  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
954  * \param[out] out_propertyValue The returned value of the property.
955  * \return true if successful.
956  */
957  bool(*GetValueReal32)(
958  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
959  const GUID* in_guidPlatform,
960  const char * in_pszPropertyName,
961  float* out_propertyValue
962  );
963 
964  /**
965  * \brief Retrieves the boolean value of a specific property.
966  *
967  * The plug-in XML definition file should define this property as a \c bool in order to use
968  * this method.
969  *
970  * \sa
971  * - \ref wwiseplugin_bank
972  *
973  * \param[in] in_this Current instance of this interface.
974  * \param[in] in_guidPlatform The unique ID of the queried platform.
975  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
976  * \param[out] out_propertyValue The returned value of the property.
977  * \return true if successful.
978  */
979  bool(*GetValueBool)(
980  const struct ak_wwise_plugin_host_property_set_instance_v1* in_this,
981  const GUID* in_guidPlatform,
982  const char * in_pszPropertyName,
983  bool* out_propertyValue
984  );
985 };
986 
987 
988 struct ak_wwise_plugin_notifications_property_set_v1
989 #ifdef __cplusplus
990  : public ak_wwise_plugin_base_interface
991 #endif
992 {
993 #ifndef __cplusplus
994  ak_wwise_plugin_base_interface m_baseInterface;
995 #endif
996 
997 #ifdef __cplusplus
998  /// Base instance type for receiving notifications on property set's changes.
999  using Instance = ak_wwise_plugin_notifications_property_set_instance_v1;
1000 
1001  ak_wwise_plugin_notifications_property_set_v1() :
1002  ak_wwise_plugin_base_interface(AK_WWISE_PLUGIN_INTERFACE_TYPE_NOTIFICATIONS_PROPERTY_SET, 1)
1003  {}
1004 #endif
1005 
1006  /**
1007  * \brief This function is called by Wwise when a plug-in property changes.
1008  *
1009  * For example, data can change through interaction with a UI control bound to a property,
1010  * or through undo/redo operations.
1011  *
1012  * This function is not called on the Object Store or any inner property sets.
1013  *
1014  * \sa
1015  * - \ref wwiseplugin_propertyset_notification
1016  *
1017  * \param[in] in_this Current instance of this interface.
1018  * \param[in] in_guidPlatform The unique ID of the queried platform.
1019  * \param[in] in_pszPropertyName The name of the affected property.
1020  */
1021  void(*NotifyPropertyChanged)(
1022  struct ak_wwise_plugin_notifications_property_set_instance_v1* in_this,
1023  const GUID* in_guidPlatform,
1024  const char * in_pszPropertyName
1025  );
1026 };
1027 
1028 
1029 #define AK_WWISE_PLUGIN_HOST_PROPERTY_SET_V1_ID() \
1030  AK_WWISE_PLUGIN_BASE_INTERFACE_FROM_ID(AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_PROPERTY_SET, 1)
1031 #define AK_WWISE_PLUGIN_HOST_PROPERTY_SET_V1_CTOR() \
1032 { \
1033  .m_baseInterface = AK_WWISE_PLUGIN_HOST_PROPERTY_SET_V1_ID() \
1034 }
1035 
1036 #define AK_WWISE_PLUGIN_NOTIFICATIONS_PROPERTY_SET_V1_ID() \
1037  AK_WWISE_PLUGIN_BASE_INTERFACE_FROM_ID(AK_WWISE_PLUGIN_INTERFACE_TYPE_NOTIFICATIONS_PROPERTY_SET, 1)
1038 #define AK_WWISE_PLUGIN_NOTIFICATIONS_PROPERTY_SET_V1_CTOR(/* ak_wwise_plugin_info* */ in_pluginInfo, /* void* */ in_data) \
1039 { \
1040  .m_baseInterface = AK_WWISE_PLUGIN_BASE_INTERFACE_CTOR(AK_WWISE_PLUGIN_NOTIFICATIONS_PROPERTY_SET_V1_ID(), in_pluginInfo, in_data) \
1041 }
1042 
1043 
1044 #ifdef __cplusplus
1045 namespace AK::Wwise::Plugin
1046 {
1047  namespace V1
1048  {
1049  using CHostPropertySet = ak_wwise_plugin_host_property_set_v1;
1050 
1051  /// \copydoc ak_wwise_plugin_host_property_set_v1
1052  class PropertySet : public CBaseInstanceGlue<CHostPropertySet>
1053  {
1054  public:
1055  using Interface = CHostPropertySet;
1056 
1057  /**
1058  * \brief The interface type, as requested by this plug-in.
1059  */
1060  enum : InterfaceTypeValue
1061  {
1062  /**
1063  * \brief The interface type, as requested by this plug-in.
1064  */
1065  k_interfaceType = AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_PROPERTY_SET
1066  };
1067  /**
1068  * \brief The interface version, as requested by this plug-in.
1069  */
1070  enum : InterfaceVersion
1071  {
1072  /**
1073  * \brief The interface version, as requested by this plug-in.
1074  */
1075  k_interfaceVersion = 1
1076  };
1077 
1078  /**
1079  * \deprecated
1080  * \brief Retrieves the value of a specific property as a variant.
1081  *
1082  * \akwarning
1083  * This is a semi-private function. You should use the typed GetValue methods instead.
1084  *
1085  * \ref GetValueString, \ref GetValueInt64, \ref GetValueInt32, \ref GetValueInt16,
1086  * \ref GetValueInt8, \ref GetValueUInt64, \ref GetValueUInt32, \ref GetValueUInt16,
1087  * \ref GetValueUInt8, \ref GetValueReal64 \ref GetValueReal32, \ref GetValueBool
1088  *
1089  * The function can still be useful if you want to handle parameters as a black box, getting a
1090  * value without knowing the type, and then setting that value elsewhere.
1091  * \endakwarning
1092  *
1093  * \sa
1094  * - \ref wwiseplugin_bank
1095  *
1096  * \param[in] in_guidPlatform The unique ID of the queried platform.
1097  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1098  * \param[out] out_varProperty The returned value of the property.
1099  * \return true if successful.
1100  */
1101  inline bool GetValue(
1102  const GUID & in_guidPlatform,
1103  const char * in_pszPropertyName,
1104  AK::WwiseAuthoringAPI::AkVariantBase& out_varProperty
1105  ) const
1106  {
1107  return MKBOOL(g_cinterface->GetValue(this, &in_guidPlatform, in_pszPropertyName, &out_varProperty));
1108  }
1109 
1110  /**
1111  * \deprecated
1112  * \brief Modifies the value of a specific property as a variant.
1113  *
1114  * Updates the property \c in_pszPropertyName to contain \c in_varProperty under the
1115  * \c in_guidPlatform platform.
1116  *
1117  * The property type, as contained by \c in_varProperty, should be equal to the
1118  * type as defined in the plug-in XML definition file.
1119  *
1120  * \aknote
1121  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
1122  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
1123  *
1124  * More than one platform will be affected if the property is linked
1125  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
1126  * \endaknote
1127  *
1128  * \akwarning
1129  * This is a semi-private function. You should use the typed SetValue methods instead.
1130  *
1131  * \ref SetValueString, \ref SetValueInt64, \ref SetValueInt32, \ref SetValueInt16,
1132  * \ref SetValueInt8, \ref SetValueUInt64, \ref SetValueUInt32, \ref SetValueUInt16,
1133  * \ref SetValueUInt8, \ref SetValueReal64 \ref SetValueReal32, \ref SetValueBool
1134  *
1135  * The function can still be useful if you want to handle parameters as a black box, getting a
1136  * value without knowing the type, and then setting that value elsewhere.
1137  * \endakwarning
1138  *
1139  * \sa
1140  * - \ref wwiseplugin_bank
1141  *
1142  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1143  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1144  * \param[out] in_varProperty The new value of the property.
1145  * \return true if successful.
1146  */
1147  inline bool SetValue(
1148  const GUID & in_guidPlatform,
1149  const char * in_pszPropertyName,
1150  const AK::WwiseAuthoringAPI::AkVariantBase& in_varProperty
1151  )
1152  {
1153  return MKBOOL(g_cinterface->SetValue(this, &in_guidPlatform, in_pszPropertyName, &in_varProperty));
1154  }
1155 
1156  /**
1157  * \brief Returns true if the specified property exists.
1158  *
1159  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to check.
1160  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1161  * \return true if property exists.
1162  */
1163  inline bool HasPropertyValue(
1164  const GUID & in_guidPlatform,
1165  const char * in_pszPropertyName
1166  ) const
1167  {
1168  return MKBOOL(g_cinterface->HasPropertyValue(this, &in_guidPlatform, in_pszPropertyName));
1169  }
1170 
1171  /**
1172  * \brief Get the RTPC binding status for the specified property.
1173  *
1174  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1175  * \return true if property is bound to an RTPC.
1176  */
1177  inline bool PropertyHasRTPC(
1178  const char * in_pszPropertyName
1179  ) const
1180  {
1181  return MKBOOL(g_cinterface->PropertyHasRTPC(this, in_pszPropertyName));
1182  }
1183 
1184  /**
1185  * \brief Returns whether the specified property is bound to a state object.
1186  *
1187  * \sa
1188  * - \ref concept_state
1189  *
1190  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1191  * \return true if property is bound to a state.
1192  */
1193  inline bool PropertyHasState(
1194  const char* in_pszPropertyName
1195  ) const
1196  {
1197  return MKBOOL(g_cinterface->PropertyHasState(this, in_pszPropertyName));
1198  }
1199 
1200  /**
1201  * \brief Returns whether the specified property has at least some linked platforms.
1202  *
1203  * By default, all platforms are linked.
1204  *
1205  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1206  * \return true if that particular property has some linked platforms.
1207  */
1208  inline bool PropertyHasLinked(
1209  const char* in_pszPropertyName
1210  ) const
1211  {
1212  return MKBOOL(g_cinterface->PropertyHasLinked(this, in_pszPropertyName));
1213  }
1214 
1215  /**
1216  * \brief Returns whether the specified property has at least some platforms that are not linked.
1217  *
1218  * By default, all platforms are linked.
1219  *
1220  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1221  * \return true if that particular property has some unlinked platforms.
1222  */
1223  inline bool PropertyHasUnlinked(
1224  const char* in_pszPropertyName
1225  ) const
1226  {
1227  return MKBOOL(g_cinterface->PropertyHasUnlinked(this, in_pszPropertyName));
1228  }
1229 
1230  /**
1231  * \brief Returns whether the specified property's platform is linked.
1232  *
1233  * By default, all platforms are linked.
1234  *
1235  * \param[in] in_guidPlatform The unique ID of the queried platform.
1236  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1237  * \return true if the specified property specifically has the specified platform linked.
1238  */
1239  inline bool PropertyPlatformIsLinked(
1240  const GUID& in_guidPlatform,
1241  const char* in_pszPropertyName
1242  ) const
1243  {
1244  return MKBOOL(g_cinterface->PropertyPlatformIsLinked(this, &in_guidPlatform, in_pszPropertyName));
1245  }
1246 
1247  /**
1248  * \brief Returns the internal unique identifier of the corresponding object.
1249  *
1250  * For the plug-in property set, this is equivalent to the ID field in the project files.
1251  *
1252  * For inner property sets, as defined in Object Stores, that value is dynamic and only valid for
1253  * this session.
1254  *
1255  * \aknote
1256  * This value is provided mostly for information during the development process.
1257  *
1258  * The ID might change on Undo or Redo operations.
1259  * \endaknote
1260  *
1261  * \return GUID of the corresponding object.
1262  */
1263  inline const GUID* GetID() const
1264  {
1265  return g_cinterface->GetID(this);
1266  }
1267 
1268  /**
1269  * \brief Retrieves the type of a specific property.
1270  *
1271  * The return value can contain AK::WwiseAuthoringAPI::AkVariantTypeBase
1272  * enumeration values.
1273  *
1274  * \param[in] in_guidPlatform The unique ID of the queried platform.
1275  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1276  * \return A AK::WwiseAuthoringAPI::AkVariantTypeBase value.
1277  */
1278  inline int GetType(
1279  const GUID& in_guidPlatform,
1280  const char* in_pszPropertyName
1281  ) const
1282  {
1283  return g_cinterface->GetType(this, &in_guidPlatform, in_pszPropertyName);
1284  }
1285 
1286  /**
1287  * \brief Resets a property value to its default.
1288  *
1289  * This is different than setting the value to the default value. Once saved,
1290  * this property set value line will disappear from the project file.
1291  *
1292  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1293  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1294  * \return true if successful.
1295  */
1296  inline bool ClearValue(
1297  const GUID& in_guidPlatform,
1298  const char* in_pszPropertyName
1299  )
1300  {
1301  return MKBOOL(g_cinterface->ClearValue(this, &in_guidPlatform, in_pszPropertyName));
1302  }
1303 
1304  /**
1305  * \brief Modifies a property to a string value.
1306  *
1307  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
1308  * \c in_guidPlatform platform.
1309  *
1310  * The plug-in XML definition file should define this property as a \c string in order to use
1311  * this method.
1312  *
1313  * \aknote
1314  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
1315  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
1316  *
1317  * More than one platform will be affected if the property is linked
1318  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
1319  * \endaknote
1320  *
1321  * \sa
1322  * - \ref wwiseplugin_bank
1323  *
1324  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1325  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1326  * \param[out] in_propertyValue The new value of the property.
1327  * \return true if successful.
1328  */
1329  inline bool SetValueString(
1330  const GUID & in_guidPlatform,
1331  const char * in_pszPropertyName,
1332  const char * in_propertyValue
1333  )
1334  {
1335  return MKBOOL(g_cinterface->SetValueString(this, &in_guidPlatform, in_pszPropertyName, in_propertyValue));
1336  }
1337 
1338  /**
1339  * \brief Modifies a property to a 64-bit signed integer value.
1340  *
1341  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
1342  * \c in_guidPlatform platform.
1343  *
1344  * The plug-in XML definition file should define this property as a \c int64 in order to use
1345  * this method.
1346  *
1347  * \aknote
1348  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
1349  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
1350  *
1351  * More than one platform will be affected if the property is linked
1352  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
1353  * \endaknote
1354  *
1355  * \sa
1356  * - \ref wwiseplugin_bank
1357  *
1358  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1359  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1360  * \param[out] in_propertyValue The new value of the property.
1361  * \return true if successful.
1362  */
1363  inline bool SetValueInt64(
1364  const GUID & in_guidPlatform,
1365  const char * in_pszPropertyName,
1366  int64_t in_propertyValue
1367  )
1368  {
1369  return MKBOOL(g_cinterface->SetValueInt64(this, &in_guidPlatform, in_pszPropertyName, in_propertyValue));
1370  }
1371 
1372  /**
1373  * \brief Modifies a property to a 32-bit signed integer value.
1374  *
1375  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
1376  * \c in_guidPlatform platform.
1377  *
1378  * The plug-in XML definition file should define this property as a \c int32 in order to use
1379  * this method.
1380  *
1381  * \aknote
1382  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
1383  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
1384  *
1385  * More than one platform will be affected if the property is linked
1386  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
1387  * \endaknote
1388  *
1389  * \sa
1390  * - \ref wwiseplugin_bank
1391  *
1392  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1393  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1394  * \param[out] in_propertyValue The new value of the property.
1395  * \return true if successful.
1396  */
1397  inline bool SetValueInt32(
1398  const GUID & in_guidPlatform,
1399  const char * in_pszPropertyName,
1400  int32_t in_propertyValue
1401  )
1402  {
1403  return MKBOOL(g_cinterface->SetValueInt32(this, &in_guidPlatform, in_pszPropertyName, in_propertyValue));
1404  }
1405 
1406  /**
1407  * \brief Modifies a property to a 16-bit signed integer value.
1408  *
1409  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
1410  * \c in_guidPlatform platform.
1411  *
1412  * The plug-in XML definition file should define this property as a \c int16 in order to use
1413  * this method.
1414  *
1415  * \aknote
1416  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
1417  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
1418  *
1419  * More than one platform will be affected if the property is linked
1420  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
1421  * \endaknote
1422  *
1423  * \sa
1424  * - \ref wwiseplugin_bank
1425  *
1426  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1427  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1428  * \param[out] in_propertyValue The new value of the property.
1429  * \return true if successful.
1430  */
1431  inline bool SetValueInt16(
1432  const GUID & in_guidPlatform,
1433  const char * in_pszPropertyName,
1434  int16_t in_propertyValue
1435  )
1436  {
1437  return MKBOOL(g_cinterface->SetValueInt16(this, &in_guidPlatform, in_pszPropertyName, in_propertyValue));
1438  }
1439 
1440  /**
1441  * \brief Modifies a property to an 8-bit signed integer value. (Future use)
1442  *
1443  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
1444  * \c in_guidPlatform platform.
1445  *
1446  * \akwarning
1447  * The plug-in XML definition file doesn't currently provide a \c int8 value type.
1448  * \endakwarning
1449  *
1450  * \aknote
1451  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
1452  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
1453  *
1454  * More than one platform will be affected if the property is linked
1455  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
1456  * \endaknote
1457  *
1458  * \sa
1459  * - \ref wwiseplugin_bank
1460  *
1461  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1462  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1463  * \param[out] in_propertyValue The new value of the property.
1464  * \return true if successful.
1465  */
1466  inline bool SetValueInt8(
1467  const GUID & in_guidPlatform,
1468  const char * in_pszPropertyName,
1469  int8_t in_propertyValue
1470  )
1471  {
1472  return MKBOOL(g_cinterface->SetValueInt8(this, &in_guidPlatform, in_pszPropertyName, in_propertyValue));
1473  }
1474 
1475  /**
1476  * \brief Modifies a property to a 64-bit unsigned integer value. (Future use)
1477  *
1478  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
1479  * \c in_guidPlatform platform.
1480  *
1481  * \akwarning
1482  * The plug-in XML definition file doesn't currently provide a \c uint64 value type.
1483  * \endakwarning
1484  *
1485  * \aknote
1486  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
1487  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
1488  *
1489  * More than one platform will be affected if the property is linked
1490  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
1491  * \endaknote
1492  *
1493  * \sa
1494  * - \ref wwiseplugin_bank
1495  *
1496  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1497  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1498  * \param[out] in_propertyValue The new value of the property.
1499  * \return true if successful.
1500  */
1501  inline bool SetValueUInt64(
1502  const GUID & in_guidPlatform,
1503  const char * in_pszPropertyName,
1504  uint64_t in_propertyValue
1505  )
1506  {
1507  return MKBOOL(g_cinterface->SetValueUInt64(this, &in_guidPlatform, in_pszPropertyName, in_propertyValue));
1508  }
1509 
1510  /**
1511  * \brief Modifies a property to a 32-bit unsigned integer value. (Future use)
1512  *
1513  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
1514  * \c in_guidPlatform platform.
1515  *
1516  * \akwarning
1517  * The plug-in XML definition file doesn't currently provide a \c uint32 value type.
1518  * \endakwarning
1519  *
1520  * \aknote
1521  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
1522  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
1523  *
1524  * More than one platform will be affected if the property is linked
1525  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
1526  * \endaknote
1527  *
1528  * \sa
1529  * - \ref wwiseplugin_bank
1530  *
1531  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1532  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1533  * \param[out] in_propertyValue The new value of the property.
1534  * \return true if successful.
1535  */
1536  inline bool SetValueUInt32(
1537  const GUID & in_guidPlatform,
1538  const char * in_pszPropertyName,
1539  uint32_t in_propertyValue
1540  )
1541  {
1542  return MKBOOL(g_cinterface->SetValueUInt32(this, &in_guidPlatform, in_pszPropertyName, in_propertyValue));
1543  }
1544 
1545  /**
1546  * \brief Modifies a property to a 16-bit unsigned integer value. (Future use)
1547  *
1548  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
1549  * \c in_guidPlatform platform.
1550  *
1551  * \akwarning
1552  * The plug-in XML definition file doesn't currently provide a \c uint16 value type.
1553  * \endakwarning
1554  *
1555  * \aknote
1556  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
1557  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
1558  *
1559  * More than one platform will be affected if the property is linked
1560  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
1561  * \endaknote
1562  *
1563  * \sa
1564  * - \ref wwiseplugin_bank
1565  *
1566  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1567  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1568  * \param[out] in_propertyValue The new value of the property.
1569  * \return true if successful.
1570  */
1571  inline bool SetValueUInt16(
1572  const GUID & in_guidPlatform,
1573  const char * in_pszPropertyName,
1574  uint16_t in_propertyValue
1575  )
1576  {
1577  return MKBOOL(g_cinterface->SetValueUInt16(this, &in_guidPlatform, in_pszPropertyName, in_propertyValue));
1578  }
1579 
1580  /**
1581  * \brief Modifies a property to an 8-bit unsigned integer value. (Future use)
1582  *
1583  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
1584  * \c in_guidPlatform platform.
1585  *
1586  * \akwarning
1587  * The plug-in XML definition file doesn't currently provide a \c uint8 value type.
1588  * \endakwarning
1589  *
1590  * \aknote
1591  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
1592  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
1593  *
1594  * More than one platform will be affected if the property is linked
1595  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
1596  * \endaknote
1597  *
1598  * \sa
1599  * - \ref wwiseplugin_bank
1600  *
1601  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1602  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1603  * \param[out] in_propertyValue The new value of the property.
1604  * \return true if successful.
1605  */
1606  inline bool SetValueUInt8(
1607  const GUID & in_guidPlatform,
1608  const char * in_pszPropertyName,
1609  uint8_t in_propertyValue
1610  )
1611  {
1612  return MKBOOL(g_cinterface->SetValueUInt8(this, &in_guidPlatform, in_pszPropertyName, in_propertyValue));
1613  }
1614 
1615  /**
1616  * \brief Modifies a property to a 64-bit floating point value.
1617  *
1618  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
1619  * \c in_guidPlatform platform.
1620  *
1621  * The plug-in XML definition file should define this property as a \c Real64 in order to use
1622  * this method.
1623  *
1624  * \aknote
1625  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
1626  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
1627  *
1628  * More than one platform will be affected if the property is linked
1629  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
1630  * \endaknote
1631  *
1632  * \sa
1633  * - \ref wwiseplugin_bank
1634  *
1635  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1636  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1637  * \param[out] in_propertyValue The new value of the property.
1638  * \return true if successful.
1639  */
1640  inline bool SetValueReal64(
1641  const GUID & in_guidPlatform,
1642  const char * in_pszPropertyName,
1643  double in_propertyValue
1644  )
1645  {
1646  return MKBOOL(g_cinterface->SetValueReal64(this, &in_guidPlatform, in_pszPropertyName, in_propertyValue));
1647  }
1648 
1649  /**
1650  * \brief Modifies a property to a 32-bit floating point value.
1651  *
1652  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
1653  * \c in_guidPlatform platform.
1654  *
1655  * The plug-in XML definition file should define this property as a \c Real32 in order to use
1656  * this method.
1657  *
1658  * \aknote
1659  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
1660  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
1661  *
1662  * More than one platform will be affected if the property is linked
1663  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
1664  * \endaknote
1665  *
1666  * \sa
1667  * - \ref wwiseplugin_bank
1668  *
1669  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1670  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1671  * \param[out] in_propertyValue The new value of the property.
1672  * \return true if successful.
1673  */
1674  inline bool SetValueReal32(
1675  const GUID & in_guidPlatform,
1676  const char * in_pszPropertyName,
1677  float in_propertyValue
1678  )
1679  {
1680  return MKBOOL(g_cinterface->SetValueReal32(this, &in_guidPlatform, in_pszPropertyName, in_propertyValue));
1681  }
1682 
1683  /**
1684  * \brief Modifies a property to a boolean value.
1685  *
1686  * Updates the property \c in_pszPropertyName to contain \c in_propertyValue under the
1687  * \c in_guidPlatform platform.
1688  *
1689  * The plug-in XML definition file should define this property as a \c bool in order to use
1690  * this method.
1691  *
1692  * \aknote
1693  * Your changes might be substantially altered or replaced if your property is bound to an RTPC
1694  * ( \ref PropertyHasRTPC ) or a State ( \ref PropertyHasState ).
1695  *
1696  * More than one platform will be affected if the property is linked
1697  * ( \ref PropertyPlatformIsLinked ); all platforms are linked by default.
1698  * \endaknote
1699  *
1700  * \sa
1701  * - \ref wwiseplugin_bank
1702  *
1703  * \param[in] in_guidPlatform The unique ID of the platform whose property you want to modify.
1704  * \param[in] in_pszPropertyName The name of the property to update, based on the XML definition file.
1705  * \param[out] in_propertyValue The new value of the property.
1706  * \return true if successful.
1707  */
1708  inline bool SetValueBool(
1709  const GUID & in_guidPlatform,
1710  const char * in_pszPropertyName,
1711  bool in_propertyValue
1712  )
1713  {
1714  return MKBOOL(g_cinterface->SetValueBool(this, &in_guidPlatform, in_pszPropertyName, in_propertyValue));
1715  }
1716 
1717  /**
1718  * \brief Retrieves the string value of a specific property.
1719  *
1720  * The plug-in XML definition file should define this property as a \c string in order to use
1721  * this method.
1722  *
1723  * \aknote
1724  * The returned pointer is provided by Authoring, and contains a TLS copy of the property
1725  * value string. It is guaranteed to be valid until the next Host function call. If you
1726  * wish to retain this string, you should make a copy at the earliest convenience.
1727  * \endaknote
1728  *
1729  * \sa
1730  * - \ref wwiseplugin_bank
1731  *
1732  * \param[in] in_guidPlatform The unique ID of the queried platform.
1733  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1734  * \param[out] out_propertyValue The returned value of the property.
1735  * The buffer is owned by Authoring and is valid until the next API call.
1736  * \return true if successful.
1737  */
1738  inline bool GetValueString(
1739  const GUID & in_guidPlatform,
1740  const char * in_pszPropertyName,
1741  const char*& out_propertyValue
1742  ) const
1743  {
1744  return MKBOOL(g_cinterface->GetValueString(this, &in_guidPlatform, in_pszPropertyName, &out_propertyValue));
1745  }
1746 
1747  /**
1748  * \brief Retrieves the 64-bit signed integer value of a specific property.
1749  *
1750  * The plug-in XML definition file should define this property as a \c int64 in order to use
1751  * this method.
1752  *
1753  * \sa
1754  * - \ref wwiseplugin_bank
1755  *
1756  * \param[in] in_guidPlatform The unique ID of the queried platform.
1757  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1758  * \param[out] out_propertyValue The returned value of the property.
1759  * \return true if successful.
1760  */
1761  inline bool GetValueInt64(
1762  const GUID & in_guidPlatform,
1763  const char * in_pszPropertyName,
1764  int64_t& out_propertyValue
1765  ) const
1766  {
1767  return MKBOOL(g_cinterface->GetValueInt64(this, &in_guidPlatform, in_pszPropertyName, &out_propertyValue));
1768  }
1769 
1770  /**
1771  * \brief Retrieves the 32-bit signed integer value of a specific property.
1772  *
1773  * The plug-in XML definition file should define this property as a \c int32 in order to use
1774  * this method.
1775  *
1776  * \sa
1777  * - \ref wwiseplugin_bank
1778  *
1779  * \param[in] in_guidPlatform The unique ID of the queried platform.
1780  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1781  * \param[out] out_propertyValue The returned value of the property.
1782  * \return true if successful.
1783  */
1784  inline bool GetValueInt32(
1785  const GUID & in_guidPlatform,
1786  const char * in_pszPropertyName,
1787  int32_t& out_propertyValue
1788  ) const
1789  {
1790  return MKBOOL(g_cinterface->GetValueInt32(this, &in_guidPlatform, in_pszPropertyName, &out_propertyValue));
1791  }
1792 
1793  /**
1794  * \brief Retrieves the 16-bit signed integer value of a specific property.
1795  *
1796  * The plug-in XML definition file should define this property as a \c int16 in order to use
1797  * this method.
1798  *
1799  * \sa
1800  * - \ref wwiseplugin_bank
1801  *
1802  * \param[in] in_guidPlatform The unique ID of the queried platform.
1803  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1804  * \param[out] out_propertyValue The returned value of the property.
1805  * \return true if successful.
1806  */
1807  inline bool GetValueInt16(
1808  const GUID & in_guidPlatform,
1809  const char * in_pszPropertyName,
1810  int16_t& out_propertyValue
1811  ) const
1812  {
1813  return MKBOOL(g_cinterface->GetValueInt16(this, &in_guidPlatform, in_pszPropertyName, &out_propertyValue));
1814  }
1815 
1816  /**
1817  * \brief Retrieves the 8-bit signed integer value of a specific property. (Future use)
1818  *
1819  * \akwarning
1820  * The plug-in XML definition file doesn't currently provide a \c int8 value type.
1821  * \endakwarning
1822  *
1823  * \sa
1824  * - \ref wwiseplugin_bank
1825  *
1826  * \param[in] in_guidPlatform The unique ID of the queried platform.
1827  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1828  * \param[out] out_propertyValue The returned value of the property.
1829  * \return true if successful.
1830  */
1831  inline bool GetValueInt8(
1832  const GUID & in_guidPlatform,
1833  const char * in_pszPropertyName,
1834  int8_t& out_propertyValue
1835  ) const
1836  {
1837  return MKBOOL(g_cinterface->GetValueInt8(this, &in_guidPlatform, in_pszPropertyName, &out_propertyValue));
1838  }
1839 
1840  /**
1841  * \brief Retrieves the 64-bit unsigned integer value of a specific property. (Future use)
1842  *
1843  * \akwarning
1844  * The plug-in XML definition file doesn't currently provide a \c uint64 value type.
1845  * \endakwarning
1846  *
1847  * \sa
1848  * - \ref wwiseplugin_bank
1849  *
1850  * \param[in] in_guidPlatform The unique ID of the queried platform.
1851  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1852  * \param[out] out_propertyValue The returned value of the property.
1853  * \return true if successful.
1854  */
1855  inline bool GetValueUInt64(
1856  const GUID & in_guidPlatform,
1857  const char * in_pszPropertyName,
1858  uint64_t& out_propertyValue
1859  ) const
1860  {
1861  return MKBOOL(g_cinterface->GetValueUInt64(this, &in_guidPlatform, in_pszPropertyName, &out_propertyValue));
1862  }
1863 
1864  /**
1865  * \brief Retrieves the 32-bit unsigned integer value of a specific property. (Future use)
1866  *
1867  * \akwarning
1868  * The plug-in XML definition file doesn't currently provide a \c uint32 value type.
1869  * \endakwarning
1870  *
1871  * \sa
1872  * - \ref wwiseplugin_bank
1873  *
1874  * \param[in] in_guidPlatform The unique ID of the queried platform.
1875  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1876  * \param[out] out_propertyValue The returned value of the property.
1877  * \return true if successful.
1878  */
1879  inline bool GetValueUInt32(
1880  const GUID & in_guidPlatform,
1881  const char * in_pszPropertyName,
1882  uint32_t& out_propertyValue
1883  ) const
1884  {
1885  return MKBOOL(g_cinterface->GetValueUInt32(this, &in_guidPlatform, in_pszPropertyName, &out_propertyValue));
1886  }
1887 
1888  /**
1889  * \brief Retrieves the 16-bit unsigned integer value of a specific property. (Future use)
1890  *
1891  * \akwarning
1892  * The plug-in XML definition file doesn't currently provide a \c uint16 value type.
1893  * \endakwarning
1894  *
1895  * \sa
1896  * - \ref wwiseplugin_bank
1897  *
1898  * \param[in] in_guidPlatform The unique ID of the queried platform.
1899  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1900  * \param[out] out_propertyValue The returned value of the property.
1901  * \return true if successful.
1902  */
1903  inline bool GetValueUInt16(
1904  const GUID & in_guidPlatform,
1905  const char * in_pszPropertyName,
1906  uint16_t& out_propertyValue
1907  ) const
1908  {
1909  return MKBOOL(g_cinterface->GetValueUInt16(this, &in_guidPlatform, in_pszPropertyName, &out_propertyValue));
1910  }
1911 
1912  /**
1913  * \brief Retrieves the 8-bit unsigned integer value of a specific property. (Future use)
1914  *
1915  * \akwarning
1916  * The plug-in XML definition file doesn't currently provide a \c uint8 value type.
1917  * \endakwarning
1918  *
1919  * \sa
1920  * - \ref wwiseplugin_bank
1921  *
1922  * \param[in] in_guidPlatform The unique ID of the queried platform.
1923  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1924  * \param[out] out_propertyValue The returned value of the property.
1925  * \return true if successful.
1926  */
1927  inline bool GetValueUInt8(
1928  const GUID & in_guidPlatform,
1929  const char * in_pszPropertyName,
1930  uint8_t& out_propertyValue
1931  ) const
1932  {
1933  return MKBOOL(g_cinterface->GetValueUInt8(this, &in_guidPlatform, in_pszPropertyName, &out_propertyValue));
1934  }
1935 
1936  /**
1937  * \brief Retrieves the 64-bit floating point value of a specific property.
1938  *
1939  * The plug-in XML definition file should define this property as a \c Real64 in order to use
1940  * this method.
1941  *
1942  * \sa
1943  * - \ref wwiseplugin_bank
1944  *
1945  * \param[in] in_guidPlatform The unique ID of the queried platform.
1946  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1947  * \param[out] out_propertyValue The returned value of the property.
1948  * \return true if successful.
1949  */
1950  inline bool GetValueReal64(
1951  const GUID & in_guidPlatform,
1952  const char * in_pszPropertyName,
1953  double& out_propertyValue
1954  ) const
1955  {
1956  return MKBOOL(g_cinterface->GetValueReal64(this, &in_guidPlatform, in_pszPropertyName, &out_propertyValue));
1957  }
1958 
1959  /**
1960  * \brief Retrieves the 32-bit floating point value of a specific property.
1961  *
1962  * The plug-in XML definition file should define this property as a \c Real32 in order to use
1963  * this method.
1964  *
1965  * \sa
1966  * - \ref wwiseplugin_bank
1967  *
1968  * \param[in] in_guidPlatform The unique ID of the queried platform.
1969  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1970  * \param[out] out_propertyValue The returned value of the property.
1971  * \return true if successful.
1972  */
1973  inline bool GetValueReal32(
1974  const GUID & in_guidPlatform,
1975  const char * in_pszPropertyName,
1976  float& out_propertyValue
1977  ) const
1978  {
1979  return MKBOOL(g_cinterface->GetValueReal32(this, &in_guidPlatform, in_pszPropertyName, &out_propertyValue));
1980  }
1981 
1982  /**
1983  * \brief Retrieves the boolean value of a specific property.
1984  *
1985  * The plug-in XML definition file should define this property as a \c bool in order to use
1986  * this method.
1987  *
1988  * \sa
1989  * - \ref wwiseplugin_bank
1990  *
1991  * \param[in] in_guidPlatform The unique ID of the queried platform.
1992  * \param[in] in_pszPropertyName The name of the queried property, based on the XML definition file.
1993  * \param[out] out_propertyValue The returned value of the property.
1994  * \return true if successful.
1995  */
1996  inline bool GetValueBool(
1997  const GUID & in_guidPlatform,
1998  const char * in_pszPropertyName,
1999  bool& out_propertyValue
2000  ) const
2001  {
2002  return MKBOOL(g_cinterface->GetValueBool(this, &in_guidPlatform, in_pszPropertyName, &out_propertyValue));
2003  }
2004 
2005  /**
2006  * \brief Retrieves the string value of a specific property and returns the value as a temporary pointer.
2007  *
2008  * This is a convenience for \ref GetValueString where the value is returned instead of
2009  * being set in a provided variable.
2010  *
2011  * The plug-in XML definition file should define this property as a \c string in order to use
2012  * this method.
2013  *
2014  * \aknote
2015  * The returned pointer is provided by Authoring, and contains a TLS copy of the property
2016  * value string. It is guaranteed to be valid until the next Host function call. If you
2017  * wish to retain this string, you should make a copy at the earliest convenience.
2018  * \endaknote
2019  *
2020  * \sa
2021  * - \ref wwiseplugin_bank
2022  *
2023  * \param in_guidPlatform The unique ID of the queried platform.
2024  * \param in_pszPropertyName The name of the queried property, based on the XML definition file.
2025  * \return The value of the property.
2026  */
2027  inline const char* GetString(
2028  const GUID & in_guidPlatform, ///< The unique ID of the queried platform
2029  const char * in_pszPropertyName ///< The name of the property
2030  ) const
2031  {
2032  const char* result;
2033  AKVERIFY(GetValueString(in_guidPlatform, in_pszPropertyName, result));
2034  return result;
2035  }
2036 
2037  /**
2038  * \brief Returns the 64-bit signed integer value of a specific property.
2039  *
2040  * This is a convenience for \ref GetValueInt64 where the value is returned instead of
2041  * being set in a provided variable.
2042  *
2043  * The plug-in XML definition file should define this property as a \c int64 in order to use
2044  * this method.
2045  *
2046  * \sa
2047  * - \ref wwiseplugin_bank
2048  *
2049  * \param in_guidPlatform The unique ID of the queried platform.
2050  * \param in_pszPropertyName The name of the queried property, based on the XML definition file.
2051  * \return The value of the property.
2052  */
2053  inline int64_t GetInt64(
2054  const GUID & in_guidPlatform, ///< The unique ID of the queried platform
2055  const char * in_pszPropertyName ///< The name of the property
2056  ) const
2057  {
2058  int64_t result;
2059  AKVERIFY(GetValueInt64(in_guidPlatform, in_pszPropertyName, result));
2060  return result;
2061  }
2062 
2063  /**
2064  * \brief Returns the 32-bit signed integer value of a specific property.
2065  *
2066  * This is a convenience for \ref GetValueInt32 where the value is returned instead of
2067  * being set in a provided variable.
2068  *
2069  * The plug-in XML definition file should define this property as a \c int32 in order to use
2070  * this method.
2071  *
2072  * \sa
2073  * - \ref wwiseplugin_bank
2074  *
2075  * \param in_guidPlatform The unique ID of the queried platform.
2076  * \param in_pszPropertyName The name of the queried property, based on the XML definition file.
2077  * \return The value of the property.
2078  */
2079  inline int32_t GetInt32(
2080  const GUID & in_guidPlatform, ///< The unique ID of the queried platform
2081  const char * in_pszPropertyName ///< The name of the property
2082  ) const
2083  {
2084  int32_t result;
2085  AKVERIFY(GetValueInt32(in_guidPlatform, in_pszPropertyName, result));
2086  return result;
2087  }
2088 
2089  /**
2090  * \brief Returns the 16-bit signed integer value of a specific property.
2091  *
2092  * This is a convenience for \ref GetValueInt16 where the value is returned instead of
2093  * being set in a provided variable.
2094  *
2095  * The plug-in XML definition file should define this property as a \c int16 in order to use
2096  * this method.
2097  *
2098  * \sa
2099  * - \ref wwiseplugin_bank
2100  *
2101  * \param in_guidPlatform The unique ID of the queried platform.
2102  * \param in_pszPropertyName The name of the queried property, based on the XML definition file.
2103  * \return The value of the property.
2104  */
2105  inline int16_t GetInt16(
2106  const GUID & in_guidPlatform, ///< The unique ID of the queried platform
2107  const char * in_pszPropertyName ///< The name of the property
2108  ) const
2109  {
2110  int16_t result;
2111  AKVERIFY(GetValueInt16(in_guidPlatform, in_pszPropertyName, result));
2112  return result;
2113  }
2114 
2115  /**
2116  * \brief Returns the 8-bit signed integer value of a specific property.
2117  *
2118  * This is a convenience for \ref GetValueInt8 where the value is returned instead of
2119  * being set in a provided variable.
2120  *
2121  * \akwarning
2122  * The plug-in XML definition file doesn't currently provide a \c int8 value type.
2123  * \endakwarning
2124  *
2125  * \sa
2126  * - \ref wwiseplugin_bank
2127  *
2128  * \param in_guidPlatform The unique ID of the queried platform.
2129  * \param in_pszPropertyName The name of the queried property, based on the XML definition file.
2130  * \return The value of the property.
2131  */
2132  inline int8_t GetInt8(
2133  const GUID & in_guidPlatform, ///< The unique ID of the queried platform
2134  const char * in_pszPropertyName ///< The name of the property
2135  ) const
2136  {
2137  int8_t result;
2138  AKVERIFY(GetValueInt8(in_guidPlatform, in_pszPropertyName, result));
2139  return result;
2140  }
2141 
2142  /**
2143  * \brief Returns the 64-bit unsigned integer value of a specific property.
2144  *
2145  * This is a convenience for \ref GetValueUInt64 where the value is returned instead of
2146  * being set in a provided variable.
2147  *
2148  * \akwarning
2149  * The plug-in XML definition file doesn't currently provide a \c uint64 value type.
2150  * \endakwarning
2151  *
2152  * \sa
2153  * - \ref wwiseplugin_bank
2154  *
2155  * \param in_guidPlatform The unique ID of the queried platform.
2156  * \param in_pszPropertyName The name of the queried property, based on the XML definition file.
2157  * \return The value of the property.
2158  */
2159  inline uint64_t GetUInt64(
2160  const GUID & in_guidPlatform, ///< The unique ID of the queried platform
2161  const char * in_pszPropertyName ///< The name of the property
2162  ) const
2163  {
2164  uint64_t result;
2165  AKVERIFY(GetValueUInt64(in_guidPlatform, in_pszPropertyName, result));
2166  return result;
2167  }
2168 
2169  /**
2170  * \brief Returns the 32-bit unsigned integer value of a specific property.
2171  *
2172  * This is a convenience for \ref GetValueUInt32 where the value is returned instead of
2173  * being set in a provided variable.
2174  *
2175  * \akwarning
2176  * The plug-in XML definition file doesn't currently provide a \c uint32 value type.
2177  * \endakwarning
2178  *
2179  * \sa
2180  * - \ref wwiseplugin_bank
2181  *
2182  * \param in_guidPlatform The unique ID of the queried platform.
2183  * \param in_pszPropertyName The name of the queried property, based on the XML definition file.
2184  * \return The value of the property.
2185  */
2186  inline uint32_t GetUInt32(
2187  const GUID & in_guidPlatform, ///< The unique ID of the queried platform
2188  const char * in_pszPropertyName ///< The name of the property
2189  ) const
2190  {
2191  uint32_t result;
2192  AKVERIFY(GetValueUInt32(in_guidPlatform, in_pszPropertyName, result));
2193  return result;
2194  }
2195 
2196  /**
2197  * \brief Returns the 16-bit unsigned integer value of a specific property.
2198  *
2199  * This is a convenience for \ref GetValueUInt16 where the value is returned instead of
2200  * being set in a provided variable.
2201  *
2202  * \akwarning
2203  * The plug-in XML definition file doesn't currently provide a \c uint16 value type.
2204  * \endakwarning
2205  *
2206  * \sa
2207  * - \ref wwiseplugin_bank
2208  *
2209  * \param in_guidPlatform The unique ID of the queried platform.
2210  * \param in_pszPropertyName The name of the queried property, based on the XML definition file.
2211  * \return The value of the property.
2212  */
2213  inline uint16_t GetUInt16(
2214  const GUID & in_guidPlatform, ///< The unique ID of the queried platform
2215  const char * in_pszPropertyName ///< The name of the property
2216  ) const
2217  {
2218  uint16_t result;
2219  AKVERIFY(GetValueUInt16(in_guidPlatform, in_pszPropertyName, result));
2220  return result;
2221  }
2222 
2223  /**
2224  * \brief Returns the 8-bit unsigned integer value of a specific property.
2225  *
2226  * This is a convenience for \ref GetValueUInt8 where the value is returned instead of
2227  * being set in a provided variable.
2228  *
2229  * \akwarning
2230  * The plug-in XML definition file doesn't currently provide a \c uint8 value type.
2231  * \endakwarning
2232  *
2233  * \sa
2234  * - \ref wwiseplugin_bank
2235  *
2236  * \param in_guidPlatform The unique ID of the queried platform.
2237  * \param in_pszPropertyName The name of the queried property, based on the XML definition file.
2238  * \return The value of the property.
2239  */
2240  inline uint8_t GetUInt8(
2241  const GUID & in_guidPlatform, ///< The unique ID of the queried platform
2242  const char * in_pszPropertyName ///< The name of the property
2243  ) const
2244  {
2245  uint8_t result;
2246  AKVERIFY(GetValueUInt8(in_guidPlatform, in_pszPropertyName, result));
2247  return result;
2248  }
2249 
2250  /**
2251  * \brief Returns the 64-bit floating point value of a specific property.
2252  *
2253  * This is a convenience for \ref GetValueReal64 where the value is returned instead of
2254  * being set in a provided variable.
2255  *
2256  * The plug-in XML definition file should define this property as a \c Real64 in order to use
2257  * this method.
2258  *
2259  * \sa
2260  * - \ref wwiseplugin_bank
2261  *
2262  * \param in_guidPlatform The unique ID of the queried platform.
2263  * \param in_pszPropertyName The name of the queried property, based on the XML definition file.
2264  * \return The value of the property.
2265  */
2266  inline double GetReal64(
2267  const GUID & in_guidPlatform, ///< The unique ID of the queried platform
2268  const char * in_pszPropertyName ///< The name of the property
2269  ) const
2270  {
2271  double result;
2272  AKVERIFY(GetValueReal64(in_guidPlatform, in_pszPropertyName, result));
2273  return result;
2274  }
2275 
2276  /**
2277  * \brief Returns the 32-bit floating point value of a specific property.
2278  *
2279  * This is a convenience for \ref GetValueReal32 where the value is returned instead of
2280  * being set in a provided variable.
2281  *
2282  * The plug-in XML definition file should define this property as a \c Real32 in order to use
2283  * this method.
2284  *
2285  * \sa
2286  * - \ref wwiseplugin_bank
2287  *
2288  * \param in_guidPlatform The unique ID of the queried platform.
2289  * \param in_pszPropertyName The name of the queried property, based on the XML definition file.
2290  * \return The value of the property.
2291  */
2292  inline float GetReal32(
2293  const GUID & in_guidPlatform, ///< The unique ID of the queried platform
2294  const char * in_pszPropertyName ///< The name of the property
2295  ) const
2296  {
2297  float result;
2298  AKVERIFY(GetValueReal32(in_guidPlatform, in_pszPropertyName, result));
2299  return result;
2300  }
2301 
2302  /**
2303  * \brief Returns the boolean value of a specific property.
2304  *
2305  * This is a convenience for \ref GetValueBool where the value is returned instead of
2306  * being set in a provided variable.
2307  *
2308  * The plug-in XML definition file should define this property as a \c bool in order to use
2309  * this method.
2310  *
2311  * \sa
2312  * - \ref wwiseplugin_bank
2313  *
2314  * \param in_guidPlatform The unique ID of the queried platform.
2315  * \param in_pszPropertyName The name of the queried property, based on the XML definition file.
2316  * \return The value of the property.
2317  */
2318  inline bool GetBool(
2319  const GUID & in_guidPlatform, ///< The unique ID of the queried platform
2320  const char * in_pszPropertyName ///< The name of the property
2321  ) const
2322  {
2323  bool result;
2324  AKVERIFY(GetValueBool(in_guidPlatform, in_pszPropertyName, result));
2325  return result;
2326  }
2327  };
2328 
2329  namespace Notifications
2330  {
2331  using CPropertySet_ = ak_wwise_plugin_notifications_property_set_v1;
2332 
2333  /// \copydoc ak_wwise_plugin_notifications_property_set_v1
2334  class PropertySet_ : public CPropertySet_::Instance
2335  {
2336  public:
2337  /**
2338  * \copydoc CPropertySet_::Instance
2339  */
2340  using Instance = CPropertySet_::Instance;
2341 
2342  /**
2343  * \brief The interface type, as provided by this plug-in.
2344  */
2345  enum : InterfaceTypeValue
2346  {
2347  /**
2348  * \brief The interface type, as provided by this plug-in.
2349  */
2350  k_interfaceType = AK_WWISE_PLUGIN_INTERFACE_TYPE_NOTIFICATIONS_PROPERTY_SET
2351  };
2352  /**
2353  * \brief The interface version, as provided by this plug-in.
2354  */
2355  enum : InterfaceVersion
2356  {
2357  /**
2358  * \brief The interface version, as provided by this plug-in.
2359  */
2360  k_interfaceVersion = 1
2361  };
2362 
2363  /**
2364  * \brief The C interface, fulfilled by your plug-in.
2365  */
2366  struct Interface : public CPropertySet_
2367  {
2368  using Instance = PropertySet_;
2369  Interface()
2370  {
2371  CPropertySet_::NotifyPropertyChanged = [](
2372  struct ak_wwise_plugin_notifications_property_set_instance_v1* in_this,
2373  const GUID* in_guidPlatform,
2374  const char* in_pszPropertyName)
2375  {
2376  static_cast<Instance*>(in_this)->NotifyPropertyChanged(
2377  *in_guidPlatform,
2378  in_pszPropertyName);
2379  };
2380  }
2381  };
2382 
2383  InterfacePtr GetInterfacePointer() {
2384  static Interface g_interface;
2385  return &g_interface;
2386  }
2387  CPropertySet_::Instance* GetInstancePointer() {
2388  return this;
2389  }
2390  const CPropertySet_::Instance* GetInstancePointer() const {
2391  return this;
2392  }
2393 
2394  PropertySet_() :
2395  CPropertySet_::Instance()
2396  {
2397  }
2398 
2399  virtual ~PropertySet_() {}
2400 
2401  /**
2402  * \brief This function is called by Wwise when a plug-in property changes.
2403  *
2404  * For example, data can change through interaction with a UI control bound to a property,
2405  * or through undo/redo operations.
2406  *
2407  * This function is not called on the Object Store or any inner property sets.
2408  *
2409  * \sa
2410  * - \ref wwiseplugin_propertyset_notification
2411  *
2412  * \param[in] in_guidPlatform The unique ID of the queried platform.
2413  * \param[in] in_pszPropertyName The name of the affected property.
2414  */
2415  virtual void NotifyPropertyChanged(
2416  const GUID& in_guidPlatform, ///< The unique ID of the queried platform
2417  const char* in_pszPropertyName ///< The name of the property
2418  ) {}
2419  };
2420  } // of namespace Notifications
2421 
2422  /**
2423  * \brief Requests a PropertySet interface, provided as m_propertySet variable.
2424  *
2425  * Deriving your plug-in class from RequestPropertySet will automatically request both PropertySet and
2426  * Notifications::PropertySet_ interfaces. From this point, you will be able to derive from the virtual
2427  * functions as defined in Notifications::PropertySet_, and access the host-provided functions in the
2428  * `m_propertySet` variable.
2429  *
2430  * This is also useful when you want to access inner property sets from the ObjectStore interface.
2431  * In that case, you can ignore the m_propertySet variable and the notifications interface.
2432  *
2433  * \aknote The AK::Wwise::Plugin::RequestPropertySet and AK::Wwise::Plugin::RequestWrite classes are automatically
2434  * derived when providing AudioPlugin in C++. \endaknote
2435  */
2436  using RequestPropertySet = RequestedHostInterface<PropertySet>;
2437 
2438  } // of namespace V1
2439 
2440  /// Latest version of the C PropertySet interface.
2441  using CHostPropertySet = V1::CHostPropertySet;
2442  /// Latest version of the C++ PropertySet interface.
2443  using PropertySet = V1::PropertySet;
2444  /// Latest version of the requested C++ PropertySet interface.
2445  using RequestPropertySet = V1::RequestPropertySet;
2446 
2447  namespace Notifications
2448  {
2449  /// Latest version of the C PropertySet notification interface.
2450  using CPropertySet = V1::Notifications::CPropertySet_;
2451  /// Latest version of the C++ PropertySet notification interface.
2452  using PropertySet = V1::Notifications::PropertySet_;
2453  }
2454 
2455  AK_WWISE_PLUGIN_SPECIALIZE_HOST_INTERFACE(PropertySet, propertySet,, public Notifications::PropertySet);
2456  AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_CLASS(PropertySet);
2457  AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION(PropertySet);
2458  AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_CLASS(Notifications::PropertySet);
2459  AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION(Notifications::PropertySet);
2460 } // of namespace AK::Wwise::Plugin
2461 
2462 #endif
AK.Wwise::Plugin::V1::PropertySet::SetValue
bool SetValue(const GUID &in_guidPlatform, const char *in_pszPropertyName, const AK::WwiseAuthoringAPI::AkVariantBase &in_varProperty)
Modifies the value of a specific property as a variant.
Definition: HostPropertySet.h:1147
ak_wwise_plugin_host_property_set_v1::SetValueUInt64
bool(* SetValueUInt64)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, uint64_t in_propertyValue)
Modifies a property to a 64-bit unsigned integer value. (Future use)
Definition: HostPropertySet.h:502
AK.Wwise::Plugin::V1::PropertySet::GetValueInt8
bool GetValueInt8(const GUID &in_guidPlatform, const char *in_pszPropertyName, int8_t &out_propertyValue) const
Retrieves the 8-bit signed integer value of a specific property. (Future use)
Definition: HostPropertySet.h:1831
AK.Wwise::Plugin::V1::Notifications::PropertySet_::k_interfaceVersion
@ k_interfaceVersion
The interface version, as provided by this plug-in.
Definition: HostPropertySet.h:2360
ak_wwise_plugin_host_property_set_v1::SetValueString
bool(* SetValueString)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, const char *in_propertyValue)
Modifies a property to a string value.
Definition: HostPropertySet.h:335
AK.Wwise::Plugin::V1::PropertySet::k_interfaceType
@ k_interfaceType
The interface type, as requested by this plug-in.
Definition: HostPropertySet.h:1065
AK.Wwise::Plugin::V1::PropertySet::GetInt64
int64_t GetInt64(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Returns the 64-bit signed integer value of a specific property.
Definition: HostPropertySet.h:2053
AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_PROPERTY_SET
@ AK_WWISE_PLUGIN_INTERFACE_TYPE_HOST_PROPERTY_SET
2021.1 Property Set host service. ak_wwise_plugin_host_property_set_v1
Definition: PluginBaseInterface.h:81
AK.Wwise::Plugin::V1::PropertySet::GetType
int GetType(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Retrieves the type of a specific property.
Definition: HostPropertySet.h:1278
AK.Wwise::Plugin::V1::PropertySet::SetValueString
bool SetValueString(const GUID &in_guidPlatform, const char *in_pszPropertyName, const char *in_propertyValue)
Modifies a property to a string value.
Definition: HostPropertySet.h:1329
ak_wwise_plugin_host_property_set_v1::SetValueUInt8
bool(* SetValueUInt8)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, uint8_t in_propertyValue)
Modifies a property to an 8-bit unsigned integer value. (Future use)
Definition: HostPropertySet.h:604
ak_wwise_plugin_host_property_set_v1::HasPropertyValue
bool(* HasPropertyValue)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName)
Returns true if the specified property exists.
Definition: HostPropertySet.h:177
AK.Wwise::Plugin::V1::Notifications::PropertySet_::NotifyPropertyChanged
virtual void NotifyPropertyChanged(const GUID &in_guidPlatform, const char *in_pszPropertyName)
This function is called by Wwise when a plug-in property changes.
Definition: HostPropertySet.h:2415
ak_wwise_plugin_host_property_set_v1::GetValueReal64
bool(* GetValueReal64)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, double *out_propertyValue)
Retrieves the 64-bit floating point value of a specific property.
Definition: HostPropertySet.h:935
ak_wwise_plugin_host_property_set_v1::PropertyHasUnlinked
bool(* PropertyHasUnlinked)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const char *in_pszPropertyName)
Returns whether the specified property has at least some platforms that are not linked.
Definition: HostPropertySet.h:233
ak_wwise_plugin_host_property_set_v1::GetType
int(* GetType)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName)
Retrieves the type of a specific property.
Definition: HostPropertySet.h:286
AK.Wwise::Plugin::CBaseInterfaceGlue< CHostPropertySet >::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:90
AK.Wwise::Plugin::V1::PropertySet::GetValueInt64
bool GetValueInt64(const GUID &in_guidPlatform, const char *in_pszPropertyName, int64_t &out_propertyValue) const
Retrieves the 64-bit signed integer value of a specific property.
Definition: HostPropertySet.h:1761
AK.Wwise::Plugin::V1::PropertySet::SetValueUInt32
bool SetValueUInt32(const GUID &in_guidPlatform, const char *in_pszPropertyName, uint32_t in_propertyValue)
Modifies a property to a 32-bit unsigned integer value. (Future use)
Definition: HostPropertySet.h:1536
AK.Wwise::Plugin::V1::PropertySet::GetID
const GUID * GetID() const
Returns the internal unique identifier of the corresponding object.
Definition: HostPropertySet.h:1263
AK.Wwise::Plugin::InterfaceVersion
decltype(BaseInterface::m_version) InterfaceVersion
PluginInfoGenerator: Type for the m_version value in BaseInterface.
Definition: PluginInfoGenerator.h:51
AK.Wwise::Plugin::V1::PropertySet::SetValueUInt64
bool SetValueUInt64(const GUID &in_guidPlatform, const char *in_pszPropertyName, uint64_t in_propertyValue)
Modifies a property to a 64-bit unsigned integer value. (Future use)
Definition: HostPropertySet.h:1501
ak_wwise_plugin_host_property_set_v1::GetValue
bool(* GetValue)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, AK::WwiseAuthoringAPI::AkVariantBase *out_varProperty)
Retrieves the value of a specific property as a variant.
Definition: HostPropertySet.h:117
AK.Wwise::Plugin::V1::PropertySet::GetInt8
int8_t GetInt8(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Returns the 8-bit signed integer value of a specific property.
Definition: HostPropertySet.h:2132
ak_wwise_plugin_host_property_set_v1::GetValueReal32
bool(* GetValueReal32)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, float *out_propertyValue)
Retrieves the 32-bit floating point value of a specific property.
Definition: HostPropertySet.h:957
AK.Wwise::Plugin::V1::PropertySet::GetUInt16
uint16_t GetUInt16(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Returns the 16-bit unsigned integer value of a specific property.
Definition: HostPropertySet.h:2213
AK.Wwise::Plugin::V1::RequestPropertySet
RequestedHostInterface< PropertySet > RequestPropertySet
Requests a PropertySet interface, provided as m_propertySet variable.
Definition: HostPropertySet.h:2436
AK.Wwise::Plugin::V1::Notifications::PropertySet_::GetInstancePointer
const CPropertySet_::Instance * GetInstancePointer() const
Definition: HostPropertySet.h:2390
AK.Wwise::Plugin::V1::PropertySet::SetValueInt8
bool SetValueInt8(const GUID &in_guidPlatform, const char *in_pszPropertyName, int8_t in_propertyValue)
Modifies a property to an 8-bit signed integer value. (Future use)
Definition: HostPropertySet.h:1466
ak_wwise_plugin_host_property_set_v1::PropertyHasLinked
bool(* PropertyHasLinked)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const char *in_pszPropertyName)
Returns whether the specified property has at least some linked platforms.
Definition: HostPropertySet.h:219
AK.Wwise::Plugin::V1::PropertySet::PropertyHasUnlinked
bool PropertyHasUnlinked(const char *in_pszPropertyName) const
Returns whether the specified property has at least some platforms that are not linked.
Definition: HostPropertySet.h:1223
AK.Wwise::Plugin::V1::Notifications::PropertySet_::k_interfaceType
@ k_interfaceType
The interface type, as provided by this plug-in.
Definition: HostPropertySet.h:2350
AK.Wwise::Plugin::V1::PropertySet::GetString
const char * GetString(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Retrieves the string value of a specific property and returns the value as a temporary pointer.
Definition: HostPropertySet.h:2027
AK.Wwise::Plugin::V1::PropertySet::GetInt32
int32_t GetInt32(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Returns the 32-bit signed integer value of a specific property.
Definition: HostPropertySet.h:2079
ak_wwise_plugin_notifications_property_set_v1::Instance
ak_wwise_plugin_notifications_property_set_instance_v1 Instance
Base instance type for receiving notifications on property set's changes.
Definition: HostPropertySet.h:999
ak_wwise_plugin_host_property_set_v1::PropertyHasState
bool(* PropertyHasState)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const char *in_pszPropertyName)
Returns whether the specified property is bound to a state object.
Definition: HostPropertySet.h:205
ak_wwise_plugin_host_property_set_v1::GetValueUInt64
bool(* GetValueUInt64)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, uint64_t *out_propertyValue)
Retrieves the 64-bit unsigned integer value of a specific property. (Future use)
Definition: HostPropertySet.h:844
ak_wwise_plugin_host_property_set_v1::SetValueReal64
bool(* SetValueReal64)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, double in_propertyValue)
Modifies a property to a 64-bit floating point value.
Definition: HostPropertySet.h:637
AK.Wwise::Plugin::V1::Notifications::PropertySet_::Interface
The C interface, fulfilled by your plug-in.
Definition: HostPropertySet.h:2367
ak_wwise_plugin_host_property_set_v1::GetValueInt8
bool(* GetValueInt8)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, int8_t *out_propertyValue)
Retrieves the 8-bit signed integer value of a specific property. (Future use)
Definition: HostPropertySet.h:821
AK.Wwise::Plugin::V1::PropertySet::SetValueInt32
bool SetValueInt32(const GUID &in_guidPlatform, const char *in_pszPropertyName, int32_t in_propertyValue)
Modifies a property to a 32-bit signed integer value.
Definition: HostPropertySet.h:1397
AK.Wwise::Plugin::V1::PropertySet::GetUInt64
uint64_t GetUInt64(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Returns the 64-bit unsigned integer value of a specific property.
Definition: HostPropertySet.h:2159
ak_wwise_plugin_host_property_set_v1::GetValueBool
bool(* GetValueBool)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, bool *out_propertyValue)
Retrieves the boolean value of a specific property.
Definition: HostPropertySet.h:979
ak_wwise_plugin_notifications_property_set_v1::NotifyPropertyChanged
void(* NotifyPropertyChanged)(struct ak_wwise_plugin_notifications_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName)
This function is called by Wwise when a plug-in property changes.
Definition: HostPropertySet.h:1021
AK.Wwise::Plugin::V1::PropertySet::GetReal64
double GetReal64(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Returns the 64-bit floating point value of a specific property.
Definition: HostPropertySet.h:2266
AK.Wwise::Plugin::V1::PropertySet::ClearValue
bool ClearValue(const GUID &in_guidPlatform, const char *in_pszPropertyName)
Resets a property value to its default.
Definition: HostPropertySet.h:1296
ak_wwise_plugin_host_property_set_v1::GetValueInt64
bool(* GetValueInt64)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, int64_t *out_propertyValue)
Retrieves the 64-bit signed integer value of a specific property.
Definition: HostPropertySet.h:754
AK.Wwise::Plugin::V1::Notifications::PropertySet_::GetInterfacePointer
InterfacePtr GetInterfacePointer()
Definition: HostPropertySet.h:2383
AK.Wwise::Plugin::V1::PropertySet::GetValueString
bool GetValueString(const GUID &in_guidPlatform, const char *in_pszPropertyName, const char *&out_propertyValue) const
Retrieves the string value of a specific property.
Definition: HostPropertySet.h:1738
AK.Wwise::Plugin::V1::PropertySet::SetValueReal32
bool SetValueReal32(const GUID &in_guidPlatform, const char *in_pszPropertyName, float in_propertyValue)
Modifies a property to a 32-bit floating point value.
Definition: HostPropertySet.h:1674
AK.Wwise::Plugin::V1::PropertySet::GetBool
bool GetBool(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Returns the boolean value of a specific property.
Definition: HostPropertySet.h:2318
ak_wwise_plugin_host_property_set_v1::GetID
const GUID *(* GetID)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this)
Returns the internal unique identifier of the corresponding object.
Definition: HostPropertySet.h:271
ak_wwise_plugin_notifications_property_set_v1
Definition: HostPropertySet.h:992
ak_wwise_plugin_host_property_set_v1::SetValueInt64
bool(* SetValueInt64)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, int64_t in_propertyValue)
Modifies a property to a 64-bit signed integer value.
Definition: HostPropertySet.h:368
AK.Wwise::Plugin::V1::PropertySet::GetValueUInt16
bool GetValueUInt16(const GUID &in_guidPlatform, const char *in_pszPropertyName, uint16_t &out_propertyValue) const
Retrieves the 16-bit unsigned integer value of a specific property. (Future use)
Definition: HostPropertySet.h:1903
PluginInfoGenerator.h
Wwise Authoring Plug-ins - C++ class helper to automatically determine the plug-in interfaces used in...
ak_wwise_plugin_host_property_set_v1::SetValueUInt32
bool(* SetValueUInt32)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, uint32_t in_propertyValue)
Modifies a property to a 32-bit unsigned integer value. (Future use)
Definition: HostPropertySet.h:536
AK.Wwise::Plugin::V1::PropertySet::GetValueBool
bool GetValueBool(const GUID &in_guidPlatform, const char *in_pszPropertyName, bool &out_propertyValue) const
Retrieves the boolean value of a specific property.
Definition: HostPropertySet.h:1996
AK.Wwise::Plugin::CBaseInstanceGlue
PluginInfoGenerator: Associates an existing C Interface with a variable that can be used....
Definition: PluginInfoGenerator.h:105
AK.Wwise::Plugin::InterfacePtr
CInterfacePtr InterfacePtr
Definition: PluginDef.h:968
ak_wwise_plugin_host_property_set_v1::SetValueInt16
bool(* SetValueInt16)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, int16_t in_propertyValue)
Modifies a property to a 16-bit signed integer value.
Definition: HostPropertySet.h:434
AKVERIFY
#define AKVERIFY(x)
Definition: AkAssert.h:78
AK.Wwise::Plugin::V1::CHostPropertySet
ak_wwise_plugin_host_property_set_v1 CHostPropertySet
Definition: HostPropertySet.h:1049
AK.Wwise::Plugin::V1::PropertySet::k_interfaceVersion
@ k_interfaceVersion
The interface version, as requested by this plug-in.
Definition: HostPropertySet.h:1075
ak_wwise_plugin_host_property_set_v1::GetValueString
bool(* GetValueString)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, const char **out_propertyValue)
Retrieves the string value of a specific property.
Definition: HostPropertySet.h:732
AK.Wwise::Plugin::V1::PropertySet::GetInt16
int16_t GetInt16(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Returns the 16-bit signed integer value of a specific property.
Definition: HostPropertySet.h:2105
ak_wwise_plugin_host_property_set_v1::GetValueInt16
bool(* GetValueInt16)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, int16_t *out_propertyValue)
Retrieves the 16-bit signed integer value of a specific property.
Definition: HostPropertySet.h:798
AK_WWISE_PLUGIN_INTERFACE_TYPE_NOTIFICATIONS_PROPERTY_SET
@ AK_WWISE_PLUGIN_INTERFACE_TYPE_NOTIFICATIONS_PROPERTY_SET
2021.1 Property Set modification notification. ak_wwise_plugin_notifications_property_set_v1
Definition: PluginBaseInterface.h:68
ak_wwise_plugin_host_property_set_v1::SetValue
bool(* SetValue)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, const AK::WwiseAuthoringAPI::AkVariantBase *in_varProperty)
Modifies the value of a specific property as a variant.
Definition: HostPropertySet.h:162
ak_wwise_plugin_host_property_set_v1::GetValueInt32
bool(* GetValueInt32)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, int32_t *out_propertyValue)
Retrieves the 32-bit signed integer value of a specific property.
Definition: HostPropertySet.h:776
AK.Wwise::Plugin::V1::PropertySet::PropertyHasLinked
bool PropertyHasLinked(const char *in_pszPropertyName) const
Returns whether the specified property has at least some linked platforms.
Definition: HostPropertySet.h:1208
AK.Wwise::Plugin::V1::PropertySet::PropertyHasRTPC
bool PropertyHasRTPC(const char *in_pszPropertyName) const
Get the RTPC binding status for the specified property.
Definition: HostPropertySet.h:1177
ak_wwise_plugin_notifications_property_set_v1::ak_wwise_plugin_notifications_property_set_v1
ak_wwise_plugin_notifications_property_set_v1()
Definition: HostPropertySet.h:1001
AK.Wwise::Plugin::V1::Notifications::PropertySet_
Definition: HostPropertySet.h:2335
AK.Wwise::Plugin::V1::PropertySet::GetUInt32
uint32_t GetUInt32(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Returns the 32-bit unsigned integer value of a specific property.
Definition: HostPropertySet.h:2186
ak_wwise_plugin_host_property_set_v1
Interface used to interact with property sets.
Definition: HostPropertySet.h:80
AK.Wwise::Plugin::V1::PropertySet::GetUInt8
uint8_t GetUInt8(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Returns the 8-bit unsigned integer value of a specific property.
Definition: HostPropertySet.h:2240
AK.Wwise::Plugin::V1::Notifications::PropertySet_::Interface::Interface
Interface()
Definition: HostPropertySet.h:2369
AK.Wwise::Plugin::V1::PropertySet::GetReal32
float GetReal32(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Returns the 32-bit floating point value of a specific property.
Definition: HostPropertySet.h:2292
AK.Wwise::Plugin::InterfaceTypeValue
std::underlying_type< InterfaceType >::type InterfaceTypeValue
PluginInfoGenerator: Underlying storage type for the m_interface value in BaseInterface.
Definition: PluginInfoGenerator.h:50
AK.Wwise::Plugin::V1::PropertySet::GetValueReal32
bool GetValueReal32(const GUID &in_guidPlatform, const char *in_pszPropertyName, float &out_propertyValue) const
Retrieves the 32-bit floating point value of a specific property.
Definition: HostPropertySet.h:1973
AK.Wwise::Plugin::V1::PropertySet::SetValueUInt16
bool SetValueUInt16(const GUID &in_guidPlatform, const char *in_pszPropertyName, uint16_t in_propertyValue)
Modifies a property to a 16-bit unsigned integer value. (Future use)
Definition: HostPropertySet.h:1571
AK.Wwise::Plugin::V1::PropertySet::SetValueInt16
bool SetValueInt16(const GUID &in_guidPlatform, const char *in_pszPropertyName, int16_t in_propertyValue)
Modifies a property to a 16-bit signed integer value.
Definition: HostPropertySet.h:1431
AK.Wwise::Plugin::V1::PropertySet::GetValueUInt64
bool GetValueUInt64(const GUID &in_guidPlatform, const char *in_pszPropertyName, uint64_t &out_propertyValue) const
Retrieves the 64-bit unsigned integer value of a specific property. (Future use)
Definition: HostPropertySet.h:1855
AK.Wwise::Plugin::V1::Notifications::PropertySet_::PropertySet_
PropertySet_()
Definition: HostPropertySet.h:2394
AK.Wwise::Plugin::V1::PropertySet::GetValueInt16
bool GetValueInt16(const GUID &in_guidPlatform, const char *in_pszPropertyName, int16_t &out_propertyValue) const
Retrieves the 16-bit signed integer value of a specific property.
Definition: HostPropertySet.h:1807
AK.Wwise::Plugin::V1::PropertySet::SetValueBool
bool SetValueBool(const GUID &in_guidPlatform, const char *in_pszPropertyName, bool in_propertyValue)
Modifies a property to a boolean value.
Definition: HostPropertySet.h:1708
ak_wwise_plugin_host_property_set_v1::ak_wwise_plugin_host_property_set_v1
ak_wwise_plugin_host_property_set_v1()
Definition: HostPropertySet.h:88
AK.Wwise::Plugin::V1::PropertySet
Interface used to interact with property sets.
Definition: HostPropertySet.h:1053
AK.Wwise::Plugin::AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION
AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION(AudioPlugin)
AK.Wwise::Plugin::V1::PropertySet::PropertyPlatformIsLinked
bool PropertyPlatformIsLinked(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Returns whether the specified property's platform is linked.
Definition: HostPropertySet.h:1239
AK.Wwise::Plugin::V1::Notifications::PropertySet_::~PropertySet_
virtual ~PropertySet_()
Definition: HostPropertySet.h:2399
AK.Wwise::Plugin::V1::PropertySet::GetValueUInt32
bool GetValueUInt32(const GUID &in_guidPlatform, const char *in_pszPropertyName, uint32_t &out_propertyValue) const
Retrieves the 32-bit unsigned integer value of a specific property. (Future use)
Definition: HostPropertySet.h:1879
ak_wwise_plugin_host_property_set_v1::GetValueUInt8
bool(* GetValueUInt8)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, uint8_t *out_propertyValue)
Retrieves the 8-bit unsigned integer value of a specific property. (Future use)
Definition: HostPropertySet.h:913
ak_wwise_plugin_base_interface
Interface description and base class for every Wwise Authoring plug-in interface.
Definition: PluginBaseInterface.h:117
AK.Wwise::Plugin::V1::PropertySet::SetValueInt64
bool SetValueInt64(const GUID &in_guidPlatform, const char *in_pszPropertyName, int64_t in_propertyValue)
Modifies a property to a 64-bit signed integer value.
Definition: HostPropertySet.h:1363
AK.Wwise::Plugin::V1::Notifications::CPropertySet_
ak_wwise_plugin_notifications_property_set_v1 CPropertySet_
Definition: HostPropertySet.h:2331
ak_wwise_plugin_host_property_set_v1::PropertyHasRTPC
bool(* PropertyHasRTPC)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const char *in_pszPropertyName)
Get the RTPC binding status for the specified property.
Definition: HostPropertySet.h:190
AK.Wwise::Plugin::V1::PropertySet::SetValueReal64
bool SetValueReal64(const GUID &in_guidPlatform, const char *in_pszPropertyName, double in_propertyValue)
Modifies a property to a 64-bit floating point value.
Definition: HostPropertySet.h:1640
ak_wwise_plugin_host_property_set_instance_v1
Base host-provided instance type for ak_wwise_plugin_host_property_set_v1.
Definition: PluginDef.h:644
ak_wwise_plugin_host_property_set_v1::ClearValue
bool(* ClearValue)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName)
Resets a property value to its default.
Definition: HostPropertySet.h:303
AK.Wwise::Plugin::V1::PropertySet::SetValueUInt8
bool SetValueUInt8(const GUID &in_guidPlatform, const char *in_pszPropertyName, uint8_t in_propertyValue)
Modifies a property to an 8-bit unsigned integer value. (Future use)
Definition: HostPropertySet.h:1606
AK.Wwise::Plugin::V1::Notifications::PropertySet_::GetInstancePointer
CPropertySet_::Instance * GetInstancePointer()
Definition: HostPropertySet.h:2387
AK.Wwise::Plugin::V1::PropertySet::PropertyHasState
bool PropertyHasState(const char *in_pszPropertyName) const
Returns whether the specified property is bound to a state object.
Definition: HostPropertySet.h:1193
ak_wwise_plugin_host_property_set_v1::SetValueUInt16
bool(* SetValueUInt16)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, uint16_t in_propertyValue)
Modifies a property to a 16-bit unsigned integer value. (Future use)
Definition: HostPropertySet.h:570
ak_wwise_plugin_host_property_set_v1::SetValueInt32
bool(* SetValueInt32)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, int32_t in_propertyValue)
Modifies a property to a 32-bit signed integer value.
Definition: HostPropertySet.h:401
ak_wwise_plugin_host_property_set_v1::SetValueInt8
bool(* SetValueInt8)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, int8_t in_propertyValue)
Modifies a property to an 8-bit signed integer value. (Future use)
Definition: HostPropertySet.h:468
MKBOOL
#define MKBOOL(cond)
Definition: PluginHelpers.h:75
ak_wwise_plugin_host_property_set_v1::PropertyPlatformIsLinked
bool(* PropertyPlatformIsLinked)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName)
Returns whether the specified property's platform is linked.
Definition: HostPropertySet.h:248
ak_wwise_plugin_notifications_property_set_instance_v1
Base instance type for receiving notifications on property set's changes.
Definition: PluginDef.h:845
ak_wwise_plugin_host_property_set_v1::SetValueBool
bool(* SetValueBool)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, bool in_propertyValue)
Modifies a property to a boolean value.
Definition: HostPropertySet.h:703
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:238
AK.Wwise::Plugin::Notifications::PropertySet
V1::Notifications::PropertySet_ PropertySet
Latest version of the C++ PropertySet notification interface.
Definition: HostPropertySet.h:2452
AK.Wwise::Plugin::V1::PropertySet::HasPropertyValue
bool HasPropertyValue(const GUID &in_guidPlatform, const char *in_pszPropertyName) const
Returns true if the specified property exists.
Definition: HostPropertySet.h:1163
ak_wwise_plugin_host_property_set_v1::SetValueReal32
bool(* SetValueReal32)(struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, float in_propertyValue)
Modifies a property to a 32-bit floating point value.
Definition: HostPropertySet.h:670
AK.Wwise::Plugin::V1::PropertySet::GetValueReal64
bool GetValueReal64(const GUID &in_guidPlatform, const char *in_pszPropertyName, double &out_propertyValue) const
Retrieves the 64-bit floating point value of a specific property.
Definition: HostPropertySet.h:1950
AK.Wwise::Plugin::V1::PropertySet::GetValue
bool GetValue(const GUID &in_guidPlatform, const char *in_pszPropertyName, AK::WwiseAuthoringAPI::AkVariantBase &out_varProperty) const
Retrieves the value of a specific property as a variant.
Definition: HostPropertySet.h:1101
ak_wwise_plugin_host_property_set_v1::GetValueUInt32
bool(* GetValueUInt32)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, uint32_t *out_propertyValue)
Retrieves the 32-bit unsigned integer value of a specific property. (Future use)
Definition: HostPropertySet.h:867
AK.Wwise::Plugin::V1::PropertySet::GetValueUInt8
bool GetValueUInt8(const GUID &in_guidPlatform, const char *in_pszPropertyName, uint8_t &out_propertyValue) const
Retrieves the 8-bit unsigned integer value of a specific property. (Future use)
Definition: HostPropertySet.h:1927
ak_wwise_plugin_host_property_set_v1::GetValueUInt16
bool(* GetValueUInt16)(const struct ak_wwise_plugin_host_property_set_instance_v1 *in_this, const GUID *in_guidPlatform, const char *in_pszPropertyName, uint16_t *out_propertyValue)
Retrieves the 16-bit unsigned integer value of a specific property. (Future use)
Definition: HostPropertySet.h:890
AK.Wwise::Plugin::V1::PropertySet::GetValueInt32
bool GetValueInt32(const GUID &in_guidPlatform, const char *in_pszPropertyName, int32_t &out_propertyValue) const
Retrieves the 32-bit signed integer value of a specific property.
Definition: HostPropertySet.h:1784
AK.Wwise::Plugin::AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_CLASS
AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_CLASS(AudioPlugin)
GUID
Definition: PluginHelpers.h:46

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