#include "graphics/Grass.h"
#include "common/Exception.h"
#include "data/ByteData.h"
#include "graphics/Graphics.h"
#include "graphics/Mesh.h"
#include "graphics/Shader.h"
#include "graphics/Texture.h"
#include "graphics/TextureSampler.h"
#include "graphics/shaders/mesh3d_grass_frag_spv.inc"
#include "graphics/shaders/mesh3d_grass_vert_spv.inc"
#include "image/Image.h"
#include "image/ImageData.h"
#include <algorithm>
#include <array>
#include <cmath>
#include <cstring>
#include <fstream>
#include <iterator>
#include <memory>
#include <unordered_map>
#include <utility>

命名空间
namespace	eve

namespace	eve::graphics
	卡牌游戏 UI 工具模块：工厂 + 脚本绑定入口。功能参考 ycarowr/UiCard：扇形手牌布局、抽牌/洗牌、悬浮放大、拖拽到落牌区、敌方手牌（背面/偷看）、费用不足置灰，以及可实时调节的布局参数。数据模型与渲染/交互逻辑见 CardTypes.h。

namespace	eve::graphics::grass
	t3ssel8r-style stylized grass.

函数
int	eve::graphics::grass::paramCount ()

std::string	eve::graphics::grass::paramName (int index)

void	eve::graphics::grass::bindDefaults (Shader *shader)

void	eve::graphics::grass::bindAtlasLayout (Shader *shader, const PackedAtlasInfo &info)

void	eve::graphics::grass::bindLayer (Shader *shader, bool alwaysDark)

void	eve::graphics::grass::setTime (Shader *shader, float seconds)

void	eve::graphics::grass::setFrameDuration (Shader *shader, float seconds)

Shader *	eve::graphics::grass::createShader (Graphics *gfx)

int	eve::graphics::grass::swayFrame (float time, float frameDuration, uint32_t instanceId, int frameCount=4)
	Discrete 4-frame index with a per-instance phase offset.

int	eve::graphics::grass::swayAtlasWidth (int frameW, int frames)

int	eve::graphics::grass::swayAtlasHeight (int frameH)

void	eve::graphics::grass::makeSwayAtlasRGBA (int frameW, int frameH, int frames, std::vector< uint8_t > &rgbaOut)
	Procedural 4-frame fallback atlas (horizontal strip). GPU paths should load authored 2x2 PNG masks via packSwayAtlasRGBA / createSwayAtlasFromFiles.

Texture *	eve::graphics::grass::createSwayAtlas (Graphics *gfx, int frameW, int frameH, int frames)

void	eve::graphics::grass::packSwayAtlasRGBA (const std::vector< std::string > &grassFiles, const std::vector< std::string > &leafFiles, std::vector< uint8_t > &rgbaOut, PackedAtlasInfo &info)
	Load white-on-black (or RGBA) 2x2 sway PNGs and pack them into one atlas.

Texture *	eve::graphics::grass::createSwayAtlasFromFiles (Graphics gfx, const std::vector< std::string > &grassFiles, const std::vector< std::string > &leafFiles, PackedAtlasInfo infoOut)

std::vector< Point >	eve::graphics::grass::sampleHalton (const float posXYZ, const float nrmXYZ, int vertexCount, const uint32_t *indices, int indexCount, int count, uint32_t seed=1, float minSlopeDot=0.25f)
	Area-weighted Halton samples (deterministic, evenly spread).

std::vector< Point >	eve::graphics::grass::samplePoisson (const float posXYZ, const float nrmXYZ, int vertexCount, const uint32_t *indices, int indexCount, const SampleParams &params={})
	Fast Poisson-disk / dart-throwing blue noise on a triangle mesh.

BillboardMesh	eve::graphics::grass::buildBillboards (const std::vector< Point > &points, float width=0.62f, float height=0.95f, bool alwaysDark=false)
	Expand a unit rectangle per point. Vertex layout: pos = grass root uv = quad corner in [0,1]^2 (0.5, 0) is the root normal.x = instance id, normal.y = scale, normal.z = alwaysDark (0/1)

void	eve::graphics::grass::makePlane (float sizeX, float sizeZ, int segX, int segZ, std::vector< float > &posXYZ, std::vector< float > &nrmXYZ, std::vector< uint32_t > &indices)
	Unit XZ plane (Y-up) for tests / demos.