Programación en maxscript

Programación en Maxscript.
2.1 - edición y ejecución de guiones en ficheros. Como se ha comentado en el capítulo 1, en Maxscript se pueden generar nuevas utilidades y funciones para 3d Studio max. Si queremos conservar los guiones de estas utilidades y funciones tendremos que guardarlos en ficheros, ya que el contenido de la ventana oyente se pierde una vez se cierra el programa. Para ello, en lugar de utilizar el oyente de Maxscript, abriremos un guión nuevo mediante el botón abrir guión y escribiremos en el editor de guiones nuestro programa en Maxscript.
http://www.foro3d.com/attachment.php...1&d=1222375021

Si por el contrario ya tenemos un guión escrito y lo queremos modificar podemos presionar el botón abrir guión" o bien mediante la instrucción edit nombrefich.ms desde el oyente de Maxscript. Por convención, los ficheros escritos en Maxscript tienen la extensión *.ms.
2.1.1 - teclas abreviadas.

En este apartado explicaremos todas las teclas de función que se utilizan en Maxscript. No es necesario aprendérselas de memoria, ni mucho menos, pero puede ser útil saber algunas de ellas para ir más rápido y evitar tener que irnos al menú y buscar la función. Se ha de decir que todos los métodos abreviados tienen su equivalente en los menús del oyente y del editor de Maxscript, o sea, que, si no te interesa el tema, puedes pasar al siguiente apartado directamente (confieso que este es un ).

Podemos utilizar teclas abreviadas tanto en el oyente de Maxscript como en el editor de guiones, pero ojo. Hay un par que tienen significado diferente si las aplicas en un sitio o en otro. También hay abreviaciones específicas para el oyente, y abreviaciones sólo para el editor.

Comencemos primero por las que tienen significado diferente.

Teclas abreviadas con significado diferente nombre
significado en oyente
significado en editor
Ctrl + s guardar cómo. Abre un cuadro de diálogo para que el usuario introduzca el nombre del fichero en el que se va a guardar todo el texto activo del oyente. Guardar. Guarda el contenido del editor en el fichero actual. Si el fichero no tiene nombre se abrirá un cuadro de diálogo para que el usuario introduzca el nombre que dese. Ctrl + r ejecutar guión. Se abre un cuadro de diálogo para que el usuario seleccione un fichero de Maxscript. Una vez seleccionado, se procederá a su ejecución. Sitúa el cursor en el lugar donde se había situado anteriormente con un click del botón izquierdo, o en una operación de búsqueda. Esto es un poco complicado de entender. Pongamos un ejemplo. Un usuario ha buscado en su editor la palabra esfera, y ya va por la tercera ocurrencia, pero se da cuenta que la que le interesa es la segunda. Pulsando Ctrl + r se situará en la anterior, que es la que desea.

Otro ejemplo sería cuando un usuario hace click en una posición y luego se va a otro sitio. Podrá recuperar la posición en la que estaba anteriormente el cursor pulsando Ctrl + r.

He de comentar que las teclas Ctrl + r en el editor de guiones particularmente no me han funcionado nunca. No sé si es cosa de mi 3d Studio max o es uno de los muchos errores que tiene nuestro querido Maxscript.

A continuación os muestro otra tabla con funciones exclusivas del editor de guiones:
Teclas abreviadas exclusivas del editor de guiones nombre
significado en editor
Ctrl + e evaluar todo. Evalúa todo el código que hay en el editor de guiones. Es lo mismo que seleccionar todo el texto y pulsar las teclas shift + enter. La ventaja es que no se tiene que seleccionar todo el texto. Ctrl + click derecho del ratón se muestra un menú con todos los elementos (botones, persianas, etiquetas, funciones, etc). De esta forma es más rápido ir de un sitio a otro. Simplemente se ha de pulsar la tecla Control y hacer un click con el botón derecho del ratón y seleccionar el elemento en el que te quieras posicionar con un click del botón izquierdo. El cursor se posicionará en el lugar que has seleccionado. Para que os hagáis una idea del menú que sale pulsando las teclas Control + click derecho del ratón aquí tenéis un ejemplo:
http://www.foro3d.com/attachment.php...1&d=1222375065

