Draw a grid
int PgDrawGrid( PhRect_t const *r, PhPoint_t const *g ); int PgDrawGridCx( void *dc, PhRect_t const *r, PhPoint_t const *g );
ph
These functions draw a rectangular grid. PgDrawGrid() works on the current draw context, while you can specify the draw context for PgDrawGridCx().
These functions build a draw command to draw the grid. The size of the grid is defined by the r argument with g.x+1 vertical lines and g.y+1 horizontal lines. If g.x is 0, no vertical lines are drawn; if g.y is 0, no horizontal lines are drawn.
The following example uses PgDrawGrid() to make a grid of 8 squares by 8 squares; each square is 8 by 8 pixels:
void GridStandard() { PhRect_t r = { 8, 8, 72, 72 }; PhPoint_t g = { 8, 8 }; PgSetStrokeColor( Pg_WHITE ); PgDrawGrid( &r, &g ); }
This code draws:
The following example uses PgDrawGrid() to generate 20 ticks. Every 5th tick is made larger by calling PgDrawGrid() again with different parameters:
void GridTicks() { PhRect_t r = { 8, 24, 108, 28 }; PhPoint_t g = { 20, 0 }; PgSetStrokeColor( Pg_WHITE ); PgDrawGrid( &r, &g ); r.ul.y-=1; r.lr.y+=1; g.x=4; PgSetStrokeWidth( 3 ); PgSetStrokeCap( Pg_POINT_CAP ); PgDrawGrid( &r, &g ); PgSetStrokeWidth( 0 ); }
This code draws:
Photon
Safety: | |
---|---|
Interrupt handler | No |
Signal handler | No |
Thread | No |
PgSetStrokeCap*(), PgSetStrokeColor*(), PgSetStrokeDash*(), PgSetStrokeDither*(), PgSetStrokeJoin*(), PgSetStrokeTransPat*(), PgSetStrokeWidth*(), PgSetStrokeXORColor*(), PhPoint_t, PhRect_t
“Drawing attributes” and “Lines, pixels, and pixel arrays” in the Raw Drawing and Animation chapter of the Photon Programmer's Guide