blob: 9c7a1dc77beb3163e8dfec17df6a2ebe4d80ff15 [file] [log] [blame]
Jack Jansen9d8b96c2000-07-14 22:16:45 +00001/*
Jack Jansen94bebc02001-08-08 13:17:31 +00002** pymactoolbox.h - globals defined in mactoolboxglue.c
Jack Jansen9d8b96c2000-07-14 22:16:45 +00003*/
4
5#ifdef __cplusplus
6 extern "C" {
7#endif
8
Jack Jansen9f66b4a2001-05-19 12:32:39 +00009#ifdef WITHOUT_FRAMEWORKS
Jack Jansen9d8b96c2000-07-14 22:16:45 +000010#include <Memory.h>
11#include <Dialogs.h>
12#include <Menus.h>
13#include <Controls.h>
14#include <Components.h>
15#include <Lists.h>
16#include <Movies.h>
17#include <Errors.h>
Jack Jansen9f66b4a2001-05-19 12:32:39 +000018#else
19#include <Carbon/Carbon.h>
20#include <QuickTime/QuickTime.h>
21#endif
Jack Jansen9d8b96c2000-07-14 22:16:45 +000022
Jack Jansen94bebc02001-08-08 13:17:31 +000023/*
24** Helper routines for error codes and such.
25*/
26char *PyMac_getscript(void); /* Get the default encoding for our 8bit character set */
27char *PyMac_StrError(int); /* strerror with mac errors */
28PyObject *PyErr_Mac(PyObject *, int); /* Exception with a mac error */
29PyObject *PyMac_Error(OSErr); /* Uses PyMac_GetOSErrException */
Jack Jansen7b049462001-09-10 22:09:30 +000030extern OSErr PyMac_GetFullPathname(FSSpec *, char *, int); /* convert fsspec->path */
Jack Jansen94bebc02001-08-08 13:17:31 +000031
32/*
33** These conversion routines are defined in mactoolboxglue.c itself.
34*/
35int PyMac_GetOSType(PyObject *, OSType *); /* argument parser for OSType */
36PyObject *PyMac_BuildOSType(OSType); /* Convert OSType to PyObject */
37
38PyObject *PyMac_BuildNumVersion(NumVersion);/* Convert NumVersion to PyObject */
39
40int PyMac_GetStr255(PyObject *, Str255); /* argument parser for Str255 */
41PyObject *PyMac_BuildStr255(Str255); /* Convert Str255 to PyObject */
42PyObject *PyMac_BuildOptStr255(Str255); /* Convert Str255 to PyObject, NULL to None */
43
44int PyMac_GetRect(PyObject *, Rect *); /* argument parser for Rect */
45PyObject *PyMac_BuildRect(Rect *); /* Convert Rect to PyObject */
46
47int PyMac_GetPoint(PyObject *, Point *); /* argument parser for Point */
48PyObject *PyMac_BuildPoint(Point); /* Convert Point to PyObject */
49
50int PyMac_GetEventRecord(PyObject *, EventRecord *); /* argument parser for EventRecord */
51PyObject *PyMac_BuildEventRecord(EventRecord *); /* Convert EventRecord to PyObject */
52
53int PyMac_GetFixed(PyObject *, Fixed *); /* argument parser for Fixed */
54PyObject *PyMac_BuildFixed(Fixed); /* Convert Fixed to PyObject */
55int PyMac_Getwide(PyObject *, wide *); /* argument parser for wide */
56PyObject *PyMac_Buildwide(wide *); /* Convert wide to PyObject */
57
58/*
59** The rest of the routines are implemented by extension modules. If they are
60** dynamically loaded mactoolboxglue will contain a stub implementation of the
61** routine, which imports the module, whereupon the module's init routine will
62** communicate the routine pointer back to the stub.
63** If USE_TOOLBOX_OBJECT_GLUE is not defined there is no glue code, and the
64** extension modules simply declare the routine. This is the case for static
65** builds (and could be the case for MacPython CFM builds, because CFM extension
66** modules can reference each other without problems).
67*/
68
Jack Jansenf57a4a22001-05-17 22:11:44 +000069#ifdef USE_TOOLBOX_OBJECT_GLUE
70/*
71** These macros are used in the module init code. If we use toolbox object glue
72** it sets the function pointer to point to the real function.
73*/
Jack Jansen0268ac82001-05-22 22:34:56 +000074#define PyMac_INIT_TOOLBOX_OBJECT_NEW(object, rtn) { \
Jack Jansenf57a4a22001-05-17 22:11:44 +000075 extern PyObject *(*PyMacGluePtr_##rtn)(object); \
76 PyMacGluePtr_##rtn = _##rtn; \
77}
Jack Jansen0268ac82001-05-22 22:34:56 +000078#define PyMac_INIT_TOOLBOX_OBJECT_CONVERT(object, rtn) { \
79 extern int (*PyMacGluePtr_##rtn)(PyObject *, object *); \
Jack Jansenf57a4a22001-05-17 22:11:44 +000080 PyMacGluePtr_##rtn = _##rtn; \
81}
82#else
83/*
84** If we don't use toolbox object glue the init macros are empty. Moreover, we define
85** _xxx_New to be the same as xxx_New, and the code in mactoolboxglue isn't included.
86*/
Jack Jansen0268ac82001-05-22 22:34:56 +000087#define PyMac_INIT_TOOLBOX_OBJECT_NEW(object, rtn)
88#define PyMac_INIT_TOOLBOX_OBJECT_CONVERT(object, rtn)
Jack Jansenf57a4a22001-05-17 22:11:44 +000089#endif /* USE_TOOLBOX_OBJECT_GLUE */
90
Jack Jansena5bca572001-08-03 15:39:27 +000091/* macfs exports */
Jack Jansenfabd00f2001-09-01 23:39:58 +000092int PyMac_GetFSSpec(PyObject *, FSSpec *); /* argument parser for FSSpec */
93PyObject *PyMac_BuildFSSpec(FSSpec *); /* Convert FSSpec to PyObject */
94
95int PyMac_GetFSRef(PyObject *, FSRef *); /* argument parser for FSRef */
96PyObject *PyMac_BuildFSRef(FSRef *); /* Convert FSRef to PyObject */
Jack Jansena5bca572001-08-03 15:39:27 +000097
Jack Jansen9d8b96c2000-07-14 22:16:45 +000098/* AE exports */
99extern PyObject *AEDesc_New(AppleEvent *); /* XXXX Why passed by address?? */
100extern int AEDesc_Convert(PyObject *, AppleEvent *);
101
102/* Cm exports */
103extern PyObject *CmpObj_New(Component);
104extern int CmpObj_Convert(PyObject *, Component *);
105extern PyObject *CmpInstObj_New(ComponentInstance);
106extern int CmpInstObj_Convert(PyObject *, ComponentInstance *);
107
108/* Ctl exports */
109extern PyObject *CtlObj_New(ControlHandle);
110extern int CtlObj_Convert(PyObject *, ControlHandle *);
111
112/* Dlg exports */
113extern PyObject *DlgObj_New(DialogPtr);
114extern int DlgObj_Convert(PyObject *, DialogPtr *);
Jack Jansenadd58f92001-02-09 15:59:18 +0000115extern PyObject *DlgObj_WhichDialog(DialogPtr);
Jack Jansen9d8b96c2000-07-14 22:16:45 +0000116
117/* Drag exports */
118extern PyObject *DragObj_New(DragReference);
119extern int DragObj_Convert(PyObject *, DragReference *);
120
121/* List exports */
122extern PyObject *ListObj_New(ListHandle);
123extern int ListObj_Convert(PyObject *, ListHandle *);
124
125/* Menu exports */
126extern PyObject *MenuObj_New(MenuHandle);
127extern int MenuObj_Convert(PyObject *, MenuHandle *);
128
129/* Qd exports */
130extern PyObject *GrafObj_New(GrafPtr);
131extern int GrafObj_Convert(PyObject *, GrafPtr *);
132extern PyObject *BMObj_New(BitMapPtr);
133extern int BMObj_Convert(PyObject *, BitMapPtr *);
134extern PyObject *QdRGB_New(RGBColor *);
135extern int QdRGB_Convert(PyObject *, RGBColor *);
136
Jack Jansen50bf1482000-12-12 22:13:03 +0000137/* Qdoffs exports */
138extern PyObject *GWorldObj_New(GWorldPtr);
139extern int GWorldObj_Convert(PyObject *, GWorldPtr *);
140
Jack Jansen9d8b96c2000-07-14 22:16:45 +0000141/* Qt exports */
142extern PyObject *TrackObj_New(Track);
143extern int TrackObj_Convert(PyObject *, Track *);
144extern PyObject *MovieObj_New(Movie);
145extern int MovieObj_Convert(PyObject *, Movie *);
146extern PyObject *MovieCtlObj_New(MovieController);
Jack Jansenf57a4a22001-05-17 22:11:44 +0000147extern int MovieCtlObj_Convert(PyObject *, MovieController *);
Jack Jansen9d8b96c2000-07-14 22:16:45 +0000148extern PyObject *TimeBaseObj_New(TimeBase);
149extern int TimeBaseObj_Convert(PyObject *, TimeBase *);
150extern PyObject *UserDataObj_New(UserData);
151extern int UserDataObj_Convert(PyObject *, UserData *);
152extern PyObject *MediaObj_New(Media);
153extern int MediaObj_Convert(PyObject *, Media *);
154
155/* Res exports */
156extern PyObject *ResObj_New(Handle);
157extern int ResObj_Convert(PyObject *, Handle *);
158extern PyObject *OptResObj_New(Handle);
159extern int OptResObj_Convert(PyObject *, Handle *);
160
161/* TE exports */
162extern PyObject *TEObj_New(TEHandle);
163extern int TEObj_Convert(PyObject *, TEHandle *);
164
165/* Win exports */
166extern PyObject *WinObj_New(WindowPtr);
167extern int WinObj_Convert(PyObject *, WindowPtr *);
168extern PyObject *WinObj_WhichWindow(WindowPtr);
Jack Jansen9d8b96c2000-07-14 22:16:45 +0000169
170
171#ifdef __cplusplus
172 }
173#endif