Skip to content

Commit c3c580d

Browse files
committed
Finalize draft for audio file chunk authoring in the host, prepare documentation for subrelease
1 parent c20dc78 commit c3c580d

File tree

204 files changed

+1793
-1623
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

204 files changed

+1793
-1623
lines changed

ChangeLog.txt

+3-6
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,6 @@
1-
This is a development build of the ARA Library 2.1.
2-
=== PRELIMINARY - DO NOT USE FOR SHIPPING PRODUCTS! ===
3-
4-
5-
ARA SDK 2.1 draft 1 (aka 2.0.1) (2021/??/??)
6-
- initial draft of ARA audio file chunk authoring directly in the host
1+
=== ARA SDK 2.1 release (aka 2.1.001) (2022/01/06) ===
2+
- finalized ARM support for Apple Silicon
3+
- enable ARA audio file chunk authoring directly in the host
74

85

96
=== ARA SDK 2.0 release (aka 2.0.001) (2021/05/03) ===

html_docs/ara_design_overview.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
77
<meta name="generator" content="Doxygen 1.9.1"/>
88
<meta name="viewport" content="width=device-width, initial-scale=1"/>
9-
<title>ARA SDK 2.0.0: ARA Design Overview</title>
9+
<title>ARA SDK 2.1.0: ARA Design Overview</title>
1010
<link rel="icon" type="image/png" sizes="96x96" href="favicon-96x96.png">
1111
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
1212
<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">

html_docs/dir_2892372f937ff5a221b9474b167a8bad.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
77
<meta name="generator" content="Doxygen 1.9.1"/>
88
<meta name="viewport" content="width=device-width, initial-scale=1"/>
9-
<title>ARA SDK 2.0.0: PlugIn Directory Reference</title>
9+
<title>ARA SDK 2.1.0: PlugIn Directory Reference</title>
1010
<link rel="icon" type="image/png" sizes="96x96" href="favicon-96x96.png">
1111
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
1212
<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">

html_docs/dir_360188f7f901f641d98b8f8f4319c2a6.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
77
<meta name="generator" content="Doxygen 1.9.1"/>
88
<meta name="viewport" content="width=device-width, initial-scale=1"/>
9-
<title>ARA SDK 2.0.0: ARA_API Directory Reference</title>
9+
<title>ARA SDK 2.1.0: ARA_API Directory Reference</title>
1010
<link rel="icon" type="image/png" sizes="96x96" href="favicon-96x96.png">
1111
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
1212
<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">

html_docs/dir_b46f7d7662f470ecb8d9f332d0f2a2cd.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
77
<meta name="generator" content="Doxygen 1.9.1"/>
88
<meta name="viewport" content="width=device-width, initial-scale=1"/>
9-
<title>ARA SDK 2.0.0: Dispatch Directory Reference</title>
9+
<title>ARA SDK 2.1.0: Dispatch Directory Reference</title>
1010
<link rel="icon" type="image/png" sizes="96x96" href="favicon-96x96.png">
1111
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
1212
<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">

html_docs/dir_de36e60450da2e4883acdd27d8bd213d.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
77
<meta name="generator" content="Doxygen 1.9.1"/>
88
<meta name="viewport" content="width=device-width, initial-scale=1"/>
9-
<title>ARA SDK 2.0.0: Markdown Directory Reference</title>
9+
<title>ARA SDK 2.1.0: Markdown Directory Reference</title>
1010
<link rel="icon" type="image/png" sizes="96x96" href="favicon-96x96.png">
1111
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
1212
<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">

html_docs/dir_ec5bcb8fa3837de76c9ed1d58ec0e69c.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
77
<meta name="generator" content="Doxygen 1.9.1"/>
88
<meta name="viewport" content="width=device-width, initial-scale=1"/>
9-
<title>ARA SDK 2.0.0: Utilities Directory Reference</title>
9+
<title>ARA SDK 2.1.0: Utilities Directory Reference</title>
1010
<link rel="icon" type="image/png" sizes="96x96" href="favicon-96x96.png">
1111
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
1212
<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">

html_docs/dir_ffb7eb592b42f6b4027ad387f579f075.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
77
<meta name="generator" content="Doxygen 1.9.1"/>
88
<meta name="viewport" content="width=device-width, initial-scale=1"/>
9-
<title>ARA SDK 2.0.0: ARA_Library Directory Reference</title>
9+
<title>ARA SDK 2.1.0: ARA_Library Directory Reference</title>
1010
<link rel="icon" type="image/png" sizes="96x96" href="favicon-96x96.png">
1111
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
1212
<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">

