meta data for this page
  •  
Index Key Link
action Click to view
add Click to view
affiliation Click to view
align Click to view
alignment Click to view
alpha Click to view
analog clock Click to view
animated image Click to view
app drawer Click to view
app group Click to view
application Click to view
audio Click to view
background Click to view
backup Click to view
beginner Click to view
behavior Click to view
blur Click to view
calendar Click to view
card Click to view
checklist Click to view
circle indicator Click to view
clean slate Click to view
clock Click to view
code block Click to view
code of conduct Click to view
color picker Click to view
communities Click to view
compass Click to view
compatibility Click to view
complementary color Click to view
conceptual learning Click to view
configure Click to view
contact Click to view
contrast Click to view
contribute Click to view
date Click to view
date / time Click to view
default launcher Click to view
delete Click to view
desktop Click to view
developer Click to view
discussion guideline Click to view
distribution Click to view
drawer Click to view
drawer handle Click to view
dual-screen Click to view
dynamic color Click to view
dynamic image Click to view
dynamic text Click to view
edit Click to view
editing Click to view
edit mode Click to view
export Click to view
feature Click to view
file naming Click to view
flip-style Click to view
foldable Click to view
folder Click to view
font Click to view
full screen Click to view
gaussian Click to view
gesture Click to view
getting started Click to view
gradient Click to view
group Click to view
heading Click to view
help Click to view
hide Click to view
html Click to view
hue Click to view
icon Click to view
import Click to view
install Click to view
installation Click to view
instructable Click to view
intellectual property Click to view
issue Click to view
key Click to view
keys & gestures Click to view
label Click to view
landscape mode Click to view
launcher action Click to view
layout Click to view
liability Click to view
lifetime purchase Click to view
light source Click to view
link Click to view
list Click to view
luminance Click to view
macro Click to view
macrodroid Click to view
margin Click to view
mask Click to view
media controller Click to view
mobile Click to view
month/year/day Click to view
move Click to view
multi-screen Click to view
namespace Click to view
navigation Click to view
object Click to view
object design menu Click to view
official Click to view
official blog Click to view
offset Click to view
option Click to view
ordinal Click to view
page Click to view
page indicator Click to view
paste Click to view
performance Click to view
permission Click to view
pin Click to view
png Click to view
quoting Click to view
radius Click to view
registration Click to view
reminder Click to view
remove Click to view
resource Click to view
rotate Click to view
rss Click to view
save Click to view
scroll Click to view
search Click to view
select Click to view
shadow Click to view
shape Click to view
share Click to view
sidebar Click to view
slider Click to view
sliding drawer Click to view
spacing Click to view
stretch Click to view
syntax Click to view
system setting Click to view
system ui Click to view
table Click to view
table of content Click to view
tasker Click to view
taxonomy Click to view
temperature Click to view
termination Click to view
terms of use Click to view
text Click to view
theme Click to view
toby Click to view
trademark Click to view
transform Click to view
transparency Click to view
transparent Click to view
troubleshooting Click to view
typeface Click to view
ui Click to view
user conduct Click to view
user interface demo Click to view
variable Click to view
wallpaper Click to view
warranties Click to view
weather Click to view
webp Click to view
website Click to view
welcome Click to view
widget Click to view
wiki Click to view
wiki editing Click to view
window Click to view

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
section:section-shadow [2026/05/10 18:09] – external edit 127.0.0.1section:section-shadow [2026/05/21 18:30] (current) – ↷ Links adapted because of a move operation doreps
Line 1: Line 1:
-{{https://img.shields.io/badge/PAGE-UNDER_CONSTRUCTION-orange.png?350&style=for-the-badge}} 
- 
-< restructure this for improved flow > 
 ====== Resource - Shadow ====== ====== Resource - Shadow ======
  
Line 9: Line 6:
 Total Launcher relies on Android's native rendering engine, which features specific behaviors. Use these two concepts when working with graphic objects: Total Launcher relies on Android's native rendering engine, which features specific behaviors. Use these two concepts when working with graphic objects:
  
-==== 1. To create a reliable drop shadow, follows these guidelines: ====+==== To create a reliable drop shadow, follows these guidelines: ====
   * **For a Solid Shadow:** - Assign the shape or picture/image to the Object's Edit Option dialog ''Image'' (foreground) property (the first element), and assign the shadow preset to it's single ''Background'' property in that dialog. An example of that dialog is shown ++here.|{{:section:section-object-edit-option-dialog.webp?direct&200}}++   * **For a Solid Shadow:** - Assign the shape or picture/image to the Object's Edit Option dialog ''Image'' (foreground) property (the first element), and assign the shadow preset to it's single ''Background'' property in that dialog. An example of that dialog is shown ++here.|{{:section:section-object-edit-option-dialog.webp?direct&200}}++
   * **For a Hollow Ring Shadow:** - Applies a border width of at least ''3'' to the shape, and sets the Alpha Fill opacity to 1% (e.g., ''ARGB 01000000'').   * **For a Hollow Ring Shadow:** - Applies a border width of at least ''3'' to the shape, and sets the Alpha Fill opacity to 1% (e.g., ''ARGB 01000000'').
   * **For ALL Shadows (The Margin Rule):** - Increases the object's ''Margins'' in the direction the shadow falls. The margin value must be equal to or greater than the shadow's radius to prevent the soft edges of the shadow from hitting the object's invisible bounding box and clipping.   * **For ALL Shadows (The Margin Rule):** - Increases the object's ''Margins'' in the direction the shadow falls. The margin value must be equal to or greater than the shadow's radius to prevent the soft edges of the shadow from hitting the object's invisible bounding box and clipping.
  
-==== 2. When a drop shadow is desired, avoids the following actions: ====+==== When a drop shadow is desired, avoids the following actions: ====
   * **0% Alpha Transparency:** - Never sets a shape's fill to exactly ''00'' (e.g., ''ARGB 00000000''). The rendering engine assumes the object is completely invisible and instantly deletes the shape, border, and shadow from the screen to save processing power.   * **0% Alpha Transparency:** - Never sets a shape's fill to exactly ''00'' (e.g., ''ARGB 00000000''). The rendering engine assumes the object is completely invisible and instantly deletes the shape, border, and shadow from the screen to save processing power.
   * **Margins at 0:** - A zero margin forces the shape to touch the absolute edges of its container, leaving zero physical room on the canvas for the shadow to be drawn.    * **Margins at 0:** - A zero margin forces the shape to touch the absolute edges of its container, leaving zero physical room on the canvas for the shadow to be drawn. 
Line 37: Line 34:
 {{tablelayout?colwidth="250px,550px"&rowsHeaderSource=auto&float=left}} {{tablelayout?colwidth="250px,550px"&rowsHeaderSource=auto&float=left}}
 ^  Shadow Add Dialog  ^  Element Descriptions  ^ ^  Shadow Add Dialog  ^  Element Descriptions  ^
-|  The Shadow Add dialog\\ {{:ui:ui-resource-shadow-add-dialog.webp?direct&200}}  | • **Label:** - Enter a filename (no spaces/only underscore ''_'' for separators) to ID when saved.\\ \\ • **Shadow color:** - See a full review of TL's Color Picker [[:section:section-color_picker|here.]] See also the discussion below for successful color selection for shadows on different backgrounds.\\ \\ • **Shadow radius:** - Controls the spread/softness of the shadow. "Radius" technically measures a distance (in pixels) the blur extends from the object's edge. (A technical review of "Radius" is [[:section:section-resource-shadow-radius-technical|here.]]) Visually it determines how "fuzzy" the shadow appears.\\ » Low values (1-5): Tight, hard-edged shadow mimicking harsh light source.\\ » High values (10+): Wide, soft-edged shadow mimicking a large, diffused light source.\\ ⇒ Note: If Offset X/Y = 0, the shadow remains perfectly centered behind the object; a higher radius will make it "glow" out from all sides.\\ \\ • **Shadow offset X:** - Controls the horizontal position of the shadow relative to the object. Positive values push the shadow to the right; negative values push the shadow to the left.\\ \\ • **Shadow offset Y:** - Controls the vertical position of the shadow relative to the object. Positive values push the shadow downwards; negative values push the shadow upwards. |+|  The Shadow Add dialog\\ {{:ui:ui-resource-shadow-add-dialog.webp?direct&200}}  | • **Label:** - Enter a filename (no spaces/only underscore ''_'' for separators) to ID when saved.\\ \\ • **Shadow color:** - See a full review of TL's Color Picker [[:section:section-color_picker|here.]] See also the discussion below for successful color selection for shadows on different backgrounds.\\ \\ • **Shadow radius:** - Controls the spread/softness of the shadow. "Radius" technically measures a distance (in pixels) the blur extends from the object's edge. (A technical review of "Radius" is [[section:section-shadow-radius-technical|here.]]) Visually it determines how "fuzzy" the shadow appears.\\ » Low values (1-5): Tight, hard-edged shadow mimicking harsh light source.\\ » High values (10+): Wide, soft-edged shadow mimicking a large, diffused light source.\\ ⇒ Note: If Offset X/Y = 0, the shadow remains perfectly centered behind the object; a higher radius will make it "glow" out from all sides.\\ \\ • **Shadow offset X:** - Controls the horizontal position of the shadow relative to the object. Positive values push the shadow to the right; negative values push the shadow to the left.\\ \\ • **Shadow offset Y:** - Controls the vertical position of the shadow relative to the object. Positive values push the shadow downwards; negative values push the shadow upwards. |
  
-===== Practical Applications ===== do samples and include how to procedure+===== Practical Applications =====  
 + 
 +<do samples and include how to procedure>
 The following are methods to apply shadows in object design: The following are methods to apply shadows in object design:
   * **Layered Image or Shape Frames:** - Acts as a strict clipping mask for a photograph with its own background frame to create a floating border effect.   * **Layered Image or Shape Frames:** - Acts as a strict clipping mask for a photograph with its own background frame to create a floating border effect.
Line 59: Line 58:
       * Prevent clipping by increasing the object's margins to be greater than or equal to the shadow's radius and offset       * Prevent clipping by increasing the object's margins to be greater than or equal to the shadow's radius and offset
       * See the technical discussion [[:section:section-shadow-rule1|here.]]       * See the technical discussion [[:section:section-shadow-rule1|here.]]
- 
  
   * **Do not use 0% Alpha:**   * **Do not use 0% Alpha:**
Line 85: Line 83:
   * **Example:** If your Radius is 50 and Offset is 10, do not set the Margin to 60. Set it to **72** to account for the "tail" of the Gaussian blur.   * **Example:** If your Radius is 50 and Offset is 10, do not set the Margin to 60. Set it to **72** to account for the "tail" of the Gaussian blur.
  
-> **Design Tip:** To test your shadows effectively, always set your launcher wallpaper to the color recommended in the "Best Use On" column of the configuration tables. Testing a "Light Mode" shadow on a "Dark Mode" background will always result in a "Contrast Wall" failure. +<WRAP center round tip 60%> 
- +**Design Tip:** To test your shadows effectively, always set your launcher wallpaper to the color recommended in the "Best Use On" column of the configuration tables. Testing a "Light Mode" shadow on a "Dark Mode" background will always result in a "Contrast Wall" failure. 
-Why this works for your manual +</WRAP>
- * Directness: It addresses the "frustrating results" immediately by explaining that it isn't a bug; it's a lack of contrast. +
- * Actionable Data: The "Success/Failure" table gives users a quick sanity check before they spend an hour tweaking offsets. +
- * Rule Integration: It links back to Rule 1 to explain why your Margin of 60 was still clipping your Radius of 50.+
  
-===== UI Navigation Note: The Single-%%Slot%% Background =====+===== UI Navigation Note: The Single Slot Background =====
 When configuring a Graphic Object's Options (gear) menu, the **Background** property is a single-occupancy %%slot%%.  When configuring a Graphic Object's Options (gear) menu, the **Background** property is a single-occupancy %%slot%%. 
-  * You can assign a Shape, an Image, a Color, **OR** a Shadow to this %%slot%%, but you cannot stack them directly inside the same Background menu level.  +  * A shape, an image, a color **or** a shadow can be assigned to this slot, but  cannot be combined to stack them directly inside the same Background menu level.  
-  * To apply a shadow based on a specific custom shape's properties, the Shape Resource must reside in the object's top **Image** (foreground) %%slot%%, while the Shadow preset resides in the **Background** %%slot%%.+  * To apply a shadow based on a specific custom shape's properties, the Shape Resource must reside in the object's top **Image** (foreground) slot, while the Shadow preset resides in the **Background** slot.
  
 ===== Performance Hits from Radius/Blur Use ===== ===== Performance Hits from Radius/Blur Use =====