kapy academy

Importar un STL o un OBJ

8 min readUpdated ago 2026

Usa Malla (STL/OBJ) para meter una malla de triángulos en tu documento como un cuerpo que puedes mover, cortar y usar de base. Deselecciona todo para que aparezca el grupo de objetos en la barra de herramientas, pulsa Malla (STL/OBJ) y se abre el panel Insert Mesh abajo a la derecha.

A mesh somebody else exportedUn ala y un cubo, los dos redondos y los dos dibujados con 48 caras. El panel hace sus preguntas antes de construir nada, y las respuestas se ven en el resultado: la cara de arriba y la base salen como caras planas únicas mientras las dos paredes redondas siguen facetadas.

A diferencia de una importación STEP, esta pregunta antes. Una malla no tiene unidades, no tiene caras y no sabe con qué precisión está hecha, y Kapy necesita tus respuestas a eso antes de poder construir nada.

El panel entero está en inglés, esté el resto del editor en el idioma que esté, así que los controles se citan aquí tal y como los vas a leer en pantalla.

Qué ajustar antes de insertar

El panel Insert Mesh
Control Por defecto Qué decide
File Elige el STL o el OBJ. El formato lo marca la extensión
Unit mm Qué significa una unidad del archivo: mm, cm, m o in. Equivocarte aquí es una pieza mil veces más grande
Detect planar faces Activado Si los triángulos coplanarios se funden en caras planas únicas
Planar merge angle 1,0° Cuánto pueden inclinarse dos triángulos entre sí y seguir contando como la misma cara plana. De 0 a 45
Weld tolerance 0,0001 mm Cómo de cerca tienen que estar dos puntos para tratarse como uno antes de nada más
Sewing tolerance 0,01 mm Cómo de ancho puede ser el hueco entre los bordes de dos caras y aun así coserse
Decimate Desactivado Reduce el número de triángulos antes de construir. Se activa solo cuando el archivo pasa del cupo
Target triangles 50000 El número al que decimar

Acierta con la unidad a la primera. La unidad, la tolerancia de soldado y el objetivo de decimación quedan grabados en el cuerpo al pulsar Insert y ya no se cambian. Cambiar de idea significa importar otra vez.

Deja Detect planar faces activado salvo que tengas un motivo. Es la diferencia entre un cuerpo con un puñado de caras planas aprovechables y un cuerpo hecho de diez mil triángulos.

El techo de 50.000 triángulos

El texto que hay bajo el nombre del archivo te dice qué contiene. Por encima de cincuenta mil triángulos añade:

— over the 50,000 budget, decimate to import

y el botón Insert se desactiva. No hay forma de importarlo de todos modos. Activa Decimate, pon un objetivo y Kapy adelgaza la malla antes de construir. Un escaneo o un esculpido lo van a necesitar; una pieza mecánica casi nunca.

El techo existe porque cada triángulo que sobrevive se convierte en geometría real, y un cuerpo con un millón de caras no es algo con lo que se pueda trabajar aunque se pudiera construir.

Qué construye Kapy de verdad

La importación no es una malla guardada con un envoltorio bonito. Kapy construye un cuerpo sólido auténtico a partir de tus triángulos, y en este orden: suelda los puntos duplicados, decima si se lo has pedido, escala a milímetros y luego hace crecer regiones planas, fundiendo cada tirada de triángulos coplanarios en una cara con sus contornos y sus agujeros. Cose esas caras en una cáscara, y cierra la cáscara en un sólido solo si esa cáscara resulta ser estanca.

Cuando sale bien, un aviso emergente cuenta lo que ha pasado, también sin traducir:

Mesh imported: 12,480 triangles → 214 regions → 231 faces · solid

Lee la última palabra. solid significa que tienes un cuerpo cerrado: los booleanos, los cortes y la impresión funcionan como esperas. open shell significa que la malla tenía agujeros o aristas sin pareja y Kapy no ha podido cerrarla. Sigue ahí, se sigue viendo y se sigue exportando, pero es una superficie y no un volumen, y las operaciones que necesitan un sólido no harán lo que esperas. Subir la tolerancia de cosido e importar otra vez es lo primero que hay que probar; reparar la malla en una herramienta de mallas es lo que funciona.

Donde la superficie se curva no hay nada que fundir, y cada triángulo se convierte en su propia cara de tres lados. Pulsa una zona curva de una malla importada y seleccionas un triángulo, no el cilindro al que pertenece. Ese es el estado honesto de la geometría: la curva ya no está, y ningún ajuste de importación la trae de vuelta. Las regiones planas que sí se fundieron, en cambio, se comportan como cualquier otra cara plana, y puedes dibujar croquis sobre ellas y seleccionarlas con normalidad.

Si la misma pieza existe como STEP, importa esa. Importar un STEP te da curvas de verdad y una fracción de las caras.

Después de la importación

El panel se cierra solo al terminar bien y sale el manipulador, así que arrastra las flechas para mover el cuerpo y los anillos para girarlo. Igual que con el STEP, la posición y el giro son cosa del manipulador y no se repiten en el popover de la línea de tiempo.

El popover tiene lo que sigue siendo ajustable, con los rótulos también en inglés:

Lo que todavía puedes cambiar
Control Nota
File Solo lectura. De qué archivo salió este cuerpo
Scale Uniforme, mínimo 0,001. Va encima de la unidad que elegiste al importar
Detect planar faces Vuelve a hacer la fusión. Mira el aviso de abajo
Planar merge angle Igual
Ghost Dibuja el cuerpo semitransparente y no seleccionable, como referencia

La unidad, la tolerancia de soldado y la decimación que aceptaste no están en esa lista. Ya son parte del cuerpo.

El interruptor Ghost de aquí se comporta exactamente igual que en una importación STEP, incluida la parte que más sorprende: un fantasma se dibuja como referencia pero se escribe igualmente en una exportación STL. Ocúltalo o bórralo antes de exportar. Exportar tu modelo tiene la lista entera.

Cuando falla

El formato lo decide la extensión, y solo la extensión. Un archivo que acaba en .obj va al lector de OBJ; todo lo demás va al lector de STL. Renombra un .ply a .stl y se lo comerá el lector de STL, que falla con:

Could not read that file.

El mismo mensaje cubre un STL genuinamente dañado. Los STL binarios y los ASCII se leen los dos, y Kapy los distingue por el tamaño del archivo y no por su cabecera, así que un binario con pinta de ASCII no es un problema.

El lector de OBJ coge vértices y caras e ignora todo lo demás: normales, coordenadas de textura, grupos, suavizado y materiales se descartan. Las caras de más de tres esquinas se parten en triángulos.

That file has no triangles.

El archivo se ha leído y no tenía caras. Aquí acaba un OBJ que es todo curvas y nada de malla.

This mesh has too many triangles — decimate it to a lower count and try again

El cupo otra vez, esta vez desde la construcción y no desde el panel.

Could not build a body from this mesh — it may be empty or badly formed

Los triángulos estaban ahí y no han querido convertirse en cuerpo. Prueba una tolerancia de cosido mayor, después una de soldado mayor, y después repara la malla fuera de Kapy. El panel se queda abierto cuando hay un error precisamente para que cambies un número y vuelvas a pulsar Insert.

Las mallas solo entran por el editor

En el gestor de archivos no hay camino para las mallas. Suelta un STL allí y recibes Unsupported file. Import a .kpy or .step file., que no te trae hasta aquí. Abre o crea un modelo primero, y usa después esta herramienta.

Ver también

Discord