dashes

Typeproperty
DictionaryLCS
LibraryLiveCode Script
Syntax
set the dashes [of <graphic>] to <pixelsOn> [, <pixelsOff>]
Associationsgraphic
Summary

Specifies the appearance of dashed lines in graphics and paint images.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
set the dashes to 10,2 -- 10-pixel dashes separated by 2 pixels
set the dashes of graphic "Connector" to 1,2,5,2 -- "dit-dah" dashes
set the dashes of graphic 10 to empty -- makes a solid line
Values
NameTypeDescription
Value

A list of numbers which specifies a sequence of pixel lengths that alternately represent space and dash lengths. By default, the dashes property of a newly created graphic is set to empty.

RelatedKeyword: items
Constant: true, false
Property: relativePoints, roundEnds, lineSize, capStyle
Command: global, set
Object: control, image, graphic
Glossary: pixel, integer, property, appearance, paint tool, default
Description

Use the dashes property to change the appearance of lines.

The odd-numbered items in the dashes property represent the number of pixels in a dash, and the even-numbered items represent the number of pixels in the blank space after the dash. The list is repeated for the length of the line. An odd number of pixel lengths will cause the dash and space pixel lengths to alternate between repeats. For example, if the dashes is set to 20,10,5 the line will contain the following: 20 pixel dash, 10 pixel space, 5 pixel dash, 20 pixel space, 10 pixel dash, 5 pixel space etc.

If the dashes property contains a single integer the dashes and spaces will both be given this pixel value. If the dashes property is empty, the line will be solid.

The global setting of the dashes property controls the appearance of lines drawn with the paint tools in the same way. Once a paint line is drawn however, its appearance cannot be changed by changing the global dashes property.

Note: The capStyle property of a graphic is set to "round" by default. The roundEnds property of a graphic is true by default. Under these conditions, a dashes length that is equal to or less than the lineSize property of the graphic will make the line appear solid. To ensure that the line appears with dashes do one or more of the following:

Tagsui