Center Map on Vertex Addition When Position Locked & Off-Screen

[mohsenD98]

Description:

This PR addresses a usability issue related to adding vertices when the coordinate cursor is locked and is off-screen. (#5883 ).

Problem:

When the coordinate cursor is locked, new vertices should be added at the current location point. However, if the user moves the map canvas so the current location (and thus the crosshair) is no longer visible, the user receives no visual confirmation of vertex addition. This creates uncertainty as to whether the vertex has been added or not.

Solution:

This PR implements a solution that automatically recenters the map when a vertex is added under the described condition. Specifically:

When the positionLocked setting is enabled and a vertex is being added.

The code checks if the crosshair circle (representing the current location) is off-screen. This is determined by the following logic:

const outOfScreen = crosshairCircle.x + crosshairCircle.width <= 0 ||
                    crosshairCircle.x - crosshairCircle.width >= mainWindow.width ||
                    crosshairCircle.y + crosshairCircle.height <= 0 ||
                    crosshairCircle.y - crosshairCircle.height >= mainWindow.height;

If outOfScreen is true , the map is automatically recentered to the current location using mapCanvas.mapSettings.setCenter(positionSource.projectedPosition, true);.

Screen cast:

Screencast.From.2025-02-16.23-49-34.webm

[qfield-fairy]

🎉 Ta-daaa, freshly created APKs are available for 18d9f38: arm64-android

Other architectures

• arm-neon-android
• x64-android
• x86-android
• all access arm64-android
• all access arm-neon-android
• all access x64-android
• all access x86-android