Input
Usate il pulsante a destra in Gestione Attributi per selezionare il file da caricare. Il Nodo è in grado di leggere file ASCII con codifica UTF8. UTF16 non funzionerà per il momento.
Per ottenere risultati migliori, attenetevi ai formati di file CSV o JSON. Potete facilmente scrivere questi file con semplici applicazioni di testo o esportare gli elenchi in formato CSV direttamente da applicazioni di fogli di calcolo come Microsoft Excel.
Ecco come potrebbe apparire un tipico file CSV:
Punto;X;Y;Z
0;100;0;0
1;-100;0;0
2;0;0;100
Questa immagine mostra un file CSV che elenca le coordinate dei punti di un oggetto Sfera. Questo genere di struttura di dati dovrebbe esservi familiare grazie alla Gestione Struttura di Cinema 4D.
La prima cosa da notare è che la struttura CSV utilizza righe e colonne. La prima riga definisce normalmente i nomi dei valori di ciascuna colonna. Questi nomi si trovano anche come output sul Nodo.
La seconda cosa da notare è che tutte le colonne sono separate da un punto e virgola. Il Nodo può utilizzare anche altri delimitatori, come spazi, tabulazioni o punti.
Quando si usano i file JSON la struttura è un po' diversa:
[
{
"Point":0,
"X":100,
"Y":0,
"Z":0
},
{
"Point":1,
"X":-100,
"Y":0,
"Z":0
},
{
"Point":2,
"X":0,
"Y":0,
"Z":100
}
]
I file JSON hanno una struttura più rigida per i set di dati rispetto ai file CSV. Questo file memorizza le posizioni di 3 punti.
Potete notare che in questo formato vengono usate le parentesi graffe per definire un set di dati. Ogni set di dati è a sua volta separato da una virgola dal set di dati successivo. Il nome di un valore e il valore stesso sono sempre utilizzati insieme in una riga, separati da due punti e conclusi da una virgola. Le stringhe di nomi vengono utilizzate con le virgolette. Tutti i set di dati sono racchiusi tra parentesi quadre.
Usate questo pulsante per aggiornare il file collegato.
I valori possono essere separati da vari separatori, come il punto, la virgola, i due punti, la tabulazione o lo spazio. È possibile scegliere qualsiasi altro carattere o segno di punteggiatura impostando la modalità su "Personalizzato". Se non siete sicuri del delimitatore utilizzato, provate la modalità "Automatico".
Poiché i file CSV e JSON sono facilmente leggibili con le applicazioni di testo standard, è sempre possibile verificare personalmente la struttura del file e i separatori utilizzati.
Questa opzione viene usata principalmente per i file CSV, che di solito elencano i nomi dei valori nella prima riga. Se nel file sono memorizzati solo valori, è possibile disattivare questa opzione. Allora anche la prima riga del file sarà inclusa nell'array di valori risultante.
I file possono anche contenere commenti dell'utente che non dovrebbero tuttavia far parte dei valori letti. Di solito i commenti sono contrassegnati da hashtag e possono essere filtrati automaticamente con questa opzione.
Come potete vedere nell'esempio JSON precedente, le stringhe sono spesso inserite all'interno di virgolette singole o doppie. L'uso di doppie virgolette è più comune per le stringhe.
Se impostate questo valore a 0, verrà letto l'intero file. Con altri valori numerici è possibile limitare la quantità di righe di dati letti da un file CSV.
Questo menu è rilevante solo per la lettura di file JSON. Come potete vedere nell'esempio precedente, i file JSON sono costituiti da set di dati incapsulati e separati da parentesi graffe. Selezionando "Tutti i Set di Dati", il Nodo leggerà tutti i set di dati del file. Se invece selezionate "Singolo Set di Dati", dal file verrà letto un solo set di dati specifico. Il numero di indice del set di dati viene definito con il parametro Set di Dati.
Quando utilizzate il Modo "Singolo Set di Dati", è possibile inserire il numero di indice specifico del set di dati che volete leggere da un file JSON.