libui 0.0.15 → 0.1.0.pre.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2fe04f1f03b5bc2cdc5596993230212f76b2582d05e943a1b0f67cfa8a26c1d5
-  data.tar.gz: 9fa47e55f1d5fd30191d7c48e546269fd72c727fea98850ab6a665beeeccd4ce
+  metadata.gz: 86351824e7a0d8285f2f853268a3085116c5499e0c0cbc68f567a18df02d6659
+  data.tar.gz: 3648436c3fa23817f2317cd70c55924931413bb16cc2a7e671004aceabddabfd
 SHA512:
-  metadata.gz: 31a67b3239d6f80f3be0693b9a06be1903cba54157a790d5a3a008dc282470e8e6037716e0c3428ff461ab6207d1b64f1ae59d2d33aa7cdd4348d4e831e56929
-  data.tar.gz: f2a9feac43d98eca7d952f2c6970ceb90ab32c778b497fa09396a5cde7739bf00330529f53aa8c4a4896b71eeffb0dea93f5c5849cd29a22291a1ca2fdd52c1f
+  metadata.gz: 29ca304955f3f8f36a74c3484e1220330fd562c128654626c680422fec6d715102d0135f2eedbb95200febcf0e3e0fe6087acd9be9b81bc6766f0a06c18d339e
+  data.tar.gz: 4f449bc98a90c9bb0ea42ccc1973fe9b53112f8ffe4b2e5bc7b89b6f52ccad5d6aa7341d78c053a28138b39af0fe5aae04ca6d5a01ce539ee74980dce6318f88

data/README.md

