]>
git.saurik.com Git - wxWidgets.git/blob - contrib/src/stc/gen_iface.py
2 #----------------------------------------------------------------------------
4 # Purpose: Generate stc.h and stc.cpp from the info in Scintilla.iface
10 # Copyright: (c) 2000 by Total Control Software
11 # Licence: wxWindows license
12 #----------------------------------------------------------------------------
15 import sys
, string
, re
, os
16 from fileinput
import FileInput
19 IFACE
= os
.path
.abspath('./scintilla/include/Scintilla.iface')
20 H_TEMPLATE
= os
.path
.abspath('./stc.h.in')
21 CPP_TEMPLATE
= os
.path
.abspath('./stc.cpp.in')
22 H_DEST
= os
.path
.abspath('../../include/wx/stc/stc.h')
23 CPP_DEST
= os
.path
.abspath('./stc.cpp')
26 # Value prefixes to convert
27 valPrefixes
= [('SCI_', ''),
29 ('SCN_', None), # just toss these out...
38 # Message function values that should have a CMD_ constant as well
39 cmdValues
= [ (2300, 2350), 2011, 2013, (2176, 2180) ]
42 # Map some generic typenames to wx types, using return value syntax
49 # Map some generic typenames to wx types, using parameter syntax
52 'string': 'const wxString&',
53 'colour': 'const wxColour&',
57 # Map of method info that needs tweaked. Either the name needs changed, or
58 # the method definition/implementation. Tuple items are:
60 # 1. New method name. None to skip the method, 0 to leave the
62 # 2. Method definition for the .h file, 0 to leave alone
63 # 3. Method implementation for the .cpp file, 0 to leave alone.
64 # 4. tuple of Doc string lines, or 0 to leave alone.
68 'void %s(const wxString& text);',
70 '''void %s(const wxString& text) {
71 wxWX2MBbuf buf = (wxWX2MBbuf)wx2stc(text);
72 SendMsg(%s, strlen(buf), (long)(const char*)buf);''',
76 'void %s(const wxMemoryBuffer& data);',
78 '''void %s(const wxMemoryBuffer& data) {
79 SendMsg(%s, data.GetDataLen(), (long)data.GetData());''',
82 'GetViewWS' : ( 'GetViewWhiteSpace', 0, 0, 0),
83 'SetViewWS' : ( 'SetViewWhiteSpace', 0, 0, 0),
87 return (unsigned char)SendMsg(%s, pos, 0);''',
90 'GetStyleAt' : ( 0, 0,
92 return (unsigned char)SendMsg(%s, pos, 0);''',
96 'wxMemoryBuffer %s(int startPos, int endPos);',
98 '''wxMemoryBuffer %s(int startPos, int endPos) {
100 if (endPos < startPos) {
105 int len = endPos - startPos;
106 if (!len) return buf;
108 tr.lpstrText = (char*)buf.GetWriteBuf(len*2+1);
109 tr.chrg.cpMin = startPos;
110 tr.chrg.cpMax = endPos;
111 len = SendMsg(%s, 0, (long)&tr);
112 buf.UngetWriteBuf(len);
115 ('Retrieve a buffer of cells.',)),
118 'PositionFromPoint' : (0,
119 'int %s(wxPoint pt);',
121 '''int %s(wxPoint pt) {
122 return SendMsg(%s, pt.x, pt.y);''',
127 '#ifdef SWIG\n wxString %s(int* OUTPUT);\n#else\n wxString GetCurLine(int* linePos=NULL);\n#endif',
129 '''wxString %s(int* linePos) {
130 int len = LineLength(GetCurrentLine());
132 if (linePos) *linePos = 0;
133 return wxEmptyString;
136 wxMemoryBuffer mbuf(len+1);
137 char* buf = (char*)mbuf.GetWriteBuf(len+1);
139 int pos = SendMsg(%s, len+1, (long)buf);
140 mbuf.UngetWriteBuf(len);
142 if (linePos) *linePos = pos;
143 return stc2wx(buf);''',
147 'SetUsePalette' : (None, 0,0,0),
149 'MarkerSetFore' : ('MarkerSetForeground', 0, 0, 0),
150 'MarkerSetBack' : ('MarkerSetBackground', 0, 0, 0),
153 '''void %s(int markerNumber, int markerSymbol,
154 const wxColour& foreground = wxNullColour,
155 const wxColour& background = wxNullColour);''',
157 '''void %s(int markerNumber, int markerSymbol,
158 const wxColour& foreground,
159 const wxColour& background) {
161 SendMsg(%s, markerNumber, markerSymbol);
163 MarkerSetForeground(markerNumber, foreground);
165 MarkerSetBackground(markerNumber, background);''',
167 ('Set the symbol used for a particular marker number,',
168 'and optionally the fore and background colours.')),
170 'SetMarginTypeN' : ('SetMarginType', 0, 0, 0),
171 'GetMarginTypeN' : ('GetMarginType', 0, 0, 0),
172 'SetMarginWidthN' : ('SetMarginWidth', 0, 0, 0),
173 'GetMarginWidthN' : ('GetMarginWidth', 0, 0, 0),
174 'SetMarginMaskN' : ('SetMarginMask', 0, 0, 0),
175 'GetMarginMaskN' : ('GetMarginMask', 0, 0, 0),
176 'SetMarginSensitiveN' : ('SetMarginSensitive', 0, 0, 0),
177 'GetMarginSensitiveN' : ('GetMarginSensitive', 0, 0, 0),
179 'StyleSetFore' : ('StyleSetForeground', 0, 0, 0),
180 'StyleSetBack' : ('StyleSetBackground', 0, 0, 0),
181 'SetSelFore' : ('SetSelForeground', 0, 0, 0),
182 'SetSelBack' : ('SetSelBackground', 0, 0, 0),
183 'SetCaretFore' : ('SetCaretForeground', 0, 0, 0),
184 'StyleSetFont' : ('StyleSetFaceName', 0, 0, 0),
186 'AssignCmdKey' : ('CmdKeyAssign',
187 'void %s(int key, int modifiers, int cmd);',
189 '''void %s(int key, int modifiers, int cmd) {
190 SendMsg(%s, MAKELONG(key, modifiers), cmd);''',
194 'ClearCmdKey' : ('CmdKeyClear',
195 'void %s(int key, int modifiers);',
197 '''void %s(int key, int modifiers) {
198 SendMsg(%s, MAKELONG(key, modifiers));''',
202 'ClearAllCmdKeys' : ('CmdKeyClearAll', 0, 0, 0),
205 'SetStylingEx' : ('SetStyleBytes',
206 'void %s(int length, char* styleBytes);',
208 '''void %s(int length, char* styleBytes) {
209 SendMsg(%s, length, (long)styleBytes);''',
214 'IndicSetStyle' : ('IndicatorSetStyle', 0, 0, 0),
215 'IndicGetStyle' : ('IndicatorGetStyle', 0, 0, 0),
216 'IndicSetFore' : ('IndicatorSetForeground', 0, 0, 0),
217 'IndicGetFore' : ('IndicatorGetForeground', 0, 0, 0),
219 'SetWhitespaceFore' : ('SetWhitespaceForeground', 0, 0, 0),
220 'SetWhitespaceBack' : ('SetWhitespaceBackground', 0, 0, 0),
222 'AutoCShow' : ('AutoCompShow', 0, 0, 0),
223 'AutoCCancel' : ('AutoCompCancel', 0, 0, 0),
224 'AutoCActive' : ('AutoCompActive', 0, 0, 0),
225 'AutoCPosStart' : ('AutoCompPosStart', 0, 0, 0),
226 'AutoCComplete' : ('AutoCompComplete', 0, 0, 0),
227 'AutoCStops' : ('AutoCompStops', 0, 0, 0),
228 'AutoCSetSeparator' : ('AutoCompSetSeparator', 0, 0, 0),
229 'AutoCGetSeparator' : ('AutoCompGetSeparator', 0, 0, 0),
230 'AutoCSelect' : ('AutoCompSelect', 0, 0, 0),
231 'AutoCSetCancelAtStart' : ('AutoCompSetCancelAtStart', 0, 0, 0),
232 'AutoCGetCancelAtStart' : ('AutoCompGetCancelAtStart', 0, 0, 0),
233 'AutoCSetFillUps' : ('AutoCompSetFillUps', 0, 0, 0),
234 'AutoCSetChooseSingle' : ('AutoCompSetChooseSingle', 0, 0, 0),
235 'AutoCGetChooseSingle' : ('AutoCompGetChooseSingle', 0, 0, 0),
236 'AutoCSetIgnoreCase' : ('AutoCompSetIgnoreCase', 0, 0, 0),
237 'AutoCGetIgnoreCase' : ('AutoCompGetIgnoreCase', 0, 0, 0),
238 'AutoCSetAutoHide' : ('AutoCompSetAutoHide', 0, 0, 0),
239 'AutoCGetAutoHide' : ('AutoCompGetAutoHide', 0, 0, 0),
240 'AutoCSetDropRestOfWord' : ('AutoCompSetDropRestOfWord', 0,0,0),
241 'AutoCGetDropRestOfWord' : ('AutoCompGetDropRestOfWord', 0,0,0),
244 'SetHScrollBar' : ('SetUseHorizontalScrollBar', 0, 0, 0),
245 'GetHScrollBar' : ('GetUseHorizontalScrollBar', 0, 0, 0),
247 'GetCaretFore' : ('GetCaretForeground', 0, 0, 0),
249 'GetUsePalette' : (None, 0, 0, 0),
252 '''int %s(int minPos, int maxPos, const wxString& text, int flags=0);''',
254 '''int %s(int minPos, int maxPos,
255 const wxString& text,
258 ft.chrg.cpMin = minPos;
259 ft.chrg.cpMax = maxPos;
260 wxWX2MBbuf buf = (wxWX2MBbuf)wx2stc(text);
261 ft.lpstrText = (char*)(const char*)buf;
263 return SendMsg(%s, flags, (long)&ft);''',
267 '''int %s(bool doDraw,
271 wxDC* target, // Why does it use two? Can they be the same?
273 wxRect pageRect);''',
274 ''' int %s(bool doDraw,
278 wxDC* target, // Why does it use two? Can they be the same?
283 if (endPos < startPos) {
289 fr.hdcTarget = target;
290 fr.rc.top = renderRect.GetTop();
291 fr.rc.left = renderRect.GetLeft();
292 fr.rc.right = renderRect.GetRight();
293 fr.rc.bottom = renderRect.GetBottom();
294 fr.rcPage.top = pageRect.GetTop();
295 fr.rcPage.left = pageRect.GetLeft();
296 fr.rcPage.right = pageRect.GetRight();
297 fr.rcPage.bottom = pageRect.GetBottom();
298 fr.chrg.cpMin = startPos;
299 fr.chrg.cpMax = endPos;
301 return SendMsg(%s, doDraw, (long)&fr);''',
306 'wxString %s(int line);',
308 '''wxString %s(int line) {
309 int len = LineLength(line);
310 if (!len) return wxEmptyString;
312 wxMemoryBuffer mbuf(len+1);
313 char* buf = (char*)mbuf.GetWriteBuf(len+1);
314 SendMsg(%s, line, (long)buf);
315 mbuf.UngetWriteBuf(len);
317 return stc2wx(buf);''',
319 ('Retrieve the contents of a line.',)),
321 'SetSel' : ('SetSelection', 0, 0, 0),
322 'GetSelText' : ('GetSelectedText',
329 GetSelection(&start, &end);
330 int len = end - start;
331 if (!len) return wxEmptyString;
333 wxMemoryBuffer mbuf(len+1);
334 char* buf = (char*)mbuf.GetWriteBuf(len+1);
335 SendMsg(%s, 0, (long)buf);
336 mbuf.UngetWriteBuf(len);
338 return stc2wx(buf);''',
340 ('Retrieve the selected text.',)),
343 'wxString %s(int startPos, int endPos);',
345 '''wxString %s(int startPos, int endPos) {
346 if (endPos < startPos) {
351 int len = endPos - startPos;
352 if (!len) return wxEmptyString;
353 wxMemoryBuffer mbuf(len+1);
354 char* buf = (char*)mbuf.GetWriteBuf(len);
357 tr.chrg.cpMin = startPos;
358 tr.chrg.cpMax = endPos;
359 SendMsg(%s, 0, (long)&tr);
360 mbuf.UngetWriteBuf(len);
362 return stc2wx(buf);''',
364 ('Retrieve a range of text.',)),
366 'PointXFromPosition' : (None, 0, 0, 0),
367 'PointYFromPosition' : (None, 0, 0, 0),
369 'ScrollCaret' : ('EnsureCaretVisible', 0, 0, 0),
370 'ReplaceSel' : ('ReplaceSelection', 0, 0, 0),
371 'Null' : (None, 0, 0, 0),
377 int len = GetTextLength();
378 wxMemoryBuffer mbuf(len+1); // leave room for the null...
379 char* buf = (char*)mbuf.GetWriteBuf(len+1);
380 SendMsg(%s, len+1, (long)buf);
381 mbuf.UngetWriteBuf(len);
383 return stc2wx(buf);''',
385 ('Retrieve all the text in the document.', )),
387 'GetDirectFunction' : (None, 0, 0, 0),
388 'GetDirectPointer' : (None, 0, 0, 0),
390 'CallTipPosStart' : ('CallTipPosAtStart', 0, 0, 0),
391 'CallTipSetHlt' : ('CallTipSetHighlight', 0, 0, 0),
392 'CallTipSetBack' : ('CallTipSetBackground', 0, 0, 0),
395 'ReplaceTarget' : (0,
396 'int %s(const wxString& text);',
399 int %s(const wxString& text) {
400 wxWX2MBbuf buf = (wxWX2MBbuf)wx2stc(text);
401 return SendMsg(%s, strlen(buf), (long)(const char*)buf);''',
404 'ReplaceTargetRE' : (0,
405 'int %s(const wxString& text);',
408 int %s(const wxString& text) {
409 wxWX2MBbuf buf = (wxWX2MBbuf)wx2stc(text);
410 return SendMsg(%s, strlen(buf), (long)(const char*)buf);''',
413 'SearchInTarget' : (0,
414 'int %s(const wxString& text);',
417 int %s(const wxString& text) {
418 wxWX2MBbuf buf = (wxWX2MBbuf)wx2stc(text);
419 return SendMsg(%s, strlen(buf), (long)(const char*)buf);''',
424 # Remove all methods that are key commands since they can be
425 # executed with CmdKeyExecute
426 'LineDown' : (None, 0, 0, 0),
427 'LineDownExtend' : (None, 0, 0, 0),
428 'LineUp' : (None, 0, 0, 0),
429 'LineUpExtend' : (None, 0, 0, 0),
430 'CharLeft' : (None, 0, 0, 0),
431 'CharLeftExtend' : (None, 0, 0, 0),
432 'CharRight' : (None, 0, 0, 0),
433 'CharRightExtend' : (None, 0, 0, 0),
434 'WordLeft' : (None, 0, 0, 0),
435 'WordLeftExtend' : (None, 0, 0, 0),
436 'WordRight' : (None, 0, 0, 0),
437 'WordRightExtend' : (None, 0, 0, 0),
438 'Home' : (None, 0, 0, 0),
439 'HomeExtend' : (None, 0, 0, 0),
440 'LineEnd' : (None, 0, 0, 0),
441 'LineEndExtend' : (None, 0, 0, 0),
442 'DocumentStart' : (None, 0, 0, 0),
443 'DocumentStartExtend' : (None, 0, 0, 0),
444 'DocumentEnd' : (None, 0, 0, 0),
445 'DocumentEndExtend' : (None, 0, 0, 0),
446 'PageUp' : (None, 0, 0, 0),
447 'PageUpExtend' : (None, 0, 0, 0),
448 'PageDown' : (None, 0, 0, 0),
449 'PageDownExtend' : (None, 0, 0, 0),
450 'EditToggleOvertype' : (None, 0, 0, 0),
451 'Cancel' : (None, 0, 0, 0),
452 'DeleteBack' : (None, 0, 0, 0),
453 'Tab' : (None, 0, 0, 0),
454 'BackTab' : (None, 0, 0, 0),
455 'NewLine' : (None, 0, 0, 0),
456 'FormFeed' : (None, 0, 0, 0),
457 'VCHome' : (None, 0, 0, 0),
458 'VCHomeExtend' : (None, 0, 0, 0),
459 'ZoomIn' : (None, 0, 0, 0),
460 'ZoomOut' : (None, 0, 0, 0),
461 'DelWordLeft' : (None, 0, 0, 0),
462 'DelWordRight' : (None, 0, 0, 0),
463 'LineCut' : (None, 0, 0, 0),
464 'LineDelete' : (None, 0, 0, 0),
465 'LineTranspose' : (None, 0, 0, 0),
466 'LowerCase' : (None, 0, 0, 0),
467 'UpperCase' : (None, 0, 0, 0),
468 'LineScrollDown' : (None, 0, 0, 0),
469 'LineScrollUp' : (None, 0, 0, 0),
470 'DeleteBackNotLine' : (None, 0, 0, 0),
473 'GetDocPointer' : (0,
476 return (void*)SendMsg(%s);''',
479 'SetDocPointer' : (0,
480 'void %s(void* docPointer);',
481 '''void %s(void* docPointer) {
482 SendMsg(%s, 0, (long)docPointer);''',
485 'CreateDocument' : (0,
488 return (void*)SendMsg(%s);''',
491 'AddRefDocument' : (0,
492 'void %s(void* docPointer);',
493 '''void %s(void* docPointer) {
494 SendMsg(%s, 0, (long)docPointer);''',
497 'ReleaseDocument' : (0,
498 'void %s(void* docPointer);',
499 '''void %s(void* docPointer) {
500 SendMsg(%s, 0, (long)docPointer);''',
504 '''void %s(int codePage) {
506 wxASSERT_MSG(codePage == wxSTC_CP_UTF8,
507 wxT("Only wxSTC_CP_UTF8 may be used when wxUSE_UNICODE is on."));
509 wxASSERT_MSG(codePage != wxSTC_CP_UTF8,
510 wxT("wxSTC_CP_UTF8 may not be used when wxUSE_UNICODE is off."));
512 SendMsg(%s, codePage);''',
513 ("Set the code page used to interpret the bytes of the document as characters.",) ),
516 'GrabFocus' : (None, 0, 0, 0),
517 'SetFocus' : ('SetSTCFocus', 0, 0, 0),
518 'GetFocus' : ('GetSTCFocus', 0, 0, 0),
526 #----------------------------------------------------------------------------
528 def processIface(iface
, h_tmplt
, cpp_tmplt
, h_dest
, cpp_dest
):
534 fi
= FileInput(iface
)
537 if line
[:2] == '##' or line
== '':
542 if line
[:2] == '# ': # a doc string
543 curDocStrings
.append(line
[2:])
546 parseVal(line
[4:], values
, curDocStrings
)
549 elif op
== 'fun ' or op
== 'set ' or op
== 'get ':
550 parseFun(line
[4:], methods
, curDocStrings
, values
)
554 if string
.strip(line
[4:]) == 'Deprecated':
555 break # skip the rest of the file
567 print '***** Unknown line type: ', line
572 data
['VALUES'] = processVals(values
)
573 defs
, imps
= processMethods(methods
)
574 data
['METHOD_DEFS'] = defs
575 data
['METHOD_IMPS'] = imps
578 h_text
= open(h_tmplt
).read()
579 cpp_text
= open(cpp_tmplt
).read()
581 # do the substitutions
582 h_text
= h_text
% data
583 cpp_text
= cpp_text
% data
585 # write out destination files
586 open(h_dest
, 'w').write(h_text
)
587 open(cpp_dest
, 'w').write(cpp_text
)
591 #----------------------------------------------------------------------------
593 def processVals(values
):
595 for name
, value
, docs
in values
:
599 text
.append('// ' + x
)
600 text
.append('#define %s %s' % (name
, value
))
601 return string
.join(text
, '\n')
603 #----------------------------------------------------------------------------
605 def processMethods(methods
):
609 for retType
, name
, number
, param1
, param2
, docs
in methods
:
610 retType
= retTypeMap
.get(retType
, retType
)
611 params
= makeParamString(param1
, param2
)
613 name
, theDef
, theImp
, docs
= checkMethodOverride(name
, number
, docs
)
618 # Build the method definition for the .h file
622 defs
.append(' // ' + x
)
624 theDef
= ' %s %s(%s);' % (retType
, name
, params
)
627 # Build the method implementation string
631 imps
.append('// ' + x
)
633 theImp
= '%s wxStyledTextCtrl::%s(%s) {\n ' % (retType
, name
, params
)
635 if retType
== 'wxColour':
636 theImp
= theImp
+ 'long c = '
637 elif retType
!= 'void':
638 theImp
= theImp
+ 'return '
639 theImp
= theImp
+ 'SendMsg(%s, %s, %s)' % (number
,
640 makeArgString(param1
),
641 makeArgString(param2
))
642 if retType
== 'bool':
643 theImp
= theImp
+ ' != 0'
644 if retType
== 'wxColour':
645 theImp
= theImp
+ ';\n return wxColourFromLong(c)'
647 theImp
= theImp
+ ';\n}'
651 return string
.join(defs
, '\n'), string
.join(imps
, '\n')
654 #----------------------------------------------------------------------------
656 def checkMethodOverride(name
, number
, docs
):
657 theDef
= theImp
= None
658 if methodOverrideMap
.has_key(name
):
659 item
= methodOverrideMap
[name
]
665 theDef
= ' ' + (item
[1] % name
)
667 theImp
= item
[2] % ('wxStyledTextCtrl::'+name
, number
) + '\n}'
671 print "*************", name
674 return name
, theDef
, theImp
, docs
676 #----------------------------------------------------------------------------
678 def makeArgString(param
):
685 return '(long)(const char*)wx2stc(%s)' % name
687 return 'wxColourAsLong(%s)' % name
691 #----------------------------------------------------------------------------
693 def makeParamString(param1
, param2
):
696 aType
= paramTypeMap
.get(param
[0], param
[0])
697 return aType
+ ' ' + param
[1]
704 st
= st
+ doOne(param2
)
708 #----------------------------------------------------------------------------
710 def parseVal(line
, values
, docs
):
711 name
, val
= string
.split(line
, '=')
713 # remove prefixes such as SCI, etc.
714 for old
, new
in valPrefixes
:
719 name
= new
+ name
[lo
:]
722 values
.append( ('wxSTC_' + name
, val
, docs
) )
724 #----------------------------------------------------------------------------
726 funregex
= re
.compile(r
'\s*([a-zA-Z0-9_]+)' # <ws>return type
727 '\s+([a-zA-Z0-9_]+)=' # <ws>name=
729 '\(([ a-zA-Z0-9_]*),' # (param,
730 '([ a-zA-Z0-9_]*)\)') # param)
732 def parseFun(line
, methods
, docs
, values
):
733 def parseParam(param
):
734 param
= string
.strip(param
)
738 param
= tuple(string
.split(param
))
741 mo
= funregex
.match(line
)
743 print "***** Line doesn't match! : " + line
745 retType
, name
, number
, param1
, param2
= mo
.groups()
747 param1
= parseParam(param1
)
748 param2
= parseParam(param2
)
750 # Special case. For the key command functionss we want a value defined too
751 num
= string
.atoi(number
)
753 if (type(v
) == type(()) and v
[0] <= num
< v
[1]) or v
== num
:
754 parseVal('CMD_%s=%s' % (string
.upper(name
), number
), values
, docs
)
756 #if retType == 'void' and not param1 and not param2:
758 methods
.append( (retType
, name
, number
, param1
, param2
, tuple(docs
)) )
761 #----------------------------------------------------------------------------
765 # TODO: parse command line args to replace default input/output files???
768 processIface(IFACE
, H_TEMPLATE
, CPP_TEMPLATE
, H_DEST
, CPP_DEST
)
772 if __name__
== '__main__':
775 #----------------------------------------------------------------------------