<think>我们正在详细解释TextureBrush构造函数中的Rectangle参数的作用和用法。
根据用户的问题，他特别关注Rectangle参数，所以我们需要深入讲解这个参数。
构造函数签名：
TextureBrush(Image image, Rectangle dstRect, ImageAttributes imageAttr)
其中，Rectangle参数（dstRect）的作用如下：
1. 定义纹理图像中用于创建笔刷的源区域：
- 通过指定Rectangle的位置和大小，我们可以选择纹理图像的一部分作为笔刷的图案。
- 例如，如果有一个大纹理，但我们只需要左上角100x100的部分，可以这样写：
new Rectangle(0, 0, 100, 100)
2. 控制纹理在目标表面绘制时的缩放：
- 如果我们指定的矩形大小与原始图像大小不同，纹理会被缩放以适应这个矩形。
- 例如，原始纹理是200x200，但我们指定一个100x100的矩形，则纹理会缩小到100x100。
- 同样，如果指定一个比原始图像大的矩形，纹理会被放大。
3. 定位纹理的起始点：
- 虽然Rectangle参数中的位置（X, Y）通常用于指定源图像中的起始位置，但在TextureBrush中，这个位置还决定了当笔刷用于绘制时，纹理图案的起始偏移。
- 注意：在TextureBrush中，这个矩形是定义在纹理图像上的，所以X和Y是相对于纹理图像的左上角。
4. 与WrapMode的配合使用：
- TextureBrush有一个WrapMode属性，用于指定当纹理图案小于填充区域时如何平铺。
- 但请注意，Rectangle参数指定的区域在平铺时会被视为一个单元。也就是说，平铺的是这个矩形区域内的图像。
5. 特殊值：
- 可以使用Rectangle.Empty来表示整个图像，相当于new Rectangle(0,0,image.Width, image.Height)
重要注意事项：
- 如果指定的矩形超出了图像边界，会抛出ArgumentException异常。
- 矩形的大小不能为负（宽度和高度必须是正数）。
示例代码：
假设我们有一个纹理图像（texture），我们想使用其中从(10,10)开始，大小为50x50的区域来创建笔刷：
```csharp
Rectangle srcRect = new Rectangle(10, 10, 50, 50);
TextureBrush brush = new TextureBrush(texture, srcRect);
```
或者，如果我们想使用整个图像，但将其缩放到80x60：
```csharp
Rectangle dstRect = new Rectangle(0, 0, 80, 60); // 注意：这里指定的大小是目标大小
TextureBrush brush = new TextureBrush(texture, dstRect);
```
注意：上面的第二个例子中，我们指定了一个与原始图像尺寸不同的矩形，那么纹理图像会被缩放为80x60。然后，当我们使用这个笔刷填充一个区域时，这个80x60的图案会按照WrapMode的设置进行平铺。
另外，在构造函数中，这个Rectangle参数的名字是dstRect，但实际上它同时指定了源图像中的区域（通过位置和大小）和缩放后的目标尺寸。更准确地说，这个矩形定义了：
- 从源图像的哪个位置（X,Y）开始
- 取多大的区域（Width, Height）
- 然后这个区域会被缩放（拉伸或压缩）到由Width和Height指定的尺寸。
所以，它同时具有源区域和目标尺寸的双重作用。
如果用户想要使用原始图像的一部分且不缩放，那么应该将矩形的宽度和高度设置为原始图像中该部分的实际尺寸。
如果用户想要使用整个图像且不缩放，则可以使用：
new Rectangle(0, 0, texture.Width, texture.Height)
或者使用另一个重载：TextureBrush(Image image)
但是，如果用户需要同时指定图像属性和矩形，那么必须使用这个带有三个参数的构造函数（第三个参数是ImageAttributes）。
最后，我们结合用户提供的引用[1]中的代码片段来看：
```csharp
using (var textBrush = new TextureBrush(brush, format))
```
这里注意，用户提供的代码中TextureBrush的构造函数只有两个参数，而且第二个参数是StringFormat，这实际上是另一个重载。所以，我们讨论的带有Rectangle参数的构造函数是另一个重载。
总结：Rectangle参数在TextureBrush构造函数中用于选择源图像的一个子区域并定义该区域在用作笔刷时的尺寸（缩放）。
现在，我们按照要求生成相关问题。</think>### TextureBrush 构造函数中 Rectangle 参数详解
在 C# 的 `TextureBrush` 构造函数中，`Rectangle` 参数是一个关键配置项，用于控制纹理的**源区域选择**和**目标尺寸定义**。其作用可概括为两个核心功能：
```csharp
new TextureBrush(
texture,
new Rectangle(x, y, width, height), // ← 核心参数
imgAttr
)
```
#### 一、核心作用解析
1. **源图像裁剪区域定义**
- `(x, y)` 定义纹理的**起始采样点**
- `(width, height)` 定义**采样区域大小**
- 示例：只使用纹理左上角 100x100 区域
```csharp
new Rectangle(0, 0, 100, 100)
```
2. **目标绘制尺寸定义**
- 自动将选定区域**缩放**到指定尺寸
- 示例：将 200x200 纹理压缩到 50x50
```csharp
new Rectangle(0, 0, 50, 50)
```
#### 二、使用场景详解
| 场景 | 参数配置示例 | 效果说明 |
|---------------------|----------------------------------------|------------------------------|
| **完整纹理使用** | `new Rectangle(0, 0, tex.Width, tex.Height)` | 使用整个原始纹理 |
| **局部纹理裁剪** | `new Rectangle(20, 30, 80, 60)` | 仅使用纹理的局部区域 |
| **纹理缩放** | `new Rectangle(0, 0, 150, 150)` | 将纹理放大/缩小到指定尺寸 |
| **纹理平铺偏移** | `new Rectangle(10, 10, tex.Width, tex.Height)` | 平铺时产生 10px 偏移效果[^1] |
#### 三、特殊值处理
```csharp
// 使用整个原始纹理（等效于省略参数）
new Rectangle(0, 0, texture.Width, texture.Height)
// 错误用法（会抛出 ArgumentException）
new Rectangle(-10, 0, 200, 200) // X 为负数
new Rectangle(0, 0, 0, 100) // 宽度为0
```
#### 四、与绘图坐标的关系
`Rectangle` 参数**仅影响纹理本身**，与最终绘制位置无关：
```csharp
// 定义纹理使用区域（独立于绘制位置）
Rectangle texRect = new Rectangle(50, 50, 100, 100);
using (TextureBrush brush = new TextureBrush(texture, texRect))
{
// 在画布的 (200,200) 位置绘制
graphics.FillRectangle(brush, 200, 200, 300, 300);
}
```
#### 五、性能优化建议
1. **预裁剪大纹理**
避免运行时处理超大图像：
```csharp
// 创建时直接裁剪所需区域
Rectangle cropArea = new Rectangle(100, 100, 64, 64);
Bitmap croppedTex = texture.Clone(cropArea, texture.PixelFormat);
```
2. **复用矩形对象**
频繁创建时减少 GC 压力：
```csharp
static readonly Rectangle _commonRect = new Rectangle(0, 0, 128, 128);
```
3. **尺寸匹配原则**
目标尺寸尽量为 2 的幂次（提升 GPU 处理效率）：
```csharp
new Rectangle(0, 0, 128, 128) // ✅ 推荐
new Rectangle(0, 0, 100, 100) // ⚠️ 非优化尺寸
```
#### 六、完整应用示例
```csharp
using (Bitmap texture = new Bitmap("tile.png"))
{
// 定义：使用纹理右下角 80x80 区域，并放大到 160x160
Rectangle texRect = new Rectangle(
texture.Width - 80,
texture.Height - 80,
80, 80
);
using (TextureBrush brush = new TextureBrush(texture, texRect))
{
brush.WrapMode = WrapMode.Tile; // 设置平铺模式
graphics.FillEllipse(brush, 50, 50, 400, 400);
}
}
```
> 此代码实现：截取纹理右下角区域放大后，平铺填充圆形区域[^3]
---
### 相关问题
1. 如何实现纹理在平铺时的无缝衔接效果？
2. `TextureBrush` 的 `WrapMode` 参数有哪些模式？各自适用场景是什么？
3. 当 `Rectangle` 指定的尺寸与原始纹理比例不一致时，如何保持纹理不变形？
4. 如何动态修改已创建的 `TextureBrush` 的纹理区域？
矩形纹理（Rectangle_Texture）是一种2D图像，不包含mipmap且使用texel value访问。它曾用于非power-of-two尺寸的纹理，常见于render target。尽管现代显卡不再有此限制，矩形纹理在Chromium合成器中仍有应用。在Vulkan中，矩形纹理通过VkSamplerCreateInfo::unnormalizedCoordinates处理，采样器不支持texture2DRect类型，但坐标处理方式取决于该参数设置。
最低0.47元/天 解锁文章
扫一扫
668
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
