Advanced 2D Help File

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