载入中...
搜索中...
未找到
eve::avatar 命名空间参考

类

class  Avatar
 Avatar module — layered character rendering for VN / portrait use. Script: avatar <- eve.Avatar(); 更多...
 
class  AvatarInstance
 Unified avatar instance. Kind is a string: "image" | "live2d" | "vroid". Script-facing API avoids overloads; kind-specific methods no-op / return false when unsupported. 更多...
 
class  ILive2DBackend
 Optional Live2D runtime backend (Cubism etc.). Registered from C++ / plugins. 更多...
 
class  NullLive2DBackend
 Built-in Live2D placeholder backend (no Cubism SDK). Stores path / parameters / expression / motion so scripts and tests can run without a proprietary runtime. Replace via Avatar::registerLive2DBackend (see examples/live2d-backend-plugin). 更多...
 
struct  VrmAtlasRect
 VrmAtlasRect public API. 更多...
 
struct  VrmCollider
 Node-local sphere/capsule used only by referencing spring groups. 更多...
 
struct  VrmDocument
 Validated VRM schema data. Unknown optional fields are ignored; unknown versions fail. 更多...
 
struct  VrmExpression
 One expression's indexed morph/material/UV operations. 更多...
 
struct  VrmLookAt
 VRM gaze maps; angles are degrees, expression outputs are weights. 更多...
 
struct  VrmMaterial
 Linear material factors and image references from VRMC_materials_mtoon. 更多...
 
class  VrmRuntime
 VrmRuntime public API. 更多...
 
struct  VrmSpring
 Ordered joints and explicit collision membership of one VRM spring. 更多...
 
struct  VrmSurface
 VrmSurface public API. 更多...
 
struct  VrmTexture
 Owning, validated VRM import data; independent of parser and source bytes. 更多...
 

类型定义

using Live2DBackendFactory = ILive2DBackend *(*)()
 

枚举

enum class  EquipmentVisualChange { Applied , Unchanged , Removed , Rejected }
 Outcome of changing or rebuilding the equipment appearance projection. 更多...
 
enum class  SkinnedPartUpdateMode { Unavailable = 0 , Gpu = 1 , Cpu = 2 }
 Observable backend selected for a shared-pose skinned part. 更多...
 

函数

 Module_IMPL (Avatar, new Avatar())
 
ILive2DBackend * createNullLive2DBackend ()
 Creates null live 2 d backend.
 
eve::Result< VrmDocument > parseVrm (std::span< const std::byte > bytes)
 Validate a self-contained GLB's VRM extension before publishing runtime state.
 
graphics::Texture & buildVrmAtlas (graphics::Graphics &graphics, const VrmDocument &document, std::vector< VrmAtlasRect > &rectangles)
 Prepare an atlas using the provider's owning resource factory. @ownership Graphics owns the result; caller releases it through that provider after use. @lifetime Valid until explicit release or provider destruction; observe resourceLifetime(). @thread Render thread, no callbacks. Throws before publication on invalid image data.
 
std::unique_ptr< VrmSurface > buildVrmSurface (graphics::Graphics &graphics, const VrmMaterial &data, graphics::Texture &atlas, const std::vector< VrmAtlasRect > &rectangles)
 Builds vrm surface.
 

类型定义说明

◆ Live2DBackendFactory

在文件 AvatarInstance.h 第 105 行定义.

枚举类型说明

◆ EquipmentVisualChange

Outcome of changing or rebuilding the equipment appearance projection.

枚举值
Applied 
Unchanged 
Removed 
Rejected 

在文件 AvatarInstance.h 第 60 行定义.

◆ SkinnedPartUpdateMode

Observable backend selected for a shared-pose skinned part.

枚举值
Unavailable 
Gpu 
Cpu 

在文件 AvatarInstance.h 第 68 行定义.

函数说明

◆ buildVrmAtlas()

graphics::Texture & eve::avatar::buildVrmAtlas ( graphics::Graphics &  gfx,
const VrmDocument &  d,
std::vector< VrmAtlasRect > &  rects 
)

Prepare an atlas using the provider's owning resource factory. @ownership Graphics owns the result; caller releases it through that provider after use. @lifetime Valid until explicit release or provider destruction; observe resourceLifetime(). @thread Render thread, no callbacks. Throws before publication on invalid image data.

在文件 VrmSurface.cpp 第 23 行定义.

引用了 bytes, d, file, h, height, eve::graphics::Graphics::newTexture(), eve::image::ImageData::paste(), w, width, x , 以及 y.

被这些函数引用 eve::avatar::VrmRuntime::prepare().

◆ buildVrmSurface()

std::unique_ptr< VrmSurface > eve::avatar::buildVrmSurface ( graphics::Graphics &  gfx,
const VrmMaterial &  data,
graphics::Texture &  atlas,
const std::vector< VrmAtlasRect > &  rects 
)

◆ createNullLive2DBackend()

ILive2DBackend * eve::avatar::createNullLive2DBackend ( )
inline

Creates null live 2 d backend.

在文件 Live2DNullBackend.h 第 70 行定义.

被这些函数引用 eve::avatar::Avatar::createLive2DBackend() , 以及 eve::avatar::Avatar::registerLive2DBackend().

◆ Module_IMPL()

eve::avatar::Module_IMPL ( Avatar  ,
new   Avatar() 
)

◆ parseVrm()

EVENGINE_API_DOMAINS eve::Result< VrmDocument > eve::avatar::parseVrm ( std::span< const std::byte >  bytes)

Validate a self-contained GLB's VRM extension before publishing runtime state.

参数
bytesBorrowed for this call only; result owns all imported data.
返回
Owning document or ParseError/UnknownVersion/Unsupported diagnostics.
注解
Thread independent; no callbacks, filesystem access, or observable mutation.

在文件 VrmDocument.cpp 第 227 行定义.

引用了 at, bytes, children, d, eve::Diagnostic::error(), eve::Result< T >::failure(), image, index, length, n, name, node, nodes, number, p, eve::json::Document::parse(), eve::ParseError, r, range, root, size, slots, start, steps, eve::Result< T >::success(), type, eve::UnknownVersion, eve::Unsupported, v, eve::avatar::VrmDocument::version , 以及 x.

被这些函数引用 eve::avatar::VrmRuntime::prepare().