createImageBitmap Unavailable? Troubleshoot by Platform & Environment

What You See

Any3D shows the message: "Your browser does not support createImageBitmap." This is one of the three Worker path components used to efficiently decode image pixels in the background. Without it, workflows like texture compression and image-to-model conversion cannot complete the full Worker path, and large files are more likely to stutter.

Common Causes

Cause	Typical Scenario
Old browser / WebView	Outdated Android WebView, in-app embedded pages
Non-secure context	HTTP sites (non-localhost), file://
Cross-origin resource issues	Enterprise CDN/CORS causing image decode failure (functional)
Memory / tab limits	Low-memory mobile devices, enterprise "single tab" policy
Extension interference	Privacy plugins modifying Image API behavior

Platform‑Specific Troubleshooting

Windows / macOS (Desktop)

1. Use the latest stable version of Chrome / Edge / Firefox / Safari.
2. Always open Any3D via HTTPS.
3. If you have Screen Time (macOS) or Microsoft Family Safety (Windows) enabled, they may restrict downloads or media access, affecting large image decoding. Test with a different admin account.
4. Remote Desktop: Very high‑resolution textures may fail to decode in a weak GPU environment. First test with a small image.

Linux

1. Update Chrome or Firefox. Under Wayland, if GPU decoding behaves oddly, try an X11 session (rare).

iOS / iPadOS

1. Safari 14+ supports it well; keep iOS updated.
2. In‑app browsers (e.g., Facebook Messenger, Gmail) often lag behind → open in Safari.
3. iCloud Private Relay / Limit Adult Content generally do not block createImageBitmap, but they may block cross‑origin image hosts. Ensure your model textures are same‑origin or accessible.

Android

1. Update Chrome and Android System WebView (Settings → Apps → Show system apps).
2. If using a Chinese browser in compatibility mode, switch to Chrome.
3. Digital Wellbeing / Family Link restrictions on background activity do not directly affect the API, but may prevent large file uploads.

Network, VPN, and Corporate Intranet

Scenario	Description
Corporate VPN	If model textures are served via an internal CDN, CORS or certificate errors may cause decode failure—check the Console for network errors
Transparent proxy	If it modifies or corrupts image responses, createImageBitmap may reject
Internal HTTP only	Non‑secure context → API may be unavailable or behavior limited
Zero Trust / SSL inspection	Self‑signed certs must be trusted; otherwise resource loading fails

Recommendation: Disconnect VPN, switch to a hotspot, and test with a pure geometry model (no external textures). If pure geometry works but textured models fail, investigate network / CORS first.

Enterprise Policies & Parental Controls

• Intune App Protection may restrict "Save As" / Download, indirectly affecting the image selection flow, but the API itself should still exist—use the Console to differentiate.
• Managed school iPads: Disabling the "Files" app does not affect the API, but it changes how you upload. Use an alternative upload channel.
• Router parental control DNS: If it blocks Any3D's domain, the entire site becomes unavailable, not just createImageBitmap.

Step‑by‑Step Fix (General)

1. HTTPS + latest browser + restart.
2. Incognito window to exclude extensions.
3. Open in the system browser, not an in‑app WebView.
4. Also check if Web Worker and OffscreenCanvas are flagged.

Quick Self‑Test

typeof createImageBitmap !== "undefined";

Advanced (requires HTTPS and an accessible image URL):

fetch("https://example.com/favicon.ico")
  .then((r) => r.blob())
  .then((b) => createImageBitmap(b))
  .then(() => console.log("ok"))
  .catch(console.error);

Summary

createImageBitmap issues are most often caused by old WebViews, non‑HTTPS, or VPN/intranet resource loading failures. Update the platform-specific WebView, test with a different network, and exclude extensions to restore the Worker image path.