始める・インストール 10分
PhotoCraft が開かないとき
起動の失敗の多くは、壊れたエディタではなく、間違ったファイルです。二度目の再インストールの前に、ファイル名をマシンと照合してください。
実行したのがアプリかを確認する
Source code の zip と photocraft-web-<ver>.zip は、それだけではデスクトップのウィンドウを起動しません。web の zip はホストするためのサイトで、ブラウザの PhotoCraft で扱います。デスクトップの名前は、MSI、ポータブルの zip、DMG、AppImage、Flatpak、deb、rpm、そして ダウンロードする PhotoCraft のファイル にある各プラットフォームの tar 書庫です。
ARM の Windows PC には arm64 ビルドが必要です。Intel または AMD の PC には x64 が必要です。製品ページの v0.23.1 の資産一覧には、32ビットの Windows インストーラはありませんでした。Mac は、Apple silicon と Intel の両方に、ユニバーサルの DMG を使います。
グラフィックスと Wayland
README は、Metal、Vulkan、DirectX 12、WebGPU の上の GPU コンポジタを説明しています。同じインストーラをもう一つ取るより、その経路の現行ドライバの方が重要です。Mac ではキャンバスが Metal を使います。Windows は DirectX 12 か Vulkan を求めます。Linux は Vulkan を求めます。
Wayland のセッションでは、README によれば、ウィンドウにドロップしたファイルはまだ開きません。ファイルを選んでから開くか、画像をコピーして貼り付けてください。ドラッグアンドドロップは XWayland の下では動作し、README はそのために WAYLAND_DISPLAY を消す方法を示しています。XWayland で表示倍率を分数にすると、ぼやけて見えることがあります。ネイティブの Wayland は鮮明なままですが、ドロップの制限は残ります。
本物のビルドでも失敗するとき
PhotoCraft は早期アルファです。正しいインストーラでのクラッシュは不具合であり、第三者のミラーをダウンロードして解くパズルではありません。README は、報告するときに、オペレーティングシステム、文書のサイズ、レイヤー数、スクリーンショットを求めています。
リポジトリ か Discord で報告してください。ウィンドウが開いてから閉じる、ステータスバーが CPU rendering と表示する、またはメモリを理由にファイルを拒否するときは、その手順が ウィンドウが閉じるとき、またはキャンバスが遅いとき です。やり直せない仕事にアルファ版が使えると決める前に、早期アルファが意味すること を読んでください。
クラッシュと呼ぶ前に、インストールそのものを確認する
一度も現れないウィンドウは、しばしば間違った成果物です。ソースコードの zip は、エディタを起動しません。web の zip はホストする必要があり、それが ブラウザの PhotoCraft です。デスクトップの経路は、ダウンロードする PhotoCraft のファイル にあるものです。Windows では、ユーザーごとのインストールは管理者を要らず、Everyone on this computer は要ります。インストール済みのコピーは一つだけ許されるので、その二つのあいだの途中まで終わった切り替えは、削除しなかった方のコピーを残します。ポータブルビルドは、zip の中の exe で、その横に PhotoCraftData があります。Mac では、アプリはユニバーサルイメージから Applications へドラッグしたものです。Linux では、起動するファイルが AppImage でなければなりません。ダウンロードして一度もインストールしていない deb は、今もただのファイルです。起動する Flatpak は、flatpak install --user のあと、flatpak run ai.storyteller.photocraft です。FreeBSD では、tarball は、インストールガイドが列挙するライブラリとともに /usr/local の下に属します。
インストールガイドは、今も 32 ビットの Windows のファイル名を印刷しています。v0.23.1 の製品ページの資産には、それらは含まれていませんでした。x86 の MSI を出す古いブログは、開いているリリースより新しい出典ではありません。Gentoo のコミュニティのオーバーレイは、任意のパッケージングで、PhotoCraft チームは保守していません。これらのインストールの形の出典のページは インストールと更新 です。
助けが必要な起動のためのフラグ
ほとんどの人は、起動フラグを必要としません。コマンドラインにファイル名を一つ以上渡せば、PhotoCraft はそれらを開きます。Windows と Linux では、PhotoCraft がすでに動いているあいだに開くファイルは、そのコピーの中の新しいタブになります。別のコピーが欲しいときは、--new-instance を加えてください。タブではなく、今も新しいウィンドウが見える人もいます。その報告は未解決で、他の未解決の問題とともに ウィンドウが閉じるとき、またはキャンバスが遅いとき に挙げられています。
--safe-gpu は、その一回の起動を CPU のレンダラで始めます。--in-window-menus は、Mac で、システムのメニューバーの代わりに、ウィンドウの中へメニューを残します。--present-mode は fifo、autovsync、または novsync を取り、--frame-latency は 1、2、または 3 を取ります。その二つは、フレームが画面へどう届くかを変えます。PHOTOCRAFT_CONFIG_DIR は、PhotoCraft の設定を、選んだフォルダへ向けます。ポータブル型の設定ディレクトリを、既定の場所に置きたくないときに役立ちます。photocraft --help が、その一式を印刷します。フラグなしで起きるグラフィックスのフォールバック、Windows では Vulkan、次に DirectX 12、次に CPU というのは、ウィンドウが閉じるとき、またはキャンバスが遅いとき のより長い話です。
アンインストールしても、画像は削除されません。Windows は Settings、次に Apps からアプリを削除します。ポータブルの zip は、そのフォルダを削除して取り除きます。macOS は、PhotoCraft を Applications からゴミ箱へ移します。Linux は、パッケージマネージャ、flatpak uninstall ai.storyteller.photocraft を使うか、AppImage か展開した tarball を削除します。設定フォルダを削除するまで、設定は残ります。正しいインストールのあとでも本物のビルドが閉じるなら、オペレーティングシステム、文書のサイズ、レイヤー数、スクリーンショットを添えて報告してください。開いたあと、アルファ版が適切な道具かは 早期アルファが意味すること です。