dbIsTrackPatternColored

dbIsTrackPatternColored(
d_trackPatternId
)
=> t / nil

Description

Returns a Boolean value that indicates whether the first track of the specified track pattern is colored in a color other than gray.

To color the track pattern, use dbSetTrackPatternFirstTrackColor or dbSetTrackPatternColorAlternating.

Arguments

d_trackPatternId

Specifies the track pattern ID

Value Returned

t	Returns t if the track pattern is colored
nil	Returns nil if the track pattern is not colored or an error occurs during execution

Examples

Creates a track pattern, then checks for coloring on the track pattern. Newly created track patterns are not colored.

dbIsTrackPatternColored( dbCreateTrackPattern( cvId t 100 10 10 "M1") ) => nil

Creates a track pattern, then sets the first track color to mask2Color, which makes the track pattern colored.

tpID = dbCreateTrackPattern( cvId t 100 10 10 "M1") )
dbSetTrackPatternFirstTrackColor( tpID "mask2Color" )
dbIsTrackPatternColored( tpID ) => t

Return to top