m4l-techniques

Max for Live Development Techniques

Practical techniques for building robust Max for Live devices, covering the Live Object Model, device namespaces, parameter persistence, and common pitfalls.

M4L デバイス構築チェックリスト

M4L デバイスを構築する際、以下の順序で設計・実装する。

設計段階（patch-guidelines Phase 0 と併用）

1. 保存方式を決定: Live 直接管理 vs pattrstorage 管理（Live Parameter Rules Section 5 参照）
2. パラメータの復元依存チェーンを設計: _parameter_order を hot/cold inlet の依存関係に基づいて決定（Live Parameter Rules Section 6 参照）
3. pattr の命名: --- プレフィックスを使わない（Namespace & Parameters 参照）
4. pattr のデータ型を決定: Float 値は _parameter_range [-100000, 100000]、テキストは _parameter_type 3 (blob)（Live Parameter Rules Section 3 参照）

実装段階

5. live.observer パターン: property はメッセージで設定、@property 構文は使わない（Live Parameter Rules Section 1 参照）
6. live.object の API: プロパティ設定は set <property> <value>、取得は get <property>（<property> <value> ではない）
7. live. UI の unitstyle*: _parameter_type が Float (0) なら _parameter_unitstyle も Float (1) に設定（Live Parameter Rules Section 2 参照）
8. pattr outlet 構造: outlet 0 = 値出力、outlet 1 = bindto（UI バインド）、outlet 2 = dumpout。UI にバインドする場合は outlet 1 をパッチコードで接続

Categories

Live Object Model (LOM)

The foundation for programmatic control of Ableton Live from Max for Live devices.

Key topics:

• Path-based navigation (live.path)
• ID generation and session-scoped lifecycle
• Parameter control with live.object (get/set/call)
• Real-time monitoring with live.observer

See Live Object Model Reference

LOM Applied Patterns

Reusable patterns for building production M4L devices with the Live Object Model.

Key topics:

• Dynamic LOM path construction with pak + zl.join
• Dynamic parameter range from live.observer list counting
• Visual feedback via highlighted_clip_slot
• Triggering LOM methods with live.text button mode

See LOM Applied Patterns Reference

LOM Observer Patterns

live.observer を使った監視・フィルタリングの実践パターン。

Key topics:

• live.observer の有効化・無効化パターン
• selected_parameter フィルタチェーン
• canonical_parent による自デバイスパラメータ除外

See LOM Observer Patterns Reference

Namespaces & Parameter Persistence

M4L-specific naming and state management patterns.

Key topics:

• --- (device-wide) vs #0 (instance-local) namespace prefixes
• Why pattr names must NOT use --- prefix
• Unbound pattr persistence fix (Float → blob)
• selected_parameter monitoring workaround

See Namespace & Parameters Reference

Tips & Reference Values

Practical tips for M4L device development.

Key topics:

• Logarithmic controller mapping (input^exponent)
• Live level values and dBFS reference table
• Push2 Automapping Index for parameter display order

See Tips Reference

Live Parameter Rules

M4L デバイス固有のコーディングルール。Live パラメータシステムとの正しい連携方法。

Key topics:

• live.observer のアトリビュート設定方法と property メッセージ
• live.* UI オブジェクトの _parameter_unitstyle 設定
• pattr の parameter_enable と永続化設定
• live.dial の表示要素制御（showname / shownumber）
• パラメータ保存方式の選択（Live 直接管理 vs pattrstorage）
• _parameter_order による復元順序の完全定義

See Live Parameter Rules Reference