# gdip.pathGradientBrush 库模块帮助文档

## gdip 成员列表 <a id="gdip" href="#gdip">&#x23;</a>

### gdip.pathGradientBrush <a id="gdip.pathGradientBrush" href="#gdip.pathGradientBrush">&#x23;</a>
路径渐变笔刷

创建路径渐变笔刷

### gdip.pathGradientBrush() <a id="gdip.pathGradientBrush" href="#gdip.pathGradientBrush">&#x23;</a>
[返回对象:gdippathGradientbrushObject](#gdippathGradientbrushObject)

### gdip.pathGradientBrush(points,wrapMode) <a id="gdip.pathGradientBrush" href="#gdip.pathGradientBrush">&#x23;</a>
参数 @points 可指定 ::POINTF 结构体数组（至少包含 3 个坐标点），  
也可以指定数值数组（每 2 个数值表示一个坐标点，至少指定 3 个坐标点）。   
参数 @wrapMode 可选用 _GdipWrapMode 前缀常量指定平铺填充模式

### gdip.pathGradientBrush(rectf,wrapMode) <a id="gdip.pathGradientBrush" href="#gdip.pathGradientBrush">&#x23;</a>
参数 @rectf 可指定 ::RECT 结构体或者 ::RECT 结构体。  
参数 @wrapMode 可选用 _GdipWrapMode 前缀常量指定平铺填充模式

### gdip.pathGradientBrush(路径对象) <a id="gdip.pathGradientBrush" href="#gdip.pathGradientBrush">&#x23;</a>
参数 @1 指定 gdip.path 对象。  
应当先添加有效数据到路径对象。  

如果不指定参数 @1 则不会初始化笔刷，可调用返回对象的 setPath 方法创建渐变笔刷。

## gdippathGradientbrushObject 成员列表 <a id="gdippathGradientbrushObject" href="#gdippathGradientbrushObject">&#x23;</a>

### gdippathGradientbrushObject.delete() <a id="gdippathGradientbrushObject.delete" href="#gdippathGradientbrushObject.delete">&#x23;</a>
释放路径对象

### gdippathGradientbrushObject.gammaCorrection <a id="gdippathGradientbrushObject.gammaCorrection" href="#gdippathGradientbrushObject.gammaCorrection">&#x23;</a>
是否允许伽马校正

### gdippathGradientbrushObject.resetTransform() <a id="gdippathGradientbrushObject.resetTransform" href="#gdippathGradientbrushObject.resetTransform">&#x23;</a>
将此渐变笔刷的变换矩阵重置为单位矩阵，并返回自身。  
此操作会撤消 translate/rotate/scale 等方法应用的变换矩阵。

### gdippathGradientbrushObject.rotate(角度,矩阵顺序) <a id="gdippathGradientbrushObject.rotate" href="#gdippathGradientbrushObject.rotate">&#x23;</a>
旋转渐变笔刷并返回自身  
矩阵顺序可省略，默认为 0（前置）

### gdippathGradientbrushObject.scale(水平比例,垂直比例,矩阵顺序) <a id="gdippathGradientbrushObject.scale" href="#gdippathGradientbrushObject.scale">&#x23;</a>
缩放渐变笔刷并返回自身  
矩阵顺序可省略，默认为 0（前置）

### gdippathGradientbrushObject.setBlend(颜色因子数组,位置因子数组) <a id="gdippathGradientbrushObject.setBlend" href="#gdippathGradientbrushObject.setBlend">&#x23;</a>
参数@1使用小数表示的百分比代表色彩渐变的度,  
0表示起点色,1表示完全转变为终点色  
合成位置中0表示起点,1表示终点,第一个合成位置必须是0,最后一个必须是1

### gdippathGradientbrushObject.setCenterColor(颜色) <a id="gdippathGradientbrushObject.setCenterColor" href="#gdippathGradientbrushObject.setCenterColor">&#x23;</a>
指定中心颜色。  
颜色请使用 0xAARRGGBB 格式数值

### gdippathGradientbrushObject.setCenterPoint(pointf) <a id="gdippathGradientbrushObject.setCenterPoint" href="#gdippathGradientbrushObject.setCenterPoint">&#x23;</a>
设置中心点坐标，参数 pointf 必须指定 ::POINTF 结构体。  

未修改中心坐标时，默认自动自动计算几何中心（Centroid）

### gdippathGradientbrushObject.setCenterPoint(x,y) <a id="gdippathGradientbrushObject.setCenterPoint" href="#gdippathGradientbrushObject.setCenterPoint">&#x23;</a>
设置中心点坐标，参数 x,y 必须指定数值。  

未修改中心坐标时，默认自动计算几何中心（Centroid）

### gdippathGradientbrushObject.setFocusScales(x聚焦缩放,y聚焦缩放) <a id="gdippathGradientbrushObject.setFocusScales" href="#gdippathGradientbrushObject.setFocusScales">&#x23;</a>
对中心焦点进行缩放,参数为x轴、y轴的缩放比例,  
使中心颜色不仅显示在中心点,而是显示于围绕中心点进行缩放的路径内，  
被缩放的中心焦点路径内部使用中心颜色填充

### gdippathGradientbrushObject.setInterpolationColors(插值颜色数组,插值位置数组) <a id="gdippathGradientbrushObject.setInterpolationColors" href="#gdippathGradientbrushObject.setInterpolationColors">&#x23;</a>
定义多色渐变  
数组元素都是数值,长度必须相等  
插值位置以小数表示百分比,开始必须为0表示外边界,最后一个必须为1

### gdippathGradientbrushObject.setPath(路径对象) <a id="gdippathGradientbrushObject.setPath" href="#gdippathGradientbrushObject.setPath">&#x23;</a>
使用参数 @1 指定的 gdip.path 对象重新创建路径渐变笔刷。  
如果之前已经创建了笔刷则会删除原来笔刷对象。

### gdippathGradientbrushObject.setSurroundColors(颜色数组) <a id="gdippathGradientbrushObject.setSurroundColors" href="#gdippathGradientbrushObject.setSurroundColors">&#x23;</a>
指定环绕颜色  
参数可以是数组,也可以是多个颜色数值参数,  
颜色请使用0xAARRGGBB格式数值

### gdippathGradientbrushObject.translate(横位移,纵位移,矩阵顺序) <a id="gdippathGradientbrushObject.translate" href="#gdippathGradientbrushObject.translate">&#x23;</a>
平移渐变笔刷并返回自身  
矩阵顺序可省略，默认为 0（前置）
