# रेंडरिंग समस्याएँ

> स्क्रीन कोड को प्रतिबिंबित नहीं करती — ऑन-डिमांड render, alpha, layout अमान्यकरण, कमज़ोर GPU।

Source: https://crossfly.dev/hi/docs/troubleshooting/render — CrossFly documentation. Full docs as one file: https://crossfly.dev/llms-full.txt

# रेंडरिंग समस्याएँ

स्क्रीन वह प्रतिबिंबित नहीं करती जो कोड ने किया। प्रारूप: **लक्षण → कारण → सुधार**।

## "मैंने एक मान बदला और स्क्रीन अपडेट नहीं होती"
**कारण:** render **ऑन-डिमांड** है — CrossFly केवल अनुरोध पर ही पुनः-ड्रॉ करता है।
**सुधार:** `Component.repaint()` कॉल करें; यदि आपने आकार/स्थिति "बाहर से" बदली है, तो
`setValidLayout(false)` भी (फ्रेमवर्क के अधिकांश setters यह पहले से करते हैं; जो आप मैन्युअल रूप से बदलते हैं,
वह नहीं)। (अध्याय 4 §4.6)

## परिभाषित रंग गायब हो जाता है / कंपोनेंट अदृश्य हो जाता है
**कारण:** रंग एक `int` ARGB `0xAARRGGBB` है और आपने `0xRRGGBB` (alpha 0) उपयोग किया।
**सुधार:** `0xFF…` उपसर्ग लगाएँ।
```java
// 0x2196F3  → अदृश्य (alpha 00)
// 0xFF2196F3 → अपारदर्शी नीला
```
(अध्याय 11 — रंग)

## बच्चे बदलने के बाद layout पुनः-गणना नहीं करता
**कारण:** layout अमान्य करना छूट गया।
**सुधार:** `container.setValidLayout(false);` + `Component.repaint();`।

## पुराने डिवाइस पर UI अटकता है / दांतेदार दिखता है
**कारण:** कमज़ोर GPU।
**सुधार:** **`Screen.slowGPU`** जाँचें और उस स्थिति में छाया/ग्रेडिएंट/ग्लास प्रभाव कम करें।
(अध्याय 8 — Rendering)

## थीम बदल गई, पर पुराने कंपोनेंट नहीं
**कारण:** स्टाइल कैश `styleVersion` द्वारा पुनः-हल होता है (`PalColor` रंग अगले फ्रेम में पुनः-हल होते हैं) —
सामान्यतः `setColorScheme`/`setDarkMode` पर स्वचालित।
**सुधार:** यदि कुछ साथ नहीं चला, तो विंडो पर `restyle()` या `Component.repaint()` फ़ोर्स करें।
([लाइट/डार्क मोड](/docs/ui/theming/dark-mode))

## यह भी देखें
- [रनटाइम त्रुटियाँ](/docs/troubleshooting/runtime) · अवधारणा: [रेंडरिंग पाइपलाइन](/docs/concepts/rendering-pipeline)