Qué parámetros exponer

Decide cuáles de los números del objeto puede cambiar quien lo coloca. Apunta al icono Parámetros de la columna de arriba a la derecha del visor y pulsa el candado de cada fila: cerrado deja el número privado, abierto lo manda al panel de la colocación. Expón dos y se ve de qué va el objeto; expón catorce y no los toca nadie.

Ten claro el reparto antes de empezar. En el editor eliges el nombre, el tipo y el candado, y nada más. El mínimo, el máximo, el paso y la descripción que lee quien lo coloca se ponen después, en el asistente de publicación de la tienda, y solo para los objetos que publiques allí. En este editor no hay ni un deslizador ni un campo de límites por ninguna parte.

El candado de exportación

Cada fila de parámetro lleva un candado. Cerrado significa privado, abierto significa exportado, y el aviso describe el clic en vez del estado: un parámetro exportado dice Exportado — clic para mantener privado y uno sin exportar No exportado — clic para exportar. Léelo como una instrucción, no como una etiqueta.

Solo los parámetros exportados llegan a una colocación. Todo lo demás es invisible para quien use tu objeto, que es justo lo que quieres para los veinte números intermedios que necesita tu modelo.

Expón la intención y deriva el resto

La costumbre que separa un objeto bueno de uno cargante: exporta los números que decide quien lo coloca, y calcula todo lo que se deduce de ellos.

Un objeto de alojamiento de tornillo es el ejemplo limpio. Quien lo coloca decide una cosa, la métrica del tornillo. De ahí salen por fórmula el diámetro del alojamiento, la profundidad del avellanado, la pared que lo rodea y la holgura. Exporta BOLT_DIA; haz de los otros cuatro expresiones que lo lean, y déjalos privados. Ahora el objeto no puede quedar en un estado incoherente, porque no hay manera de tocar el avellanado sin tocar el tornillo.

El patrón contrario exporta los cinco y lo llama flexibilidad. Lo que entrega en realidad son cinco maneras de construir algo que no encaja.

De ahí salen dos reglas prácticas:

• Si dos parámetros exportados pueden contradecirse, uno de los dos debería haber sido una expresión.
• Si no eres capaz de escribir una frase que diga qué cambia un parámetro, ese parámetro no pinta nada en el panel. Vas a tener que escribir esa frase igualmente al publicar.

Nombra los parámetros exportados por la cosa que controlan y no por el número que llevan dentro, porque el nombre es lo que ve quien lo coloca y no se puede editar al publicar: WALL, BOLT_DIA o PLATE_T sobreviven a un cambio de valor, y TRES_MM no. Parámetros con nombre cuenta las reglas de nombrado y las palabras reservadas.

Elige el tipo por la forma de la decisión

El tipo queda fijado al crear el parámetro, así que elígelo por la forma de la decisión y no por el valor que tengas a mano.

Un Preajuste (lista) es la herramienta más fuerte de esa tabla, y la más desaprovechada. Una opción puede llevar asignaciones que gobiernen otros parámetros, así que una sola fila M3 / M4 / M5 fija a la vez el diámetro del agujero, el de la cabeza y la profundidad del avellanado, de forma coherente, siempre. Los parámetros que gobierna pasan a solo lectura y muestran ↳ controlado por {nombre} mientras el preajuste los sujeta.

Eso te da una forma que merece la pena copiar. Exporta el preajuste. Deja privados los tres números que gobierna. Quien lo coloca elige una métrica de tornillo y no puede equivocarse en el trío.

Las opciones llevan además un campo de descripción. No lo lee nadie. El popover de la colocación, el panel de vista previa del archivo y la tarjeta de la tienda pintan el nombre de la opción y solo el nombre, y la descripción se descarta en el momento en que el objeto se publica. Así que mete la información en el nombre: M3 (tuerca de 5,5 mm) es un nombre que dice algo, y no viene ninguna segunda línea a explicarlo.

Los límites y las descripciones se ponen al publicar

