3.1 loadFBXParsed(parsedObject)

Recibe un THREE.Object3D ya parseado (por ejemplo, el resultado de una carga manual de FBX) y lo agrega como hijo de este XUEmptyObject. Ajusta la escala a (1,1,1) por defecto.

Parámetros:

• parsedObject: Una instancia de THREE.Object3D (FBX parseado).

Ejemplo:

// Si obtuviste un FBX con parseFBX
const parsedObj = await parseFBX("Assets/Modelos/Robot.fbx");
const emptyObj = new XUEmptyObject(scene, objects, {...});
emptyObj.loadFBXParsed(parsedObj);
                            

3.2 loadFBX(url)

Llama internamente a un FBXLoader y, al terminar la carga, agrega el modelo como hijo de este XUEmptyObject.

Parámetros:

• url: Ruta o URL del archivo FBX a cargar (string).

Ejemplo:

const emptyObj = new XUEmptyObject(scene, objects, {
    fbxUrl: "Assets/Prefabs/Cubo01.fbx"
});
// O también:
emptyObj.loadFBX("Assets/Prefabs/OtroModelo.fbx");
                            

3.3 setPosition(x, y, z)

Ajusta la posición en la escena. Internamente llama a this.position.set(...) de THREE.Object3D.

Ejemplo:

emptyObj.setPosition(2, 1, -3);
                            

3.4 setRotation(x, y, z)

Ajusta la rotación en radianes alrededor de los ejes X, Y y Z.

Ejemplo:

// Rotar 45° en Y
emptyObj.setRotation(0, Math.PI/4, 0);
                            

3.5 setScale(x, y, z)

Ajusta la escala del objeto. Todos los hijos del XUEmptyObject se verán afectados.

Ejemplo:

// Duplicar su tamaño en cada eje
emptyObj.setScale(2, 2, 2);
                            

3.6 getPosition()

Devuelve la posición actual como un THREE.Vector3 clon.

Ejemplo:

const pos = emptyObj.getPosition();
XUConsole(pos.x, pos.y, pos.z);
                            

3.7 getRotation()

Devuelve la rotación actual como un THREE.Euler clon. Los valores de x, y, z están en radianes.

Ejemplo:

const rot = emptyObj.getRotation();
XUConsole(rot.x, rot.y, rot.z);
                            

3.8 getScale()

Devuelve la escala actual como un THREE.Vector3 clon.

Ejemplo:

const scl = emptyObj.getScale();
XUConsole(scl.x, scl.y, scl.z);
                            

2.1 addWidget(id, options)

Crea un nuevo widget dentro del contenedor principal o dentro de otro widget padre. Retorna el elemento HTML creado.

Parámetros:

• id: Identificador único (string) para tu widget.
• options: Objeto con múltiples propiedades de configuración.

Ejemplo básico:

// Crear un panel con fondo gris y texto
UIManager.addWidget('miPanel', {
    widgetType: 'panel',
    layout_width: '200px',
    layout_height: '100px',
    backgroundColor: '#ccc',
    text: 'Soy un panel simple'
});
                                    

Para ver todas las propiedades disponibles, revisa la sección de tipos de widget y la documentación de options.

2.2 updateWidget(id, newOptions)

Actualiza dinámicamente las propiedades de un widget existente.

Ejemplo:

// Cambiar el color de fondo y el texto de un panel existente
UIManager.updateWidget('miPanel', {
    backgroundColor: 'lightblue',
    text: 'Nuevo texto en mi panel'
});
                                    

2.3 removeWidget(id)

Elimina el widget (y todos sus hijos) dado su id.

Ejemplo:

// Remover un widget llamado 'miPanel'
UIManager.removeWidget('miPanel');
                                    

2.4 getWidgetProperty(id, prop)

Retorna el valor actual de la propiedad prop en el widget con id dado.

Ejemplo:

// Obtener el 'text' de un panel
const texto = UIManager.getWidgetProperty('miPanel', 'text');
XUConsole(texto);
                                    