html_docs/group___a_p_i__generations.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
77
<meta name="generator" content="Doxygen 1.9.1"/>
88
<meta name="viewport" content="width=device-width, initial-scale=1"/>
9-
<title>ARA SDK 2.0.0: API Generations</title>
9+
<title>ARA SDK 2.1.0: API Generations</title>
1010
<link rel="icon" type="image/png" sizes="96x96" href="favicon-96x96.png">
1111
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
1212
<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">
@@ -136,7 +136,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga056d437a04be3404c38ec74
136136
</td></tr>
137137
<tr><td class="fieldname"><a id="gga056d437a04be3404c38ec743727b0ba7aef92bda70849afe4022166643ef35f40"></a>kARAAPIGeneration_2_0_Draft&#160;</td><td class="fielddoc"><p>supported by Studio One, Logic Pro, Cubase/Nuendo, Cakewalk, REAPER, Melodyne, ReVoice Pro, VocAlign, Auto-Align, SpectraLayers </p>
138138
</td></tr>
139-
<tr><td class="fieldname"><a id="gga056d437a04be3404c38ec743727b0ba7a017c2181dc7de21c1810795e1e95a406"></a>kARAAPIGeneration_2_0_Final&#160;</td><td class="fielddoc"><p>most developers supporting kARAAPIGeneration_2_0_Draft are already working on updating to kARAAPIGeneration_2_0_Final </p>
139+
<tr><td class="fieldname"><a id="gga056d437a04be3404c38ec743727b0ba7a017c2181dc7de21c1810795e1e95a406"></a>kARAAPIGeneration_2_0_Final&#160;</td><td class="fielddoc"><p>most developers supporting kARAAPIGeneration_2_0_Draft are already working on updating to kARAAPIGeneration_2_0_Final (this is also required for ARM builds) </p>
140140
</td></tr>
141141
<tr><td class="fieldname"><a id="gga056d437a04be3404c38ec743727b0ba7a1bc12a72f3bbe61b350ef517ec5b95be"></a>kARAAPIGeneration_2_X_Draft&#160;</td><td class="fielddoc"><p>reserved for future development </p>
142142
</td></tr>

html_docs/group___a_p_i__versions.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
77
<meta name="generator" content="Doxygen 1.9.1"/>
88
<meta name="viewport" content="width=device-width, initial-scale=1"/>
9-
<title>ARA SDK 2.0.0: API Versions</title>
9+
<title>ARA SDK 2.1.0: API Versions</title>
1010
<link rel="icon" type="image/png" sizes="96x96" href="favicon-96x96.png">
1111
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
1212
<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">

html_docs/group___a_r_a___library.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
77
<meta name="generator" content="Doxygen 1.9.1"/>
88
<meta name="viewport" content="width=device-width, initial-scale=1"/>
9-
<title>ARA SDK 2.0.0: ARA C++ Library</title>
9+
<title>ARA SDK 2.1.0: ARA C++ Library</title>
1010
<link rel="icon" type="image/png" sizes="96x96" href="favicon-96x96.png">
1111
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
1212
<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">

html_docs/group___a_r_a___library___a_r_a_plug.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
77
<meta name="generator" content="Doxygen 1.9.1"/>
88
<meta name="viewport" content="width=device-width, initial-scale=1"/>
9-
<title>ARA SDK 2.0.0: ARAPlug</title>
9+
<title>ARA SDK 2.1.0: ARAPlug</title>
1010
<link rel="icon" type="image/png" sizes="96x96" href="favicon-96x96.png">
1111
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
1212
<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">

html_docs/group___a_r_a___library___a_r_a_plug___document___controller.html

+18-7
Large diffs are not rendered by default.

html_docs/group___a_r_a___library___a_r_a_plug___document___controller.js

+1
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

html_docs/group___a_r_a___library___a_r_a_plug___model___objects.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
77
<meta name="generator" content="Doxygen 1.9.1"/>
88
<meta name="viewport" content="width=device-width, initial-scale=1"/>
9-
<title>ARA SDK 2.0.0: Model Objects</title>
9+
<title>ARA SDK 2.1.0: Model Objects</title>
1010
<link rel="icon" type="image/png" sizes="96x96" href="favicon-96x96.png">
1111
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
1212
<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">

