Back to API Reference
Class
NativeMagnifier
sealed
Inherits:SelectableEntity
Implements:IMagnifier
Presents the platform's own text magnifier: android.widget.Magnifier on Android and the system text loupe on iOS, each shaped, sized, zoomed and animated by the running system — so the loupe matches the device's current text-selection look instead of imitating it.
Remarks
The magnified content is the live frame the player renders, sampled by the system from the player's own surface. The focal point follows the finger horizontally and snaps to the text line under it (
TryGetLineScreenRect), the behavior both platforms use for caret placement and selection-handle dragging. Sampling a surface always trails the frame being built, so each platform re-samples on its own display frame while the loupe is up; this entity sends a focus, never a repaint. A selection the user changes and then holds still therefore catches up behind the glass without the player thread driving the loupe. The system magnifier exists on Android 9.0 and iOS 17 and later. Elsewhere — every other platform, the Editor, and older devices — there is no system magnifier to present and this entity shows nothing; assign PrefabMagnifier for a loupe that exists everywhere.