[][src]Function turtle::start

pub fn start()

Start the turtle window in advance

If you do not create a turtle immediately at the beginning of main() with Turtle::new(), you must call this function at the start of main() to avoid any problems.

Since the majority of code created using this crate does little or no work before calling Turtle::new(), this usually isn't a problem. Programs that parse command line arguments, read input, or check environment variables may fail to start if this function is not called right at the beginning of the program. Programs that perform any expensive computations may experience delayed start up problems unless they call this function first.

The Turtle::new() method will call this function for you so that you don't need to worry about this unless you are doing something before that.

Example

use turtle::Turtle;

fn main() {
    // Initializes the turtle renderer first so that there is less delay when a Turtle
    // is created and so that there are no conflicts with command line arguments or
    // environment variables.
    // Not required if Turtle::new() is already at the top of main.
    turtle::start();

    // Do all kinds of expensive work here...
    // Feel free to check environment variables, command line arguments, etc.

    // Create the turtle when you are ready
    // Turtle::new() will also call start(), but calling it twice doesn't matter
    let mut turtle = Turtle::new();
    // Do things with the turtle...
}