Lingo Dictionary > L-N > marker() |  |

marker()

Syntax

    marker(integerExpression)
    marker("string")

Description

Function; returns the frame number of markers before or after the current frame. This function is useful for implementing a Next or Previous button or for setting up an animation loop.

The argument `integerExpression` can evaluate to any positive or negative integer or 0. For example:

| `marker(2)`—Returns the frame number of the second marker after the current frame.
| `marker(1)`—Returns the frame number of the first marker after the current frame.
| `marker(0)`—Returns the frame number of the current frame if the current frame is marked, or the frame number of the previous marker if the current frame is not marked.
| `marker(-1)`—Returns the frame number of the first marker before the marker(0).
| `marker(-2)`—Returns the frame number of the second marker before the marker(0).

If the argument for `marker` is a string, `marker` returns the frame number of the first frame whose marker label matches the string.

Example

This statement sends the playback head to the beginning of the current frame if the current frame has a marker, otherwise it sends the playback head to the previous marker:

    go to marker(0)

Example

This statement sets the variable `nextMarker` equal to the next marker in the Score:

    nextMarker = marker(1)

See also

`go`, `frame() (function)`, `frameLabel`, `label()`, `labelList`