Offscreen bitmap support, first stab. PixMaps are still treated as ordinary

handles, not fullblown python objects, and UpdateGWorld returns a new GWorld
object in stead of modifying the existing one.

Mac/Lib/lib-toolbox/QDOffscreen.py

+# Generated from 'Moes:Codewarrior Pro 4:Metrowerks CodeWarrior:MacOS Support:Headers:Universal Headers:QDOffscreen.h'
+
+def FOUR_CHAR_CODE(x): return x
+pixPurgeBit = 0
+noNewDeviceBit = 1
+useTempMemBit = 2
+keepLocalBit = 3
+pixelsPurgeableBit = 6
+pixelsLockedBit = 7
+mapPixBit = 16
+newDepthBit = 17
+alignPixBit = 18
+newRowBytesBit = 19
+reallocPixBit = 20
+clipPixBit = 28
+stretchPixBit = 29
+ditherPixBit = 30
+gwFlagErrBit = 31
+pixPurge = 1L << pixPurgeBit
+noNewDevice = 1L << noNewDeviceBit
+useTempMem = 1L << useTempMemBit
+keepLocal = 1L << keepLocalBit
+pixelsPurgeable = 1L << pixelsPurgeableBit
+pixelsLocked = 1L << pixelsLockedBit
+kAllocDirectDrawSurface = 1L << 14
+mapPix = 1L << mapPixBit
+newDepth = 1L << newDepthBit
+alignPix = 1L << alignPixBit
+newRowBytes = 1L << newRowBytesBit
+reallocPix = 1L << reallocPixBit
+clipPix = 1L << clipPixBit
+stretchPix = 1L << stretchPixBit
+ditherPix = 1L << ditherPixBit
+gwFlagErr = 1L << gwFlagErrBit

Mac/Modules/qdoffs/qdoffsscan.py

+# Scan an Apple header file, generating a Python file of generator calls.
+import sys
+import os
+BGENDIR=os.path.join(sys.prefix, ':Tools:bgen:bgen')
+sys.path.append(BGENDIR)
+from bgenlocations import TOOLBOXDIR
+
+from scantools import Scanner
+
+def main():
+	input = "QDOffscreen.h"
+	output = "qdoffsgen.py"
+	defsoutput = TOOLBOXDIR + "QDOffscreen.py"
+	scanner = MyScanner(input, output, defsoutput)
+	scanner.scan()
+	scanner.close()
+	print "=== Done scanning and generating, now importing the generated code... ==="
+	import qdoffssupport
+	print "=== Done.  It's up to you to compile it now! ==="
+
+class MyScanner(Scanner):
+
+	def destination(self, type, name, arglist):
+		classname = "Function"
+		listname = "functions"
+		if arglist:
+			t, n, m = arglist[0]
+			if t == "GWorldPtr" and m in ("InMode", "InOutMode"):
+				classname = "Method"
+				listname = "methods"
+		return classname, listname
+
+	def writeinitialdefs(self):
+		self.defsfile.write("def FOUR_CHAR_CODE(x): return x\n")
+
+	def makeblacklistnames(self):
+		return [
+			'DisposeGWorld', # Implied when the object is deleted
+			'NewGWorldFromHBITMAP', # Don't know what the args do
+			'GetGDeviceAttributes', # Doesn't seem to exist
+			]
+
+	def makeblacklisttypes(self):
+		return [
+			"void_ptr",		# GetGDeviceSurface, blacklisted for now
+			"Ptr",			# Again, for now (array is probably ok here)
+			]
+
+	def makerepairinstructions(self):
+		return [
+			
+## 			("UpdateGWorld",
+## 			 [("GWorldPtr", "*", "OutMode")],
+## 			 [("*", "*", "InOutMode")]),
+			 
+			# This one is incorrect: we say that all input gdevices are
+			# optional, but some are not. Most are, however, so users passing
+			# None for non-optional gdevices will get a qd error, I guess, in
+			# stead of a python argument error.
+			([("GDHandle", "*", "InMode")],
+			 [("OptGDHandle", "*", "InMode")]),
+			]
+
+if __name__ == "__main__":
+	main()
+

