HoopLang Docs
/
Playground
El libro · Capítulo 10

10. De la pantalla a la máquina

Un diseño que compila no es todavía un bordado. Entre hoop build y la prenda terminada hay un archivo que elegir, una tela que preparar, un estabilizador, una prueba y una regla para medir. Este último capítulo cubre ese camino, con un diseño hecho para la primera prueba en una máquina casera.

Qué formato elegir#

hoop build escribe siempre los seis formatos. Usa el de tu máquina:

MáquinaFormatoNotas
Brother, Babylock.pesguarda los hilos (color y nombre) y la posición en el bastidor
Janome.jefguarda las distancias reales desde el origen; el bastidor más grande que el formato conoce es de 200 × 200 mm
Tajima y la mayoría de las multiaguja industriales.dstel formato universal de la industria; no guarda colores: en la máquina asignas una aguja a cada cambio
Melco, Bernina.exp
Husqvarna Viking, Pfaff.vp3
Singer.xxx

Si no sabes, prueba primero el nativo de la marca. DST es el comodín: casi todas las máquinas lo leen, aunque tengas que volver a decirle los colores.

Las máquinas Tajima, Melco y Singer (DST, EXP, XXX) empiezan a bordar donde está la aguja: centra la aguja en el bastidor antes de empezar, y cada diseño caerá donde dice su at. Las Brother centran el conjunto en el bastidor.

hoop build revisa además los límites de cada formato y te avisa antes de que la máquina rechace el archivo:

Salida del compilador
galeria/plancha.hoop:warning (JEF): 310.4 × 170.4 mm exceeds the largest Janome hoop (200 × 200 mm): the machine may reject it

Entre esos avisos: un diseño más grande que el bastidor, más bloques de color de los que el formato guarda (PES y VP3 guardan unos 255), puntadas de más de 12 mm (quedan sueltas y se enganchan) y saltos largos que una Janome tomaría por un corte.

La tela y el estabilizador#

La tela que declaraste con fabric ajusta las puntadas; el estabilizador (entretela) es lo que la sostiene mientras se borda. Sin estabilizador la tela se frunce, el registro se pierde (el contorno no cae sobre el relleno) y el diseño se deforma al sacarlo del bastidor.

Tela (fabric)EstabilizadorPor qué
Twill: sarga, drill, gabardina, algodón firmede arranque (tearaway), una o dos capasla tela es estable; el estabilizador sólo ayuda durante el bordado
Pique: polera, tejido de puntorecortable (cutaway)el punto se estira; el estabilizador tiene que quedarse para siempre
Fleece: polar, polerónrecortable, y encima una película soluble en agua (topping)el pelo se traga las puntadas; la película las mantiene arriba
Stretch: jersey, bistretchrecortable, mejor si es adhesivolo que más se deforma
Cap: gorroel propio de gorro, de arranque firmela visera curva no perdona

Para toallas y felpa, la película soluble encima es imprescindible: sin ella las letras desaparecen en el rizo.

Al poner la tela en el bastidor: tensa como un tambor, pero sin estirarla. Una tela estirada en el bastidor se encoge al sacarla y el bordado se frunce.

La primera prueba: prueba-brother.hoop#

La galería trae un diseño pensado para la primera prueba en una máquina casera Brother con bastidor mediano (100 × 100 mm): un círculo de 64 mm que prueba cada tipo de puntada.

HoopLang
// prueba-brother.hoop: la primera prueba en una máquina casera Brother con
// bastidor mediano (100 × 100 mm). Un círculo de 64 mm que prueba cada tipo
// de puntada: relleno (fondo), satín (borde), texto con satín, relleno chico
// (estrella) y corrido triple. Tres hilos; tela de algodón firme con
// entretela de arranque.
import brother from "../bibliotecas/brother.hoop"

design "Prueba Brother" {
  canvas: circle(center: (32mm, 32mm), r: 32mm)
  fabric: Twill
}