html_docs/group___a_r_a___library___a_r_a_plug___plug_in_entry.html

+32-2
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
77
<meta name="generator" content="Doxygen 1.9.1"/>
88
<meta name="viewport" content="width=device-width, initial-scale=1"/>
9-
<title>ARA SDK 2.0.0: Plug-In Entry</title>
9+
<title>ARA SDK 2.1.0: Plug-In Entry</title>
1010
<link rel="icon" type="image/png" sizes="96x96" href="favicon-96x96.png">
1111
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
1212
<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">
@@ -165,6 +165,9 @@ <h2 class="memtitle"><span class="permalink"><a href="#class_a_r_a_1_1_plug_in_1
165165
<tr class="memitem:af2b77443300649a0b4aac93f45666e55"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="group___model___playback___region.html#ga258336ff5f674225e3ec403493461179">ARAPlaybackTransformationFlags</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_r_a___library___a_r_a_plug___plug_in_entry.html#af2b77443300649a0b4aac93f45666e55">getSupportedPlaybackTransformationFlags</a> () const noexcept</td></tr>
166166
<tr class="memdesc:af2b77443300649a0b4aac93f45666e55"><td class="mdescLeft">&#160;</td><td class="mdescRight">Set of transformations that the plug-in supports when configuring playback regions. These flags allow the host to determine whether e.g. the plug-in can be used as time-stretch engine. <a href="group___a_r_a___library___a_r_a_plug___plug_in_entry.html#af2b77443300649a0b4aac93f45666e55">More...</a><br /></td></tr>
167167
<tr class="separator:af2b77443300649a0b4aac93f45666e55"><td class="memSeparator" colspan="2">&#160;</td></tr>
168+
<tr class="memitem:a37f87a4ecf4ec0d6d6cb20df7746ade7"><td class="memItemLeft" align="right" valign="top">virtual bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_r_a___library___a_r_a_plug___plug_in_entry.html#a37f87a4ecf4ec0d6d6cb20df7746ade7">supportsStoringAudioFileChunks</a> () const noexcept</td></tr>
169+
<tr class="memdesc:a37f87a4ecf4ec0d6d6cb20df7746ade7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Flag whether the plug-in supports exporting ARA audio file chunks via <a class="el" href="group___plug-_in___document___controller.html#a4759249602a579d2d561745eaa92182a" title="Create an archive of the internal state of the specified audio source suitable to be embedded into th...">ARADocumentControllerInterface::storeAudioSourceToAudioFileChunk()</a>. Note that reading such chunks is unaffected by this flag - as long as the documentArchiveID in the chunk is compatible, the plug-in must be able to read the data via <a class="el" href="group___plug-_in___document___controller.html#a6ad2b9f4070e12178057c3c9590f4c32" title="Unarchive the internal state of the specified objects. This call can be used both for unarchiving ent...">ARADocumentControllerInterface::restoreObjectsFromArchive()</a>. <a href="group___a_r_a___library___a_r_a_plug___plug_in_entry.html#a37f87a4ecf4ec0d6d6cb20df7746ade7">More...</a><br /></td></tr>
170+
<tr class="separator:a37f87a4ecf4ec0d6d6cb20df7746ade7"><td class="memSeparator" colspan="2">&#160;</td></tr>
168171
</table>
169172
<h4 class="groupheader">Member Function Documentation</h4>
170173
<a id="aae299f1edf33c6e6e0827624b9c3eab7"></a>
@@ -516,6 +519,33 @@ <h2 class="memtitle"><span class="permalink"><a href="#a2c730711a4bc4daca565f90f
516519

517520
<p>Version string of the plug-in to display to the user. </p>
518521

