phaneron/Kelsidavis-WoWee
1
0
Fork 0
mirror of https://github.com/Kelsidavis/WoWee.git synced 2026-05-10 02:53:51 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

feat(editor): add --gen-texture-knit V-stitch fabric pattern

Browse source 
47th procedural texture: knit fabric V-stitch — each stitch
occupies a cellW x cellH cell holding the V-shape made by
two diagonal strokes meeting at the apex (cellW/2, 0) and
dropping to the cell's bottom corners. Cells tile contiguously
in both axes giving the iconic chevron-zigzag appearance of
knitted fabric stitches.

Useful for sweater fabric, woolly NPC clothing, blanket
textures, mitten/scarf set dressing, dwarven knitwork.
Defaults to 16x12 cells with 2-px stroke width.
This commit is contained in:
Kelsi 2026-05-09 10:18:22 -07:00
parent 0ff13ccd67
commit a9f4e322d5
3 changed files with 91 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

1
tools/editor/cli_arg_required.cpp
View file

@ -81,6 +81,7 @@ const char* const kArgRequired[] = {
"--gen-texture-lattice", "--gen-texture-honeycomb",
"--gen-texture-cracked", "--gen-texture-runes",
"--gen-texture-leopard", "--gen-texture-zebra",
"--gen-texture-knit",
"--validate-glb", "--info-glb", "--info-glb-tree", "--info-glb-bytes",
"--validate-jsondbc", "--check-glb-bounds", "--validate-stl",
"--validate-png", "--validate-blp",

88
tools/editor/cli_gen_texture.cpp
View file

@ -4501,6 +4501,91 @@ int handleZebra(int& i, int argc, char** argv) {
return 0;
}
int handleKnit(int& i, int argc, char** argv) {
// Knit: V-stitch pattern. Each stitch occupies a cellW x cellH
// cell; the stitch is the V-shape made by two diagonal strokes
// meeting at the apex (cellW/2, 0) and dropping to the cell's
// bottom corners. Cells tile contiguously in both axes, giving
// the iconic chevron-zigzag look of knitted fabric.
std::string outPath = argv[++i];
std::string bgHex = argv[++i];
std::string stitchHex = argv[++i];
int cellW = 16;
int cellH = 12;
int strokeWidth = 2;
int W = 256, H = 256;
if (i + 1 < argc && argv[i + 1][0] != '-') {
try { cellW = std::stoi(argv[++i]); } catch (...) {}
}
if (i + 1 < argc && argv[i + 1][0] != '-') {
try { cellH = std::stoi(argv[++i]); } catch (...) {}
}
if (i + 1 < argc && argv[i + 1][0] != '-') {
try { strokeWidth = 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 ||
cellW < 4 || cellW > 256 ||
cellH < 4 || cellH > 256 ||
strokeWidth < 1 || strokeWidth >= cellH) {
std::fprintf(stderr,
"gen-texture-knit: invalid dims (W/H 1..8192, cellW/H 4..256, "
"strokeWidth 1..cellH-1)\n");
return 1;
}
uint8_t br_, bg_, bb_, sr, sg, sb_;
if (!parseHex(bgHex, br_, bg_, bb_) ||
!parseHex(stitchHex, sr, sg, sb_)) {
std::fprintf(stderr,
"gen-texture-knit: bg or stitch hex color is invalid\n");
return 1;
}
std::vector<uint8_t> pixels(static_cast<size_t>(W) * H * 3, 0);
// Slope of each V stroke: rise (cellH) over run (cellW/2)
// gives slope = 2*cellH/cellW. Vertical strokeWidth in pixels
// measures how far the pixel is from the ideal stroke line.
const float slope = 2.0f * cellH / static_cast<float>(cellW);
for (int y = 0; y < H; ++y) {
int localY = y % cellH;
for (int x = 0; x < W; ++x) {
int localX = x % cellW;
// Distance from stitch apex along x.
int d = std::abs(localX - cellW / 2);
float expectedY = d * slope;
// Pixel is "stitch" if its localY is within strokeWidth
// of the V stroke's expected y at this x.
uint8_t r, g, b;
if (std::fabs(localY - expectedY) < strokeWidth) {
r = sr; g = sg; b = sb_;
} else {
r = br_; g = bg_; b = bb_;
}
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-knit: 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/stitch : %s / %s\n", bgHex.c_str(), stitchHex.c_str());
std::printf(" stitch : %dx%d (stroke %d px)\n",
cellW, cellH, strokeWidth);
return 0;
}
} // namespace
bool handleGenTexture(int& i, int argc, char** argv, int& outRc) {
@ -4644,6 +4729,9 @@ bool handleGenTexture(int& i, int argc, char** argv, int& outRc) {
if (std::strcmp(argv[i], "--gen-texture-zebra") == 0 && i + 3 < argc) {
outRc = handleZebra(i, argc, argv); return true;
}
if (std::strcmp(argv[i], "--gen-texture-knit") == 0 && i + 3 < argc) {
outRc = handleKnit(i, argc, argv); return true;
}
return false;
}

2
tools/editor/cli_help.cpp
View file

@ -127,6 +127,8 @@ void printUsage(const char* argv0) {
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(" --gen-texture-knit <out.png> <bgHex> <stitchHex> [cellW] [cellH] [strokeW] [W H]\n");
std::printf(" Knit: V-stitch chevron-zigzag pattern reading as knitted fabric stitches\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");