modelX \ Language (API)

Name

modelX

Examples

settings <- function() {
    size(100, 100, P3D)
}

draw <- function() {
    noFill()
    background(0)
    pushMatrix()
    # start at the middle of the screen
    translate(width/2, height/2, -100)
    # some random rotation to make things interesting
    rotateY(1)  #yrot)
    rotateZ(2)  #zrot)
    rotateX(0)
    # offset from center
    translate(0, 50, 0)
    # draw a white box outline at (0, 0, 0)
    stroke(255)
    box(50)
    # the box was drawn at (0, 0, 0), store that location
    x = modelX(0, 0, 0)
    y = modelY(0, 0, 0)
    z = modelZ(0, 0, 0)
    # clear out all the transformations
    popMatrix()
    # draw another box at the same (x, y, z) coordinate as the other
    pushMatrix()
    translate(x, y, z)
    stroke(255, 0, 0)
    box(50)
    popMatrix()
}

Description

Returns the three-dimensional X, Y, Z position in model space. This returns the X value for a given coordinate based on the current set of transformations (scale, rotate, translate, etc.) The X value can be used to place an object in space relative to the location of the original point once the transformations are no longer in use.

In the example, the modelX(), modelY(), and modelZ() functions record the location of a box in space after being placed using a series of translate and rotate commands. After popMatrix() is called, those transformations no longer apply, but the (x, y, z) coordinate returned by the model functions is used to place another box in the same location.

Syntax

modelX(x, y, z)

Parameters

x	float: 3D x-coordinate to be mapped
y	float: 3D y-coordinate to be mapped
z	float: 3D z-coordinate to be mapped

modelY
modelZ