ObjectCaptureの使い方

なんとAppleから Object Capture というフォトグラメトリが可能なAPIが発表されました。
写真を読み込ませるとUSDZ形式のモデルが生成されます。
写真枚数制限もなく利用することが出来ます。

詳しくはこちら

というわけで、Appleが公開しているサンプルの使用手順を以下にまとめました。
コンソールを使ったコマンドラインによるものですが、コマンドラインを使ったこと無い人でも試せるよう詳しめに書いてみました。

環境

macOS：12.0(Monteley) 以上
Xcode：13.0 以上

手順

ここからサンプルApp「Creating a Photogrammetry Command-Line App」をDLする。

ダウンロードしたPhotogrammetry Command-Line Appのzipを解凍する。

HelloPhotogrammetry.xcodeprojをXcodeで開く。

Appleのアカウントを指定する。

ビルドする。
(左上の再生マークを押す)

「Cloudn’t get the list of tags:」エラーが出る場合

fatal: bad numeric config value ‘null’ for ‘tag.forcesignannotated’: invalid unit

対処法：
別バージョンのXcodeが入っている場合は削除する
参考記事：https://developer.apple.com/forums/thread/682556

ビルドが完了するとProductsにHelloPhotogrammetryが生成されている。

デフォルト設定の場合、Finder上ではここに生成されます。

コマンドラインで生成

あとはコマンドを実行で生成出来ます。

OVERVIEW: Reconstructs 3D USDZ model from a folder of images.

USAGE: hello-photogrammetry &lt;input-folder&gt; &lt;output-filename&gt; [--detail &lt;detail&gt;] [--sample-overlap &lt;sample-overlap&gt;] [--sample-ordering &lt;sample-ordering&gt;] [--feature-sensitivity &lt;feature-sensitivity&gt;]

ARGUMENTS:
&lt;input-folder&gt; The local input file folder of images.
&lt;output-filename&gt; Full path to the USDZ output file.

OPTIONS:
-d, --detail &lt;detail&gt; detail {preview, reduced, medium, full, raw} Detail of output model in terms of mesh size and texture size . (default: nil)
-l, --sample-overlap &lt;sample-overlap&gt;
sampleOverlap {normal, low} It should be set to `low` if there is low overlap between images captured nearby in space.
-o, --sample-ordering &lt;sample-ordering&gt;
sampleOrdering {unordered, sequential} Setting to sequential may speed up computation if images are captured in a spatially sequential
pattern.
-f, --feature-sensitivity &lt;feature-sensitivity&gt;
featureSensitivity {normal, high} Set to high if the scanned object does not contain a lot of discernible structures, edges or textures.
-h, --help Show help information.

コマンド例

デスクトップに「ObjectCapture」フォルダを作成し、
その直下に「HelloPhotogrammetry」ファイル、
写真格納用の「Images」フォルダ、
生成後のモデルを入れる「Models」フォルダを用意し、
フルの精度で生成する場合はー

以下のようなコマンドになります。

/Users/ryo/Desktop/ObjectCapture/HelloPhotogrammetry /Users/ryo/Desktop/ObjectCapture/Images /Users/ryo/Desktop/ObjectCapture/Models/Model.usdz -d full