/*
* Copyright (C) 2010, 2012 The Android Open Source Project
*
* Licensed 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.
*/
package com.android.ant;
import org.apache.tools.ant.BuildException;
import org.apache.tools.ant.Project;
import org.apache.tools.ant.taskdefs.ExecTask;
import org.apache.tools.ant.types.Path;
import java.io.File;
import java.util.ArrayList;
import java.util.List;
/**
* Task to execute renderscript.
*
* It expects 7 attributes:
* 'executable' ({@link Path} with a single path) for the location of the llvm executable
* 'framework' ({@link Path} with 1 or more paths) for the include paths.
* 'genFolder' ({@link Path} with a single path) for the location of the gen folder.
* 'resFolder' ({@link Path} with a single path) for the location of the res folder.
* 'targetApi' for the -target-api value.
* 'optLevel' for the -O optimization level.
* 'debug' for -g renderscript debugging.
*
* It also expects one or more inner elements called "source" which are identical to {@link Path}
* elements for where to find .rs files.
*/
public class RenderScriptTask extends MultiFilesTask {
private String mExecutable;
private Path mIncludePath;
private String mGenFolder;
private String mResFolder;
private final List mPaths = new ArrayList();
private int mTargetApi = 0;
public enum OptLevel { O0, O1, O2, O3 };
private OptLevel mOptLevel;
private boolean mDebug = false;
private class RenderScriptProcessor implements SourceProcessor {
private final String mTargetApiStr;
public RenderScriptProcessor(int targetApi) {
// get the target api value. Must be 11+ or llvm-rs-cc complains.
mTargetApiStr = Integer.toString(mTargetApi < 11 ? 11 : mTargetApi);
}
@Override
public String getSourceFileExtension() {
return "rs";
}
@Override
public void process(String filePath, String sourceFolder, List sourceFolders,
Project taskProject) {
File exe = new File(mExecutable);
String execTaskName = exe.getName();
ExecTask task = new ExecTask();
task.setTaskName(execTaskName);
task.setProject(taskProject);
task.setOwningTarget(getOwningTarget());
task.setExecutable(mExecutable);
task.setFailonerror(true);
for (String path : mIncludePath.list()) {
File res = new File(path);
if (res.isDirectory()) {
task.createArg().setValue("-I");
task.createArg().setValue(path);
} else {
System.out.println(String.format(
"WARNING: RenderScript include directory '%s' does not exist!",
res.getAbsolutePath()));
}
}
if (mDebug) {
task.createArg().setValue("-g");
}
task.createArg().setValue("-O");
task.createArg().setValue(Integer.toString(mOptLevel.ordinal()));
task.createArg().setValue("-target-api");
task.createArg().setValue(mTargetApiStr);
task.createArg().setValue("-d");
task.createArg().setValue(getDependencyFolder(filePath, sourceFolder));
task.createArg().setValue("-MD");
task.createArg().setValue("-p");
task.createArg().setValue(mGenFolder);
task.createArg().setValue("-o");
task.createArg().setValue(mResFolder);
task.createArg().setValue(filePath);
// execute it.
task.execute();
}
@Override
public void displayMessage(DisplayType type, int count) {
switch (type) {
case FOUND:
System.out.println(String.format("Found %1$d RenderScript files.", count));
break;
case COMPILING:
if (count > 0) {
System.out.println(String.format(
"Compiling %1$d RenderScript files with -target-api %2$d",
count, mTargetApi));
System.out.println(String.format("Optimization Level: %1$d", mOptLevel.ordinal()));
} else {
System.out.println("No RenderScript files to compile.");
}
break;
case REMOVE_OUTPUT:
System.out.println(String.format("Found %1$d obsolete output files to remove.",
count));
break;
case REMOVE_DEP:
System.out.println(
String.format("Found %1$d obsolete dependency files to remove.",
count));
break;
}
}
private String getDependencyFolder(String filePath, String sourceFolder) {
String relative = filePath.substring(sourceFolder.length());
if (relative.charAt(0) == '/') {
relative = relative.substring(1);
}
return new File(mGenFolder, relative).getParent();
}
}
/**
* Sets the value of the "executable" attribute.
* @param executable the value.
*/
public void setExecutable(Path executable) {
mExecutable = TaskHelper.checkSinglePath("executable", executable);
}
public void setIncludePath(Path value) {
mIncludePath = value;
}
public void setGenFolder(Path value) {
mGenFolder = TaskHelper.checkSinglePath("genFolder", value);
}
public void setResFolder(Path value) {
mResFolder = TaskHelper.checkSinglePath("resFolder", value);
}
public void setTargetApi(String targetApi) {
try {
mTargetApi = Integer.parseInt(targetApi);
if (mTargetApi <= 0) {
throw new BuildException("targetApi attribute value must be >= 1");
}
} catch (NumberFormatException e) {
throw new BuildException("targetApi attribute value must be an integer", e);
}
}
public void setOptLevel(OptLevel optLevel) {
mOptLevel = optLevel;
}
/** Sets the current build type. value is a boolean, true for debug build, false for release */
@Override
public void setBuildType(String buildType) {
super.setBuildType(buildType);
mDebug = Boolean.valueOf(buildType);
}
public Path createSource() {
Path p = new Path(getProject());
mPaths.add(p);
return p;
}
@Override
public void execute() throws BuildException {
if (mExecutable == null) {
throw new BuildException("RenderScriptTask's 'executable' is required.");
}
if (mIncludePath == null) {
throw new BuildException("RenderScriptTask's 'includePath' is required.");
}
if (mGenFolder == null) {
throw new BuildException("RenderScriptTask's 'genFolder' is required.");
}
if (mResFolder == null) {
throw new BuildException("RenderScriptTask's 'resFolder' is required.");
}
if (mTargetApi == 0) {
throw new BuildException("RenderScriptTask's 'targetApi' is required.");
}
processFiles(new RenderScriptProcessor(mTargetApi), mPaths, mGenFolder);
}
}