Mug Typography

日本語

English

日本語

English

Appearance

PARAMETER REFERENCE

Appendix

制限事項、環境設定のカスタマイズ、およびキーボード・マウス操作一覧などの補足情報をまとめています。

制限事項 ​

項目制限内容
最大文字数通常版：Low 16文字 / Mid 30文字 / High 60文字 / 3D 30文字。
Lite版：通常版の1.5倍（Lite Low 24文字 / Lite Mid 45文字 / Lite High 90文字 / Lite (3D) 45文字）。
Scripting：512文字。
※通常版・Lite版はpreferences.jsonでカスタマイズ可能です（絶対上限512文字）。
最大パーツ数通常版：Low 60 / Mid 84 / High 170 / 3D 84パーツ。
Lite版とScripting：個別パーツパラメーターを持たないため、描画上限の1024パーツまで扱えます。
最大図形数（シェイプ）全プリセット共通で最大256個（Luaスクリプトの ctx.shapes:declare で宣言。文字数・パーツ数の上限枠は消費しません）。
プリセットについて2D用の通常版（Low / Mid / High）とLite版（Lite Low / Lite Mid / Lite High）、3D用の 3D / Lite (3D)、Lua制御用の Scripting があり、計9種類から選択できます。3D系の上限はMid相当です。
個別パラメーターの無効化Lite版（Lite (3D) を含む）ではPart SettingsとPart選択モードが表示されません。ScriptingではCharacter SettingsとPart Settings、および両方の選択モードが表示されず、個別値はLuaから制御します。
旧プロジェクトの互換性アライメントパラメーターが Horizontal Alignment と Vertical Alignment に分離されたため、旧バージョンで作成されたプロジェクトをロードすると、アライメント設定がリセットされます。お手数ですが、再度アライメントを設定し直してください。
フィルター時の背景合成制限グラフィックボードのエラー等によりCPU描画に切り替わった場合、背景画像が読み込めず、背景との合成がスキップされて「テキストのみ（背景が透明または黒）」が表示される状態になります。
Edit ページ：カラーのアルファ値DaVinci Resolve の仕様により、Edit ページではカラーパラメーターのアルファ値（透明度）を設定できません。透明度を使用したい場合は Fusion ページをご利用ください。
Edit ページ：キーフレームエディターInspector で現在選択中のページのパラメーターしか表示されません。他のページのパラメーターにキーフレームを設定する場合は、都度ページを切り替えてください。
Edit ページ：2DパラメーターのキーフレームカーブDaVinci Resolve の仕様により、Edit ページでは Position などの 2D パラメーターに対してキーフレームのカーブ（イージングなど）を設定・調整できません。移動アニメーションの細かな調整が必要な場合は、Fusion ページ版をご利用ください。
Edit ページ：分割クリップへのキーフレーム設定Edit ページで分割（カット）したクリップに対して、プラグイン側（ビューア上の操作や WinAlt+KMacOption+K などによるキーフレーム打刻）からキーフレームを設定すると、キーフレームが正しい位置に設定されません。これは DaVinci Resolve 側の仕様による問題であり、プラグイン側で対応することはできません。このため、本プラグインを適用するクリップは分割しない運用を推奨します。
Fusion ページ：カラーマネジメント設定時の色味の変化プロジェクト設定のカラーサイエンスを DaVinci YRGB Color Managed にしている場合、Fusion ページ上の OFX プラグイン出力が DaVinci Resolve 側でリニア（ガンマ 1.0）として扱われ、ビューアやタイムラインへ送る際にガンマ補正が二重にかかって中間調が明るく白っぽく見えることがあります（標準の DaVinci YRGB プロジェクトや、Edit ページのジェネレーターとして配置した場合は発生しません）。
Fusion ページでカラーマネジメントを使用する場合は、本プラグインの直後に Color Space Transform（色空間変換） ノードを繋ぎ、Input Color Space: Rec.709、Input Gamma: Rec.709、Output Color Space: Rec.709、Output Gamma: Linear、Pre-Divide/Post-Multiply: ON に設定すると本来の色味に戻ります。
TTC フォントのフォントリスト変更.ttc ファイルに含まれる全フェイスが個別にフォントリストへ列挙されます。旧バージョンで作成したプロジェクトで .ttc より後に列挙されていたフォントを使用していた場合、フォント選択がずれる可能性があります。その場合は Inspector でフォントを再選択してください。

