Pin | Documentazione Locus

I Pin di livello sono annotazioni spaziali per il lavoro nell’Editor. Possono contenere titolo, corpo, tag, commenti, tipo, posizione e una vista del viewport salvata opzionale senza diventare parte della mappa.

Archiviazione e sicurezza della mappa

Ambito	Archiviazione	Comportamento del controllo del codice sorgente
Condiviso	`<Project>/ProjectPins/`	Usa il provider Unreal attivo quando disponibile
Privato	`<Project>/Saved/Locus/PrivatePins/`	Non interroga né modifica mai il provider

Ogni Pin è un file .locuspin esterno. Un Pin non è un Actor, Component, UAsset, pacchetto, metadato della mappa, oggetto runtime o proprietario di dati cotti. Creare, spostare, modificare o eliminare un Pin non rende sporco il pacchetto della mappa.

Sfoglia i Pin

Mappa corrente mostra i Pin associati alla mappa salvata risolta correntemente.
Tutte le mappe raggruppa i Pin del progetto per mappa senza caricare quelle mappe.

I Pin restano separati dalla mappa a cui fanno riferimento. Duplicare una mappa non duplica né reindirizza i Pin. Se una mappa viene spostata, Locus può risolvere un redirect dell’Asset Registry, ma non riscrive silenziosamente ogni file Pin.

Combina ricerca e tag con i filtri compatti TIPO, Stato e Assignee. I tipi Pin sono Predefinito, Importante, Problema, Info e Successo; lo stato è indipendentemente Aperto o Risolto. Gli Pin condivisi utilizzano il selettore persone ricercabile; Io utilizza Il tuo Nome di Visualizzazione, mentre gli Pin privati rimangono Non assegnato.

Posiziona un Pin

Apri e salva prima il livello di destinazione. I Pin persistenti non sono disponibili per un mondo non salvato o transitorio.

Posiziona Pin (Ctrl+Alt+P) posiziona un Pin. Il successivo clic su una superficie valida crea il Pin e termina Posiziona Pin. Un clic che non trova una superficie valida mantiene attivo il posizionamento. Premi di nuovo Ctrl+Alt+P o Esc per annullare.
Modalità posizionamento nell’area di lavoro Pin è continua: ogni clic su una superficie valida crea un Pin finché non selezioni di nuovo Modalità posizionamento o premi Esc.
Aggiungi pin nell’area di lavoro Pin crea un Pin senza un clic nel viewport.
Locus > Crea Pin qui nel menu contestuale del viewport del Level Editor crea un Pin nella posizione cliccata.

Mentre Posiziona Pin, Modalità posizionamento o Sposta Pin è attivo, il viewport mostra un indicatore chiaro con il nome dello stato attivo; Posiziona Pin e Modalità posizionamento mostrano anche l’ambito di creazione Condiviso o Privato. Il posizionamento termina anche quando cambi mappa, avvii Play o Simulate oppure nascondi i Pin di livello.

Ctrl+Click è la selezione nativa del viewport Unreal. Locus non lo usa più per posizionare i Pin.

Seleziona il Pin nel viewport o nel area di lavoro per modificarne titolo, corpo, tag, tipo e commenti. I tipi sono Predefinito, Importante, Problema, Info e Successo. I commenti sono una lista cronologica piatta; non offrono thread, reazioni o notifiche.

L’area di creazione combina un ambito condiviso/privato, una preimpostazione Pin opzionale e il menu Viewport. Le preimpostazioni sono personali per l’utente e il progetto, contengono solo un tipo Pin e tag e si applicano solo ai futuri Pin creati tramite Aggiungi pin, Posiziona Pin (Ctrl+Alt+P), Modalità posizionamento o Locus > Crea Pin qui.

Il campo Tag del Pin usa lo stesso editor a chip delle Note. Digita un tag e premi Enter per aggiungerlo oppure seleziona × su un chip per rimuovere quel tag. I tag vuoti e i duplicati senza distinzione tra maiuscole e minuscole vengono rifiutati; Aggiungi tag e Rimuovi tag in blocco seguono le stesse regole dei tag.

Azioni rapide nel viewport

Seleziona un Pin attivo salvato nel viewport per mostrare azioni rapide compatte sul Pin:

