Table of Contents

Diagnosi e correzione: caricamento target non riuscito

La funzione di tracking di oggetti 3D dipende fortemente dalla qualità del modello 3D in input. Quando il caricamento del modello target fallisce, EasyAR stampa log di errore dettagliati per aiutare gli sviluppatori a individuare il problema. Questo capitolo elenca cause comuni e soluzioni, coprendo problemi di materiale, texture e file modello.

Errori dei file materiale/texture map

Questi errori sono solitamente causati da configurazione dei percorsi o problemi di formato file.

Messaggio di log Causa dell'errore Soluzione
Material file not exist Il percorso del file materiale (.mtl) non esiste o non è referenziato correttamente Controllare che il file .mtl esista nella cartella del modello e che il percorso mtllib nel file .obj punti correttamente a esso come percorso relativo
Current material has no name La definizione del materiale non ha un nome (newmtl non è specificato) Aggiungere un nome per ogni materiale nel file .mtl, ad esempio newmtl Material1
No texture map exists in material Nel materiale non è specificata alcuna texture map (manca map_Ka o map_Kd) Aggiungere un percorso texture nel file .mtl, ad esempio map_Kd texture.jpg
Read texture map file failed Il file texture map non può essere letto (percorso errato o formato non supportato) Controllare che il file texture sia nella cartella del modello, in formato JPG/PNG e che il percorso non contenga spazi

Errori dei file modello

Questi errori sono solitamente causati da formato OBJ non standard o problemi di encoding.

Messaggio di log Causa dell'errore Soluzione
Error in opening OBJ file Il percorso del file modello non esiste o i permessi sono insufficienti Controllare il percorso del file e assicurarsi che il file sia leggibile
Error in reading OBJ file Lettura file non riuscita (encoding non UTF-8 o file danneggiato) Aprire il file .obj in un editor di testo e salvarlo con encoding UTF-8
Material not exist Il materiale referenziato dalla faccia non è stato trovato nel file .mtl Controllare il campo usemtl nel file .obj e assicurarsi che corrisponda al nome newmtl nel file .mtl
Vertex format invalid Formato coordinate vertex non valido (la riga v non rispetta la specifica) Controllare il formato v: v x y z (ad esempio v -4.322898 6.063079 -40.241329) e assicurarsi che i valori siano numerici
Vertex texture coordinate format invalid Formato coordinate texture vertex non valido (la riga vt non rispetta la specifica) Controllare il formato vt: vt u v (ad esempio vt 0.929688 0.094622) e assicurarsi che i valori siano tra 0 e 1
Face format invalid La face ha meno di 3 vertici (la riga f non è valida) Controllare la riga f e assicurarsi che ogni face contenga almeno 3 vertici
Both vertex index and vertex texture coordinate index are required Formato face errato (indice vertex o texture mancante) Controllare il formato della riga f e assicurarsi che contenga indici vertex e texture (ad esempio f 1/1 2/2 3/3)
Vertex index format invalid Indice vertex della face errato (indice fuori intervallo o non intero) Controllare gli indici vertex nella riga f e assicurarsi che siano interi positivi e non superino il numero totale di vertici
Vertex texture coordinate index format invalid Indice coordinate texture della face errato Controllare gli indici texture nella riga f e assicurarsi che siano interi positivi e non superino il numero totale di coordinate texture

Best practice

Quando si verifica un errore di caricamento, eseguire la diagnosi secondo le informazioni nelle tabelle precedenti. In generale, seguire queste linee guida di base:

  • Se il modello è esportato da strumenti professionali come Blender o Maya, assicurarsi di selezionare "write materials" e "include UVs" (o opzioni simili) durante l'esportazione, e verificare che tutti i file siano nella stessa cartella.
  • I percorsi di riferimento all'interno dei file modello esportati dagli strumenti possono essere assoluti. Controllarli e convertirli in percorsi relativi, evitare spazi nei nomi file e assicurarsi che l'encoding sia UTF-8.
  • Per i requisiti dettagliati su formato e specifiche del modello, vedere Preparazione del modello.

Suggerimento: se il problema non può ancora essere risolto, comprimere i file modello e i log di errore e ottenere aiuto tramite il forum ufficiale EasyAR o il supporto tecnico.