From 71ad49d8cd93b4da6e7a8d0ff796293ff2f66e86 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rodrigo=20Depin=C3=A9=20Dalpiaz?= <dalpiaze@gmail.com>
Date: Fri, 12 Jan 2024 19:32:35 -0300
Subject: [PATCH] Update README.md

---
 README.md | 25 +++++++++++++++++++++----
 1 file changed, 21 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 8282533..e022d54 100644
--- a/README.md
+++ b/README.md
@@ -27,11 +27,19 @@
 - [Literal tag character](#literal-tag-character)
 - [Chinese/Japanese/Korean line break](#chinesejapanesekorean-line-break)
 - [Auto Scaling](#auto-scaling)
+- [Color Notation](#color-notation)
 - [Formatted Message Dialog Component](#formatted-message-dialog-component)
 - [Donate](#donate)
 
 ## What's New
 
+- 01/12/2024 (Version 5.1)
+
+   - Improved VCL x FMX x HTML color notation. Please read Color Notation topic.
+
+<details>
+  <summary>Click here to view the entire changelog</summary>
+
 - 01/05/2024 (Version 5.0)
 
    | :exclamation: Component breaking changes           |
@@ -71,9 +79,6 @@
    - New Tag `<PI>` - paragraph indent
    - New Transparent property for VCL
 
-<details>
-  <summary>Click here to view the entire changelog</summary>
-
 - 12/05/2023 (Version 4.4)
 
    - Fixed Lazarus compilation (ScalingUtils directive).
@@ -409,7 +414,7 @@ This visual component allows you to specify a formatted text in a label, using a
 <OFFSET:[top=123],[bottom=456]></OFFSET> - Content margin spacing
   Offset margins are memorized if a new offset tag is specifyed without same parameter name
 
-* COLOR_VALUE - clColor(VCL)|Color(FMX)|$123456|$12345678|#123456|#12345678
+* COLOR_VALUE - clColor(VCL)|Color(FMX)|$00GGBBRR|#AARRGGBB|#RRGGBB
 * When FMX, all sizes (TPixels) use the "." notation as a decimal separator
 ```
 
@@ -715,6 +720,18 @@ If using Windows previous version, the scaling will be based on the default moni
 
 In FMX environment, auto scaling is controled by Fire Monkey framework, automatically scaling the entire form layout and its components.
 
+## Color Notation
+
+When using tags like `<fc:color>` or `<bc:color>`, you can specify these color notation options:
+
+- VCL Style: `$00BBGGRR`, where BB=Blue Color, GG=Green Color, RR=Red Color.
+- VCL Literal: `clColor` -> example: clBlack, or clWindowText.
+- FMX Style: `#AARRGGBB`, where AA=Alpha Chanel, RR=Red, GG=Green, BB=Blue.
+- FMX Literal: `Color` -> example: Black (FMX TAlphaColor does not support system colors).
+- HTML Style: `#RRGGBB`, where RR=Red, GG=Green, BB=Blue (when using in FMX, alpha channel will be set to `FF` - solid).
+
+You can specify VCL notation when using FMX component, or even using FMX notation when using VCL component. The same for HTML notation.
+
 ## Formatted Message Dialog Component
 
 Please, take a look at my Message Dialogs Component that uses this HTML Component to display formatted messages. The component will make much more easy to manage your application messages.