summaryrefslogtreecommitdiffstats
path: root/src/classes/com/sun/gluegen/GlueEmitter.java
diff options
context:
space:
mode:
authorKenneth Russel <[email protected]>2006-01-15 03:25:55 +0000
committerKenneth Russel <[email protected]>2006-01-15 03:25:55 +0000
commit61d2579d7e6ccb1ac2fbb48d0410390a697bec16 (patch)
treea83ddfcf708e6572af0be2d4de6c7d3340db230e /src/classes/com/sun/gluegen/GlueEmitter.java
parentaad7268baef8142e33815a02034ef6af56442e63 (diff)
Moved GlueGen out of the JOGL workspace and into its own project.
Restructured JOGL and JOAL build processes to separately invoke GlueGen's main build.xml before using it to generate their code. Refactored OS/CPU detection code into gluegen-cpptasks.xml build file in GlueGen workspace, which is now imported by both the JOGL and JOAL build processes. Unfortunately it seems to be somewhat difficult to completely factor out the C compiler configuration into the GlueGen workspace so this has been left for a later date. Added missed ALProcAddressLookup file to JOAL workspace. Updated JOGL and JOAL build documentation. More documentation for the GlueGen workspace is forthcoming. git-svn-id: file:///usr/local/projects/SUN/JOGL/git-svn/svn-server-sync/jogl/trunk@542 232f8b59-042b-4e1e-8c03-345bb8c30851
Diffstat (limited to 'src/classes/com/sun/gluegen/GlueEmitter.java')
-rw-r--r--src/classes/com/sun/gluegen/GlueEmitter.java120
1 files changed, 0 insertions, 120 deletions
diff --git a/src/classes/com/sun/gluegen/GlueEmitter.java b/src/classes/com/sun/gluegen/GlueEmitter.java
deleted file mode 100644
index e21bc8764..000000000
--- a/src/classes/com/sun/gluegen/GlueEmitter.java
+++ /dev/null
@@ -1,120 +0,0 @@
-/*
- * Copyright (c) 2003 Sun Microsystems, Inc. All Rights Reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are
- * met:
- *
- * - Redistribution of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
- * - Redistribution in binary form must reproduce the above copyright
- * notice, this list of conditions and the following disclaimer in the
- * documentation and/or other materials provided with the distribution.
- *
- * Neither the name of Sun Microsystems, Inc. or the names of
- * contributors may be used to endorse or promote products derived from
- * this software without specific prior written permission.
- *
- * This software is provided "AS IS," without a warranty of any kind. ALL
- * EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
- * INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
- * PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN
- * MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL NOT BE LIABLE FOR
- * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
- * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR
- * ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR
- * DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE
- * DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY,
- * ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF
- * SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
- *
- * You acknowledge that this software is not designed or intended for use
- * in the design, construction, operation or maintenance of any nuclear
- * facility.
- *
- * Sun gratefully acknowledges that this software was originally authored
- * and developed by Kenneth Bradley Russell and Christopher John Kline.
- */
-
-package com.sun.gluegen;
-
-import java.util.*;
-import com.sun.gluegen.cgram.types.*;
-
-/** Specifies the interface by which GlueGen requests glue code to be
- generated. Can be replaced to generate glue code for other
- languages and foreign function interfaces. */
-
-public interface GlueEmitter {
-
- public void readConfigurationFile(String filename) throws Exception;
-
- /** Sets the description of the underlying hardware. "md32"
- specifies the description of a 32-bit version of the underlying
- CPU architecture. "md64" specifies the description of a 64-bit
- version of the underlying CPU architecture. At least one must be
- specified. When both are specified, the bulk of the glue code is
- generated using the 32-bit machine description, but structs are
- laid out twice and the base class delegates between the 32-bit
- and 64-bit implementation at run time. This allows Java code
- which can access both 32-bit and 64-bit versions of the data
- structures to be included in the same jar file. <P>
-
- It is up to the end user to provide the appropriate opaque
- definitions to ensure that types of varying size (longs and
- pointers in particular) are exposed to Java in such a way that
- changing the machine description does not cause different shared
- glue code to be generated for the 32- and 64-bit ports.
- */
- public void setMachineDescription(MachineDescription md32,
- MachineDescription md64);
-
- /**
- * Begin the emission of glue code. This might include opening files,
- * emitting class headers, etc.
- */
- public void beginEmission(GlueEmitterControls controls) throws Exception;
-
- /**
- * Finish the emission of glue code. This might include closing files,
- * closing open class definitions, etc.
- */
- public void endEmission() throws Exception;
-
- public void beginDefines() throws Exception;
- /**
- * @param optionalComment If optionalComment is non-null, the emitter can
- * emit that string as a comment providing extra information about the
- * define.
- */
- public void emitDefine(String name, String value, String optionalComment) throws Exception;
- public void endDefines() throws Exception;
-
- public void beginFunctions(TypeDictionary typedefDictionary,
- TypeDictionary structDictionary,
- Map canonMap) throws Exception;
-
- /** Emit glue code for the list of FunctionSymbols. */
- public Iterator emitFunctions(java.util.List/*<FunctionSymbol>*/ cFunctions) throws Exception;
- public void endFunctions() throws Exception;
-
- /** Begins the process of computing field offsets and type sizes for
- the structs to be emitted. */
- public void beginStructLayout() throws Exception;
- /** Lays out one struct which will be emitted later. */
- public void layoutStruct(CompoundType t) throws Exception;
- /** Finishes the struct layout process. */
- public void endStructLayout() throws Exception;
-
- public void beginStructs(TypeDictionary typedefDictionary,
- TypeDictionary structDictionary,
- Map canonMap) throws Exception;
- /** Emit glue code for the given CompoundType. alternateName is
- provided when the CompoundType (e.g. "struct foo_t") has not
- been typedefed to anything but the type of "pointer to struct
- foo_t" has (e.g. "typedef struct foo_t {} *Foo"); in this case
- alternateName would be set to Foo. */
- public void emitStruct(CompoundType t, String alternateName) throws Exception;
- public void endStructs() throws Exception;
-}