feat(editor): add --gen-texture-zebra wavy-stripe pattern

46th procedural texture: zebra-print stripes — base
horizontal stripes with a sinusoidal y-shift in x so they
undulate organically rather than aligning to the row grid.
Two-color (bg + stripe) for the iconic black-on-white animal-
print effect. Each pixel computes y + amplitude*sin(2π*x/wavelength)
then mods by the stripe period.

Useful for animal-print fabric, savanna grass mats, tribal
clothing, fur tiles. Defaults to 24-px period with 8-px
amplitude on an 80-px wavelength wave.
This commit is contained in:
Kelsi 2026-05-09 10:03:27 -07:00
parent 32e7eef107
commit f6f5b7d9a0
3 changed files with 89 additions and 1 deletions

View file

@ -4418,6 +4418,89 @@ int handleLeopard(int& i, int argc, char** argv) {
return 0;
}
int handleZebra(int& i, int argc, char** argv) {
// Zebra: wavy parallel stripes. The base stripes run
// horizontally; a sinusoidal y-shift in x makes them
// undulate, producing the characteristic non-straight
// zebra look without lining up perfectly with the row
// grid. Two-color (bg + stripe) for the iconic black-on-
// white animal-print effect.
std::string outPath = argv[++i];
std::string bgHex = argv[++i];
std::string stripeHex = argv[++i];
int stripePeriod = 24; // stripe + gap together
int amplitude = 8; // sine-wave amplitude (px)
int wavelength = 80; // x-period of the sine wave (px)
int W = 256, H = 256;
if (i + 1 < argc && argv[i + 1][0] != '-') {
try { stripePeriod = std::stoi(argv[++i]); } catch (...) {}
}
if (i + 1 < argc && argv[i + 1][0] != '-') {
try { amplitude = std::stoi(argv[++i]); } catch (...) {}
}
if (i + 1 < argc && argv[i + 1][0] != '-') {
try { wavelength = std::stoi(argv[++i]); } catch (...) {}
}
if (i + 1 < argc && argv[i + 1][0] != '-') {
try { W = std::stoi(argv[++i]); } catch (...) {}
}
if (i + 1 < argc && argv[i + 1][0] != '-') {
try { H = std::stoi(argv[++i]); } catch (...) {}
}
if (W < 1 || H < 1 || W > 8192 || H > 8192 ||
stripePeriod < 4 || stripePeriod > 256 ||
amplitude < 0 || amplitude > 128 ||
wavelength < 8 || wavelength > 1024) {
std::fprintf(stderr,
"gen-texture-zebra: invalid dims (W/H 1..8192, period 4..256, "
"amplitude 0..128, wavelength 8..1024)\n");
return 1;
}
uint8_t br_, bg_, bb_, sr, sg, sb_;
if (!parseHex(bgHex, br_, bg_, bb_) ||
!parseHex(stripeHex, sr, sg, sb_)) {
std::fprintf(stderr,
"gen-texture-zebra: bg or stripe hex color is invalid\n");
return 1;
}
constexpr float kPi = 3.14159265358979323846f;
const float twoPi = 2.0f * kPi;
std::vector<uint8_t> pixels(static_cast<size_t>(W) * H * 3, 0);
int halfPeriod = stripePeriod / 2; // each stripe = half the period
for (int y = 0; y < H; ++y) {
for (int x = 0; x < W; ++x) {
// Apply sine perturbation to the row index. Each
// column gets a y-shift based on cos(x * 2π/wavelength).
float shift = amplitude * std::sin(x * twoPi / wavelength);
int adjY = y + static_cast<int>(shift);
int phase = ((adjY % stripePeriod) + stripePeriod) % stripePeriod;
uint8_t r, g, b;
if (phase < halfPeriod) {
r = sr; g = sg; b = sb_; // stripe
} else {
r = br_; g = bg_; b = bb_; // bg
}
size_t idx = (static_cast<size_t>(y) * W + x) * 3;
pixels[idx + 0] = r;
pixels[idx + 1] = g;
pixels[idx + 2] = b;
}
}
if (!stbi_write_png(outPath.c_str(), W, H, 3,
pixels.data(), W * 3)) {
std::fprintf(stderr,
"gen-texture-zebra: stbi_write_png failed for %s\n",
outPath.c_str());
return 1;
}
std::printf("Wrote %s\n", outPath.c_str());
std::printf(" size : %dx%d\n", W, H);
std::printf(" bg/stripe : %s / %s\n", bgHex.c_str(), stripeHex.c_str());
std::printf(" stripes : period %d (amplitude %d, wavelength %d px)\n",
stripePeriod, amplitude, wavelength);
return 0;
}
} // namespace
bool handleGenTexture(int& i, int argc, char** argv, int& outRc) {
@ -4558,6 +4641,9 @@ bool handleGenTexture(int& i, int argc, char** argv, int& outRc) {
if (std::strcmp(argv[i], "--gen-texture-leopard") == 0 && i + 3 < argc) {
outRc = handleLeopard(i, argc, argv); return true;
}
if (std::strcmp(argv[i], "--gen-texture-zebra") == 0 && i + 3 < argc) {
outRc = handleZebra(i, argc, argv); return true;
}
return false;
}

View file

@ -125,6 +125,8 @@ void printUsage(const char* argv0) {
std::printf(" Runes: scattered angular glyphs of 3-5 strokes each (8 cardinal/diagonal angles)\n");
std::printf(" --gen-texture-leopard <out.png> <bgHex> <spotHex> [count] [radius] [W H]\n");
std::printf(" Leopard: irregular spots (4 sub-circles each) for animal-print fabric/fur\n");
std::printf(" --gen-texture-zebra <out.png> <bgHex> <stripeHex> [period] [amplitude] [wavelength] [W H]\n");
std::printf(" Zebra: wavy parallel stripes via sinusoidal y-shift (animal-print stripes)\n");
std::printf(" --add-texture-to-zone <zoneDir> <png-path> [renameTo]\n");
std::printf(" Copy an existing PNG into <zoneDir> (optionally renaming it on the way in)\n");
std::printf(" --gen-mesh <wom-base> <cube|plane|sphere|cylinder|torus|cone|ramp> [size]\n");

View file

@ -194,7 +194,7 @@ int main(int argc, char* argv[]) {
"--gen-texture-spider-web", "--gen-texture-gingham",
"--gen-texture-lattice", "--gen-texture-honeycomb",
"--gen-texture-cracked", "--gen-texture-runes",
"--gen-texture-leopard",
"--gen-texture-leopard", "--gen-texture-zebra",
"--validate-glb", "--info-glb", "--info-glb-tree", "--info-glb-bytes",
"--validate-jsondbc", "--check-glb-bounds", "--validate-stl",
"--validate-png", "--validate-blp",