ThaCuber [Lexaloffle Blog Feed]

vector.p8: A simple and lightweight vector math library

Tue, 29 Nov 2022 14:31:18 UTC

vector.p8 v2.3

by ThaCuber

[Click to Play]

vector.p8

a simple and lightweight (in tokens) vector math library for PICO-8.

usage:

load #vector_p8 and save as such: vector.p8
remove all the demo code; it's in the second tab
#include in any cart you want

functions within:

> NOTE:
> vectors are just normal Lua tables with x and y fields, so you can pass any table that contains x and y to any of the functions and they will work regardless.

creation and management

vector(x,y) - the main function. x and y default to 0

v_polar(angle, length) - makes a new vector using polar coordinates
v_rnd() - returns a normalized vector with a random direction

v_copy(v) - returns a copy of v
v_unpack(v) - returns the components of v separately
v_tostr(v) - turns a vector into a string, appropriate for both debugging and normal output. it looks like [x, y]

actual math

v_add(a,b) - returns a + b
v_sub(a,b) - returns a - b
v_scale(v,n) - returns v scaled by n
v_mul(v,n) - alias for v_scale
v_div(v,n) - returns v scaled by the inverse of n

v_dot(a,b) - returns the dot product of a and b
v_magsq(v) - returns the squared magnitude of v
v_mag(v) - returns the magnitude of v
v_distsq(a,b) - returns the squared distance between a and b
v_dist(a,b) - returns the distance between a and b
v_norm(v) - returns v, normalized

v_perp(v) - returns a vector clockwise-perpendicular to v
v_proj(a,b) - returns the projection of b onto a
v_dir(a,b) - returns a normalized vector that points towards b, with origin at a.

v_rot(v,t) - returns v rotated to point towards angle t.
v_rotby(v,t) - returns v rotated by t.
v_angle(v) - returns the angle denoted by v

miscellaneous

v_lerp(a,b,t) - linearly interpolates from a to b by t
v_flr(v) - returns v, with all its components floored

constants

> WARNING!
> because of the way Lua tables work, do NOT use compound assignments to alter a variable if you directly assign one of these constants to it. either copy the constant using v_cpy and then assign that to the variable or use one of the functions within the library to manipulate it.

v_right - rightwards pointing vector.
v_left - leftwards pointing vector.
v_up - upwards pointing vector. Y points downward in 2D so this vector points towards -Y.
v_down - downwards pointing vector. Y points downward in 2D so this vector points towards +Y.
v_one - identity vector. all components are set to 1.
v_center - utility vector pointing towards the center of the screen, i.e. [64,64].

changelog

format: dd-mm-yyyy

v2.3 (23-10-2024):

fixed v_lerp using v_scl instead of v_scale or v_mul
v_rot rotates to t, not by t; changed the docs of v_rot to mention that, and added v_rotby
post related update: removed the "rotation related functions" section; not exactly useful

v2.2 (02-10-2024):

fixed undefined global call to v_dstsq in v_dist (see v2.0 changelog)
added version number to cart title
programmed a new demo! check the second tab in the editor (tab 1)

v2.1.1 (02-10-2024):

accidentally switched x and y around in v_angle, sorry about that

v2.1 (02-10-2024):

the calls to cos and sin in v_polar were swapped with each other
the formula for v_proj was taken from Wikipedia, and it projects b onto a, not a onto b; the docs were updated to reflect that

v2.0 (24-05-2024):
almost a 50% reduction on tokens, in exchange for various breaking changes:

removed v_eq, v_zero, v_atwds, v_isvec, v_arr and v_sprj
removed z component from all functions, the 3D constants and v_cross
as in, this library no longer supports 3D math. sorry. it was oddly shoehorned in though, so I really wouldn't have relied on it that much.
added v_dir, taken from a mod of the library done by snale
optimized v_lerp, v_sub and v_rot
v_proj now uses the proper definition for vector projection
extended the names of some functions:
- v_cpy -> v_copy
- v_unpck -> v_unpack
- v_scl -> v_scale
- v_ang -> v_angle
- v_cntr -> v_center
- v_dst -> v_dist
- v_dstsq -> v_distsq

v1.2.1 (11-03-2023):

thought I had fixed all functions that used v_getd, but turns out one function I hadn't added to the docs, v_flr, still used it
documented v_flr
improved explanation for v_atwds

v1.2 (06-12-2022):

fixed the math functions v_add, v_sub, v_scl, v_div and v_neg using the now-defunct v_getd function

v1.1 (09-11-2022):