Fai clic sul segmento dello stato per Risolvi o Riapri direttamente il Pin.
Apri Altre azioni per Cambia tipo, Assegna il Pin oppure Apri dettagli nell’area di lavoro Pin.
Scegli Prendi nota per aprire Cattura rapida con il Pin allegato come riferimento. La nuova Nota è indipendente dal Pin e dai suoi commenti; un Pin Privato può essere referenziato solo da una Nota Privata.

Queste azioni compatte sono il punto di accesso alle azioni del Pin; il clic destro sul Pin non apre un menu di azioni del Pin. Le azioni rapide usano le stesse protezioni di modifica, checkout e sola lettura dell’area di lavoro Pin.

Modifica di più Pin

Usa Ctrl/Shift-click per selezionare più Pin, quindi usa Stato, Tipo, Assegna, Aggiungi tag o Rimuovi tag nel pannello della selezione o nel menu Azioni in blocco dell’elenco. I campi con valori diversi nella selezione mostrano Misto. La selezione resta attiva dopo queste modifiche non distruttive, quindi puoi applicare più cambiamenti in sequenza. Elimina Pin Locus selezionati resta un’azione separata che richiede conferma.

Le modifiche in blocco seguono le stesse regole di sicurezza delle modifiche a un singolo Pin. Non sono disponibili quando un Pin selezionato non può essere modificato o sottoposto a checkout e i Pin Condivisi controllati vengono sottoposti a checkout tramite il normale flusso del provider prima della modifica. Le azioni in blocco non convertono i Pin tra ambito Condiviso e Privato e Assegna offre le scelte di assegnatario disponibili invece dell’inserimento di testo libero.

Posizione e viste salvate

Trascina l’ancora per cambiare la posizione sui tre assi.
Trascina verticalmente la testa del marker per regolarne l’altezza.
Premi End per agganciare l’ancora selezionata verso il basso su una superficie.
Premi F per focalizzare il Pin selezionato.
Acquisisci vista salva la vista corrente del viewport dell’Editor con il Pin; Ripristina vista torna a essa quando è stata acquisita.
Sposta Pin posiziona di nuovo il Pin selezionato con il successivo clic su una superficie valida e termina dopo uno spostamento riuscito. Può cambiare il livello proprietario del Pin. Se il Pin selezionato viene perso mentre Sposta Pin è attivo, Sposta Pin termina senza creare un nuovo Pin.

Ogni Pin può memorizzare un viewport opzionale Snapshot. Cattura da una prospettiva disponibile Level Editor, apri l’anteprima più grande e utilizza Aggiorna Istantanea o Cancella Istantanea. Un’immagine condivisa è un file di controllo del codice sorgente separato; un’immagine privata rimane locale sotto Saved e l’eliminazione di Pin la rimuove.

Pin Locus selezionato con marker del viewport, ancora e pannello dettagli in una mappa salvata — Un Pin di livello selezionato collega marker e ancora del viewport ai dettagli modificabili del Pin.

Le modifiche vengono salvate automaticamente. Premi Ctrl+S per salvare immediatamente o ritentare un salvataggio.

Sottolivelli di streaming classici

I Pin di livello supportano i sottolivelli di streaming classici:

Il posizionamento interattivo segue il livello corrente di Unreal. I Pin posizionati nel livello persistente (principale) si comportano come prima.
Un Pin di proprietà di un sottolivello di streaming classico segue la visibilità di quel livello nell’Editor, quindi è nascosto mentre il livello proprietario è nascosto o non caricato.
Un sottolivello corrente bloccato rifiuta il posizionamento. Un sottolivello corrente nascosto può comunque ricevere un Pin; Locus mostra un avviso e il Pin resta nascosto finché il livello non viene mostrato.
L’area di lavoro Pin mostra il Livello proprietario dei Pin di proprietà di un sottolivello.
Sposta Pin può cambiare il livello proprietario. Il normale trascinamento e l’aggancio con End mantengono il proprietario corrente.
Vai al Pin sposta solo la telecamera; non cambia visibilità, caricamento o livello corrente.
Le ancore dei Pin restano nello spazio del mondo. Spostare o trasformare un sottolivello non sposta i suoi Pin.
Aggiungi pin crea Pin del livello persistente e lo strumento MCP locus.create_pin crea solo Pin del livello persistente.
La proprietà dei Pin da parte di Level Instance non è supportata.

Presentazione del viewport

