====== Total Launcher Layout Objects ======

Custom layouts are fundamental building blocks within the Total Launcher ecosystem, providing the primary mechanism for organizing clickable graphic objects, shortcuts, and widgets. Unlike simple free-form object placement, applying a specialized Layout Object automatically imposes a set of alignment and spacing rules on the content it contains. This guide explains the:
  * **Adding a layout** to the page
  * **Shared design fundamentals** applicable to all layout types
  * **Unique layouts** specific guides:
    * **List (linear)**
    * **Circle (radial)**
    * **Grid (matrix)**

===== Adding A Layout To The Page =====
A list layout (linear) is added to a page and modified in the following process:
  - Enter [[:section:section-basic_editing#to_enter_edit_mode|Edit Mode]]. Tap the ++''Edit Off'' icon|{{:ui:ui-icon_edit_mode-edit_off-v4.webp?direct&100}}++ in the lower right to change it to an ++''Edit On'' icon|{{:ui:ui-icon_edit_mode-edit_on-v4.webp?direct&35}}++
    - Tap-hold the list object to select it.
    - In the ++Object Design Menu (top)|{{:ui:ui-icon_object_design_menu_top-v4.webp?direct&150}}++ select the ++Option icon|{{ :ui:ui-icon_option-25-v4.webp}}++.
  - Review the menu panels indicated at the bottom of the interface.
    - Select ''OPTIONS'' to modify its options.
    - Select ''ANIMATION'' to adjust the dynamic behaviors.
  - Apply the desired variable changes within the respective menus.

===== Understanding Layout Properties =====

While Total Launcher offers distinct spatial arrangement types (Grid, Circle, List), the visual styling options and interaction rules for the **items contained inside** these layouts remain completely uniform. The configuration interface features four standardized tabs present in every layout dialog. These global functions must be understood first, as they constitute the standardized visual design system across all layout implementations.

==== Shared Style Tabs ====

Each layout configuration dialog includes the following four tabs for uniform object styling:
<WRAP hscroll_box>
<WRAP>
=== Icon ===
Controls visual attributes of contained image graphics. Note that this often adjusts the internal space surrounding the icons (Icon padding), global visibility (opacity and saturation), and applies color overlays uniformly to create cohesive themes.
<WRAP>
=== Options - Icon ===
Modify the visual attributes of the icon images contained within the grid.
  * **Icon size:** - Adjust the overall size (scale) of the icons.
  * **Icon padding:** - Modify the internal space surrounding the icons.
  * **Icon opacity (%):** - Adjust the transparency level of the icons, utilizing values such as ''100%'' for solid visibility.
  * **Icon saturation (%):** - Modify the color intensity, where ''100%'' represents natural colors and reduced values approach grayscale.
  * **Icon color filter:** - Apply a specific color overlay or tint to all icons uniformly.
</WRAP>
<WRAP>
{{:ui:ui-layout-icon-v4.webp?direct&200}}
</WRAP>
</WRAP>
<WRAP hscroll_box>
<WRAP>
=== Label ===
Dictates the typography for text descriptions associated with contained items. This encompasses typeface selection, vertical wrapping (Label lines), sizing, scaling, and the transition of color when an object is pressed or interacted with. 
=== Options - Label ===
Control the display parameters and typography of the text associated with each grid item.
  * **Show label:** - Toggle the visibility state of the text labels to On or Off.
  * **Typeface:** - Select the specific font family applied to the label text.
  * **Label lines:** - Determine the maximum number of lines permitted for text wrapping, ranging from ''1'' to ''3''.
  * **Font size:** - Adjust the structural point size of the label text.
  * **Scale X (%):** - Stretch or compress the text width horizontally.
  * **Text color:** - Define the primary resting color of the text using the Launcher's [[:section:section-color_picker|Color Picker]] and apply a hexadecimal value such as ''#FFFFFFFF''.]
  * **Text color (pressed):** - Same as ''Text color'' above, but changes the text color as the object is 'pressed' or tapped.
</WRAP>
<WRAP>
{{:ui:ui-layout-label-v4.webp?direct&200}}
</WRAP>
</WRAP>
<WRAP hscroll_box>
<WRAP>
=== Shadow ===
Provides dedicated drop shadow controls specifically for item labels. Detailed specifications regarding how to utilize Shadows can be referenced **[[section:section-shadow|here]]**.
=== Options - Shadow ===
Apply drop shadows to text labels for enhanced contrast against varied backgrounds. See [[:section:section-shadow|here]] for more detail on how to use Shadows.
  * **Shadow color:** - Select the hue of the underlying text shadow.
  * **Shadow radius:** - Control the blur, spread, or sharpness of the shadow effect.
  * **Shadow offset X:** - Shift the shadow position along the horizontal axis.
  * **Shadow offset Y:** - Shift the shadow position along the vertical axis.
</WRAP>
<WRAP>
{{:ui:ui-layout-shadow-v4.webp?direct&200}}
</WRAP>
</WRAP>
<WRAP hscroll_box>
<WRAP>
=== Background ===
Configures the styling of the overall layout container and the individual background states (resting, pressed, focused) for items contained within. Standard **margins** and **item spacing** properties are also defined within this section.
=== Options - Background ===
Configure the container styling, individual item backgrounds, and spacing options.
  * **Background:** - Set the global color or image for the entire grid container.
  * **Margins:** - Define the external spacing outside the grid boundary, requiring specific integer values for ''left'', ''top'', ''right'', and ''bottom''.
  * **Item background:** - Set the resting background color or image for individual grid items.
  * **Item background (pressed):** - Set the background visual for individual grid items during a press interaction.
  * **Item background (focused):** - Set the background visual for individual grid items when navigated to via hardware controls or focus states.
  * **Item spacing:** - Adjust the internal gap distance between individual items placed within the grid structure.
</WRAP>
<WRAP>
{{:ui:ui-layout-background-v4.webp?direct&200}}
</WRAP>
</WRAP>

This standardization ensures that design preferences, such as specific font sizes or background colors, are preserved regardless of the chosen spatial arrangement. Future visual theme adjustments only require editing the global configuration rules defined in these tabs.

===== The Specific Layout Types =====

To create custom Android interfaces, one of three specialized structural archetypes must be selected. Although they share the visual configuration system detailed above, each utilizes a distinct method of spatial organization. The following documentation details the distinct properties of each layout style.

Select a layout type to review its dedicated unique options:
<WRAP>
[[:section:section-layout-list|{{:ui:ui-layout-list-v4.webp?direct&150}}]]\\ ➡️[[:section:section-layout-list|List Layout]] - (Linear)
</WRAP>
<WRAP>
[[:section:section-layout-grid|{{:ui:ui-layout-grid-v4.webp?direct&150}}]]\\ ➡️[[:section:section-layout-grid|Grid Layout]] - (Matrix)
</WRAP>
<WRAP>
[[:section:section-layout-circle|{{:ui:ui-layout-circle-v4.webp?direct&150}}]]\\ ➡️[[:section:section-layout-circle|Circle Layout]] - (Radial)
</WRAP>