shape estrella = polygon(
  (32mm, 12mm), (35.5mm, 21mm), (45mm, 21mm), (37.5mm, 26.5mm),
  (40.5mm, 36mm), (32mm, 30.5mm), (23.5mm, 36mm), (26.5mm, 26.5mm),
  (19mm, 21mm), (28.5mm, 21mm))

layer fondo {
  fill brother.blue { shape: canvas.inset(2mm), angle: 45deg }
}

layer detalle {
  fill brother.deep_gold { shape: estrella }
  text brother.white {
    value: "HOLA", font: Montserrat, height: 9mm,
    at: (32mm, 47mm), align: center
  }
  triple brother.white { path: path { from (16mm, 52mm) line (48mm, 52mm) } }
}

layer borde {
  satin brother.deep_gold { border: canvas, width: 3.5mm }
}

Y su bastidor, para que la máquina lo centre en el aro mediano:

HoopLang
// La prueba centrada en el bastidor mediano Brother (100 × 100 mm).
hoop "Prueba Brother" {
  frame: Brother_100x100
  fabric: Twill
  margin: 5mm
  place "prueba-brother.hoop" at (50mm, 50mm) anchor: center
}
Terminal
hoop build docs/lenguaje/galeria/prueba-brother-bastidor.hoop salida/
Salida del compilador
docs/lenguaje/galeria/prueba-brother-bastidor.hoop: 64.4 × 64.4 mm, 7830 stitches, 3 threads, 7 trims, 88 ms

Fíjate en cómo está pensado, porque es lo que aprendiste en el libro:

  • El fondo es un relleno a 45° del lienzo menos 2 mm (canvas.inset(2mm)): así el borde de satín de 3.5 mm cubre el canto del relleno sin cargar demasiado hilo encima.
  • La estrella es un relleno chico, con puntas: prueba que los rellenos chicos quedan definidos y que el solape con el fondo no deja tela a la vista.
  • "HOLA" en Montserrat de 9 mm se borda en satín (menos de 20 mm): prueba los huecos de las letras.
  • El triple prueba una línea fina y visible.
  • El borde de satín va en la última capa, sobre todo lo demás.
  • Tres hilos y siete cortes: una prueba corta, de unos pocos minutos.

Antes de bordar#

  1. Tela: un retazo de algodón firme o drill, no una prenda. Anota cuál.
  2. Estabilizador: de arranque, una capa (dos si la tela es delgada).
  3. Aguja: nueva, de bordado (75/11 es lo común). Una aguja gastada deshilacha el satín.
  4. Hilo: de bordado, calibre 40, en la bobina el hilo de bobina de la máquina (no el de bordar).
  5. Bastidor: la tela tensa, sin estirar; el aro bien apretado.
  6. Velocidad: media o baja para la primera prueba.
  7. El archivo: prueba-brother-bastidor.pes en el pendrive, en la carpeta que tu máquina espera.

Durante#

  • Mira el primer minuto del relleno: si la tela se levanta o hace ondas, falta estabilizador o tensión en el bastidor.
  • En cada cambio de hilo, la máquina se detiene: azul, dorado (la estrella y el borde, que no toca las letras), blanco (las letras y el triple).
  • Corta las hebras de los saltos si tu máquina no tiene cortahilos.

Después: medir y mirar#

Saca el bordado del bastidor, déjalo reposar y mide con una regla:

  • El diámetro: el diseño mide 64.4 mm (lo dice hoop build). Si mide menos en una dirección, la tela se encogió a lo ancho de las filas: falta compensación (pull) o estabilizador.
  • El registro: ¿el borde dorado cae sobre el canto del relleno azul, o se ve tela entre ambos? Si se ve, ¿de qué lado y cuánto? Si es parejo, sube pull; si es de un lado, revisa cómo tensaste la tela.
  • La estrella: ¿se ve tela entre la estrella y el azul? ¿Las puntas quedan definidas o redondeadas?
  • Las letras: ¿los huecos de la "O" y la "A" quedan abiertos?
  • El satín: ¿brilla parejo o se ven puntadas sueltas? ¿Se ve el azul por fuera?
  • El revés: el hilo de bobina debería verse como una franja en el centro de cada columna de satín (un tercio del ancho). Si no se ve, la tensión superior está floja; si casi todo es bobina, está apretada.

