You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

useragent.xml 4.4KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114
  1. <?xml version="1.0" encoding="UTF-8" standalone="no"?>
  2. <!--
  3. Licensed to the Apache Software Foundation (ASF) under one or more
  4. contributor license agreements. See the NOTICE file distributed with
  5. this work for additional information regarding copyright ownership.
  6. The ASF licenses this file to You under the Apache License, Version 2.0
  7. (the "License"); you may not use this file except in compliance with
  8. the License. You may obtain a copy of the License at
  9. http://www.apache.org/licenses/LICENSE-2.0
  10. Unless required by applicable law or agreed to in writing, software
  11. distributed under the License is distributed on an "AS IS" BASIS,
  12. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. See the License for the specific language governing permissions and
  14. limitations under the License.
  15. -->
  16. <!-- $Id$ -->
  17. <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd">
  18. <document>
  19. <header>
  20. <title>Apache™ FOP Design: User Agent</title>
  21. <version>$Revision$</version>
  22. <authors>
  23. <person name="Keiron Liddle" email="keiron@aftexsw.com"/>
  24. </authors>
  25. </header>
  26. <body>
  27. <section id="intro">
  28. <title>Introduction</title>
  29. <p>
  30. Technically the user agent is Apache™ FOP in the role of determining the
  31. output format and when resolving various attributes. The user
  32. agent is represented by a class that is available to others to
  33. specify how FOP should behave.
  34. </p>
  35. <p>
  36. The user agent is used by the formatting process to determine
  37. certain user definable values.
  38. </p>
  39. <p>
  40. It will enable the customisation of values for generating and
  41. rendering the document.
  42. </p>
  43. <p>
  44. The user agent must be available to the layout processor and
  45. the renderer. Users can supply their own user agent or use
  46. the default one for a particular renderer.
  47. </p>
  48. <p>
  49. The user agent needs to be made available to the property
  50. resolution layout process and the renderer.
  51. </p>
  52. <p>
  53. Standard Features:
  54. </p>
  55. <ul>
  56. <li>error handling, what to do if fo markup is invalid</li>
  57. <li>auto overflow value and handling error-if-overflow</li>
  58. <li>adjusting length values (eg. for borders) to renderable values</li>
  59. <li>available fonts</li>
  60. <li>converting cm/in to pt (dpi)</li>
  61. <li>active state for multi properties</li>
  62. <li>title, used to identify a set of pages (in a page sequence)</li>
  63. <li>the width (in inline-progression-dimension) of a character with
  64. treat-word-as-space true</li>
  65. <li>maximum space used by conditional areas from region-reference-area</li>
  66. <li>if there should be "hot links" to before floats or footnotes</li>
  67. <li>when to clear side floats if space in inline-progression-dimension
  68. is not enough</li>
  69. <li>placement of left over footnotes on a page with a region-body</li>
  70. <li>using color property as border colour</li>
  71. <li>interpretting all border styles (except outset) as solid</li>
  72. <li>thin, medium and thick values for border width</li>
  73. <li>initial font-family value</li>
  74. <li>absolute font sizes (eg, xx-small, x-small etc.)</li>
  75. <li>relative font sizes (eg. larger, smaller)</li>
  76. <li>small caps simulation</li>
  77. <li>font weight mapping</li>
  78. <li>baseline info for a font if not available</li>
  79. <li>determining sub/superscript when another baseline is dominant</li>
  80. <li>scaling method for external-graphic and instream-foreign-object</li>
  81. <li>the width of a replaced element</li>
  82. <li>"normal" line height value</li>
  83. <li>text alignment (stretching the line with letter and word spacing)</li>
  84. <li>text transform</li>
  85. <li>initial color</li>
  86. <li>rendering intent of auto</li>
  87. <li>dot character for leader</li>
  88. <li>line breaking with leaders, use optimum length when breaking the line</li>
  89. <li>page height/width of auto</li>
  90. <li>left and right caption widths</li>
  91. <li>glyph orientation vertical of auto</li>
  92. <li>rendering processor of content-type (mime type)</li>
  93. </ul>
  94. <p>
  95. Interactive Features:
  96. </p>
  97. <ul>
  98. <li>inline and block scroll amount</li>
  99. <li>dynamic effects, links and property sets</li>
  100. <li>initial "pause-after", "pause-before" and "voice-family" value</li>
  101. <li>treating fixed as scroll on background attachement</li>
  102. <li>media usage of auto</li>
  103. </ul>
  104. </section>
  105. </body>
  106. </document>