/// <summary>
/// Merges all the <see cref="ModelRoot.LogicalBuffers"/> instances into a single, big one.
/// </summary>
/// <remarks>
/// When merging the buffers, it also adjusts the BufferView offsets so the data they point to remains the same.
///
/// If images are required to be included in the binary, call <see cref="ModelRoot.MergeImages"/> before calling <see cref="MergeBuffers"/>
///
/// This action cannot be reversed.
/// </remarks>
public void MergeBuffers()
{
// retrieve all buffers and merge them into a single, big buffer
var views = _bufferViews
.OrderByDescending(item => item.Content.Count)
.ToArray();
if (views.Length <= 1)
{
return; // nothing to do.
}
var sbbuilder = new _StaticBufferBuilder(0);
foreach (var bv in views)
{
bv._IsolateBufferMemory(sbbuilder);
}
this._buffers.Clear();
var b = new Buffer(sbbuilder.ToArray());
this._buffers.Add(b);
}
/// <summary>
/// Merges all the <see cref="LogicalBuffers"/> instances into a single big one.
/// </summary>
/// <remarks>
/// <para>
/// When merging the buffers, it also adjusts the BufferView offsets so the data they point to remains the same.
/// </para>
/// <para>
/// If images are required to be included in the binary, call <see cref="MergeImages"/>
/// before calling <see cref="MergeBuffers()"/>.
/// </para>
/// </remarks>
/// <exception cref="InvalidOperationException">
/// .Net arrays have an upper limit of 2Gb, so this is the biggest a buffer can normally grow,
/// so attempting to merge buffers that sum more than 2Gb will throw this exception.
/// </exception>
public void MergeBuffers()
{
// retrieve all buffers and merge them into a single, big buffer
var views = _bufferViews
.OrderByDescending(item => item.Content.Count)
.ToList();
if (views.Count <= 1)
{
return; // nothing to do.
}
// check final size
long totalLen = views.Sum(item => (long)item.Content.Count.WordPadded());
if (totalLen >= (long)int.MaxValue)
{
throw new InvalidOperationException("Can't merge a buffer larger than 2Gb");
}
// begin merge
var sbbuilder = new _StaticBufferBuilder(0);
foreach (var bv in views)
{
bv._IsolateBufferMemory(sbbuilder);
}
// build final buffer
this._buffers.Clear();
var b = new Buffer(sbbuilder.ToArray());
this._buffers.Add(b);
}
