Question 1

How do I install CPML using luarocks?

Accepted Answer

Run 'luarocks install --server=http://luarocks.org/dev cpml' in the terminal. For local installations, add '--tree=path/to/directory' to specify a custom location, or clone the repository and require it directly, as per the README.

Question 2

Is CPML better than hump.vector for Lua game math?

Accepted Answer

CPML is more comprehensive, offering 3D support, matrices, and quaternions, while hump.vector is simpler and 2D-focused. For 3D games or complex transformations, CPML is superior; for basic 2D vector math, hump.vector might be easier.

Question 3

Does CPML work with Lua 5.x without LuaJIT?

Accepted Answer

CPML is intended for LuaJIT, which is based on Lua 5.1, so it may work with other Lua versions but with potential performance drops. The README recommends LuaJIT for optimal performance in game development.

Question 4

How to perform 3D rotations with quaternions in CPML?

Accepted Answer

Use CPML's quaternion functions to create rotations from angles or axes, interpolate with slerp for smooth transitions, and apply them to vectors or matrices. The documentation provides examples for common rotation scenarios.

Question 5

What's the difference between CPML and LÖVE's built-in math functions?

Accepted Answer

LÖVE has basic 2D math, while CPML adds 3D support, matrices, quaternions, and geometric calculations like line intersections. CPML is more feature-rich for 3D games, but for simple 2D projects, LÖVE's functions might suffice.

Question 6

How do I migrate from CPML version 0.10 to 1.0?

Accepted Answer

Update your code to reflect the new composition rule where a*b means 'apply b, then a' for both matrices and quaternions. Check the README's version notes and test thoroughly to ensure transformations work correctly after the change.

Cirno's Perfect Math Library

What is Cirno's Perfect Math Library?

Overview

Use Cases

Best For

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions