Method
CoglFramebufferresolve_samples_region
Declaration [src]
void
cogl_framebuffer_resolve_samples_region (
CoglFramebuffer* framebuffer,
int x,
int y,
int width,
int height
)
Description [src]
When point sample rendering (also known as multisample rendering)
has been enabled via cogl_framebuffer_set_samples_per_pixel()
then you can optionally call this function (or
cogl_framebuffer_resolve_samples()
) to explicitly resolve the point
samples into values for the final color buffer.
Some GPUs will implicitly resolve the point samples during rendering and so this function is effectively a nop, but with other architectures it is desirable to defer the resolve step until the end of the frame.
Use of this API is recommended if incremental, small updates to a framebuffer are being made because by default Cogl will implicitly resolve all the point samples of the framebuffer which can result in redundant work if only a small number of samples have changed.
Because some GPUs implicitly resolve point samples this function only guarantees that at-least the region specified will be resolved and if you have rendered to a larger region then it’s possible that other samples may be implicitly resolved.
Stability: | Unstable |
Available since: | 1.8 |