On-Staff Feedback Rendering
The on-staff visual feedback (the transparent red/green overlay notes) is highly stable vertically. However, mapping dynamic canvas rendering to an active MusicXML cursor is complex, so you may occasionally spot minor horizontal alignment quirks.
Known Minor Issues:
-Feedback coloring the "dots" of dotted notes instead of the main notehead.
-Feedback highlighting articulation accents rather than the note.
-Slight horizontal misalignment on very dense chord clusters.
Note: Because these quirks are cosmetic and do not impact core practice features, they are currently a lower priority while the core app engine is stabilized.
Reporting a Feedback Note Rendering Bug
If you encounter a severe rendering bug, capturing the exact state of the rendering engine is critical. Please follow these steps to capture a debug log before opening a GitHub Issue:
Capture Steps:
- Navigate to Practice -> Visual Feedback and enable Show correct / incorrect notes.
- Navigate to Settings -> Debug and enable Debug Note Feedback.
- Set your Practice Mode to Realtime.
- Zoom in clearly on the problematic measure via More -> Display Settings.
- Open your browser's Developer Console (Press F12 in Chrome/Edge).
- Press Play, let the problematic note render, and immediately hit Pause.
What to Include in Your Bug Report:
- The .musicxml or .xml file you were practicing.
- The specific measure number and note(s) affected.
- A screenshot of the canvas showing the red debug note overlays.
- An export of your browser console log (saved as a .txt file).
On-Staff Feedback Rendering
The on-staff visual feedback (the transparent red/green overlay notes) is highly stable vertically. However, mapping dynamic canvas rendering to an active MusicXML cursor is complex, so you may occasionally spot minor horizontal alignment quirks.
Known Minor Issues:
-Feedback coloring the "dots" of dotted notes instead of the main notehead.
-Feedback highlighting articulation accents rather than the note.
-Slight horizontal misalignment on very dense chord clusters.
Note: Because these quirks are cosmetic and do not impact core practice features, they are currently a lower priority while the core app engine is stabilized.
Reporting a Feedback Note Rendering Bug
If you encounter a severe rendering bug, capturing the exact state of the rendering engine is critical. Please follow these steps to capture a debug log before opening a GitHub Issue:
Capture Steps:
What to Include in Your Bug Report: