LÖVE 11 draw call batching documentation?

[Ross]

Is there any documentation on how the new draw call batching works? Specifically, what breaks a batch?

[slime]

The love.graphics.flushBatch wiki page describes it.

[raidho36]

Batch is broken automatically whenever it is required. Doing it manually just increases amount of draw calls and reduces performance, compared to automatic mode. With that in mind, I'm not even sure why it's there. Placebo effect I guess?

[zorg]

It has its reasons, i guess.

[Ross]

Aha! Thanks, slime. So I can change the transform and the color, and draw the same image (or quad pieces of the same image) as much as I want, but that's about it.

1. Now I can also use any of the line/shape/point drawing functions without breaking the batch, right?
   . . . (arc, circle, ellipse, line, points, polygon, and rectangle.)
2. But .setPointSize, .setLineWith, etc., will break the batch?

[slime]

With that in mind, I'm not even sure why it's there.

Mostly so people can (theoretically) still use raw OpenGL if they really really want to, and are really careful.