SuperAPI AI 工具集

m4l-presentation-layout

办公与效率

查看项目

更新于 10-16 03:41

技能介绍

用途:为 Max for Live(M4L)设备规划 GUI 与 Presentation 模式布局,解决界面超出设备条、被裁剪或渲染模糊的问题。

主要能力与规则:Live 设备条高度固定为 169 像素,内容应设计在 y=0..168,推荐上下各留 4–8 px 内边距,可用高度约 152–153 px。宽度由 patcher 的 devicewidth 决定:0.0 为动态宽度,也可设为正整数固定宽度;官方建议尽量窄。M4L 无用户拖拽缩放,折叠设备需自行向 live.thisdevice 发送 setwidth <pixels>,并让初始宽度与初始状态一致以避免加载闪烁。

坐标:patching_rect 是编辑视图坐标,presentation_rect 是 Live 中显示的坐标,两者独立。需要显示的控件必须设 "presentation": 1,patcher 级需设 "openinpresentation": 1。坐标只用整数,避免非 Retina 屏模糊;推荐 patcher 属性 integercoordinates: 1、gridsize: [8.0, 8.0]、default_fontname: "Ableton Sans"。

尺寸参考:live.dial 大约 35×48(Tiny 24×24、Large 40×85、横向 75×30);live.numbox 50×15;live.text 按钮 50×15、切换 30×15;live.toggle 与 live.button 15×15;live.tab 每页约 70×15;live.menu 80×15;live.slider 横向 80×15、纵向 15×80;live.gain~ 约 95×25;live.meter~ 纵向 10×80。这些是刚放置时的经验值,需在 Inspector 中核对。

主题:Live 10+ 有 Light、Mid Light、Mid Dark、Dark 四套主题,live.* 对象自动跟随主题;自定义颜色需测试全部主题,非 live.* 对象可用 live.colors 读取主题色。

限制与常见错误:y+h 超过 169 底部被裁剪;x+w 超过 devicewidth 右侧被裁剪;负坐标、忘记 presentation 标记、浮点坐标、非 100% 缩放设置设备宽度、未测试主题的自定义颜色,以及把 live.thisdevice、live.observer、live.path、live.object、live.remote~ 等基础设施对象标为 presentation: 1,都是需要避免的问题。

资料给出若干参考布局与布局算法,并建议对每个 presentation_rect 断言 0<=x、x+w<=devicewidth、0<=y、y+h<=169 且均为整数。具体代码示例此处从略。