tilemap-ruletile-createfromsegment

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Tilemap RuleTile Create From Segment

从Segment创建Tilemap RuleTile

Purpose

目的

This skill creates Unity RuleTile TilingRules by first analyzing sprites using the

sprite-segment-3x3grid

skill, then converting the resulting text patterns into neighbor rule configurations. The user must specify Sprites or a Spritesheet input.

此skill首先使用

sprite-segment-3x3grid

skill分析Sprite，然后将生成的文本模式转换为邻居规则配置，从而创建Unity RuleTile TilingRules。用户必须指定Sprites或Spritesheet输入。

Workflow

工作流程

Step 1: sprite-segment-3x3grid    Step 2: Create TilingRules
+--------------------------+      +--------------------------+
|  Analyze each Sprite     |      |  Parse text patterns     |
|  using color matching    |  ->  |  Map to neighbor rules   |
|  Output: text pattern    |      |  Sort by specificity     |
+--------------------------+      +--------------------------+

CRITICAL: Always run the

sprite-segment-3x3grid

skill first on each Sprite to generate the text pattern.

Step 1: sprite-segment-3x3grid    Step 2: Create TilingRules
+--------------------------+      +--------------------------+
|  Analyze each Sprite     |      |  Parse text patterns     |
|  using color matching    |  ->  |  Map to neighbor rules   |
|  Output: text pattern    |      |  Sort by specificity     |
+--------------------------+      +--------------------------+

关键：始终先对每个Sprite运行

sprite-segment-3x3grid

skill以生成文本模式。

Step 1: Apply sprite-segment-3x3grid (Required)

第1步：应用sprite-segment-3x3grid（必需）

For each Sprite in your texture, analyze it with

sprite-segment-3x3grid

csharp

string pattern = SpriteSegment3x3Grid.AnalyzeSpriteGrid(sprite, matchThreshold: 0.75f);

使用

sprite-segment-3x3grid

分析纹理中的每个Sprite：

csharp

string pattern = SpriteSegment3x3Grid.AnalyzeSpriteGrid(sprite, matchThreshold: 0.75f);

Pattern Output Format

模式输出格式

Single-line text pattern:

[TopRow] / [MiddleRow] / [BottomRow]

Each row contains 3 characters separated by spaces:

```
X
```
- Cell does NOT meet match threshold
```
.
```
- Cell MEETS match threshold (matches center color)
```
*
```
- Center cell (the tile itself)

Example:

X X X / X * X / . . .

单行文本模式：

[TopRow] / [MiddleRow] / [BottomRow]

每行包含3个以空格分隔的字符：

```
X
```
- 单元格不满足匹配阈值
```
.
```
- 单元格满足匹配阈值（与中心颜色匹配）
```
*
```
- 中心单元格（即瓦片本身）

示例：

X X X / X * X / . . .

Step 2: Create TilingRules from Patterns

第2步：从模式创建TilingRules

Symbol to Rule Mapping

符号与规则映射

Symbol	RuleTile Neighbor	Value	Behavior
`.`	`This`	1	Neighbor must be an instance of this RuleTile
`X`	`DontCare`	0	Position not added to neighbors list
`*`	(center)	N/A	Ignored - represents the tile itself

Note: "DontCare" is not an explicit constant. A position is "don't care" when it is simply not included in the

m_Neighbors

and

m_NeighborPositions

lists.

符号	RuleTile邻居	值	行为
`.`	`This`	1	邻居必须是此RuleTile的实例
`X`	`DontCare`	0	位置不添加到邻居列表
`*`	(中心)	N/A	忽略 - 表示瓦片本身

注意："DontCare"不是一个显式常量。当一个位置未包含在

m_Neighbors

和

m_NeighborPositions

列表中时，即为"不关心"。

Neighbor Position Mapping

邻居位置映射

Grid Layout:              Unity Vector3Int positions:
[0] [1] [2]  (Top)        (-1,1,0)  (0,1,0)  (1,1,0)
[3] [*] [5]  (Middle)     (-1,0,0)    ---    (1,0,0)
[6] [7] [8]  (Bottom)     (-1,-1,0) (0,-1,0) (1,-1,0)

