# ドープシートビュー

ドープシートビューでは、アニメーションの[キー](/spine-keys)のタイミングを表示・編集することができます。

ドープシートでは、キーのタイミングのみが表示され、値は表示されませんが、様々なプロパティのキーを一度に表示することができます。一方、[グラフ](/spine-graph)はキーのタイミングと値の両方を表示しますが、キーが設定されているプロパティが多い場合には扱いづらいことがあります。

![](/img/spine-user-guide/dopesheet/dopesheet.png)

ドープシートを効率的に使うための様々な方法については、ドープシートの[Tips](/spine-tips#Dopesheet)をご覧ください。

# 行

[タイムライン](/spine-keys#タイムライン)の下に、ボーンごとにまとめられた、キーが記録されているプロパティごとの行が表示されます。各行には、キーを表す色付きの長方形があります。各キーの種類ごとに固有の色が使われています。白いキーは、同じフレームに複数のタイプのキーがあることを示しています。

![](/img/spine-user-guide/dopesheet/rows.png)

ドープシートの行の上でマウスホイールをスクロールすると、行が上下にスクロールします。ビューポートと同様に、マウスの右ボタンでドラッグすると、ドープシートの行が上下または左右に移動します。

## 概要行

ドープシートの最初の行は「概要行」で、この行には、アニメーション名と、その下のすべての行のキーが表示されます。これは、アニメーションの全てのキーを同時に変更したい場合や、ドープシートに表示されている全てのキーを変更したい場合に便利です。

<callout>アニメーション名をクリックするのは、別のアニメーションを選択する必要がある場合に便利ですが、[アニメーションビュー](/spine-animations-view)を使用する方がより効率的です。</callout>

プロジェクトに複数のスケルトンがある場合は、各スケルトンの行の上に概要行が表示されます。ツリー上でスケルトンを非表示にすると、ドープシート上でも非表示になります。

アニメーション名をクリックすると、そのアニメーションがツリー上でも選択されます。

## ボーン行

![](/img/spine-user-guide/dopesheet/rows-bone.png)

キーは、キーが設定されたプロパティに最も関連するボーンによってグループ化されます。

ボーン行は、行の左にある折りたたみ(`-`)または展開(`+`)アイコンをクリックするか、ボーン名を右クリックすることで折りたたんだり展開したりすることができます。展開すると、ボーン行はその下にある複数のプロパティのキーが同じフレームに重なっている場合にのみキーを表示します。折りたたまれると、ボーン行はその下にあるプロパティのすべてのキーを表示します。

<callout>ドープシートが[ロック](#ロックされている時)されているときには、ボーン名をクリックしてボーンが選択されてもドープシートの行は変更されないので、より便利です。</callout>

ボーン名をクリックして、ビューポート内のボーンを選択できます。`ctrl`(Macでは`cmd`)を押しながら操作すると、選択を切り替えたり、複数のボーンを選択することができます。

ボーン行は、上下にドラッグすることで、ドープシート上での[順番](#順番)を変えることができます。

## プロパティ行

![](/img/spine-user-guide/dopesheet/rows-property.png)

ボーン行の下には、キーが設定された各プロパティのプロパティ行があります。プロパティ行には、そのプロパティのすべてのキーが表示されます。キーとキーの間の線は、キー間の補間の種類を示しています。

<callout>[ボーンのトランスフォーム](/spine-tools#ボーンのトランスフォーム)のプロパティ名をクリックすると、対応する[トランスフォームツール](/spine-tools#トランスフォームツール)も選択されるので、新しいキーの設定をより手早く行えます。</callout>

プロパティ名をクリックすると、ビューポートまたはツリー上でアイテムが選択されます。`ctrl`(Macでは`cmd`)を押したままにすると、選択を切り替えたり、複数のアイテムを選択することができます。

### 補間について

キー間の直線は、キー間のリニア補間を表します。ややカーブした線はベジエ補間、点線はステップ補間を表します。キー間の補間については、[グラフ](/spine-graph#カーブの種類)を参照してください。

また、キー間に線がない場合は、キー間で補間が行われていないことを示しています。これは、両方のキーが同じ値を持っているか、[スロットアタッチメント](/spine-keys#スロットアタッチメント)や[イベントキー](/spine-keys#イベント)のように、キーの種類によってトランジションが無いことを意味します。なお、概要行とボーン行では、キー間に線が表示されることはありません。

## その他の行

[表示順序](/spine-keys#表示順序)と[イベント](/spine-keys#イベント)の行はボーンに関連付けられていないので、キーが打たれている場合はグラフの最下部に表示されます。これらの行は[ドープシートのフィルター](#フィルター)を使って隠すことができます。

# コンテンツ

ドープシートには、どのボーンの行が表示されるかを制御するために2つのモードがあります。つまり、ロックされていない状態とロックされている状態です。

## ロックされていない時

![](/img/spine-user-guide/dopesheet/unlock.png)

<callout>すべてのボーン行を表示するには、`スペースバー`、`エスケープ`キーを押すか、ビューポートの任意の場所をダブルクリックして[選択を解除](/spine-tools#選択解除)します。</callout>

ドープシートはデフォルトではロックされていません。ロックされていない時、どのボーンの行が表示されるかは、ビューポートまたはツリー上の選択に依存します。ボーン(またはボーンの下のアイテム)が選択されている場合、それらのボーンの行のみが表示されます。ボーンが選択されていない場合は、すべての行が表示されます。

ドープシートをロックせずに使用するのは、一度に1つのボーンのキーを見るだけで良い場合には便利です。複数のボーンで作業する場合は、ドープシートのコンテンツをロックした方が便利です。

## ロックされている時

![](/img/spine-user-guide/dopesheet/lock.png)

<callout>[同期](#同期)が有効になっていると、ロックボタンが非表示になります。</callout>

ロックボタンをクリックすると、ドープシートがロックされ、どのボーンの行が表示されるかを固定できます。ロック中は、ビューポートやツリー上での選択を変更しても、表示されるボーンの行は変わりません。

ドープシートをロックすることは、複数のボーンや特定のボーンのセットを操作する際に便利で、異なるボーンを選択している間でも複数ボーンの行を見ることができます。

#### 更新

![](/img/spine-user-guide/dopesheet/lock-refresh.png)

更新ボタンを押すと、現在選択しているボーンの行を表示するようにドープシートが更新されます。これは、一度ドープシートのロックを解除して、再度ロックすることと同じです。

#### 選択

![](/img/spine-user-guide/dopesheet/lock-select.png)

選択ボタンは、現在表示されているすべてのボーン行を元にビューポート内のボーンを選択します。これを利用してロックされているボーンを選択し、選択内容を変更した後、更新をクリックすると、ドープシートに表示されるボーンの行が変更されるので便利です。

## 順番

ボーン行は、ボーンが選択された順にドープシートに表示されます。また、各ボーン行は、上下にドラッグすることで並べ替えることができます。

## 表示状態

 [スキン内に含まれているボーン](/spine-skins#スキンボーン)の行は、該当のスキンがアクティブなときのみ表示されます。 ツリービューの設定の [Hide viewport skin bones(ビューポートのスキンボーンを非表示)](/spine-tree#ビューポートのスキンボーンを非表示)のチェックを外すと、全てのボーン行が表示されます。

また、[スキン内に含まれているアタッチメント](/spine-skins#スキンアタッチメント)のプロパティ行も、 該当のスキンがアクティブなときのみ表示されます。ツリービューの設定の[Show all skin attachments(すべてのスキンアタッチメントを表示)](/spine-tree#すべてのスキンアタッチメントを表示) のチェックを外すと、全てのアタッチメントのプロパティ行が表示されます。

# フィルター

<callout>[同期](#同期)が有効になっていると、フィルターボタンが非表示になります。</callout>

ドープシートをフィルタリングして、選択した種類のプロパティのみを表示することができます。フィルターボタンをクリックして、表示されるプロパティの種類を選択します。フィルターが有効になっている時は、フィルターボタンが赤くなります。

![](/img/spine-user-guide/dopesheet/filter-dopesheet.png)

`ctrl`(Macでは`cmd`)または`shift`またはshiftを押しながら操作すると、複数のフィルターを選択できます。`Reset(リセット)`ボタンを押すと、すべてのフィルターを選択します。

`Current tool(現在のツール)`がアクティブな場合、現在選択中の[トランスフォームツール](/spine-tools#トランスフォームツール)に対応する[ボーンのトランスフォーム](/spine-tools#ボーンのトランスフォーム)プロパティのみが表示されます。

また、フィルターボタンを右クリックすることで、フィルターのオン/オフを切り替えることができます。

# タイムラインポジション

現在のタイムラインポジションは、`Current(現在)`ボタンの横に表示されます。

![](/img/spine-user-guide/dopesheet/current.png)

フレーム番号を入力し、`Enter`または`tab`キーを押すと、現在のタイムラインポジションが設定されます。小数点以下の数字を入力すると、フレームとフレームの間にタイムラインの位置を設定することができます。

[フレームにジャンプ](/spine-settings#Jump-to-frame%28フレームにジャンプ%29)が有効な場合、空白部分をクリックすると、そのフレームにタイムラインの位置が設定されます。

`Current(現在)`ボタンが有効になっていると、再生中にドープシートが自動的に水平方向にスクロールします。これは、アニメーションが長くてキーがドープシートに水平に収まらない場合に便利です。

## ループ

開始フレームまたは終了フレームを設定するには、タイムラインポジションを設定してから`Loop Start(ループスタート)`または`End(エンド)`ボタンをクリックします。また、それぞれのボックスにフレーム番号を入力することもできます。両方を設定して[リピート](/spine-keys#リピート)を有効にすると、指定した開始フレームと終了フレームの間で再生が区切られます。これは再生の繰り返しを制御するだけで、アニメーションごとに保存されるわけではありません。

開始フレームと終了フレームを消去するには、`Loop Start(ループスタート)`または`End(エンド)`を2回クリックするか、テキストボックス内の数字を削除してください。

![](/img/spine-user-guide/dopesheet/looping.png)

# 選択

クリックしてキーを選択できます。[キーにジャンプ](/spine-settings#Jump-to-key%28キーにジャンプ%29)が有効になっている場合、この操作でタイムラインポジションも選択されたキーに設定されます。`ctrl`(Macでは`cmd`)を押しながらクリックすると、選択を切り替えたり、複数のキーを選択することができます。概要行やボーン行でキーを選択すると、その下のキーも選択されます。

キーをクリックしたときにドープシートが[ロックされている](#ロックされている時)と、ビューポートまたはツリー上でそのキーのアイテムが選択されます。これにより、選択されたキーの修正が容易になります。

キーが選択されているときに`ctrl+A`(Macでは`cmd+A`)を押すと、同じ行にあるすべてのキーが選択されます。もう一度押すと、ドープシートに表示されているすべてのキーが選択されます。

ドープシートでキーが選択されると、グラフでも同じキーが選択されます。同様に、グラフでキーが選択されると、ドープシートでもキーが選択されます。

## ボックス選択

空いているスペースでドラッグするとボックス選択になります。`ctrl`(Macでは`cmd`)を押してからドラッグすると、キーの上から始まるボックス選択になります。

![](/img/spine-user-guide/dopesheet/box-select-gif.gif)

ボックス選択状態を残さずにボックス選択をするには、ドラッグしてからマウスボタンを素早く離します。ボックス選択状態を維持したい場合は、ドラッグした後に少しだけ停止してからマウスボタンを離します。この方法では、`ctrl`(Macでは`cmd`)を押しながら操作することで、複数のボックス選択を行うことができます。

![](/img/spine-user-guide/dopesheet/box-select-nobox-gif.gif)

ボックス選択の左端または右端をドラッグすると、選択したキーをスケーリングすることができます。キーをスケーリングすると、選択したキー間のタイミングが増減します。概要行で使用すると、スケーリングによってアニメーション全体のデュレーションを長くしたり短くしたりすることができます。

![](/img/spine-user-guide/dopesheet/scale-gif.gif)

スケーリングする際、左端を右に、右端を左に移動させることで、キーの順番を逆にすることができます。

ボックス選択を作成またはスケーリングする際、`shift`を押したままにすると[フレームスナップ](/spine-keys#フレームスナップ)を無効にすることができます。

# キーの操作について

選択したキーを左右にドラッグすることで、キーが有効になるフレームを変更することができます。`ctrl+shift`(Macでは`cmd+shift`)を押しながらドラッグを開始すると、選択したキーを複製することができます。`shift`を押しながらドラッグすると、[フレームスナップ](/spine-keys#フレームスナップ)が無効になります。

ダブルクリックでキーを削除できます。

## クリップボードボタン

![](/img/spine-user-guide/dopesheet/copy-paste-keys.png)

[クリップボードボタン](/spine-keys#クリップボードボタン)をご覧ください。

## シフト

![](/img/spine-user-guide/dopesheet/key-shift.png)

[シフト](/spine-keys#シフト)をご覧ください。

## オフセット

![](/img/spine-user-guide/dopesheet/key-offset.png)

[オフセット](/spine-keys#オフセット)をご覧ください。

## 調整

![](/img/spine-user-guide/dopesheet/key-adjust.png)

<callout>複数のキーの値を一度に変更するには、[グラフ](/spine-graph)を使った方が簡単な場合があります。</callout>

`Adjust(調整)`は、複数のキーを一度に編集することができます。`Adjust(調整)`を有効にして、`回転`、`トランスレート`、`スケール`、`ポーズ`のいずれかのツールを使ってビューポート内のボーンを操作すると、選択されたすべてのキーが同じ量だけ相対的に調整されます。

例えば、とあるボーンに3つの回転キーがあり、それらの角度は0度、50度、85度になっているとします。ドープシートでこれらのキーを選択し、`Adjust(調整)`を有効にしてから、`回転`回転ツールを使ってボーンを15度回転させます。すると選択されたキーは、それぞれの値に15度が加わって、15度、65度、100度となります。

アニメーション中に複数のキーで定義された動きがある場合、`Adjust(調整)`を使えば、各キーを個別に編集することなく、動き全体を調整することができます。

## 表示内容をキーに記録

![](/img/spine-user-guide/key-frames/key-shown.png)

[表示内容をキーに記録](/spine-keys#表示内容をキーに記録)をご覧ください。

# 同期

![](/img/spine-user-guide/dopesheet/sync.png)

<callout>同じツールバーのボタンの多くがグラフにも用意されているので、`同期`を使用する際には[ツールバーを隠す](#ツールバー)と、スペースを節約できて便利です。</callout>

`Sync(同期)`を有効にすると、ドープシートには[グラフ](/spine-graph)に表示されているカーブの行が表示されるようになります。ドープシートにどの行を表示するかはグラフが制御するので、ロックボタンとフィルターボタンは非表示になります。

また、ドープシートビューがグラフビューの真上または真下にある状態で`同期`が有効な場合、両方のビューのタイムラインのズームレベルが同期され、両方のビューのキーが水平に揃うようになります。これにより、グラフでキーの値を調整しながら、ドープシートでタイミングを調整したり、一度に多くのキーを見ることができます。

# ビュー設定

![](/img/spine-user-guide/dopesheet/view-options.png)

#### ツールバー

`Toolbar(ツールバー)` のチェックを外すと、ドープシートのツールバーが非表示になります。これにより、縦方向のスペースを節約することができるため、[同期](#同期)と一緒によく使用されます。

#### 行

`Rows(行)` のチェックを外すと、ドープシートのツールバーが非表示になります。これにより、横方向のスペースを節約することができるため、[同期](#同期)と一緒によく使用されます。

# ビデオ

[youtube:kDv2hBnenGs&list=PLwGl7Ikd_6GRFo7d0uRu_fN2RIlvkxW7b?modestbranding=1&rel=0]

[次: ゴースト化ビュー](/spine-ghosting)
[前: オーディオビュー](/spine-audio-view)
[Spine ユーザーガイド: 目次]