Index

C/C++ Functions

pdDocInvertLine

void pdDocInvertLine(DT_PDDOC power_doc, DT_SRAST_L x, DT_SRAST_L y, DT_SRAST_L w, DT_SRAST_L h, DT_ID_SWORD format, DT_ID_SWORD subformat, const DT_MDC* memory_surface)

Short Description: Invert document area (line)

The pdDocInvertLine function applies an inversion effect to a line segment within an existing memory surface. The blend parameters of the effect can be set by calling pdDocSetInvert.

Parameters

ParameterDescription

power_doc

Handle of the associated Power Engine document.

x

X coordinate of the line segment's enclosing rectangle, in pixels.

y

Y coordinate of the line segment's enclosing rectangle, in pixels.

w

Width of the line segment's enclosing rectangle, in pixels.

h

Height of the line segment's enclosing rectangle, in pixels.

format

Same as in pdDocDraw. See the pdDocDraw function for details.

subformat

Same as in pdDocDraw. See the pdDocDraw function for details.

memory_surface

A pointer to the DT_MDC structure that describes the surface. See D-Type Standard Engine Manual for details.

Comments

This function can be used to invert the color of an area within an existing memory surface without the need to redraw the entire area by calling the pdDocDraw function. Depending on the blend parameters (set by calling the pdDocSetInvert function), certain inversion effects are reversible. This means that when applied two times successively to the same pixels, the result will be the same as if the effect was not applied at all. For this reason, these inversion effect can be used to visually indicate various types of temporary user selections (e.g. the cursor movements, text or block selections).

Related Functions

pdDocDraw
pdDocInvertBox, pdDocInvertQuad, pdDocInvertFrames

 

Index