doc/parts/dynamic/misc.sxml

   1 <!-- This file is part of Shapes.                                           -->
   2 <!--                                                                        -->
   3 <!-- Shapes is free software: you can redistribute it and/or modify         -->
   4 <!-- it under the terms of the GNU General Public License as published by   -->
   5 <!-- the Free Software Foundation, either version 3 of the License, or      -->
   6 <!-- any later version.                                                     -->
   7 <!--                                                                        -->
   8 <!-- Shapes is distributed in the hope that it will be useful,              -->
   9 <!-- but WITHOUT ANY WARRANTY; without even the implied warranty of         -->
  10 <!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the          -->
  11 <!-- GNU General Public License for more details.                           -->
  12 <!--                                                                        -->
  13 <!-- You should have received a copy of the GNU General Public License      -->
  14 <!-- along with Shapes.  If not, see <http://www.gnu.org/licenses/>.        -->
  15 <!--                                                                        -->
  16 <!-- Copyright 2008 Henrik Tidefelt                                         -->
  17
  18 <section id="dynamic/misc">
  19 <title>Other</title>
  20 <top>
  21         <p>Any dynamic variable not mentioned so far goes here.</p>
  22 </top>
  23
  24 <dynamic-variable name="eyez">
  25         <type><named-type name="Length" /></type>
  26         <constraint><self /> &gt; <physical><scalar>0</scalar><unit>bp</unit></physical> <b>or</b> <self /> = <eq>∞</eq></constraint>
  27         <default><physical><scalar>50</scalar><unit>cm</unit></physical></default>
  28         <description>
  29                 <p>When a <str-3D /> world is viewed through a pin-hole camera to obtain <str-2D /> image, the pin-hole camera (the eye) is located at <eq>( 0, 0, z<sub><rm>eye</rm></sub> )</eq>, and the image plane is <eq>z = 0</eq>.  The special float value <eq>∞</eq> can be used to place the eye at infinity, which will make the projection independent of <eq>z</eq> coordinates.</p>
  30         </description>
  31 </dynamic-variable>
  32
  33 <dynamic-variable name="TeX_bleed">
  34         <type><named-type name="Length" /></type>
  35         <default><physical><scalar>1</scalar><unit>bp</unit></physical></default>
  36         <description>
  37                 <p>The bounding boxes computed by <str-pdfLaTeX /> are generally too small to completely contain the glyph marks.  The reason appears to be that font designers tend to intentionally lie about the bounding box in order to achieve better type setting given existing type setting algorithms.</p>
  38                 <p>This causes a problem when such objects are at the boundary of the bounding box of page, since the page will then be slightly too small.  While perhaps just mildly irritating when the page is the end media, but when the output is included as a picture in a bigger document, the cropped glyphs become really disturbing.</p>
  39                 <p>The solution to this is to define a <em>bleed box</em> which is larger than the bounding box.  The bounding box will be used for layout as usual, but the bleed box is used when determining the crop box for the page.  To keep things simple, the size of the bleed box is controlled using this dynamic variable alone, which specifies how much the bleed box extends outside the bounding box in the <eq>x</eq> and <eq>y</eq> directions.</p>
  40         </description>
  41 </dynamic-variable>
  42
  43 </section>