twinkle highlights one or more graphical objects by flashing them

## Syntax

                twinkle
                twinkle(n)
                twinkle(h)
                twinkle(h,n)

## Arguments

h

  handle or vector of handles of one or several graphical entities to blink. By default, the current graphic entity pointed by `gce()` is considered.

n

  positive integer number: the number of blinks. Default n = 5.

## Description

`twinkle` blinks `n` times graphical entities handled with `h`. If some of the objects are initially invisible, they are blinked with other ones and are finally left invisible before returning.

If `twinkle()` is run while no graphical figure exists, it does nothing and returns. If the handle `h` has some invalid components (the entity has been deleted in the meantime), `twinkle(h..)` yields an error.

## Examples

    clf
    plot()
    twinkle     // twinkles the last group of curves plotted in the plot() example
    twinkle(3)  // twinkles it only three times

    clf
    x = linspace(-2*%pi,2*%pi,100)';
    plot2d(x,[sin(x),cos(x)]);
    e = gce();
    p1 = e.children(1);
    p2 = e.children(2);
    twinkle(p1)       // cos plot twinkle
    twinkle(p2,10)    // sin plot twinkle 10 times
    twinkle(gca())    // axes twinkle

    // Blinking a subset of many curves, with some initially invisible ones
    clf
    plot()
    c = gca().children.children(1:10);
    c(1:5).visible = "off";
    sleep(5,'s')
    twinkle(c)

## See also

- graphics entities

## History

6.0

twinkle() and twinkle(n) added.

6.1

Several independent objects can now be blinked together.