Glosario

Glosario

English · Español

Términos del dominio y del proyecto usados en toda la wiki. Gran parte del código usa identificadores en español (marca, ficha, diseno…); junto al significado en inglés se da el nombre español para que puedas buscarlo.

Términos de Magic y de impresión

Término	Significado
Proxy	Un sustituto impreso de una carta real. La app solo imprime proxies; nunca vende ni distribuye nada.
Impresión (printing)	Una edición concreta de una carta (set, número de coleccionista, idioma). Una carta tiene muchas impresiones; véase Añadir carta y variantes.
Ficha (token)	Una pieza de juego (ficha de criatura, emblema, copia…) que crea una carta. Se detecta automáticamente a partir de los all_parts de Scryfall o del catálogo de Cockatrice. Véanse Integración con Scryfall, Fuentes externas.
DFC	Carta de doble cara (double-faced card). Anverso y reverso son imágenes separadas; la maquetación puede intercalarlas o alinearlas para la impresión a doble cara. Véase Motor de maquetación.
Dúplex	Impresión por las dos caras de la hoja, que exige páginas de reverso reflejadas o alineadas.
Sangrado (bleed)	Área de imagen extra más allá de la línea de corte para que los pequeños errores al cortar no dejen bordes blancos. Por defecto 0.
Guías de corte (cut guides)	Marcas impresas fuera de la carta para cortar por ellas. Apagadas de fábrica.
Cartas grandes	Cartas de tamaño mayor (planos de Planechase, conspiraciones de Archenemy, Vanguard) que tienen hojas propias al final del plan (big_grid, big_cells, Page.big).
Sideboard / Maybeboard	Secciones del mazo en las listas pegadas. Se convierten en las marcas banquillo y opcional.

Términos del mazo y de los datos

Término	Significado
Deck (mazo)	La unidad guardada: el texto de la lista pegada, las cartas resueltas y los ajustes de impresión. Véase Modelo del mazo.
DeckCard	El equivalente a una casilla de carta: su origen, imágenes, ediciones, marca y diseño.
CardSource	De dónde viene una carta: una carta de Scryfall o Custom (imagen propia, opcionalmente vinculada a una carta de Scryfall mediante scryfallId o a una referencia externa externa).
Vincular (linking)	Asociar una carta de imagen propia con una carta real para que obtenga información de carta y estadísticas conservando su imagen propia. Véase Identificación de cartas y OCR.
Marca (mark)	DeckCard.marca: una variante de diseño, una carta opcional o del banquillo. Las cartas marcadas se imprimen, pero proxy_core::model::cuentan las excluye del tamaño, las copias, las estadísticas y la lista exportada. DeckStats.setAside las cuenta.
.pbdeck	Paquete de mazo en un solo fichero con el mazo y sus imágenes. Véase Formato del paquete de mazo.
Almacén de blobs (blob store)	Almacenamiento de imágenes direccionado por contenido en app_data_dir/blobs/ por SHA-256. Los mazos dependen de él, así que nunca se trata como caché. Véase Almacenamiento y blobs.
Caché de renderizado (render cache)	Imágenes derivadas (miniaturas…) en app_cache_dir/renders/. Se puede borrar sin riesgo.
blob_refs	Tabla de qué blobs están referenciados (por ejemplo por diseños) para que la recolección de basura no los borre.
Biblioteca (library)	La lista de mazos guardados con etiquetas, favoritos, notas y portadas. Véase Biblioteca de mazos.

Términos de maquetación y renderizado

Término	Significado
PagePlan	La geometría de cada hoja en milímetros, calculada por proxy-core::layout y consumida tanto por la vista previa como por el PDF. La pantalla nunca calcula posiciones por su cuenta. Véase Motor de maquetación.
Encuadre / estirado (frame / stretch)	La imagen se estira hasta la casilla exacta (imaging::frame) y solo se recorta cuando la proporción difiere en más de MAX_ESTIRADO (15 %). Véase Imagen y PDF.
Desplazamientos de fila (alinear filas)	Correcciones de alineación de la impresora por fila en el panel de exportación.
Casilla (slot)	Una posición de carta en una hoja de la vista previa.
pbimg://	Esquema de URI propio mediante el cual la vista web carga blobs, miniaturas, vistas previas del diseñador y letras. Véase Capa de aplicación Rust.
Trabajo (job)	Una tarea larga de Rust con eventos de progreso (resolver, exportar, identificar en bloque, descargas). Véase IPC y manejo de errores.
Busy	Error que se lanza cuando ya hay un trabajo largo en marcha y se pide otro.

Términos del diseñador

