2010-03-12 02:20:12 +00:00
|
|
|
/*
|
|
|
|
* Copyright (C) 2009 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.
|
|
|
|
*/
|
Manually merge 129, 174, and 233 from donut
This adds a static OpenGL ES API.
Here are the three commit messages for the original changes:
Clean up trivial Eclipse warnings and fix whitespace.
Added @Override to overridden methods.
Removed unused imports.
Converted tabs to spaces.
Removed \r characters from end-of-lines.
Add .gitignore file to ignore the .class files that are
generated when the "gen" script is run.
This is the 2nd commit message:
Improve glgen
+ gen script is really a bash script rather than a sh script,
so declare that to be true. (For example, it uses pushd,
which is a part of bash, but not a part of sh. Not sure
how this worked until now. Possibly gen was only run in
environments where /bin/sh was really bash.
+ Check the results of the java compile of the code generator,
and abort the script if the compile fails.
+ Turn on the bash shell option that guards against using
uninitialized variables in the script.
+ Remove the generated class files.
Refactor JniCodeEmitter into two classes: a general-purpose
JniCodeEmitter and a specific Jsr239CodeEmitter. The hope is
to use JniCodeEmitter as a base for emitting static OpenGL ES
bindings.
This is the 3rd commit message:
Add an Android-specific static OpenGL ES 1.1 Java API.
This change adds four new public classes that expose a static OpenGL ES 1.1 API:
android.opengl.GLES10
android.opengl.GLES10Ext
android.opengl.GLES11
android.opengl.GLES11Ext
Benefits:
+ The static API is slightly faster (1% to 4%) than the existing Interface based JSR239 API.
+ The static API is similar to the C API, which should make it easier to import C-based
example code.
+ The static API provides a clear path for adding new OpenGL ES 1.1 extensions
and OpenGL ES 2.0 APIs, neither of which currently have a JSR standard.
Example:
import static android.opengl.GLES10.*;
...
glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
Note that it is possible to mix-and-match calls to both the static and JSR239 APIs.
This works because neither API maintains state. They both call through to the same underlying
C OpenGL ES APIs.
Implementation details:
This change enhances the "glgen" "gen" script to generate both the original JSR239 and
new static OpenGL ES APIs. The contents of the generated JSR239 classes remained the same as before,
so there is no need to check in new versions of the generated JSR239 classes.
As part of this work the gen script was updated to be somewhat more robust, and to
work with git instead of perforce. The script prints out commands to git add the generated files,
but leaves it up to the script runner to actually execute those commands.
2009-04-13 23:22:25 +00:00
|
|
|
|
|
|
|
import java.io.BufferedReader;
|
|
|
|
import java.io.File;
|
|
|
|
import java.io.FileOutputStream;
|
|
|
|
import java.io.FileReader;
|
|
|
|
import java.io.IOException;
|
|
|
|
import java.io.PrintStream;
|
|
|
|
|
|
|
|
public class GenerateGLES {
|
|
|
|
|
|
|
|
static void copy(String filename, PrintStream out) throws IOException {
|
|
|
|
BufferedReader br = new BufferedReader(new FileReader(filename));
|
|
|
|
String s;
|
|
|
|
while ((s = br.readLine()) != null) {
|
|
|
|
out.println(s);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
private static void emit(GLESCodeEmitter emitter,
|
|
|
|
BufferedReader specReader,
|
|
|
|
PrintStream glStream,
|
|
|
|
PrintStream cStream) throws Exception {
|
|
|
|
String s = null;
|
|
|
|
while ((s = specReader.readLine()) != null) {
|
|
|
|
if (s.trim().startsWith("//")) {
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
|
|
|
CFunc cfunc = CFunc.parseCFunc(s);
|
|
|
|
|
|
|
|
String fname = cfunc.getName();
|
|
|
|
String stubRoot = "stubs/gles11/" + fname;
|
|
|
|
String javaPath = stubRoot + ".java";
|
|
|
|
File f = new File(javaPath);
|
|
|
|
if (f.exists()) {
|
|
|
|
System.out.println("Special-casing function " + fname);
|
|
|
|
copy(javaPath, glStream);
|
|
|
|
copy(stubRoot + ".cpp", cStream);
|
|
|
|
|
|
|
|
// Register native function names
|
|
|
|
// This should be improved to require fewer discrete files
|
|
|
|
String filename = stubRoot + ".nativeReg";
|
|
|
|
BufferedReader br =
|
|
|
|
new BufferedReader(new FileReader(filename));
|
|
|
|
String nfunc;
|
|
|
|
while ((nfunc = br.readLine()) != null) {
|
|
|
|
emitter.addNativeRegistration(nfunc);
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
emitter.emitCode(cfunc, s);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public static void main(String[] args) throws Exception {
|
|
|
|
int aidx = 0;
|
|
|
|
while ((aidx < args.length) && (args[aidx].charAt(0) == '-')) {
|
|
|
|
switch (args[aidx].charAt(1)) {
|
|
|
|
default:
|
|
|
|
System.err.println("Unknown flag: " + args[aidx]);
|
|
|
|
System.exit(1);
|
|
|
|
}
|
|
|
|
|
|
|
|
aidx++;
|
|
|
|
}
|
|
|
|
|
|
|
|
BufferedReader checksReader =
|
|
|
|
new BufferedReader(new FileReader("specs/gles11/checks.spec"));
|
|
|
|
ParameterChecker checker = new ParameterChecker(checksReader);
|
|
|
|
|
|
|
|
// Generate files
|
|
|
|
for(String suffix: new String[] {"GLES10", "GLES10Ext",
|
2009-11-19 08:34:55 +00:00
|
|
|
"GLES11", "GLES11Ext", "GLES20"})
|
Manually merge 129, 174, and 233 from donut
This adds a static OpenGL ES API.
Here are the three commit messages for the original changes:
Clean up trivial Eclipse warnings and fix whitespace.
Added @Override to overridden methods.
Removed unused imports.
Converted tabs to spaces.
Removed \r characters from end-of-lines.
Add .gitignore file to ignore the .class files that are
generated when the "gen" script is run.
This is the 2nd commit message:
Improve glgen
+ gen script is really a bash script rather than a sh script,
so declare that to be true. (For example, it uses pushd,
which is a part of bash, but not a part of sh. Not sure
how this worked until now. Possibly gen was only run in
environments where /bin/sh was really bash.
+ Check the results of the java compile of the code generator,
and abort the script if the compile fails.
+ Turn on the bash shell option that guards against using
uninitialized variables in the script.
+ Remove the generated class files.
Refactor JniCodeEmitter into two classes: a general-purpose
JniCodeEmitter and a specific Jsr239CodeEmitter. The hope is
to use JniCodeEmitter as a base for emitting static OpenGL ES
bindings.
This is the 3rd commit message:
Add an Android-specific static OpenGL ES 1.1 Java API.
This change adds four new public classes that expose a static OpenGL ES 1.1 API:
android.opengl.GLES10
android.opengl.GLES10Ext
android.opengl.GLES11
android.opengl.GLES11Ext
Benefits:
+ The static API is slightly faster (1% to 4%) than the existing Interface based JSR239 API.
+ The static API is similar to the C API, which should make it easier to import C-based
example code.
+ The static API provides a clear path for adding new OpenGL ES 1.1 extensions
and OpenGL ES 2.0 APIs, neither of which currently have a JSR standard.
Example:
import static android.opengl.GLES10.*;
...
glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
Note that it is possible to mix-and-match calls to both the static and JSR239 APIs.
This works because neither API maintains state. They both call through to the same underlying
C OpenGL ES APIs.
Implementation details:
This change enhances the "glgen" "gen" script to generate both the original JSR239 and
new static OpenGL ES APIs. The contents of the generated JSR239 classes remained the same as before,
so there is no need to check in new versions of the generated JSR239 classes.
As part of this work the gen script was updated to be somewhat more robust, and to
work with git instead of perforce. The script prints out commands to git add the generated files,
but leaves it up to the script runner to actually execute those commands.
2009-04-13 23:22:25 +00:00
|
|
|
{
|
|
|
|
BufferedReader spec11Reader =
|
|
|
|
new BufferedReader(new FileReader("specs/gles11/"
|
|
|
|
+ suffix + ".spec"));
|
|
|
|
String gl11Filename = "android/opengl/" + suffix + ".java";
|
|
|
|
String gl11cFilename = "android_opengl_" + suffix + ".cpp";
|
|
|
|
PrintStream gl11Stream =
|
|
|
|
new PrintStream(new FileOutputStream("out/" + gl11Filename));
|
|
|
|
PrintStream gl11cStream =
|
|
|
|
new PrintStream(new FileOutputStream("out/" + gl11cFilename));
|
|
|
|
gl11Stream.println("/*");
|
|
|
|
gl11cStream.println("/*");
|
|
|
|
copy("stubs/gles11/" + suffix + "Header.java-if", gl11Stream);
|
|
|
|
copy("stubs/gles11/" + suffix + "cHeader.cpp", gl11cStream);
|
|
|
|
GLESCodeEmitter emitter = new GLESCodeEmitter(
|
|
|
|
"android/opengl/" + suffix,
|
|
|
|
checker, gl11Stream, gl11cStream);
|
|
|
|
emit(emitter, spec11Reader, gl11Stream, gl11cStream);
|
|
|
|
emitter.emitNativeRegistration("register_android_opengl_jni_"
|
|
|
|
+ suffix);
|
|
|
|
gl11Stream.println("}");
|
|
|
|
gl11Stream.close();
|
|
|
|
gl11cStream.close();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|