環境設定のカスタマイズ (preferences.json) ​

Mug Typography では、プラグインの最大動作制限（最大文字数・最大パーツ数）を、環境設定ファイル preferences.json を編集することでカスタマイズ可能です。主に、次の2つの目的で調整します。

  • 文字数・パーツ数を増やす: 既存のプリセット（Low / Mid / High）の上限では文字数やパーツ数が足りない場合、maxCharacters / maxParts の値を引き上げることで対応できます。
  • ロード時間を短縮する: 逆に、入力するテキストが短い・パーツ数が少ないことが分かっている場合は、上限値を小さくすることでロード時間を短縮できます。ロード時間は、おおよそ「最大文字数 × 文字パラメーター数 ＋ 最大パーツ数 × パーツパラメーター数」の合計値に比例して長くなるため、必要以上に大きな上限値を設定しないことが、軽快に動作させるコツです。

ファイルの配置場所 ​

環境設定ファイルは、各OSの以下のアプリデータディレクトリに配置されています。ファイルが存在しない場合は、一度プラグインを起動すると自動的にデフォルト設定でファイルが生成されます。

text
%APPDATA%\MugLab\MugTypography\preferences.json
text
~/Library/Application Support/MugLab/MugTypography/preferences.json

※ Windows の場合は、エクスプローラーのアドレスバーに %APPDATA%\MugLab\MugTypography\ と入力してEnterを押すと素早く移動できます。

設定ファイルの形式 ​

ファイルは以下のような JSON 形式です。各プリセット（Low, Mid, High）に対する最大文字数 (maxCharacters) と最大パーツ数 (maxParts) を任意の値にカスタマイズできます。

json
{
  "low": {
    "maxCharacters": 16,
    "maxParts": 60
  },
  "mid": {
    "maxCharacters": 30,
    "maxParts": 84
  },
  "high": {
    "maxCharacters": 60,
    "maxParts": 170
  }
}

CAUTION

環境設定ファイル（preferences.json）の編集に伴うリスクについて

preferences.json による制限値の変更は、DaVinci Resolve で開くすべてのプロジェクト（既存プロジェクトも含む）にグローバルに影響します。そのため、編集する際は以下のリスクを十分に理解した上で行ってください。

  • 値を下げる場合（データ喪失リスク）:
    既存プロジェクトで使用されている文字数やパーツ数よりも「小さい値」に制限値を下げた状態でそのプロジェクトを開いてしまうと、制限値を超えた分の文字やパーツの個別パラメーターデータが完全に失われます。 一度保存してしまうと復元できなくなるため、制限値を下げる際は細心の注意を払ってください。
  • 値を上げる場合（パフォーマンスリスク / 動作不安定化）:
    文字数やパーツ数の制限値を引き上げると、より多くの文字を扱えるようになりますが、ロード時間が長くなり、クリップ（Inspector）の切り替えにも時間がかかるようになります。特に最大の上限値に近い値を設定すると、マシンスペックによっては動作が著しくカクついたり、メモリ不足で DaVinci Resolve がクラッシュしたりする恐れがあります。

制限値に関する仕様

  • 設定可能な最大の上限値:
    maxCharacters（最大文字数）は最大 512 まで、maxParts（最大パーツ数）は最大 1024 まで設定可能です。
  • 範囲外の値が設定された場合:
    最大の上限値を超える値や 1 未満の値を記述した場合、その設定項目は無視され、自動的に各プリセットのデフォルト値（Mid の場合は 30文字 / 84パーツなど）に戻ります。
  • Lite版の最大文字数について:
    Lite版（Lite Low / Lite Mid / Lite High）の最大文字数は、preferences.json で設定した通常版の maxCharacters の値をベースに、自動的に 1.5倍（最大512文字まで）に増やした値が適用されます。
  • 3Dプリセットについて:
    3DはMidのmaxCharacters / maxParts、Lite (3D) はMidのmaxCharactersを1.5倍した値を使用します。3D専用の上限項目はなく、Midの設定変更が3D系にも反映されます。
  • Scriptingプリセットについて:
    Scriptingはpreferences.jsonの値に関わらず、最大512文字・1024パーツを使用します。Character / Partの個別パラメーターを定義しないため、上限を増やしてもInspectorの項目数は増えません。

