精灵
Yuri引擎使用WPF作为底层的画面引擎,并对其提供的API进行了更高程度的封装。在Yuri引擎中,精灵对象即是对WPF可视化对象的一种封装,它的状态由可序列化的精灵描述子记录。
精灵对象
精灵对象YuriSprite是对WPF的可视化UI控件的一种封装,为游戏的图形资源提供展示、用户互动和动画效果。
| 方法或属性名 | 作用 | 
|---|---|
| Init(string resName, ResourceType resType, MemoryStream ms, Int32Rect? cutrect) | 使用一个内存流初始化精灵对象,它只能被执行一次 | 
| GetPixelColor(double X, double Y) | 获取一个相对于左上角的像素点的颜色 | 
| IsEmptyRegion(double X, double Y, int threshold) | 判断一个相对于左上角的像素点是否全透明 | 
| InitAnimationRenderTransform() | 初始化精灵的动画依赖 | 
| Anchor | 获取或设置精灵动画锚点 | 
| AnchorX | 获取精灵锚点相对精灵左上角的X坐标 | 
| AnchorY | 获取精灵锚点相对精灵左上角的Y坐标 | 
| CutRect | 获取或设置纹理切割矩形 | 
| SpriteBitmapImage | 获取或设置纹理源 | 
| DisplayBinding | 获取或设置前端显示控件 | 
| AnimationElement | 获取或设置背景层实际显示控件的引用 | 
| DisplayX | 获取或设置前端显示控件的X值 | 
| DisplayY | 获取或设置前端显示控件的Y值 | 
| DisplayZ | 获取或设置前端显示控件的Z值 | 
| DisplayOpacity | 获取或设置前端显示控件的透明度 | 
| DisplayWidth | 获取或设置前端显示控件的宽度 | 
| DisplayHeight | 获取或设置前端显示控件的高度 | 
| ImageWidth | 获取源图片的宽度 | 
| ImageHeight | 获取源图片的高度 | 
| IsDisplaying | 获取当前精灵是否被绑定到Image前端对象上 | 
| IsScaling | 获取精灵是否被缩放 | 
| ResourceType | 获取精灵的资源类型 | 
| ResourceName | 获取精灵的资源名 | 
| AnimateCount | 获取或设置正在进行的动画数量 | 
| IsInit | 获取精灵是否已经初始化 | 
| Descriptor | 获取或设置精灵的描述子 | 
| TranslateTransformer | 获取或设置绑定的平移变换器 | 
| ScaleTransformer | 获取或设置绑定的缩放变换器 | 
| RotateTransformer | 获取或设置绑定的旋转变换器 | 
精灵的描述子
精灵描述子对象SpriteDescriptor是精灵对象当前(以及动画结束后将要到达的)状态进行可序列化描述的对象。
| 属性名 | 作用 | 
|---|---|
| Id | 获取或设置精灵id | 
| X | 获取或设置精灵X坐标 | 
| Y | 获取或设置精灵Y坐标 | 
| Z | 获取或设置精灵Z坐标 | 
| Slot3D | 获取或设置3D精灵所在的立绘槽号 | 
| Deepth3D | 获取或设置3D精灵距离镜头的深度Z坐标 | 
| Angle | 获取或设置精灵角度 | 
| Opacity | 获取或设置精灵不透明度 | 
| ScaleX | 获取或设置精灵X缩放 | 
| ScaleY | 获取或设置精灵Y缩放 | 
| BlurRadius | 获取或设置精灵的模糊半径 | 
| ShadowRadius | 获取或设置精灵的投影半径 | 
| AnchorType | 获取或设置精灵锚点方式 | 
| ResourceType | 获取或设置精灵的资源类型 | 
| ResourceName | 获取或设置精灵的资源名 | 
| CutRect | 获取或设置精灵的纹理切割矩 | 
| ToX | 获取或设置精灵在动画结束后的X坐标 | 
| ToY | 获取或设置精灵在动画结束后的Y坐标 | 
| ToZ | 获取或设置精灵在动画结束后的Z坐标 | 
| ToAngle | 获取或设置精灵在动画结束后的角度 | 
| ToOpacity | 获取或设置精灵在动画结束后的不透明度 | 
| ToScaleX | 获取或设置精灵在动画结束后的X缩放 | 
| ToScaleY | 获取或设置精灵在动画结束后的Y缩放 | 
| ToBlurRadius | 获取或设置精灵在动画结束后的模糊半径 | 
| ToShadowRadius | 获取或设置精灵在动画结束后的投影半径 | 
程序集信息
| Property | Value | 
|---|---|
| 层次结构 | Yuri.PlatformCore.Graphic.YuriSprite | 
| 最低版本 | 1.0 | 
| 并行安全 | 是 | 
| 层次结构 | Yuri.PlatformCore.Graphic.SpriteDescriptor | 
| 最低版本 | 1.0 | 
| 并行安全 | 是 |