Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

LineDDA function

The LineDDA function determines which pixels should be highlighted for a line defined by the specified starting and ending points.

Syntax


BOOL LineDDA(
  _In_  int nXStart,
  _In_  int nYStart,
  _In_  int nXEnd,
  _In_  int nYEnd,
  _In_  LINEDDAPROC lpLineFunc,
  _In_  LPARAM lpData
);

Parameters

nXStart [in]

Specifies the x-coordinate, in logical units, of the line's starting point.

nYStart [in]

Specifies the y-coordinate, in logical units, of the line's starting point.

nXEnd [in]

Specifies the x-coordinate, in logical units, of the line's ending point.

nYEnd [in]

Specifies the y-coordinate, in logical units, of the line's ending point.

lpLineFunc [in]

Pointer to an application-defined callback function. For more information, see the LineDDAProc callback function.

lpData [in]

Pointer to the application-defined data.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

The LineDDA function passes the coordinates for each point along the line, except for the line's ending point, to the application-defined callback function. In addition to passing the coordinates of a point, this function passes any existing application-defined data.

The coordinates passed to the callback function match pixels on a video display only if the default transformations and mapping modes are used.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Lines and Curves Overview
Line and Curve Functions
LineDDAProc

 

 

Community Additions

Show:
© 2014 Microsoft