diff options
Diffstat (limited to 'framework/src/ant/apache-ant-1.9.6/manual/Tasks/image.html')
| -rw-r--r-- | framework/src/ant/apache-ant-1.9.6/manual/Tasks/image.html | 261 |
1 files changed, 0 insertions, 261 deletions
diff --git a/framework/src/ant/apache-ant-1.9.6/manual/Tasks/image.html b/framework/src/ant/apache-ant-1.9.6/manual/Tasks/image.html deleted file mode 100644 index ed7ed7ef..00000000 --- a/framework/src/ant/apache-ant-1.9.6/manual/Tasks/image.html +++ /dev/null @@ -1,261 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - The ASF licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. ---> -<html> - -<head> -<meta http-equiv="Content-Language" content="en-us"> -<link rel="stylesheet" type="text/css" href="../stylesheets/style.css"> -<title>Image Task</title> -</head> - -<body> - -<h2><a name="image">Image</a></h2> -<h3>Description</h3> -<p>Applies a chain of image operations on a set of files.</p> -<p>Requires Java Advanced Image API from Sun.</p> - -<h5>Overview of used datatypes</h5> -<img src="image-classdiagram.gif" border="0" alt="Class-Diagram"> - -<h3>Parameters</h3> -<table border="1" cellpadding="2" cellspacing="0"> - <tr> - <td valign="top"><b>Attribute</b></td> - <td valign="top"><b>Description</b></td> - <td align="center" valign="top"><b>Required</b></td> - </tr> - <tr> - <td valign="top"> failonerror </td> - <td valign="top"> Boolean value. If false, note errors to the output but keep going. </td> - <td align="center"> no (defaults to <i>true</i>) </td> - </tr> - <tr> - <td valign="top"> srcdir </td> - <td valign="top"> Directory containing the images. </td> - <td align="center"> yes, unless nested fileset is used </td> - </tr> - <tr> - <td valign="top"> encoding </td> - <td valign="top"> Image encoding type. <br> - Valid (caseinsensitive) are: jpg, jpeg, tif, tiff - </td> - <td align="center"> no (defaults to <i>JPEG</i>) </td> - </tr> - <tr> - <td valign="top"> overwrite </td> - <td valign="top"> Boolean value. Sets whether or not to overwrite - a file if there is naming conflict. - </td> - <td align="center"> no (defaults to <i>false</i>) </td> - </tr> - <tr> - <td valign="top"> gc </td> - <td valign="top"> Boolean value. Enables garbage collection after - each image processed. - </td> - <td align="center"> no (defaults to <i>false</i>) </td> - </tr> - <tr> - <td valign="top"> destdir </td> - <td valign="top"> Directory where the result images are stored. </td> - <td align="center"> no (defaults to value of <i>srcdir</i>) </td> - </tr> - <!-- attributes inherited from MatchingTask --> - <tr> - <td valign="top">includes</td> - <td valign="top">comma- or space-separated list of patterns of files that must be - included. All files are included when omitted.</td> - <td valign="top" align="center">No</td> - </tr> - <tr> - <td valign="top">includesfile</td> - <td valign="top">the name of a file. Each line of this file is - taken to be an include pattern</td> - <td valign="top" align="center">No</td> - </tr> - <tr> - <td valign="top"> excludes</td> - <td valign="top">comma- or space-separated list of patterns of files that must be - excluded. No files (except default excludes) are excluded when omitted.</td> - <td valign="top" align="center">No</td> - </tr> - <tr> - <td valign="top">excludesfile</td> - <td valign="top">the name of a file. Each line of this file is - taken to be an exclude pattern</td> - <td valign="top" align="center">No</td> - </tr> - <tr> - <td valign="top">defaultexcludes</td> - <td valign="top">indicates whether default excludes should be used or not - ("yes"/"no"). Default excludes are used when omitted.</td> - <td valign="top" align="center">No</td> - </tr> - <tr> - <td valign="top"> caseSensitive </td> - <td valign="top"> Boolean value. Sets case sensitivity of the file system. </td> - <td align="center"> no (defaults to <i>false</i>) </td> - </tr> - <tr> - <td valign="top"> followSymlinks </td> - <td valign="top"> Boolean value. Sets whether or not symbolic links should be followed. </td> - <td align="center"> no (defaults to <i>true</i>) </td> - </tr> -</table> - -<h3>Parameters specified as nested elements</h3> -<p>This task forms an implicit <a href="../Types/fileset.html">FileSet</a> and -supports most attributes of <code><fileset></code> as well as the -nested <code><include></code>, <code><exclude></code> and -<code><patternset></code> elements.</p> - - -<h4>ImageOperation</h4> -<p>Adds an ImageOperation to chain.</p> -<h5>Nested Elements</h5> -ImageOperation can handle nested Rotate, Draw, Rectangle, Text and Scale objects. - -<h4>Rotate</h4> -<p>Adds a Rotate ImageOperation to chain.</p> -<h5>Parameters</h5> -<table border="1" cellpadding="2" cellspacing="0"> - <tr> - <td valign="top"><b>Attribute</b></td> - <td valign="top"><b>Description</b></td> - <td align="center" valign="top"><b>Required</b></td> - </tr> - <tr> - <td valign="top"> angle </td> - <td valign="top"> Float value. Sets the angle of rotation in degrees. </td> - <td align="center"> no (defaults to <i>0.0F</i>) </td> - </tr> -</table> - -<h4>Scale</h4> -<p>Adds a Scale ImageOperation to chain.</p> -<h5>Parameters</h5> -<table border="1" cellpadding="2" cellspacing="0"> - <tr> - <td valign="top"><b>Attribute</b></td> - <td valign="top"><b>Description</b></td> - <td align="center" valign="top"><b>Required</b></td> - </tr> - <td valign="top"> proportions </td> - <td valign="top"> Sets which dimension to control proportions from. Valid values are:<ul> - <li>"ignore" - treat the dimensions independently.</li> - <li>"height" - keep proportions based on the width.</li> - <li>"width" - keep proportions based on the height.</li> - <li>"cover" - keep proportions and fit in the supplied dimensions.</li> - <li>"fit" - keep proportions and cover the supplied dimensions.</li> - </ul></td> - <td align="center"> no (defaults to <i>ignore</i>) </td> - <tr> - <td valign="top"> width </td> - <td valign="top"> Sets the width of the image, either as an integer or a %. </td> - <!-- todo: if integer, what kind? cm, px, inches, ... --> - <td align="center"> no (defaults to <i>100%</i>) </td> - </tr> - <tr> - <td valign="top"> height </td> - <td valign="top"> Sets the height of the image, either as an integer or a %. </td> - <!-- todo: if integer, what kind? cm, px, inches, ... --> - <td align="center"> no (defaults to <i>100%</i>) </td> - </tr> -</table> - -<h4>Draw</h4> -<p>Adds a Draw ImageOperation to chain. DrawOperation DataType objects can be -nested inside the Draw object.</p> -<h5>Parameters</h5> -<table border="1" cellpadding="2" cellspacing="0"> - <tr> - <td valign="top"><b>Attribute</b></td> - <td valign="top"><b>Description</b></td> - <td align="center" valign="top"><b>Required</b></td> - </tr> - <tr> - <td valign="top"> xloc </td> - <td valign="top"> X-Position where to draw nested image elements. </td> - <td align="center"> no (defaults to <i>0</i>) </td> - </tr> - <tr> - <td valign="top"> yloc </td> - <td valign="top"> Y-Position where to draw nested image elements. </td> - <td align="center"> no (defaults to <i>0</i>) </td> - </tr> -</table> - -<h4>mapper</h4> -<p><em>Since Apache Ant 1.8.0</em></p> - -<p>You can define filename transformations by using a - nested <a href="../Types/mapper.html">mapper</a> element. The - default mapper used by - <code><image></code> is - the <a href="../Types/mapper.html#identity-mapper">identity - mapper</a>.</p> - -<p>You can also use a filenamemapper type in place of the mapper - element.</p> - -<h3>Examples</h3> - -<blockquote><pre> - <image destdir="samples/low" overwrite="yes"> - <fileset dir="samples/full"> - <include name="**/*.jpg"/> - </fileset> - <scale width="160" height="160" proportions="fit"/> - </image> -</pre></blockquote> -<p>Create thumbnails of my images and make sure they all fit within the 160x160 size whether the -image is portrait or landscape.</p> - -<blockquote><pre> -<image srcdir="src" includes="*.png"> - <scale proportions="width" width="40"/> -</image> -</pre></blockquote> -<p>Creates a thumbnail for all PNG-files in <i>src</i> in the size of 40 pixel keeping the proportions -and stores the <i>src</i>.</p> - -<blockquote><pre> -<image srcdir="src" destdir="dest" includes="*.png"> - <scale proportions="width" width="40"/> -</image> -</pre></blockquote> -<p>Same as above but stores the result in <i>dest</i>.</p> - -<blockquote><pre> -<image srcdir="src" destdir="dest" includes="*.png"> - <scale proportions="width" width="40"/> - <globmapper from="*" to="scaled-*"/> -</image> -</pre></blockquote> -<p>Same as above but stores the resulting file names will be prefixed - by "scaled-".</p> - -<blockquote><pre> -</pre></blockquote> - - - -</body> -</html> - - |