ショートカットキーのカスタマイズ ​

プレビュー画面で使用する一部のショートカットキー（装飾キー以外のキーコード部分）を、設定ファイルに shortcuts オブジェクトを記述することでカスタマイズ可能です。

設定可能なパラメーターおよびデフォルト値は以下のとおりです：

設定項目 (JSONキー)説明デフォルトキーデフォルトコード (10進数)
alignHorizontal水平方向の整列H72
alignVertical垂直方向の整列V86
selectGlobalGlobal（全体選択）モード切り替えA65
selectCharacterCharacter（文字選択）モード切り替えC67
selectPartPart（パーツ選択）モード切り替えP80
selectCameraCamera（カメラ操作）モード切り替えM77
setKeyframeキーフレームの設定K75
adjustIncreaseマージン・トラッキングの間隔増加Up (上矢印)65362
adjustDecreaseマージン・トラッキングの間隔減少Down (下矢印)65364
clearAlpha選択中の文字を透明化（アルファをクリア）[91
restoreAlpha選択中の文字の透明化を解除]93
copy選択中の文字・パーツをコピー元として記憶Y89
pasteコピー元のパラメーターを選択へ貼り付けU85
toggleOutlineアウトライン（境界線）表示の ON/OFF を切り替え;59

設定ファイルの記述例 ​

json
{
  "low": {
    "maxCharacters": 16,
    "maxParts": 60
  },
  "mid": {
    "maxCharacters": 30,
    "maxParts": 84
  },
  "high": {
    "maxCharacters": 60,
    "maxParts": 170
  },
  "shortcuts": {
    "alignHorizontal": 72,
    "alignVertical": 86,
    "selectGlobal": 65,
    "selectCharacter": 67,
    "selectPart": 80,
    "selectCamera": 77,
    "setKeyframe": 75,
    "adjustIncrease": 65362,
    "adjustDecrease": 65364,
    "clearAlpha": 91,
    "restoreAlpha": 93,
    "copy": 89,
    "paste": 85,
    "toggleOutline": 59
  }
}

主要キーコード一覧（10進数） ​

設定ファイルに記述する主なキーコードは以下のとおりです。

  • アルファベット（大文字）:
    • A〜Z: 65〜90
    • ※アルファベットを指定した場合、大文字・小文字のどちらのキー入力でも反応します。
  • 数字:
    • 0〜9: 48〜57
  • ファンクションキー:
    • F1〜F12: 65470〜65481
    • F13〜F24: 65482〜65493 （通常のキーボードにない特殊キーに割り当てる際におすすめです）
  • その他特殊キー:
    • Space (スペース): 32
    • Enter (エンター): 65293
    • Escape (エスケープ): 65307
    • Backspace (バックスペース): 65288
    • Delete (デリート): 65535
    • Tab (タブ): 65289

キーボード・マウス操作一覧 ​

プレビュー画面 ​

