Repères

Les Repères de niveau sont des annotations spatiales pour le travail dans l’Editor. Ils peuvent contenir un titre, un corps, des tags, des commentaires, un type, une position et éventuellement une vue du viewport enregistrée sans devenir une partie de la carte.

Stockage et sécurité de la carte

Scope	Stockage	Comportement du contrôle de source
Partagé	<Project>/ProjectPins/	Utilise le fournisseur Unreal actif lorsqu’il est disponible
Privé	<Project>/Saved/Locus/PrivatePins/	Ne consulte ni ne modifie jamais le fournisseur

Chaque Repère est un fichier externe .locuspin. Un Repère n’est ni un Actor, ni un Component, ni un UAsset, ni un package, ni une métadonnée de carte, ni un objet d’exécution, ni le propriétaire de données cuites. Créer, déplacer, modifier ou supprimer un Repère ne rend pas le package de carte modifié à lui seul.

Protéger les Repères privés

Les Repères privés et leurs données de récupération vivent dans l’arborescence Saved du projet. Nettoyer ou supprimer Saved peut les supprimer définitivement.

Parcourir les Repères

• Carte actuelle affiche les Repères associés à la carte enregistrée actuellement résolue.
• Toutes les cartes regroupe les Repères du projet par carte sans charger ces cartes.

Les Repères restent séparés de la carte qu’ils référencent. Dupliquer une carte ne duplique pas et ne réoriente pas les Repères. Si une carte est déplacée, Locus peut résoudre une redirection de l’Asset Registry, mais ne réécrit pas silencieusement chaque fichier de Repère.

Combinez la recherche et les balises avec les filtres compacts TYPE, État et Assignee. Les types repère sont Par défaut, Important, Problème, Info et Succès ; le statut est indépendamment Ouvert ou Résolu. Les repère partagés utilisent le sélecteur de personnes consultable ; Moi utilise Votre nom d’affichage, tandis que les repère privés restent Non attribué.

Placer un Repère

1. Ouvrez et enregistrez le niveau cible. Les Repères persistants ne sont pas disponibles pour un monde non enregistré ou transitoire.
2. Ouvrez Repères et démarrez l’action de placement Partagé ou Privé, ou appuyez sur Ctrl+Alt+P pour le Mode de placement.
3. Cliquez sur une surface dans le viewport.
4. Appuyez sur Esc pour quitter le Mode de placement.

Sélectionnez le Repère dans le viewport ou l’espace de travail pour modifier son titre, son corps, ses tags, son type et ses commentaires. Les types sont Par défaut, Important, Problème, Info et Succès. Les commentaires forment une liste chronologique simple ; ils ne proposent ni fils, ni réactions, ni notifications.

La zone de création combine Ajouter un repère, Mode de placement, une étendue partagée/privée, un préréglage repère et le menu Viewport. Les préréglages sont personnels à l’utilisateur et au projet, contiennent uniquement un type repère et des balises et affectent uniquement les futurs repère. Locus > Create repère Here dans le menu contextuel de la fenêtre Level Editor utilise le même flux de création.

Position et vues enregistrées

• Faites glisser l’ancre pour modifier sa position sur trois axes.
• Faites glisser la tête du marqueur verticalement pour régler sa hauteur.
• Appuyez sur End pour accrocher l’ancre sélectionnée vers le bas sur une surface.
• Appuyez sur F pour focaliser le Repère sélectionné.
• Capturer la vue enregistre la vue actuelle du viewport de l’Editor avec le Repère ; Restaurer la vue y revient lorsqu’une vue a été capturée.
• Repositionner replace le Repère sélectionné.

Chaque repère peut stocker une fenêtre optionnelle Snapshot. Capturez à partir d’une fenêtre d’affichage Level Editor en perspective disponible, ouvrez l’aperçu plus grand et utilisez Mettre à jour l’instantané ou Effacer l’instantané. Une image partagée est un fichier de contrôle de source distinct ; une image privée reste locale sous Saved, et la suppression du repère la supprime.

Un Repère de niveau sélectionné relie son marqueur et son ancre du viewport aux détails du Repère modifiables.

Les modifications sont enregistrées automatiquement. Appuyez sur Ctrl+S pour enregistrer immédiatement les modifications en attente ou réessayer un enregistrement.

