com.jogamp.gluegen.ant
Class GlueGenTask

java.lang.Object
  extended by Task
      extended by com.jogamp.gluegen.ant.GlueGenTask

public class GlueGenTask
extends Task

An ANT org.apache.tools.ant.Task for using GlueGen.

Usage:

    <gluegen src="[source C file]" 
                outputrootdir="[optional output root dir]"
                includes="[optional directory pattern of include files to include]"
                excludes="[optional directory pattern of include files to exclude]"
                includeRefid="[optional FileSet or DirSet for include files]"
                literalInclude="[optional comma separated list of literal include directories, avoiding limitations of FileSet / DirSet issues]"
                emitter="[emitter class name]"
                config="[configuration file]"
                dumpCPP="[optional boolean]"
                debug="[optional boolean]" />
 

Author:
Rob Grzywinski rgrzywinski@yahoo.com

Constructor Summary
GlueGenTask()
          Create and add the VM and classname to org.apache.tools.ant.types.CommandlineJava.
 
Method Summary
 void addDirset(DirSet dirset)
          Add a nested org.apache.tools.ant.types.DirSet to specify the files to include.
 Path createClasspath()
          Add an optional classpath that defines the location of GlueGen and GlueGen's dependencies.
 PatternSet.NameEntry createExclude()
          Add an include file to the list that is to be exluded.
 PatternSet.NameEntry createExcludesFile()
          Add an exclude file to the list.
 PatternSet.NameEntry createInclude()
          Add an include file to the list.
 PatternSet.NameEntry createIncludesFile()
          Add an include file to the list.
 void execute()
          Run the task.
 void setConfig(String configuration)
          Set the configuration file name.
 void setDebug(boolean debug)
          Set the debug flag (optional).
 void setDumpCPP(boolean dumpCPP)
          Set the dumpCPP flag (optional).
 void setEmitter(String emitter)
          Set the emitter class name.
 void setExcludes(String excludes)
          Set the set of exclude patterns.
 void setIncludeRefid(Reference reference)
          Set a org.apache.tools.ant.types.Reference to simplify adding of complex sets of files to include.
 void setIncludes(String includes)
          Set the set of include patterns.
 void setLiteralInclude(String commaSeparatedIncludes)
          Set a literal include directories, separated with a comma.
 void setOutputRootDir(String outputRootDir)
          Set the output root dir (optional).
 void setSrc(String sourceFile)
          Set the source C file that is to be parsed.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

GlueGenTask

public GlueGenTask()

Create and add the VM and classname to org.apache.tools.ant.types.CommandlineJava.

Method Detail

setDebug

public void setDebug(boolean debug)

Set the debug flag (optional). This is called by ANT.


setDumpCPP

public void setDumpCPP(boolean dumpCPP)

Set the dumpCPP flag (optional). This is called by ANT.


setOutputRootDir

public void setOutputRootDir(String outputRootDir)

Set the output root dir (optional). This is called by ANT.

Parameters:
outputRootDir - the optional output root dir

setEmitter

public void setEmitter(String emitter)

Set the emitter class name. This is called by ANT.

Parameters:
emitter - the name of the emitter class

setConfig

public void setConfig(String configuration)

Set the configuration file name. This is called by ANT.

Parameters:
configuration - the name of the configuration file

setSrc

public void setSrc(String sourceFile)

Set the source C file that is to be parsed. This is called by ANT.

Parameters:
sourceFile - the name of the source file

setLiteralInclude

public void setLiteralInclude(String commaSeparatedIncludes)

Set a literal include directories, separated with a comma. See the literalInclude javadoc for more information.

Parameters:
commaSeparatedIncludes - the comma separated directories to include

createInclude

public PatternSet.NameEntry createInclude()

Add an include file to the list. This is called by ANT for a nested element.

Returns:
org.apache.tools.ant.types.PatternSet.NameEntry

createIncludesFile

public PatternSet.NameEntry createIncludesFile()

Add an include file to the list. This is called by ANT for a nested element.

Returns:
org.apache.tools.ant.types.PatternSet.NameEntry

setIncludes

public void setIncludes(String includes)

Set the set of include patterns. Patterns may be separated by a comma or a space. This is called by ANT.

Parameters:
includes - the string containing the include patterns

createExclude

public PatternSet.NameEntry createExclude()

Add an include file to the list that is to be exluded. This is called by ANT for a nested element.

Returns:
org.apache.tools.ant.types.PatternSet.NameEntry

createExcludesFile

public PatternSet.NameEntry createExcludesFile()

Add an exclude file to the list. This is called by ANT for a nested element.

Returns:
org.apache.tools.ant.types.PatternSet.NameEntry

setExcludes

public void setExcludes(String excludes)

Set the set of exclude patterns. Patterns may be separated by a comma or a space. This is called by ANT.

Parameters:
includes - the string containing the exclude patterns

setIncludeRefid

public void setIncludeRefid(Reference reference)

Set a org.apache.tools.ant.types.Reference to simplify adding of complex sets of files to include. This is called by ANT.

?

Parameters:
reference - a Reference to a org.apache.tools.ant.types.FileSet or org.apache.tools.ant.types.DirSet
Throws:
BuildException - if the specified Reference is not either a FileSet or DirSet

addDirset

public void addDirset(DirSet dirset)

Add a nested org.apache.tools.ant.types.DirSet to specify the files to include. This is called by ANT.

Parameters:
dirset - the DirSet to be added

createClasspath

public Path createClasspath()

Add an optional classpath that defines the location of GlueGen and GlueGen's dependencies.


execute

public void execute()
             throws BuildException

Run the task. This involves validating the set attributes, creating the command line to be executed and finally executing the command.

Throws:
BuildException
See Also:
org.apache.tools.ant.Task#execute()