操作動作
クリック文字・パーツを選択（選択切り替え）
ドラッグ文字・パーツを移動
選択済み対象をクリック複数選択を維持したまま移動
空白エリアをドラッグマーキー選択（範囲選択）
選択済み対象を WinCtrlMacCommand + クリック回転・スケール・ピボットハンドルを表示
対象を WinCtrl+AltMacCommand+Option + クリックCharacter / Part モードで選択状態を切り替え
バウンディングボックスの辺を WinAltMacOption + ドラッグStretch を変更
WinAlt+↑/↓MacOption+↑/↓0.1em 単位で増減（Global: Tracking / Character: 選択文字の Margin After）
WinAlt+KMacOption+K現在選択中の文字・パーツに対してキーフレームを設定（Set Keyframes for Selected）
WinAlt+Ctrl+HMacOption+Command+H選択中の文字を水平方向に整列
WinAlt+Ctrl+VMacOption+Command+V選択中の文字を垂直方向に整列
WinAlt+Ctrl+AMacOption+Command+A選択モードを Global（テキスト全体）に切り替え
WinAlt+Ctrl+CMacOption+Command+C選択モードを Character（個々の文字）に切り替え
WinAlt+Ctrl+PMacOption+Command+P選択モードを Part（文字内のパーツ）に切り替え（※Lite / Scriptingでは無効）
WinAlt+Ctrl+MMacOption+Command+M選択モードを Camera（カメラ操作）に切り替え（3D / Scriptingプリセットのみ）
WinAlt+Ctrl+[MacOption+Command+[選択中の文字を透明化（アルファをクリア）※Character 選択モードのみ
WinAlt+Ctrl+]MacOption+Command+]選択中の文字の透明化を解除し、グローバルカラーに戻す ※Character 選択モードのみ
WinAlt+Shift+YMacOption+Shift+Y選択中の文字・パーツをコピー元として記憶（Copy Selection）
WinAlt+Shift+UMacOption+Shift+Uコピー元のパラメーターを選択へ貼り付け（Paste to Selection）
WinAlt+;MacOption+;アウトライン（境界線）表示の ON/OFF を切り替え
CameraモードでOrbitハンドルをドラッグCamera Yaw / Pitchを変更（3D / Scriptingプリセットのみ）
Cameraモードで空白を WinAltMacOption + ドラッグカメラをオービット（3D / Scriptingプリセットのみ）
CameraモードでTarget PadをドラッグCamera Targetを移動（3D / Scriptingプリセットのみ）
CameraモードでZoom / PerspectiveハンドルをドラッグCamera Zoom / Perspective Strengthを変更（3D / Scriptingプリセットのみ）
Cameraモードで操作ハンドル外をドラッグLens Shiftを変更（3D / Scriptingプリセットのみ）
Cameraモードでドラッグ中に Shift移動量の大きい軸に操作を固定（3D / Scriptingプリセットのみ）

※ ショートカットのキー部分（Alt+Ctrl+H の H や、Alt+K の K など）は、設定ファイル preferences.json を編集することでカスタマイズ可能です（Alt や Ctrl などの修飾キーは変更できません）。

数値の範囲 ​

パラメーター範囲単位
Position / Pos-1.0 〜 +1.0（表示） / -10.0 〜 +10.0（内部）キャンバス相対
Pivot-1.0 〜 +1.0（表示） / -10.0 〜 +10.0（内部）キャンバス相対
Rotation-360 〜 +360（表示） / -360000 〜 +360000（内部）度
Scale（全体）0.1 〜 5.0（表示） / 0.001 〜 100.0（内部）倍率
Scale（文字・パーツ）0.1 〜 10.0（表示） / 0.001 〜 100.0（内部）倍率
Stretch-10 〜 +10倍率
Global / Character Yaw・Pitch-360.0 〜 +360.0（表示） / -360000 〜 +360000（内部）度
Character / Part Z Offset-0.5 〜 +0.5（表示） / -1.9 〜 +10.0（内部）キャンバス高さ相対
Camera Target / Lens Shift-1.0 〜 +1.0（表示） / -10.0 〜 +10.0（内部）キャンバス相対
Camera Yaw / Pitch-360.0 〜 +360.0（表示） / -360000 〜 +360000（内部）度
Perspective Strength0.0 〜 2.0（表示） / 0.0 〜 5.0（内部）比率
Camera Zoom0.001 〜 10.0（表示） / 0.001 〜 100.0（内部）倍率
Tracking-1.0 〜 +1.0（表示） / -10.0 〜 +10.0（内部）em
Line Spacing-2.0 〜 3.0（表示） / -10.0 〜 10.0（内部）em
Margin After (em)-1.0 〜 +1.0（表示） / -10.0 〜 +10.0（内部）em
Emoji Offset X / Y-1.0 〜 +1.0（表示） / -10.0 〜 +10.0（内部）em
Emoji Scale0.1 〜 3.0（表示） / 0.01 〜 10.0（内部）倍率
Stroke Width / Outer Stroke Width0.0 〜 0.2（表示） / 0.0 〜 10.0（内部）フォントサイズ比
Stroke Gap0.0 〜 0.2（表示） / 0.0 〜 10.0（内部）フォントサイズ比
Stroke Miter Limit1.0 〜 20.0（表示） / 1.0 〜 100.0（内部）比率
Gradient Midpoint0.0 〜 1.0正規化
Gradient Angle0.0 〜 360.0（表示） / -360000 〜 +360000（内部）度
Gradient Start / End0.0 〜 1.0（表示） / -1.0 〜 2.0（内部）BB 相対
Texture P1 〜 P50.0 〜 1.0（角度スロットは 0.0 〜 360.0）（表示） / -1000.0 〜 +1000.0（内部）スロット依存
Shadow Distance0.0 〜 0.5（表示） / 0.0 〜 10.0（内部）em (フォントサイズ比)
Shadow Angle-360 〜 +360（表示） / -360000 〜 +360000（内部）度
Text Blur X / Y0.0 〜 1.0（表示） / 0.0 〜 10.0（内部）em (フォントサイズ比)
Shadow Blur X / Y0.0 〜 1.0（表示） / 0.0 〜 10.0（内部）em (フォントサイズ比)
Text Glow / Shadow Glow0.0 〜 1.0（表示） / 0.0 〜 10.0（内部）比率
Pulse Amplitude0.0 〜 3.0（表示） / 0.0 〜 20.0（内部）比率
Trapezoid Amplitude0.0 〜 1.0比率
Sphere / Barrel Amplitude0.0 〜 1.0（表示） / -10.0 〜 +10.0（内部）比率
Pulse/Sphere/Barrel Range Min / Max-1.0 〜 1.0正規化
Deform Speed (Hz)0.0 〜 10.0（表示） / 0.0 〜 20.0（内部）Hz
Deform Step0.0 〜 360.0度
Deform Phase0.0 〜 360.0（表示） / -360000.0 〜 +360000.0（内部）度
Deform Char Phase / Angle-360.0 〜 +360.0（表示） / -360000.0 〜 +360000.0（内部）度
Deform Char Delay-2.0 〜 +2.0（表示） / -10.0 〜 +10.0（内部）秒
Hand Drawn Frame Rate1.0 〜 30.0（表示） / 0.001 〜 120.0（内部）回/秒
Hand Drawn Wobble Amplitude0.0 〜 10.0（表示） / 0.0 〜 100.0（内部）フォントサイズ相対
Hand Drawn Fine Wobble0.0 〜 2.0（表示） / 0.0 〜 100.0（内部）フォントサイズ相対
Hand Drawn Jitter Amplitude0.0 〜 10.0（表示） / 0.0 〜 100.0（内部）フォントサイズ相対
Hand Drawn Pattern Count1 〜 30個
Border Width0.5 〜 500.0% (フォントサイズ比)
Bounding Box Margin X / Y-1500 〜 +1500% (フォントサイズ比)
Bounding Box Corner Radius0 〜 100% (フォントサイズ比)
Bounding Box Border / Fill Offset-1500 〜 +1500% (フォントサイズ比)

