手元の動画素材をつなぎ、地図・高度・推定した移動速度・コメントを添えて、旅を伝える。素材の撮影時刻とGPX（時刻付きの経路ファイル）の対応を活かす編集ツールの設計です。
私が道具を作る中で直面した課題と、対応策・理由を載せています。必要なら、その内容をもとに自分の道具をAIと作るための設計と指示を使えます。
並べた後の再生位置から、その素材が撮られた時刻へ戻る。そこからGPXを参照し、場面に合う地図や数値を表示する設計です。
設計の模式図です。時刻と場面は例示です。
並べ替えても、撮影時刻はそのまま。作品の再生位置から、その場面のGPXへ。
以下は私がCut/Editを作る中で直面した課題です。どの操作で困り、何を変え、なぜその方法を選んだかを示します。自分のカメラや素材に合う道具を作るときは、必要な課題から条件を選べます。
写真と動画では撮影日時の保存場所が違い、写真に書かれた現地日時をどの地域の時計として読むかも問題になります。
Cut出力の開始日時にはすでに時計補正が含まれています。原本用の補正をもう一度足すと、GPXやMarkへの対応がずれます。
Cutの保存範囲が希望範囲より広がった場合、そのMP4を全部使うと不要な前後も作品へ入ります。
主映像の前を切ったり途中で分けたりすると、その場面に添えた字幕や動きの開始位置も扱い直す必要があります。
音声やBGMを同時に使うと、声のある区間だけ音楽を下げたい場合があります。
映像内の見せたくない部分をぼかす際、そこへ重ねた写真や文字を同じようにぼかしたいとは限りません。
保存したタイトルを別作品にも使うとき、元の雛形の変更を、すでに配置した表示へ反映したいとは限りません。
長い測位の空白を一直線で結ぶと、その道を実際に通ったと読めてしまいます。
同時に複数作品を作る場合、素材の選択、変更履歴、復旧用の保存は作品ごとに持つ必要があります。
完成動画の保存先にすでに同名の動画がある場合や、途中で出力を取り消す場合があります。
場面の端を別の場面の開始へ合わせる際、時間の許容差が固定だと、拡大率で操作の感じが変わります。
コメントの瞬間を確認したいだけなのに、作品の再生位置や選択が移ると元の作業へ戻りにくくなります。
手元の動画を作品にまとめたいときに使う道具の設計です。
素材を並べ、撮影時刻とGPXを活かす表示を添えます。
素材を並べて、前後を調整。編集の再生位置と元の撮影時刻を分けて扱い、順番を変えても記録への対応を保ちます。
地図・高度・移動速度（推定）・Markコメントを、追加して調整できるオブジェクトに。素材にGPSがなくても、GPXの時刻から参照します。
素材と編集範囲、GPX参照、追加した表示をProject（素材の参照と編集状態）へ。保存・再読込後も、同じ場面と記録を扱えることを検証します。
ここに書くのは、AIと自分用の道具を作るための設計案です。完成アプリの機能一覧ではありません。「守る要件」はこの設計の中心となる動作と、記録を壊さず対応を保つ条件です。「便利機能の提案」は必要なものを選ぶ候補で、全部を実装する条件ではありません。実装言語や映像処理の方式は指定しません。
撮影した場面と経路・Markを対応させるには、時刻の意味と参照元を残す必要があります。UTCで日時を比べることや、秒数を整数の組で保存することは一般的な方法です。Vromaのファイルと連携するときだけ、下の独自形式も使います。
GPXは経路を保存する標準形式です。VromaはGPX 1.1を使います。Topografixの公式仕様 ↗に形式の定義があります。動画との対応には、位置だけでなく観測日時のある点が必要です。
Markは瞬間の日時とコメントです。Vromaでは同じフォルダの「旅.gpx」と「旅.marks.csv」のように名前を対応させます。動画をこのフォルダへ移す必要はありません。
動画のある瞬間の日時は、カメラが記録した開始日時に、時計の補正秒数と動画内の位置を足して求めます。カメラが2秒遅れていたなら＋2秒です。表示を日本時間から別地域へ変えても、同じ瞬間を表す日時そのものは動かしません。
補正を適用済みの切り出し動画へ、同じ補正をもう一度足してはいけません。開始日時が読めない素材は不明と示し、名前やコピー日から撮影日時を決めません。
切り出しや作品編集は動画原本を変更せず、使用した範囲や追加表示を別に保存します。短い素材の0秒が原本の何秒目かを残せば、同じMarkと場所へ戻れます。
コメント編集は、自分の道具で必要な場合に採用します。採用する場合は、読み込んだMarkの参照元を追跡し、利用者が入力した変更だけを保存します。別端末の変更と競合したら勝手に上書きせず、両方を残して確認します。参照するだけで記録を書き換えません。保存はボタンでも自動保存でも構いませんが、その動きを利用者へ示します。
UTF-8、ヘッダーなしの3列です。第1列はUTCのISO 8601日時、第2列は時差付きの現地日時、第3列はコメント。小数秒を残し、カンマ・引用符・改行のあるコメントはCSVの引用で保存します。時刻を比べるときは第1列を使います。第2列は同じ瞬間の表示であり、別の時計補正ではありません。
このCSVにID列はありません。読み込む側が識別値を作ります。Cutは解析した日時の秒数とコメント、Editは第1列の日時文字列とコメントを使うため、両者のIDは常に同じとは限りません。IDは読み込み後のProjectや出力の対応情報に現れます。同じ瞬間を照合するため、参照元・日時・コメントも残します。出力にIDが付いている場合はその値を引き継ぎます。
補正を保存するのはStudioです。選んだ動画の場面をMarkの日時へ合わせて補正秒数を保存し、Cut/Editはこのファイルを読み込んで利用します。通常の保存先は動画フォルダで、別の場所なら利用者が明示的に読み込みます。
schemaVersion: 1のentriesに、対象のsource、補正秒数seconds、任意の表示名cameraNameを保存します。sourceは末尾の名前filename、バイト数size、補正前の開始日時cameraStart、秒単位の長さdurationです。cameraStartの数値は1970-01-01 UTCからのUnix秒です。
名前とサイズは一致、開始日時の差は1ms未満、長さの差は0.25秒以内のときだけ補正を使います。改名するとこの一致を失います。これは時計差を自動測定する処理でも、動画の全内容を比較する処理でもありません。Studioには内部日時が読めないときにファイルの作成日時を使う経路があります。Cutでも利用者が選択した場合にファイルの作成日時を使えます。使用する日時やコピー後のファイル日時によって、アプリ間で開始日時が一致しない場合があります。形式不正や曖昧な一致はエラーにします。
既存Cutの出力形式と連携するときは、MP4とこの対応ファイルを同じ出力フォルダに残します。CutはschemaVersion: 1を書き、Editは1と2を読みます。clipsのoutputFileが出力名、creationDateが出力の最初の実フレームに対応する補正後の撮影日時です。原本の開始日時や希望した開始日時とは限りません。
requestedは希望した範囲、actualは再生できる境界へ広げた実際の範囲です。どちらも切り出す前の原本、またはまとめた録画内の位置であり、出力の0秒を基準にした範囲ではありません。整数valueを時間単位timescaleで割ると秒になります。Editは両範囲の差から、出力内で希望部分が始まる位置を求めます。
この対応ファイルの数値日時は2001-01-01 UTCを基準にした秒数で、VromaMedia.jsonのUnix秒とは基準が違います。EditにはISO 8601文字列を読む経路もあります。表示用タイムゾーンを変えても絶対日時へ再び時差を足しません。
任意のmarksには識別値id、UTCのISO 8601日時date、comment、出力動画内の秒位置sourceTimeがあります。Mark情報のない出力は元のGPXとMark CSVを併用します。自分の道具が既存Cut/Editと連携しない場合、同じ形式を採用することは必須ではありません。
Vromaの停止拡張は、OSが確認した有限の停止区間を、すでにある実測点に添えるものです。観測していない時刻に新しい位置の点を追加するための形式ではありません。通常のGPX二点の近さから停止を推定する方法とは区別します。
実測点のtrkptの直下にあるextensionsへ、名前空間https://www.tsuyukimakoto.com/xmlns/vroma/gpx/1のstationary要素を一つ置きます。開始fromと終了untilはその要素の属性で、現行の書出しは小数秒付きのUTC ISO 8601日時です。たとえば<vroma:stationary from="2026-10-07T01:00:00.000Z" until="2026-10-07T01:02:00.000Z" />です。vromaの接頭辞は上の名前空間へ宣言します。実測点の時刻≦from＜untilを満たし、次の観測があればそこまでに制限し、終了時刻自体は区間へ含めません。接頭辞のつづりでなく名前空間と要素名で読み、不正・重複の宣言を停止の根拠にしません。推定値を観測点としてGPXへ書き戻しません。
まず、このページのURLをAIへ渡し、課題・対応策・理由と設計条件を読んでもらいます。目的と、記録のコピーを読める場所や方法を添えてください。AIがURLを取得できない場合は、本文をコピーして渡せます。
ローカル表示です。変更後の本文はまだ公開されていません。AIへ渡す場合は本文コピーを使ってください。
下の指示は相談の始め方です。URLが読めないときは「課題と設計の本文をコピー」で本文も渡してください。
次の課題・対応策・理由と設計条件を参考に、私のカメラ・素材・作業環境に合う自分用の道具を作ってください。 https://www.tsuyukimakoto.com/products/vroma/edit/ URLを取得できない場合は、私が渡す本文を使ってください。既存の対応策は作者の実装例なので、同じ言語や映像処理方式を必須にせず、選ぶ方法と理由を説明してください。 作りたい道具と用途：［指定］ カメラ・素材形式・OSと作業環境：［指定］ 使う素材・作品の目的・並び・添える表示：［指定］ 記録のコピーの保存場所と、AIが読める方法：［指定］ 既存Cut/Edit出力との互換性：［必要な場合だけ指定。通常は前提にしない］ まず課題から必要な条件を整理し、未知の条件は推測せず示してください。設計と実装、小さなコピーでの確認を進めてください。 動画原本を変更しないでください。コメント編集は必要な場合に採用し、採用する場合は参照元を追跡して利用者が入力した変更を保存し、同時変更を勝手に上書きしないでください。UTC比較は一般の時刻処理、Vroma独自形式は選んだ連携に応じて使ってください。 同じMarkと場面、時計補正、欠測、並べ替え・トリム後の撮影時刻、編集状態の保存と再読込を確認してください。実装したこと、未対応条件、確認結果を分けて示してください。
課題と対応策は全項目の一覧でも読めます。本文コピーはこのページの掲載範囲です。全一覧も使う場合は、そのURLか本文を併せて渡してください。
原本は保存したまま、小さな範囲のコピーから。
使えることと、まだ扱えないことを確かめます。
| 確認すること | 自分の記録で見る結果 |
|---|---|
| 同じMark、同じ場面 | 自分のMarkが元の動画のどの場面かを確認する。時計差の補正やトリム・並べ替えの後も、同じ撮影時刻とGPXへの対応が保たれている。 |
| 動画にGPSがない | 位置や高度を持たない自分の動画でも、撮影時刻から持ち帰ったGPXを参照できる。時刻が読み取れない場合は、推測で埋めずに示す。 |
| 原本と、作品の出力 | 原本を残してコピーで確認する。作品の素材・使用区間・並び・追加した表示と音声を再生して確認する。GPX欠測や範囲外は不明として扱う。 |
| 編集状態を保存して続きを作る | 保存・再読込後も素材とMarkの対応が保たれている。素材を並べ替えても撮影時刻、GPX参照と追加した表示が保たれている。 |
| コメント編集を採用する場合の保存と同時変更 | コメント編集を採用する場合に確認する。参照するだけでは記録が変わらず、入力した変更は示された保存方式で指定の参照元へ反映される。別端末と同じMarkを違う文へ直した場合は上書きを止め、両方の内容を確認できる。 |
手元の写真や動画を見返すならChrova。好きな場面だけを切り出したいときはCutの設計を読めます。