Con lo que mediste, ajusta el diseño (density, pull, fabric) y no la máquina, y vuelve a probar. Para pruebas más finas (compensación, solapes, satines de 2 a 8 mm), mira docs/HOJA_DE_PRUEBA.md.

Leer los diagnósticos#

Todo mensaje del compilador tiene la misma forma:

Salida del compilador
archivo:línea:columna: severidad CÓDIGO: mensaje
Salida del compilador
hola-typo.hoop:8:3: error E003: undeclared thread `azull`; did you mean `azul`?
  • error: no compila. Arréglalo.
  • warning: compila, pero mira: es algo que puede salir mal en la tela.

Los códigos que viste en este libro:

CódigoQué significaLo viste en
E000error de sintaxis: falta una llave, una coma, un :cap. 1
E001tipo incorrecto: falta la unidad, un Length donde va un Anglecaps. 1, 7
E002valor fuera de rango o no válido: satín de 9 mm, una fuente que no existecaps. 3, 4
E003hilo no declaradocaps. 1, 5
E004forma vacía o abierta donde se pide cerradacap. 2
E006algo cosido fuera del lienzo o del bastidor, con cuánto y por qué ladocaps. 1, 4, 9
E007nombre repetido, desconocido o que faltacaps. 5, 7, 9
W001detalle de menos de 1.5 mm², no se borda limpiocap. 3
W003satín de más de 7 mmcap. 3
W004texto más chico que el mínimo de su fuente (también al achicarlo con scale)cap. 7
W006dos diseños de un bastidor que se pisancap. 9
W008diseño sin canvascap. 1
W009algo fuera de su insidecap. 6
W010una propiedad que todavía no tiene efecto (rungs)cap. 3

Además, hoop build avisa de los límites de cada formato (warning (JEF): …); si alguno es error (no cabe en el bastidor), escribe los archivos igual pero termina con código de salida 1. La lista completa de códigos está en la referencia de diagnósticos.

Tres hábitos que ahorran tiempo:

  1. Arregla el primer error primero. A veces los siguientes son consecuencia (el compilador evita repetir el de una forma que no se declaró, pero un error de sintaxis esconde todo lo que viene después).
  2. Lee la sugerencia. did you mean acierta casi siempre.
  3. La posición del error es la de tu archivo, aunque el problema esté en un diseño colocado: el mensaje dice in estrella.hoop 18:5 para que sepas dónde mirar adentro.

Si el mensaje habla de un límite (the limit, too large to sew), la entrada es demasiado grande o profunda para procesarla de forma segura. Los topes están muy por encima de cualquier diseño real: un relleno de 400 × 400 mm, un patrón de mil piezas o un polígono de 20 000 puntos compilan sin problema. Reduce las repeticiones, el texto o la complejidad de las formas; no cambies la densidad del bordado para esquivar el error. Los límites y los errores de desbordamiento están en la referencia de diagnósticos.

Hasta aquí#

Ya sabes escribir un diseño con formas, puntadas, texto, hilos, capas, componentes, repeticiones y decisiones; montarlo en un bastidor; elegir el formato y probarlo en la máquina. El resto es práctica: abre la galería (docs/lenguaje/galeria/), cambia una medida, compila y borda.

Resumen#

  • PES para Brother, JEF para Janome, DST para Tajima y multiagujas, EXP para Melco y Bernina, VP3 para Husqvarna y Pfaff, XXX para Singer.
  • El estabilizador depende de la tela: de arranque en tejidos firmes, recortable en punto y elásticas, película soluble encima en polar y felpa.
  • La primera prueba se hace con prueba-brother.hoop en un retazo, y se mide: tamaño, registro, letras, satín, revés.
  • Ajusta el diseño con lo que mides, no la máquina.
  • Un diagnóstico es archivo:línea:columna: severidad CÓDIGO: mensaje; los E… no compilan, los W… avisan.

Referencia: diagnósticos · herramientas · bastidor · catálogos