Término	Significado
Diseñador (Diseñar, diseno)	El editor de cartas que renderiza cartas a partir de datos y packs de marcos. Véase Visión general del diseñador.
CardDesign / CardData	Los ajustes de diseño de una carta y sus datos textuales (nombre, tipo, reglas, estadísticas…).
Colección (collection)	Un conjunto con nombre de valores de diseño por defecto compartidos por muchas cartas.
Diseño efectivo (efectivo)	Diseño de la carta sobre colección sobre valores de fábrica, fusionados por diseno::efectivo.
huella	Hash del diseño efectivo y de sus entradas, usado como clave de caché y en las URL pbimg://…/d/<huella>/<width>.
Idioma de diseño (design language, DesignLang)	El idioma en que se pintan los textos de una carta diseñada: uno de los 15 códigos de la app (los de Scryfall), elegido por deck (PrintSettings.designLang). No es el idioma de la interfaz ni el de las impresiones de las cartas. Véase Visión general del diseñador.
ByLang<T>	Un valor por idioma de diseño: es y en siempre, los demás solo si existen (otros). Véase Motor del diseñador.
Letras CJK (CJK fonts)	Noto Sans JP, KR, SC y TC, que se bajan la primera vez que se usa el japonés, el coreano o el chino como idioma de diseño (pesan demasiado para el instalador).
Pack	Un pack de marcos: capas, SVG, letras, estilos y condiciones en el formato descrito en Packs de marcos.
Marcos Original (Original frames)	Marcos de imagen M15 de Card Conjurer, descargados bajo demanda, fijados a un commit y a un SHA-256.
Pack Balatro	El primer pack descargable (pixel art, siete estilos).
Estilo (style)	Una plantilla de marco dentro de un pack, elegida según el tipo de carta o los colores.
FineTuning	Ajustes finos por colección o por carta: alturas y tamaños de texto, interlineado, opacidad de la caja de reglas, radio de la ventana de la ilustración, radio de la carta.
Estrechado (squeeze)	Estrechamiento del título y de la línea de tipo (title_squeeze_min, title_squeeze_base).
Tests dorados (dorados, golden tests)	Tests de renderizado que comparan la salida con imágenes guardadas en proxy-core/tests/dorados/. Véase Tests y CI.
Borrador (draft)	La copia de trabajo editable de un diseño en el diseñador.
design_overlay	Pinta una carta una vez sin su ilustración e informa de dónde está la ventana de la ilustración, para que arrastrar la ilustración no necesite ida y vuelta a Rust. Véase Capa de aplicación del diseñador.

Fuentes e integraciones

Término	Significado
Scryfall	Fuente de los datos y las imágenes de las cartas. Todas las peticiones pasan por el cliente de Rust con limitación de ritmo.
fuentes::Externo	El cliente HTTP con lista de permitidos para toda descarga que no sea de Scryfall: lista fija de sitio + ruta (PERMITIDOS), nueva comprobación de las redirecciones, tope de tamaño, imágenes recodificadas por limpiar_imagen.
Cockatrice / MTGJSON / mtg.io	Catálogo de fichas, índice local de nombres multilingüe y consulta en línea de nombres multilingüe. Véase Fuentes externas.
OCR	Reconocimiento de texto opcional (ocrs) sobre imágenes de carta enteras para identificar originales.
tweakcn	Fuente de temas de color instalables. Véase Temas y skins.

Términos de frontend y herramientas

Término	Significado
Binding	Un tipo de TypeScript generado a partir de un tipo de Rust con ts-rs en src/bindings/ (nunca se edita a mano).
AppError	{ code, params }: la única forma de error que devuelven los comandos; la interfaz la traduce. Véase IPC y manejo de errores.
call()	La única forma en que la interfaz invoca a Rust (src/lib/ipc.ts).
Store	Un store de zustand (deck-store, plan-store, ui-store, trabajo-store, actualizacion-store). Véase Stores de estado.
Skin	Capa de estilo visual (Hera, Zeus) que se combina con el tema y el material. Véase Temas y skins.
t()	Función de traducción: el argumento es la cadena fuente en español; cada traducción vive en src/i18n/<código>/<área>.json, indexada por esa cadena. Véase Internacionalización.
Idioma de la interfaz (interface language)	Uno de los 15 idiomas de la interfaz de src/lib/idiomas.ts (inglés de fábrica), guardado en proxybuilder.lang. Véase Internacionalización.
ScrollArea	El componente de scroll compartido; no se usa overflow-auto nativo.

Véase también

• Arquitectura
• Índice de ficheros
• Convenciones