Index	Position	Vector3Int
0	Top-Left	`(-1, 1, 0)`
1	Top	`(0, 1, 0)`
2	Top-Right	`(1, 1, 0)`
3	Left	`(-1, 0, 0)`
4	Center	(skipped)
5	Right	`(1, 0, 0)`
6	Bottom-Left	`(-1, -1, 0)`
7	Bottom	`(0, -1, 0)`
8	Bottom-Right	`(1, -1, 0)`

Grid Layout:              Unity Vector3Int positions:
[0] [1] [2]  (Top)        (-1,1,0)  (0,1,0)  (1,1,0)
[3] [*] [5]  (Middle)     (-1,0,0)    ---    (1,0,0)
[6] [7] [8]  (Bottom)     (-1,-1,0) (0,-1,0) (1,-1,0)

索引	位置	Vector3Int
0	左上	`(-1, 1, 0)`
1	上	`(0, 1, 0)`
2	右上	`(1, 1, 0)`
3	左	`(-1, 0, 0)`
4	中心	(跳过)
5	右	`(1, 0, 0)`
6	左下	`(-1, -1, 0)`
7	下	`(0, -1, 0)`
8	右下	`(1, -1, 0)`

Pattern Filtering

模式过滤

By default, detected patterns that do not match any entry in the Common Tile Patterns table are discarded. Only the 47 known patterns are kept. This prevents unexpected or noisy rules from appearing in the final RuleTile.

If the user explicitly asks to keep non-standard patterns, set

filterToKnownPatterns: false

to bypass this filtering.

默认情况下，检测到的模式如果与常见瓦片模式表中的任何条目不匹配，则被丢弃。仅保留47种已知模式。这可以防止意外或嘈杂的规则出现在最终的RuleTile中。

如果用户明确要求保留非标准模式，设置

filterToKnownPatterns: false

以绕过此过滤。

Deduplication

去重

Duplicate TilingRules with identical neighbor configurations are automatically removed. When multiple sprites produce the same pattern, only the first sprite encountered is kept.

具有相同邻居配置的重复TilingRules会被自动移除。当多个Sprite产生相同模式时，仅保留第一个遇到的Sprite。

Rule Sorting

规则排序

Rules are sorted by specificity (number of

This

rules) in descending order. More specific rules are evaluated first.

This Count	Example Pattern	Priority
8	`. . . / . * . / . . .`	First
5	`. . . / . * . / X X X`	...
3	`X X X / X * X / . . .`	...
0	`X X X / X * X / X X X`	Last

规则按特异性（

This

规则数量）降序排序。更具体的规则优先评估。

This数量	示例模式	优先级
8	`. . . / . * . / . . .`	最先
5	`. . . / . * . / X X X`	...
3	`X X X / X * X / . . .`	...
0	`X X X / X * X / X X X`	最后

Sprite Assignment

Sprite分配

Each TilingRule is assigned at most 1 Sprite:

Set

m_Output

TilingRuleOutput.OutputSprite.Single

Assign the sprite to
```
m_Sprites[0]
```

The RuleTile's

m_DefaultSprite

is set to the sprite from the bottom-most (least specific) rule. Since rules are sorted by specificity descending, this is the last rule in the list. This sprite is used when no TilingRule matches.

每个TilingRule最多分配1个Sprite：

将

m_Output

设置为

TilingRuleOutput.OutputSprite.Single

将Sprite分配给
```
m_Sprites[0]
```

RuleTile的

m_DefaultSprite

设置为最底部（特异性最低）规则中的Sprite。由于规则按特异性降序排序，这是列表中的最后一个规则。当没有TilingRule匹配时，将使用此Sprite。

Algorithm Summary

算法总结

For each Sprite: Run
```
sprite-segment-3x3grid
```
and store the pattern
Filter: Discard patterns not in Common Tile Patterns (unless user opts out)
Deduplicate: Remove duplicate patterns (first sprite wins)
Parse: Split by
```
/
```
for rows, then by space for cells
Extract Neighbors:
```
.
```
-> add position with
```
This
```
(1);
```
X
```
-> skip
Create TilingRule: Populate
```
m_Neighbors
```
and
```
m_NeighborPositions
```
Assign Sprite: Set single sprite output
Sort: Order by specificity descending
Apply: Add sorted rules to RuleTile asset
Default Sprite: Set
```
m_DefaultSprite
```
to the last (least specific) rule's sprite

