Return-Path: Mailing-List: contact dev-help@ant.apache.org; run by ezmlm Delivered-To: mailing list dev@ant.apache.org Received: (qmail 602 invoked by uid 500); 16 Apr 2003 12:44:45 -0000 Received: (qmail 594 invoked from network); 16 Apr 2003 12:44:45 -0000 Received: from icarus.apache.org (208.185.179.13) by daedalus.apache.org with SMTP; 16 Apr 2003 12:44:45 -0000 Received: (qmail 39582 invoked by uid 1146); 16 Apr 2003 12:44:45 -0000 Date: 16 Apr 2003 12:44:45 -0000 Message-ID: <20030416124445.39581.qmail@icarus.apache.org> From: bodewig@apache.org To: ant-cvs@apache.org Subject: cvs commit: ant/docs/manual/OptionalTasks image-classdiagram.gif image.html X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N bodewig 2003/04/16 05:44:44 Modified: docs/manual install.html optionaltasklist.html Added: docs/manual/OptionalTasks image-classdiagram.gif image.html Log: Documentation for the image task. PR: 19055 Submitted by: Jan Mat�rne Revision Changes Path 1.50 +6 -0 ant/docs/manual/install.html Index: install.html =================================================================== RCS file: /home/cvs/ant/docs/manual/install.html,v retrieving revision 1.49 retrieving revision 1.50 diff -u -r1.49 -r1.50 --- install.html 10 Apr 2003 06:11:02 -0000 1.49 +++ install.html 16 Apr 2003 12:44:44 -0000 1.50 @@ -424,6 +424,12 @@ http://www.jcraft.com/jsch/index.html + + JAI - Java Advanded Imaging + image task + http://java.sun.com/products/java-media/jai/ +
1.37 +1 -0 ant/docs/manual/optionaltasklist.html Index: optionaltasklist.html =================================================================== RCS file: /home/cvs/ant/docs/manual/optionaltasklist.html,v retrieving revision 1.36 retrieving revision 1.37 diff -u -r1.36 -r1.37 --- optionaltasklist.html 13 Mar 2003 09:01:54 -0000 1.36 +++ optionaltasklist.html 16 Apr 2003 12:44:44 -0000 1.37 @@ -28,6 +28,7 @@ Echoproperties
FTP
IContract
+Image
Jarlib-available
Jarlib-display
Jarlib-manifest
1.1 ant/docs/manual/OptionalTasks/image-classdiagram.gif <> 1.1 ant/docs/manual/OptionalTasks/image.html Index: image.html =================================================================== Image Task

Image

Description

Applies a chain of image operations on a set of files.

Requires Java Advanced Image API from Sun.

Overview of used datatypes
Class-Diagram

Parameters

Attribute Description Required
failonerror Boolean value. If false, note errors to the output but keep going. no (defaults to true)
srcdir Directory containing the images. yes, unless nested fileset is used
encoding Image encoding type.
Valid (caseinsensitive) are: jpg, jpeg, tif, tiff 		no (defaults to JPEG)
overwrite Boolean value. Sets whether or not to overwrite a file if there is naming conflict. no (defaults to false)
gc Boolean value. Enables garbage collection after each image processed. no (defaults to false)
destdir Directory where the result images are stored. no (defaults to value of srcdir)
includes comma- or space-separated list of patterns of files that must be included. All files are included when omitted. No
includesfile the name of a file. Each line of this file is taken to be an include pattern No
excludes comma- or space-separated list of patterns of files that must be excluded. No files (except default excludes) are excluded when omitted. No
excludesfile the name of a file. Each line of this file is taken to be an exclude pattern No
defaultexcludes indicates whether default excludes should be used or not ("yes"/"no"). Default excludes are used when omitted. No
caseSensitive Boolean value. Sets case sensitivity of the file system. no (defaults to false)
followSymlinks Boolean value. Sets whether or not symbolic links hsould be followed. no (defaults to true)

Parameters specified as nested elements

This task forms an implicit FileSet and supports all attributes of <fileset> as well as the nested <include>, <exclude> and <patternset> elements.

ImageOperation

Adds an ImageOperation to chain.

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

Rotate

Adds a Rotate ImageOperation to chain.

Parameters
Attribute Description Required
angle Float value. Sets the angle of rotation in degrees. no (defaults to 0.0F)

Scale

Adds a Scale ImageOperation to chain.

Parameters
Attribute Description Required
keepproportions Boolean value. Sets whether the proportion heigth/width should be kept. no (defaults to false)
width Sets the width of the image, either as an integer or a %. no (defaults to 100%)
heigth Sets the height of the image, either as an integer or a %. no (defaults to 100%)

Draw

Adds a Draw ImageOperation to chain. DrawOperation DataType objects can be nested inside the Draw object.

Parameters
Attribute Description Required
xloc X-Position where to draw nested image elements. no (defaults to 0)
yloc Y-Position where to draw nested image elements. no (defaults to 0)

Examples

  <image srcdir="src" includes="*.png">
      <scale keepproportions="true" width="40"/>
  </image>

Creates a thumbnail for all PNG-files in src in the size of 40 pixel keeping the proportions and stores the src.

  <image srcdir="src" destdir="dest" includes="*.png">
      <scale keepproportions="true" width="40"/>
  </image>

Same as above but stores the result in dest.

Copyright © 2003 Apache Software Foundation. All rights Reserved.