Document settings
*****************

Page orientation
----------------

You can use between ``landscape`` and ``portrait`` (default) page orientation.

.. code-block:: php
    
    <?php
    // rtf document instance
    $rtf = new PHPRtfLite();
    // landscape page orientation
    $rtf->setLandscape();


.. _doc-settings_page-margins:
   
Page margins
------------

You can set margins for the document and for sections, too. Section margins will overwrite document margins.

.. code-block:: php
    
    <?php
    $rtf = new PHPRtfLite();
    // margin left: 1cm
    $rtf->setMarginLeft(1);
    // margin right: 2cm
    $rtf->setMarginRight(2);
    // margin top: 3cm
    $rtf->setMarginTop(3);
    // margin bottom: 4cm
    $rtf->setMarginBottom(4);
    

The code example below does the same in a shorter way.
    
.. code-block:: php

    <?php
    $rtf = new PHPRtfLite();
    // margins: left 1cm, top 3cm, right 2cm, bottom 4cm
    $rtf->setMargins(1, 3, 2, 4);

    
You can define that odd and even pages uses mirrored margins. Section margins can be mirrored, too, and will overwrite the document setting.

.. code-block:: php

    <?php
    $rtf = new PHPRtfLite();
    // margin left: 2cm
    $rtf->setMarginLeft(2);
    // margin right: 1cm
    $rtf->setMarginRight(1);
    // odd pages: left 2cm, right 1cm
    // even pages: left 1cm, right 2cm
    $rtf->setMirrorMarings();
    
.. _doc-settings_page-size:
    
Page size
---------

The paper width and height can be set for sections, too, which will overwrite the document settings.

.. code-block:: php

    <?php
    $rtf = new PHPRtfLite();
    $rtf->setPaperWidth(14);  // in cm
    $rtf->setPaperHeight(25); // in cm

    
Units in RTF
==========================

RTF uses TWIP ("TWentieth of an Inch Point" - 1/20 Point = 1/1440 Inch) [#f1]_ as internal unit. PHPRtfLite uses centimeter as default unit for all measuring unit inputs.

.. code-block:: php

    <?php
    PHPRtfLite_Unit::setGlobalUnit(PHPRtfLite_Unit::UNIT_CM);    // inputs used as centimeters
    PHPRtfLite_Unit::setGlobalUnit(PHPRtfLite_Unit::UNIT_INCH);  // inputs used as inches
    PHPRtfLite_Unit::setGlobalUnit(PHPRtfLite_Unit::UNIT_POINT); // inputs used as points


.. [#f1] `<http://en.wikipedia.org/wiki/Twip>`_

    
Character set (text input)
==========================

.. code-block:: php

    <?php
    $rtf = new PHPRtfLite();
    $rtf->setCharset('Latin1');  // use Latin1 instead of UTF-8
    
    
Hyphenation
=====================

.. code-block:: php

    <?php
    $rtf = new PHPRtfLite();
    $rtf->setHyphenation();