对于每个Sprite：运行
```
sprite-segment-3x3grid
```
并存储模式
过滤：丢弃不在常见瓦片模式中的模式（除非用户选择保留）
去重：移除重复模式（第一个Sprite优先）
解析：先用
```
/
```
分割行，再用空格分割单元格
提取邻居：
```
.
```
-> 添加位置并标记
```
This
```
（1）；
```
X
```
-> 跳过
创建TilingRule：填充
```
m_Neighbors
```
和
```
m_NeighborPositions
```
分配Sprite：设置单Sprite输出
排序：按特异性降序排列
应用：将排序后的规则添加到RuleTile资源中
默认Sprite：将
```
m_DefaultSprite
```
设置为最后一个（特异性最低）规则的Sprite

Scripts

脚本

Implementation and usage examples are in the

scripts/

folder:

File Description

File	Description
`TilemapRuleTileCreateFromSegment.cs`	Core implementation with `CreateRuleTileFromSprites` , `CreateTilingRuleFromPattern` , `ParsePattern` , and `ApplyRulesToTile`
`RuleTileGenerator.cs`	Editor window example ( `Tools > Generate RuleTile from Sprites` )
`ManualWorkflowExample.cs`	Manual two-step workflow for finer control over analysis

TilemapRuleTileCreateFromSegment.cs

Core implementation with

CreateRuleTileFromSprites

CreateTilingRuleFromPattern

ParsePattern

, and

ApplyRulesToTile

RuleTileGenerator.cs

Editor window example (

Tools > Generate RuleTile from Sprites

)

ManualWorkflowExample.cs

Manual two-step workflow for finer control over analysis

实现和用法示例位于

scripts/

文件夹中：

文件描述

文件	描述
`TilemapRuleTileCreateFromSegment.cs`	核心实现，包含 `CreateRuleTileFromSprites` 、 `CreateTilingRuleFromPattern` 、 `ParsePattern` 和 `ApplyRulesToTile`
`RuleTileGenerator.cs`	编辑器窗口示例（ `Tools > Generate RuleTile from Sprites` ）
`ManualWorkflowExample.cs`	手动两步工作流，用于对分析进行更精细的控制

TilemapRuleTileCreateFromSegment.cs

核心实现，包含

CreateRuleTileFromSprites

、

CreateTilingRuleFromPattern

、

ParsePattern

和

ApplyRulesToTile

RuleTileGenerator.cs

编辑器窗口示例（

Tools > Generate RuleTile from Sprites

）

ManualWorkflowExample.cs

手动两步工作流，用于对分析进行更精细的控制

Quick Usage

快速用法

csharp

// Get sprites and create rules in one call
var rules = TilemapRuleTileCreateFromSegment.CreateRuleTileFromSprites(
    sprites, matchThreshold: 0.75f, colorTolerance: 0.04f);

// Apply to RuleTile
var ruleTile = ScriptableObject.CreateInstance<RuleTile>();
TilemapRuleTileCreateFromSegment.ApplyRulesToTile(ruleTile, rules);

csharp

// Get sprites and create rules in one call
var rules = TilemapRuleTileCreateFromSegment.CreateRuleTileFromSprites(
    sprites, matchThreshold: 0.75f, colorTolerance: 0.04f);

// Apply to RuleTile
var ruleTile = ScriptableObject.CreateInstance<RuleTile>();
TilemapRuleTileCreateFromSegment.ApplyRulesToTile(ruleTile, rules);

Common Tile Patterns

常见瓦片模式

