Convertitore online gratuito da OFF a SCAD

Cos'è il formato OFF

OFF, ovvero Object File Format, è un formato di testo semplice per superfici poligonali. La sua intestazione è seguita dal numero di vertici, facce e spigoli, quindi dalle coordinate dei vertici e dalle definizioni delle facce, che fanno riferimento ai vertici tramite un indice a base zero.

OFF è utilizzato da Geomview, MeshLab, programmi basati su CGAL, software accademici per la geometria e dataset di mesh. Una faccia può contenere tre o più indici di vertici, quindi il file può memorizzare triangoli, quadrilateri o poligoni generici. I file OFF standard contengono generalmente solo la geometria; i valori colore opzionali per vertice o per faccia non vengono conservati in modo affidabile dai convertitori.

Cos'è il formato SCAD

SCAD è il formato del codice sorgente di OpenSCAD. Descrive la geometria tramite primitive come cube() e sphere(), operazioni booleane come union() e difference(), trasformazioni, variabili, moduli e mesh letterali come polyhedron().

Una mesh OFF viene normalmente rappresentata in SCAD come un'unica istruzione polyhedron(points = [...], faces = [...]);. Ciò rende il risultato modificabile come codice sorgente e combinabile con altri oggetti OpenSCAD, ma non ricostruisce il progetto parametrico originale: il file convertito rimane un elenco fisso di punti e facce.

Come convertire effettivamente OFF in SCAD

Per una conversione rapida senza installare software, usa il convertitore da OFF a SCAD su 101convert.com: carica il file .off, scegli SCAD come formato di output, esegui la conversione e scarica il file .scad risultante.

Per una conversione locale o ripetibile, usa un breve script Python che traduce i record OFF nella sintassi polyhedron() di OpenSCAD:

#!/usr/bin/env python3
import sys

src, dst = sys.argv[1], sys.argv[2]
with open(src, encoding='utf-8') as f:
    tokens = []
    for line in f:
        line = line.split('#', 1)[0]
        tokens.extend(line.split())

if not tokens or tokens[0].upper() != 'OFF':
    raise ValueError('The input is not a standard OFF file')

nv, nf, _ = map(int, tokens[1:4])
pos = 4
points = []
for _ in range(nv):
    points.append([float(tokens[pos]), float(tokens[pos + 1]), float(tokens[pos + 2])])
    pos += 3

faces = []
for _ in range(nf):
    count = int(tokens[pos])
    pos += 1
    faces.append([int(tokens[pos + i]) for i in range(count)])
    pos += count

with open(dst, 'w', encoding='utf-8') as f:
    f.write('// Converted from OFF\npolyhedron(\n')
    f.write('  points = [\n')
    for i, p in enumerate(points):
        comma = ',' if i + 1 < len(points) else ''
        f.write('    [%r, %r, %r]%s\n' % (p[0], p[1], p[2], comma))
    f.write('  ],\n  faces = [\n')
    for i, face in enumerate(faces):
        comma = ',' if i + 1 < len(faces) else ''
        f.write('    [%s]%s\n' % (', '.join(map(str, face)), comma))
    f.write('  ]\n);\n')

Salvalo come off_to_scad.py, quindi esegui:

python3 off_to_scad.py model.off model.scad

Apri il risultato in OpenSCAD e usa Design → Preview oppure premi F5. Usa Design → Render oppure premi F6 per convalidare il solido finale prima di esportarlo.

Limitazioni relative a qualità e compatibilità

OFF normalmente non definisce le unità di misura, quindi le coordinate vengono importate senza ridimensionamento. Se la sorgente utilizza millimetri, pollici o un altro sistema di unità, applica un fattore esplicito in OpenSCAD, ad esempio scale(25.4) { polyhedron(...); }.

Il convertitore conserva le coordinate dei vertici e gli indici delle facce, ma generalmente elimina colori, dati dei materiali, coordinate delle texture, normali, commenti e altri attributi non geometrici. L'orientamento delle facce deve essere coerente: le facce invertite possono produrre normali errate o avvisi di OpenSCAD come geometria non-manifold.

Poligoni non planari, autointersezioni, vertici duplicati, fori e spigoli non-manifold possono causare errori durante il rendering. Ripara o triangola la mesh in MeshLab prima della conversione se OpenSCAD segnala facce non valide. La triangolazione migliora la compatibilità, ma può modificare il modo in cui viene interpretato un poligono non planare.