Desplaza el sistema de coordenadas.
De forma predeterminada, el origen (0, 0)
está en la esquina superior izquierda del lienzo en modo 2D y en el centro en el modo WebGL. La función translate()
desplaza el origen a una posición diferente. Todo lo dibujado después de llamar a translate()
parecerá estar desplazado. Hay dos formas de llamar a translate()
con parámetros que establecen la posición del origen.
La primera forma de llamar a translate()
utiliza números para establecer la cantidad de desplazamiento. Los dos primeros parámetros, x
y y
, establecen la cantidad de desplazamiento a lo largo de los ejes x- e y- positivos. Por ejemplo, llamar a translate(20, 30)
desplaza el origen 20 píxeles a lo largo del eje x- y 30 píxeles a lo largo del eje y-. El tercer parámetro, z
, es opcional. Establece la cantidad de desplazamiento a lo largo del eje z- positivo. Por ejemplo, llamar a translate(20, 30, 40)
desplaza el origen 20 píxeles a lo largo del eje x-, 30 píxeles a lo largo del eje y- y 40 píxeles a lo largo del eje z-.
La segunda forma de llamar a translate()
utiliza un objeto p5.Vector para establecer la cantidad de desplazamiento. Por ejemplo, llamar a translate(myVector)
utiliza el x-, y- y z- componentes de myVector
para establecer la cantidad de desplazamiento a lo largo del x-, y- y z-ejes. Hacer esto es lo mismo que llamar a translate(myVector.x, myVector.y, myVector.z)
.
De forma predeterminada, las transformaciones se acumulan. Por ejemplo, llamar a translate(10, 0)
dos veces tiene el mismo efecto que llamar a translate(20, 0)
una vez. Las funciones push() y pop() se pueden utilizar para aislar transformaciones dentro de grupos de dibujo distintos.
Nota: Las transformaciones se restablecen al principio del bucle de dibujo. Llamar a translate(10, 0)
dentro de la función draw() no hará que las formas se muevan continuamente.
Ejemplos
Sintaxis
translate(x, y, [z])
translate(vector)
Parámetros
cantidad a desplazar a lo largo del eje x- positivo.
cantidad a desplazar a lo largo del eje y- positivo.
cantidad a desplazar a lo largo del eje z- positivo.
vector por el que desplazar.