a2StartDotBatch This command begins a dot batch drawing operation.
Syntax
    a2StartDotBatch batchSize
Parameters
    batchSize
Boolean An estimate of how many dots will be drawn in this batch.
Returns
This command does not return a value.
Description
This command begins an a2Dot batch drawing operation. The batch size is an estimate of how many dots are planned to be drawn. It doesn't matter if it's too big or too small, but the closer it is the more efficient the batch.
Example Code
    a = timer()

    for x = 1 to 100000
        a2Dot rnd(screen width()), rnd(screen height()), rgb(rnd(255), rnd(255), rnd(255))
    next x

    t1 = timer()-a
    a = timer()
    a2StartDotBatch 100000

    for x = 1 to 100000
        a2Dot rnd(screen width()), rnd(screen height()), rgb(rnd(255), rnd(255), rnd(255))
    next x

    a2EndBatch
    t2 = timer()-a
    set text opaque
    print "No batch:";t1;" milliseconds"
    print " Batched:";t2;" milliseconds"

    WAIT KEY
See also
a2StartLineBatch a2StartTriangleBatch a2EndBatch Advanced 2D Index Main Menu