.. _toolbox:

Toolbox
=======

Selection Tools
---------------

**Selection**
   |Tool Select| - Primary tool to select items on canvas and perform simple transformation operations.


Content Tools
-------------

**Text Frame**
   |Tool Text Frame| - Insert a text frame.

**Image Frame**
   |Tool Image Frame| - Insert an image frame.

**Render Frame**
   |Tool Render Frame| - Insert a render frame.

**Table**
   |Tool Table| - Insert a table.


Shape Tools
-----------

**Shapes**
   |Tool Rectangle| - Insert a predefined shape. Hold :kbd:`LMB` to select different shapes from a list.

**Polygon**
   |Tool Polygon| - Insert a polygon shape.

**Arc**
   |Tool Arc| - Insert an arc shape.

**Spiral**
   |Tool Spiral| - Insert a spiral shape.

**Line**
   |Tool Line| - Insert a straight line.

**Barcode**
   |Tool Barcode| - Insert a barcode or QR code.


Drawing Tools
-------------

**Draw Bezier**
   |Tool Draw Bezier| - Draw a bezier curve.

**Draw Freehand**
   |Tool Draw Freehand| - Draw a freehand curve.

**Draw Calligraphy**
   |Tool Draw Calligraphy| - Draw a calligraphy curve.


Transformation Tools
--------------------

**Rotate**
   |Tool Rotate| - Rotate page items.


Navigation Tools
----------------

**Zoom**
   |Tool Zoom| - Zoom in and out on canvas

**Panning**
   |Tool Panning| - Move viewport on canvas. Press :kbd:`Space` on canvas to activate or deactivate panning. 


Editing Tools
-------------

**Edit Content**
   |Tool Edit Content| - Toggle a page item into editing mode.

**Story Editor**
   |Tool Story Editor| - Open :ref:`Story Editor <story-editor>` for text editing. Only for :ref:`Text Frames <text-frames>`.

**Link Text Frames**
   |Tool Link Textframe| - Link two text frames. Overflowing text of the first text frame will be display in the second text frame. 

**Unlink Text Frames**
   |Tool Unlink Textframe| - Unlink two text frames.

**Copy Frame Style**
   |Tool Copy Style| - Copy frame style properties from selected page item to another one.


Measuring Tools
---------------

**Measurements**
   |Tool Measurement| - Mesurement tool to measure positions, distances and angles.

**Eye Dropper**
   |Tool Eye Dropper| - Pick a color from any pixel under the cursor.



.. |Tool Select| image:: _img/tool-select.svg
  :width: 24
.. |Tool Text Frame| image:: _img/tool-insert-text-frame.svg
  :width: 24
.. |Tool Image Frame| image:: _img/tool-insert-image.svg
  :width: 24
.. |Tool Render Frame| image:: _img/tool-insert-render-frame.svg
  :width: 24
.. |Tool Table| image:: _img/tool-insert-table.svg
  :width: 24
.. |Tool Rectangle| image:: _img/draw-rectangle.svg
  :width: 24
.. |Tool Polygon| image:: _img/tool-insert-polygon.svg
  :width: 24
.. |Tool Arc| image:: _img/tool-insert-arc.svg
  :width: 24
.. |Tool Spiral| image:: _img/tool-insert-spiral.svg
  :width: 24
.. |Tool Line| image:: _img/tool-insert-line.svg
  :width: 24
.. |Tool Draw Bezier| image:: _img/tool-draw-bezier.svg
  :width: 24
.. |Tool Draw Freehand| image:: _img/tool-draw-freehand.svg
  :width: 24
.. |Tool Draw Calligraphy| image:: _img/tool-draw-calligraphy.svg
  :width: 24
.. |Tool Rotate| image:: _img/tool-rotate.svg
  :width: 24
.. |Tool Zoom| image:: _img/tool-zoom.svg
  :width: 24
.. |Tool Panning| image:: _img/cursor-hand.svg
  :width: 24
.. |Tool Edit Content| image:: _img/tool-edit-content.svg
  :width: 24
.. |Tool Story Editor| image:: _img/tool-story-editor.svg
  :width: 24
.. |Tool Link Textframe| image:: _img/tool-link-text-frame.svg
  :width: 24
.. |Tool Unlink Textframe| image:: _img/tool-unlink-text-frame.svg
  :width: 24
.. |Tool Measurement| image:: _img/tool-ruler.svg
  :width: 24
.. |Tool Eye Dropper| image:: _img/tool-color-picker.svg
  :width: 24
.. |Tool Copy Style| image:: _img/tool-copy-style.svg
  :width: 24
.. |Tool Barcode| image:: _img/tool-insert-barcode.svg
  :width: 24