Présentation du viewport

Le bouton de visibilité du viewport est indépendant du Mode de placement. L’affichage du titre prend en charge les comportements Toujours, Sélectionné, Survolé, À proximité et Adaptatif. Les choix d’occlusion incluent Toujours visible, Ligne de vue, Sélectionné à travers la géométrie et Opacité réduite.

Les paramètres personnels des Repères contrôlent la distance des titres proches, la hauteur maximale du marqueur, la présentation du marqueur et du connecteur et l’animation de placement. Ces préférences affectent uniquement la présentation dans l’Editor ; elles ne modifient pas les cartes ni le contenu faisant autorité du Repère. Voir Paramètres.

Les contrôles visuels les plus utiles sont Intensité de la lueur pour l’énergie lumineuse supplémentaire, Épaisseur de la ligne de liaison pour le cœur persistant et Mode de couleur de la ligne et de l’anneau pour les accents sémantiques ou personnalisés.

Afficher uniquement les repères filtrés est désactivé par défaut et reflète la carte, la portée, la recherche, les balises, le type, le statut et le résultat du destinataire actuel. Profondeur de la scène utilise la géométrie de la scène pour l’occlusion en profondeur ; Ligne de vue est le comportement de trace de collision par défaut. Les repère sélectionnés et actifs restent au premier plan.

Rechercher, dupliquer et supprimer

La recherche et les filtres réduisent les Repères selon leurs champs visibles par l’utilisateur et leur contexte de carte/scope. Ctrl+D duplique le Repère sélectionné. Supprimer demande la suppression définitive et nécessite une confirmation. L’annulation Unreal ne peut pas restaurer un fichier de Repère externe supprimé.

Revue N démarre la révision de niveau sur le résultat filtré. Repère précédent et Repère suivant se déplacent de manière cyclique ; Quitter la revue conserve la sélection. All Maps Review confirme la navigation sur plusieurs cartes avec Ouvrir le Niveau, Passer le repère ou Annuler. L’état de révision concerne uniquement la session.

Récupération et conflits

Les instantanés de récupération sont stockés sous <Project>/Saved/ProjectPins/Recovery/ pour les Repères partagés et <Project>/Saved/Locus/Recovery/PrivatePins/ pour les Repères privés. Les actions de récupération comprennent la restauration, la restauration comme nouveau Repère et l’abandon de l’instantané.

Si un fichier .locuspin change à l’extérieur alors que des modifications locales sont en attente, Locus bloque le remplacement silencieux et propose des actions de conflit sûres comme recharger le disque ou enregistrer le travail local comme nouveau Repère. Voir Résolution des problèmes.

Contrôle des sources

Un nouveau repère partagé reste local et Untracked jusqu’à ce que vous choisissiez explicitement Marquer pour ajout ; Les repère multisélectionnés éligibles peuvent être additionnés. Un repère partagé contrôlé demande automatiquement l’extraction avant une mutation prise en charge. Les images instantanées partagées ont un état d’ajout ou d’extraction distinct.

Les repère privés restent locaux et ne contactent jamais le fournisseur. Sans fournisseur configuré, le mode local permet l’édition et n’affiche aucune interface utilisateur spécifique au contrôle source. Locus ne soumet pas, ne synchronise pas, ne gère pas les listes de modifications et ne modifie pas les typesmaps.

Mise en page réactive

À mesure que l’espace se rétrécit, les actions se déplacent dans le menu avec points de suspension, la portée devient un menu compact, les piles de métadonnées et les miniatures des instantanés se rétrécissent avant de devenir une icône. Aux largeurs extrêmes, la liste et les détails deviennent une vue maître/détail avec Retour aux repères ; les commentaires sont renvoyés pour garder les actions accessibles.

Limitations actuelles

• Un monde de niveau supérieur enregistré est requis pour un placement persistant.
• Dupliquer une carte ne clone pas et ne réoriente pas les Repères.
• Les workflows de fournisseur et de mondes complexes en dehors de la matrice de publication actuellement validée doivent être vérifiés par le projet avant toute utilisation fiable.

La capture d’instantané nécessite une fenêtre d’affichage en perspective Level Editor disponible et n’est pas disponible pendant PIE. Les commentaires existants ne peuvent pas être modifiés ou supprimés.