Este es el reparto que hay que tener claro. El editor de objetos inteligentes no tiene campo para un mínimo, un máximo, un paso ni una descripción, y no hay ninguna interfaz en ningún sitio que ponga un rango a un parámetro. Si sales del editor pensando que has acotado un valor, no lo has hecho.

Eso vive en el asistente del flujo de publicación de la tienda, en su paso Parámetros, que se presenta con Salen del propio documento. Define el rango en el que se puede configurar cada uno y explica qué hace. Por cada parámetro exportado te dan:

• Un recuadro de Descripción, con el aviso Qué cambia este parámetro y qué valores tienen sentido.
• Solo para los números, Mín, Máx y Paso.

El paso no deja seguir hasta que cada parámetro tiene una descripción de verdad, y los números reciben la negativa Un slider necesita un mínimo y un máximo. si falta el mínimo, el máximo o el paso, si el mínimo no está por debajo del máximo, o si el paso no es positivo.

Tómatelo en serio en vez de rellenarlo para pasar de pantalla. Los límites son lo que evita que alguien teclee 90 en un grosor de pared y luego cuente por ahí que tu objeto está roto, y el paso es lo que hace que el deslizador caiga en valores que se puedan imprimir. Un paso de 0,1 mm en una holgura sirve; uno de 0,001 mm es un deslizador imposible de ajustar.

Los rótulos de los tipos no coinciden entre las dos pantallas, y conviene esperárselo: el editor dice Booleano y Preajuste (lista), y el asistente dice Interruptor y Opción.

El control no lo eliges tú

El control que ve quien coloca el objeto se deduce del tipo, y no hay ajuste para él. Un número se vuelve deslizador cuando tiene mínimo y máximo, y un simple campo numérico cuando no. Un booleano se vuelve interruptor, y un preajuste se vuelve desplegable.

Así que los límites no son adorno: darle a un número un mínimo y un máximo es la manera de convertirlo en deslizador. Ese es el mecanismo entero. Si quieres que el objeto se sienta ajustable en vez de tecleable, es ahí donde lo consigues.

Los presets tienen su propio paso en el asistente, descrito como Combinaciones de valores con nombre, para que se pueda partir de algo que ya funciona. Ojo con las palabras: un Preset del asistente es una combinación de valores con nombre para el objeto entero, mientras que un Preajuste (lista) del editor es un tipo de parámetro; la aplicación usa las dos palabras, cada una en su pantalla. A un preset le basta un nombre para contar como completo, pero el nombre es de lo que elige quien coloca, así que 2×3 con imanes gana a Preset 1.

Cuando va mal

Un parámetro que exportaste no aparece en la colocación. Mira el candado: privado es lo que sale por defecto en cada parámetro que creas, así que construir un objeto entero y no exportar nada pasa más de lo que uno diría.

Un valor ajeno produce geometría rota. Un valor fuera de rango es un aviso blando dentro del editor y nunca un bloqueo, y no hay rango alguno hasta que publicas con uno. Si un valor no se puede rebasar, imponlo en el modelo con una expresión en vez de confiar.

Un valor no se deja teclear. Lo está sujetando un preajuste. Esa fila está gobernada, y el preajuste tiene que cambiar o soltarla.

Un parámetro está ámbar con la expresión hace referencia a un parámetro desconocido. Algo que nombra se renombró o se borró, y la fila muestra el último valor que funcionó. Renombrar no reescribe nunca las fórmulas que mencionan el nombre viejo, así que arréglalas a mano.

Borrar un parámetro que algo usa. La confirmación dice '{nombre}' se usa en {n} entrada(s). ¿Eliminar de todos modos? Las entradas vuelven a valores literales. y es exactamente lo que pasa: esos campos se quedan con su número actual como valor literal, nada se pone rojo, y el objeto deja de ser paramétrico en ese punto sin decir nada.

Ver también

• Qué expone un objeto: la geometría y las anclas que forman el resto de la interfaz
• Versiones y publicación: el asistente donde se rellenan límites y descripciones
• Parámetros con nombre: nombres, tipos, preajustes y qué rompe un renombrado
• Expresiones: derivar los números privados de los exportados