@@ -4,7 +4,11 @@
 [![Gem Version](https://badge.fury.io/rb/libui.svg)](https://badge.fury.io/rb/libui)
 <a href="https://github.com/AndyObtiva/glimmer-dsl-libui"><img alt="glimmer-dsl-libui" src="https://github.com/AndyObtiva/glimmer/blob/master/images/glimmer-logo-hi-res.svg" width="50" height="50" align="right"></a>
 
-:radio_button: [libui](https://github.com/libui-ng/libui-ng) - a portable GUI library - for Ruby
+LibUI is a Ruby wrapper for libui and libui-ng.
+
+:rocket: [libui-ng](https://github.com/libui-ng/libui-ng) - A cross-platform portable GUI library
+
+:radio_button: [libui](https://github.com/andlabs/libui) - Original version by andlabs
 
 ## Installation
 
@@ -24,6 +28,7 @@ gem install libui
 Note:
 * If you are using the 32-bit (x86) version of Ruby, you need to download the 32-bit (x86) native dll. See [Development](#development).
 * On Windows, libui may not work due to missing DLLs. In that case, you need to install [Visual C++ Redistributable](https://docs.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist). See ([#48](https://github.com/kojix2/LibUI/issues/48))
+* [Raspberry Pi](https://www.raspberrypi.com/) and other platform users will need to compile C libui. See [Development](#development).
 
 ## Usage
 
@@ -72,8 +77,9 @@ You can use [the documentation for libui's Go bindings](https://pkg.go.dev/githu
 
 ### DSLs for LibUI
 
-LibUI is not object-oriented, but provides high portability with minimal implementation.
-If you want to write in an object-oriented way, please use the following DSLs built on top of LibUI.
+LibUI is intentionally not object-oriented because it is a thin Ruby wrapper (binding) for the procedural C libui library, so it mirrors its API structure.
+
+It is recommended that you build actual applications using a DSL for LibUI because DSLs enable writing object-oriented code the Ruby way (instead of procedural code the C way):
 
 * [Glimmer DSL for LibUI](https://github.com/AndyObtiva/glimmer-dsl-libui)
 * [libui_paradise](https://rubygems.org/gems/libui_paradise)
@@ -156,6 +162,8 @@ Add additional options below if necessary.
 
 ## Development
 
+LibUI is not object-oriented, but it provides high portability with a minimal implementation. 
+
 ```sh
 git clone https://github.com/kojix2/libui
 cd libui
@@ -180,7 +188,27 @@ rake vendor:windows_x86  # Download libui.dll for Windows to vendor directory
 
 For example, If you are using a 32-bit (x86) version of Ruby on Windows, type `rake vendor:windows_x86`.
 
-Or Set environment variable `LIBUIDIR` to specify the path to the shared library.
+### Use C libui compiled from source code
+
+You can compile C libui from source code on your platform and tell ruby LibUI where to find the shared libraries. Set environment variable `LIBUIDIR` to specify the path to the shared library. (See [#46](https://github.com/kojix2/LibUI/issues/46#issuecomment-1041575792)). This is especially useful on platforms where the LibUI gem does not provide shared library, such as the ARM architecture (used in devices like Raspberry Pi).
+
+Another simple approach is to replace the shared libraries in the gem vendor directory with the ones you have compiled.
+
+### libui-ng
+
+Version 0.0.X only supports libui. From version 0.1.X, we plan to support only libui-ng.
+
+[libui-ng](https://github.com/libui-ng/libui-ng) is the successor project to libui. Rake tasks are available to build or download libui-ng shared libraries.
+
+```
+rake libui-ng:build[hash]  # Build libui-ng latest master [commit hash]
+rake libui-ng:mac          # Download latest dev build for Mac to vendor directory
+rake libui-ng:ubuntu_x64   # Download latest dev build for Ubuntu to vendor directory
+```
+
+```
+rake install
+```
 
 ## Contributing
 

data/lib/libui/ffi.rb

@@ -65,23 +65,23 @@ module LibUI
       'void (*Disable)(uiControl *)'
     ]
 
-    try_extern 'void uiControlDestroy(uiControl *)'
-    try_extern 'uintptr_t uiControlHandle(uiControl *)'
-    try_extern 'uiControl *uiControlParent(uiControl *)'
-    try_extern 'void uiControlSetParent(uiControl *, uiControl *)'
-    try_extern 'int uiControlToplevel(uiControl *)'
-    try_extern 'int uiControlVisible(uiControl *)'
-    try_extern 'void uiControlShow(uiControl *)'
-    try_extern 'void uiControlHide(uiControl *)'
-    try_extern 'int uiControlEnabled(uiControl *)'
-    try_extern 'void uiControlEnable(uiControl *)'
-    try_extern 'void uiControlDisable(uiControl *)'
+    try_extern 'void uiControlDestroy(uiControl *c)'
+    try_extern 'uintptr_t uiControlHandle(uiControl *c)'
+    try_extern 'uiControl *uiControlParent(uiControl *c)'
+    try_extern 'void uiControlSetParent(uiControl *c, uiControl *parent)'
+    try_extern 'int uiControlToplevel(uiControl *c)'
+    try_extern 'int uiControlVisible(uiControl *c)'
+    try_extern 'void uiControlShow(uiControl *c)'
+    try_extern 'void uiControlHide(uiControl *c)'
+    try_extern 'int uiControlEnabled(uiControl *c)'
+    try_extern 'void uiControlEnable(uiControl *c)'
+    try_extern 'void uiControlDisable(uiControl *c)'
 
     try_extern 'uiControl *uiAllocControl(size_t n, uint32_t OSsig, uint32_t typesig, const char *typenamestr)'
-    try_extern 'void uiFreeControl(uiControl *)'
+    try_extern 'void uiFreeControl(uiControl *c)'
 
-    try_extern 'void uiControlVerifySetParent(uiControl *, uiControl *)'
-    try_extern 'int uiControlEnabledToUser(uiControl *)'
+    try_extern 'void uiControlVerifySetParent(uiControl *c, uiControl *parent)'
+    try_extern 'int uiControlEnabledToUser(uiControl *c)'
 
     try_extern 'void uiUserBugCannotSetParentOnToplevel(const char *type)'
 
@@ -93,25 +93,30 @@ module LibUI
     try_extern 'void uiWindowSetContentSize(uiWindow *w, int width, int height)'
     try_extern 'int uiWindowFullscreen(uiWindow *w)'
     try_extern 'void uiWindowSetFullscreen(uiWindow *w, int fullscreen)'
-    try_extern 'void uiWindowOnContentSizeChanged(uiWindow *w, void (*f)(uiWindow *, void *), void *data)'
-    try_extern 'void uiWindowOnClosing(uiWindow *w, int (*f)(uiWindow *w, void *data), void *data)'
+    try_extern 'void uiWindowOnContentSizeChanged(uiWindow *w, void (*f)(uiWindow *sender, void *senderData), void *data)'
+    try_extern 'void uiWindowOnClosing(uiWindow *w, int (*f)(uiWindow *sender, void *senderData), void *data)'
+    try_extern 'void uiWindowOnFocusChanged(uiWindow *w, void (*f)(uiWindow *sender, void *senderData), void *data)'
+    try_extern 'int uiWindowFocused(uiWindow *w)'
     try_extern 'int uiWindowBorderless(uiWindow *w)'
     try_extern 'void uiWindowSetBorderless(uiWindow *w, int borderless)'
     try_extern 'void uiWindowSetChild(uiWindow *w, uiControl *child)'
     try_extern 'int uiWindowMargined(uiWindow *w)'
     try_extern 'void uiWindowSetMargined(uiWindow *w, int margined)'
+    try_extern 'int uiWindowResizeable(uiWindow *w)'
+    try_extern 'void uiWindowSetResizeable(uiWindow *w, int resizeable)'
     try_extern 'uiWindow *uiNewWindow(const char *title, int width, int height, int hasMenubar)'
 
     # uiButton
 
     try_extern 'char *uiButtonText(uiButton *b)'
     try_extern 'void uiButtonSetText(uiButton *b, const char *text)'
-    try_extern 'void uiButtonOnClicked(uiButton *b, void (*f)(uiButton *b, void *data), void *data)'
+    try_extern 'void uiButtonOnClicked(uiButton *b, void (*f)(uiButton *sender, void *senderData), void *data)'
     try_extern 'uiButton *uiNewButton(const char *text)'
 
     # uiBox
 
     try_extern 'void uiBoxAppend(uiBox *b, uiControl *child, int stretchy)'
+    try_extern 'int uiBoxNumChildren(uiBox *b)'
     try_extern 'void uiBoxDelete(uiBox *b, int index)'
     try_extern 'int uiBoxPadded(uiBox *b)'
     try_extern 'void uiBoxSetPadded(uiBox *b, int padded)'
@@ -122,7 +127,7 @@ module LibUI
 
     try_extern 'char *uiCheckboxText(uiCheckbox *c)'
     try_extern 'void uiCheckboxSetText(uiCheckbox *c, const char *text)'
-    try_extern 'void uiCheckboxOnToggled(uiCheckbox *c, void (*f)(uiCheckbox *c, void *data), void *data)'
+    try_extern 'void uiCheckboxOnToggled(uiCheckbox *c, void (*f)(uiCheckbox *sender, void *senderData), void *data)'
     try_extern 'int uiCheckboxChecked(uiCheckbox *c)'
     try_extern 'void uiCheckboxSetChecked(uiCheckbox *c, int checked)'
     try_extern 'uiCheckbox *uiNewCheckbox(const char *text)'
@@ -131,7 +136,7 @@ module LibUI
 
     try_extern 'char *uiEntryText(uiEntry *e)'
     try_extern 'void uiEntrySetText(uiEntry *e, const char *text)'
-    try_extern 'void uiEntryOnChanged(uiEntry *e, void (*f)(uiEntry *e, void *data), void *data)'
+    try_extern 'void uiEntryOnChanged(uiEntry *e, void (*f)(uiEntry *sender, void *senderData), void *data)'
     try_extern 'int uiEntryReadOnly(uiEntry *e)'
     try_extern 'void uiEntrySetReadOnly(uiEntry *e, int readonly)'
     try_extern 'uiEntry *uiNewEntry(void)'
@@ -147,11 +152,11 @@ module LibUI
     # uiTab
 
     try_extern 'void uiTabAppend(uiTab *t, const char *name, uiControl *c)'
-    try_extern 'void uiTabInsertAt(uiTab *t, const char *name, int before, uiControl *c)'
+    try_extern 'void uiTabInsertAt(uiTab *t, const char *name, int index, uiControl *c)'
     try_extern 'void uiTabDelete(uiTab *t, int index)'
     try_extern 'int uiTabNumPages(uiTab *t)'
-    try_extern 'int uiTabMargined(uiTab *t, int page)'
-    try_extern 'void uiTabSetMargined(uiTab *t, int page, int margined)'
+    try_extern 'int uiTabMargined(uiTab *t, int index)'
+    try_extern 'void uiTabSetMargined(uiTab *t, int index, int margined)'
     try_extern 'uiTab *uiNewTab(void)'
 
     # uiGroup
@@ -167,14 +172,18 @@ module LibUI
 
     try_extern 'int uiSpinboxValue(uiSpinbox *s)'
     try_extern 'void uiSpinboxSetValue(uiSpinbox *s, int value)'
-    try_extern 'void uiSpinboxOnChanged(uiSpinbox *s, void (*f)(uiSpinbox *s, void *data), void *data)'
+    try_extern 'void uiSpinboxOnChanged(uiSpinbox *s, void (*f)(uiSpinbox *sender, void *senderData), void *data)'
     try_extern 'uiSpinbox *uiNewSpinbox(int min, int max)'
 
     # uiSlider
 
     try_extern 'int uiSliderValue(uiSlider *s)'
     try_extern 'void uiSliderSetValue(uiSlider *s, int value)'
-    try_extern 'void uiSliderOnChanged(uiSlider *s, void (*f)(uiSlider *s, void *data), void *data)'
+    try_extern 'int uiSliderHasToolTip(uiSlider *s)'
+    try_extern 'void uiSliderSetHasToolTip(uiSlider *s, int hasToolTip)'
+    try_extern 'void uiSliderOnChanged(uiSlider *s, void (*f)(uiSlider *sender, void *senderData), void *data)'
+    try_extern 'void uiSliderOnReleased(uiSlider *s, void (*f)(uiSlider *sender, void *senderData), void *data)'
+    try_extern 'void uiSliderSetRange(uiSlider *s, int min, int max)'
     try_extern 'uiSlider *uiNewSlider(int min, int max)'
 
     # uiProgressBar
@@ -191,9 +200,13 @@ module LibUI
     # uiCombobox
 
     try_extern 'void uiComboboxAppend(uiCombobox *c, const char *text)'
+    try_extern 'void uiComboboxInsertAt(uiCombobox *c, int index, const char *text)'
+    try_extern 'void uiComboboxDelete(uiCombobox *c, int index)'
+    try_extern 'void uiComboboxClear(uiCombobox *c)'
+    try_extern 'int uiComboboxNumItems(uiCombobox *c)'
     try_extern 'int uiComboboxSelected(uiCombobox *c)'
-    try_extern 'void uiComboboxSetSelected(uiCombobox *c, int n)'
-    try_extern 'void uiComboboxOnSelected(uiCombobox *c, void (*f)(uiCombobox *c, void *data), void *data)'
+    try_extern 'void uiComboboxSetSelected(uiCombobox *c, int index)'
+    try_extern 'void uiComboboxOnSelected(uiCombobox *c, void (*f)(uiCombobox *sender, void *senderData), void *data)'
     try_extern 'uiCombobox *uiNewCombobox(void)'
 
     # uiEditableCombobox
@@ -201,15 +214,15 @@ module LibUI
     try_extern 'void uiEditableComboboxAppend(uiEditableCombobox *c, const char *text)'
     try_extern 'char *uiEditableComboboxText(uiEditableCombobox *c)'
     try_extern 'void uiEditableComboboxSetText(uiEditableCombobox *c, const char *text)'
-    try_extern 'void uiEditableComboboxOnChanged(uiEditableCombobox *c, void (*f)(uiEditableCombobox *c, void *data), void *data)'
+    try_extern 'void uiEditableComboboxOnChanged(uiEditableCombobox *c, void (*f)(uiEditableCombobox *sender, void *senderData), void *data)'
     try_extern 'uiEditableCombobox *uiNewEditableCombobox(void)'
 
     # uiRadioButtons
 
     try_extern 'void uiRadioButtonsAppend(uiRadioButtons *r, const char *text)'
     try_extern 'int uiRadioButtonsSelected(uiRadioButtons *r)'
-    try_extern 'void uiRadioButtonsSetSelected(uiRadioButtons *r, int n)'
-    try_extern 'void uiRadioButtonsOnSelected(uiRadioButtons *r, void (*f)(uiRadioButtons *, void *), void *data)'
+    try_extern 'void uiRadioButtonsSetSelected(uiRadioButtons *r, int index)'
+    try_extern 'void uiRadioButtonsOnSelected(uiRadioButtons *r, void (*f)(uiRadioButtons *sender, void *senderData), void *data)'
     try_extern 'uiRadioButtons *uiNewRadioButtons(void)'
 
     # uiDateTimePicker
@@ -245,7 +258,7 @@ module LibUI
 
     try_extern 'void uiDateTimePickerTime(uiDateTimePicker *d, struct tm *time)'
     try_extern 'void uiDateTimePickerSetTime(uiDateTimePicker *d, const struct tm *time)'
-    try_extern 'void uiDateTimePickerOnChanged(uiDateTimePicker *d, void (*f)(uiDateTimePicker *, void *), void *data)'
+    try_extern 'void uiDateTimePickerOnChanged(uiDateTimePicker *d, void (*f)(uiDateTimePicker *sender, void *senderData), void *data)'
     try_extern 'uiDateTimePicker *uiNewDateTimePicker(void)'
     try_extern 'uiDateTimePicker *uiNewDatePicker(void)'
     try_extern 'uiDateTimePicker *uiNewTimePicker(void)'
@@ -255,7 +268,7 @@ module LibUI
     try_extern 'char *uiMultilineEntryText(uiMultilineEntry *e)'
     try_extern 'void uiMultilineEntrySetText(uiMultilineEntry *e, const char *text)'
     try_extern 'void uiMultilineEntryAppend(uiMultilineEntry *e, const char *text)'
-    try_extern 'void uiMultilineEntryOnChanged(uiMultilineEntry *e, void (*f)(uiMultilineEntry *e, void *data), void *data)'
+    try_extern 'void uiMultilineEntryOnChanged(uiMultilineEntry *e, void (*f)(uiMultilineEntry *sender, void *senderData), void *data)'
     try_extern 'int uiMultilineEntryReadOnly(uiMultilineEntry *e)'
     try_extern 'void uiMultilineEntrySetReadOnly(uiMultilineEntry *e, int readonly)'
     try_extern 'uiMultilineEntry *uiNewMultilineEntry(void)'
@@ -265,7 +278,7 @@ module LibUI
 
     try_extern 'void uiMenuItemEnable(uiMenuItem *m)'
     try_extern 'void uiMenuItemDisable(uiMenuItem *m)'
-    try_extern 'void uiMenuItemOnClicked(uiMenuItem *m, void (*f)(uiMenuItem *sender, uiWindow *window, void *data), void *data)'
+    try_extern 'void uiMenuItemOnClicked(uiMenuItem *m, void (*f)(uiMenuItem *sender, uiWindow *window, void *senderData), void *data)'
     try_extern 'int uiMenuItemChecked(uiMenuItem *m)'
     try_extern 'void uiMenuItemSetChecked(uiMenuItem *m, int checked)'
 
@@ -280,6 +293,7 @@ module LibUI
     try_extern 'uiMenu *uiNewMenu(const char *name)'
 
     try_extern 'char *uiOpenFile(uiWindow *parent)'
+    try_extern 'char *uiOpenFolder(uiWindow *parent)'
     try_extern 'char *uiSaveFile(uiWindow *parent)'
     try_extern 'void uiMsgBox(uiWindow *parent, const char *title, const char *description)'
     try_extern 'void uiMsgBoxError(uiWindow *parent, const char *title, const char *description)'
@@ -370,6 +384,7 @@ module LibUI
     try_extern 'void uiDrawPathBezierTo(uiDrawPath *p, double c1x, double c1y, double c2x, double c2y, double endX, double endY)'
     try_extern 'void uiDrawPathCloseFigure(uiDrawPath *p)'
     try_extern 'void uiDrawPathAddRectangle(uiDrawPath *p, double x, double y, double width, double height)'
+    try_extern 'int uiDrawPathEnded(uiDrawPath *p)'
     try_extern 'void uiDrawPathEnd(uiDrawPath *p)'
     try_extern 'void uiDrawStroke(uiDrawContext *c, uiDrawPath *path, uiDrawBrush *b, uiDrawStrokeParams *p)'
     try_extern 'void uiDrawFill(uiDrawContext *c, uiDrawPath *path, uiDrawBrush *b)'
@@ -471,6 +486,9 @@ module LibUI
       'uiTextStretch Stretch'
     ]
 
+    try_extern 'void uiLoadControlFont(uiFontDescriptor *f)'
+    try_extern 'void uiFreeFontDescriptor(uiFontDescriptor *desc)'
+
     typealias 'uiDrawTextAlign', 'int'
 
     DrawTextLayoutParams = struct [
@@ -488,7 +506,7 @@ module LibUI
     # uiFontButton
 
     try_extern 'void uiFontButtonFont(uiFontButton *b, uiFontDescriptor *desc)'
-    try_extern 'void uiFontButtonOnChanged(uiFontButton *b, void (*f)(uiFontButton *, void *), void *data)'
+    try_extern 'void uiFontButtonOnChanged(uiFontButton *b, void (*f)(uiFontButton *sender, void *senderData), void *data)'
     try_extern 'uiFontButton *uiNewFontButton(void)'
     try_extern 'void uiFreeFontButtonFont(uiFontDescriptor *desc)'
 
@@ -520,12 +538,13 @@ module LibUI
 
     try_extern 'void uiColorButtonColor(uiColorButton *b, double *r, double *g, double *bl, double *a)'
     try_extern 'void uiColorButtonSetColor(uiColorButton *b, double r, double g, double bl, double a)'
-    try_extern 'void uiColorButtonOnChanged(uiColorButton *b, void (*f)(uiColorButton *, void *), void *data)'
+    try_extern 'void uiColorButtonOnChanged(uiColorButton *b, void (*f)(uiColorButton *sender, void *senderData), void *data)'
     try_extern 'uiColorButton *uiNewColorButton(void)'
 
     # uiForm
 
     try_extern 'void uiFormAppend(uiForm *f, const char *label, uiControl *c, int stretchy)'
+    try_extern 'int uiFormNumChildren(uiForm *f)'
     try_extern 'void uiFormDelete(uiForm *f, int index)'
     try_extern 'int uiFormPadded(uiForm *f)'
     try_extern 'void uiFormSetPadded(uiForm *f, int padded)'
@@ -594,6 +613,16 @@ module LibUI
     try_extern 'void uiTableAppendCheckboxTextColumn(uiTable *t, const char *name, int checkboxModelColumn, int checkboxEditableModelColumn, int textModelColumn, int textEditableModelColumn, uiTableTextColumnOptionalParams *textParams)'
     try_extern 'void uiTableAppendProgressBarColumn(uiTable *t, const char *name, int progressModelColumn)'
     try_extern 'void uiTableAppendButtonColumn(uiTable *t, const char *name, int buttonModelColumn, int buttonClickableModelColumn)'
+    try_extern 'int uiTableHeaderVisible(uiTable *t)'
+    try_extern 'void uiTableHeaderSetVisible(uiTable *t, int visible)'
     try_extern 'uiTable *uiNewTable(uiTableParams *params)'
+
+    typealias 'uiSortIndicator', 'int'
+
+    try_extern 'void uiTableHeaderSetSortIndicator(uiTable *t, int column, uiSortIndicator indicator)'
+    try_extern 'uiSortIndicator uiTableHeaderSortIndicator(uiTable *t, int column)'
+    try_extern 'void uiTableHeaderOnClicked(uiTable *t, void (*f)(uiTable *sender, int column, void *senderData), void *data)'
+    try_extern 'int uiTableColumnWidth(uiTable *t, int column)'
+    try_extern 'void uiTableColumnSetWidth(uiTable *t, int column, int width)'
   end
 end

data/lib/libui/version.rb

@@ -1,3 +1,3 @@
 module LibUI
-  VERSION = '0.0.15'
+  VERSION = '0.1.0.pre.0'
 end

data/lib/libui.rb

@@ -215,6 +215,11 @@ module LibUI
   TableValueTypeInt    = 2
   TableValueTypeColor  = 3
 
+  # SortIndicator
+  SortIndicatorNone       = 0
+  SortIndicatorAscending  = 1
+  SortIndicatorDescending = 2
+
   # editable
   TableModelColumnNeverEditable  = -1
   TableModelColumnAlwaysEditable = -2

data/vendor/{LICENSE → LICENSE.md}

@@ -1,3 +1,5 @@
+Copyright (c) 2022 libui-ng authors
+
 Copyright (c) 2014 Pietro Gagliardi
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
@@ -6,4 +8,3 @@ The above copyright notice and this permission notice shall be included in all c
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
-(this is called the MIT License or Expat License; see http://www.opensource.org/licenses/MIT)

data/vendor/README.md

@@ -1,81 +1,21 @@
-# libui: a portable GUI library for C
+# libui-ng: a portable GUI library for C
 
-This README is being written.<br>
-[![Build Status, Azure Pipelines](https://dev.azure.com/andlabs/libui/_apis/build/status/andlabs.libui?branchName=master)](https://dev.azure.com/andlabs/libui/_build/latest?definitionId=1&branchName=master)<br>
-[![Build Status, AppVeyor](https://ci.appveyor.com/api/projects/status/ouyk78c52mmisa31/branch/master?svg=true)](https://ci.appveyor.com/project/andlabs/libui/branch/master)
+Fork of [andlabs/libui](https://github.com/andlabs/libui). This README is being written.<br>
+[![Build Status, GitHub Actions](https://github.com/libui-ng/libui-ng/actions/workflows/build.yml/badge.svg)](https://github.com/libui-ng/libui-ng/actions/workflows/build.yml)
+[![GitLab](https://img.shields.io/badge/gitlab-%23181717.svg?style=for-the-badge&logo=gitlab&logoColor=white)](https://gitlab.com/libui-ng/libui-ng)
+[![GitHub](https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge&logo=github&logoColor=white)](https://github.com/libui-ng/libui-ng)
 
-## Status
-
-It has come to my attention that I have not been particularly clear about how usable or feature-complete libui is, and that this has fooled many people into expecting more from libui right this moment than I have explicitly promised to make available. I apologize for not doing this sooner.
-
-libui is currently **mid-alpha** software. Much of what is currently present runs stabily enough for the examples and perhaps some small programs to work, but the stability is still a work-in-progress, much of what is already there is not feature-complete, some of it will be buggy on certain platforms, and there's a lot of stuff missing. In short, here's a list of features that I would like to add to libui, but that aren't in yet:
-
-- trees
-- clipboard support, including drag and drop
-- more and better dialogs
-- printing
-- accessibility for uiArea and custom controls
-- document-based programs
-- tighter OS integration (especially for document-based programs), to allow programs to fully feel native, rather than merely look and act native
-- better support for standard dialogs and features (search bars, etc.)
-- OpenGL support
-
-In addition, [here](https://github.com/andlabs/libui/issues?utf8=%E2%9C%93&q=master+in%3Atitle+is%3Aissue+is%3Aopen) is a list of issues generalizing existing problems.
-
-Furthermore, libui is not properly fully documented yet. This is mainly due to the fact that the API was initially unstable enough so as to result in rewriting documentation multiple times, in addition to me not being happy with really any existing C code documentation tool. That being said, I have started to pin down my ideal code documentation style in parts of `ui.h`, most notably in the uiAttributedString APIs. Over time, I plan on extending this to the rest of the headers. You can also use [the documentation for libui's Go bindings](https://godoc.org/github.com/andlabs/ui) as a reference, though it is somewhat stale and not optimally written.
-
-But libui is not dead; I am working on it whenever I can, and I hope to get it to a point of real quality soon!
-
-## News
-
-*Note that today's entry (Eastern Time) may be updated later today.*
-
-* **7 April 2019**
-	* **The build system has been switched to Meson.** See below for instructions. This change was made because the previous build system, CMake, caused countless headaches over trivial issues. Meson was chosen due to how unproblematic setting up libui's build just right was, as well as having design goals that are by coincidence closely aligned with what libui wants.
-	* Travis CI has been replaced with Azure Pipelines and much of the AppVeyor CI configuration was integrated into the Azure Pipelines configuration. This shouldn't affect most developers.
+## About
 
-* **1 September 2018**
-	* **Alpha 4.1 is here.** This is an emergency fix to Alpha 4 to fix `uiImageAppend()` not working as documented. It now works properly, with one important difference you'll need to care about: **it now requires image data to be alpha-premultiplied**. In addition, `uiImage` also is implemented slightly more nicely now, and `ui.h` has minor documentation typo fixes.
-	* Alpha 4.1 also tries to make everything properly PIC-enabled.
+Simple and portable (but not inflexible) GUI library in C that uses the native GUI technologies of each platform it supports.
 
-* **10 August 2018**
-	* **Alpha 4 is finally here.** Everything from Alpha 3.5 and what's listed below is in this release; the two biggest changes are still the new text drawing API and new uiTable control. In between all that is a whole bunch of bugfixes, and hopefully more stability too. Thanks to everybody who helped contribute!
-	* Alpha 4 should hopefully also include automated binary releases via CI. Thanks to those who helped set that up!
-
-* **8 August 2018**
-	* Finally introduced an API for loading images, `uiImage`, and a new control, `uiTable`, for displaying tabular data. These provide enough basic functionality for now, but will be improved over time. You can read the documentation for the new features as they are [here](https://github.com/andlabs/libui/blob/f47e1423cf95ad7b1001663f3381b5a819fc67b9/uitable.h). Thanks to everyone who helped get to this point, in particular @bcampbell for the initial Windows code, and to everyone else for their patience!
-
-* **30 May 2018**
-	* Merged the previous Announcements and Updates section of this README into a single News section, and merged the respective archive files into a single NEWS.md file.
-
-* **16 May 2018**
-	* Thanks to @parro-it and @msink, libui now has better CI, including AppVeyor for Windows CI, and automated creation of binary releases when I make a tagged release.
-
-* **13 May 2018**
-	* Added new functions to work with uiDateTimePickers: `uiDateTimePickerTime()`, `uiDateTimePickerSetTime()`, and `uiDateTimePickerOnChanged()`. These operate on standard `<time.h>` `struct tm`s. Thanks @cody271!
-	* Release builds on Windows with MSVC should be fixed now; thanks @l0calh05t, @slahn, @mischnic, and @zentner-kyle.
-
-* **12 May 2018**
-	* GTK+ and OS X now have a cleaner build process for static libraries which no longer has intermediate files and differing configurations. As a result, certain issues should no longer be present. New naming rules for internal symbols of libui have also started being drafted; runtime symbols and edge cases still need to be handled (and the rules applied to Windows) before this can become a regular thing.
-
-* **2 May 2018**
-	* On Windows, you no longer need to carry around a `libui.res` file with static builds. You do need to link in the appropriate manifest file, such as the one in the `windows/` folder (I still need to figure out exactly what is needed apart from the Common Controls v6 dependency, or at least to create a complete-ish template), or at least include it alongside your executables. This also means you should no longer see random cmake errors when building the static libraries.
-
-* **18 April 2018**
-	* Introduced a new `uiTimer()` function for running code on a timer on the main thread. (Thanks to @cody271.)
-	* Migrated all code in the `common/` directory to use `uipriv` prefixes for everything that isn't `static`. This is the first step toward fixing static library oddities within libui, allowing libui to truly be safely used as either a static library or a shared library.
+## Status
 
-* **18 March 2018**
-	* Introduced an all-new formatted text API that allows you to process formatted text in ways that the old API wouldn't allow. You can read on the whole API [here](https://github.com/andlabs/libui/blob/8944a3fc5528445b9027b1294b6c86bae03eeb89/ui_attrstr.h). There is also a new examples for it: `drawtext`, which shows the whole API at a glance. It doesn't yet support measuring or manipulating text, nor does it currently support functions that would be necessary for things like text editors; all of this will be added back later.
-	* libui also now uses my [utf library](https://github.com/andlabs/utf) for UTF-8 and UTF-16 processing, to allow consistent behavior across platforms. This usage is not completely propagated throughout libui, but the Windows port uses it in most places now, and eventually this will become what libui will use throughout.
-	* Also introduced a formal set of contribution guidelines, see `CONTRIBUTING.md` for details. They are still WIP.
+libui-ng is currently **mid-alpha** software.
 
-* **17 February 2018**
-	* The longstanding Enter+Escape crashes on Windows have finally been fixed (thanks to @lxn).
-	* **Alpha 3.5 is now here.** This is a quickie release primiarly intended to deploy the above fix to package ui itself. **It is a partial binary release; sorry!** More new things will come in the next release, which will also introduce semver (so it will be called v0.4.0 instead).
-	* Alpha 3.5 also includes a new control gallery example. The screenshots below have not been updated yet.
+See [CHANGELOG.md](CHANGELOG.md)
 
-*Old announcements can be found in the NEWS.md file.*
+*Old announcements can be found in the [news.md](old/news.md) file.*
 
 ## Runtime Requirements
 
@@ -86,7 +26,7 @@ But libui is not dead; I am working on it whenever I can, and I hope to get it t
 ## Build Requirements
 
 * All platforms:
-	* [Meson](https://mesonbuild.com/) 0.48.0 or newer
+	* [Meson](https://mesonbuild.com/) 0.58.0 or newer
 	* Any of Meson's backends; this section assumes you are using [Ninja](https://ninja-build.org/), but there is no reason the other backends shouldn't work.
 * Windows: either
 	* Microsoft Visual Studio 2013 or newer (2013 is needed for `va_copy()`) — you can build either a static or a shared library
@@ -97,22 +37,28 @@ But libui is not dead; I am working on it whenever I can, and I hope to get it t
 
 ## Building
 
-libui uses only [the standard Meson build options](https://mesonbuild.com/Builtin-options.html), so a libui build can be set up just like any other:
+libui-ng mainly uses [the standard Meson build options](https://mesonbuild.com/Builtin-options.html).
 
 ```
-$ # you must be in the top-level libui directory, otherwise this won't work
+$ # in the top-level libui-ng directory run:
 $ meson setup build [options]
 $ ninja -C build
 ```
 
-Once this completes, everything will be under `build/meson-out/`. (Note that unlike the previous build processes, everything is built by default, including tests and examples.)
+Once this completes, everything will be under `build/meson-out/`.
+
+libui-ng specific options:
+
+- `-Dtests=(true|false)` controls whether tests are built; defaults to `true`
+- `-Dexamples=(true|false)` controls whether examples are built; defaults to `true`
 
-The most important options are:
+Most important Meson options:
 
 * `--buildtype=(debug|release|...)` controls the type of build made; the default is `debug`. For a full list of valid values, consult [the Meson documentation](https://mesonbuild.com/Running-Meson.html).
 * `--default-library=(shared|static)` controls whether libui is built as a shared library or a static library; the default is `shared`. You currently cannot specify `both`, as the build process changes depending on the target type (though I am willing to look into changing things if at all possible).
 * `-Db_sanitize=which` allows enabling the chosen [sanitizer](https://github.com/google/sanitizers) on a system that supports sanitizers. The list of supported values is in [the Meson documentation](https://mesonbuild.com/Builtin-options.html#base-options).
 * `--backend=backend` allows using the specified `backend` for builds instead of `ninja` (the default). A list of supported values is in [the Meson documentation](https://mesonbuild.com/Builtin-options.html#universal-options).
+* `--wrap-mode=(forcefallback|nofallback|nodownload|...)` controls which cmocka library version to use in test enabled builds. The default is `forcefallback` to pull and build a local copy. Package maintainers may wish to choose `nofallback` to use the system's library and declare `cmocka` a build time dependency or `nodownload`, see [the Meson documentation](https://mesonbuild.com/Subprojects.html#commandline-options) for more details.
 
 Most other built-in options will work, though keep in mind there are a handful of options that cannot be overridden because libui depends on them holding a specific value; if you do override these, though, libui will warn you when you run `meson`.
 
@@ -134,7 +80,7 @@ When running `meson`, the `--prefix` option will set the installation prefix. [T
 
 #### Arch Linux
 
-Can be built from AUR: https://aur.archlinux.org/packages/libui-git/
+Can be built from AUR: https://aur.archlinux.org/packages/libui-ng-git/
 
 ## Documentation
 
@@ -150,14 +96,15 @@ Language | Bindings
 --- | ---
 C++ | [libui-cpp](https://github.com/billyquith/libui-cpp), [cpp-libui-qtlike](https://github.com/aoloe/cpp-libui-qtlike)
 C# / .NET Framework | [LibUI.Binding](https://github.com/NattyNarwhal/LibUI.Binding)
-C# / .NET Core | [DevZH.UI](https://github.com/noliar/DevZH.UI), [SharpUI](https://github.com/benpye/sharpui/), [TCD.UI](https://github.com/tacdevel/tcdfx)
+C# / .NET Core | [DevZH.UI](https://github.com/noliar/DevZH.UI), [SharpUI](https://github.com/benpye/sharpui/), [SimplexiDev.UI](https://github.com/simplexidev/sdfx)
 CHICKEN Scheme | [wasamasa/libui](https://github.com/wasamasa/libui)
 Common Lisp | [jinwoo/cl-ui](https://github.com/jinwoo/cl-ui)
-Crystal | [libui.cr](https://github.com/Fusion/libui.cr), [hedron](https://github.com/Qwerp-Derp/hedron)
+Crystal | [libui.cr](https://github.com/Fusion/libui.cr), [hedron](https://github.com/Qwerp-Derp/hedron), [iu](https://github.com/grkek/iu)
 D | [DerelictLibui (flat API)](https://github.com/Extrawurst/DerelictLibui), [libuid (object-oriented)](https://github.com/mogud/libuid)
 Euphoria | [libui-euphoria](https://github.com/ghaberek/libui-euphoria)
 Harbour | [hbui](https://github.com/rjopek/hbui)
 Haskell | [haskell-libui](https://github.com/beijaflor-io/haskell-libui)
+Janet | [JanetUI](https://github.com/janet-lang/janetui)
 JavaScript/Node.js | [libui-node](https://github.com/parro-it/libui-node), [libui.js (merged into libui-node?)](https://github.com/mavenave/libui.js), [proton-native](https://github.com/kusti8/proton-native), [vuido](https://github.com/mimecorg/vuido)
 Julia | [Libui.jl](https://github.com/joa-quim/Libui.jl)
 Kotlin | [kotlin-libui](https://github.com/msink/kotlin-libui)
@@ -166,8 +113,9 @@ Nim | [ui](https://github.com/nim-lang/ui)
 Perl6 | [perl6-libui](https://github.com/Garland-g/perl6-libui)
 PHP | [ui](https://github.com/krakjoe/ui)
 Python | [pylibui](https://github.com/joaoventura/pylibui)
-Ruby | [libui-ruby](https://github.com/jamescook/libui-ruby)
-Rust | [libui-rs](https://github.com/rust-native-ui/libui-rs)
+Ring | [RingLibui](https://github.com/ring-lang/ring/tree/master/extensions/ringlibui)
+Ruby | [libui-ruby](https://github.com/jamescook/libui-ruby), [LibUI](https://github.com/kojix2/libui), [Glimmer DSL for LibUI](https://github.com/AndyObtiva/glimmer-dsl-libui)
+Rust | [libui-ng-sys](https://github.com/norepimorphism/libui-ng-sys), [boing](https://github.com/norepimorphism/boing), [libui-rs](https://github.com/rust-native-ui/libui-rs)
 Scala | [scalaui](https://github.com/lolgab/scalaui)
 Swift | [libui-swift](https://github.com/sclukey/libui-swift)
 
@@ -182,7 +130,7 @@ See also [this](https://github.com/andlabs/libui/pull/20#issuecomment-211381971)
 
 ## Contributing
 
-See `CONTRIBUTING.md`.
+See [CONTRIBUTING.md](CONTRIBUTING.md)
 
 ## Screenshots
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: libui
 version: !ruby/object:Gem::Version
-  version: 0.0.15
+  version: 0.1.0.pre.0
 platform: ruby
 authors:
 - kojix2
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-03-12 00:00:00.000000000 Z
+date: 2022-11-13 00:00:00.000000000 Z
 dependencies: []
 description: 
 email:
@@ -25,9 +25,8 @@ files:
 - lib/libui/libui_base.rb
 - lib/libui/utils.rb
 - lib/libui/version.rb
-- vendor/LICENSE
+- vendor/LICENSE.md
 - vendor/README.md
-- vendor/README_DYLIB.md
 - vendor/libui.dll
 - vendor/libui.dylib
 - vendor/libui.so
@@ -46,9 +45,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.3.7
 signing_key: 

data/vendor/README_DYLIB.md

@@ -1,45 +0,0 @@
-# libui shared library for M1 Mac
-
-libui.dylib for Mac has been replaced with a universal binary to make LibUI compatible with M1 Mac.
-
-See https://github.com/kojix2/LibUI/issues/47
-
-The LibUI gem also includes libui.so for Linux and libui.dll for Windows, which are identical to the official binaries distributed by andlabs.
-
-## Target libui version
-
-libui version alpha 4.1
-https://github.com/andlabs/libui
-
-## Universal binary
-
-file command to show that it is a universal binary.
-
-```
-file libui.dylib
-# libui.dylib: Mach-O universal binary with 2 architectures: [x86_64:Mach-O 64-bit dynamically linked shared library x86_64] [arm64:Mach-O 64-bit dynamically linked shared library arm64]
-# libui.dylib (for architecture x86_64):	Mach-O 64-bit dynamically linked shared library x86_64
-# libui.dylib (for architecture arm64):	Mach-O 64-bit dynamically linked shared library arm64
-```
-
-## sha256sum
-
-```
-6da2ff5acb6fba09b47eae0219b3aaefd002ace00003ab5d59689e396bcefff7  libui.dylib
-```
-
-## Build method
-
-1. Get the libui version alpha 4.1 and create a shared library for arm64 on M1 mac. 
-2. Download the official shared library provided by [andlabs](https://github.com/andlabs/libui/releases/tag/alpha4.1).
-3. Use the lipo command to merge the two files to create a universal binary.
-
-## Contributing
-
-libui-ng is looking for a way to create a binary file for the M1 Mac.
-See https://github.com/libui-ng/libui-ng/issues/41
-
-## License
-
-MIT
-