kapy academy

Parámetros con nombre

9 min readUpdated ago 2026

Ponle nombre una vez al grosor de pared y todos los pasos que lo usan te siguen cuando lo cambies. Abre la ventana Parámetros desde la pila de ventanas del borde derecho y haz clic en + Añadir parámetro.

La ventana está disponible en todo el modo Diseño, incluso mientras estás dentro de un croquis, así que puedes dar nombre a un valor en el momento en que te hace falta por primera vez.

Making a parameterLa ventana se abre al pasar el puntero y se cierra al salir. Añadir parámetro ofrece los cuatro tipos, y el tipo ya no se cambia después.

Crear uno

+ Añadir parámetro ofrece cuatro tipos.

Los cuatro tipos
Tipo Qué guarda Para qué está
Número Un valor, 0 por defecto Cotas, cuentas, cualquier cosa aritmética
Booleano Verdadero o falso, falso por defecto Encender o apagar una variante
Texto Una cadena, vacía por defecto Etiquetas, y comparaciones contra un preajuste
Preajuste (lista) Una opción de una lista que tú defines Una configuración con nombre que fija varios parámetros a la vez

El tipo queda fijo al crearlo. No hay manera de convertir después un Número en un Booleano, así que si te equivocas, borra la fila y haz una nueva.

Un parámetro nuevo nace con el nombre PARAM_1, PARAM_2 y así, y sin exportar. Antes de que exista ninguno, la ventana dice Aún no hay parámetros. Haz clic en + abajo para crear uno.

Nombrar

Los nombres se guardan en mayúsculas y se comparan sin distinguirlas, así que wall y Wall son el mismo parámetro y los dos se muestran como WALL.

Cuatro reglas, con el mensaje que te llevas por saltarte cada una. El mensaje sale en inglés:

  • No vacío: Name is required
  • Como mucho 64 caracteres: Name is too long (max 64)
  • Una letra primero, y después solo letras, dígitos y guiones bajos: Name must start with a letter and contain only letters, digits, and underscores
  • Que no sea una palabra reservada: '{name}' is a reserved keyword

La lista de reservadas cubre los nombres de función disponibles en las expresiones, pi, true, false, las palabras lógicas and, or, not y xor, y todas las constantes de calibración. Un duplicado se rechaza con A parameter named '{name}' already exists.

Dale al parámetro el nombre de lo que gobierna, no el del número que guarda. WALL, BOLT_DIA, PLATE_T sobreviven a un cambio de valor; TRES_MM no.

Qué muestra una fila

Control Qué hace
Icono de candado Interruptor de exportación. No exportado — clic para exportar / Exportado — clic para mantener privado
Nombre Haz clic en él, o en el lápiz que sale al pasar por encima, para renombrar
Valor El editor de este tipo, un campo de expresión si es un Número
Icono de papelera Eliminar '{nombre}'

Las filas se pueden arrastrar a carpetas que tú crees. La lista en sí siempre va ordenada alfabéticamente, sea cual sea el orden en que hiciste las filas, así que los parámetros relacionados solo se quedan juntos si sus nombres lo están: HOLE_DIA y HOLE_PITCH se ordenan seguidos, DIA y PITCH no.

Qué decide el candado de verdad

El candado no es decoración, y sus dos estados no son «importante» y «poco importante». Exportado significa público: un parámetro que exportas es el que ven los demás, y uno que dejas cerrado es privado del documento y solo se cambia abriendo esta ventana.

Eso pesa en dos sitios.

Si el documento es un objeto inteligente que publicas, sus parámetros exportados son exactamente lo que puede cambiar quien lo coloque: son las filas que aparecen en el panel del objeto dentro de su modelo. Todo lo que dejaste cerrado sigue funcionando, gobierna lo que gobierne y no asoma nunca. Así es como expones BOLT_DIA y dejas fuera de la vista las holguras y los grosores de pared derivados de él.

Si el documento es una pieza que exportas como archivo, los parámetros exportados son los que el diálogo de exportación ofrece sobrescribir, de modo que puedes meter un valor en el momento de exportar sin tocar el modelo. Son también lo que guarda un preajuste de exportación: una instantánea de todos los números exportados en el momento en que lo guardaste, que es lo que permite que un mismo documento escriba un archivo M3 y otro M4. En esa instantánea solo entran números, así que una fila Booleano o Preajuste (lista) se puede sobrescribir en el momento de exportar pero nunca guardarse dentro de uno. Exporta un parámetro más tarde y se une a todos los preajustes de exportación que ya tengas, con su valor por defecto; ciérralo otra vez y desaparece de todos ellos.

