💿🐜 Antkeeper source code https://antkeeper.com
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

239 lines
5.3 KiB

/*
* Copyright (C) 2021 Christopher J. Howard
*
* This file is part of Antkeeper source code.
*
* Antkeeper source code is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Antkeeper source code is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with Antkeeper source code. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef ANTKEEPER_GEOM_RECT_PACK_HPP
#define ANTKEEPER_GEOM_RECT_PACK_HPP
#include "geom/rect.hpp"
namespace geom {
/**
* Node used in 2D rectangle packing.
*
* @see geom::rect_pack
*/
template <class T>
struct rect_pack_node
{
/// Scalar type.
typedef T scalar_type;
/// Rect type.
typedef rect<T> rect_type;
/// Creates a rect pack node.
rect_pack_node();
/// Destroys a rect pack node and its children.
~rect_pack_node();
/// Pointers to the two children of the node, if any.
rect_pack_node* children[2];
/// Bounds of the node.
rect_type bounds;
/// `true` if the node is occupied, `false` otherwise.
bool occupied;
};
template <class T>
rect_pack_node<T>::rect_pack_node():
bounds{T(0), T(0), T(0), T(0)},
occupied(false)
{
children[0] = nullptr;
children[1] = nullptr;
}
template <class T>
rect_pack_node<T>::~rect_pack_node()
{
delete children[0];
delete children[1];
}
/**
* Packs 2D rectangles.
*
* @see geom::rect_pack_node
*
* @see http://www.blackpawn.com/texts/lightmaps/
*/
template <class T>
class rect_pack
{
public:
/// Scalar type.
typedef T scalar_type;
/// Node type.
typedef rect_pack_node<T> node_type;
/**
* Creates a rect pack and sets the bounds of the root node.
*
* @param w Width of the root node.
* @param h Height of the root node.
*/
rect_pack(scalar_type w, scalar_type h);
/**
* Creates an empty rect pack.
*/
rect_pack();
/**
* Clears the pack and resizes the root node bounds.
*
* @param w New width of the root node.
* @param h New height of the root node.
*
* @see rect_pack::clear()
*/
void resize(scalar_type w, scalar_type h);
/// Clear the pack, deallocating all nodes.
void clear();
/**
* Packs a rect into the rect pack.
*
* @param w Width of the rect.
* @param h Height of the rect.
* @return Pointer to the node in which the rect was packed, or `nullptr` if the rect could not be packed.
*/
const node_type* pack(scalar_type w, scalar_type h);
/// Returns a reference to the root node.
const node_type& get_root() const;
private:
static node_type* insert(node_type& parent, scalar_type w, scalar_type h);
static void free();
node_type root;
};
template <class T>
rect_pack<T>::rect_pack(scalar_type w, scalar_type h)
{
root.bounds = {T(0), T(0), w, h};
}
template <class T>
rect_pack<T>::rect_pack():
rect_pack(0, 0)
{}
template <class T>
void rect_pack<T>::resize(scalar_type w, scalar_type h)
{
clear();
root.bounds = {T(0), T(0), w, h};
}
template <class T>
void rect_pack<T>::clear()
{
delete root.children[0];
delete root.children[1];
root.children[0] = nullptr;
root.children[1] = nullptr;
root.occupied = false;
}
template <class T>
const typename rect_pack<T>::node_type* rect_pack<T>::pack(scalar_type w, scalar_type h)
{
return insert(root, w, h);
}
template <class T>
inline const typename rect_pack<T>::node_type& rect_pack<T>::get_root() const
{
return root;
}
template <class T>
typename rect_pack<T>::node_type* rect_pack<T>::insert(node_type& node, scalar_type w, scalar_type h)
{
// If not a leaf node
if (node.children[0] && node.children[1])
{
// Attempt to insert into first child
node_type* result = insert(*node.children[0], w, h);
if (result)
return result;
// Cannot fit in first child, attempt to insert into second child
return insert(*node.children[1], w, h);
}
// Abort if node occupied
if (node.occupied)
return nullptr;
// Determine node dimensions
scalar_type node_w = node.bounds.max.x - node.bounds.min.x;
scalar_type node_h = node.bounds.max.y - node.bounds.min.y;
// Check if rect is larger than node
if (w > node_w || h > node_h)
return nullptr;
// Check for a perfect fit
if (w == node_w && h == node_h)
{
node.occupied = true;
return &node;
}
// Split the node
node.children[0] = new node_type();
node.children[1] = new node_type();
// Determine split direction
scalar_type dw = node_w - w;
scalar_type dh = node_h - h;
if (dw > dh)
{
node.children[0]->bounds.min = node.bounds.min;
node.children[0]->bounds.max = {node.bounds.min.x + w, node.bounds.max.y};
node.children[1]->bounds.min = {node.bounds.min.x + w, node.bounds.min.y};
node.children[1]->bounds.max = {node.bounds.max};
}
else
{
node.children[0]->bounds.min = node.bounds.min;
node.children[0]->bounds.max = {node.bounds.max.x, node.bounds.min.y + h};
node.children[1]->bounds.min = {node.bounds.min.x, node.bounds.min.y + h};
node.children[1]->bounds.max = {node.bounds.max};
}
// Insert into first child
return insert(*node.children[0], w, h);
}
} // namespace geom
#endif // ANTKEEPER_GEOM_RECT_PACK_HPP