| | | 1 | | //======================================================================= |
| | | 2 | | // SwiftBoolArray2D.cs |
| | | 3 | | //======================================================================= |
| | | 4 | | // MIT License, Copyright (c) 2024-present David Oravsky (mrdav30) |
| | | 5 | | // See LICENSE file in the project root for full license information. |
| | | 6 | | //======================================================================= |
| | | 7 | | |
| | | 8 | | using System; |
| | | 9 | | using System.Text.Json.Serialization; |
| | | 10 | | using Chronicler; |
| | | 11 | | using Chronicler.Serialization; |
| | | 12 | | using MemoryPack; |
| | | 13 | | |
| | | 14 | | namespace SwiftCollections.Dimensions; |
| | | 15 | | |
| | | 16 | | /// <summary> |
| | | 17 | | /// Represents a 2D array specifically designed to handle boolean values. |
| | | 18 | | /// </summary> |
| | | 19 | | [Serializable] |
| | | 20 | | [JsonConverter(typeof(StateJsonConverterFactory))] |
| | | 21 | | [MemoryPackable] |
| | | 22 | | public partial class SwiftBoolArray2D : SwiftArray2D<bool>, IStateBacked<Array2DState<bool>> |
| | | 23 | | { |
| | | 24 | | #region Constructors |
| | | 25 | | |
| | | 26 | | /// <summary> |
| | | 27 | | /// Initializes a new instance of the SwiftBoolArray2D class. |
| | | 28 | | /// </summary> |
| | 2 | 29 | | public SwiftBoolArray2D() { } |
| | | 30 | | |
| | | 31 | | /// <summary> |
| | | 32 | | /// Initializes a new instance of the SwiftBoolArray2D class with the specified dimensions. |
| | | 33 | | /// </summary> |
| | | 34 | | /// <param name="width">The number of columns in the two-dimensional array. Must be greater than zero.</param> |
| | | 35 | | /// <param name="height">The number of rows in the two-dimensional array. Must be greater than zero.</param> |
| | 4 | 36 | | public SwiftBoolArray2D(int width, int height) : base(width, height) { } |
| | | 37 | | |
| | | 38 | | /// <summary> |
| | | 39 | | /// Initializes a new instance of the SwiftBoolArray2D class with the specified dimensions and default value. |
| | | 40 | | /// </summary> |
| | | 41 | | /// <param name="width">The number of columns in the two-dimensional array. Must be greater than zero.</param> |
| | | 42 | | /// <param name="height">The number of rows in the two-dimensional array. Must be greater than zero.</param> |
| | | 43 | | /// <param name="defaultValue">The initial boolean value assigned to each element in the array.</param> |
| | 12 | 44 | | public SwiftBoolArray2D(int width, int height, bool defaultValue) : base(width, height, defaultValue) { } |
| | | 45 | | |
| | | 46 | | /// <summary> |
| | | 47 | | /// Initializes a new instance of the SwiftBoolArray2D class using the specified two-dimensional Boolean array as th |
| | | 48 | | /// </summary> |
| | | 49 | | /// <param name="source">A two-dimensional array of Boolean values to initialize the array with. Cannot be null.</pa |
| | 2 | 50 | | public SwiftBoolArray2D(bool[,] source) : base(source) { } |
| | | 51 | | |
| | | 52 | | /// <summary> |
| | | 53 | | /// Initializes a new instance of the SwiftBoolArray2D class using the specified array state. |
| | | 54 | | /// </summary> |
| | | 55 | | /// <param name="state">The state object containing the two-dimensional array data and configuration to initialize t |
| | | 56 | | [MemoryPackConstructor] |
| | 4 | 57 | | public SwiftBoolArray2D(Array2DState<bool> state) : base(state) { } |
| | | 58 | | |
| | | 59 | | #endregion |
| | | 60 | | |
| | | 61 | | #region Collection Management |
| | | 62 | | |
| | | 63 | | /// <summary> |
| | | 64 | | /// Toggles the value at the specified position in the array. |
| | | 65 | | /// </summary> |
| | | 66 | | public void Toggle(int x, int y) |
| | | 67 | | { |
| | 1000002 | 68 | | this[x, y] = !this[x, y]; |
| | 1000002 | 69 | | } |
| | | 70 | | |
| | | 71 | | /// <summary> |
| | | 72 | | /// Sets all values within a rectangular region to the specified value. |
| | | 73 | | /// </summary> |
| | | 74 | | public void SetRegion(int xStart, int yStart, int width, int height, bool value) |
| | | 75 | | { |
| | 28 | 76 | | for (int x = xStart; x < xStart + width; x++) |
| | | 77 | | { |
| | 108 | 78 | | for (int y = yStart; y < yStart + height; y++) |
| | | 79 | | { |
| | 43 | 80 | | if (IsValidIndex(x, y)) |
| | 22 | 81 | | this[x, y] = value; |
| | | 82 | | } |
| | | 83 | | } |
| | 3 | 84 | | } |
| | | 85 | | |
| | | 86 | | #endregion |
| | | 87 | | |
| | | 88 | | #region Utility Methods |
| | | 89 | | |
| | | 90 | | /// <summary> |
| | | 91 | | /// Counts the number of true values in the array. |
| | | 92 | | /// </summary> |
| | | 93 | | public int CountTrue() |
| | | 94 | | { |
| | 6 | 95 | | int count = 0; |
| | 2000194 | 96 | | foreach (var cell in InnerArray) |
| | | 97 | | { |
| | 2000115 | 98 | | if (cell) count++; |
| | | 99 | | } |
| | 6 | 100 | | return count; |
| | | 101 | | } |
| | | 102 | | |
| | | 103 | | #endregion |
| | | 104 | | } |