Il controllo di visibilità del viewport è indipendente dalla Modalità posizionamento. La visualizzazione del titolo supporta i comportamenti Sempre, Selezionato, Al passaggio, Vicino e Adattivo. Le scelte di occlusione includono Sempre visibile, Linea di vista, Selezionato attraverso la geometria e Opacità ridotta.

Le impostazioni personali dei Pin controllano distanza del titolo vicino, altezza massima del marker, presentazione di marker e connettore e animazione di posizionamento. Queste preferenze influiscono solo sulla presentazione dell’Editor; non cambiano mappe o contenuto principale del Pin. Vedi Impostazioni.

I controlli visivi più utili sono Intensità bagliore per l’energia luminosa aggiuntiva, Spessore linea connettore per il nucleo persistente e Modalità colore linea e anello per gli accenti semantici o personalizzati.

Mostra solo Pin filtrati è disattivato per impostazione predefinita e rispecchia la mappa corrente, l’ambito, la ricerca, i tag, il tipo, lo stato e il risultato dell’assegnatario. Profondità della scena utilizza la geometria della scena per l’occlusione profonda; Linea di vista è il comportamento predefinito per la traccia delle collisioni. Gli Pin di revisione selezionati e attivi rimangono in primo piano.

Cerca, duplica ed elimina

Ricerca e filtri restringono i Pin in base ai campi visibili all’utente e al contesto mappa/ambito. Ctrl+D duplica il Pin selezionato. Elimina richiede l’eliminazione permanente e necessita di conferma. Annulla di Unreal non può ripristinare un file Pin esterno eliminato.

Revisione N avvia la revisione del livello sul risultato filtrato. Pin precedente e Pin successivo si muovono ciclicamente; Esci dalla Revisione mantiene la selezione. La revisione di tutte le mappe conferma la navigazione su più mappe con Apri Livello, Salta Pin o Annulla. Lo stato di revisione è solo sessione.

Recupero e conflitti

Le copie di recupero sono archiviate sotto <Project>/Saved/ProjectPins/Recovery/ per i Pin Condivisi e <Project>/Saved/Locus/Recovery/PrivatePins/ per i Pin Privati. Le azioni di recupero includono ripristino, ripristino come nuovo Pin e scarto della copia.

Se un file .locuspin cambia esternamente mentre sono in attesa modifiche locali, Locus blocca la sostituzione silenziosa e offre azioni di conflitto sicure, come ricaricare dal disco o salvare il lavoro locale come nuovo Pin. Vedi Risoluzione dei problemi.

Controllo della fonte

Un nuovo Pin condiviso rimane locale e Untracked finché non si sceglie esplicitamente Contrassegna per l’aggiunta; gli Pin multiselezionati idonei possono essere sommati insieme. Uno Pin condiviso controllato richiede il checkout automaticamente prima di una mutazione supportata. Le immagini delle istantanee condivise hanno uno stato di aggiunta o estrazione separato.

Gli Pin privati rimangono locali e non contattano mai il fornitore. Senza provider configurato, la modalità locale consente la modifica e non mostra alcuna interfaccia utente specifica del controllo del codice sorgente. Locus non invia, sincronizza, gestisce elenchi di modifiche o modifica mappe di tipi.

Disposizione reattiva

Man mano che lo spazio si restringe, le azioni si spostano nel menu con i puntini di sospensione, l’ambito diventa un menu compatto, gli stack di metadati e le miniature delle istantanee si restringono prima di diventare un’icona. A larghezze estreme l’elenco e i dettagli diventano una vista principale/dettaglio con Torna ai Pin; i commenti si spostano per mantenere le azioni raggiungibili.

Limitazioni correnti

Per il posizionamento persistente è richiesto un mondo di primo livello salvato.
La proprietà dei Pin da parte di Level Instance non è supportata.
La duplicazione di una mappa non clona né reindirizza i Pin.
I workflow del provider e dei mondi complessi al di fuori della matrice di rilascio validata devono essere verificati dal progetto prima di farvi affidamento.
Le modifiche in blocco non possono cambiare l’ambito Condiviso/Privato e non sono disponibili quando un Pin selezionato non può essere modificato o sottoposto a checkout.

L’acquisizione di istantanee richiede una vista prospettica Level Editor disponibile e non è disponibile durante PIE. I commenti esistenti non possono essere modificati o eliminati.