mergeArtifact method

void mergeArtifact(
  1. Artifact toMerge
)

Merges the current artifact with another artifact.

This method combines the current artifact with the provided artifact, creating a new, larger artifact that encompasses both.

Parameters:

  • toMerge: The Artifact to be merged with the current artifact.

The merging process involves:

  1. Creating a new rectangle that encompasses both artifacts.
  2. Creating a new matrix (grid) large enough to contain both artifacts' data.
  3. Copying the data from both artifacts into the new matrix.
  4. Updating the current artifact's matrix and rectangle to reflect the merged state.

Note: This method modifies the current artifact in-place.

Implementation

void mergeArtifact(final Artifact toMerge) {
  // Create a new rectangle that encompasses both artifacts
  final IntRect newRect = IntRect.fromLTRB(
    min(rectFound.left, toMerge.rectFound.left),
    min(rectFound.top, toMerge.rectFound.top),
    max(rectFound.right, toMerge.rectFound.right),
    max(rectFound.bottom, toMerge.rectFound.bottom),
  );

  // Create a new grid that can fit both artifacts
  final Artifact newGrid = Artifact(newRect.width, newRect.height);

  // Copy both grids onto the new grid with correct offsets
  copyArtifactGrid(
    this,
    newGrid,
    (rectFound.left - newRect.left),
    (rectFound.top - newRect.top),
  );

  copyArtifactGrid(
    toMerge,
    newGrid,
    (toMerge.rectFound.left - newRect.left),
    (toMerge.rectFound.top - newRect.top),
  );

  // Update this artifact with the merged data
  setGrid(newGrid._matrix, newGrid.cols);
}