wNim is Nim's Windows GUI Framework, based on winim. Layout DSL is powered by Yuriy Glukhov's Kiwi constraint solving library.
Basic code structure:
import wNim
let app = App()
let frame = Frame(title="Hello World", size=(400, 300))
frame.center()
frame.show()
app.mainLoop()
button.wEvent_Button do ():
frame.delete()
frame.wIdExit do ():
frame.delete()
frame.wEvent_Size do ():
layout()
panel.layout:
staticText:
top = panel.top + 10
left = panel.left + 10
button:
right + 10 = panel.right
bottom + 10 = panel.bottom
panel.autolayout """
V:|-[col1:[child1(child2)]-[child2]]-|
V:|-[col2:[child3(child4,child5)]-[child4]-[child5]]-|
H:|-[col1(col2)]-[col2]-|
"""
Getter and Setter:
let frame = Frame()
# wxWidgets/wxPython style
frame.setLabel("Hello World")
echo frame.getLabel()
# nim style
frame.label = "Hello World"
echo frame.label
With git on Windows:
nimble install wNim
Without git:
1. Download and unzip this module (by clicking the "Code" button).
2. Start a console and change the current dir to the folder with the "wNim.nimble" file.
(for example C:\wNim-master\wNim-master>)
3. Run "nimble install"
The easiest way to use wNim is to import the whole package.
import wNim
However, the modules of wNim can also be imported one by one to speed up compilation time.
import wNim/[wApp, wFrame]
There are some simple rules:
1. For every class in wNim, there is a corresponding module.
For example: wFrame, wIcon, wMenu, etc.
2. The wApp module must be imported into every wNim program.
3. Symbols in wColors and wKeyCodes modules are imported automatically with the wApp module.
4. All event classes in wNim share the same constructor: Event(), so all subclass modules
of wEvent will be automatically imported with the wEvent module.
5. wMacros, wUtils, and wTypes modules are three special modules in wNim.
See their documentation for more information.
To compile the examples, try the following command:
nim c -d:release -d:strip --opt:size --app:gui demo.nim
For Windows XP compatibility, add:
-d:useWinXP
To compile wNim with the Tiny C Compiler or to add resource files, take a look at https://github.com/khchen/winim/tree/master/tcclib
At first, I just wanted to write some code to test and prove my Winim library. I wrote some event handlers, some GUI control classes, and more. Finally, it became a whole GUI framework.
English is not my mother tongue. I often have no idea how to name an object or a function. So, I borrowed wxWidgets' names to develop my own framework.
I start from winim. It is just a Windows API module.
They are all good GUI libraries. I think wNim is easier to use and produces smaller .exe files. However, it only supports Windows.
Read license.txt for more details.
Copyright (c) Chen Kai-Hung, Ward. All rights reserved.
If this project help you reduce time to develop, you can give me a cup of coffee :)