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.

LineJoin enumeration

Applies to: desktop apps only

The LineJoin enumeration specifies how to join two lines that are drawn by the same pen and whose ends meet. At the intersection of the two line ends, a line join makes the join look more continuous.

Syntax

typedef enum  {
  LineJoinMiter          = 0,
  LineJoinBevel          = 1,
  LineJoinRound          = 2,
  LineJoinMiterClipped   = 3 
} LineJoin;

Constants

LineJoinMiter

Specifies a mitered join. This produces a sharp corner or a clipped corner, depending on whether the length of the miter exceeds the miter limit.

LineJoinBevel

Specifies a beveled join. This produces a diagonal corner.

LineJoinRound

Specifies a circular join. This produces a smooth, circular arc between the lines.

LineJoinMiterClipped

Specifies a mitered join. This produces a sharp corner or a beveled corner, depending on whether the length of the miter exceeds the miter limit.

Remarks

The miter length is the distance from the intersection of the line walls on the inside of the join to the intersection of the line walls outside of the join. The miter length can be large when the angle between two lines is small. The miter limit is the maximum allowed ratio of miter length to stroke width. The default value is 10.0f.

When using LineJoinMiter and the actual ratio exceeds the miter limit, the corner is clipped perpendicular to the miter at a distance from the inner corner that is the product of the miter limit and the pen width.

Illustration showing two lines with a corner that is clipped: the outside walls of the lines do not meet at a point

When using LineJoinMiterClipped and the miter limit is exceeded, the join is drawn as if its type were LineJoinBevel; that is, when the line walls on the inside of the join meet, then a joining line is drawn between the line walls on the outside of the join.

Illustration showing two lines with a corner that is beveled

Requirements

Minimum supported client

Windows XP, Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Product

GDI+ 1.0

Header

Gdiplusenums.h (include Gdiplus.h)

See also

Pen::SetLineJoin
Pen::SetMiterLimit

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

Show: