=====  Dynamic Color Dialog  =====

Dialog selections are discussed below the image. For navigation to an item make a selection in the Dynamic Color image.

{{imapmarkers>:ui:ui-graphic-selection-phone_green_sq-group-option-edit-background-dynamic_color.webp?200|Color - Dynamic Color}}
[[:ui:ui-graphic-selection-phone_green_sq-group-option-edit-background-custom_color|ID1|Custom color@15,47,92,72]]
{{cfg>}}
   {
   }
{{<cfg}}
{{<imapmarkers}}

<wrap hi>**Dynamic Color dialog. Make selection above.**</wrap>

  * The **Custom color** option (the first element in the dialog above) is the only interactive link in this demo. In the app, this function allows the user to define a specific, static color (Hex code) for the selected object. Using this option overrides the Material You dynamic roles, meaning the object's color will remain static and will //not// update when the device wallpaper changes.

<WRAP center round tip 60%>
<WRAP centeralign>For a setup to use Dynamic Color, the user must "authorize" it:</WRAP>
<WRAP centeralign>''Main Menu'' > ''Launcher options'' > ''UI & Animation'' > ''Dynamic color scheme'' > {{:ui:ui-icon_checked_box.webp?direct&20}}</WRAP>
<WRAP centeralign>{{:ui:ui-animation-dynamic_color-checked.webp?direct&400}}</WRAP>
</WRAP>

Dynamic Color, based on Android's **Material You** design language, adapts the Launcher’s color palette based on the user's wallpaper or theme. It uses //predefined// roles (like "Primary," "Secondary," "Error") to apply consistent colors across different UI elements.

**Note on this Demo:** Since this wiki cannot detect the actual phone wallpaper, it is not possible to visually demonstrate the color changing in real-time.
  * If you have a **Green** wallpaper, selecting "Primary" makes the **//object//** Green.
  * If you have a **Black/White** wallpaper, "Primary" makes the **//object//** Black or White.

==== Color Roles Explained ====

<WRAP center round tip 60%>
Remember: Any settings made here apply only to the object //currently// modifying.
</WRAP>

^  Color Role Name  ^  Description  ^  Associated Role Name (mostly text on objects)  ^  Description  ^
|  **Custom color**  | Allows the user to define a specific,\\ static color (Hex code) for the\\ selected object. Using this option\\ overrides the Material You dynamic\\ roles, meaning the object's color\\ will remain static and will //not//\\ update when the device wallpaper changes. |  -  |  -  |
|  **Primary**  | The main accent color. Used for key buttons\\ or highlights. |  **On primary**  | Text/icons placed //on top// of a primary background (high contrast). |
|  **Primary container**  | A softer background variant for\\ cards or panels. |  **On primary container**  | Text/icons on top of the primary container. |
|  **Secondary**  | Supporting accent color for\\ less-prominent elements. |  **On Secondary**  | Text/icons on top of secondary backgrounds. |
|  **Secondary Container**  | A lighter version of secondary\\ used for secondary cards or panels. |  **On Secondary Container**  | Text/icons on top of the secondary container. |
|  **Tertiary**  | A third accent color for subtle details. |  **On Tertiary**  | Text/icons on top of the tertiary container. |
|  **Tertiary Container**  | This is a lighter version of tertiary used\\ for background of tertiary objects. |  **On tertiary container**  | Text/icons on top of the tertiary container. |
|  **Error**  | Used for alerts (usually Red). |  **On error**  | Text/icon color over error backgrounds |
|  **Error container**  | Text/icons on top of error backgrounds. |  **On error container**  | Text/icons on top of the error container. |
|  **Surface**  | The default background color for cards or pages. |  **On surface**  | Text/icons on top of the surface backgrounds. |

**Usage Tips:**
  ***Contrast:** The “On…” roles ensure visibility. If your background is dark, the “On…” color will be light.
  ***Consistency:** Using these roles ensures a theme looks good even if the wallpaper changes.

=== Automatic vs Manual Control ===

Total Launcher allows for a mix of automatic and manual control:
  ***Automatic:** Total Launcher pulls a palette from the wallpaper and assigns it to the roles (Primary, Secondary, etc.).
  ***Manual Override:** It is possible to override any specific color role. For example, "Error" could be forced to always be Blue, even if the wallpaper is Red.
    * To do this, use the [[ui:ui-resources-shape-selection-all-color-color_picker|Color Picker]] on that specific color role.

<WRAP center round tip 60%>
<WRAP centeralign>See more discussion at:</WRAP>
<WRAP centeralign>[[section:section3-1-customize-dynamic_color|Dynamic Color]]</WRAP>
</WRAP>

<WRAP noprint>{{page>site:site-footer-comment_feedback_block}}</WRAP>