1.1 – descripción general de Maxscript. Maxscript es un lenguaje de alto nivel orientado a objetos y de sintaxis muy sencilla. Está pensado para usuarios de 3d Studio max que no estén familiarizados con la programación. Sus variables son sin tipo y no hay distinción entre mayúsculas y minúsculas.
Este lenguaje no necesita compilador. Todas las instrucciones se llevan a cabo en tiempo de ejecución.
Podemos utilizar Maxscript y 3d Studio max al mismo tiempo. Se puede crear un cubo en Maxscript y seguidamente, modificarlo en 3d Studio.
Algunos ejemplos de utilización de este lenguaje pueden ser:
- creación de escenas complejas que interactivamente serían demasiado complicadas de llevar a cabo.
- creación de herramientas de proceso por lotes.
- generación de funciones nuevas para facilitar una determinada tarea.
- uso de casi todas las funciones de 3d Studio max.
- creación de nuevos paneles y ventanas con utilidades para 3d Studio max.
1.2 – cómo se accede a Maxscript.
Maxscript se encuentra en el panel de herramientas. 
En este panel hay una persiana de utilidades, y dentro de ella se puede presionar el botón Maxscript.
Una vez se haya abierto la persiana de Maxscript podremos acceder a las opciones: abrir oyente, guión nuevo, abrir guión, ejecutar guión y cerrar.[*]abrir oyente: abre la ventana oyente de Maxscript. Si pulsamos esta opción y el oyente está minimizado, o escondido detrás de otra ventana, lo restaurara. Si la cierra y la vuelve a abrir, conserva el texto que había antes de cerrarla.
[*]guión nuevo: abre un editor en una ventana nueva, donde se puede escribir un nuevo guión en Maxscript.[*]abrir guión: al pulsar esta opción se abre un cuadro de diálogo de apertura de archivos en el que el usuario ha de elegir un guión en Maxscript. Una vez escogido el guión se abrirá una ventana editora de Maxscript con el contenido del fichero.[*]ejecutar guión: el usuario escoge un guión en Maxscript y éste se le y se ejecuta. La salida puede verse, dependiendo del tipo de guión, en los visores de 3d Studio max o bien en la ventana oyente de Maxscript.[*]utilidades: muestra las utilidades de guión disponibles.[*]cerrar: cierra la utilidad Maxscript.
1.3 – utilización del oyente de Maxscript.
En el oyente se pueden ejecutar comandos y expresiones. Para ejecutarlos, simplemente se escribe el comando o expresión y se pulsa la tecla enter.
Podemos desplazarnos por el texto del oyente como si fuese un editor normal. También se puede cortar, copiar y pegar el texto seleccionado (Control-x, Control-c, Control-v) y editar nuevos comandos en medio del texto, o modificar los que ya teníamos y después ejecutarlos.
Para ejecutar comandos en medio del texto, después de editarlos en una línea nueva, se ha de pulsar la tecla enter del teclado numérico, o bien presionar mayúsculas – enter. Los resultados se muestran en la misma ventana, bajo el comando o los comandos ejecutados.
Es posible ejecutar bloques de código seleccionándolos previamente y pulsando las teclas mayúsculas – enter o bien, presionando enter desde el teclado numérico.
La instrucción include nombre fichero. Extensión" inserta el contenido del fichero nombre fichero" en el oyente sin ejecutarlo.
Se puede seleccionar el texto y ejecutarlo por trozos.
Podemos trabajar con el oyente de Maxscript y con 3d Studio max al mismo tiempo.
1.4 – variables en Maxscript.
Las variables se utilizan para almacenar datos que varían durante la ejecución del programa. En Maxscript no es necesario declarar las variables antes de utilizarlas.
Tenemos dos clases de variables en Maxscript:[*] variables locales:[*] se considerarán variables locales aquellas que se utilicen por primera vez dentro de un bloque o función. En caso contrario, las variables se considerarán globales.[*] sólo son visibles en el bloque o función donde se declaran.[*] su valor se mantiene mientras se está ejecutando la función o el bloque donde se encuentran.[*]variables globales:[*] son visibles en todo el código Maxscript.[*] podemos acceder a ellas desde diferentes utilidades, funciones, etc. Su valor permanece hasta que se sale de 3d Studio max.
La primera vez que se utiliza una variable Maxscript la inicia como undefined.
Para que el código sea más claro, es recomendable indicar de que clase son las variables. Para ello, utilizaremos los términos local y global. Nótese que los comentarios en Maxscript van precedidos de 2 guiones – -".
Local x = 2, m = 3.7.
Local y, z, r.
Global texto = hola.
Global i = 1, – la declaración continúa en las líneas siguientes.
J = 3.
Que = sin (35).
Local f=g=h=0.
En la declaración de variables, podemos definir si son globales o locales, pero no indicamos de qué tipo son. Esto es debido a que las variables son libres de tipo. Las variables pueden cambiar el tipo de valor en las asignaciones. Por ejemplo, en una primera asignación una variable puede ser un entero, y en una segunda asignación, la variable puede ser una cadena de caracteres. Esto no quiere decir que se puedan hacer operaciones incorrectas. Si tratamos de hacerlas, Maxscript dará un error. Para convertir un tipo de variable en otro tipo utilizaremos la instrucción (as) de la siguiente forma:
valor as nuevo_tipo.
Nótese en la imagen siguiente que las salidas de comando en el oyente siempre son de color azul, excepto en los errores.
1.5 – operaciones matemáticas en Maxscript.
Cuando introducimos una operación matemática en Maxscript, éste evalúa dicha operación y muestra el resultado en la ventana oyente. Maxscript dispone de las operaciones matemáticas necesarias para hacer que funcione de forma semejante a una calculadora.
Las expresiones matemáticas están compuestas por operadores (+,-,*.) y por operandos. Un operando matemático puede ser:[*] un nombre de variable, números, etc. Por ejemplo:[*]1 + 3 – suma ambos números.[*]total – 5 – suma 5 al valor de la variable total.[*]total + iva – suma el valor de la variable total más el valor de la variable iva.[*] una llamada a una función. Por ejemplo.[*](gradosaradianes grados:180) + 5 – llama a la función gradosaradianes pasando como parámetro 180 grados y al resultado le suma 5.[*]una expresión matemática. Por ejemplo:[*]123 + (total – iva) – restamos el contenido de la variable iva al contenido de total y le sumamos el valor 123.
En la tabla siguiente podemos ver las expresiones matemáticas que tiene Maxscript.
Operaciones matemáticas.
<operando_matemático> + <operando_matemático> suma <operando_matemático> – <operando_matemático> resta <operando_matemático> * <operando_matemático> multiplicación <operando_matemático> / <operando_matemático> división <operando_matemático> <operando_matemático> exponencial <operando_matemático> as <factor> conversión entre tipos.
En la figura siguiente tenemos unos ejemplos de expresiones matemáticas en el oyente de Maxscript:
También se puede utilizar el formato abreviado de asignación del lenguaje c para modificar un valor contenido en una variable. Por ejemplo:
Formato abreviado de asignación.
X + = 5 – incrementa en 5 el valor de x.
Y * = 7 – multiplica por 7 el valor de y.
Z – = 9 – resta 9 al valor de z.
Que / = 8 – divide que entre 8.
1.6 – objetos de 3d Studio max en Maxscript.
Maxscript puede trabajar con objetos de 3d Studio max al mismo tiempo que se trabaja con ellos de forma interactiva a través de los botones y paneles. De hecho, los objetos pueden ser creados, transformados, modificados y eliminados desde Maxscript al igual que se hace desde 3d Studio max.
Los comandos de creación de objetos coinciden con los nombres de estos objetos. Podemos crear una caja tan sólo escribiendo en la ventana oyente el comando box (), o bien, si tenemos la versión, su equivalente en español caja (). Una vez escrito, y después de presionar la tecla Intro, se crea una caja con los parámetros por defecto. Es recomendable escribir los comandos en inglés, ya que no todos los parámetros que hay se han traducido al español. En este tutorial escribiremos todos los comandos y parámetros en inglés.
Es indiferente si escribimos el comando en mayúsculas y en minúsculas, ya que Maxscript no distingue entre ellos. También se recomienda asignar el objeto a una variable, para hacer más manejable el uso de dicho objeto. Si el objeto creado no se asigna a ninguna variable y queremos referirnos a él utilizaremos el símbolo $" delante del nombre que tiene el objeto en la escena.
Pongamos un ejemplo de creación de una caja de altura 20, anchura 30 y longitud 40. Asignaremos el resultado a la variable primera caja:
Cuando utilizamos el comando box con parámetros, se eliminan los paréntesis y en su lugar ponemos los nombres de los parámetros seguidos de los dos puntos y su valor. Los parámetros que se omiten adquieren su valor por defecto.
Cuando Maxscript ha creado la caja devuelve el nombre que tiene dicha caja en la escena (en este caso, el nombre será caja01") y al mismo tiempo indica la posición que tiene la nueva caja en la escena (con las coordenadas x y, z separadas por comas y dentro de corchetes). Maxscript dibuja la caja en la escena. Se puede trabajar con la nueva caja desde 3d Studio max como si se hubiese creado de forma interactiva. Podemos transformarla, modificarla, eliminarla e incluso deshacer la creación de la caja con el botón deshacer.
Atención: no es lo mismo el nombre que tiene la caja en la escena (caja01) que el nombre de variable en Maxscript (primera caja).
Utilizaremos la variable primera caja para acceder más fácilmente a los parámetros de creación y a las propiedades generales y de transformación:
En la imagen anterior hay varios ejemplos de modificación de algunos parámetros de la caja. Podemos modificar todos los parámetros del objeto (altura, radio, etc), de nodo (nombre, color,) y de transformación (rotación, posición, etc). Para modificar un valor en un objeto utilizaremos uno de los siguientes es quemas:[*] $nombreobjeto. Parámetro=nuevovalor.[*] nombrevariable. Parámetro=nuevovalor.
Donde nombreobjeto sería equivalente a $caja01 en el ejemplo anterior y nombrevariable equivale a primera caja.
1.6.1 – showclass.
Para saber los nombres y tipos de parámetros de un objeto se puede utilizar la función showclass(). Si escribimos en el oyente de Maxscript sólo el nombre de la función seguido de los dos paréntesis tendremos una lista de todos los objetos de 3dstudio Max y sus parámetros correspondientes. Cada parámetro ira seguido de su tipo.
Lo más normal es que se quiera saber los parámetros de un objeto determinado, sin necesidad de que salgan todos los objetos de 3d Studio max. Tenemos dos ejemplos de ello en el siguiente recuadro.
Ejemplos de showclass showclass box.* – muestra todos los parámetros de la clase box.
Box(caja) : geométricas {10,0}.
Height(altura) : float.
Length(longitud) : float.
Lengthsegs : integer.
Width(anchura) : float.
Widthsegs : integer.
Mapcords : bolean.
Heightsegs(segmsaltura) : integer.
Ok.
Showclass box.height – muestra todos los datos del parámetro height.
Box(caja) : geometryclass {10,0}.
Height(altura) : float.
Ok.
En el primer ejemplo indicamos con un asterisco que queremos saber todos los parámetros del objeto box. Utilizamos el asterisco como un comodín. Si quisiésemos saber todos los parámetros de los objetos que comenzasen por b" sólo tendríamos que poner showclass b*.*" y obtendríamos una lista con ellos. Si por el contrario ya sabemos el parámetro, pero no estamos seguros del tipo que tiene, nos bastara con poner showclass "box. Nombreparametro.
En el segundo ejemplo de showclass hemos comprobado que el parámetro height de la clase box es del tipo float.
Fuente oficial: bienvenidos a la página de eloweyn .