← SPL reference

play (lib/play.py) 30|

Realtime 2D/3D game runtime: pygame (window, input, audio) + ModernGL (OpenGL, GLSL shaders, meshes, textures). Import with use play;. Not the same as built-in game.ticBestMove (tic-tac-toe AI).

40| Install optional deps: pip install 'someProgrammingLanguage[play]' (pygame, moderngl, numpy, Pillow). Needs a desktop display. Check with play.depsOk() (returns 1 / 0).

Quick start

use play;

win <- play.window(640, 480, "My Game");
tex <- play.solidTexture(win, 1, 0.3, 0.5, 1);

test.while(test.isEqualNumber(win.isOpen(), 1)):
  win.tick(60);
  win.poll();
  test.ifTrue(test.isEqualNumber(win.keyPressed("escape"), 1)):
    win.close();
  end;
  win.clear(0.05, 0.05, 0.08, 1);
  win.drawSprite(tex, 100, 80, 64, 64);
  win.flip();
end;

Factories

• play.window(w, h, title) — OpenGL window handle
• play.shader(win, vertSrc, fragSrc) / play.shaderFile(win, vertPath, fragPath)
• play.defaultShader(win) — lit mesh; play.pulseShader(win) — demo fullscreen FX
• play.texture(win, path) / play.solidTexture(win, r, g, b, a)
• play.mesh(win, positions, indices [, normals, uvs])
• play.quad(win) / play.box(win) / play.sphere(win, segments)
• play.camera() — eye/target/fov; viewMatrix() / projMatrix(aspect)
• Matrices (length-16 lists): mat4Identity, perspective, lookAt, translate, rotateX/Y/Z, scale, mul
• play.loadSound(path) / play.playSound(snd, loops)

Window methods

• Loop: isOpen, close, poll, tick(fps), time, dt, flip, title
• Clear: clear(r,g,b[,a]), enableDepth(0|1)
• Input: keyDown, keyPressed, mouseX, mouseY, mouseDown
• 2D: drawSprite(tex, x, y, w, h [, angle, r,g,b,a]), drawQuad, drawFullscreen(shader)
• 3D: draw(mesh, shader, model [, view, proj] [, tex])
• Uniforms: setShaderUniform(shader, name, number|list) — conventions u_model, u_view, u_proj, u_tex, u_time

Examples

• examples/play/hello_sprite.spl
• examples/play/shader_pulse.spl
• examples/play/spin_cube.spl

Implementation: lib/play.py + someProgrammingLanguage/spl_play/