星火 2.0 开发文档

主题

GameUI.Enum ​

ButtonIntent 仅客户端 ​

命名空间 GameUI.Enum

csharp
public enum ButtonIntent

按钮语义色彩

备注

用于表达按钮的语义含义。

枚举值 ​

  • Primary — 主要 - 品牌主色
  • Secondary — 次要 - 辅助色
  • Success — 成功 - 确认、完成操作
  • Warning — 警告 - 需要注意的操作
  • Danger — 危险 - 破坏性操作
  • Info — 信息 - 中性信息
  • Neutral — 中性 - 无特定语义

ButtonVariant 仅客户端 ​

命名空间 GameUI.Enum

csharp
public enum ButtonVariant

按钮样式变体

备注

用于快速设置按钮的视觉样式。 Filled - 填充按钮，最高视觉权重 Outlined - 轮廓按钮，中等视觉权重 Ghost - 幽灵按钮，低视觉权重 Text - 文本按钮，最低视觉权重

枚举值 ​

  • Filled — 填充按钮（默认）- 实心背景色，适用于主要操作
  • Outlined — 轮廓按钮 - 透明背景 + 边框，适用于次要操作
  • Ghost — 幽灵按钮 - 透明背景无边框，适用于工具栏等紧凑空间
  • Text — 文本按钮 - 仅文字，适用于内联链接

ControlSize 仅客户端 ​

命名空间 GameUI.Enum

csharp
public enum ControlSize

控件尺寸

枚举值 ​

  • XSmall — 超小尺寸
  • Small — 小尺寸
  • Medium — 中等尺寸（默认）
  • Large — 大尺寸
  • XLarge — 超大尺寸

DisplayOrientations 仅客户端 ​

命名空间 GameUI.Enum

csharp
public enum DisplayOrientations

枚举值 ​

  • None
  • Landscape
  • LandscapeFlipped
  • Portrait
  • PortraitFlipped

HorizontalAlignment 仅客户端 ​

命名空间 GameUI.Enum

csharp
public enum HorizontalAlignment

枚举值 ​

  • Left
  • Center
  • Right
  • Stretch

HorizontalContentAlignment 仅客户端 ​

命名空间 GameUI.Enum

csharp
public enum HorizontalContentAlignment

枚举值 ​

  • Left
  • Center
  • Right
  • UniformSpacing
  • UniformMargin
  • Stretch

Orientation 仅客户端 ​

命名空间 GameUI.Enum

csharp
public enum Orientation

枚举值 ​

  • Vertical — Represents the vertical orientation or alignment. It is often used in layout and design contexts.
  • Horizontal — Defines the horizontal alignment of an element. It determines how the element is positioned along the horizontal axis.

ScaleMode 仅客户端 ​

命名空间 GameUI.Enum

csharp
public enum ScaleMode

UI 缩放策略，决定设计分辨率如何映射到物理屏幕。 与常见游戏框架（Unity Canvas Scaler、Cocos2d-x ResolutionPolicy）概念对齐。

枚举值 ​

  • Contain — 保证设计区域完整可见（取较小缩放比）。 屏幕宽高比与设计分辨率不同时，会在某个方向出现额外空间。 对应 Unity "Shrink" / Cocos2d-x "SHOW_ALL"。
  • Cover — 保证屏幕被完全填充（取较大缩放比），超出部分被裁切。 (0,0) 固定在左上角，右侧/底部内容可能被裁切。 对应 Cocos2d-x "NO_BORDER" / LibGDX "FillViewport"。
  • CoverCentered — 保证屏幕被完全填充（取较大缩放比），设计区域居中，两侧对称裁切。 对应 Unity Canvas Scaler "Shrink" 的填充行为。 需要引擎支持 set_global_offset。
  • MatchWidth — 宽度精确匹配设计分辨率，高度按比例缩放。 适合横版游戏，保证水平方向内容完全一致。 对应 Cocos2d-x "FIXED_WIDTH"。
  • MatchHeight — 高度精确匹配设计分辨率，宽度按比例缩放。 适合竖版游戏，保证垂直方向内容完全一致。 对应 Cocos2d-x "FIXED_HEIGHT"。

UIPositionType 仅客户端 ​

命名空间 GameUI.Enum

csharp
public enum UIPositionType

枚举值 ​

  • Relative — 相对定位，基于自身排版后的位置进行偏移。
  • Absolute — 绝对定位，基于父容器左上角的位置进行偏移。

VerticalAlignment 仅客户端 ​

命名空间 GameUI.Enum

csharp
public enum VerticalAlignment

枚举值 ​

  • Top
  • Center
  • Bottom
  • Stretch

VerticalContentAlignment 仅客户端 ​

命名空间 GameUI.Enum

csharp
public enum VerticalContentAlignment

枚举值 ​

  • Top
  • Center
  • Bottom
  • UniformSpacing
  • UniformMargin
  • Stretch