iJewel3D Docs

Appearance

FAQ: Rendering & Performance ​

Frequently asked questions about render quality, performance, and device-specific issues in iJewel Playground.

Why is my model blurry while rotating or zooming?

During interaction (orbiting, zooming, panning), Playground renders at a lower quality for responsiveness and then refines the image once you stop. This is normal behavior — the final high-quality render appears after you release the mouse. If the blur persists after interaction stops, check:

  1. Renderer → Scale — make sure it's set to 1 or higher (lower values reduce resolution for performance)
  2. Anti-Aliasing settings — increase TAA/Progressive frame count for sharper results
  3. Depth of Field in Post Processing — disable it if you don't need selective focus
How do I improve overall render quality?

Several settings affect render quality:

  1. Renderer → Scale — set to 1 for native resolution, or higher for supersampling
  2. Renderer → Mode — use the highest quality mode available
  3. Anti-Aliasing (TAA) — increase Progressive frame count (8–16 gives good results)
  4. SSAO (Screen Space Ambient Occlusion) — adds subtle shadows in crevices
  5. SSR (Screen Space Reflections) — improves reflection accuracy
  6. Bloom — adds glow to bright areas (especially useful for diamonds)

See Renderer Settings for a full explanation of quality modes.

Video Tutorial

Watch Resolution & Export from Playground for a visual walkthrough of resolution and quality settings.

The render looks different on mobile vs desktop. Why?

Mobile devices have lower GPU power and memory, so Playground may automatically reduce quality settings. Additionally:

  1. Screen size and pixel density differ — the same resolution looks different on a phone vs a monitor
  2. iOS has a ~350–400 MB memory limit for WebGL — exceeding it causes the page to refresh
  3. Touch interactions (drag vs scroll) may behave differently than mouse controls
  4. Some post-processing effects may be disabled automatically on lower-end devices
My page refreshes/crashes on iOS when loading complex models. What's happening?

iOS Safari has a strict memory limit for WebGL content (approximately 350–400 MB, depending on the iPhone model). When your scene exceeds this, iOS force-refreshes the page. To stay within limits:

  1. Use smaller texture maps — resize textures to 1024×1024 or lower for mobile
  2. Reduce the number of diamonds — configure cache keys to reuse diamond rendering resources
  3. Lower the Renderer Scale on mobile
  4. Use compressed GLB files (with Draco compression)
What does the Renderer Scale setting do?

Scale controls the internal rendering resolution relative to the canvas size. A scale of 1 means native resolution. Scale 0.5 renders at half resolution (faster but blurrier). Scale 2 renders at double resolution (sharper but slower). For final exports, use Scale 1 or higher. For real-time preview, Scale 0.5–1 is usually sufficient.

See Renderer Settings for more details.

Anti-aliasing breaks when playing model animation. Is this a known issue?

Yes, this can happen because TAA (Temporal Anti-Aliasing) relies on accumulating multiple frames. During animation playback, the scene changes every frame, which prevents proper accumulation. Try:

  1. Increasing the Progressive frame count in Anti-Aliasing settings
  2. For final video exports, Playground renders each frame with full AA — so the exported video will look better than the real-time preview
How do I record high-quality videos without quality depending on my device?

Use Playground's built-in video export (Export → Video Export) rather than screen recording. The built-in exporter renders each frame at full quality regardless of your device's real-time performance — it captures frames one by one, so even a slower device produces the same quality output (it just takes longer).

Useful Video Tutorials ​