2.1 setDimensions(width, height, depth)

Actualiza las dimensiones del cubo. Destruye la geometría anterior y crea una nueva con los valores indicados.

Parámetros:

• width: Ancho (número).
• height: Alto (número).
• depth: Profundidad (número).

Ejemplo:

// Cambiar el cubo a tamaño 2 x 3 x 1
miCubo.setDimensions(2, 3, 1);
                            

2.2 getDimensions()

Retorna un objeto con las dimensiones actuales: { width, height, depth }.

Ejemplo:

const dims = miCubo.getDimensions();
XUConsole(dims.width, dims.height, dims.depth);
                            

2.3 setColor(color)

Cambia el color del cubo.

Parámetros:

• color: Color en valor hexadecimal (por ej. 0xff0000) o cadena ("#ff0000").

Ejemplo:

// Cambiar el cubo a color rojo
miCubo.setColor(0xff0000);
                            

2.4 getColor()

Retorna el color actual del cubo como un número en formato Hex (por ejemplo, 16711680 es 0xff0000).

Ejemplo:

const currentColor = miCubo.getColor();
XUConsole("Color actual:", currentColor.toString(16));
                            

2.5 setPosition(x, y, z)

Cambia la posición del cubo en tu entorno 3D.

Parámetros:

• x, y, z: Coordenadas de posición (números).

Ejemplo:

// Mover el cubo a la posición (3, 1, -2)
miCubo.setPosition(3, 1, -2);
                            

2.6 getPosition()

Retorna la posición actual del cubo como un objeto con { x, y, z }.

Ejemplo:

const pos = miCubo.getPosition();
XUConsole(pos.x, pos.y, pos.z);
                            

2.7 setRotation(x, y, z)

Cambia la rotación del cubo en radianes alrededor de los ejes X, Y y Z.

Parámetros:

• x, y, z: Rotaciones en radianes.

Ejemplo:

// Rotar el cubo 45° en eje X, 30° en eje Y, 0° en Z
// Nota: 45° = Math.PI / 4 radianes
miCubo.setRotation(Math.PI / 4, Math.PI / 6, 0);
                            

2.8 getRotation()

Retorna la rotación actual del cubo como un objeto con { x, y, z }, donde cada valor está en radianes.

Ejemplo:

const rot = miCubo.getRotation();
XUConsole(rot.x, rot.y, rot.z);
                            

2.9 setScale(x, y, z)

Cambia la escala del cubo a lo largo de cada eje.

Parámetros:

• x, y, z: Factores de escala para cada eje.

Ejemplo:

// Escalar el cubo al doble en X y Z, y la mitad en Y
miCubo.setScale(2, 0.5, 2);
                            

2.10 getScale()

Retorna la escala actual del cubo como un objeto con { x, y, z }.

Ejemplo:

const scl = miCubo.getScale();
XUConsole(scl.x, scl.y, scl.z);
                            

2.1 setSphereParams(radius, widthSegments, heightSegments)

Actualiza los parámetros de la esfera: radius, widthSegments y heightSegments. Internamente se desecha la geometría previa y se crea una nueva con los valores proporcionados.

Parámetros:

• radius: Radio de la esfera (número).
• widthSegments: Segmentos en el eje horizontal (número).
• heightSegments: Segmentos en el eje vertical (número).

Ejemplo:

// Cambiar la esfera a radio 2, con 24 segmentos de ancho y 24 de alto
miEsfera.setSphereParams(2, 24, 24);
                            

2.2 getSphereParams()

Retorna un objeto con los parámetros actuales de la esfera: { radius, widthSegments, heightSegments }.

Ejemplo:

const params = miEsfera.getSphereParams();
XUConsole(params.radius, params.widthSegments, params.heightSegments);
                            

2.3 setColor(color)

Cambia el color de la esfera.

Parámetros:

• color: Valor en formato hexadecimal (por ejemplo, 0xff0000) o string ("#ff0000").

