package grenier

  1. Overview
  2. Docs
A collection of various algorithms in OCaml

Install 

dune-project
 Dependency

github.com Readme Changelog Edit opam file Versions (11)

Authors

  1. F
    Frederic Bour <frederic.bour@lakaban.net>

Maintainers

  1. F
    Frederic Bour <frederic.bour@lakaban.net>

Sources

grenier-v0.12.tbz
sha256=b08e4c774ef72fc53c4fcee477e739d1beac9702079300daddf51ced9fa9cd26
sha512=984d92c51dac7b3f169cad595969a4fdbeb2be7b420ed1a85618d6adbb64af855cf2618d9bd0834e84d6734b99196944cab04435e1aeacad8cdfbc9a7f73d6d4

doc/grenier.binpacking/Maxrects/index.html

Module MaxrectsSource

Sourcetype 'bin t
Sourceval empty : 'bin t
Sourceval add_bin : 'bin -> int -> int -> 'bin t -> 'bin t

make ~width ~height return a packer ready to place stuff in a width * height area

Sourcetype 'tag box = {
  1. tag : 'tag;
  2. width : int;
  3. height : int;
  4. allow_rotation : bool;
    (*

    can the box be rotated to optimize packing

    *)
}

Input to packing is a box

Sourceval box : ?allow_rotation:bool -> 'tag -> int -> int -> 'tag box
Sourcetype ('bin, 'tag) rect = {
  1. x : int;
  2. y : int;
  3. w : int;
  4. h : int;
  5. rotated : bool;
    (*

    True iff the input box was rotated. If true, w = box.height && h = box.width Otherwise, w = box.width && h = box.height

    *)
  6. bin : 'bin;
  7. box : 'tag box;
}

Output of packing is an optional rectangle

Sourcetype heuristic = [
  1. | `Short_side_fit
    (*

    BSSF. Positions the rectangle against the short side of a free rectangle into which it fits the best.

    *)
  2. | `Long_side_fit
    (*

    BLSF: Positions the rectangle against the long side of a free rectangle into which it fits the best.

    *)
  3. | `Area_fit
    (*

    BAF: Positions the rectangle into the smallest free rect into which it fits.

    *)
  4. | `Bottom_left
    (*

    BL: Does the Tetris placement.

    *)
]
Sourceval insert : 'bin t -> ?heuristic:heuristic -> 'tag box -> 'bin t * ('bin, 'tag) rect option

Online insertion of one item. Efficient but the packing is not very good.

Worst-case: O(n^3) (n is total number of items inserted).

Sourceval insert_batch : 'bin t -> ?heuristic:heuristic -> 'tag box list -> 'bin t * ('bin, 'tag) rect option list

Online insertion of a batch of items. Runtime is roughly the cost of inserting each item independently, but order of insertion is chosen to give a better packing.

Worst-case: O(n^4) (n is total number of items inserted).

Sourceval insert_global : 'bin t -> ?heuristic:heuristic -> 'tag box list -> 'bin t * ('bin, 'tag) rect option list

Offline insertion. Better packing but way too slow for real-time usage.

Worst-case: O(n^5) (n is total number of items inserted).