MapMap OSC 协议深度指南用 /mapmap 指令正则批量控制全部映射图层【免费下载链接】mapmapOpen source video mapping software项目地址: https://gitcode.com/gh_mirrors/ma/mapmapMapMap 是一款开源视频映射video mapping软件它内置完整的OSCOpen Sound Control接口默认监听 UDP12345端口所有指令地址均以/mapmap开头。无论用整数编号还是通配符模式你都可以一条指令批量控制全部映射图层opacity、solo、visible 等属性让序列器、MIDI 控制器或另一台电脑在演出中实时驱动 MapMap。一、快速上手MapMap 默认监听 UDP 123453 步发出第一条指令打开 MapMap 并加载你的映射项目用任意 OSC 客户端向127.0.0.1:12345发送一条消息例如/mapmap/play看到画布开始播放说明 OSC 通道已打通。 端口可按需修改在偏好设置对话框中更改或用启动参数mapmap --osc-port 端口号默认值 12345 定义在 src/core/MM.h。完整的地址方案见项目根目录的 OSC 说明文件。二、全局传输控制/mapmap/play 等 4 条指令速查这 4 条全局指令不需要任何参数作用于所有素材是现场演出最常用的急停/启动手段OSC 地址作用/mapmap/play播放全部素材/mapmap/pause暂停全部素材/mapmap/rewind全部倒回到起点/mapmap/quit退出 MapMap三、核心技巧用编号或通配符模式批量选择映射图层这是 MapMap OSC 协议最强大的部分。所有针对**素材source或图层layer**的指令第一个参数都是目标选择器支持两种方式整数按 id 选中单个元素编号从 1 开始字符串按名称匹配shell 风格通配符模式即正则式的轻量写法命中所有符合的元素——这就是批量控制的关键。例如你有一批命名为clip01clip12的视频素材发送一条/mapmap/source/rewind clip*12 个素材会同时倒回起点。选择方式指令示例效果按 id/mapmap/layer/solo 3 1第 3 个图层进入独奏模式精确名称/mapmap/source/rewind intro.mov只倒回 intro.mov通配符前缀/mapmap/source/rewind clip*倒回所有 clip 开头的素材通配符通配/mapmap/source/rewind *.mov倒回所有 .mov 素材小知识layer图层和mapping映射是同义词两种写法都可以图层本身就是映射。四、图层属性指令清单opacity、solo、visible 一键设置4.1 常用属性属性类型范围说明opacityfloat0.0 ~ 1.0不透明度visibleint/bool0/1显示/隐藏soloint/bool0/1独奏只显示该图层lockedint/bool0/1锁定防止误操作depthint—图层叠加顺序namestring—重命名图层写法统一为/mapmap/layer/属性 目标 值例如把所有mesh-开头的图层设为 50% 不透明/mapmap/layer/opacity mesh-* 0.54.2 几何指令移动、平移与顶点演出中调整映射范围时几何指令同样支持通配符批量/mapmap/layer/move/xy 目标 x y 把图层中心移到 (x, y) /mapmap/layer/translate/xy 目标 dx dy 相对平移 /mapmap/layer/vertex/xy 目标 顶点序号 x y 设置目标形顶点 /mapmap/layer/vertex/source/xy 目标 顶点序号 x y 设置源形顶点坐标使用 MapMap 内部坐标系画布左上角为原点具体数值可打开已保存的.mmp项目文件直接读取。五、实战示例3 条指令指挥整场秀下图这类网格纹理常作为映射校准的测试图案配合 OSC 指令可以快速做切换与调校一场演出的典型调度只需要 3 条消息/mapmap/rewind 全部素材倒回起点准备开场 /mapmap/layer/solo mesh-1 1 只显示 1 号墙面的映射 /mapmap/play 启动演出结束前再补一条/mapmap/source/opacity clip* 0.1所有视频素材瞬间淡出到 10%——整个过程不碰鼠标。✨六、零依赖工具用 mapmap-osc.py 快速发送测试项目自带一个无需安装任何第三方库的 Python 命令行 OSC 客户端scripts/mapmap-osc.py它会自动识别参数类型整数/浮点/字符串也可以加i:、f:、s:前缀强制指定类型。python3 scripts/mapmap-osc.py /mapmap/play python3 scripts/mapmap-osc.py /mapmap/layer/opacity 0 0.5 python3 scripts/mapmap-osc.py /mapmap/source/color 3 #ff0000 python3 scripts/mapmap-osc.py --host 192.168.1.20 --port 9000 /mapmap/pause想深入原理指令的解析逻辑集中在 src/control/OscAction.cpp地址 参数 → 动作的纯函数解析消息接收与执行在 src/control/OscInterface.cpp配套单元测试见 tests/TestOsc.cpp。七、安全提醒OSC 端口没有认证OSC 端口不做身份验证——任何能访问该端口的设备都能控制你的 MapMap。正式演出时如果不想接收外部消息请直接在防火墙封掉 12345 端口或把 MapMap 运行在独立网络中。这也是官方刻意不通过 OSC 暴露项目文件读/写功能的原因。掌握/mapmap地址体系后配合编号与通配符模式MapMap 就能被序列器、硬件控制器或脚本完全接管——这正是开源视频映射软件用于现场演出时的核心玩法。【免费下载链接】mapmapOpen source video mapping software项目地址: https://gitcode.com/gh_mirrors/ma/mapmap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 MapMap OSC 协议深度指南：用 /mapmap 指令+正则批量控制全部映射图层
MapMap OSC 协议深度指南用 /mapmap 指令正则批量控制全部映射图层【免费下载链接】mapmapOpen source video mapping software项目地址: https://gitcode.com/gh_mirrors/ma/mapmapMapMap 是一款开源视频映射video mapping软件它内置完整的OSCOpen Sound Control接口默认监听 UDP12345端口所有指令地址均以/mapmap开头。无论用整数编号还是通配符模式你都可以一条指令批量控制全部映射图层opacity、solo、visible 等属性让序列器、MIDI 控制器或另一台电脑在演出中实时驱动 MapMap。一、快速上手MapMap 默认监听 UDP 123453 步发出第一条指令打开 MapMap 并加载你的映射项目用任意 OSC 客户端向127.0.0.1:12345发送一条消息例如/mapmap/play看到画布开始播放说明 OSC 通道已打通。 端口可按需修改在偏好设置对话框中更改或用启动参数mapmap --osc-port 端口号默认值 12345 定义在 src/core/MM.h。完整的地址方案见项目根目录的 OSC 说明文件。二、全局传输控制/mapmap/play 等 4 条指令速查这 4 条全局指令不需要任何参数作用于所有素材是现场演出最常用的急停/启动手段OSC 地址作用/mapmap/play播放全部素材/mapmap/pause暂停全部素材/mapmap/rewind全部倒回到起点/mapmap/quit退出 MapMap三、核心技巧用编号或通配符模式批量选择映射图层这是 MapMap OSC 协议最强大的部分。所有针对**素材source或图层layer**的指令第一个参数都是目标选择器支持两种方式整数按 id 选中单个元素编号从 1 开始字符串按名称匹配shell 风格通配符模式即正则式的轻量写法命中所有符合的元素——这就是批量控制的关键。例如你有一批命名为clip01clip12的视频素材发送一条/mapmap/source/rewind clip*12 个素材会同时倒回起点。选择方式指令示例效果按 id/mapmap/layer/solo 3 1第 3 个图层进入独奏模式精确名称/mapmap/source/rewind intro.mov只倒回 intro.mov通配符前缀/mapmap/source/rewind clip*倒回所有 clip 开头的素材通配符通配/mapmap/source/rewind *.mov倒回所有 .mov 素材小知识layer图层和mapping映射是同义词两种写法都可以图层本身就是映射。四、图层属性指令清单opacity、solo、visible 一键设置4.1 常用属性属性类型范围说明opacityfloat0.0 ~ 1.0不透明度visibleint/bool0/1显示/隐藏soloint/bool0/1独奏只显示该图层lockedint/bool0/1锁定防止误操作depthint—图层叠加顺序namestring—重命名图层写法统一为/mapmap/layer/属性 目标 值例如把所有mesh-开头的图层设为 50% 不透明/mapmap/layer/opacity mesh-* 0.54.2 几何指令移动、平移与顶点演出中调整映射范围时几何指令同样支持通配符批量/mapmap/layer/move/xy 目标 x y 把图层中心移到 (x, y) /mapmap/layer/translate/xy 目标 dx dy 相对平移 /mapmap/layer/vertex/xy 目标 顶点序号 x y 设置目标形顶点 /mapmap/layer/vertex/source/xy 目标 顶点序号 x y 设置源形顶点坐标使用 MapMap 内部坐标系画布左上角为原点具体数值可打开已保存的.mmp项目文件直接读取。五、实战示例3 条指令指挥整场秀下图这类网格纹理常作为映射校准的测试图案配合 OSC 指令可以快速做切换与调校一场演出的典型调度只需要 3 条消息/mapmap/rewind 全部素材倒回起点准备开场 /mapmap/layer/solo mesh-1 1 只显示 1 号墙面的映射 /mapmap/play 启动演出结束前再补一条/mapmap/source/opacity clip* 0.1所有视频素材瞬间淡出到 10%——整个过程不碰鼠标。✨六、零依赖工具用 mapmap-osc.py 快速发送测试项目自带一个无需安装任何第三方库的 Python 命令行 OSC 客户端scripts/mapmap-osc.py它会自动识别参数类型整数/浮点/字符串也可以加i:、f:、s:前缀强制指定类型。python3 scripts/mapmap-osc.py /mapmap/play python3 scripts/mapmap-osc.py /mapmap/layer/opacity 0 0.5 python3 scripts/mapmap-osc.py /mapmap/source/color 3 #ff0000 python3 scripts/mapmap-osc.py --host 192.168.1.20 --port 9000 /mapmap/pause想深入原理指令的解析逻辑集中在 src/control/OscAction.cpp地址 参数 → 动作的纯函数解析消息接收与执行在 src/control/OscInterface.cpp配套单元测试见 tests/TestOsc.cpp。七、安全提醒OSC 端口没有认证OSC 端口不做身份验证——任何能访问该端口的设备都能控制你的 MapMap。正式演出时如果不想接收外部消息请直接在防火墙封掉 12345 端口或把 MapMap 运行在独立网络中。这也是官方刻意不通过 OSC 暴露项目文件读/写功能的原因。掌握/mapmap地址体系后配合编号与通配符模式MapMap 就能被序列器、硬件控制器或脚本完全接管——这正是开源视频映射软件用于现场演出时的核心玩法。【免费下载链接】mapmapOpen source video mapping software项目地址: https://gitcode.com/gh_mirrors/ma/mapmap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考