image.htm 3.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  5. <title>Image</title>
  6. <link type="text/css" rel="stylesheet" href="../fpdf.css">
  7. </head>
  8. <body>
  9. <h1>Image</h1>
  10. <code>Image(<b>string</b> file [, <b>float</b> x [, <b>float</b> y [, <b>float</b> w [, <b>float</b> h [, <b>string</b> type [, <b>mixed</b> link]]]]]])</code>
  11. <h2>Description</h2>
  12. Place une image. Les dimensions occupées dans la page peuvent être indiquées de plusieurs manières :
  13. <ul>
  14. <li>largeur et hauteur explicites (exprimées dans l'unité utilisateur)</li>
  15. <li>une dimension explicite, l'autre étant calculée automatiquement afin de respecter les
  16. proportions de l'image originale</li>
  17. <li>aucune dimension explicite, auquel cas l'image est dimensionnée en 72 dpi</li>
  18. </ul>
  19. Les formats supportés sont le JPEG, le PNG et le GIF. Le GIF nécessite l'extension GD.
  20. <br>
  21. <br>
  22. Pour le JPEG, toutes les variantes sont autorisées :
  23. <ul>
  24. <li>niveaux de gris</li>
  25. <li>couleurs vraies (24 bits)</li>
  26. <li>CMYK (32 bits)</li>
  27. </ul>
  28. Pour le PNG, sont autorisées :
  29. <ul>
  30. <li>les images en niveaux de gris sur 8 bits au plus (256 teintes)</li>
  31. <li>les images en couleurs indexées</li>
  32. <li>les images en couleurs vraies (24 bits)</li>
  33. </ul>
  34. mais ne sont pas supportés :
  35. <ul>
  36. <li>L'interlacement</li>
  37. <li>L'alpha channel</li>
  38. </ul>
  39. Pour le GIF : en cas de GIF animé, seule la première image est utilisée.<br>
  40. <br>
  41. Si une couleur transparente est définie, elle est prise en compte.<br>
  42. <br>
  43. Le format peut être spécifié explicitement ou bien déduit de l'extension du fichier.<br>
  44. Il est possible de mettre un lien sur l'image.<br>
  45. <br>
  46. Remarque : si une image est utilisée plusieurs fois, une seule copie est intégrée au document.
  47. <h2>Paramètres</h2>
  48. <dl class="param">
  49. <dt><code>file</code></dt>
  50. <dd>
  51. Chemin ou URL de l'image.
  52. </dd>
  53. <dt><code>x</code></dt>
  54. <dd>
  55. Abscisse du coin supérieur gauche. Si non précisée ou égale à <code>null</code>, l'abscisse courante
  56. est utilisée.
  57. </dd>
  58. <dt><code>y</code></dt>
  59. <dd>
  60. Ordonnée du coin supérieur gauche. Si non précisée ou égale à <code>null</code>, l'ordonnée courante
  61. est utilisée ; de plus, un saut de page est d'abord effectué si nécessaire (en cas de saut de page
  62. automatique) ; puis, après l'appel, l'ordonnée courante est positionnée en bas de l'image.
  63. </dd>
  64. <dt><code>w</code></dt>
  65. <dd>
  66. Largeur de l'image dans la page. Si elle n'est pas indiquée ou vaut zéro, elle est calculée
  67. automatiquement.
  68. </dd>
  69. <dt><code>h</code></dt>
  70. <dd>
  71. Hauteur de l'image dans la page. Si elle n'est pas indiquée ou vaut zéro, elle est calculée
  72. automatiquement.
  73. </dd>
  74. <dt><code>type</code></dt>
  75. <dd>
  76. Format de l'image. Les valeurs possibles sont (indépendamment de la casse) : <code>JPG</code>,
  77. <code>JPEG</code>, <code>PNG</code> et <code>GIF</code>.
  78. S'il n'est pas précisé, le type est déduit de l'extension du fichier.
  79. </dd>
  80. <dt><code>link</code></dt>
  81. <dd>
  82. URL ou identifiant retourné par AddLink().
  83. </dd>
  84. </dl>
  85. <h2>Voir</h2>
  86. <a href="addlink.htm">AddLink()</a>.
  87. <hr style="margin-top:1.5em">
  88. <div style="text-align:center"><a href="index.htm">Index</a></div>
  89. </body>
  90. </html>