Skip to content

Latest commit

 

History

History
58 lines (40 loc) · 3.49 KB

File metadata and controls

58 lines (40 loc) · 3.49 KB

photogra-method (フォトグラメソッド)

AppleのObject Capture APIを使用して、動画や写真フォルダからUSDZ 3Dモデルを作成するシンプルなmacOSアプリです。

動画ファイルや写真フォルダをドラッグ&ドロップするだけで、アプリが変換処理を行い、完成した3Dモデルを自動的に開きます。

機能

  • ドラッグ&ドロップインターフェース: 動画ファイル(MOV、MP4、AVI)または写真フォルダをドロップするだけで処理を開始できます。
  • 動画から写真への変換: ffmpegを使用して動画ファイルからフレームを自動的に抽出します。
  • カスタマイズ可能な処理: 以下のオプションで3Dモデルの生成を微調整できます:
    • 動画FPS(静止画枚数 / 秒): 動画から抽出する1秒あたりのフレーム数を設定します(0.1〜60)。
    • モデルの詳細度(解像度): 出力品質を選択します(previewreducedmediumfullraw)。
    • 特徴検出感度(位置推定精度): 特徴検出の感度を調整します(normalhigh)。
    • 画像の順序(画像連続性): 入力画像がsequential(連続)かunordered(順不同)かを指定します。
  • 自動出力: USDZファイルを生成し、完了時に「プレビュー」アプリで自動的に開きます。

必要条件

  • macOS: Monterey (12.1) 以降。
  • Homebrew: macOS用パッケージマネージャー。
  • ffmpeg: 動画と音声を処理するコマンドラインツール。

インストールと使用方法

  1. 依存関係のインストール: ターミナルを開き、Homebrewを使用してffmpegをインストールします。

    brew install ffmpeg
  2. アプリのダウンロード: リポジトリからphotogra-method.appをダウンロードします。

  3. アプリの実行: 動画ファイルまたは写真フォルダをアプリのウィンドウにドラッグ&ドロップします。変換が開始され、完了すると生成された.usdzモデルが開きます。

初回起動に関する注意

初回起動時に、macOSのセキュリティ制限によりアプリが開けない場合があります。これを解決するには:

  1. システム設定プライバシーとセキュリティに移動します。
  2. セキュリティのセクションまで下にスクロールします。
  3. 「photogra-method」がブロックされたというメッセージが表示されるので、**「このまま開く」**をクリックします。

または、アプリアイコンを右クリック(Control+クリック)し、コンテキストメニューから**「開く」**を選択することでも起動できます。

使用技術

このアプリケーションは、RealityKitフレームワークの一部であるAppleのObject Capture APIのラッパーです。SwiftUIで構築されています。

ブログ記事とデモ

プロジェクトの詳細や実際の動作については、以下の記事をご覧ください: