-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathreadme_src.txt
159 lines (104 loc) · 6.53 KB
/
readme_src.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
wxShapeFramework for wxWidgets
------------------------------
Author: Michal Bliznak, 2007
e-mail: [email protected]
www: http://sourceforge.net/projects/wxsf
What wxShapeFramework is?
-------------------------
wxShapeFramework (wxSF) is a software library/framework based on wxWidgets which allows
easy development of software applications manipulating with
graphical objects (shapes) like various CASE tools, technological processes modeling
tools, etc.
The library consists of several classes encapsulating so called 'Shape canvas' (visual
GUI control used for management of included diagrams; it supports serialization/
deserialization to XML files, clipboard and drag&drop operations with diagram's
components, undo/redo operations, diagrams' export to BMP files, etc) and diagrams'
components as well (basic rectangular and eliptic shapes, line and curve shape,
polygonial shapes, static and in-place editable text, bitmap images, etc).
The shape framework (and shape canvas) allows to define relationship between various
shape types (for example which shape can be a child of another one, which shape types
can be connected together by which connection type, how do various connections look
like, etc) and provides ability to interactively design diagrams composited of those
shape objects.
More over, the library source code is based on wxWidgets GUI toolkit, so it is platform
independ (as far as the appropriate wxWidgets port is available for a required target
platform).
Requirements:
-------------
- wxSF uses wxWidgets (www.wxwidgets.org) and was tested with version 2.8.x on MS Windows
and Linux (Ubuntu 7.04) target platforms.
- Code::Blocks (www.codeblocks.org) IDE with MinGW C++ compiler or MS Visual Studio 2005/2008
Express are recommended for opening included workspace/project files but the library can be
built from the command line as well.
Distribution content:
---------------------
.\build - Premake build system for creation of various project/make files
.\doc - wxSF doxygen documentation file (in CHM and HTML format).
.\include - Library headers files (needed for both hosting applications and
library itself)
.\samples - Sample and demo projects with commented source code.
.\src - Source code ad project files of the wxSF library
changes.txt - Information about library version and release changes.
.\lib - Lib files (will be created after library/demo app build)
Build instructions:
===================
The library and included sample projects can be build with two different build systems included in
a release package. Both of them are located in the ./build subdirectory and you can freely choose which one to use.
Premake build system:
---------------------
Premake build scripts and executables are suitable for creation of various IDE project files and
GNU makefile as well. You can simply create Code::Blocks and MS VS 2005/2008 project files by invoking of
the included batch scripts.
Installation - win32:
When building on win32, go to the ./build subdirectory and simply type:
> create_build_files.bat
There are few standard build configurations defined in the batch file and you can freely modify it or you can
inkove the premake system directly as follows:
Examples of usage of the premake scripts:
For Code::Blocks Workspace/Project files producing shared library with UNICODE support, using wxWidgets DLLs type:
> premake\premake-win32.exe --target cb-gcc --unicode --with-wx-shared --shared
For MSVS 2005/2008 Workspace/Project files producing staticaly built library with UNICODE support and staticaly linked runtime
and no built-in wchar type:
> premake\premake-win32.exe --target vs2005 --unicode --static-runtime --no-builtin-wchar
For GNU makefile producing static library (static link of both wxWidgets libs and runtime) type:
> premake\premake-win32.exe --target gnu --unicode --static-runtime
Installation - Unix:
When building on Unix, go to the ./build subdirectory and simply type:
sh ./create_build_files.sh
or you can invoke the premake system as described in the Win32 installation section above.
Examples of usage of the premake scripts on Unix:
For Code::Blocks Workspace/Project files producing shared library with UNICODE support, using non-debug wxWidgets DLLs type:
premake/premake-linux --target cb-gcc --shared --with-wx-shared --unicode --disable-wx-debug
For Code::Blocks Workspace/Project files producing staticaly built library with debugging and UNICODE support and staticaly linked runtime
premake/premake-linux --target cb-gcc --unicode
For GNU makefile producing static library (static link of wxWidgets (with debugging support) libs and runtime) type:
premake/premake-linux --target gnu --unicode
Note that all needed executables and scripts are included in the release package so you can use the premake build system immediately.
Bakefile build system:
----------------------
Installation - win32:
When building on win32, you can use the makefiles generated by the bakefile build system located in the ./build
folder using the WX_DIR, WX_DEBUG, WX_UNICODE, WX_SHARED and WX_MONOLITHIC options to match your wxWidgets build or you
can re-create these makefiles by invoking
> bakefile_gen
command from within the ./build directory (in this case the bakefile build system must be installed on your system).
Examples of usage of the prebuild makefiles:
> nmake -f makefile.vc WX_DIR=c:\path\to\my\wxWidgets WX_UNICODE=0/1 WX_DEBUG=0/1 WX_SHARED=0/1 WX_MONOLITHIC=0/1
> make -f makefile.bcc WX_DIR=c:\path\to\my\wxWidgets WX_UNICODE=0/1 WX_DEBUG=0/1 WX_SHARED=0/1 WX_MONOLITHIC=0/1
> mingw32-make -f makefile.gcc WX_DIR=c:\path\to\my\wxWidgets WX_UNICODE=0/1 WX_DEBUG=0/1 WX_SHARED=0/1 WX_MONOLITHIC=0/1
Note that all supplied command line parameters are optional. If some of them are missing then the default values stored
in relevant makefile are used instead.
Installation - unix:
When building on a Linux/GNU-based system, go to the component installation folder and type:
./configure
make
make install
to build against the default build of wxWidgets (the one listed as 'default' by wx-config --list).
Type "./configure --help" for more info.
You can also clean all built/installed files by typing:
make clean
make uninstall
If you want to re-create the ./configure and Makefile scripts then you must have bakefile and autoconf
system installed on your system. If all the prerequisities are present, go to the ./build subdirectory and type:
bakefile_gen
./acregen.sh