Ejemplo:

// Cambiar el color a azul
miEsfera.setColor(0x0000ff);
                            

2.4 getColor()

Retorna el color actual de la esfera como un número entero en formato Hex (por ejemplo, 16711680 representaría 0xff0000).

Ejemplo:

const currentColor = miEsfera.getColor();
XUConsole("Color actual (hex):", currentColor.toString(16));
                            

2.5 setPosition(x, y, z)

Cambia la posición de la esfera en tu entorno 3D.

Parámetros:

• x, y, z: Coordenadas de posición (números).

Ejemplo:

// Mover la esfera a la posición (2, 1, -3)
miEsfera.setPosition(2, 1, -3);
                            

2.6 getPosition()

Retorna la posición actual de la esfera como un objeto con x, y y z.

Ejemplo:

const pos = miEsfera.getPosition();
XUConsole(pos.x, pos.y, pos.z);
                            

2.7 setRotation(x, y, z)

Cambia la rotación de la esfera alrededor de cada eje (x, y, z), en radianes. Por ejemplo, Math.PI / 2 equivale a 90 grados.

Parámetros:

• x, y, z: Ángulos en radianes.

Ejemplo:

// Rotar la esfera 45° en eje X, 45° en Y
miEsfera.setRotation(Math.PI / 4, Math.PI / 4, 0);
                            

2.8 getRotation()

Retorna la rotación actual de la esfera como un objeto con los valores x, y y z en radianes.

Ejemplo:

const rot = miEsfera.getRotation();
XUConsole(rot.x, rot.y, rot.z);
                            

2.9 setScale(x, y, z)

Cambia la escala de la esfera en cada eje. Por lo general, usarás un mismo valor para x, y y z si deseas conservar la forma completamente esférica; sin embargo, es posible deformarla si lo necesitas.

Parámetros:

• x, y, z: Factores de escala para cada eje.

Ejemplo:

// Escalar la esfera al doble en todos los ejes
miEsfera.setScale(2, 2, 2);
                            

2.10 getScale()

Retorna la escala actual de la esfera como un objeto con x, y, z.

Ejemplo:

const scl = miEsfera.getScale();
XUConsole(scl.x, scl.y, scl.z);
                            

2.1 setCylinderParams(radiusTop, radiusBottom, height, radialSegments)

Actualiza los parámetros principales del cilindro. Elimina la geometría anterior y crea una nueva según los valores proporcionados.

Parámetros:

• radiusTop: Radio en la parte superior.
• radiusBottom: Radio en la parte inferior.
• height: Altura total del cilindro.
• radialSegments: Cantidad de segmentos que conforman el perímetro.

Ejemplo:

// Cambiar el cilindro a una altura de 5, parte superior 1, parte inferior 2
miCilindro.setCylinderParams(1, 2, 5, 24);
                            

2.2 getCylinderParams()

Devuelve un objeto con las propiedades actuales del cilindro: { radiusTop, radiusBottom, height, radialSegments }.

Ejemplo:

const params = miCilindro.getCylinderParams();
XUConsole(params.radiusTop, params.radiusBottom, params.height, params.radialSegments);
                            

2.3 setColor(color)

Cambia el color del cilindro.

Parámetros:

• color: Valor en formato hexadecimal (ej. 0x00ff00) o cadena ("#00ff00").

Ejemplo:

// Cambiar a color verde
miCilindro.setColor(0x00ff00);
                            

2.4 getColor()

Retorna el color actual del cilindro como un número en formato Hex (por ejemplo, 16711680 representa 0xff0000).

Ejemplo:

const currentColor = miCilindro.getColor();
XUConsole("Color actual:", currentColor.toString(16));
                            

2.5 setPosition(x, y, z)

Ajusta la posición del cilindro en tu entorno 3D.

Parámetros:

• x, y, z: Coordenadas numéricas para cada eje.

Ejemplo:

