-#!/bin/env python
+#!/usr/bin/env python
#----------------------------------------------------------------------------
# Name: gen_iface.py
# Purpose: Generate stc.h and stc.cpp from the info in Scintilla.iface
CPP_TEMPLATE = os.path.abspath('./stc.cpp.in')
H_DEST = os.path.abspath('../../include/wx/stc/stc.h')
CPP_DEST = os.path.abspath('./stc.cpp')
+DOCSTR_DEST = '/dev/null' #os.path.abspath('../../../wxPython/contrib/stc/_stc_gendocs.i')
# Value prefixes to convert
('SCWS_', 'WS_'),
]
-# Message function values that should have a CMD_ constant as well
-cmdValues = [ (2300, 2349),
- 2011,
+# Message function values that should have a CMD_ constant generated
+cmdValues = [ 2011,
2013,
(2176, 2180),
+ (2300, 2349),
(2390, 2393),
(2395, 2396),
2404,
(2413, 2416),
- (2450, 2454),
+ (2426, 2442),
+ (2450, 2455),
+ 2518,
]
+# Should a funciton be also generated for the CMDs?
+FUNC_FOR_CMD = True
+
+
# Map some generic typenames to wx types, using return value syntax
retTypeMap = {
'position': 'int',
'''void %s(const wxString& text) {
wxWX2MBbuf buf = (wxWX2MBbuf)wx2stc(text);
- SendMsg(%s, strlen(buf), (long)(const char*)buf);''',
+ SendMsg(%s, strlen(buf), (sptr_t)(const char*)buf);''',
0),
'AddStyledText' : (0,
'void %s(const wxMemoryBuffer& data);',
'''void %s(const wxMemoryBuffer& data) {
- SendMsg(%s, data.GetDataLen(), (long)data.GetData());''',
+ SendMsg(%s, data.GetDataLen(), (sptr_t)data.GetData());''',
0),
+ 'AppendText' : (0,
+ 'void %s(const wxString& text);',
+
+ '''void %s(const wxString& text) {
+ wxWX2MBbuf buf = (wxWX2MBbuf)wx2stc(text);
+ SendMsg(%s, strlen(buf), (sptr_t)(const char*)buf);''',
+ 0),
+
'GetViewWS' : ( 'GetViewWhiteSpace', 0, 0, 0),
'SetViewWS' : ( 'SetViewWhiteSpace', 0, 0, 0),
'GetCharAt' :
( 0, 0,
- '''int %s(int pos) {
+ '''int %s(int pos) const {
return (unsigned char)SendMsg(%s, pos, 0);''',
0),
'GetStyleAt' :
( 0, 0,
- '''int %s(int pos) {
+ '''int %s(int pos) const {
return (unsigned char)SendMsg(%s, pos, 0);''',
0),
tr.lpstrText = (char*)buf.GetWriteBuf(len*2+1);
tr.chrg.cpMin = startPos;
tr.chrg.cpMax = endPos;
- len = SendMsg(%s, 0, (long)&tr);
+ len = SendMsg(%s, 0, (sptr_t)&tr);
buf.UngetWriteBuf(len);
return buf;''',
'PositionFromPoint' :
(0,
- 'int %s(wxPoint pt);',
+ 'int %s(wxPoint pt) const;',
- '''int %s(wxPoint pt) {
+ '''int %s(wxPoint pt) const {
return SendMsg(%s, pt.x, pt.y);''',
0),
wxMemoryBuffer mbuf(len+1);
char* buf = (char*)mbuf.GetWriteBuf(len+1);
- int pos = SendMsg(%s, len+1, (long)buf);
+ int pos = SendMsg(%s, len+1, (sptr_t)buf);
mbuf.UngetWriteBuf(len);
mbuf.AppendByte(0);
if (linePos) *linePos = pos;
// convert bmp to a xpm in a string
wxMemoryOutputStream strm;
wxImage img = bmp.ConvertToImage();
+ if (img.HasAlpha())
+ img.ConvertAlphaToMask();
img.SaveFile(strm, wxBITMAP_TYPE_XPM);
size_t len = strm.GetSize();
char* buff = new char[len+1];
strm.CopyTo(buff, len);
buff[len] = 0;
- SendMsg(%s, markerNumber, (long)buff);
+ SendMsg(%s, markerNumber, (sptr_t)buff);
delete [] buff;
''',
('Define a marker from a bitmap',)),
'SetMarginSensitiveN' : ('SetMarginSensitive', 0, 0, 0),
'GetMarginSensitiveN' : ('GetMarginSensitive', 0, 0, 0),
+
+ 'StyleGetFore' : ('StyleGetForeground', 0, 0, 0),
+ 'StyleGetBack' : ('StyleGetBackground', 0, 0, 0),
'StyleSetFore' : ('StyleSetForeground', 0, 0, 0),
'StyleSetBack' : ('StyleSetBackground', 0, 0, 0),
'SetSelFore' : ('SetSelForeground', 0, 0, 0),
'SetSelBack' : ('SetSelBackground', 0, 0, 0),
'SetCaretFore' : ('SetCaretForeground', 0, 0, 0),
+ 'StyleGetFont' :
+ ('StyleGetFaceName',
+ 'wxString %s(int style);',
+ '''wxString %s(int style) {
+ long msg = %s;
+ long len = SendMsg(msg, style, 0);
+ wxMemoryBuffer mbuf(len+1);
+ char* buf = (char*)mbuf.GetWriteBuf(len+1);
+ SendMsg(msg, style, (sptr_t)buf);
+ mbuf.UngetWriteBuf(len);
+ mbuf.AppendByte(0);
+ return stc2wx(buf);''',
+ ('Get the font facename of a style',)),
'StyleSetFont' : ('StyleSetFaceName', 0, 0, 0),
+ 'StyleSetCharacterSet' : (None, 0, 0, 0),
'AssignCmdKey' :
('CmdKeyAssign',
'void %s(int length, char* styleBytes);',
'''void %s(int length, char* styleBytes) {
- SendMsg(%s, length, (long)styleBytes);''',
+ SendMsg(%s, length, (sptr_t)styleBytes);''',
0),
'IndicGetStyle' : ('IndicatorGetStyle', 0, 0, 0),
'IndicSetFore' : ('IndicatorSetForeground', 0, 0, 0),
'IndicGetFore' : ('IndicatorGetForeground', 0, 0, 0),
+ 'IndicSetUnder': ('IndicatorSetUnder', 0, 0, 0),
+ 'IndicGetUnder': ('IndicatorGetUnder', 0, 0, 0),
'SetWhitespaceFore' : ('SetWhitespaceForeground', 0, 0, 0),
'SetWhitespaceBack' : ('SetWhitespaceBackground', 0, 0, 0),
'AutoCGetDropRestOfWord' : ('AutoCompGetDropRestOfWord', 0,0,0),
'AutoCGetTypeSeparator' : ('AutoCompGetTypeSeparator', 0, 0, 0),
'AutoCSetTypeSeparator' : ('AutoCompSetTypeSeparator', 0, 0, 0),
+ 'AutoCGetCurrent' : ('AutoCompGetCurrent', 0, 0, 0),
+ 'AutoCSetMaxWidth' : ('AutoCompSetMaxWidth', 0, 0, 0),
+ 'AutoCGetMaxWidth' : ('AutoCompGetMaxWidth', 0, 0, 0),
+ 'AutoCSetMaxHeight' : ('AutoCompSetMaxHeight', 0, 0, 0),
+ 'AutoCGetMaxHeight' : ('AutoCompGetMaxHeight', 0, 0, 0),
+ 'AutoCGetMaxHeight' : ('AutoCompGetMaxHeight', 0, 0, 0),
'RegisterImage' :
(0,
// convert bmp to a xpm in a string
wxMemoryOutputStream strm;
wxImage img = bmp.ConvertToImage();
+ if (img.HasAlpha())
+ img.ConvertAlphaToMask();
img.SaveFile(strm, wxBITMAP_TYPE_XPM);
size_t len = strm.GetSize();
char* buff = new char[len+1];
strm.CopyTo(buff, len);
buff[len] = 0;
- SendMsg(%s, type, (long)buff);
+ SendMsg(%s, type, (sptr_t)buff);
delete [] buff;
''',
('Register an image for use in autocompletion lists.',)),
wxWX2MBbuf buf = (wxWX2MBbuf)wx2stc(text);
ft.lpstrText = (char*)(const char*)buf;
- return SendMsg(%s, flags, (long)&ft);''',
+ return SendMsg(%s, flags, (sptr_t)&ft);''',
0),
'FormatRange' :
int startPos,
int endPos,
wxDC* draw,
- wxDC* target, // Why does it use two? Can they be the same?
+ wxDC* target,
wxRect renderRect,
wxRect pageRect);''',
''' int %s(bool doDraw,
int startPos,
int endPos,
wxDC* draw,
- wxDC* target, // Why does it use two? Can they be the same?
+ wxDC* target,
wxRect renderRect,
wxRect pageRect) {
RangeToFormat fr;
fr.chrg.cpMin = startPos;
fr.chrg.cpMax = endPos;
- return SendMsg(%s, doDraw, (long)&fr);''',
+ return SendMsg(%s, doDraw, (sptr_t)&fr);''',
0),
'GetLine' :
(0,
- 'wxString %s(int line);',
+ 'wxString %s(int line) const;',
- '''wxString %s(int line) {
+ '''wxString %s(int line) const {
int len = LineLength(line);
if (!len) return wxEmptyString;
wxMemoryBuffer mbuf(len+1);
char* buf = (char*)mbuf.GetWriteBuf(len+1);
- SendMsg(%s, line, (long)buf);
+ SendMsg(%s, line, (sptr_t)buf);
mbuf.UngetWriteBuf(len);
mbuf.AppendByte(0);
return stc2wx(buf);''',
('Retrieve the contents of a line.',)),
- 'SetSel' : ('SetSelection', 0, 0, 0),
+ 'SetSel' : (None, 0,0,0), #'SetSelection', 0, 0, 0),
'GetSelText' :
('GetSelectedText',
'wxString %s();',
'''wxString %s() {
- int start;
- int end;
+ long start;
+ long end;
GetSelection(&start, &end);
int len = end - start;
if (!len) return wxEmptyString;
- wxMemoryBuffer mbuf(len+1);
+ wxMemoryBuffer mbuf(len+2);
char* buf = (char*)mbuf.GetWriteBuf(len+1);
- SendMsg(%s, 0, (long)buf);
+ SendMsg(%s, 0, (sptr_t)buf);
mbuf.UngetWriteBuf(len);
mbuf.AppendByte(0);
return stc2wx(buf);''',
tr.lpstrText = buf;
tr.chrg.cpMin = startPos;
tr.chrg.cpMax = endPos;
- SendMsg(%s, 0, (long)&tr);
+ SendMsg(%s, 0, (sptr_t)&tr);
mbuf.UngetWriteBuf(len);
mbuf.AppendByte(0);
return stc2wx(buf);''',
'GetText' :
(0,
- 'wxString %s();',
+ 'wxString %s() const;',
- '''wxString %s() {
+ '''wxString %s() const {
int len = GetTextLength();
wxMemoryBuffer mbuf(len+1); // leave room for the null...
char* buf = (char*)mbuf.GetWriteBuf(len+1);
- SendMsg(%s, len+1, (long)buf);
+ SendMsg(%s, len+1, (sptr_t)buf);
mbuf.UngetWriteBuf(len);
mbuf.AppendByte(0);
return stc2wx(buf);''',
'SetHotspotActiveFore' : ('SetHotspotActiveForeground', 0, 0, 0),
'SetHotspotActiveBack' : ('SetHotspotActiveBackground', 0, 0, 0),
+ 'GetHotspotActiveFore' : ('GetHotspotActiveForeground', 0, 0, 0),
+ 'GetHotspotActiveBack' : ('GetHotspotActiveBackground', 0, 0, 0),
+ 'GetCaretLineBack' : ('GetCaretLineBackground', 0, 0, 0),
+ 'SetCaretLineBack' : ('SetCaretLineBackground', 0, 0, 0),
'ReplaceTarget' :
(0,
'''
int %s(const wxString& text) {
wxWX2MBbuf buf = (wxWX2MBbuf)wx2stc(text);
- return SendMsg(%s, strlen(buf), (long)(const char*)buf);''',
+ return SendMsg(%s, strlen(buf), (sptr_t)(const char*)buf);''',
0),
'ReplaceTargetRE' :
'''
int %s(const wxString& text) {
wxWX2MBbuf buf = (wxWX2MBbuf)wx2stc(text);
- return SendMsg(%s, strlen(buf), (long)(const char*)buf);''',
+ return SendMsg(%s, strlen(buf), (sptr_t)(const char*)buf);''',
0),
'SearchInTarget' :
'''
int %s(const wxString& text) {
wxWX2MBbuf buf = (wxWX2MBbuf)wx2stc(text);
- return SendMsg(%s, strlen(buf), (long)(const char*)buf);''',
+ return SendMsg(%s, strlen(buf), (sptr_t)(const char*)buf);''',
0),
+ # not sure what to do about these yet
+ 'TargetAsUTF8' : ( None, 0, 0, 0),
+ 'SetLengthForEncode' : ( None, 0, 0, 0),
+ 'EncodedFromUTF8' : ( None, 0, 0, 0),
+
+
+ 'GetProperty' :
+ (0,
+ 'wxString %s(const wxString& key);',
+
+ '''wxString %s(const wxString& key) {
+ int len = SendMsg(SCI_GETPROPERTY, (sptr_t)(const char*)wx2stc(key), 0);
+ if (!len) return wxEmptyString;
+
+ wxMemoryBuffer mbuf(len+1);
+ char* buf = (char*)mbuf.GetWriteBuf(len+1);
+ SendMsg(%s, (uptr_t)(const char*)wx2stc(key), (sptr_t)buf);
+ mbuf.UngetWriteBuf(len);
+ mbuf.AppendByte(0);
+ return stc2wx(buf);''',
+ ("Retrieve a 'property' value previously set with SetProperty.",)),
+
+ 'GetPropertyExpanded' :
+ (0,
+ 'wxString %s(const wxString& key);',
+
+ '''wxString %s(const wxString& key) {
+ int len = SendMsg(SCI_GETPROPERTYEXPANDED, (uptr_t)(const char*)wx2stc(key), 0);
+ if (!len) return wxEmptyString;
+
+ wxMemoryBuffer mbuf(len+1);
+ char* buf = (char*)mbuf.GetWriteBuf(len+1);
+ SendMsg(%s, (uptr_t)(const char*)wx2stc(key), (sptr_t)buf);
+ mbuf.UngetWriteBuf(len);
+ mbuf.AppendByte(0);
+ return stc2wx(buf);''',
+ ("Retrieve a 'property' value previously set with SetProperty,",
+ "with '$()' variable replacement on returned buffer.")),
+
+ 'GetPropertyInt' : (0, 0, 0,
+ ("Retrieve a 'property' value previously set with SetProperty,",
+ "interpreted as an int AFTER any '$()' variable replacement.")),
+
'GetDocPointer' :
(0,
(0,
'void %s(void* docPointer);',
'''void %s(void* docPointer) {
- SendMsg(%s, 0, (long)docPointer);''',
+ SendMsg(%s, 0, (sptr_t)docPointer);''',
0),
'CreateDocument' :
(0,
'void %s(void* docPointer);',
'''void %s(void* docPointer) {
- SendMsg(%s, 0, (long)docPointer);''',
+ SendMsg(%s, 0, (sptr_t)docPointer);''',
0),
'ReleaseDocument' :
(0,
'void %s(void* docPointer);',
'''void %s(void* docPointer) {
- SendMsg(%s, 0, (long)docPointer);''',
+ SendMsg(%s, 0, (sptr_t)docPointer);''',
0),
'SetCodePage' :
'GrabFocus' : (None, 0, 0, 0),
+
+ # Rename some that would otherwise hide the wxWindow methods
'SetFocus' : ('SetSTCFocus', 0, 0, 0),
'GetFocus' : ('GetSTCFocus', 0, 0, 0),
-
+ 'SetCursor' : ('SetSTCCursor', 0, 0, 0),
+ 'GetCursor' : ('GetSTCCursor', 0, 0, 0),
'LoadLexerLibrary' : (None, 0,0,0),
-
-
- # Remove all methods that are key commands since they can be
- # executed with CmdKeyExecute
- 'LineDown' : (None, 0, 0, 0),
- 'LineDownExtend' : (None, 0, 0, 0),
- 'LineUp' : (None, 0, 0, 0),
- 'LineUpExtend' : (None, 0, 0, 0),
- 'CharLeft' : (None, 0, 0, 0),
- 'CharLeftExtend' : (None, 0, 0, 0),
- 'CharRight' : (None, 0, 0, 0),
- 'CharRightExtend' : (None, 0, 0, 0),
- 'WordLeft' : (None, 0, 0, 0),
- 'WordLeftExtend' : (None, 0, 0, 0),
- 'WordRight' : (None, 0, 0, 0),
- 'WordRightExtend' : (None, 0, 0, 0),
- 'Home' : (None, 0, 0, 0),
- 'HomeExtend' : (None, 0, 0, 0),
- 'LineEnd' : (None, 0, 0, 0),
- 'LineEndExtend' : (None, 0, 0, 0),
- 'DocumentStart' : (None, 0, 0, 0),
- 'DocumentStartExtend' : (None, 0, 0, 0),
- 'DocumentEnd' : (None, 0, 0, 0),
- 'DocumentEndExtend' : (None, 0, 0, 0),
- 'PageUp' : (None, 0, 0, 0),
- 'PageUpExtend' : (None, 0, 0, 0),
- 'PageDown' : (None, 0, 0, 0),
- 'PageDownExtend' : (None, 0, 0, 0),
- 'EditToggleOvertype' : (None, 0, 0, 0),
- 'Cancel' : (None, 0, 0, 0),
- 'DeleteBack' : (None, 0, 0, 0),
- 'Tab' : (None, 0, 0, 0),
- 'BackTab' : (None, 0, 0, 0),
- 'NewLine' : (None, 0, 0, 0),
- 'FormFeed' : (None, 0, 0, 0),
- 'VCHome' : (None, 0, 0, 0),
- 'VCHomeExtend' : (None, 0, 0, 0),
- 'ZoomIn' : (None, 0, 0, 0),
- 'ZoomOut' : (None, 0, 0, 0),
- 'DelWordLeft' : (None, 0, 0, 0),
- 'DelWordRight' : (None, 0, 0, 0),
- 'LineCut' : (None, 0, 0, 0),
- 'LineDelete' : (None, 0, 0, 0),
- 'LineTranspose' : (None, 0, 0, 0),
- 'LowerCase' : (None, 0, 0, 0),
- 'UpperCase' : (None, 0, 0, 0),
- 'LineScrollDown' : (None, 0, 0, 0),
- 'LineScrollUp' : (None, 0, 0, 0),
- 'DeleteBackNotLine' : (None, 0, 0, 0),
- 'HomeWrap' : (None, 0, 0, 0),
- 'HomeWrapExtend' : (None, 0, 0, 0),
- 'LineEndWrap' : (None, 0, 0, 0),
- 'LineEndWrapExtend' : (None, 0, 0, 0),
- 'VCHomeWrap' : (None, 0, 0, 0),
- 'VCHomeWrapExtend' : (None, 0, 0, 0),
- 'ParaDown' : (None, 0, 0, 0),
- 'ParaDownExtend' : (None, 0, 0, 0),
- 'ParaUp' : (None, 0, 0, 0),
- 'ParaUpExtend' : (None, 0, 0, 0),
-
+ 'SetPositionCache' : ('SetPositionCacheSize', 0, 0, 0),
+ 'GetPositionCache' : ('GetPositionCacheSize', 0, 0, 0),
'' : ('', 0, 0, 0),
}
+# all Scintilla getters are transformed into const member of wxSTC class but
+# some non-getter methods are also logically const and this set contains their
+# names (notice that it's useless to include here methods manually overridden
+# above)
+constNonGetterMethods = set((
+ 'LineFromPosition',
+ 'PositionFromLine',
+ 'LineLength',
+ 'CanPaste',
+ 'CanRedo',
+ 'CanUndo',
+))
+
#----------------------------------------------------------------------------
-def processIface(iface, h_tmplt, cpp_tmplt, h_dest, cpp_dest):
+def processIface(iface, h_tmplt, cpp_tmplt, h_dest, cpp_dest, docstr_dest):
curDocStrings = []
values = []
methods = []
curDocStrings = []
elif op == 'fun ' or op == 'set ' or op == 'get ':
- parseFun(line[4:], methods, curDocStrings, cmds)
+ parseFun(line[4:], methods, curDocStrings, cmds, op == 'get ')
curDocStrings = []
elif op == 'cat ':
data = {}
data['VALUES'] = processVals(values)
data['CMDS'] = processVals(cmds)
- defs, imps = processMethods(methods)
+ defs, imps, docstrings = processMethods(methods)
data['METHOD_DEFS'] = defs
data['METHOD_IMPS'] = imps
# write out destination files
open(h_dest, 'w').write(h_text)
open(cpp_dest, 'w').write(cpp_text)
+ open(docstr_dest, 'w').write(docstrings)
def processMethods(methods):
defs = []
imps = []
+ dstr = []
- for retType, name, number, param1, param2, docs in methods:
+ for retType, name, number, param1, param2, docs, is_const in methods:
retType = retTypeMap.get(retType, retType)
params = makeParamString(param1, param2)
if name is None:
continue
+ # Build docstrings
+ st = 'DocStr(wxStyledTextCtrl::%s,\n' \
+ '"%s", "");\n' % (name, '\n'.join(docs))
+ dstr.append(st)
+
# Build the method definition for the .h file
if docs:
defs.append('')
for x in docs:
defs.append(' // ' + x)
if not theDef:
- theDef = ' %s %s(%s);' % (retType, name, params)
+ theDef = ' %s %s(%s)' % (retType, name, params)
+ if is_const:
+ theDef = theDef + ' const'
+ theDef = theDef + ';'
defs.append(theDef)
# Build the method implementation string
for x in docs:
imps.append('// ' + x)
if not theImp:
- theImp = '%s wxStyledTextCtrl::%s(%s) {\n ' % (retType, name, params)
-
+ theImp = '%s wxStyledTextCtrl::%s(%s)' % (retType, name, params)
+ if is_const:
+ theImp = theImp + ' const'
+ theImp = theImp + '\n{\n '
if retType == 'wxColour':
theImp = theImp + 'long c = '
elif retType != 'void':
imps.append(theImp)
- return string.join(defs, '\n'), string.join(imps, '\n')
+ return '\n'.join(defs), '\n'.join(imps), '\n'.join(dstr)
#----------------------------------------------------------------------------
typ, name = param
if typ == 'string':
- return '(long)(const char*)wx2stc(%s)' % name
+ return '(sptr_t)(const char*)wx2stc(%s)' % name
if typ == 'colour':
return 'wxColourAsLong(%s)' % name
'\(([ a-zA-Z0-9_]*),' # (param,
'([ a-zA-Z0-9_]*)\)') # param)
-def parseFun(line, methods, docs, values):
+def parseFun(line, methods, docs, values, is_const):
def parseParam(param):
param = string.strip(param)
if param == '':
if (type(v) == type(()) and v[0] <= num <= v[1]) or v == num:
parseVal('CMD_%s=%s' % (string.upper(name), number), values, docs)
- #if retType == 'void' and not param1 and not param2:
+ # if we are not also doing a function for CMD values, then
+ # just return, otherwise fall through to the append blow.
+ if not FUNC_FOR_CMD:
+ return
- methods.append( (retType, name, number, param1, param2, tuple(docs)) )
+ methods.append( (retType, name, number, param1, param2, tuple(docs),
+ is_const or name in constNonGetterMethods) )
#----------------------------------------------------------------------------
def main(args):
# TODO: parse command line args to replace default input/output files???
+ if not os.path.exists(IFACE):
+ print 'Please run this script from src/stc subdirectory.'
+ sys.exit(1)
+
# Now just do it
- processIface(IFACE, H_TEMPLATE, CPP_TEMPLATE, H_DEST, CPP_DEST)
+ processIface(IFACE, H_TEMPLATE, CPP_TEMPLATE, H_DEST, CPP_DEST, DOCSTR_DEST)