#region License // // The Open Toolkit Library License // // Copyright (c) 2006 - 2010 the Open Toolkit library. // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights to // use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of // the Software, and to permit persons to whom the Software is furnished to do // so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in all // copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES // OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, // WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR // OTHER DEALINGS IN THE SOFTWARE. // #endregion using System; using System.Collections.Generic; using System.Diagnostics; using System.IO; using System.Linq; using System.Text; using Bind.Structures; namespace Bind { using Delegate = Bind.Structures.Delegate; using Enum = Bind.Structures.Enum; using Type = Bind.Structures.Type; sealed class CppSpecWriter : ISpecWriter { const string AllowDeprecated = "GLPP_COMPATIBLE"; const string DigitPrefix = "T"; // Prefix for identifiers that start with a digit const string OutputFileHeader = "gl++.h"; IBind Generator { get; set; } Settings Settings { get { return Generator.Settings; } } #region Verbatim parts of output file const string GetAddressDefinition = @" namespace Internals { #if defined(_WIN32) extern ""C"" { #define GLPP_APIENTRY __stdcall typedef int (*PROC)(); extern void* __stdcall wglGetCurrentContext(); extern PROC __stdcall wglGetProcAddress(const char *procname); extern void* __stdcall LoadLibraryA(const char *libname); extern PROC __stdcall GetProcAddress(void *module, const char *procname); } inline void*& LoadGLAddress() { static void* address = LoadLibraryA(""opengl32.dll""); return address; } inline void*& GetGLAddress() { static void* address = LoadGLAddress(); return address; } inline PROC winGetAddress(const char *procname) { PROC addr = GetProcAddress(GetGLAddress(), procname); return addr ? addr : wglGetProcAddress(procname); } #elif !defined(__APPLE__) extern ""C"" { #define GLPP_APIENTRY extern void* glXGetCurrentContext(); extern void (*glXGetProcAddress(const char *procname))(); } #endif #if defined(__APPLE__) #define GLPP_APIENTRY #include #include #include extern ""C"" void* CGLGetCurrentContext(); #ifdef MAC_OS_X_VERSION_10_3 #include inline void* NSGLGetProcAddress(const char *name) { static void* image = NULL; if (NULL == image) { image = dlopen(""/System/Library/Frameworks/OpenGL.framework/Versions/Current/OpenGL"", RTLD_LAZY); } return image ? dlsym(image, (const char*)name) : NULL; } #else #include inline void* NSGLGetProcAddress(const char *name) { static const struct mach_header* image = NULL; NSSymbol symbol; char* symbolName; if (NULL == image) { image = NSAddImage(""/System/Library/Frameworks/OpenGL.framework/Versions/Current/OpenGL"", NSADDIMAGE_OPTION_RETURN_ON_ERROR); } // prepend a '_' for the Unix C symbol mangling convention symbolName = malloc(strlen((const char*)name) + 2); strcpy(symbolName+1, (const char*)name); symbolName[0] = '_'; symbol = NULL; symbol = image ? NSLookupSymbolInImage(image, symbolName, NSLOOKUPSYMBOLINIMAGE_OPTION_BIND | NSLOOKUPSYMBOLINIMAGE_OPTION_RETURN_ON_ERROR) : NULL; free(symbolName); return symbol ? NSAddressOfSymbol(symbol) : NULL; } #endif /* MAC_OS_X_VERSION_10_3 */ #endif /* __APPLE__ */ #if defined(__sgi) || defined (__sun) #define GLPP_APIENTRY #include #include #include inline void* LoadSymbol(const char *name) { // dlopen what? if ((void *h = dlopen(NULL, RTLD_LAZY | RTLD_LOCAL)) == NULL) return NULL; return dlsym(h, ""glXGetProcAddress""); } inline void* dlGetProcAddress(const char *name) { static void* gpa = LoadSymbol(""glXGetProcAddress""); if (gpa != NULL) return ((void*(*)(const char*))gpa)(name); else return dlsym(h, (const char*)name); } inline void* dlGetCurrentContext() { static void* gpa = LoadSymbol(""glXGetProcAddress""); if (gpa != NULL) return ((void*(*)())gpa)(); return NULL; } #endif /* __sgi || __sun */ inline void* GetAddress(const char* name) { #if defined(_WIN32) return (void*)winGetAddress(name); #elif defined(__APPLE__) return (void*)NSGLGetProcAddress(name); #elif defined(__sgi) || defined(__sun) return (void*)dlGetProcAddress(name); #else return (void*)glXGetProcAddress((const char*)name); #endif } inline void* GetCurrentContext() { #if defined(_WIN32) return wglGetCurrentContext(); #elif defined(__APPLE__) return CGLGetCurrentContext(); #elif defined(__sgi) || defined(__sun) return dlGetCurrentContext(); #else return glXGetCurrentContext(); #endif } } "; const string TypeDefinitions = @" template struct Enumeration { private: int value; public: inline Enumeration(int value) { this->value = value; } inline operator int() const { return value; } }; typedef unsigned int GLenum; typedef unsigned int GLbitfield; typedef int GLsizei; // size_t typedef bool GLboolean; typedef signed char GLbyte; typedef unsigned char GLubyte; typedef short GLshort; typedef unsigned short GLushort; typedef int GLint; typedef unsigned int GLuint; typedef long GLlong; typedef unsigned long GLulong; typedef float GLfloat; typedef float GLclampf; typedef double GLdouble; typedef double GLclampd; typedef void GLvoid; typedef GLint* GLintptr; typedef GLsizei* GLsizeiptr; typedef const char* GLstring; #if defined(_MSC_VER) && _MSC_VER < 1400 typedef __int64 GLint64EXT; typedef unsigned __int64 GLuint64EXT; #else typedef signed long long GLint64EXT; typedef unsigned long long GLuint64EXT; #endif typedef GLint64EXT GLint64; typedef GLuint64EXT GLuint64; typedef struct __GLsync { } *GLsync; typedef struct __GLhandleARB { } *GLhandleARB; typedef GLintptr GLintptrARB; typedef GLsizeiptr GLsizeiptrARB; typedef char GLchar; typedef void (*GLDEBUGPROCAMD)(GLuint id, GLenum category, GLenum severity, GLsizei length, const GLchar* message, GLvoid* userParam); /* For ARB_debug_output */ typedef void (*GLDEBUGPROCARB)(GLenum source, GLenum type, GLuint id, GLenum severity, GLsizei length, const GLchar* message, GLvoid* userParam); /* For GL_ARB_cl_event */ typedef struct cl_context *_cl_context; typedef struct cl_event *_cl_event; //typedef GLsizei IntPtr; typedef void* IntPtr; typedef GLbyte SByte; typedef GLubyte Byte; typedef GLshort Int16; typedef GLushort UInt16; typedef GLint Int32; typedef GLuint UInt32; typedef GLlong Int64; typedef GLulong UInt64; typedef GLfloat Single; typedef GLdouble Double; typedef GLstring String; typedef char* StringBuilder; typedef GLDEBUGPROCAMD DebugProcAmd; typedef GLDEBUGPROCARB DebugProcArb; typedef struct _GLvdpauSurfaceNV *GLvdpauSurfaceNV; struct Half { private: GLushort value; public: }; typedef Half GLhalf; typedef GLhalf GLhalfNV; "; #endregion BindStreamWriter sw_h = new BindStreamWriter(Path.GetTempFileName()); #region WriteBindings public void WriteBindings(IBind generator) { Generator = generator; WriteBindings(generator.Delegates, generator.Wrappers, generator.Enums); } void WriteBindings(DelegateCollection delegates, FunctionCollection wrappers, EnumCollection enums) { Console.WriteLine("Writing bindings to {0}", Settings.OutputPath); if (!Directory.Exists(Settings.OutputPath)) Directory.CreateDirectory(Settings.OutputPath); // Hack: Fix 3dfx extension category so it doesn't start with a digit if (wrappers.ContainsKey("3dfx")) { var three_dee_fx = wrappers["3dfx"]; wrappers.Remove("3dfx"); wrappers.Add(DigitPrefix + "3dfx", three_dee_fx); } Settings.DefaultOutputNamespace = "OpenTK"; using (var sw = sw_h) { sw.WriteLine("#pragma once"); sw.WriteLine("#ifndef GLPP_H"); sw.WriteLine("#define GLPP_H"); sw.WriteLine(); WriteLicense(sw); sw.WriteLine("namespace {0}", Settings.OutputNamespace); sw.WriteLine("{"); sw.Indent(); WriteGetAddress(sw); WriteTypes(sw); WriteEnums(sw, enums); WriteDefinitions(sw, enums, wrappers, Generator.CSTypes); // Core definitions sw.Unindent(); sw.WriteLine("}"); sw.WriteLine("#endif"); sw.Flush(); sw.Close(); } string output_header = Path.Combine(Settings.OutputPath, OutputFileHeader); Move(sw_h.File, output_header); } void Move(string file, string dest) { if (File.Exists(dest)) File.Delete(dest); File.Move(file, dest); } static Delegate WriteWrapper(Delegate last_delegate, Function f, BindStreamWriter sw) { //if (last_delegate == f.WrappedDelegate) // return last_delegate; // Multiple wrappers for the same delegate are not necessary in C++ var valid = true; var parameters = GenerateParameterString(f, true, out valid); if (!valid) return last_delegate; last_delegate = f.WrappedDelegate; sw.WriteLine("inline {0} {1}({2})", f.WrappedDelegate.ReturnType, f.TrimmedName, parameters); sw.WriteLine("{"); sw.Indent(); WriteMethodBody(sw, f); sw.Unindent(); sw.WriteLine("}"); return last_delegate; } static string GenerateParameterString(Delegate d, bool check_validity, out bool valid) { if (d == null) throw new ArgumentNullException("d"); valid = true; var sb = new StringBuilder(); if (d.Parameters.Count > 0) { foreach (var p in d.Parameters) { if (p.CurrentType.ToLower() == "string[]") p.CurrentType = "char**"; if (p.CurrentType.ToLower() == "string") p.CurrentType = "char*"; if (p.Reference) { if (/*check_validity &&*/ p.Generic) { // We don't need generic parameters in C++ and void& is illegal. valid = false; return String.Empty; } if (p.Flow != FlowDirection.Out) sb.Append("const "); sb.Append(p.QualifiedType); sb.Append('*', p.Array); sb.Append("&"); } else if (p.Array > 0) { // Hack: generic parameters with array types are // not real (i.e. they are created by the generator // specifically for managed languages). We don't // need them in C++. // Todo: move C#/Java-specific code to their respective // classes, instead of the main generator. // Note: the 1-dimensional array is handled through the pointer case below. // (C# differentiates between arrays and pointers, C++ doesn't). if (check_validity && (p.Generic || p.Array == 1)) { valid = false; return String.Empty; } if (p.Flow != FlowDirection.Out) sb.Append("const "); sb.Append(p.Generic ? "void" : p.QualifiedType); // We don't need generic parameters in C++. sb.Append('*', p.Array); } else if (p.Pointer > 0) { if (p.Flow != FlowDirection.Out) sb.Append("const "); sb.Append(p.Generic ? "void" : p.QualifiedType); // We don't need generic parameters in C++. sb.Append('*', p.Pointer); } else if (p.CurrentType == "IntPtr") { if (p.Flow != FlowDirection.Out) sb.Append("const "); sb.Append("void*"); } else { sb.Append(p.QualifiedType); } sb.Append(" "); sb.Append(p.Name); sb.Append(", "); } if (d.Parameters.Count > 0) sb.Remove(sb.Length - 2, 2); } return sb.ToString(); } static Delegate WriteInitDelegate(Delegate last_delegate, BindStreamWriter sw, Function f) { if (last_delegate != f.WrappedDelegate) { sw.WriteLine("Delegates::{0}() = (Delegates::p{0})OpenTK::Internals::GetAddress(\"gl{0}\");", f.WrappedDelegate.Name); last_delegate = f.WrappedDelegate; } return last_delegate; } #endregion #region WriteDefinitions void WriteDefinitions(BindStreamWriter sw, EnumCollection enums, FunctionCollection wrappers, IDictionary CSTypes) { sw.WriteLine("namespace {0}", Settings.GLClass); sw.WriteLine("{"); sw.Indent(); foreach (string extension in wrappers.Keys) { if (extension != "Core") { sw.WriteLine("namespace {0}", extension); sw.WriteLine("{"); sw.Indent(); } // Avoid multiple definitions of the same function Delegate last_delegate = null; // Write delegates sw.WriteLine("namespace Delegates"); sw.WriteLine("{"); sw.Indent(); var functions = wrappers[extension]; last_delegate = null; foreach (var f in functions.Where(f => !f.Deprecated)) { WriteDelegate(sw, f.WrappedDelegate, ref last_delegate); } last_delegate = null; sw.WriteLine("#if defined({0})", AllowDeprecated); foreach (var f in functions.Where(f => f.Deprecated)) { WriteDelegate(sw, f.WrappedDelegate, ref last_delegate); } sw.WriteLine("#endif"); sw.Unindent(); sw.WriteLine("};"); // Write wrappers sw.WriteLine("inline void Init()"); sw.WriteLine("{"); sw.Indent(); last_delegate = null; foreach (var f in functions.Where(f => !f.Deprecated)) { last_delegate = WriteInitDelegate(last_delegate, sw, f); } last_delegate = null; sw.WriteLine("#if defined({0})", AllowDeprecated); foreach (var f in functions.Where(f => f.Deprecated)) { last_delegate = WriteInitDelegate(last_delegate, sw, f); } sw.WriteLine("#endif"); sw.Unindent(); sw.WriteLine("}"); last_delegate = null; foreach (var f in functions.Where(f => !f.Deprecated)) { last_delegate = WriteWrapper(last_delegate, f, sw); } sw.WriteLine("#if defined({0})", AllowDeprecated); foreach (var f in functions.Where(f => f.Deprecated)) { last_delegate = WriteWrapper(last_delegate, f, sw); } sw.WriteLine("#endif"); if (extension != "Core") { sw.Unindent(); sw.WriteLine("};"); } } sw.Unindent(); sw.WriteLine("};"); } #endregion string GetNamespace(string ext) { if (ext == "Core") return Settings.GLClass; else return String.Format("{0}::{1}", Settings.GLClass, Char.IsDigit(ext[0]) ? DigitPrefix + ext : ext); } #region WriteEnums public void WriteEnums(BindStreamWriter sw, EnumCollection enums) { foreach (Enum @enum in enums.Values) { sw.WriteLine("struct {0} : Enumeration<{0}>", @enum.Name); sw.WriteLine("{"); sw.Indent(); sw.WriteLine("inline {0}(int value) : Enumeration<{0}>(value) {{ }}", @enum.Name); sw.WriteLine("enum"); sw.WriteLine("{"); sw.Indent(); foreach (var c in @enum.ConstantCollection.Values) { sw.WriteLine(String.Format("{0} = {1}{2},", c.Name, !String.IsNullOrEmpty(c.Reference) ? (c.Reference + Settings.NamespaceSeparator) : "", !String.IsNullOrEmpty(c.Reference) ? c.Value : c.Value.ToLower())); } sw.Unindent(); sw.WriteLine("};"); sw.Unindent(); sw.WriteLine("};"); sw.WriteLine(); } } #endregion #region WriteTypes void WriteTypes(BindStreamWriter sw) { sw.WriteLine(TypeDefinitions); } #endregion #region WriteGetAddress void WriteGetAddress(BindStreamWriter sw) { sw.WriteLine(GetAddressDefinition); } #endregion #region WriteDelegate static void WriteDelegate(BindStreamWriter sw, Delegate d, ref Delegate last_delegate) { // Avoid multiple definitions of the same function if (d != last_delegate) { last_delegate = d; bool valid = true; var parameters = GenerateParameterString(d, false, out valid); sw.WriteLine("typedef {0} (GLPP_APIENTRY *p{1})({2});", d.ReturnType, d.Name, parameters); sw.WriteLine("inline p{0}& {0}()", d.Name); sw.WriteLine("{"); sw.Indent(); sw.WriteLine("static p{0} address = 0;", d.Name); sw.WriteLine("return address;"); sw.Unindent(); sw.WriteLine("}"); } } #endregion #region WriteWrappers static void WriteMethodBody(BindStreamWriter sw, Function f) { //var callstring = f.Parameters.CallString() // .Replace("String[]", "String*"); var callstring = GenerateCallString(f); if (f.ReturnType != null && !f.ReturnType.ToString().ToLower().Contains("void")) sw.Write("return "); sw.WriteLine("Delegates::{0}()({1});", f.WrappedDelegate.Name, callstring); } static object GenerateCallString(Function f) { var sb = new StringBuilder(); foreach (var p in f.Parameters) { if (p.Reference) sb.Append("&"); // Convert to pointer sb.Append(p.Name); sb.Append(", "); } if (f.Parameters.Count > 0) sb.Remove(sb.Length - 2, 2); return sb.ToString(); } void WriteDocumentation(BindStreamWriter sw, Function f) { var docs = f.Documentation; try { string warning = "[deprecated: v{0}]"; string category = "[requires: {0}]"; if (f.Deprecated) { warning = String.Format(warning, f.DeprecatedVersion); docs.Summary = docs.Summary.Insert(0, warning); } if (f.Extension != "Core" && !String.IsNullOrEmpty(f.Category)) { category = String.Format(category, f.Category); docs.Summary = docs.Summary.Insert(0, category); } else if (!String.IsNullOrEmpty(f.Version)) { if (f.Category.StartsWith("VERSION")) category = String.Format(category, "v" + f.Version); else category = String.Format(category, "v" + f.Version + " and " + f.Category); docs.Summary = docs.Summary.Insert(0, category); } for (int i = 0; i < f.WrappedDelegate.Parameters.Count; i++) { var param = f.WrappedDelegate.Parameters[i]; if (param.ComputeSize != String.Empty) { docs.Parameters[i].Documentation.Insert(0, String.Format("[length: {0}]", param.ComputeSize)); } } sw.Write("/// \brief "); sw.WriteLine(docs.Summary); foreach (var p in docs.Parameters) { sw.Write(@"/// \param "); sw.Write(p.Name); sw.WriteLine(p.Documentation); } } catch (Exception e) { Console.WriteLine("[Warning] Error documenting function {0}: {1}", f.WrappedDelegate.Name, e.ToString()); } } #endregion #region WriteLicense public void WriteLicense(BindStreamWriter sw) { sw.WriteLine(File.ReadAllText(Path.Combine(Settings.InputPath, Settings.LicenseFile))); sw.WriteLine(); } #endregion } }