Tutorial maxscript introducción

[3dpoder]

1- introducción.
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 .

[elnegrojf]

Buenos días, tengo un código para max script, para importar archivos de RealFlow desde 3dsMax pero lo pego en el max script y no me funciona o no hace nada alguien me puede decir como hago esta tarea, gracias.

[ikerCLoN]

Seguramente, lo que tengas sea un macro script. Al ejecutarlo, búscalo en customize/ customize user interface. Pero para importar archivos de real flow, tienes un plugin en la página web de Next Limit.

Y la próxima vez, intenta escribir en el sitio correcto. A los administradores les cuesta tiempo y esfuerzo mantener todo el foro ordenado.

[elnegrojf]

Lo siento mucho, pero como así que, en el sitio correcto? Disculpa mi ignorancia es que es la primera vez que escribo aquí.

[elnegrojf]

Y sí, tengo el plugin que da corredizoNexlimit, pero no he podido con él, lo instalé, pero no me funciona. Gracias, un feliz día.

[juliux]

3dpoder. Quería hacerte una pregunta, que para colmo de males no sé cómo expresar. A ver, en otros lenguajes es posible poner una orden dentro de una variable y ejecutarla, por ejemplo, en visual Fox.

Ahora necesito algo similar en Maxscript para actuar sobre objetos creados a mano. Son muchos muy similares y los llamo, por ejemplo: tecla01, tecla02 y así hasta una gran cantidad. Como puedo hacer para referenciarlos uno por uno, en un bucle?
Algo que luciera más o menos como (soy novato en Maxscript):
For n = 1 todo 100.

Variable = tecla + (n as string).

Variable, pos.x = n * 200.
)
Ya sé que la sintaxis está mal, estoy tratando de mostrar lo que necesito. Necesito que cada tecla sea tratada de una manera especial, no puedo tratarlas globalmente a todas igual. Gracias por tu atención, a lo mejor hay alguna solución en Maxscript.

[ikerCLoN]

Con Maxscript también puedes hacer eso. Lo que yo te recomiendo es almacenar en una lista (array) todos los objetos a modificar. O usar directamente los nombres de los objetos para efectuar la operación. En cualquier caso:
- Recoge todo lo seleccionado en una lista.

Thelist = #()
For s in selection do.
(

append thelist s.

).

Efectúa la orden en cada elemento de la lista.

For I = 1 todo thelist, count do.
(

thelist[i].position.x = i * 200

).

[Nessito]

Una puntualización. Recoger la selección en un array:

mysel = $selection as array

Y punto pelota. Para procesar la historia:

for item in mysel do.

Item, pos.x *= 200 -o lo que sea.
)

[Ruramuq]

Parece que quieres basarte en el nombre del objecto, tonces:

(tlocal teapots = $Teapot* -también $teapotí?  (si son menos de 100) tfor n in 1 todo teapots, count do t(t teapots[n].pos.x = n * 2 t).
)

En selecciones se puede usar simplemente selection, solo en ciertas ocasiones se usa array, y también se puede usar getcurrentselection().

La función selection existe para simplificar varias acciones, porque es mapeable, o sea puedes usar selecction, pues += 10 en lugar de crear loops.

[juliux]

3dpoder: Hay alguna función capaz de devolver un número rellenado por ceros por la izquierda? Esto es algo que se necesita mucho, especialmente en los bucles for con los que recorremos objetos numerados así 01, 02, 03, etc. Con n as string obtengo el número n hecho cadena, pero, si además lo quiero rellenar por la izquierda con x cantidad de ceros?
Muchas gracias. Estos primeros días con Maxscript voy a estar preguntón.

[Nessito]

Depende de la versión. En el 2008 ya tienes una versión formateante del print: formattedprint() creo que se llama. Busca.

En de todas formas, siempre te puedes hacer una función de este palo:

Fn zerofill num size =
(tlocal result = tlocal aux = num as string tif size > aux.count then t(t for i = 1 todo (size - Aux.count) do result += 0 t) tresult + aux.
)

[juliux]

Muy buena la función que rellena ceros por la izquierda, más compacta que la mía. En otros lenguajes se las conoce como padl, gracias, tengo que espabilarme más.

[Miguel-Arte-3D-1990]

Hola a todos, tengo un ejemplo Maxscript. Este código se crea un botón para mencionar que objetos. Va realizar su trabajo, ejemplo mencionar botón caja etc.

Este código, como le hago, para crear más botones, y que cada botón, mencione.

Su objeto respectivo, por ejemplo, si yo menciono el botón caja, tiene que aparecer caja ok etc.

Y espero una ayuda a todos en general, y estaré agradecido, de ustedes, gracias.

Código:
Rollout pru prueba-nombre del ut.

Button b box -lo que va a tener el ut.

On b pressed do - Cuando presione el botón.

Box() - Lo que va a hacer cuando presione el botón).
).

Createdialog pru-crear el ut.

[Nessito]

Copia/pega el contenido del ut, cambia button b. Por button <loquetesalgadelpito>. Y sustituye la línea box(). Por lo que quieras que haga el botón en cuestión.

[Miguel-Arte-3D-1990]

Hola a todos, ya resolví el caso como activar enlace y desactivar unlink. Ejemplo código: Rollout crearobj activar enlace -activar enlace-.

Button Lin crear.

On Lin pressed do.

B = box name:caja.

P = point name:punto.

B, parent = p.

Select p.

Rollout unlink desactivar unlink -desactivar unlink-.

Button deslink desactivar enlace.

On deslink pressed do.

Select b.
$.parent = ulink.
$punto).
)).
).

Createdialog unlink -desactivar-.

Createdialog crearobj -activar- Resuelto por Miguel.