/// <summary>
/// Resize the buffer to a given size.
/// </summary>
/// <remarks>
/// Note that if the required capacity is larger than the current length of the populated buffer so far,
/// the buffer's contents in the new, expanded region are undefined.
/// </remarks>
/// <remarks>
/// Note that if the required capacity is smaller than the current length of the populated buffer so far,
/// the buffer will be truncated and items at the end of the buffer will be lost.
/// </remarks>
/// <remarks>
/// Note also that a negative capacity will result in the buffer being resized to zero.
/// </remarks>
/// <param name="capacity">Number of bits of required capacity.</param>
/// <returns>Returns the builder (for fluent-style composition).</returns>
public BitmapBuilder Resize(int capacity)
{
capacity = capacity < 0 ? 0 : capacity;
EnsureCapacity(capacity);
Length = capacity;
SetBitCount = BitUtility.CountBits(Span, 0, Length);
return(this);
}
/// <summary>
/// Resize the buffer to a given size.
/// </summary>
/// <remarks>
/// Note that if the required capacity is larger than the current length of the populated buffer so far,
/// the buffer's contents in the new, expanded region are undefined.
/// </remarks>
/// <remarks>
/// Note that if the required capacity is smaller than the current length of the populated buffer so far,
/// the buffer will be truncated and items at the end of the buffer will be lost.
/// </remarks>
/// <param name="capacity">Number of bits of required capacity.</param>
/// <returns>Returns the builder (for fluent-style composition).</returns>
public BitmapBuilder Resize(int capacity)
{
if (capacity < 0)
{
throw new ArgumentOutOfRangeException(nameof(capacity), "Capacity must be non-negative");
}
EnsureCapacity(capacity);
Length = capacity;
SetBitCount = BitUtility.CountBits(Span, 0, Length);
return(this);
}