// Mover el cilindro a (2, 3, -1)
miCilindro.setPosition(2, 3, -1);
                            

2.6 getPosition()

Retorna un objeto con la posición actual del cilindro: { x, y, z }.

Ejemplo:

const pos = miCilindro.getPosition();
XUConsole(pos.x, pos.y, pos.z);
                            

2.7 setRotation(x, y, z)

Cambia la rotación del cilindro en radianes alrededor de los ejes x, y y z.

Parámetros:

• x, y, z: Valores de rotación en radianes.

Ejemplo:

// Rotar el cilindro 90° en eje X, 45° en eje Y
miCilindro.setRotation(Math.PI/2, Math.PI/4, 0);
                            

2.8 getRotation()

Devuelve un objeto con la rotación actual del cilindro en radianes: { x, y, z }.

Ejemplo:

const rot = miCilindro.getRotation();
XUConsole(rot.x, rot.y, rot.z);
                            

2.9 setScale(x, y, z)

Cambia la escala del cilindro en cada eje. Si quieres conservar la forma cilíndrica, mantén factores iguales en x y z (normalmente).

Parámetros:

• x, y, z: Valores de escala para cada eje.

Ejemplo:

// Escalar el cilindro al doble en X y Z, sin cambiar Y
miCilindro.setScale(2, 1, 2);
                            

2.10 getScale()

Retorna un objeto con la escala actual del cilindro: { x, y, z }.

Ejemplo:

const scl = miCilindro.getScale();
XUConsole(scl.x, scl.y, scl.z);
                            

2.1 setPlaneParams(width, height)

Ajusta las dimensiones del plano. Se destruye la geometría anterior y se crea una nueva con los valores indicados.

Parámetros:

• width: Ancho del plano (número).
• height: Altura del plano (número).

Ejemplo:

// Cambiar el plano a 20 x 15
miPlano.setPlaneParams(20, 15);
                            

2.2 getPlaneParams()

Retorna un objeto con las dimensiones actuales del plano: { width, height }.

Ejemplo:

const dims = miPlano.getPlaneParams();
XUConsole(dims.width, dims.height);
                            

2.3 setColor(color)

Cambia el color del plano.

Parámetros:

• color: Valor en formato hexadecimal (ej. 0xff0000) o cadena ("#ffffff").

Ejemplo:

// Cambiar el plano a color verde
miPlano.setColor(0x00ff00);
                            

2.4 getColor()

Retorna el color actual del plano como un número en formato Hex (por ejemplo, 16777215 equivale a 0xffffff).

Ejemplo:

const currentColor = miPlano.getColor();
XUConsole("Color actual (hex):", currentColor.toString(16));
                            

2.5 setPosition(x, y, z)

Cambia la posición del plano en el entorno 3D.

Parámetros:

• x, y, z: Coordenadas numéricas.

Ejemplo:

// Mover el plano a X=5, Y=0, Z=-2
miPlano.setPosition(5, 0, -2);
                            

2.6 getPosition()

Retorna la posición actual del plano como un objeto con x, y, z.

Ejemplo:

const pos = miPlano.getPosition();
XUConsole(pos.x, pos.y, pos.z);
                            

2.7 setRotation(x, y, z)

Cambia la rotación del plano en radianes, sobre los ejes x, y y z.

Parámetros:

• x, y, z: Rotaciones en radianes.

Ejemplo:

// Inclinar el plano 90° en X
miPlano.setRotation(Math.PI / 2, 0, 0);
                            

2.8 getRotation()

Devuelve la rotación actual del plano como un objeto con x, y, z en radianes.

Ejemplo:

const rot = miPlano.getRotation();
XUConsole(rot.x, rot.y, rot.z);
                            

2.9 setScale(x, y, z)

Cambia la escala del plano en cada eje. Usualmente en un plano basta con modificar x y y si quieres mantenerlo en 2D, pero puedes manipular los 3 ejes libremente.

Parámetros:

• x, y, z: Valores de escala para cada eje.

Ejemplo:

