Catálogos

Este capítulo reúne los enums cerrados y catálogos de HoopLang: los nombres fijos que el compilador acepta (fuentes, telas, underlays, bastidores, anclas y los valores simbólicos de algunas propiedades), las bibliotecas de hilos que trae el proyecto y los formatos de máquina que produce hoop build, con lo que cada uno conserva y los límites que se revisan al exportar. Un nombre fuera de su catálogo es E002 y, si hay uno parecido, el mensaje lo sugiere. Ver también primitivas.md, texto.md, bastidor.md, modulos.md y herramientas.md.

Los valores de un enum se escriben como un nombre suelto, sin comillas (fabric: Pique, align: center) y distinguen mayúsculas.

Resumen#

Telas (Fabric)#

La tela ajusta lo que depende del material (compensación de tirón, underlay, largo máximo de un cruce de satín y orden de bordado) y no lo que no depende de él (largo de puntada, desfase). Se declara en el design (por defecto Twill); la del hoop que monta un diseño manda sobre la de cada diseño. Los valores sólo se usan donde el archivo no escribe la propiedad (ver primitivas.md).

Cómo leer la tabla:

• Comp. tatami / satín: valor por defecto de pull en fill y satin (y en las letras de un text).
• Umbrales underlay satín: anchos medios de columna en que Auto pasa de None a Center, de Center a Edge y de Edge a Zigzag.
• Cruce máx. satín: los cruces más largos se dividen en tramos.
• Densidad tatami: multiplica la separación de filas por defecto de fill (no la escrita en density).
• Orden: vecino más cercano minimiza saltos; gorro borda en franjas desde el eje vertical hacia afuera y de abajo hacia arriba; del centro hacia afuera empuja la deformación hacia la tela libre.

Underlays (Underlay)#

Detalle de cada uno en primitivas.md.

Fuentes (Font)#

En el orden en que se ofrecen: ArialBold, Arial, Futura, Montserrat, Poppins, Roboto, MontserratBlack, RobotoBlack, FuturaBlack, Block, Condensed, Bebas, Oswald, Varsity, Serif, Times, Slab, Playfair, Script, Lobster, Elegant, Brush, Gothic, Stroke. Por defecto, Stroke. Origen, estilo y alto mínimo de cada una en texto.md.

Bastidores (frame)#

Área útil en milímetros (ancho × alto).

Un nombre fuera del catálogo da E002 con la lista completa:

error E002: unknown frame `Brother_100x200` (catalog: Brother_100x100, Brother_130x180, Brother_160x260, Brother_200x200, Brother_200x300, Tajima_150x150, Tajima_240x240, Tajima_360x360, Cap_130x60)

custom con otra cosa que dos Length es E001.

En un design, frame es opcional: no cambia el diseño y se revisa al exportar (ver Límites de máquina). En un hoop es obligatorio y define el área donde se montan los diseños, con margin (5 mm por defecto) hacia adentro (E006 si algo se sale). Ver bastidor.md.

design "Manga" { canvas: rect(size: (40mm, 120mm)), frame: custom(50mm, 130mm), fabric: Stretch }
thread n = #1c1616 "Negro"
layer a { run n { path: path { from (20mm, 5mm) line (20mm, 115mm) } } }

Anclas (anchor)#

Qué punto del lienzo del diseño colocado cae en el at de un place. Por defecto, center.

hoop "Plancha" {
  frame: Tajima_240x240
  fabric: Pique
  margin: 8mm
  place "p_fill.hoop" at (120mm, 60mm) anchor: center
  place "p_run.hoop" at (20mm, 140mm) anchor: top_left
}

(p_fill.hoop y p_run.hoop son los ejemplos de fill y run de primitivas.md, guardados junto al hoop.)

Las formas exponen los mismos nombres como miembros (canvas.top_left, escudo.bottom_center…), además de .top, .bottom, .left, .right, .width y .height; ver expresiones.md.

Bibliotecas de hilos#

El proyecto trae dos bibliotecas en docs/lenguaje/bibliotecas/. Son archivos .hoop que sólo declaran thread; los valores RGB son aproximados.

No hay biblioteca de Madeira ni de otras marcas; una propia se escribe igual (thread oro = #d8a21b "Gold" { brand: "Madeira", code: "1172" }).

Se importan con import (ruta relativa al archivo principal; ver modulos.md), con prefijo o eligiendo nombres:

import brother from "brother.hoop"
import { c002 as negro_janome } from "janome.hoop"

design "Paleta" { canvas: rect(size: (40mm, 30mm)), frame: Brother_100x100 }
layer a {
  fill brother.red { shape: rect(at: (5mm, 5mm), size: (30mm, 20mm)) }
  satin negro_janome { border: rect(at: (5mm, 5mm), size: (30mm, 20mm)), width: 2mm }
}

Al archivo de máquina llegan sólo los hilos importados que se usan.

Formatos de máquina#

hoop build <archivo.hoop> <carpeta> escribe siempre los seis formatos, más dos vistas SVG (<nombre>.svg, realista, y <nombre>.needles.svg). Todos usan una grilla de 0.1 mm. El origen es el centro del bastidor cuando se compila un hoop, y el centro del diseño cuando se compila un design suelto. Los escritores siempre producen un archivo válido: los desplazamientos más largos que lo que admite un registro se parten en varios.

Límites de máquina#

Antes de exportar, hoop build revisa lo que el archivo de máquina no puede arreglar e imprime cada problema (error: …, warning (JEF): …). Estos avisos no detienen la escritura de archivos: aparecen sólo en hoop build, no en hoop check.

Otros mínimos del motor: ninguna puntada de menos de 0.3 mm (las más cortas se funden), y en el tatami ninguna puntada de fila bajo 0.5 mm.