La parte izquierda es la que se muestra al pulsar Control + click derecho del ratón. Una vez se ha seleccionado el elemento checkbutton, se muestra la lista de todos los checkbutton que hay en el documento.

La siguiente tabla muestra las teclas abreviadas que tienen el mismo significado tanto en el oyente de Maxscript como en el editor de guiones:
Teclas abreviadas comunes nombre
significado
Ctrl + n nuevo script. Abre una nueva ventana de editor de guiones para que el usuario pueda escribir un nuevo documento de Maxscript. Ctrl + o abrir script. Se muestra un cuadro de diálogo para que el usuario pueda seleccionar un documento existente. Una vez seleccionado, se abrirá el documento Maxscript. Ctrl + z deshacer. Deshace la última modificación que se ha hecho. Sólo tiene memoria para una modificación, o sea, que tened cuidado. Ctrl + x cortar. El usuario ha de seleccionar una parte del documento y pulsar Control + x. La selección desaparecerá (se copia en el portapapeles), pero el usuario podrá recuperarla situando el cursor a donde quiera que vuelva a aparecer y pulsando Control + v. Ctrl + c copiar. El usuario ha de seleccionar un texto y pulsar Control + c. El texto seleccionado se copiará en el portapapeles. Para copiar de nuevo el texto, se habrá de situar en la posición donde dese y pulsar Control + v. La diferencia con cortar es que en este caso el texto seleccionado no desaparece. Ctrl + v pegar. Pega el contenido del portapapeles en la posición donde se encuentre el cursor. Ctrl + a seleccionar todo. Selecciona todo el texto del oyente de Maxscript o del editor de guiones activo en ese momento (donde se encuentre el cursor actualmente). Ctrl + f buscar. Se abre el cuadro de diálogo para buscar un texto. Ctrl + g buscar siguiente. Repite la última búsqueda y selecciona la siguiente ocurrencia del texto que se ha indicado buscar. Ctrl + h remplazar. Abre el cuadro de diálogo de reemplazar. Ctrl + b selecciona el texto entre paréntesis, corchetes y claves. Es útil para saber si has cerrado todos los paréntesis en trozos grandes de código. El usuario tendrá que situar el cursor en cualquier posición que dese y pulsar Control + b.

