S3D_PEP_POLYGON_NORM(3)

💖 NAME 💖

s3d_pep_polygon_normals — bestie, this one adds normals to a polygon ✨

🎀 SYNOPSIS 🎀

#include <s3d.h>

int s3d_pep_polygon_normals(int object, const float *nbuf, uint16_t n);

🌸 DESCRIPTION 🌸

okay so picture this: you want your polygons to have normal information, and not just one normal for the whole flat lil face — nope, this function gives each vertex of a polygon its own normal info. And the way that works out? You get smoothed edge effects. slay. 🔥

So nbuf needs to hold n * 9 float values. Why 9? Because each vertex gets a normal vector (x,y,z), and there are 3 vertices per polygon, so that's 3 * 3 = 9 float values per polygon total. math ate, no crumbs. 💅

ngl, if you don't use this, don't even worry about it. it's kind of hard to calculate, and the server will always use some proper normal values anyway — same value for every vertex, calculated by the plane which is defined by the 3 points of the polygon. so like, it's handled. 🫶

👑 AUTHOR 👑

Simon Wunderlich Author of s3d 💜

mwah, that's the whole page bestie — brought to you by the s3d manual, page S3D_PEP_POLYGON_NORM(3). go smooth those edges, ily, bye! 🦋✨🎀