// Escalar el plano a la mitad de su tamaño en X e Y, Z se mantiene en 1
miPlano.setScale(0.5, 0.5, 1);
                            

2.10 getScale()

Devuelve la escala actual del plano como un objeto con x, y, z.

Ejemplo:

const scl = miPlano.getScale();
XUConsole(scl.x, scl.y, scl.z);
                            

2.1 setPosition(x, y, z)

Cambia la posición del grupo en el entorno 3D.

Parámetros:

• x, y, z: Coordenadas de posición (números).

Ejemplo:

// Mover el grupo a (2, 1, -5)
miGrupo.setPosition(2, 1, -5);
                            

2.2 getPosition()

Retorna la posición actual del grupo como un objeto con x, y y z.

Ejemplo:

const pos = miGrupo.getPosition();
XUConsole(pos.x, pos.y, pos.z);
                            

2.3 setRotation(x, y, z)

Cambia la rotación del grupo en radianes alrededor de los ejes x, y y z.

Parámetros:

• x, y, z: Valores de rotación en radianes.

Ejemplo:

// Rotar el grupo 45° en eje Y
miGrupo.setRotation(0, Math.PI / 4, 0);
                            

2.4 getRotation()

Retorna la rotación actual del grupo como un objeto con x, y y z en radianes.

Ejemplo:

const rot = miGrupo.getRotation();
XUConsole(rot.x, rot.y, rot.z);
                            

2.5 setScale(x, y, z)

Ajusta la escala del grupo en cada eje. Todos los objetos hijos se verán afectados por el factor de escala definido aquí.

Parámetros:

• x, y, z: Factores de escala en cada eje.

Ejemplo:

// Escalar el grupo al doble en eje X e Y, manteniendo Z
miGrupo.setScale(2, 2, 1);
                            

2.6 getScale()

Retorna la escala actual del grupo como un objeto con x, y, z.

Ejemplo:

const scl = miGrupo.getScale();
XUConsole(scl.x, scl.y, scl.z);
                            

2.7 updateBoundingMarkers()

Calcula el bounding box del grupo (considerando todos sus hijos) y coloca marcadores en las esquinas para visualizar su tamaño. Esto es útil para depuración o selección.

Detalles:

• Limpia marcadores previos y crea un cubo pequeño en cada esquina del bounding box.
• Para mostrar los marcadores, deben estar visibles (ver toggleBoundingMarkers).

Ejemplo:

// Actualizar y mostrar los marcadores de un grupo
miGrupo.updateBoundingMarkers();
miGrupo.toggleBoundingMarkers(true);
                            

2.8 toggleBoundingMarkers(visible)

Activa o desactiva la visibilidad de los marcadores de esquina.

Parámetros:

• visible: Booleano que indica si los marcadores deben mostrarse (true) u ocultarse (false).

Ejemplo:

// Ocultar marcadores
miGrupo.toggleBoundingMarkers(false);
                            

2.1 setText(newText)

Cambia el contenido textual que se mostrará en la geometría 3D.

Parámetros:

• newText: Cadena con el nuevo texto a mostrar.

Ejemplo:

// Actualizar el texto a "Hola Mundo"
miTexto.setText("Hola Mundo");
                            

2.2 setSize(newSize)

Ajusta el tamaño base del texto. Mientras más grande sea este valor, mayor será la altura de la forma 3D.

Parámetros:

• newSize: Número que representa el nuevo tamaño de la fuente.

Ejemplo:

// Aumentar el tamaño del texto a 50
miTexto.setSize(50);
                            

2.3 setColor(newColor)

Cambia el color del texto.

Parámetros:

• newColor: Valor en formato hexadecimal (por ejemplo, 0xff0000) o string ("#ff0000").

Ejemplo:

// Cambiar a color azul
miTexto.setColor(0x0000ff);
                            

2.4 setPosition(x, y, z)

Modifica la posición del texto en tu entorno tridimensional.

Parámetros:

