Pin

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.

Proteggi i Pin privati

I Pin privati e i relativi dati di recupero vivono nell’albero Saved del progetto. Pulire o eliminare Saved può rimuoverli definitivamente.

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

1. Apri e salva il livello di destinazione. I Pin persistenti non sono disponibili per un mondo non salvato o transitorio.
2. Apri Pin e avvia l’azione di posizionamento Condivisa o Privata, oppure premi Ctrl+Alt+P per la Modalità posizionamento.
3. Fai clic su una superficie nel viewport.
4. Premi Esc per uscire dalla Modalità posizionamento.

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 Aggiungi pin, Modalità posizionamento, ambito condiviso/privato, una preimpostazione Pin e il menu Viewport. Le preimpostazioni sono personali per l’utente e il progetto, contengono solo un tipo Pin e tag e influenzano solo i futuri Pin. Locus > Create Pin Here nel menu contestuale della vista Level Editor utilizza lo stesso flusso di creazione.

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.
• Riposiziona posiziona di nuovo il Pin selezionato.

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.

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.

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 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.

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.