Así que exporta los pocos números que describen la pieza para otra persona y deja el resto cerrados. Exportarlo todo le entrega a quien coloque el objeto un muro de filas sin ninguna indicación de cuáles importan.

Usar uno

Cualquier campo numérico de cualquier paso acepta un nombre de parámetro en lugar de un número. Haz clic en el campo, escribe el nombre y acepta la sugerencia. Escribir @ en un campo lista los parámetros y nada más. Expresiones cubre el editor de campo al completo, incluido cómo crear un parámetro desde dentro del campo en el que lo necesitas por primera vez.

Preajustes que gobiernan otros parámetros

Una fila Preajuste (lista) gana un botón Opciones…, que abre la lista de opciones y vuelve a cerrarla como Ocultar opciones. Cada opción lleva un juego de asignaciones: eliges la opción y los parámetros que nombra toman los valores que les da.

Un parámetro gobernado así pasa a solo lectura y muestra ↳ controlado por {nombre} en lugar de su editor, con el tooltip Controlado por el preajuste '{nombre}'. No puedes escribir dentro mientras lo sujete el preajuste.

Todo preajuste tiene una entrada (Personalizado) que existe siempre y no se puede quitar. Seleccionarla suelta las filas fijadas y te las devuelve. Así es como se parte de un preajuste y luego se ajusta un valor.

Un preajuste es la forma correcta para una familia de piezas: M3, M4, M5, cada uno fijando a la vez un diámetro de agujero, un diámetro de cabeza y una profundidad de avellanado.

Renombrar

Haz clic en el nombre, o en el lápiz que sale al pasar por encima, y escribe. Todos los campos que apuntan al parámetro a través del selector siguen el renombrado por su cuenta, así que un agujero gobernado por BOLT sigue funcionando cuando BOLT pasa a ser BOLT_DIA.

Las fórmulas no siguen. Expresiones expone qué le hace un renombrado a una fórmula y qué hay que revisar después; es lo único que hay que comprobar antes de renombrar nada.

Las unidades y los rangos no son lo que parecen

Dos cosas que la ventana insinúa pero no hace.

Las unidades son informativas. No se convierte nada y no se comprueba nada. Todo lo creado desde + Añadir parámetro es milímetros, para siempre, y no hay forma de cambiar la unidad después. El único parámetro que recibe otra unidad es el creado desde dentro del campo de una operación, que hereda la unidad de ese campo. Si necesitas un parámetro de ángulo, créalo desde un campo de ángulo.

Los rangos no hacen nada. Se puede guardar un mínimo y un máximo, pero ninguna parte de la interfaz los fija y nada avisa cuando un valor se sale. Trata todo parámetro como no acotado y pon los límites en el nombre o en el modelo, no en el parámetro.

Borrar uno que está en uso

Borrar un parámetro del que depende algo abre un diálogo de confirmación del navegador en lugar de uno con estilo:

'{nombre}' se usa en {cantidad} entrada(s). ¿Eliminar de todos modos? Las entradas vuelven a valores literales.

Y es exactamente lo que pasa. Todos los campos que apuntaban al parámetro se quedan con el número que muestran ahora mismo, como valor literal, y el enlace desaparece. No se rompe nada y nada se pone rojo, que es lo que hace este borrado fácil de hacer por accidente y difícil de notar después.

Cuando falla

Una fila está en ámbar. Una expresión de dentro nombra algo que ya no existe, porque el nombre se renombró o el parámetro se borró. Dice la expresión hace referencia a un parámetro desconocido, y el valor que ves es el último que funcionó. Abre el campo y arregla el nombre.

Una fila no deja escribir. La está sujetando un preajuste. Pon el preajuste en (Personalizado), o cambia la asignación de la opción.

Un parámetro ha cambiado y parte del modelo no se ha movido. Los campos que no se movieron guardan números literales, o porque nunca estuvieron atados o porque el parámetro al que estaban atados se borró. Abre el paso y comprueba si el campo lleva la marca fx.

Ver también

  • Expresiones: el editor de campo, la sintaxis y crear un parámetro desde dentro de un campo
  • Editar una pieza ya construida: qué reconstruye un cambio de parámetro, y lo que cuesta
  • Cotas: las cotas de croquis que más merece la pena nombrar primero
Discord