.. _positional_information:

Positional information
======================

It is possible to see the precise positional and dimensional information of each item as packed. This is exposed as x,y,z
co-ordinates from origin, alongside width/length/depth in the packed orientation. ::

           z    y
           |   /
           |  /
           | /
           |/
           0------x

Example:

.. code-block:: php

    <?php

        // assuming packing already took place
        foreach ($packedBoxes as $packedBox) {
            $packedItems = $packedBox->items;
            foreach ($packedItems as $packedItem) { // $packedItem->item is your own item object
                echo $packedItem->item->getDescription() .  ' was packed at co-ordinate ' ;
                echo '(' . $packedItem->x . ', ' . $packedItem->y . ', ' . $packedItem->z . ') with ';
                echo 'w' . $packedItem->width . ', l' . $packedItem->length . ', d' . $packedItem->depth;
                echo PHP_EOL;
            }
        }

A :ref:`visualiser<visualiser>` is also available.