Por ejemplo: (25 + 4 (345 / 7) -.

Si ponemos el cursor en / y pulsamos Control + b se seleccionara (345 / 7). En cambio, si ponemos el cursor en 8 se seleccionará toda la expresión.

Shift + enter se evalúa todo lo que se ha seleccionado. Ctrl + y rehacer. Vuelve a rehacer lo que se ha deshecho con Control + z Control + i sangría. Pone una sangría en el texto. (equivalente a usar el tabulador). Y esto es todo en cuanto a teclas abreviadas. Ahora que ya os he dado la paliza, podéis ir al apartado siguiente.
2.2 nombres.

Los nombres en Maxscript se utilizan para definir variables, funciones, parámetros, etc. Un nombre necesariamente ha de empezar por un carácter alfabético o bien, por el carácter _. Después del primer carácter, puede haber cualquier número de caracteres alfanuméricos o el carácter _.

A continuación os muestro algunos ejemplos de nombres que son correctos e incorrectos:
correctos
incorrectos

• nomcilindro_1
• _pos_04
• a.
• var2vértices.

• 1nomcilindro.
• ? Pos_04?
• a(7)
• .var2vértices.

Si por algún motivo necesitamos definir un nombre con caracteres ilegales, como un espacio en blanco, una coma, pondremos el nombre entrecomillado. Aquí tenéis un par de ejemplos.

• nombre variable= "pepe"
• objeto.punto, posición= [2,5,10]

3d Studio max tiene un gran número de nombres que contienen espacios. Podremos utilizar el carácter underscore _ en lugar del espacio. De esta forma nos ahorramos poner un montón de comillas. Las dos instrucciones que se muestran a continuación serán equivalentes:

• $cajamesa01.modifiers[#fd 4x4x4]
• $cajamesa01.modifiers[#fd_4x4x4]

Además, se ha de comentar que los nombres en Maxscript no distinguen entre mayúsculas o minúsculas. Los siguientes nombres serían equivalentes:

• nombrevariable.
• nombrevariable.
• nombrevariable.
• nombrevariable.

2.3 cadenas (string) y comentarios.

Las cadenas en Maxscript empiezan y terminan con el símbolo de doble comilla. Estos serían algunos ejemplos de cadenas:

• hola"
• esto es una cadena"

Anteriormente se ha comentado que 3d Studio max no distingue entre mayúsculas y minúsculas. Esto es cierto salvo en una excepción. La comparación entre dos cadenas sí que hace esta distinción. Como podemos observar en la siguiente figura, no será lo mismo una palabra escrita en minúsculas que la misma palabra en mayúsculas:
http://www.foro3d.com/attachment.php...1&d=1222375137


En el ejemplo anterior, el oyente de Maxscript compara el string hola con hola. Podemos ver que el resultado es false. Esto quiere decir que los dos string son diferentes. (ya que estamos, también podemos observar que el símbolo para hacer comparaciones es ==). En el segundo caso, como los dos string son iguales, el oyente devuelve true.

Entre las comillas se puede escribir cualquier tipo de caracteres excepto el propio símbolo de comillas dobles. Si se necesita escribir, se habrá de introducir detrás del carácter de escape \. Por ejemplo, para escribir la frase: Antonio me dijo hola" el otro día, se tendría que poner de la siguiente forma:

• Antonio me dijo \"hola\" el otro día"

Los símbolos que van precedidos del carácter de escape \son los siguientes:

• \" : comillas.
• \\ : carácter \.
• \n: nueva línea.
• \r: retorno de carro.
• \t: tabulación.

Algunas veces necesitaremos introducir comentarios en el código que implementemos. Los comentarios se especificarán mediante dos guiones seguidos. A partir de estos dos guiones ´--, todo lo que se escriba hasta el final de la línea será considerado como un comentario. Por lo tanto, no podremos introducir ninguna línea de código en la parte derecha de los dos guiones. Ejemplos:

• - esto es una línea de comentario.
• x = x + 1 - a partir de los dos guiones no se inserta código.

2.4 números.

Maxscript utiliza dos tipos de número:

• enteros con signo de 32 bits y con complemento de 2 (integer)
• de coma flotante de precisión sencilla. (float).

Para separar los decimales de los números se utiliza un punto. En los paneles dé la versión interactiva de 3d Studio max en español los decimales van precedidos por una coma en lugar de un punto.

Por ejemplo: cuando creamos una esfera en el panel crear y pulsamos el botón esfera, nos salen algunos parámetros que podemos definir utilizando decimales. Por ejemplo, el radio.
http://www.foro3d.com/attachment.php...1&d=1222375170


En la imagen anterior podemos ver, que en la versión interactiva en español los decimales van precedidos por una coma. En cambio, en la misma versión española, si usamos Maxscript, en lugar de la coma tendremos que introducir un punto.

En la versión inglesa, los decimales en la versión interactiva y en Maxscript van precedidos de un punto. Esto puede generar un poco de confusión y se ha de tener en cuenta.

Ejemplos de números en Maxscript:

• 10.7
• 45
• 7.34
• 7e-4
• 45e5

En los dos últimos ejemplos anteriores podemos ver que las potencias de 10 se simbolizan con una e. Para poner 7 * 10-4 (7 por 10 elevado a -4) utilizaremos 7e-4, y para poner 45 * 105 se utilizará 45e5.

Se ha de indicar que los float en Maxscript sólo permiten tener 6 números decimales. A partir del sexto, se redondean. El usuario también ha de saber que si se sobrepasa el rango en los números se producirán errores de desbordamiento imprevisibles.
2.5 expresiones de comparación.

Estas expresiones sirven para comparar diferentes valores de un mismo tipo. Este tipo ha de permitir hacer una comparación. Devuelven como resultado true si se cumplen las condiciones especificadas o false en caso contrario. Maxscript tiene las siguientes expresiones booleanas:
Expresiones booleanas instrucción significado.

• <operando1> == <operando2
• <operando1>.= <operando2>
• <operando1> > <operando2>
• <operando1> < <operando2>
• <operando1> > = <operando2>
• <operando1> < = <operando2>

• operando1 igual a operando2
• operando1 diferente que operando2
• operando1 mayor que operando2
• operando1 menor que operando2
• operando1 mayor o igual que operando2
• operando1 menor o igual que operando2

Las expresiones = =y .=sirven para todos los tipos de Maxscript. Las restantes sólo sirven para los tipos que aceptan comparaciones.

Por ejemplo:
Instrucción devuelve ejemplos 25 = 33 false, ya que 25 es diferente de 23 true=true true, ya que, cierto es igual a cierto true=false false, ya que, cierto no es igual a falos 25.= 33 true, ya que 25 no es igual a 33 true.= true false, ya que, cierto es igual a cierto, no diferente true.= false true, ya que, cierto es distinto a falos 25 > 33 false, ya que 25 no es mayor que 33 25 < 33 true, ya que 25 es inferior a 33 25 >= 25 true, ya que 25 es igual a 25 25 >= 15 true, ya que 25 es mayor que 15 33 <= 25 false, ya que 33 no es menor o igual que 25
Los operandos pueden ser:

• expresiones matemáticas.
• otros operandos (nombres de variables, números, cadenas, etc)
• una llamada a una función.

La prioridad de las expresiones de comparación es inferior que la de las expresiones matemáticas. Esto quiere decir que en una expresión donde haya operaciones matemáticas y de comparación, se ejecutaran primero las operaciones matemáticas y por último las operaciones booleanas.
2.6 expresiones lógicas.

Las expresiones lógicas, al igual que las de comparación dan como resultado los valores true o false. Se utilizan en expresiones condicionales y combinan en sus operandos expresiones matemáticas y de comparación. Las expresiones lógicas en Maxscript son las siguientes (ordenadas de mayor prioridad a menor prioridad):
Expresiones lógicas instrucción significado.

• not <operando1>
• <operando1> and <operando2>
• <operando1> or <operando2> o.

• negación del operando 1
• operando1 y operando2
• operando1 o operando2

Los operandos de las expresiones lógicas han de ser siempre booleanos (devuelven true o false) y pueden ser de los siguientes tipos:

• operandos (nombres de variables, etc).
• expresiones de comparación.
• otras expresiones lógicas.
• llamadas a funciones.

Como se ha dicho antes, los diferentes operandos de la expresión han de dar como resultado siempre true o false, ya que de lo contrario, no se podrá evaluar dicha expresión. Los resultados de las operación con expresiones lógicas son los siguientes:
True true true instrucción valor devuelto or false or false false false or or false true true or true true como se puede observar, la expresión lógica or devuelve true siempre que uno de los operandos sea true. Únicamente en el caso de que todos los operandos sean false, devolverá el valor false.

En el caso de la expresión lógica and, sólo devolverá el valor true en el caso de que todos los operandos sean true. Si por lo menos uno de ellos es false, devolverá el valor false.

Instrucción valor devuelto and false and false false false and true false true and false false true and true true.

La expresión lógica not negara el operando que se encuentre detrás de él. De tal forma que una expresión cierta pasa a ser falsa y al revés.

Not instrucción valor devuelto not false true not true false la prioridad de las expresiones lógicas es inferior a las de comparación y matemáticas. Siempre se ejecutarán en último lugar.

-- IMÁGENES ADJUNTAS --
https://foro3d.com/attachment.php?attachmentid=82229
https://foro3d.com/attachment.php?attachmentid=82230
https://foro3d.com/attachment.php?attachmentid=82231
https://foro3d.com/attachment.php?attachmentid=82232