Tile Type	Pattern	This Count
Fully surrounded (inner tile)	`. . . / . * . / . . .`	8
Top left corner missing	`X . . / . * . / . . .`	7
Top right corner missing	`. . X / . * . / . . .`	7
Bottom left corner missing	`. . . / . * . / X . .`	7
Bottom right corner missing	`. . . / . * . / . . X`	7
Top corners missing	`X . X / . * . / . . .`	6
Bottom corners missing	`. . . / . * . / X . X`	6
Left corners missing	`X . . / . * . / X . .`	6
Right corners missing	`. . X / . * . / . . X`	6
Top Left and Bottom Right diagonal corners missing	`X . . / . * . / . . X`	6
Top Right and Bottom Left diagonal corners missing	`. . X / . * . / X . .`	6
Top Left, Top Right and Bottom Left corners missing	`X . X / . * . / X . .`	5
Top Left, Top Right and Bottom Right corners missing	`X . X / . * . / . . X`	5
Top Left, Bottom Left and Bottom Right corners missing	`X . . / . * . / X . X`	5
Top Right, Bottom Left and Bottom Right corners missing	`. . X / . * . / X . X`	5
Cross Section	`X . X / . * . / X . X`	4
Flat edge (Bottom)	`X X X / . * . / . . .`	5
Flat edge (Top)	`. . . / . * . / X X X`	5
Flat edge (Left)	`. . X / . * X / . . X`	5
Flat edge (Right)	`X . . / X * . / X . .`	5
L-Shape, Point Right	`X X X / . * . / . . X`	4
L-Shape, Point Bottom	`. . X / . * X / X . X`	3
L-Shape, Point Left	`X . . / . * . / X X X`	4
L-Shape, Point Top	`X . X / X * . / X . .`	3
L-Shape Inverse, Point Left	`X X X / . * . / X . .`	4
L-Shape Inverse, Point Bottom	`X . . / X * . / X . X`	3
L-Shape Inverse, Point Right	`. . X / . * . / X X X`	4
L-Shape Inverse, Point Top	`X . X / . * . / . . X`	5
T-Shape, face down	`X X X / . * . / X . X`	3
T-Shape, face top	`X . X / . * . / X X X`	3
T-Shape, face left	`X . X / . * X / X . X`	3
T-Shape, face right	`X . X / X * . / X . X`	3
Horizontal bridge	`X X X / . * . / X X X`	2
Vertical bridge	`X . X / X * X / X . X`	2
Corner piece, Bottom Right	`X X X / X * . / X . .`	3
Corner piece, Bottom Left	`X X X / . * X / . . X`	3
Corner piece, Top Left	`. . X / . * X / X X X`	3
Corner piece, Top Right	`X . . / X * . / X X X`	3
Edge end, Bottom Right	`X X X / X * . / X . X`	2
Edge end, Bottom Left	`X X X / . * X / X . X`	2
Edge end, Top Left	`X . X / . * X / X X X`	2
Edge end, Top Right	`X . X / X * . / X X X`	2
Single isolated tile, Left	`X X X / . * X / X X X`	1
Single isolated tile, Right	`X X X / X * . / X X X`	1
Single isolated tile, Top	`X . X / X * X / X X X`	1
Single isolated tile, Bottom	`X X X / X * X / X . X`	1
Center	`X X X / X * X / X X X`	0

瓦片类型	模式	This数量
完全包围（内部瓦片）	`. . . / . * . / . . .`	8
左上角缺失	`X . . / . * . / . . .`	7
右上角缺失	`. . X / . * . / . . .`	7
左下角缺失	`. . . / . * . / X . .`	7
右下角缺失	`. . . / . * . / . . X`	7
上角缺失	`X . X / . * . / . . .`	6
下角缺失	`. . . / . * . / X . X`	6
左角缺失	`X . . / . * . / X . .`	6
右角缺失	`. . X / . * . / . . X`	6
左上和右下对角缺失	`X . . / . * . / . . X`	6
右上和左下对角缺失	`. . X / . * . / X . .`	6
左上、右上和左下角缺失	`X . X / . * . / X . .`	5
左上、右上和右下角缺失	`X . X / . * . / . . X`	5
左上、左下和右下角缺失	`X . . / . * . / X . X`	5
右上、左下和右下角缺失	`. . X / . * . / X . X`	5
十字交叉	`X . X / . * . / X . X`	4
平边（下）	`X X X / . * . / . . .`	5
平边（上）	`. . . / . * . / X X X`	5
平边（左）	`. . X / . * X / . . X`	5
平边（右）	`X . . / X * . / X . .`	5
L形，指向右	`X X X / . * . / . . X`	4
L形，指向下	`. . X / . * X / X . X`	3
L形，指向左	`X . . / . * . / X X X`	4
L形，指向上	`X . X / X * . / X . .`	3
L形反向，指向左	`X X X / . * . / X . .`	4
L形反向，指向下	`X . . / X * . / X . X`	3
L形反向，指向右	`. . X / . * . / X X X`	4
L形反向，指向上	`X . X / . * . / . . X`	5
T形，面朝下	`X X X / . * . / X . X`	3
T形，面朝上	`X . X / . * . / X X X`	3
T形，面朝左	`X . X / . * X / X . X`	3
T形，面朝右	`X . X / X * . / X . X`	3
水平桥	`X X X / . * . / X X X`	2
垂直桥	`X . X / X * X / X . X`	2
角块，右下	`X X X / X * . / X . .`	3
角块，左下	`X X X / . * X / . . X`	3
角块，左上	`. . X / . * X / X X X`	3
角块，右上	`X . . / X * . / X X X`	3
边缘端点，右下	`X X X / X * . / X . X`	2
边缘端点，左下	`X X X / . * X / X . X`	2
边缘端点，左上	`X . X / . * X / X X X`	2
边缘端点，右上	`X . X / X * . / X X X`	2
单个独立瓦片，左	`X X X / . * X / X X X`	1
单个独立瓦片，右	`X X X / X * . / X X X`	1
单个独立瓦片，上	`X . X / X * X / X X X`	1
单个独立瓦片，下	`X X X / X * X / X . X`	1
中心	`X X X / X * X / X X X`	0

