Descripción de la lección
Añadiendo Controles
8m 42s
Añade controles personalizados en una variedad de formas y usa un script de Lua o el Block Controller para controlarlos.
Transcripción de video
Añadiendo Controles
8m 42s
0:08
Ya sea que estés programando con un script de Lua, el Block Controller o Control Components, el
0:14
resultado final debe de colocarse en algún tipo de botón en una UCI para que el usuario lo active. Tal
0:20
vez tu botón vaya a lanzar tu script personalizado, o tal vez vaya a ser controlado por un script – no
0:25
importa lo que sea, necesitarás vincular esos controles de alguna manera a tu programación. Eso
0:31
significa que necesitas añadir controles en blanco a tu diseño, así que veamos cómo hacer esto en
0:36
cada uno de los tres métodos.
0:38
Como recordatorio, solo hay algunos tipos de controles fundamentales: Los botones (buttons) y las
0:44
perillas (knobs) son interactivos, mientras que los medidores y los LED solo muestran información.
0:51
Los campos de texto pueden potencialmente ser cualquiera – puedes colocar información en un
0:56
campo de texto o puedes usarlo para mostrar otra cadena de control.
1:01
Para añadir un botón en blanco directamente en tu diseño, puedes arrastrar el componente de
1:06
Custom Controls (controles personalizados). De manera predeterminada no tiene nada en su panel
1:12
de control hasta que tú defines qué control quieres aquí en las Propiedades.
1:17
Puedes añadir varias copias del mismo tipo de botón en Grupos, así que seleccionemos un tipo para
1:23
nuestro primer grupo. Aquí parece que hay 20 tipos diferentes de controles, pero son variantes de los
1:29
mismos cinco que mencionamos anteriormente.
1:32
Todos estos son diferentes tipos de perillas, y todos estos son botones ¿ves? Solo tienen rangos
1:40
predeterminados y denominaciones diferentes, los cuales también puedes personalizar.
1:45
Una vez que has seleccionado un tipo de control para un grupo, puedes añadir más controles
1:50
idénticos a este incrementando el número de cuenta (count), desde 1 hasta 256. También tienes la
1:58
opción de añadir un segundo grupo con un tipo nuevo de control.
2:02
Ten en cuenta que no puedes seleccionar el mismo tipo de control para tu segundo grupo. Si
2:07
necesitas más de 256 controles del mismo tipo, solo tienes que añadir otro componente de Custom
2:13
Controls.
2:15
Si recordamos el video pasado del Árbol de Control de Q-SYS, las diferencias entre estos controles
2:20
ahora tienen más sentido. Un botón de mute y un botón toggle, por ejemplo, tienen los mismos
2:26
valores y posición, pero un botón de toggle tiene cadenas de verdadero/falso (true/false) mientras
2:32
que un botón de Mute tiene cadenas de muted/unmuted.
2:36
Si añades una perilla Generic Float (número flotante) con el mismo rango que una perilla de Nivel
2:42
(level knob), entonces tendrán exactamente el mismo valor numérico y de posición, pero la cadena
2:48
de la perilla de nivel incluidrá “dB” al final.
2:53
Visita el archivo de ayuda para una lista completa de los Valores, posiciones y cadenas de estos
2:58
controles, así como sus rangos predeterminados y personalizables.
3:03
Si estás usando Control Components entonces puedes iniciar a conectar estos controles
3:07
personalizados directamente a cualquier pin de control que deseas. Si estás usando el componente
3:13
de Control Script, entonces puedes conectar estos a tu script.
3:18
Puedes hacer referencia a ese control dentro del script usando la palabra clave Controls, la cual es el
3:24
objeto principal del árbol de control.
3:27
En este caso, Controls.Inputs o Controls.Outputs, dependiendo en dónde está conectado. También
3:36
tendrás que escribir en qué pin está conectado dentro de corchetes, lo que se conoce como índice (index).
3:44
Puedes extender este árbol de control al referenciar una propiedad específica del control. Usando el
3:50
comando print que ya aprendimos en el video anterior, puedo mostrar el valor de este control en la
3:55
ventana de depuración (debug window) con el comando “print (Controls.Inputs[1].Value)”.
4:03
Sin embargo, si estás creando controles personalizados solo para conectarlos a un Control Script, tal vez
4:09
quieras usar el componente de Text Controller en su lugar. Este componente también te permite añadir
4:15
controles en blanco a tu diseño, pero estos controles ya están incorporados a tu script, lo que permite
4:21
referenciarlos más fácilmente. Te recuerdo que en versiones anteriores de Q-SYS, tenemos el
4:26
componente de “Scriptable Controls” en lugar del de Text Controller. Su funcionalidad es prácticamente
4:32
la misma pero tienen una interfaz ligeramente diferente. Nos enfocaremos en la versión del Text
4:37
Controller.
4:39
La interfaz para añadir controles en este componente, es diferente al del componente de Custom
4:44
Controls, pero el concepto es el mismo. En lugar de definir los controles en las Propiedades, se pueden
4:50
añadir directamente aquí en el panel de control.
4:53
Comenzaremos dando click en el ícono de “más” para Añadir un Control; después puedes especificar
4:58
qué tipo de control es por categoría. Todos los botones están agrupados juntos, y puedes definir si lo
5:04
quieres un botón momentáneo, toggle o trigger. Si seleccionamos indicadores, encontraremos LEDs,
5:10
Medidores y displays de texto.
5:13
Personalmente, creo que esta organización es más intuitiva que la que vimos en los Custom Controls,
5:18
ya que en esos se enlistan de forma alfabética, mientras que aquí se agrupan por función.
5:24
Para controles con rango personalizable, puedes especificar los valores mínimos y máximos. Y si
5:30
quieres exponer este control para que sea conectado a algo más dentro de Q-SYS, puedes incluir un
5:36
Pin de entrada o de salida, o ambos, lo que será añadido a tu componente en el esquemático después
5:42
de que presiones OK.
5:44
También tienes la habilidad de nombrar este control, lo cual te recomiendo ampliamente. “Control 1
5:50
no es un gran nombre. Puedes llamarlo como tu – Kevin.
5:55
¿Qué? ¿Cómo supe que tu nombre era Kevin? Es que soy mago. Todos los Kevin de allá fuera se
6:01
están volviendo locos mientras que todos los demás pensarán, “Mi nombre no es Kevin”. De
6:06
cualquier manera, el beneficio de nombrar tu control es que puedes referenciar ese control por su
6:11
nombre dentro del script.
6:13
En lugar del Controls.Inputs[1] que vimos en el ejemplo anterior, ahora podemos referenciar este
6:20
control con Controls.Kevin en el script. Y si añades más de 1 del mismo control, puedes hacer
6:28
referencia a ese índice en el Árbol de Control de Lua de esta manera: Controls.Kevin[1], en lugar de
6:35
solo entradas del Control Script.
6:37
Te cuidado con usar espacios en los nombres de tus controles. Si el nombre de tu control incluye
6:43
espacios, necesitarás que tu referencia se encuentre dentro de comillas así: Controls.[“Kevin Jones”].
6:53
Posdata – Si hay un Kevin Jones viendo esto, de seguro enloquecerá.
6:59
También, hazte un favor y usa una manera uniforme en el nombrado, de tal manera que, si otro
7:05
programador necesita trabajar en este diseño algún día, le sea fácil entender tus etiquetas.
7:11
Finalmente, veamos el Block Controller. Doble click abre su panel de control y verás la misma interfaz
7:17
que vimos en el Text Controller. Puedes añadir botones, definir su tipo, etc.
7:23
Una vez más tienes la opción de añadir pines de control al componente y darle a tu control un
7:28
Nombre. Esta vez, no te preocupes si incluyes un espacio en el nombre de tu control. El Block
7:33
Controller sabe cómo compensar este posible error de sintaxis escribiendo debidamente en
7:38
corchetes y comillas cuando compila, así que ¡alócate Kevin! Pon el nombre que quieras.
7:45
Un gran beneficio del Block Controller es que también puedes añadir Conexiones de la misma
7:49
manera. De forma similar a los Command Buttons, puedes especificar si es una conexión TCP, UPD o
7:56
Serial y ponerle un nombre.
7:58
La dirección IP y el número de puerto pueden ajustarse cuando entres en Modo Emulación o corras
8:03
tu diseño, o si deseas controlar estos de manera dinámica, puedes exponer pines de control para ellos.
8:10
Dentro del Block Controller, verás estas conexiones enlistadas debajo de tus controles, con nuevos
8:16
bloques asociados con todas las acciones posibles que podrían realizarse con una conexión como
8:21
esta. Veremos esas conexiones en otro video.
8:25
Y de esta manera añadimos controles. Hay un ejercicio rápido en tu Hoja de Trabajo de Control para
8:30
que puedas trabajar. Una vez que termines, pasa a la siguiente sección donde veremos otras de las
8:35
divisiones del Árbol de control asociadas con estos controles.
Descargas
Añadiendo Controles
8m 42s