removed all dimension related functions
Consequently, a parameter was added to v_tostr for it to know how to format the output
added v_sprj and v_proj
renamed v_center to v_cntr

v1.0 (09-11-2022):

initial release

Risky Honey

Sun, 12 Jun 2022 15:56:03 UTC

Description from the itch.io page:

You're a bee, and for some reason I still do not comprehend, you decided to get some honey. In the middle of the rain. The drops are twice as bigger than you. You might die if you get hit by one. And the rain gets worse the more honey you collect. That wasn't the best idea you've gotten.

Made in 4 hours for the Crunchy Jam, hosted by Celesmeh.

Still has noticeable bugs, since I couldn't get time for enough bugfixing sadly.

riskyhoney

by ThaCuber

[Click to Play]

spaceship game (placeholder name)

Tue, 07 Sep 2021 21:17:12 UTC

Spaceship game

by ThaCuber

[Click to Play]

A game about shooting aliens that i made cause boredom.
The collision system is also trash but i can't make it better

	[0x0]

Anyways, it's pretty cool and i have like 3 days working on it, so please tell me what you think in the comments too!
and also print("have a good day :D")

sand and water test

Tue, 29 Jun 2021 23:01:25 UTC

sand and water

and yes, the physics are wrong, don't need to tell me

sand and water

by ThaCuber

[Click to Play]

EDGE Demake 0.2

Sat, 30 Jan 2021 16:01:21 UTC

EDGE Demake 0.2

by ThaCuber

[Click to Play]

New things:

A level editor that doesn't really work well
Climbing
More bugs
My brain hurts

Yeah, i don't really thing i will go on with this project. Well, it depends.

Depends in if my coding skills are enough to continue this thing.

i dont think so

EDGE Prototype

Fri, 22 Jan 2021 22:44:20 UTC

EDGE Demake 0.1

by ThaCuber

[Click to Play]

Please don't ask me why i do tutorials and immediately come with a game remake coded all by myself. Just play this.

This is a 2D remake of a game i've always wanted to remake somewhere else. I ended remaking it in PICO-8 (here), which is an uncomfortable thing since the original game is in 3D, and this thing is in 2D. But i'll be cool and say that this is a demake instead. For now it's just a very hecking early alpha, but i'll be working on it.

Also also, i don't know if i'll be able to code moving platforms.

To-do:

The ability to climb blocks, if it isn't there how could i call this an EDGE Remake.
Not being able to move in certain places ( for example, when you're trapped in a little tunnel )
The collectables, win, lose, and all the other things that need to be here and if not i could hardly call this a game.
And a lot more things.

Anyways, hope you like this thing, it's my first PICO-8 project with no tutorials, and because of it i'm so proud of it. Even though it's a copy of another game.

And yes, you can edit it according to the Creative Commons license.

Stay cool and see ya!

Tha Cuber

Basic pong game

Mon, 04 Jan 2021 02:43:16 UTC

Pong Game

by ThaCuber

[Click to Play]

A basic pong game.

Thanks to @Krystman for the tutorials.

Also sorry too because i literally changed almost nothing.

PICO-8 discord server?

Wed, 30 Dec 2020 17:01:48 UTC

Is there a PICO-8 official discord server?

If there is, how can I join?

If there isn't, are there any plans to make one?

Because I would like to have one.

Off-Topic

Also, I'm getting better at PICO-8.

Kinda.

got a freaking awesome idea

Wed, 23 Sep 2020 19:08:51 UTC

What if i, instead of doing games, i make mechanics for games?

i feel like this is a good idea.

puzzlescript.

Hit Test

Tue, 22 Sep 2020 19:30:03 UTC

Hi! I'm here again and i'm testing a hitbox thing.

Also you can walljump. How interesting.

And double jump. i'm awesome.

Btw im not gonna use it, 2 hard 4 me

Hit test

by ThaCuber

[Click to Play]

Also, just a fun fact, i make Puzzlescript games.

That's it, i wasted your time.

Something

Tue, 22 Sep 2020 03:22:46 UTC

The header of my account is one of my so many Puzzlescript games.

That's it, i wasted your time.

First Game

Tue, 22 Sep 2020 01:49:37 UTC

Hi! I'm ThaCuber! I want to post here my first game ever on here, even though i didn't finished it.

Please tell me guys what you thnk about it!

btw yes i used @MBoffin's top down game tutorial, don't tell that on the comments pls

The Dungeon King

by ThaCuber

[Click to Play]

Oh, and, i am proud of it, i don't care if you don't