| Package | flash.display |
| Classe | public final class GraphicsStroke |
| Héritage | GraphicsStroke  Object |
| Implémente | IGraphicsStroke, IGraphicsData |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Utilisez l’objet GraphicsStroke avec la méthode Graphics.drawGraphicsData(). Dessiner un objet GraphicsStroke revient à appeler l’une des méthodes de la classe Graphics qui définit le style de ligne, par exemple les méthodes Graphics.lineStyle(), Graphics.lineBitmapStyle() ou Graphics.lineGradientStyle().
Eléments de l’API associés
flash.display.Graphics.lineBitmapStyle()
flash.display.Graphics.lineGradientStyle()
flash.display.Graphics.drawGraphicsData()
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
| caps : String
Spécifie le type d’extrémité au bout des lignes. | GraphicsStroke | ||
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| fill : IGraphicsFill
Spécifie l’occurrence contenant les données pour le remplissage d’un trait. | GraphicsStroke | ||
| joints : String
Spécifie le type d’apparence de liaison utilisé dans les angles. | GraphicsStroke | ||
| miterLimit : Number
Indique la limite à laquelle une pointe est coupée. | GraphicsStroke | ||
| pixelHinting : Boolean
Indique si des indices supplémentaires de lissage des pixels doivent être ajoutés. | GraphicsStroke | ||
| scaleMode : String
Spécifie l’échelle de l’épaisseur du trait. | GraphicsStroke | ||
| thickness : Number
Indique l’épaisseur de la ligne en points ; les valeurs disponibles sont comprises entre 0 et 255. | GraphicsStroke | ||
| Méthode | Défini par | ||
|---|---|---|---|
GraphicsStroke(thickness:Number = NaN, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = "none", joints:String = "round", miterLimit:Number = 3.0, fill:IGraphicsFill = null)
Crée un nouvel objet GraphicsStroke. | GraphicsStroke | ||
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
caps | propriété |
caps:String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie le type d’extrémité au bout des lignes. Les valeurs possibles sont les suivantes : CapsStyle.NONE, CapsStyle.ROUND et CapsStyle.SQUARE. En l’absence de valeur, Flash utilise des extrémités rondes.
Par exemple, l’illustration suivante présente les différents réglages capsStyle. Pour chaque paramètre, l’illustration présente une ligne bleue dont l’épaisseur est de 30 (pour laquelle capsStyle s’applique), et une ligne noire superposée dont l’épaisseur est de 1 (pour laquelle aucun capsStyle ne s’applique) :
Implémentation
public function get caps():String public function set caps(value:String):voidEléments de l’API associés
fill | propriété |
public var fill:IGraphicsFill| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie l’occurrence contenant les données pour le remplissage d’un trait. Une occurrence IGraphicsFill peut représenter une série de commandes de remplissage.
Eléments de l’API associés
joints | propriété |
joints:String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie le type d’apparence de liaison utilisé dans les angles. Les valeurs possibles sont les suivantes : JointStyle.BEVEL, JointStyle.MITER et JointStyle.ROUND. En l’absence de valeurs, Flash utilise des liaisons rondes.
Par exemple, l’illustration suivante présente les différents réglages joints. Pour chaque paramètre, l’illustration présente une ligne bleue en angle dont l’épaisseur est de 30 (pour laquelle jointStyle s’applique), et une ligne noire en angle superposée dont l’épaisseur est de 1 (pour laquelle aucun jointStyle ne s’applique) :
Remarque : pour les paramètres joints définis sur JointStyle.MITER, vous pouvez utiliser le paramètre miterLimit pour limiter la longueur de la pointe.
Implémentation
public function get joints():String public function set joints(value:String):voidEléments de l’API associés
miterLimit | propriété |
public var miterLimit:Number| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Indique la limite à laquelle une pointe est coupée. Les valeurs disponibles sont comprises entre 1 et 255 (et les valeurs qui excèdent cette plage sont arrondies à 1 ou 255). Cette valeur n’est utilisée que si jointStyle est défini sur "miter". La valeur miterLimit représente la longueur maximale d’une pointe au-delà du point où les lignes se rencontrent pour former une liaison. La valeur exprime un facteur du paramètre thickness de la ligne. Par exemple, avec un facteur miterLimit de 2,5 et une valeur de thickness de 10 pixels, la pointe est coupée à 25 pixels.
Par exemple, les lignes d’angle suivantes dessinent un objet avec un paramètre thickness d’une valeur de 20, mais un paramètre miterLimit défini sur 1, 2 et 4. Les lignes de référence noires sont surimposées et indiquent les points de rencontre des pointes :
Notez qu’une valeur miterLimit donnée possède un angle maximal spécifique pour lequel la pointe est coupée. Vous trouverez quelques exemples dans le tableau suivant :
Valeur miterLimit : | Les angles inférieurs aux valeurs indiquées sont coupés : |
|---|---|
| 1,414 | 90 degrés |
| 2 | 60 degrés |
| 4 | 30 degrés |
| 8 | 15 degrés |
pixelHinting | propriété |
public var pixelHinting:Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Indique si des indices supplémentaires de lissage des pixels doivent être ajoutés. Cette valeur affecte à la fois la position des ancres de courbe et la taille du trait. Si pixelHinting est défini sur true, Flash Player propose des index de largeur des pixels. Si pixelHinting est défini sur false, les courbes et les lignes droites risquent de ne pas être continues. Les exemples ci-dessous illustrent comment Flash Player effectue le rendu de deux rectangles arrondis identiques à une exception près : le réglage du paramètre pixelHinting utilisé par la méthode lineStyle() (les images sont mises à l’échelle 200 %, pour mettre en évidence la différence) :
scaleMode | propriété |
scaleMode:String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie l’échelle de l’épaisseur du trait. Les valeurs possibles sont :
-
LineScaleMode.NORMAL— Redimensionne toujours l’épaisseur du trait si l’objet est redimensionné (valeur par défaut). -
LineScaleMode.NONE— Ne redimensionne jamais l’épaisseur du trait. -
LineScaleMode.VERTICAL— N’ajuste pas l’épaisseur du trait si l’objet est redimensionné verticalement uniquement. Considérons par exemple les cercles illustrés ci-dessous, dessinés dans un trait d’un pixel, et pour lesquels le paramètrescaleModeest défini surLineScaleMode.VERTICAL. Le cercle de gauche est redimensionné verticalement uniquement, tandis que le cercle de droite est redimensionné à la verticale et à l’horizontale :
-
LineScaleMode.HORIZONTAL— N’ajuste pas l’épaisseur du trait si l’objet est redimensionné horizontalement uniquement. Considérons par exemple les cercles illustrés ci-dessous, dessinés dans un trait d’un pixel, et pour lesquels le paramètrescaleModeest défini surLineScaleMode.HORIZONTAL. Le cercle de gauche est redimensionné horizontalement uniquement, tandis que le cercle de droite est redimensionné à la verticale et à l’horizontale :
Implémentation
public function get scaleMode():String public function set scaleMode(value:String):voidEléments de l’API associés
thickness | propriété |
public var thickness:Number| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Indique l’épaisseur de la ligne en points ; les valeurs disponibles sont comprises entre 0 et 255. Si aucun nombre n’est spécifié, ou si le paramètre n’est pas défini, aucune ligne n’est dessinée. Si une valeur inférieure à 0 est transmise, la valeur par défaut est de 0. 0 correspond à l’épaisseur minimale et 255 à l’épaisseur maximale. Si la valeur transmise est supérieure à 255, la valeur par défaut est de 255.
GraphicsStroke | () | Constructeur |
public function GraphicsStroke(thickness:Number = NaN, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = "none", joints:String = "round", miterLimit:Number = 3.0, fill:IGraphicsFill = null)| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Crée un nouvel objet GraphicsStroke.
Paramètresthickness:Number (default = NaN) | |||||||||||
pixelHinting:Boolean (default = false)pixelHinting est défini sur true, Flash Player propose des index de largeur des pixels. Si pixelHinting est défini sur false, les courbes et les lignes droites risquent de ne pas être continues. Les exemples ci-dessous illustrent comment Flash Player effectue le rendu de deux rectangles arrondis identiques à une exception près : le réglage du paramètre pixelHinting utilisé par la méthode lineStyle() (les images sont mises à l’échelle 200 %, pour mettre en évidence la différence) :
Si vous ne spécifiez pas de valeur, la ligne n’utilise pas les index de lissage des pixels. | |||||||||||
scaleMode:String (default = "normal")
| |||||||||||
caps:String (default = "none")CapsStyle.NONE, CapsStyle.ROUND et CapsStyle.SQUARE. En l’absence de valeur, Flash utilise des extrémités rondes.
Par exemple, l’illustration suivante présente les différents réglages
| |||||||||||
joints:String (default = "round")JointStyle.BEVEL, JointStyle.MITER et JointStyle.ROUND. En l’absence de valeurs, Flash utilise des liaisons rondes.
Par exemple, l’illustration suivante présente les différents réglages
Remarque : pour les paramètres | |||||||||||
miterLimit:Number (default = 3.0)jointStyle est défini sur "miter". La valeur miterLimit représente la longueur maximale d’une pointe au-delà du point où les lignes se rencontrent pour former une liaison. La valeur exprime un facteur du paramètre thickness de la ligne. Par exemple, avec un facteur miterLimit de 2,5 et une valeur de thickness de 10 pixels, la pointe est coupée à 25 pixels.
Par exemple, les lignes d’angle suivantes dessinent un objet avec un paramètre
Notez qu’une valeur
| |||||||||||
fill:IGraphicsFill (default = null) |
Eléments de l’API associés
Tue Jun 12 2018, 09:30 AM Z