• x, y, z: Coordenadas numéricas.

Ejemplo:

// Mover el texto a (3, 5, -2)
miTexto.setPosition(3, 5, -2);
                            

2.5 getPosition()

Obtiene la posición actual del texto como un objeto con x, y y z.

Ejemplo:

const pos = miTexto.getPosition();
XUConsole(pos.x, pos.y, pos.z);
                            

2.6 setRotation(x, y, z)

Cambia la rotación del texto alrededor de cada eje (x, y, z), expresada en radianes.

Parámetros:

• x, y, z: Ángulos en radianes.

Ejemplo:

// Rotar el texto 90° en X
miTexto.setRotation(Math.PI / 2, 0, 0);
                            

2.7 getRotation()

Obtiene la rotación actual del texto como un objeto con x, y y z, todos en radianes.

Ejemplo:

const rot = miTexto.getRotation();
XUConsole(rot.x, rot.y, rot.z);
                            

2.8 setScale(x, y, z)

Ajusta la escala del texto en cada eje. Esto puede usarse para deformar o ampliar el texto en X, Y o Z según necesites.

Parámetros:

• x, y, z: Factores de escala.

Ejemplo:

// Duplicar el ancho y la altura, mantener la profundidad
miTexto.setScale(2, 2, 1);
                            

2.9 getScale()

Retorna la escala actual del texto como un objeto con x, y y z.

Ejemplo:

const scl = miTexto.getScale();
XUConsole(scl.x, scl.y, scl.z);
                            

2.1 start()

Inicia la emisión de partículas, permitiendo que nuevas partículas se generen cada frame según la propiedad emissionRate.

Ejemplo:

// Comenzar la emisión de partículas
miSistemaParticulas.start();
                            

2.2 stop()

Detiene la emisión de nuevas partículas; las existentes se extinguirán cuando termine su lifetime.

Ejemplo:

// Detener la emisión
miSistemaParticulas.stop();
                            

2.3 update(deltaTime)

Lógica principal del sistema de partículas que debe llamarse cada frame (o en un bucle de actualización). Controla la creación de nuevas partículas y actualiza su vida y posición.

Parámetros:

• deltaTime: Tiempo transcurrido desde la última actualización, en segundos.

Ejemplo:

// En tu ciclo de animación o bucle principal
function loop(deltaTime) {
    miSistemaParticulas.update(deltaTime);
    // ... Lógica de otros objetos
}
                            

2.4 setPosition(x, y, z)

Ajusta la posición del sistema de partículas en el entorno. Todas las partículas se generan en esta posición inicial.

Parámetros:

• x, y, z: Coordenadas numéricas.

Ejemplo:

// Mover el sistema de partículas a (2, 3, -1)
miSistemaParticulas.setPosition(2, 3, -1);
                            

2.5 getPosition()

Retorna la posición actual del sistema como un objeto con x, y y z.

Ejemplo:

const pos = miSistemaParticulas.getPosition();
XUConsole(pos.x, pos.y, pos.z);
                            

2.6 setRotation(x, y, z)

Cambia la rotación del sistema en radianes alrededor de cada eje (x, y, z).

Parámetros:

• x, y, z: Ángulos en radianes.

Ejemplo:

// Rotar el sistema 45° en eje Y
miSistemaParticulas.setRotation(0, Math.PI / 4, 0);
                            

2.7 getRotation()

Devuelve la rotación actual del sistema como un objeto con x, y, z en radianes.

Ejemplo:

const rot = miSistemaParticulas.getRotation();
XUConsole(rot.x, rot.y, rot.z);
                            

2.8 setScale(x, y, z)

Ajusta la escala del sistema. Podrías, por ejemplo, agrandar o reducir todo el efecto de partículas si x, y, z tuvieran el mismo valor.

Parámetros:

• x, y, z: Factores de escala.

Ejemplo:

// Reducir el tamaño general a la mitad
miSistemaParticulas.setScale(0.5, 0.5, 0.5);
                            

