PureBasic & GDI+ 1.0
LinearGradientBrush

Les brush de type LinearGradientBrush permettent de créer des dégradés linéaires à partir de 2 couleurs de base qui sont la couleur de départ et la couleur d'arrivée, ainsi que de paramètres variables selon le type de brush qui permettant de définir les coordonnées. Quatre grand types de dégradés sont disponibles tels que décrits par les valeurs LinearGradientMode.

La taille de la brush peut être égale ou différente de la zone ou elle sera dessinée. Si la brush est plus petite que la zone dessinée, il y aura répétition du motif jusqu'à ce que la zone soit remplie. Dans ce cas, le paramètre wrapMode.l des fonctions permet de spécifier le mode de remplissage des formes. Si le dégradé est plus petit que la zone à remplir, il sera disposé en mosaïque selon un des formats de l'énumération Wrapmode.

Lorsqu'une brush est créée, il est possible d'appliquer des modifications (nombreuses fonctions).

- Les méthodes de transformation géométrique (rotation --> rotate).
- Les méthodes de mise à l'échelle (scale).
- Les méthodes de translation (translate).
- Les méthodes de mélange des couleurs (blend).
- Correction gamma.

Certaines modifications utilisent des matrices de transformation dont un paramètre permet de positionner l'ordre des modifications tel que décrit par les valeurs MatrixOrder.

Les brush (donc les LinearGradientBrush) sont des objets qui sont utilisés pour remplir l'intérieur d'une forme fermée. Des fonctions telles que GdipFillEllipseI(),  GdipFillRectangleI() etc. doivent être utilisées pour afficher la brush sur un objet graphic.

Les couleurs passées en paramètre aux brush doivent avoir été préalablement modifiées par la procédure ARGB (voir le fichier gdiplus.pbi)

Lorsque l'on retrouve une couleur avec une des commandes existantes, il faut la modifier à l'aide de la fonction ARGBEX() qui se trouve dans le fichier gdiplus.pbi

Valeur de retour:

D'une manière générale, les fonctions retournent les valeurs suivantes :

Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status.

Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.

GdipCreateLineBrush

GdipCreateLineBrushI

GdipCreateLineBrushFromRect

GdipCreateLineBrushFromRectI

GdipCreateLineBrushFromRectWithAngle

GdipCreateLineBrushFromRectWithAngleI

GdipGetLineBlend

GdipGetLineBlendCount

GdipGetLineColors

GdipGetLineGammaCorrection

GdipGetLinePresetBlend

GdipGetLinePresetBlendCount

GdipGetLineRect

GdipGetLineRectI

GdipGetLineTransform

GdipGetLineWrapMode

GdipMultiplyLineTransform

GdipResetLineTransform

GdipRotateLineTransform

GdipScaleLineTransform

GdipSetLineBlend

GdipSetLineColors

GdipSetLineGammaCorrection

GdipSetLineLinearBlend

GdipSetLinePresetBlend

GdipSetLineSigmaBlend

GdipSetLineTransform

GdipSetLineWrapMode

GdipTranslateLineTransform