Troubleshooting

intermediate troubleshooting

X-Frame FPS Accelerator · Troubleshooting & FAQ

Troubleshooting

This page covers the most common issues users encounter with X-Frame FPS Accelerator and how to resolve them.

X-Frame has no effect on FPS

SymptomFPS does not change after adding X-Frame to the camera.
CauseCurrent FPS already meets the target, or the method is set to Disabled.
Solution
  1. Verify Method is not set to Disabled.
  2. Lower the Minimum FPS value below your current FPS to trigger downsampling.
  3. Check that Preserve Nice FPS is not disabling X-Frame because your FPS exceeds the Nice FPS threshold.

Image is too blurry

SymptomThe rendered image appears excessively blurry or pixelated.
CauseMinimum Quality is set too low, or Filtering is set to Nearest Neighbor.
Solution
  1. Increase Minimum Quality to 0.7 or higher.
  2. Set Filtering to Bilinear for smoother upscaling.
  3. Enable Sharpen Image (requires Blit render method) to recover detail.
  4. Increase Antialias to 2 or higher for cleaner edges.

Ghosting artifacts

SymptomPrevious frames leave ghost traces on screen.
CauseThe X-Frame camera's clear flags are set to Nothing while the scene has transparency or moving objects.
Solution
  1. Change Clear Flags to Solid Color or Color.

UI buttons not responding

SymptomCanvas buttons or interactive elements do not respond to clicks/taps.
CauseScreen coordinates are offset due to downsampling, or runtime Canvas objects are not registered.
Solution
  1. Enable GameObject Clicks in X-Frame settings.
  2. If Canvas objects are created at runtime, call XFrameManager.instance.UpdateUICanvases().
  3. For custom raycasting, use XFrameManager.instance.ScreenPointToRay() instead of Camera.ScreenPointToRay().

Method selection ignored in URP

SymptomYou selected Horizontal or Quad Downsampling but the behavior is always Adaptive.
CauseWhen URP is detected, X-Frame internally uses Adaptive Downsampling regardless of the selected method.
Solution
  1. This is expected behavior in URP. Use the quality parameters (Minimum Quality, Static Camera Quality) to control the result.

Still need help?

Visit the Kronnect Support to post your question. Our team will get back to you shortly.

Was this page helpful?