2.9 getScale()

Retorna la escala actual del sistema de partículas como un objeto con x, y, z.

Ejemplo:

const scl = miSistemaParticulas.getScale();
XUConsole(scl.x, scl.y, scl.z);
                            

2.1 applyForce(fx, fy, fz)

Aplica una fuerza constante sobre el objeto, modificando su velocidad según la fórmula F = m * a. No tiene efecto si isKinematic es verdadero o si mass <= 0.

Parámetros:

• fx, fy, fz: Componentes de la fuerza.

Ejemplo:

// Empujar el objeto hacia arriba
miFisica.applyForce(0, 20, 0);
                            

2.2 applyImpulse(ix, iy, iz)

Aplica un impulso instantáneo sobre el objeto. Modifica la velocidad sin tener en cuenta la aceleración gradual. No tiene efecto si isKinematic es verdadero o mass <= 0.

Parámetros:

• ix, iy, iz: Componentes del impulso.

Ejemplo:

// Dar un golpe horizontal rápido
miFisica.applyImpulse(10, 0, 0);
                            

2.3 update(deltaTime)

Actualiza la posición del objeto en base a su velocidad actual y atenúa la misma según la fricción. Se recomienda llamarlo cada frame o ciclo de actualización.

Parámetros:

• deltaTime: Tiempo transcurrido desde la última actualización, en segundos.

Ejemplo:

// En tu ciclo de animación
function actualizar(deltaTime) {
    miFisica.update(deltaTime);
    // ... Otros objetos
}
                            

2.4 setPosition(x, y, z)

Fija la posición del objeto en el entorno. Puede usarse para reposicionar manualmente o restablecer su localización.

Parámetros:

• x, y, z: Coordenadas numéricas.

Ejemplo:

// Mover el objeto a (3, 2, -4)
miFisica.setPosition(3, 2, -4);
                            

2.5 getPosition()

Devuelve la posición actual del objeto como un objeto con x, y y z.

Ejemplo:

const pos = miFisica.getPosition();
XUConsole(pos.x, pos.y, pos.z);
                            

2.6 setRotation(x, y, z)

Ajusta la rotación del objeto en radianes alrededor de cada eje (x, y, z).

Parámetros:

• x, y, z: Ángulos en radianes.

Ejemplo:

// Rotar 45° en eje Y
miFisica.setRotation(0, Math.PI / 4, 0);
                            

2.7 getRotation()

Devuelve la rotación actual del objeto como un objeto con x, y, z (valores en radianes).

Ejemplo:

const rot = miFisica.getRotation();
XUConsole(rot.x, rot.y, rot.z);
                            

2.8 setScale(x, y, z)

Cambia la escala del objeto. Esto puede usarse para agrandar, disminuir o distorsionar la forma asociada a la física (si la hubiera).

Parámetros:

• x, y, z: Factores de escala.

Ejemplo:

// Aumentar el tamaño en 2X en X, mantener Y y Z
miFisica.setScale(2, 1, 1);
                            

2.9 getScale()

Retorna la escala actual del objeto como un objeto con x, y y z.

Ejemplo:

const scl = miFisica.getScale();
XUConsole(scl.x, scl.y, scl.z);
                            

2.10 setVelocity(vx, vy, vz)

Establece la velocidad del objeto directamente, sin necesidad de aplicar fuerzas o impulsos.

Parámetros:

• vx, vy, vz: Componentes de la velocidad.

Ejemplo:

// Dar una velocidad inicial de (1, -1, 0)
miFisica.setVelocity(1, -1, 0);
                            

2.11 getVelocity()

Obtiene la velocidad actual del objeto como un objeto con x, y, z.

Ejemplo:

const vel = miFisica.getVelocity();
XUConsole(vel.x, vel.y, vel.z);
                            

2.1 XUConsole(mensaje)

Función simple que imprime los parámetros recibidos en la consola interna (o la consola del navegador) según la configuración actual de XUEngine. Puede aceptar múltiples argumentos y los une o los muestra correlativamente.

