Millumin2 OSC控制参数文档及示例下载
OSC是通过网络工作的通信协议。它是易于阅读和非常多才多艺。
Millumin使用OSC消息接收指令:用于TouchOSC布局,或创建与Millumin协作的应用程序。它也发送消息(见反馈部分)。创建OSC消息很简单,请参考开发人员套件获取许多技术的示例。
简而言之,OSC消息有两部分:the /address和[arguments]。
将不透明度设置为75%的示例,命名为“test”的图层:
/millumin/test/opacity [0.75]
该协议由计算机或移动设备上的多个应用程序支持。
例如,在TouchOSC上:请参阅本教程
这是一个直接链接,用于下载TouchOSC的模板
操作控制参数
启动或停止特定列:
• /millumin/action/launchOrStopColumn [index or “name”]
• /millumin/action/launchColumn [index or “name”]
• /millumin/action/stopColumn
例如 :
• /millumin/action/launchColumn [11] 推出第11列
• /millumin/action/launchColumn [“test”] 启动名为“test”的列
启动上一列或下一列:
• /millumin/action/launchPreviousColumn
• /millumin/action/launchNextColumn
要播放/暂停您正在编辑的时间轴:
• /millumin/action/playTimeline
• /millumin/action/pauseTimeline
• /millumin/action/playOrPauseTimeline
• /millumin/action/goToTimelineSegment [“name”]
选择Board:
• /millumin/action/selectBoard [index or “name”]
选择元素:
• /millumin/action/selectLayer [index or “name”]
• /millumin/action/selectLight [index or “name”]
进入/退出全屏:
• /millumin/action/enterFullscreen
• /millumin/action/exitFullscreen
打开/保存项目:
• /millumin/action/openProject [“/path/to/my/project.millumin”]
• /millumin/action/saveProject
• /millumin/action/saveProject [“/path/to/my/project.millumin”]
你可以通过以下方式离开Millumin:
• /millumin/action/quit
要发送’ping’,那么Millumin会返回多个OSC消息,它描述所有层的状态:
• /millumin/ping
管理元素
要管理元素(层,灯光,…),您的OSC地址必须标识它。您有不同的替代方案,具体取决于您如何管理元素:
• /millumin/myElementName/… 定位名为“myElementName”的元素
• /millumin/layer:myLayerName/… 定位名为“myLayerName”的图层
• /millumin/light:myLightName/… 瞄准名为“myLightName”的光
• /millumin/index:99/… 以索引99定位元素(请参阅首选项以显示索引)
• /millumin/selectedLayer/… 在界面中定位所选图层(橙色)
• /millumin/selectedLight/… 在界面中以选定的光线为目标(橙色)
OSC消息不区分大小写(“selectedLayer”与“selectedlayer”相同)
以下是可用于图层的属性:
• /millumin/selectedLayer/opacity [0.75] 以75%更新不透明度
• /millumin/selectedLayer/position/xy [12,21]移动[12,21](简称/selectedLayer/xy)
• /millumin/selectedLayer/position/x [12]在X上移动12像素(短格式/selectedLayer/x)
• /millumin/selectedLayer/position/y [21]以21px移动Y(短格式/selectedLayer/y)
• /millumin/selectedLayer/rotation [90] 以90°旋转
• /millumin/selectedLayer/scale [0.5] 以50%
移动映射角:
• /millumin/selectedLayer/mapping/topLeft [12,21] 在[12,21]
• /millumin/selectedLayer/mapping/topLeft/x [12] 在X上以12px移动角
• /millumin/selectedLayer/mapping/topLeft/y [21] 在21px处移动Y点
• /millumin/selectedLayer/mapping/topRight [12,21]
• /millumin/selectedLayer/mapping/bottomRight [12,21]
• /millumin/selectedLayer/mapping/bottomLeft [12,21]
要更改效果参数(效果由其索引识别):
• /millumin/selectedLayer/effect1/red [0.1] 改变第一效果的“红色”参数
• /millumin/selectedLayer/effect3/blue [0.1] 改变第三个效果的“蓝色”参数
改变光线的强度:
• /millumin/selectedLight/intensity [0.8] 更新强度为80%
要相对工作(向值添加一个数字),请使用后缀/+或/-:
• /millumin/selectedLayer/position/x/+ [10] 在X上微调10点
• /millumin/selectedLayer/scale/- [0.01] 降低1%的规模
通过属性专业选择图层:
• /millumin/layer:myLayerName/selected [1] 选择名为“myLayerName”的图层
• /millumin/layer:myLayerName/selected [0] 取消选中名为“myLayerName”的图层
管理媒体
媒体可以直接通过他们的名字来定位,或者首先识别图层:
• /millumin/Movie.mov/… 以“Movie.mov”为目标的媒体
• /millumin/selectedLayer/media/… 瞄准所选层的当前媒体
以下是电影可以使用的属性:
• /millumin/Movie.mov/time [10] 在10秒钟内移动播放头
• /millumin/selectedLayer/media/time [10] 在10秒钟内移动播放头
• /millumin/selectedLayer/media/normalizedTime [0.5] 在电影中间移动播放头
• /millumin/selectedLayer/media/speed [0.5] 将速度改为50%
更新Quartz补丁输入:
• /millumin/selectedLayer/media/myQuartzInput [0.5] 将名为“myQuartzInput”的Quartz输入更新为0.5
开始/暂停/停止媒体:
• /millumin/selectedLayer/startMedia 重新启动当前媒体
• /millumin/selectedLayer/startMedia [7] 在第七栏开始媒体
• /millumin/selectedLayer/startMedia [“Movie.mov”] 开始名为“Movie.mov”的媒体
• /millumin/selectedLayer/pauseMedia 暂停当前 媒体
• /millumin/selectedLayer/startOrPauseMedia 开始/暂停当前媒体
• /millumin/selectedLayer/stopMedia 停止当前媒体
反馈
Millumin发送OSC消息,所以第三方应用可以捕获它们。确保激活:打开设备管理器(CMD + K),然后选择“OSC”选项卡,并检查“Millumin API”中的反馈是否打开。
当列启动/停止时,Millumin发送:
• /millumin/board/launchedColumn [index,”name”] (如果列没有名称,则最后一个参数不存在)
• /millumin/board/stoppedColumn [index,”name”] (如果列没有名称,则最后一个参数不存在)
媒体启动/暂停/停止时,Millumin发送:
• /millumin/layer:myLayer/mediaStarted [index,”name”,duration] (如果媒体没有持续时间,最后一个参数不存在)
• /millumin/index:99/mediaStarted [index,”name”,duration] (如果媒体没有持续时间,最后一个参数不存在)
• /millumin/layer:myLayer/mediaPaused [index,”name”]
• /millumin/index:99/mediaPaused [index,”name”]
• /millumin/layer:myLayer/mediaStopped [index,”name”]
• /millumin/index:99/mediaStopped [index,”name”]
跟踪属性:opacity,xy,rotation,scale,mapping / topLeft,mapping / topRight,mapping / bottomRight,mapping / bottomLeft,intensity所以当属性被更新时,Millumin发送:
• /millumin/layer:myLayerName/opacity [0.8] 以通知不透明度更新为80%
• / millumin / index:99 / … [value]
• /millumin/light:myLightName/intensity [0.5] 通知强度更新为50%
专门针对媒体:
• /millumin/selectedLayer/media/time [value,duration]
• /millumin/selectedLayer/media/normalizedTime[数值]`
• /millumin/selectedLayer/media/speed[数值]`
当选择更改时,Millumin发送:
• /millumin/layer:myLayerName/selected 以通知名为“myLayerName”的图层被选中
• /millumin/light:myLightName/selected 以通知名为“myLightName”的光被选中
• /millumin/index:99/selected 以通知索引99处的元素被选中
通过后缀/?,您可以询问Millumin向您发送有关特定财产的费用:
• /millumin/myElementName/opacity/? 询问有关名为“myElementName”的元素的不透明度
• /layer:myLayerName/position/? 询问名为“myLayerName”的图层的位置
• /light:myLightName/intensity/? 询问旋转名为“myLightName”的光
• /index:99/scale/? 询问索引99上的元素的比例
• /selectedLayer/mapping/topLeft/? 询问所选图层的左上角
• /selectedLight/intensity/? 询问所选光的强度
概要
地址:
• /millumin/action/launchOrStopColumn
• /millumin/action/launchColumn
• /millumin/action/stopColumn
• /millumin/action/launchPrevColumn
• /millumin/action/launchNextColumn
• /millumin/action/playTimeline
• /millumin/action/pauseTimeline
• /millumin/action/playOrPauseTimeline
• /millumin/action/goToTimelineSegment
• /millumin/action/selectBoard
• /millumin/action/selectLayer
• /millumin/action/selectLight
• /millumin/action/enterFullscreen
• /millumin/action/exitFullscreen
• /millumin/action/openProject
• /millumin/action/saveProject
• /millumin/action/quit
• /millumin/ping
• /millumin/myElementName/opacity
• /millumin/layer:myLayerName/position
• /millumin/light:myLightName/intensity
• /millumin/index:99/rotation
• /millumin/selectedLayer/scale
• /millumin/selectedLight/intensity
• /millumin/selectedLayer/mapping/topLeft
• /millumin/selectedLayer/mapping/topRight
• /millumin/selectedLayer/mapping/bottomRight
• /millumin/selectedLayer/mapping/bottomLeft
• /millumin/selectedLayer/effect1/myParameterName
• /millumin/layer:myLayerName/selected
• /millumin/MyMedia.mov/time
• /millumin/selectedLayer/media/time
• /millumin/selectedLayer/media/normalizedTime
• /millumin/selectedLayer/media/speed
• /millumin/selectedLayer/media/myQuartzInput
• /millumin/selectedLayer/startMedia
• /millumin/selectedLayer/startMedia
• /millumin/selectedLayer/pauseMedia
• /millumin/selectedLayer/startOrPauseMedia
• /millumin/selectedLayer/stopMedia
• /millumin/board/columnLaunched
• /millumin/board/columnStopped
• /millumin/selectedLayer/mediaStarted
• /millumin/selectedLayer/mediaPaused
• /millumin/selectedLayer/mediaStopped
后缀:
• /+
• /?
停用地址(可在Millumin V1使用):
• /millumin/layer/…
• /millumin/layer/addX
• /millumin/layer/addY
• /millumin/layer/mapPoint
• /millumin/layer/mapPointAddX
• /millumin/layer/mapPointAddY
• /millumin/layer/media
• /millumin/layer/media/text/prevLine
• /millumin/layer/media/text/nextLine
• /millumin/layer/media/quartz/param1
• /millumin/layer/select
• /millumin/layer/currentMediaDuration
• /millumin/action/launchOrStopColumnWithName
• /millumin/action/composition/start
• /millumin/action/composition/stop
• /millumin/action/composition/startOrStop
• /millumin/action/fullscreen
• /millumin/action/stopAll
• /millumin/action/selectLayerWithName
• /millumin/action/fadeToBlack
• /millumin/composition/cue
专题:Millumin中文使用说明:
- 创建MilluNode项目
- Millumin中文说明-基础入门
- Millumin中文说明-时间线
- Millumin中文说明-映射表面
- Millumin中文说明-动画属性
- Millumin中文说明-屏幕拼接融合
- Millumin中文说明-使用MIDI、OSC、DMX
- Millumin中文说明-创建视频映射
- Millumin中文说明-外部设备
- Millumin中文说明-使用着色器
- Millumin中文说明-设置投影
- Millumin中文说明-DMX 设备
- Millumin3开启Cinema 4D插件
- Millumin3开启Unity插件进行视频映射
- Millumin开启After Effects插件
- Millumin2 OSC控制参数文档及示例下载
- Millumin2键盘快捷键