Mac/Modules/qdoffs/qdoffssupport.py

+# This script generates a Python interface for an Apple Macintosh Manager.
+# It uses the "bgen" package to generate C code.
+# The function specifications are generated by scanning the mamager's header file,
+# using the "scantools" package (customized for this particular manager).
+
+import string
+
+# Declarations that change for each manager
+MACHEADERFILE = 'QDOffscreen.h'		# The Apple header file
+MODNAME = 'Qdoffs'				# The name of the module
+OBJECTNAME = 'GWorld'			# The basic name of the objects used here
+
+# The following is *usually* unchanged but may still require tuning
+MODPREFIX = MODNAME			# The prefix for module-wide routines
+OBJECTTYPE = OBJECTNAME + 'Ptr'		# The C type used to represent them
+OBJECTPREFIX = OBJECTNAME + 'Obj'	# The prefix for object methods
+INPUTFILE = string.lower(MODPREFIX) + 'gen.py' # The file generated by the scanner
+#EDITFILE = string.lower(MODPREFIX) + 'edit.py' # The manual definitions
+OUTPUTFILE = MODNAME + "module.c"	# The file generated by this program
+
+from macsupport import *
+
+# Create the type objects
+
+GWorldPtr = OpaqueByValueType(OBJECTTYPE, OBJECTPREFIX)
+GWorldFlags = Type("GWorldFlags", "l")
+GDHandle = OpaqueByValueType("GDHandle", "ResObj")
+OptGDHandle = OpaqueByValueType("GDHandle", "OptResObj")
+CTabHandle = OpaqueByValueType("CTabHandle", "OptResObj")
+PixPatHandle = OpaqueByValueType("PixPatHandle", "ResObj")
+PixMapHandle = OpaqueByValueType("PixMapHandle", "ResObj")
+CGrafPtr = OpaqueByValueType("CGrafPtr", "GrafObj")
+GrafPtr = OpaqueByValueType("GrafPtr", "GrafObj")
+QDErr = OSErrType("QDErr", 'h')
+
+includestuff = includestuff + """
+#include <%s>""" % MACHEADERFILE + """
+
+#define resNotFound -192 /* Can't include <Errors.h> because of Python's "errors.h" */
+
+"""
+
+
+class MyObjectDefinition(GlobalObjectDefinition):
+	def outputCheckNewArg(self):
+		Output("if (itself == NULL) return PyMac_Error(resNotFound);")
+## 	def outputInitStructMembers(self):
+## 		GlobalObjectDefinition.outputInitStructMembers(self)
+## 		Output("SetWRefCon(itself, (long)it);")
+## 	def outputCheckConvertArg(self):
+## 		OutLbrace("if (DlgObj_Check(v))")
+## 		Output("*p_itself = ((WindowObject *)v)->ob_itself;")
+## 		Output("return 1;")
+## 		OutRbrace()
+## 		Out("""
+## 		if (v == Py_None) { *p_itself = NULL; return 1; }
+## 		if (PyInt_Check(v)) { *p_itself = (WindowPtr)PyInt_AsLong(v); return 1; }
+## 		""")
+	def outputFreeIt(self, itselfname):
+		Output("DisposeGWorld(%s);", itselfname)
+# From here on it's basically all boiler plate...
+
+# Create the generator groups and link them
+module = MacModule(MODNAME, MODPREFIX, includestuff, finalstuff, initstuff)
+object = MyObjectDefinition(OBJECTNAME, OBJECTPREFIX, OBJECTTYPE)
+module.addobject(object)
+
+
+# Create the generator classes used to populate the lists
+Function = OSErrFunctionGenerator
+Method = OSErrMethodGenerator
+
+# Create and populate the lists
+functions = []
+methods = []
+execfile(INPUTFILE)
+
+
+# add the populated lists to the generator groups
+# (in a different wordl the scan program would generate this)
+for f in functions: module.add(f)
+for f in methods: object.add(f)
+
+
+
+# generate output (open the output file as late as possible)
+SetOutputFileName(OUTPUTFILE)
+module.generate()