「位相」が実際に意味するもの
何も描かれていない時計の文字盤の上を、他には何も動いていない中で、ゆっくりと針が回っている様子を想像してほしい。針は最初にたまたま指していた向きから回り始める。どの瞬間でも「今どこを指している?」と問うことができ、その誠実な答えはただ1つの数字になる。針が回り始めてから、円周全体のうちどれだけ回ったか、という数字だ。
まだ回っていなければ最初に指していた位置のままで、4分の1回転すれば「ぐるりと4分の1まで来た」ことになり、元の位置まで完全に戻れば「1周した」ことになって、そこからまた0から数え直す。
その1つの数字、何かが1周のうちどれだけ回ったか、これこそが**位相(phase)**が意味するすべてだ。時計そのものとは何の関係もなく、実際に目に見える円とも何の関係もない。繰り返すもの(上下するうねり、ぐるりと回る文字盤、振動する音)であれば何にでも位相がある。「この1回の繰り返しのうち、今どれだけ進んだか」という同じ数字が、ただ違う種類の動きに結びついているだけだ。
波の上を上下に動く点は、その時計の針とまったく同じ回転を、方向ではなく高さとして描き直しているにすぎない。「1回の上下サイクルのうち4分の1まで進んだ」という事実は、針が東を指していても、点が波の頂点に乗っていても、同じ種類の事実だ。位相とは、その事実を書き表すための数字である。
コードや数式ではその数字を「4分の1回転」や「90度」とは書かず、
で書く。これは同じ考え方を別の大きさの目盛りで表したもので、1周は360°ではなく2πラジアンになる。sin(phase)
とcos(phase)は、その「どれだけ回ったか」という数字を読み取り、実際の位置に変換するという仕事だけをする、2つの関数だ。
直感的な理解
((x + shift) / waveLength) * 2 * Math.PIは、足し算、割り算、掛け算が、それ自体では説明のつかない順序で組み合わされた、恣意的な操作の寄せ集めに見える。しかし恣意的ではない。それぞれの部分には特定の役割があり、全体としては名前を持つ標準的な公式であって、アニメーションが見た目よくなるまで数字をいじり続けた一回限りのものではない。
この公式は、ある点が上下に動いて波の形を何度も何度も永遠にトレースするようにするためのものだ。その役割は、天井のない、ずっと上がり続ける値を受け取り、それを波に合わせて上下に し続ける高さへと変換することにある。
その上がり続ける値は仮定の話ではなく、この記事の公式の元になった、波打つローディングインジケーターの実際の1行だ。shiftAnimatable.valueである。これは0からwaveLengthまで数え上がり、0に巻き戻り、また数え上がる、決して止まらないループのアニメーションだ。この値単体では、ただ着実に大きくなっていく数字であり、「上」や「下」という概念が存在すること自体を知らない。この公式は、その1つの上がり続ける数字を、波に合わせた点の実際の高さへと、何度も何度も変換するものだ。
val startPhase = (shiftAnimatable.value / waveLength) * 2 * Math.PI
val startY = center.y - amplitude * sin(startPhase)2つの部分があり、それぞれが「ずっと上がり続けるアニメーションの値」を「位相」に変換する中で、特定の役割を担っている。
startPhaseそのものが位相である。上の時計の針のたとえで出てきた「1周のうちどれだけ回ったか」そのものの数字を、文字盤を回る針ではなくこの波のサイクルに対して測ったものだ。startPhaseがわかれば、sin(startPhase)によって点の高さが正確にわかる。それは針の角度がわかれば、針がどこを指しているか正確にわかるのと同じことだ。startPhaseそのものには、ピクセル単位の位置や時間上の瞬間といった意味は一切なく、純粋に「どれだけ回ったか」だけを表している。2 * PIは単位変換である。時計風の度数をラジアンに置き換えるものだ。shiftAnimatable.value / waveLengthは「このアニメーションが波の1回の繰り返しのうち何割を進んだか」であり、これは「針が文字盤のうち何割を回ったか」と全く同じ問いだ。その割合に2πを掛けることで、sinが期待する実際の角度に変換される。なぜならsinは常に2πごとに1周を完了するものであり、それは時計の文字盤が常に360°ごとに1周を完了するのと同じ、どちらの公式も選べない固定の決まりだからだ。
これで、横方向には決して動かない、波上のある特定の1点についての公式がすべて説明できた。波の上にあるほとんどの点は横方向にも動くため、それが2つ目の要素としてこの同じ合計式に組み込まれることになる。これは後の「他のケース」で扱う。
- →Polar to Cartesian: What cos and sin Are Actually ComputingThe same '2π per cycle' idea, but spent on an angle around a circle instead of a distance along a line.
- →animate*AsState vs Animatable: Animation Is Just an Interpolated ValueWhat shiftAnimatable.value and infiniteRepeatable are actually doing on every frame, underneath this post's formula.
- →Screen Coordinate Systems Aren't Cartesian: Y Points Down, Not UpWhy this post's formula subtracts amplitude * sin(phase) from center.y instead of adding it.
具体例
これは波打つローディングインジケーターの背後にある実際の計算を、位相の数式部分だけに絞ったものだ。位置xも受け取るが、これは上述の2つ目の要素であり、「直感的な理解」の1点だけの公式に合わせて以下では0に固定している。
val waveLength = 46f // px, one full wave repeat
val amplitude = 6f // px
fun heightAt(x: Float, shift: Float): Float {
val phase = ((x + shift) / waveLength) * 2 * Math.PI
return (center.y - amplitude * sin(phase)).toFloat()
}xを0に固定したままshiftを1周分のwaveLengthにわたって動かしてみる。これは波の固定された始点にある点が実際に置かれている状況そのものだ。
heightAt(x = 0f, shift = 0f) // phase = 0 → sin = 0 → center.y
heightAt(x = 0f, shift = 11.5f) // phase = π/2 → sin = 1 → center.y - amplitude (top)
heightAt(x = 0f, shift = 23f) // phase = π → sin = 0 → center.y
heightAt(x = 0f, shift = 34.5f) // phase = 3π/2 → sin = -1 → center.y + amplitude (bottom)
heightAt(x = 0f, shift = 46f) // phase = 2π → sin = 0 → center.y, back to the startshiftが1周分のwaveLength(46px)を進むと、phaseはちょうど1周分の2πを進み、これはちょうどsinの1サイクル、つまり上・中・下・中に対応する。これは偶然ではなく、2πによる変換がまさに担っている1つの役割、「waveLength1つ分の距離」を「sinの1周」に等しくする、という仕事の結果だ。そしてshiftAnimatableは実際にまさにこれを行っており、無限ループで0からwaveLengthまでアニメーションするため、点は永遠にこの同じ上・中・下・中のシーケンスを上下し続ける。
下のスライダーをドラッグして、2つの図が一緒に動く様子を見てほしい。波上の点の高さと、円上にトレースされる点は、どちらも同じphaseから来ており、ただ2つの違う方法で読み取られているだけだ。
phase: 92.6° sin(phase): 1
((0 + 18) / 70) × 2π = 1.6 rad — x 0, shift 18, phase 92.6 degrees, sin of phase 1
他のケース: 横方向にも動く点
「直感的な理解」で紹介した公式は本物だが、それが成り立つのは横方向に決して動かない点に限られる。以下が、位置も含めた実際のコードであり、先ほどの0に固定された点と並べて示す。
val startX = 0f // never moves
val startPhase = ((startX + shiftAnimatable.value) / waveLength) * 2 * Math.PI
val tipX = size.width * progress() // a second point, moves as progress animates
val tipPhase = ((tipX + shiftAnimatable.value) / waveLength) * 2 * Math.PI- 角度になる前に、2つの異なるものがその1つの数字へと合算される。位置(
startXまたはtipX)と、shiftAnimatable.value(独立して永遠にループし続ける アニメーションがどれだけ進んだかという、むしろ経過時間に近いもの)だ。これら2つは、どちらも角度の一部になる前に足し合わされるため、sinが実行される時点では、どの部分が位置由来でどの部分が時間由来かを区別する手段のない、1つの合算された数字を見ているだけになる。 startX = 0fに固定された点は、位相への寄与をshiftAnimatable.valueからしか受け取らず、その点自身の項は永久にゼロのままで、「直感的な理解」で紹介した簡略化された公式とまったく同じになる。だからこそ、横方向には一切動かないにもかかわらずこの点は上下する。xに関しては何も変化していないのに点は上下しており、それは100%shiftAnimatable.valueの上昇によるものだ。tipXにある点は両方の項から位相への寄与を受け取る。progressが上昇するにつれてx座標が変化し、その下ではまったく同じshiftAnimatable.valueの上昇も重なっている。仕組みは同じだが、今回は動く入力が1つではなく2つになっているだけだ。
同じ関数、同じ公式であり、2つの点の間で変わるのは、どちらの引数が動く値でどちらが定数か、という点だけだ。
その根本原理
これは進行波の位相の公式であり、物理学ではφ(x, t) = k(x + vt)という形で書かれる同じものだ。ここでk = 2π / wavelengthは波数であり、距離をラジアンに変換する固定の変換係数である。位置と経過時間は2つの独立した入力であり、振動する関数(sin、cos、あるいは周期的な関数なら何でも)が実行される前に、1つの数字である位相へと合算される。その振動を担う関数には、2つの寄与を後から分離する手段はなく、そもそもその必要もない。関数が消費するのは常にその合計値だけだ。
他の場所で: 同じ根本原理、違うフレームワーク
- フラグメントシェーダー(GLSL): 水面や旗のうねり効果は、ほぼ常に
sin(uv.x * frequency + time * speed)という形をしている。uv.xが位置の項、time * speedが経過時間の項であり、これらがsinの前に足し合わされる。これはまさにこの記事の公式であり、frequencyが2π / waveLengthの役割を果たしている。 - オーディオ合成: デジタルオシレーターは各サンプルごとに
sin(2 * PI * frequency * sampleIndex / sampleRate + phaseOffset)を計算する。sampleIndex / sampleRateは秒単位の経過時間であり、frequencyはここでの1 / waveLengthと同じ役割を果たし、phaseOffsetは時間も位置もまったく結びついていない、純粋な位相シフトの項である。 - 物理学、本来の出典: 進行波の方程式
y(x, t) = A·sin(kx - ωt)は、この記事がずっと使ってきた公式そのものである。k = 2π/λ(波数)はここでの2π / waveLengthの役割を果たし、xは位置、tは時間だ。正準形では時間の項を引くが、この記事のコードでは代わりに足している。考え方は同じで符号が逆であり、これはちょうど以下で扱う進行方向のエッジケースに対応する。
エッジケース
2πを省略する、あるいは間違った定数を使う。 sin(distance / waveLength)はそれでもコンパイルは通り、それでも振動はするが、waveLengthピクセルごとではなく2π * waveLengthピクセルごとに1サイクルを完了するようになる。何もクラッシュしないが、波はコードの他の部分が前提としているwaveLengthという定数と、何も言わずに合わなくなっていく。
位置の項と時間の項の符号を入れ替える。 x + shift
とx - shiftは、どちらも1つの瞬間を凍結して見れば完全に同じように振動する。その違いが現れるのは時間が経ってからだけだ。+shiftはshiftが増えるにつれて波のパターンが片方向にスライドしているように見え、-shiftは逆方向にスライドする。符号を間違えても形は壊れず、進行方向が反転するだけなので、これはスクリーンショットでは見えず、実際にアニメーションを見て初めて現れるバグだ。
waveLengthとアニメーションの持続時間を混同する。 waveLengthは
距離(1回の繰り返しあたりのピクセル数)であり、shiftAnimatableアニメーションのdurationMillisは
持続時間(1回の繰り返しあたりのミリ秒数)である。実際のコードでWaveSpeedを変更すると変わるのはdurationMillisだけなので、波のスクロールは速くなったり遅くなったりするが、waveLengthは固定のままなので、画面上の波の実際の形(高さ、密度)は変わらない。速度と形は、たまたま同じphaseの公式に入力される、無関係な2つの定数によって制御されている。
どこで使うべきか
繰り返されるパターン自体も動いているように見せる必要がある場面全般で使える。
- スクロールする波やうねりの効果。ローディングインジケーター、水面シェーダー、オーディオの波形ビジュアライザーなど、ある形が空間方向に振動しつつ同時に時間とともにスクロールする必要がある場面すべて。
- 同じ波に乗った複数のマーカー。ある1点の高さが
heightAt(x, shift)で表せるようになれば、N個のマーカーを配置するのは、上記のtip/startの点のペアとまったく同じように、同じ関数をN個の異なるx値で呼び出すだけになる。 - 個別に調整可能な、独立した「空間周波数」と「時間的な速度」を持つもの全般。ここでの
waveLengthとdurationMillisがそれにあたる。これらは同じものの別名ではなく、本当に2つの異なる定数だからだ。
これが適切な根本原理ではないことを示すサインは、入力が1つしかない場合(時間だけ、あるいは位置だけで、両方が足し合わされることがない場合)だ。その場合は進行波の「進行」の部分が存在しないので、animateFloatを直接sinに渡すだけの単純な実装で十分にカバーできる。
位相は単体での時間でも位置でもなく、sinに渡される前に合算されるものであり、2πは単に、1サイクルをsinが理解できる唯一の単位にその合計を揃えるための単位にすぎない。



