c6fd71241d
* docs: add user docs for PhotoCraft Adds docs/user/ (published at getartcraft.com/docs/photocraft), the docs check and publish workflows (copied from craft-launcher), and a User docs rule in AGENTS.md. Checker: 0 error(s), 0 warning(s). Source notes per page: - index.md: README (intro, status, Crafting Apps table), website crafting-apps.ts photocraft entry, links.rs (Discord, issues), menus.rs (Help > Report an Issue). - getting-started/index.md: menus.rs and menu_catalog.rs labels, panels.rs (Layers, Properties, History), dialogs.rs (Create button). - getting-started/install.md: README Downloads and Get started sections, gh release view v0.7.0 asset list, craft-launcher catalog.rs (lists PhotoCraft). - guides/open-and-save-files.md: apps/photocraft/src/services.rs (open and save filters), README Formats and PSD sections, docs/file-format-parity.md. - guides/adjust-colors-with-adjustment-layers.md: menu_catalog.rs, panels.rs (footer button, adjustment list), lib.rs (Properties shows new layer). - guides/select-and-mask.md: menu_catalog.rs Select and Layer Mask menus, state.rs tool names, retouch_ui.rs (Select Subject button and message). - guides/add-and-style-text.md: state.rs (Horizontal Type Tool, T), type_tool.rs, menu_catalog.rs Layer Style and Type menus, dialogs.rs. - guides/export-an-image.md: export_dialog.rs (labels, formats, options). - troubleshooting/taskbar-turns-black.md: issues 3550, 3864, 3430, 3144, PR 3308 (git: not an ancestor of v0.7.0), prefs_ui.rs (System title bar). - troubleshooting/text-moves-when-editing.md: issues 3795, 1317, PR 3819 (open). - troubleshooting/get-help.md: menus.rs, links.rs, gpu_status.rs (System Info content). - faq/*: README (status, license badge, offline, formats), LICENSE-MIT and LICENSE-APACHE, docs/file-format-parity.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(user): apply final review fixes Part 1: verified = latest release tag policy in docs/user/AGENTS.md; released-pages sentence in root AGENTS.md. Part 4 items 1-9: remove x86 row and TGA resolution, formats, new photocraft-does-not-start page, mask label, taskbar workaround, wording, Affinity read-only, index. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(user): use the standard section title Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(user): describe PhotoCraft 0.7.0 startup behaviour Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(user): tighten PhotoCraft startup wording Drop the unsourced "slower" claim for CPU mode and give the exact Preferences path on Windows and macOS. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs: pin the docs checker to a commit and its SHA-256 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs: drop the docs workflows until the checker is on artcraft-services main Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs: re-verify against 0.8.2 - taskbar and PSD text pages: both fixes ship in 0.8.2; tell users to update and drop the "not in a release yet" wording and workarounds - does not start: 0.8.2 fixes the Intel Iris Pro/Monterey Device(Lost) case; OpenCore Legacy Patcher Macs still have no fix - install: Windows 10 or later, 32-bit Windows builds, RISC-V deb/rpm, Wayland paste and XWayland notice - open and save: Krita and Paint.NET filters, Krita/PCX/FITS formats, save progress, JPEG/WebP encoding kept on Save - export: TGA Resolution, multi-layer Export As and Quick Export - text: Shift-click starts new text over existing type - CLAUDE.md is now a regular file pointing to AGENTS.md - verified: 0.8.2 on every page Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Drop the root AGENTS.md docs rule; keep the PR to docs/user/ Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(user): drop the stale missing-tools count from the Photoshop FAQ Re-verified the page against v0.9.0. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Fabio Lussi <198260595+itrycodinganditsbad@users.noreply.github.com> Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
4.6 KiB
title, description, order, verified
| title | description | order | verified |
|---|---|---|---|
| PhotoCraft does not start | PhotoCraft closes or crashes at startup on Windows PCs with Intel graphics (it uses DirectX 12 and picks a safer graphics mode after a crash) or on older Intel Macs (0.8.2 fixes one cause; no fix yet for Macs patched with OpenCore Legacy Patcher). | 30 | 0.8.2 |
On Windows, PhotoCraft starts Intel graphics on DirectX 12. If PhotoCraft closed while it was starting, start it again: it picks a safer graphics mode after a crash. On an older Intel Mac that shows a Device(Lost) error, update to 0.8.2, which fixes one cause; on Macs patched with OpenCore Legacy Patcher there is no fix yet.
Symptoms
- Windows with Intel graphics (for example Intel UHD Graphics 630): PhotoCraft closes or crashes right after you start it. Windows Event Viewer shows an application error in
igvk64.dllwith exception0xc0000005(issue 2320, issue 4). - Intel Mac: the app icon bounces in the Dock and the app disappears. Started from Terminal, it prints
Error: Wgpu(RequestDeviceError(RequestDeviceError { inner: Core(Device(Lost)) }))(issue 1859).
Fix
Windows
- Use PhotoCraft 0.7.0 or later. Older builds do not have the steps below.
- Start PhotoCraft again. Double-clicking its icon or a
.pcraftfile works. PhotoCraft notes that the last start did not finish and uses the next safer graphics mode this time:- A start on Vulkan is followed by one on DirectX 12.
- A start on DirectX 12 is followed by one on the CPU. The CPU mode does not depend on the graphics driver.
- If it started, nothing more to do. PhotoCraft remembers the mode that worked. You can see or reset it under Edit › Preferences › Performance… (on macOS, PhotoCraft › Settings › Performance…).
If PhotoCraft still closes on every start, force DirectX 12 from PowerShell:
-
Open PowerShell in the folder that contains
photocraft.exe. -
Run these three lines:
$env:WGPU_BACKEND = "dx12" & .\photocraft.exe Remove-Item Env:WGPU_BACKEND
The last line clears the setting so later launches use the default again. You need the first two lines each time you start PhotoCraft this way. While WGPU_BACKEND is set, PhotoCraft uses it and does not step down to a safer mode by itself (issue 2320).
Intel Mac
- Update to PhotoCraft 0.8.2 or later. On Intel Macs it skips a set of graphics checks that macOS could not compile on older Intel graphics, such as Intel Iris Pro on macOS Monterey (issue 3107).
- Start PhotoCraft again.
If it still fails, there is no fix yet. This is the case reported on Macs patched with OpenCore Legacy Patcher, where setting WGPU_BACKEND, --safe-gpu and PHOTOCRAFT_CPU_CANVAS=1 did not change the error (issue 1859). Add your Mac model, macOS version and PhotoCraft version to that issue.
Why this happens
On Windows, PhotoCraft draws with your graphics driver. Intel's Vulkan driver (igvk64.dll) crashed PhotoCraft on a UHD 630 PC with PhotoCraft 0.6.0, and the DirectX 12 setting above avoided the crash (issue 2320). Since 0.7.0 PhotoCraft prefers DirectX 12 on Intel graphics. Before it opens the window, it writes a small file called gpu-starting.json in its settings folder and deletes it once the first frames are drawn. A start that crashed leaves the file behind, and the next start reads it and moves to the next safer mode.
Still stuck?
See Get help with a problem. Say which graphics card you have, which PhotoCraft version you use and how you started it. Add one of these:
-
If you can open PhotoCraft: the text from Help › System Info….
-
If PhotoCraft does not open at all: the log file
photocraft.log, plus the faulting module and exception code from Event Viewer on Windows. PhotoCraft keeps it in alogsfolder inside its settings folder:- Windows:
%APPDATA%\Photocraft\logs\photocraft.log - macOS:
~/Library/Application Support/Photocraft/logs/photocraft.log - Linux:
~/.config/photocraft/logs/photocraft.log - Portable copy (a
portable.txtfile next to the program): thePhotoCraftData\logsfolder next to the program.
Every start moves the previous log to
photocraft.1.log. If you already started PhotoCraft again after the crash, attachphotocraft.1.logtoo, because it holds the run that crashed. - Windows: