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.

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

Ouvrez et enregistrez d’abord le niveau cible. Les Repères persistants ne sont pas disponibles pour un monde non enregistré ou transitoire.

Placer un repère (Ctrl+Alt+P) place un seul Repère. Votre prochain clic sur une surface valide crée le Repère et termine Placer un repère. Un clic qui ne trouve aucune surface valide laisse le placement armé. Appuyez à nouveau sur Ctrl+Alt+P ou sur Esc pour annuler.
Le Mode de placement de l’espace de travail Repères est continu : chaque clic sur une surface valide crée un Repère jusqu’à ce que vous sélectionniez à nouveau Mode de placement ou appuyiez sur Esc.
Ajouter un repère dans l’espace de travail Repères crée un Repère sans clic dans le viewport.
Locus > Créer un repère ici dans le menu contextuel du viewport du Level Editor crée un Repère à l’emplacement cliqué.

Lorsque Placer un repère, le Mode de placement ou Déplacer le repère est actif, le viewport affiche un indicateur clair qui nomme l’état actif ; Placer un repère et le Mode de placement affichent aussi le scope de création Partagé ou Privé. Le placement se termine également lorsque vous changez de carte, lancez Play ou Simulate, ou masquez les Repères de niveau.

Ctrl+Click correspond à la sélection native du viewport Unreal. Locus ne l’utilise plus pour placer des Repères.

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 une étendue partagée/privée, un préréglage repère facultatif et le menu Viewport. Les préréglages sont personnels à l’utilisateur et au projet et contiennent uniquement un type repère et des balises. Ils s’appliquent uniquement aux futurs Repères créés via Ajouter un repère, Placer un repère (Ctrl+Alt+P), Mode de placement ou Locus > Créer un repère ici.

Le champ Balises du Repère utilise le même éditeur de pastilles que les Notes. Saisissez une balise et appuyez sur Enter pour l’ajouter, ou sélectionnez × sur une pastille pour la supprimer. Les balises vides et les doublons insensibles à la casse sont rejetés, et les actions groupées Ajouter une balise et Supprimer la balise suivent les mêmes règles de balises.

Actions rapides du viewport

Sélectionnez un Repère enregistré actif dans le viewport pour afficher des actions rapides compactes sur le Repère :

Cliquez sur le segment d’état pour Résoudre ou Rouvrir directement le Repère.
Ouvrez Autres actions pour Modifier le type, Attribuer le Repère ou Ouvrir les détails dans l’espace de travail Repères.
Choisissez Prendre une note pour ouvrir Capture rapide avec le Repère joint comme référence. La nouvelle Note est indépendante du Repère et de ses commentaires ; un Repère privé ne peut être référencé que depuis une Note privée.

Ces actions compactes constituent la surface d’action du Repère ; un clic droit sur le Repère n’ouvre pas de menu d’actions du Repère. Les actions rapides utilisent les mêmes protections d’édition, d’extraction et de lecture seule que l’espace de travail Repères.

Modifier plusieurs Repères

Utilisez Ctrl/Shift-click pour sélectionner plusieurs Repères, puis État, Type, Attribuer, Ajouter une balise ou Supprimer la balise dans le panneau de sélection ou le menu Actions groupées de la liste. Les champs dont les valeurs diffèrent dans la sélection affichent Mixte. La sélection est conservée après ces modifications non destructives, afin que vous puissiez appliquer plusieurs changements à la suite. Supprimer les repères Locus sélectionnés reste une action distincte qui demande confirmation.

Les modifications par lots suivent les mêmes règles de sécurité que les modifications d’un seul Repère. Elles sont indisponibles lorsqu’un Repère sélectionné ne peut pas être modifié ou extrait, et les Repères partagés contrôlés sont extraits via le workflow normal du fournisseur avant leur modification. Les actions par lots ne convertissent pas les Repères entre les scopes Partagé et Privé, et Attribuer propose les choix de responsables disponibles plutôt qu’une saisie libre.

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.
Déplacer le repère replace le Repère sélectionné avec le prochain clic sur une surface valide et se termine après un déplacement réussi. Cette action peut changer le niveau propriétaire du Repère. Si le Repère sélectionné est perdu pendant que Déplacer le repère est actif, Déplacer le repère se termine sans créer de nouveau Repère.

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.

Repère Locus sélectionné avec marqueur de viewport, ancre et panneau de détails dans une carte enregistrée — 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.

Sous-niveaux de streaming classiques

Les Repères de niveau prennent en charge les sous-niveaux de streaming classiques :

Le placement interactif suit le niveau actuel d’Unreal. Les Repères placés dans le niveau persistant (principal) se comportent comme auparavant.
Un Repère appartenant à un sous-niveau de streaming classique suit la visibilité de ce niveau dans l’Editor ; il est donc masqué tant que son niveau propriétaire est masqué ou déchargé.
Un sous-niveau actuel verrouillé refuse le placement. Un sous-niveau actuel masqué peut tout de même recevoir un Repère ; Locus affiche un avis et le Repère reste masqué jusqu’à ce que le niveau soit affiché.
L’espace de travail Repères affiche le Niveau propriétaire des Repères appartenant à un sous-niveau.
Déplacer le repère peut changer le niveau propriétaire. Le glissement ordinaire et l’accrochage avec End conservent le propriétaire actuel.
Aller au repère déplace uniquement la caméra ; cela ne modifie ni la visibilité, ni le chargement, ni le niveau actuel.
Les ancres des Repères restent dans l’espace du monde. Déplacer ou transformer un sous-niveau ne déplace pas ses Repères.
Ajouter un repère crée des Repères du niveau persistant, et l’outil MCP locus.create_pin ne crée que des Repères du niveau persistant.
L’appartenance des Repères à une Level Instance n’est pas prise en charge.

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.
L’appartenance des Repères à une Level Instance n’est pas prise en charge.
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.
Les modifications par lots ne peuvent pas changer le scope Partagé/Privé et sont indisponibles lorsqu’un Repère sélectionné ne peut pas être modifié ou extrait.

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.