Colour, reloaded.
Mantra: Indexed purity. No RGB noise.
Tagline: Color, solved.

woc_Colours

Overview

woc_Colours is the advanced low‑level color management engine for the ogTools suite. It operates in both RGB and specialized indexed color spaces, providing unparalleled consistency and design flexibility for any 4D project. Localized in EN, FR, ES, DE.

Key Features

Supported Color Spaces

• md – Material Design (bright and efficient)
• mdo – Material Design OG (double the luminosity of md)
• sw – Senzā Wada original (new)
• swo – Senzā Wada OG reloaded (new)
• rale – RALe (smooth and soft)
• pans – Pantone Short (curated and efficient)
• pant – Pantone (comprehensive)
• mn – A custom space
• 4d – Native 4D theme colors
• svg – Standard SVG colors
• web – Standard web colors

Intelligent Color Editor

A single long integer can store both Stroke and Fill properties, each potentially from a different color space. The editor UI dynamically resizes when switching spaces to maintain perfectly squared color samples and seamlessly manages conversions between spaces.

Comprehensive Tools

• Ready‑to‑Use Widgets – Includes color pickers, menus, and other UI elements for seamless integration.
• Color Processing – Provides common utilities for color manipulation and treatment.
• Extended Libraries – Features libraries for rgb, colour, color, and svg operations.
• Pattern Library – A collection of “delicious” patterns from Hero Patterns, complete with an embedded editor for customization.

Advantages of Indexed Colors

• Stroke and Fill combined in one long integer.
• Limited choice that adds taste to your UI.
• With built‑in spaces, the effective limitation is low.
• Up to 16 spaces (4 bits) and 4096 indexes (12 bits).
• Lazy loading: spaces and conversion tables can be auto‑ or pre‑loaded.
• Display and copy colors in multiple formats: [0x0…], [sp:index] name, numeric values, rgb(r,g,b), 0xrrggbb, etc.

Installation & Dependencies

Prerequisites

• 4D v21 or higher (Project mode recommended).
• wok_Krolific – Licensing component (mandatory dependency).
• wox_Xlibrary – Core utilities (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 woc_Colours (and any ogTools component) is through the Dependencies Manager using the GitHub repository:

1. In your 4D project, open the Dependencies Manager (Project > Dependencies).
2. Click the + button and select Add a dependency from a Git URL.
3. Enter the following Git URL:protee/woc_Colours
4. Choose the desired version (e.g., main, latest, or a specific release tag).
5. Confirm the installation – the component will be automatically fetched from GitHub, placed in the Components folder, 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.

ogTools Suite – Dependencies

woc_Colours is the color management 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.

License

woc_Colours is a commercial component and is part of the paid ogTools suite. A valid license is required for use. For licensing options and trial requests, please contact the sales team directly.

Localization

woc_Colours supports the following languages out‑of‑the‑box:

• 🇺🇸 English (EN), 🇫🇷 French (FR), 🇪🇸 Spanish (ES), 🇩🇪 German (DE)
• Other 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

woc_Colours 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.