wos_SvgWidgets – Draw your verses
Description
Draw your verses – Where code meets canvas in perfect harmony. Pixel-less precision, infinite resolution. One SVG, all sizes.
README
wos_SvgWidgets
Overview
wos_SvgWidgets provides a splendid, fully customizable SVG editor component, originally developed for GenieSolutions. Where code meets canvas in perfect harmony, this component allows you to integrate powerful vector drawing capabilities directly into your 4D applications.
All underlying sub-widgets are exposed and available, giving you the flexibility to build your own custom vector drawing tools.
SOURCE available here wos_SvgWidgets.4dbase
Key Features
- Ready-to-Use Editor: Includes a powerful
svgEditorwidget that you can seamlessly place directly into your forms. - Easy Launch: A convenience method is provided to instantly open a form pre-populated with the editor for dedicated SVG editing tasks, requiring only a few lines of code.
- Specialized Signing Mode: A unique option allows you to "stick" or lock the selected drawing tool, creating dedicated zones for handwritten signatures and effectively turning the editor into a signing pad.
- Exposed Sub-Widgets: All underlying sub-widgets are available, enabling you to assemble your own custom vector drawing tools.
- Multi-Language Support: Localized in English (EN), with French (FR) and other languages coming soon.
Current Limitation
Please note that the SVGpath element is not currently supported for editing within the widget.
Installation & Dependencies
Prerequisites
- 4D v21 or higher (Project mode recommended).
- wok_Krolific – Licensing component (mandatory dependency).
- wox_Xlibrary – Core utilities (mandatory dependency).
- woc_Colours – Color management engine (mandatory dependency).
- The 4D SVG component must be available in your project.
Installation via Dependencies Manager (GitHub)
Starting with 4D v21, the recommended way to install wos_SvgWidgets (and any ogTools component) is through the Dependencies Manager using the GitHub repository:
- In your 4D project, open the Dependencies Manager (
Project > Dependencies). - Click the
+button and select Add a dependency from a Git URL. - Enter the following Git URL:
protee/wos_SvgWidgets - Choose the desired version (e.g.,
main,latest, or a specific release tag). - Confirm the installation – the component will be automatically fetched from GitHub, placed in the
Componentsfolder, and linked to your project.
Note: For team development, commit the dependency configuration file (
dependencies.json) to your source control so all team members automatically fetch the same version from GitHub.
How It Works
- Place the Widget: Drag and drop the
svgEditorwidget onto any form in your application. - Launch the Editor: Use the provided convenience method to open a dedicated form pre-populated with the editor, requiring only a few lines of code.
- Enable Signing Mode: Activate the unique "sticky" drawing tool option to lock a selected tool, creating a dedicated zone for handwritten signatures.
- Build Custom Tools: Leverage the exposed sub-widgets to assemble your own custom vector drawing tools tailored to your specific needs.
ogTools Suite – Dependencies
wos_SvgWidgets is the vector graphics pillar of the comprehensive ogTools suite – an integrated development ecosystem for 4D. Dependencies:
| Icon | Component | Description |
|---|---|---|
![]() |
wok_Krolific | License manager. |
![]() |
wox_Xlibrary | Core utilities for everyday development tasks. |
![]() |
woc_Colours | Advanced, indexed color management engine. |
License
wos_SvgWidgets is a free component and is part of the ogTools suite. No valid license is required for use. But the woc_Colours dependency requires a license to get full access.
Localization
wos_SvgWidgets supports the following languages out‑of‑the‑box:
- 🇺🇸 English (EN), 🇫🇷 French (FR), 🇪🇸 Spanish (ES), 🇩🇪 German (DE)
- More on demand
Localization affects error messages, UI prompts, and built-in pane texts.
Support & Resources
- Official Website: https://www.protee.org
- Documentation: Full documentation and HDI (Host Database Interface) demos are included with your purchase.
For direct inquiries:
- Email: og@protee.org
- Phone: +33 6 3718 5941
About the Creator
wos_SvgWidgets and the ogToolsSuite are developed by Protée sarl, a company with over 30 years of expertise in 4D development. Led by Olivier Grimbert, the team focuses on delivering high‑quality, production‑grade tools that enhance developer productivity and application reliability.



