PEXReturnAccumulationBuffer - Return Accumulation Buffer (5.2)


Synopsis

                                                                           
     void PEXReturnAccumulationBuffer(                                   
             Display *display,                
             Drawable drawable,              
             float scale_factor          
        )                                                                       

Arguments

display
A pointer to a display structure returned by a successful XOpenDisplay call.

drawable
The drawable which is loaded with the scaled contents of the accumulation buffer associated with it.

scale_factor
The scale factor used to scale the accumulated values as they are copied to the drawable.

Returns

None.

Description

Invoke PEXReturnAccumulationBuffer to multiply the contents of the accumulation buffer (A) associated with drawable (D) by the scale_factor (w) and then write to the drawable itself.

This function overwrites the existing values in the drawable. The operation is as follows:

If underflow or overflow occurs, then the result is implementation-dependent.

If the drawable has been resized but its accumulation buffer has not yet been resized by using the PEXLoadAccumulationBuffer function, the implementation will take no action for this function.

Errors

BadDrawable
drawable is invalid.

BadMatch
The drawable specified by drawable does not have an allocated accumulation buffer.

See Also

See Accumulation Buffers for an overview.