Notes

注意事项

Always run
```
sprite-segment-3x3grid
```
first -- this skill depends on its output
Rules are evaluated in order; first matching rule wins
A rule with 0
```
This
```
conditions matches any configuration (use as fallback)
The center cell (
```
*
```
) is always ignored in neighbor calculations
Unity's RuleTile supports up to 8 neighbors in a standard 3x3 grid
For hexagonal or isometric grids, use
```
HexagonalRuleTile
```
or
```
IsometricRuleTile
```

始终先运行
```
sprite-segment-3x3grid
```
——此skill依赖其输出
规则按顺序评估；第一个匹配的规则生效
具有0个
```
This
```
条件的规则匹配任何配置（用作回退）
中心单元格（
```
*
```
）在邻居计算中始终被忽略
Unity的RuleTile在标准3x3网格中最多支持8个邻居
对于六边形或等距网格，请使用
```
HexagonalRuleTile
```
或
```
IsometricRuleTile
```

Prerequisites

先决条件

sprite-segment-3x3grid
skill: generates the input patterns. It ships in this same plugin as
```
sprite-segment-3x3grid
```
, so it is always available — invoke it rather than treating it as an unmet dependency.
com.unity.2d.tilemap.extras package: Required for RuleTile class

sprite-segment-3x3grid
skill：生成输入模式。它随此插件一起附带，与
```
sprite-segment-3x3grid
```
相同，因此始终可用——调用它而不是将其视为未满足的依赖项。
com.unity.2d.tilemap.extras包：RuleTile类所需

另请参阅

```
sprite-segment-3x3grid
```
- required prerequisite; generates the input patterns

Packages/com.unity.2d.tilemap.extras/Runtime/Tiles/RuleTile/RuleTile.cs

for RuleTile implementation

Unity Manual: Rule Tile

```
sprite-segment-3x3grid
```
- 必需的先决条件；生成输入模式

Packages/com.unity.2d.tilemap.extras/Runtime/Tiles/RuleTile/RuleTile.cs

了解RuleTile实现

Unity手册：Rule Tile

tilemap-ruletile-createfromsegment

Original

Translation

Tilemap RuleTile Create From Segment

从Segment创建Tilemap RuleTile

Purpose

目的

Workflow

工作流程

Step 1: Apply sprite-segment-3x3grid (Required)

第1步：应用sprite-segment-3x3grid（必需）

Pattern Output Format

模式输出格式

Step 2: Create TilingRules from Patterns

第2步：从模式创建TilingRules

Symbol to Rule Mapping

符号与规则映射

Neighbor Position Mapping

邻居位置映射

Pattern Filtering

模式过滤

Deduplication

去重

Rule Sorting

规则排序

Sprite Assignment

Sprite分配

Algorithm Summary

算法总结

Scripts

脚本

Quick Usage

快速用法

Common Tile Patterns

常见瓦片模式

Notes

注意事项

Prerequisites

先决条件

See Also

另请参阅