522+
</div>
523+
</div>
524+
<a id="a37f87a4ecf4ec0d6d6cb20df7746ade7"></a>
525+
<h2 class="memtitle"><span class="permalink"><a href="#a37f87a4ecf4ec0d6d6cb20df7746ade7">&#9670;&nbsp;</a></span>supportsStoringAudioFileChunks()</h2>
526+
527+
<div class="memitem">
528+
<div class="memproto">
529+
<table class="mlabels">
530+
<tr>
531+
<td class="mlabels-left">
532+
<table class="memname">
533+
<tr>
534+
<td class="memname">virtual bool ARA::PlugIn::FactoryConfig::supportsStoringAudioFileChunks </td>
535+
<td>(</td>
536+
<td class="paramname"></td><td>)</td>
537+
<td> const</td>
538+
</tr>
539+
</table>
540+
</td>
541+
<td class="mlabels-right">
542+
<span class="mlabels"><span class="mlabel">virtual</span><span class="mlabel">noexcept</span></span> </td>
543+
</tr>
544+
</table>
545+
</div><div class="memdoc">
546+
547+
<p>Flag whether the plug-in supports exporting ARA audio file chunks via <a class="el" href="group___plug-_in___document___controller.html#a4759249602a579d2d561745eaa92182a" title="Create an archive of the internal state of the specified audio source suitable to be embedded into th...">ARADocumentControllerInterface::storeAudioSourceToAudioFileChunk()</a>. Note that reading such chunks is unaffected by this flag - as long as the documentArchiveID in the chunk is compatible, the plug-in must be able to read the data via <a class="el" href="group___plug-_in___document___controller.html#a6ad2b9f4070e12178057c3c9590f4c32" title="Unarchive the internal state of the specified objects. This call can be used both for unarchiving ent...">ARADocumentControllerInterface::restoreObjectsFromArchive()</a>. </p>
548+
519549
</div>
520550
</div>
521551

@@ -587,7 +617,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#ab1f2cdc93d55890bc575e29d
587617
<div class="line">{</div>
588618
<div class="line"> <span class="keywordflow">return</span> PlugInEntry::getPlugInEntry&lt;MyFactoryConfig, MyDocumentController&gt; ()-&gt;getFactory ();</div>
589619
<div class="line">}</div>
590-
<div class="ttc" id="agroup___plug-_in___factory_html_struct_a_r_a_factory"><div class="ttname"><a href="group___plug-_in___factory.html#struct_a_r_a_factory">ARAFactory</a></div><div class="ttdoc">Static plug-in factory. All pointers herein must remain valid as long as the binary is loaded....</div><div class="ttdef"><b>Definition:</b> ARAInterface.h:3092</div></div>
620+
<div class="ttc" id="agroup___plug-_in___factory_html_struct_a_r_a_factory"><div class="ttname"><a href="group___plug-_in___factory.html#struct_a_r_a_factory">ARAFactory</a></div><div class="ttdoc">Static plug-in factory. All pointers herein must remain valid as long as the binary is loaded....</div><div class="ttdef"><b>Definition:</b> ARAInterface.h:3109</div></div>
591621
</div><!-- fragment -->
592622
</div>
593623
</div>

html_docs/group___a_r_a___library___a_r_a_plug___plug_in_entry.js

+2-1
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,8 @@ var group___a_r_a___library___a_r_a_plug___plug_in_entry =
1313
[ "getManufacturerName", "group___a_r_a___library___a_r_a_plug___plug_in_entry.html#a30146dd7b21400d65c5c28c1e33fba03", null ],
1414
[ "getPlugInName", "group___a_r_a___library___a_r_a_plug___plug_in_entry.html#af287c0e453546bf7226b02d3a2a0fed7", null ],
1515
[ "getSupportedPlaybackTransformationFlags", "group___a_r_a___library___a_r_a_plug___plug_in_entry.html#af2b77443300649a0b4aac93f45666e55", null ],
16-
[ "getVersion", "group___a_r_a___library___a_r_a_plug___plug_in_entry.html#a2c730711a4bc4daca565f90fb08b292a", null ]
16+
[ "getVersion", "group___a_r_a___library___a_r_a_plug___plug_in_entry.html#a2c730711a4bc4daca565f90fb08b292a", null ],
17+
[ "supportsStoringAudioFileChunks", "group___a_r_a___library___a_r_a_plug___plug_in_entry.html#a37f87a4ecf4ec0d6d6cb20df7746ade7", null ]
1718
] ],
1819
[ "PlugInEntry", "group___a_r_a___library___a_r_a_plug___plug_in_entry.html#class_a_r_a_1_1_plug_in_1_1_plug_in_entry", [
1920
[ "getPlugInEntry", "group___a_r_a___library___a_r_a_plug___plug_in_entry.html#ab1f2cdc93d55890bc575e29d3c1bb585", null ]

0 commit comments

Comments
 (0)