feat(sdk): 控件库第一批通用基座(agent-150) + launcher/hello 重链
- meow_widget 基座收敛(尾部追加 Options+状态机位+自定义回调+布局子项), W_CUSTOM/W_LAYOUT/W_SPACER - meow_theme 尾部追加 MD3 语义色+风格参数(旧字段 bg/fg/accent/dim 映射兼容), g_theme[2][2](style×mode×明暗), display.background 背景源深浅成对, 图片路径回退 - meow_widget_opts(Modifier式, 不改create签名)/MEOW_WS_*状态机(enabled阻断hit,pressed)/meow_widget_custom_create(render/hit_cb)/meow_row/column/box+arrange(算绝对坐标兼容) - meow_ui_set_style/style/meow_theme_get 完整主题(MD3默认/MIUIx占位) - meow_ui.a=29c5078d hello=24116e6b(向后兼容外观零变化) launcher重链=626546f9；build_sdk 0warning; 宿主 test_sdk_controls T1-T10 PASS + test_sb_statusbar ALL PASS - 未做(第二批/后续): Material子集/实时按压刷新扩展/物理键焦点移动运行时(留草案)
This commit is contained in:
MeowOS committed
1 parent
e6f0b665e3
commit
2cb6a7c16f
5 files changed
+527
-49
No files matched your search
+112
-4
@@ -264,13 +264,37 @@ unsigned long long meow_ui_frames_presented(void);
|
||||
/* ============================================================ */
|
||||
typedef enum { MEOW_THEME_LIGHT, MEOW_THEME_DARK, MEOW_THEME_AUTO } meow_theme_mode;
|
||||
|
||||
/* 主题（§5.8.4 + §8.1.3）。既有字段 bg/fg/accent/dim 保留（兼容映射，见下表），
|
||||
* 其后追加 MD3 语义色板 + 风格参数段（扩展兼容——既有代码读旧字段不受影响）。
|
||||
* 映射：bg↔surface、fg↔onSurface、accent↔primary、dim↔onSurfaceVariant。
|
||||
* 「当前 style×mode」完整主题 = meow_theme_get()（MD3 默认；MIUIx 用 MD3 基础/占位）。 */
|
||||
typedef struct meow_theme {
|
||||
uint32_t bg; /* 背景色 */
|
||||
uint32_t fg; /* 前景/正文 */
|
||||
uint32_t accent; /* 强调色（按钮/选中） */
|
||||
uint32_t dim; /* 次要文字 */
|
||||
/* —— 既有字段（兼容保留；映射见上）—— */
|
||||
uint32_t bg; /* 背景色 = surface */
|
||||
uint32_t fg; /* 前景/正文 = onSurface */
|
||||
uint32_t accent; /* 强调色（按钮/选中）= primary */
|
||||
uint32_t dim; /* 次要文字 = onSurfaceVariant */
|
||||
int font_title; /* 28 */
|
||||
int font_body; /* 20 */
|
||||
|
||||
/* —— MD3 语义色板（§5.8.4；日/夜各一组，AUTO 按 meow_theme_mode 切换）—— */
|
||||
uint32_t primary, onPrimary, primaryContainer, onPrimaryContainer;
|
||||
uint32_t secondary, onSecondary, secondaryContainer, onSecondaryContainer;
|
||||
uint32_t tertiary, onTertiary, tertiaryContainer, onTertiaryContainer;
|
||||
uint32_t surface, onSurface, surfaceVariant, onSurfaceVariant;
|
||||
uint32_t surfaceContainerLowest, surfaceContainerLow, surfaceContainer,
|
||||
surfaceContainerHigh, surfaceContainerHighest;
|
||||
uint32_t surfaceDim, surfaceBright, surfaceTint;
|
||||
uint32_t outline, outlineVariant, scrim;
|
||||
uint32_t error, onError, errorContainer, onErrorContainer;
|
||||
uint32_t inverseSurface, inverseOnSurface, inversePrimary;
|
||||
uint32_t shadow; /* 仅状态层/描边近似用；无 GPU 不做投影（§5.8.7） */
|
||||
|
||||
/* —— 风格参数段（§8.1.3；MD3 默认 / MIUIx 加大圆角+描边+间距）—— */
|
||||
int radius; /* 控件默认圆角（按钮等，px） */
|
||||
int radius_card; /* 卡片/容器默认圆角（px） */
|
||||
int spacing; /* 布局/间距步进（px） */
|
||||
int stroke_w; /* 默认细描边宽（0=无边框，MD3；MIUIx=1） */
|
||||
} meow_theme;
|
||||
|
||||
const meow_theme *meow_theme_get(void);
|
||||
@@ -295,6 +319,90 @@ meow_theme meow_theme_defaults(meow_theme_mode m);
|
||||
void meow_ui_set_style(int style); /* 设顶级主题风格族；越界 clamp 到合法值；同值忽略 */
|
||||
int meow_ui_style(void); /* 当前 style（默认 MEOW_STYLE_MD3） */
|
||||
|
||||
/* ============================================================ */
|
||||
/* §5.8 控件层升级（第一批=通用基座）：Options / 状态机 / 自定义画布 / 布局 */
|
||||
/* ============================================================ */
|
||||
|
||||
/* ---- §5.8.2 Modifier 式通用 Options（轻量结构体，非链式 DSL）----
|
||||
* 经 meow_widget_set_opts 一次性挂载，作用于任意控件（标准/自定义）。全部控件共用。
|
||||
* 哨兵语义：bg/fg==0=用控件/主题默认；stroke==0=无描边；stroke_w=描边宽；
|
||||
* radius==-1=控件默认（如按钮 10），>=0=指定圆角（0=直角）；pad/margin=0=无；
|
||||
* disabled/selected=1=置位（立即反映到状态机位）。 */
|
||||
typedef struct meow_widget_opts {
|
||||
uint32_t bg; /* 背景色（0=控件/主题默认） */
|
||||
uint32_t fg; /* 前景/文字（0=主题 onSurface） */
|
||||
uint32_t stroke; /* 描边色（0=无描边） */
|
||||
int stroke_w; /* 描边宽（px） */
|
||||
int radius; /* 圆角（px；-1=控件默认，如按钮 10） */
|
||||
int pad_x; /* 内边距（水平，px） */
|
||||
int pad_y; /* 内边距（垂直，px） */
|
||||
int margin_x; /* 外边距（水平，px；布局用） */
|
||||
int margin_y; /* 外边距（垂直，px；布局用） */
|
||||
int disabled; /* 1=禁用（视觉变暗 + 不响应命中，见状态机 §5.8.3） */
|
||||
int selected; /* 1=选中（列表高亮/勾选，见状态机 §5.8.3） */
|
||||
} meow_widget_opts;
|
||||
|
||||
/* 挂载：作用于任意控件（标准/自定义）。w 内部浅拷这份 opts。
|
||||
* 返回 0=成功；NULL/无效=负值（不销毁 w）。 */
|
||||
int meow_widget_set_opts(meow_widget *w, const meow_widget_opts *opts);
|
||||
/* 取回当前 opts（浅拷到 out；0=成功）。自定义画布用它读通用修饰。 */
|
||||
int meow_widget_opts_get(const meow_widget *w, meow_widget_opts *out);
|
||||
|
||||
/* ---- §5.8.3 统一状态机（enabled / selected / focused / pressed）----
|
||||
* 标准/自定义控件共用；visual 层由 SDK/App 按状态位叠。enabled=0 阻断 hit/pressed。 */
|
||||
#define MEOW_WS_ENABLED (1u<<0)
|
||||
#define MEOW_WS_SELECTED (1u<<1)
|
||||
#define MEOW_WS_FOCUSED (1u<<2)
|
||||
#define MEOW_WS_PRESSED (1u<<3)
|
||||
|
||||
/* 设/查状态（置位/清位，其它位不动）。on=1 置位 / 0 清位。 */
|
||||
void meow_widget_set_state(meow_widget *w, unsigned bits, int on);
|
||||
unsigned meow_widget_state(const meow_widget *w);
|
||||
|
||||
/* 便捷：禁用/启用、选中/取消（单态等效于 set_state）。 */
|
||||
int meow_widget_enabled(const meow_widget *w);
|
||||
void meow_widget_set_enabled(meow_widget *w, int on);
|
||||
int meow_widget_selected(const meow_widget *w);
|
||||
void meow_widget_set_selected(meow_widget *w, int on);
|
||||
|
||||
/* 一键叠状态层（自定义画布可选）：把 pressed/focused/disabled/selected 的视觉层
|
||||
* 叠到 w 的矩形上（半透明状态层 + 焦点描边）。标准控件由 SDK 自动叠，无需调用；
|
||||
* 自定义画布在 render_cb 里画完内容后可调它（App 也可据 meow_widget_state 自行叠）。 */
|
||||
void meow_widget_draw_state_layer(meow_widget *w, const meow_theme *th);
|
||||
|
||||
/* ---- §5.8.1 自定义画布（App 提供 render/hit 回调；同一个 meow_widget）----
|
||||
* render：SDK 在 meow_widget_draw 时调用，th=当前生效主题（MD3 语义色板）；
|
||||
* w 的 x/y/w/h 已就位；App 用 §3/§4 绘制 API 自绘（往 back_buf 画）。
|
||||
* hit ：命中判定，App 自定义（如圆形/区域外镂空）；返回 1=命中。 */
|
||||
typedef void (*meow_widget_render_fn)(meow_widget *w, const meow_theme *th, void *ctx);
|
||||
typedef int (*meow_widget_hit_fn)(meow_widget *w, int x, int y, void *ctx);
|
||||
|
||||
/* 创建：自定义画布（x,y,w,h = 绝对坐标，同既有控件）。
|
||||
* 生命周期/Activity 归属：创建时绑定当前 active Activity（同 meow_btn_create，§6.1 ①）；
|
||||
* 命中走 hit_cb（先过 owner==active + enabled 双闸门）。 */
|
||||
meow_widget *meow_widget_custom_create(int x, int y, int w, int h,
|
||||
meow_widget_render_fn render_cb,
|
||||
meow_widget_hit_fn hit_cb,
|
||||
void *ctx);
|
||||
|
||||
/* ---- §5.8.5 可组合布局（Row / Column / Box + Spacer）----
|
||||
* 布局容器 = meow_widget（W_LAYOUT）；arrange 把子控件算成绝对坐标（写进各 child 的
|
||||
* x/y/w/h）→ 与现有绝对定位完全兼容（draw/hit/flush_region/owner 闸门照常）。
|
||||
* 本批先支持固定尺寸子项（w/h 均已知）；弹性（w/h==0）为后续增强。 */
|
||||
enum { MEOW_LAYOUT_ROW = 0, MEOW_LAYOUT_COLUMN = 1, MEOW_LAYOUT_BOX = 2 };
|
||||
|
||||
meow_widget *meow_row_create(int x, int y, int w, int h, int spacing);
|
||||
meow_widget *meow_column_create(int x, int y, int w, int h, int spacing);
|
||||
meow_widget *meow_box_create(int x, int y, int w, int h);
|
||||
|
||||
/* 添加子控件（子可为普通控件/自定义/另一布局/Spacer）。返回 0=成功；无效=负值。 */
|
||||
int meow_layout_add(meow_widget *layout, meow_widget *child);
|
||||
/* 计算子控件绝对坐标（写入各 child 的 x,y,w/h；嵌套布局递归）；此后照常 draw/hit。 */
|
||||
void meow_layout_arrange(meow_widget *layout);
|
||||
|
||||
/* 固定尺寸空白（也作撑余量；不可见，hit 恒 0）。 */
|
||||
meow_widget *meow_layout_spacer(int w, int h);
|
||||
|
||||
/* ============================================================ */
|
||||
/* §9 应用日志（统一日志 API，M2.51 最小可用版） */
|
||||
/* ============================================================ */
|
||||
|
||||
Reference in new issue
Block a user