sphere_detail()#

Controls the detail used to render a sphere by adjusting the number of vertices of the sphere mesh.

Examples#

def setup():
    py5.size(100, 100, py5.P3D)


def draw():
    py5.background(200)
    py5.stroke(255, 50)
    py5.translate(50, 50, 0)
    py5.rotate_x(py5.mouse_y*0.05)
    py5.rotate_y(py5.mouse_x*0.05)
    py5.fill(py5.mouse_x*2, 0, 160)
    py5.sphere_detail(py5.mouse_x//4)
    py5.sphere(40)

Description#

Controls the detail used to render a sphere by adjusting the number of vertices of the sphere mesh. The default resolution is 30, which creates a fairly detailed sphere definition with vertices every 360/30 = 12 degrees. If you’re going to render a great number of spheres per frame, it is advised to reduce the level of detail using this function. The setting stays active until sphere_detail() is called again with a new parameter and so should not be called prior to every sphere() statement, unless you wish to render spheres with different settings, e.g. using less detail for smaller spheres or ones further away from the camera. To control the detail of the horizontal and vertical resolution independently, use the version of the functions with two parameters.

Underlying Processing method: sphereDetail

Signatures#

sphere_detail(
    res: int,  # number of segments (minimum 3) used per full circle revolution
    /,
) -> None

sphere_detail(
    ures: int,  # number of segments used longitudinally per full circle revolutoin
    vres: int,  # number of segments used latitudinally from top to bottom
    /,
) -> None

Updated on March 06, 2023 02:49:26am UTC