Drawing Graphics: 2.2 Shapes: Lines

Up: GEOS SDK TechDocs| Up | Prev: 2.1 Dots | Next: 2.3 Rectangles
GrDrawLine(), GrDrawLineTo(), GrDrawRelLineTo(), GrDrawHLine(), GrDrawHLineTo(), GrDrawVLine(), GrDrawVLineTo()

A line is simply a line segment that connects two points. Lines are drawn using the current line attributes stored with the GState. The new pen position becomes the last passed coordinate pair.

GrDrawLine() draws a line between points. GrDrawLineTo() draws a line from the current pen position to the passed point. GrDrawHLine() draws a horizontal line between two points. These two points share the same y coordinate (thus the line is horizontal). GrDrawHLineTo() draws a horizontal line from the current pen position to a passed x coordinate. GrDrawVLine() draws a vertical line between two points which share a common x coordinate. GrDrawVLineTo() draws a vertical line from the current pen position to a passed y coordinate. The GrDrawH...() and GrDrawV...() routines save space compared to GrDrawLine() or GrDrawLineTo() , since fewer coordinates are necessary to define the line.

GrDrawRelLineTo() draws a line from the current pen position to the point at the specified x and y offset from the starting position. This routine takes very precise coordinates, and is useful for describing paths.


Up: GEOS SDK TechDocs| Up | Prev: 2.1 Dots | Next: 2.3 Rectangles