PageRenderTime 916ms CodeModel.GetById 22ms RepoModel.GetById 0ms app.codeStats 0ms

/projects/ant-1.8.2/docs/manual/Tasks/image.html

https://gitlab.com/essere.lab.public/qualitas.class-corpus
HTML | 261 lines | 217 code | 25 blank | 19 comment | 0 complexity | 3c40e8b98a8c48168d77cdaa4041ed3e MD5 | raw file
    

  1. <!--

    2. 

  2.    Licensed to the Apache Software Foundation (ASF) under one or more

    3. 

  3.    contributor license agreements.  See the NOTICE file distributed with

    4. 

  4.    this work for additional information regarding copyright ownership.

    5. 

  5.    The ASF licenses this file to You under the Apache License, Version 2.0

    6. 

  6.    (the "License"); you may not use this file except in compliance with

    7. 

  7.    the License.  You may obtain a copy of the License at

    8. 

  8. 

    9. 

  9.        http://www.apache.org/licenses/LICENSE-2.0

    10. 

  10. 

    11. 

  11.    Unless required by applicable law or agreed to in writing, software

    12. 

  12.    distributed under the License is distributed on an "AS IS" BASIS,

    13. 

  13.    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    14. 

  14.    See the License for the specific language governing permissions and

    15. 

  15.    limitations under the License.

    16. 

  16. -->

    17. 

  17. <html>

    18. 

  18. 

    19. 

  19. <head>

    20. 

  20. <meta http-equiv="Content-Language" content="en-us">

    21. 

  21. <link rel="stylesheet" type="text/css" href="../stylesheets/style.css">

    22. 

  22. <title>Image Task</title>

    23. 

  23. </head>

    24. 

  24. 

    25. 

  25. <body>

    26. 

  26. 

    27. 

  27. <h2><a name="image">Image</a></h2>

    28. 

  28. <h3>Description</h3>

    29. 

  29. <p>Applies a chain of image operations on a set of files.</p>

    30. 

  30. <p>Requires Java Advanced Image API from Sun.</p>

    31. 

  31. 

    32. 

  32. <h5>Overview of used datatypes</h5>

    33. 

  33. <img src="image-classdiagram.gif" border="0" alt="Class-Diagram">

    34. 

  34. 

    35. 

  35. <h3>Parameters</h3>

    36. 

  36. <table border="1" cellpadding="2" cellspacing="0">

    37. 

  37.   <tr>

    38. 

  38.     <td valign="top"><b>Attribute</b></td>

    39. 

  39.     <td valign="top"><b>Description</b></td>

    40. 

  40.     <td align="center" valign="top"><b>Required</b></td>

    41. 

  41.   </tr>

    42. 

  42.   <tr>

    43. 

  43.     <td valign="top"> failonerror </td>

    44. 

  44.     <td valign="top"> Boolean value. If false, note errors to the output but keep going. </td>

    45. 

  45.     <td align="center"> no (defaults to <i>true</i>) </td>

    46. 

  46.   </tr>

    47. 

  47.   <tr>

    48. 

  48.     <td valign="top"> srcdir </td>

    49. 

  49.     <td valign="top"> Directory containing the images. </td>

    50. 

  50.     <td align="center"> yes, unless nested fileset is used </td>

    51. 

  51.   </tr>

    52. 

  52.   <tr>

    53. 

  53.     <td valign="top"> encoding </td>

    54. 

  54.     <td valign="top"> Image encoding type. <br>

    55. 

  55.       Valid (caseinsensitive) are: jpg, jpeg, tif, tiff

    56. 

  56.     </td>

    57. 

  57.     <td align="center"> no (defaults to <i>JPEG</i>) </td>

    58. 

  58.   </tr>

    59. 

  59.   <tr>

    60. 

  60.     <td valign="top"> overwrite </td>

    61. 

  61.     <td valign="top"> Boolean value. Sets whether or not to overwrite

    62. 

  62.       a file if there is naming conflict.

    63. 

  63.     </td>

    64. 

  64.     <td align="center"> no (defaults to <i>false</i>) </td>

    65. 

  65.   </tr>

    66. 

  66.   <tr>

    67. 

  67.     <td valign="top"> gc </td>

    68. 

  68.     <td valign="top"> Boolean value. Enables garbage collection after

    69. 

  69.       each image processed.

    70. 

  70.     </td>

    71. 

  71.     <td align="center"> no (defaults to <i>false</i>) </td>

    72. 

  72.   </tr>

    73. 

  73.   <tr>

    74. 

  74.     <td valign="top"> destdir </td>

    75. 

  75.     <td valign="top"> Directory where the result images are stored. </td>

    76. 

  76.     <td align="center"> no (defaults to value of <i>srcdir</i>) </td>

    77. 

  77.   </tr>

    78. 

  78.   <!-- attributes inherited from MatchingTask -->

    79. 

  79.   <tr>

    80. 

  80.     <td valign="top">includes</td>

    81. 

  81.     <td valign="top">comma- or space-separated list of patterns of files that must be

    82. 

  82.       included. All files are included when omitted.</td>

    83. 

  83.     <td valign="top" align="center">No</td>

    84. 

  84.   </tr>

    85. 

  85.   <tr>

    86. 

  86.     <td valign="top">includesfile</td>

    87. 

  87.     <td valign="top">the name of a file. Each line of this file is

    88. 

  88.       taken to be an include pattern</td>

    89. 

  89.     <td valign="top" align="center">No</td>

    90. 

  90.   </tr>

    91. 

  91.   <tr>

    92. 

  92.     <td valign="top"> excludes</td>

    93. 

  93.     <td valign="top">comma- or space-separated list of patterns of files that must be

    94. 

  94.       excluded. No files (except default excludes) are excluded when omitted.</td>

    95. 

  95.     <td valign="top" align="center">No</td>

    96. 

  96.   </tr>

    97. 

  97.   <tr>

    98. 

  98.     <td valign="top">excludesfile</td>

    99. 

  99.     <td valign="top">the name of a file. Each line of this file is

    100. 

  100.       taken to be an exclude pattern</td>

    101. 

  101.     <td valign="top" align="center">No</td>

    102. 

  102.   </tr>

    103. 

  103.   <tr>

    104. 

  104.     <td valign="top">defaultexcludes</td>

    105. 

  105.     <td valign="top">indicates whether default excludes should be used or not

    106. 

  106.       (&quot;yes&quot;/&quot;no&quot;). Default excludes are used when omitted.</td>

    107. 

  107.     <td valign="top" align="center">No</td>

    108. 

  108.   </tr>

    109. 

  109.   <tr>

    110. 

  110.     <td valign="top"> caseSensitive </td>

    111. 

  111.     <td valign="top"> Boolean value. Sets case sensitivity of the file system. </td>

    112. 

  112.     <td align="center"> no (defaults to <i>false</i>) </td>

    113. 

  113.   </tr>

    114. 

  114.   <tr>

    115. 

  115.     <td valign="top"> followSymlinks </td>

    116. 

  116.     <td valign="top"> Boolean value. Sets whether or not symbolic links should be followed. </td>

    117. 

  117.     <td align="center"> no (defaults to <i>true</i>) </td>

    118. 

  118.   </tr>

    119. 

  119. </table>

    120. 

  120. 

    121. 

  121. <h3>Parameters specified as nested elements</h3>

    122. 

  122. <p>This task forms an implicit <a href="../Types/fileset.html">FileSet</a> and

    123. 

  123. supports most attributes of <code>&lt;fileset&gt;</code> as well as the

    124. 

  124. nested <code>&lt;include&gt;</code>, <code>&lt;exclude&gt;</code> and

    125. 

  125. <code>&lt;patternset&gt;</code> elements.</p>

    126. 

  126. 

    127. 

  127. 

    128. 

  128. <h4>ImageOperation</h4>

    129. 

  129. <p>Adds an ImageOperation to chain.</p>

    130. 

  130. <h5>Nested Elements</h5>

    131. 

  131. ImageOperation can handle nested Rotate, Draw, Rectangle, Text and Scale objects.

    132. 

  132. 

    133. 

  133. <h4>Rotate</h4>

    134. 

  134. <p>Adds a Rotate ImageOperation to chain.</p>

    135. 

  135. <h5>Parameters</h5>

    136. 

  136. <table border="1" cellpadding="2" cellspacing="0">

    137. 

  137.   <tr>

    138. 

  138.     <td valign="top"><b>Attribute</b></td>

    139. 

  139.     <td valign="top"><b>Description</b></td>

    140. 

  140.     <td align="center" valign="top"><b>Required</b></td>

    141. 

  141.   </tr>

    142. 

  142.   <tr>

    143. 

  143.     <td valign="top"> angle </td>

    144. 

  144.     <td valign="top"> Float value. Sets the angle of rotation in degrees. </td>

    145. 

  145.     <td align="center"> no (defaults to <i>0.0F</i>) </td>

    146. 

  146.   </tr>

    147. 

  147. </table>

    148. 

  148. 

    149. 

  149. <h4>Scale</h4>

    150. 

  150. <p>Adds a Scale ImageOperation to chain.</p>

    151. 

  151. <h5>Parameters</h5>

    152. 

  152. <table border="1" cellpadding="2" cellspacing="0">

    153. 

  153.   <tr>

    154. 

  154.     <td valign="top"><b>Attribute</b></td>

    155. 

  155.     <td valign="top"><b>Description</b></td>

    156. 

  156.     <td align="center" valign="top"><b>Required</b></td>

    157. 

  157.   </tr>

    158. 

  158.     <td valign="top"> proportions </td>

    159. 

  159.     <td valign="top"> Sets which dimension to control proportions from. Valid values are:<ul>

    160. 

  160.         <li>&quot;ignore&quot; -  treat the dimensions independently.</li>

    161. 

  161.         <li>&quot;height&quot; - keep proportions based on the width.</li>

    162. 

  162.         <li>&quot;width&quot; - keep proportions based on the height.</li>

    163. 

  163.         <li>&quot;cover&quot; - keep proportions and fit in the supplied dimensions.</li>

    164. 

  164.         <li>&quot;fit&quot; - keep proportions and cover the supplied dimensions.</li>

    165. 

  165.     </ul></td>

    166. 

  166.     <td align="center"> no (defaults to <i>ignore</i>) </td>

    167. 

  167.   <tr>

    168. 

  168.     <td valign="top"> width </td>

    169. 

  169.     <td valign="top"> Sets the width of the image, either as an integer or a %. </td>

    170. 

  170.         <!-- todo: if integer, what kind? cm, px, inches, ... -->

    171. 

  171.     <td align="center"> no (defaults to <i>100%</i>) </td>

    172. 

  172.   </tr>

    173. 

  173.   <tr>

    174. 

  174.     <td valign="top"> height </td>

    175. 

  175.     <td valign="top"> Sets the height of the image, either as an integer or a %. </td>

    176. 

  176.         <!-- todo: if integer, what kind? cm, px, inches, ... -->

    177. 

  177.     <td align="center"> no (defaults to <i>100%</i>) </td>

    178. 

  178.   </tr>

    179. 

  179. </table>

    180. 

  180. 

    181. 

  181. <h4>Draw</h4>

    182. 

  182. <p>Adds a Draw ImageOperation to chain. DrawOperation DataType objects can be

    183. 

  183. nested inside the Draw object.</p>

    184. 

  184. <h5>Parameters</h5>

    185. 

  185. <table border="1" cellpadding="2" cellspacing="0">

    186. 

  186.   <tr>

    187. 

  187.     <td valign="top"><b>Attribute</b></td>

    188. 

  188.     <td valign="top"><b>Description</b></td>

    189. 

  189.     <td align="center" valign="top"><b>Required</b></td>

    190. 

  190.   </tr>

    191. 

  191.   <tr>

    192. 

  192.     <td valign="top"> xloc </td>

    193. 

  193.     <td valign="top"> X-Position where to draw nested image elements. </td>

    194. 

  194.     <td align="center"> no (defaults to <i>0</i>) </td>

    195. 

  195.   </tr>

    196. 

  196.   <tr>

    197. 

  197.     <td valign="top"> yloc </td>

    198. 

  198.     <td valign="top"> Y-Position where to draw nested image elements. </td>

    199. 

  199.     <td align="center"> no (defaults to <i>0</i>) </td>

    200. 

  200.   </tr>

    201. 

  201. </table>

    202. 

  202. 

    203. 

  203. <h4>mapper</h4>

    204. 

  204. <p><em>Since Apache Ant 1.8.0</em></p>

    205. 

  205. 

    206. 

  206. <p>You can define filename transformations by using a

    207. 

  207.   nested <a href="../Types/mapper.html">mapper</a> element. The

    208. 

  208.   default mapper used by

    209. 

  209.   <code>&lt;image&gt;</code> is

    210. 

  210.   the <a href="../Types/mapper.html#identity-mapper">identity

    211. 

  211.   mapper</a>.</p>

    212. 

  212. 

    213. 

  213. <p>You can also use a filenamemapper type in place of the mapper

    214. 

  214.   element.</p>

    215. 

  215. 

    216. 

  216. <h3>Examples</h3>

    217. 

  217. 

    218. 

  218. <blockquote><pre>

    219. 

  219. &nbsp;&lt;image destdir="samples/low" overwrite="yes"&gt;

    220. 

  220. &nbsp;&nbsp;&nbsp;&nbsp; &lt;fileset dir="samples/full"&gt;

    221. 

  221. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;include name="**/*.jpg"/&gt;

    222. 

  222. &nbsp;&nbsp;&nbsp;&nbsp; &lt;/fileset&gt;

    223. 

  223. &nbsp;&nbsp;&nbsp;&nbsp; &lt;scale width="160" height="160" proportions="fit"/&gt;

    224. 

  224. &nbsp;&lt;/image&gt;

    225. 

  225. </pre></blockquote>

    226. 

  226. <p>Create thumbnails of my images and make sure they all fit within the 160x160 size whether the

    227. 

  227. image is portrait or landscape.</p>

    228. 

  228. 

    229. 

  229. <blockquote><pre>

    230. 

  230. &lt;image srcdir="src" includes="*.png"&gt;

    231. 

  231.     &lt;scale proportions="width" width="40"/&gt;

    232. 

  232. &lt;/image&gt;

    233. 

  233. </pre></blockquote>

    234. 

  234. <p>Creates a thumbnail for all PNG-files in <i>src</i> in the size of 40 pixel keeping the proportions

    235. 

  235. and stores the <i>src</i>.</p>

    236. 

  236. 

    237. 

  237. <blockquote><pre>

    238. 

  238. &lt;image srcdir="src" destdir="dest" includes="*.png"&gt;

    239. 

  239.     &lt;scale proportions="width" width="40"/&gt;

    240. 

  240. &lt;/image&gt;

    241. 

  241. </pre></blockquote>

    242. 

  242. <p>Same as above but stores the result in <i>dest</i>.</p>

    243. 

  243. 

    244. 

  244. <blockquote><pre>

    245. 

  245. &lt;image srcdir="src" destdir="dest" includes="*.png"&gt;

    246. 

  246.     &lt;scale proportions="width" width="40"/&gt;

    247. 

  247.     &lt;globmapper from="*" to="scaled-*"/&gt;

    248. 

  248. &lt;/image&gt;

    249. 

  249. </pre></blockquote>

    250. 

  250. <p>Same as above but stores the resulting file names will be prefixed

    251. 

  251.   by "scaled-".</p>

    252. 

  252. 

    253. 

  253. <blockquote><pre>

    254. 

  254. </pre></blockquote>

    255. 

  255. 

    256. 

  256. 

    257. 

  257. 

    258. 

  258. </body>

    259. 

  259. </html>

    260. 

  260. 

    261. 

  261. 

    262. 

  262.