Parámetros:

• mensaje: Cadena de texto (o múltiples argumentos) a imprimir. Puede contener variables concatenadas, tal como harías con XUConsole.

Ejemplo:

XUConsole("Hola Mundo");
XUConsole("Valor de x:", x, "Valor de y:", y);
                            

3.1 log(...mensajes)

Añade una línea de código para imprimir mensajes en la consola, usando la sintaxis propia del lenguaje configurado.

Ejemplo:

// En JavaScript:
vm.log("Hola mundo", { info: "datos" });
                                        

3.2 retornarValores(objetoLiteral)

Genera código que imprime los valores de un objeto literal formateado según el lenguaje seleccionado.

Ejemplo:

// En JavaScript:
vm.retornarValores("{ x: 5, y: 10 }");
                                        

3.3 para(inicio, condicion, incremento, cuerpo)

Crea un bucle for adaptado al lenguaje configurado.

Ejemplo:

// En JavaScript:
vm.para("let i = 0", "i < 10", "i++", "console.log(i)");
                                        

3.4 mientras(condicion, cuerpo)

Genera un bucle while (o su equivalente) utilizando la condición y el cuerpo especificados.

Ejemplo:

// En Python:
vm.mientras("i < 5", "print(i); i += 1");
                                        

3.5 funcion(nombre, parametros, cuerpo)

Define una función con el nombre, los parámetros y el cuerpo indicado, adaptándose a la sintaxis del lenguaje actual.

Ejemplo:

// En Python:
vm.funcion("saludar", ["nombre"], "print('Hola, ' + nombre)");
                                        

3.6 pausa(ms)

Inserta una pausa en la ejecución del script durante el número de milisegundos indicado.

Ejemplo:

// En JavaScript:
vm.pausa(1000);
                                        

3.7 incluir(modulo)

Agrega una línea de código para importar o requerir un módulo. Por ejemplo, en Node.js se utiliza require().

Ejemplo:

// En Node.js:
vm.incluir("fs");
                                        

3.8 estructura(nombre, campos)

Define una clase o estructura generando un constructor que asigna los valores de los campos especificados.

Ejemplo:

// En JavaScript:
vm.estructura("Persona", ["nombre", "edad"]);
                                        

3.9 input(variable, mensaje)

Inserta código para solicitar una entrada de datos al usuario, mostrando el mensaje indicado.

Ejemplo:

// En Python:
vm.input("nombre", "Introduce tu nombre:");
                                        

3.10 definir(nombre, valor)

Declara una variable y le asigna el valor indicado, respetando la sintaxis del lenguaje actual.

Ejemplo:

// En JavaScript:
vm.definir("x", 5);
                                        

3.11 finalizar()

Agrega una línea de código que indica la finalización del script, por lo general imprimiendo un mensaje.

Ejemplo:

// En JavaScript:
vm.finalizar();
                                        

3.12 comando(codigo)

Permite agregar una línea de código arbitraria al script generado.

Ejemplo:

// En Shell:
vm.comando("x=5");
                                        

3.13 generarCodigoFinal()

Retorna el script completo generado como una cadena de texto, listo para visualizarse o enviarse a un entorno de ejecución.

Ejemplo:

// En JavaScript:
const codigo = vm.generarCodigoFinal();
console.log(codigo);
                                        

3.14 enviar(lenguaje, nombreArchivo)

Configura el lenguaje, asigna el nombre de archivo y envía el script al entorno host para su ejecución o almacenamiento.

Ejemplo:

// En JavaScript:
vm.enviar("js", "mi_script");
                                        

3.15 awaitResultado(lenguaje, nombreArchivo)

Envía el script y retorna una promesa que se resuelve con el resultado de la ejecución.

Ejemplo:

// En JavaScript:
vm.awaitResultado("py", "mi_script")
    .then(resultado => console.log(resultado))
    .catch(err => console.error(err));