変形の適用順序 ​

2Dプリセット ​

グローバル変形（Position / Rotation / Scale / Stretch）
    ↓（追加で適用）
キャラクター変形（Pos / Rotation / Scale / Stretch）
    ↓（追加で適用）
パーツ変形（Pos / Rotation / Scale / Stretch）

3Dプリセット ​

3DプリセットではCharacter / PartのStretchを使用できません。各階層の変形を積み重ねたあと、Camera Settingsの投影を適用します。

グローバル変形（Position / Rotation / Scale / Stretch / Global Yaw / Pitch）
    ↓（追加で適用）
キャラクター変形（Pos / Rotation / Scale / Z Offset / Yaw / Pitch）
    ↓（追加で適用）
パーツ変形（Pos / Rotation / Scale / Z Offset）
    ↓
Camera Settingsによる投影

色の優先順位 ​

面（フィル）の色:

パーツの個別色（Use Indiv Color）  ← 最優先
    ↑ なければ
キャラクターの個別色（Use Indiv Color）
    ↑ なければ
グローバルのフォントカラー（Font Color） / グラデーション

線（ストローク）の色:

キャラクターの個別ストローク色（Use Indiv Stroke：Stroke Color / Outer Stroke Color）  ← 最優先
    ↑ なければ
グローバルのストロークカラー（Stroke Color / Outer Stroke Color）

シャドウの色:

キャラクターの個別シャドウ色（Use Indiv Shadow：Shadow Color）  ← 最優先
    ↑ なければ
グローバルのシャドウカラー（Shadow Color）

アンインストール ​

インストール先からフォルダを削除し、DaVinci Resolve を再起動してください。

OSインストール先
WindowsC:\Program Files\Common Files\OFX\Plugins\MugTypography.ofx.bundle
macOS/Library/OFX/Plugins/MugTypography.ofx.bundle