On this page:
<drawing>
<drawing-tests>
<constants>
<constants>2
<render-world>
<chop-whiskers-tests>
<chop-whiskers>
<render-board>
<render-cell>
<world-width>
<world-height>
<cell-center-x-tests>
<cell-center-x-tests>2
<cell-center-x>
<cell-center-y-tests>
<cell-center-y>
1.18.7 Drawing the World

There are a number of constants that are given names to make the code more readable.

These first two constants give the radius of the circles that are drawn on the board, plus the radius of an invisible circle that, if they were drawn on top of the circles, would touch each other. Accordingly, circle-spacing is used when computing the positions of the circles, but the circles are drawn using circle-radius.

(define circle-radius 20)
(define circle-spacing 22)

The other four constants specify the colors of the circles.

(define normal-color 'lightskyblue)
(define on-shortest-path-color 'white)
(define blocked-color 'black)
(define under-mouse-color 'black)

The main function for drawing a world is render-world. It is a fairly straightforward composition of helper functions. First, it builds the image of a board, and then puts the cat on it. Lastly, since the whiskers of the cat might now hang off of the edge of the board (if the cat is on a leftmost or rightmost cell), it trims them. This ensures that the image is always the same size and that the pinhole is always in the upper-left corner of the window.

(define/contract (render-world w)
  (-> world? image?)
  (chop-whiskers
   (overlay/xy (render-board (world-board w)
                             (world-size w)
                             (on-cats-path? w)
                             (world-mouse-posn w))
               (cell-center-x (world-cat w))
               (cell-center-y (world-cat w))
               (cond
                 [(equal? (world-state w) 'cat-won) happy-cat]
                 [(equal? (world-state w) 'cat-lost) mad-cat]
                 [else thinking-cat]))))

Trimming the cat’s whiskers amounts to removing any extra space in the image that appears to the left or above the pinhole. For example, the rectangle function returns an image with a pinhole in the middle. So trimming 5x5 rectangle results in a 3x3 rectangle with the pinhole at (0,0).

(test (chop-whiskers (rectangle 5 5 'solid 'black))
      (put-pinhole (rectangle 3 3 'solid 'black) 0 0))

The function uses shrink to remove all of the material above and to the left of the pinhole.

(define/contract (chop-whiskers img)
  (-> image? image?)
  (shrink img
          0
          0
          (- (image-width img) (pinhole-x img) 1)
          (- (image-height img) (pinhole-y img) 1)))

The render-board function uses for/fold to iterate over all of the cells in cs. It starts with an empty rectangle and, one by one, puts the cells on image.

(define/contract (render-board cs world-size on-cat-path? mouse)
  (-> (listof cell?)
      natural-number/c
      (-> posn? boolean?)
      (or/c #f posn?)
      image?)
  (for/fold ([image (nw:rectangle (world-width world-size)
                                  (world-height world-size)
                                  'solid
                                  'white)])
            ([c cs])
    (overlay image
             (render-cell c
                          (on-cat-path? (cell-p c))
                          (and (posn? mouse)
                               (equal? mouse (cell-p c)))))))

The render-cell function accepts a cell, a boolean indicating if the cell is on the shortest path between the cat and the boundary, and a second boolean indicating if the cell is underneath the mouse. It returns an image of the cell, with the pinhole placed in such a way that overlaying the image on an empty image with pinhole in the upper-left corner results in the cell being placed in the right place.

(define/contract (render-cell c on-short-path? under-mouse?)
  (-> cell? boolean? boolean? image?)
  (let ([x (cell-center-x (cell-p c))]
        [y (cell-center-y (cell-p c))]
        [main-circle
         (cond
           [(cell-blocked? c)
            (circle circle-radius 'solid blocked-color)]
           [else
            (circle circle-radius 'solid normal-color)])])
    (move-pinhole
     (cond
       [under-mouse?
        (overlay main-circle
                 (circle (quotient circle-radius 2) 'solid under-mouse-color))]
       [on-short-path?
        (overlay main-circle
                 (circle (quotient circle-radius 2) 'solid
                         on-shortest-path-color))]
       [else
        main-circle])
     (- x)
     (- y))))

The world-width function computes the width of the rendered world, given the world’s size by finding the center of the rightmost posn, and then adding an additional radius.

(define/contract (world-width board-size)
  (-> natural-number/c number?)
  (let ([rightmost-posn
         (make-posn (- board-size 1) (- board-size 2))])
    (+ (cell-center-x rightmost-posn) circle-radius)))

Similarly, the world-height function computest the height of the rendered world, given the world’s size.

(define/contract (world-height board-size)
  (-> natural-number/c number?)
  (let ([bottommost-posn
         (make-posn (- board-size 1) (- board-size 1))])
    (ceiling (+ (cell-center-y bottommost-posn)
                circle-radius))))

The cell-center-x function returns the x coordinate of the center of the cell specified by p.

For example, the first cell in the third row (counting from 0) is flush with the edge of the screen, so its center is just the radius of the circle that is drawn.

(test (cell-center-x (make-posn 0 2))
      circle-radius)

The first cell in the second row, in contrast is offset from the third row by circle-spacing.

(test (cell-center-x (make-posn 0 1))
      (+ circle-spacing circle-radius))

The definition of cell-center-x multiplies the x coordinate of p by twice circle-spacing and then adds circle-radius to move over for the first circle. In addition if the y coordinate is odd, then it adds circle-spacing, shifting the entire line over.

(define/contract (cell-center-x p)
  (-> posn? number?)
  (let ([x (posn-x p)]
        [y (posn-y p)])
    (+ circle-radius
       (* x circle-spacing 2)
       (if (odd? y)
           circle-spacing
           0))))

The cell-center-y function computes the y coordinate of a cell’s location on the screen. For example, the y coordinate of the first row is the radius of a circle, ensuring that the first row is flush against the top of the screen.

(test (cell-center-y (make-posn 1 0))
      circle-radius)

Because the grid is hexagonal, the y coordinates of the rows do not have the same spacing as the x coordinates. In particular, they are off by sin(pi/3). We approximate that by 433/500 in order to keep the computations and test cases simple and using exact numbers. A more precise approximation would be 0.8660254037844386, but it is not necessary at the screen resolution.

(define/contract (cell-center-y p)
  (-> posn? number?)
  (+ circle-radius
     (* (posn-y p)
        circle-spacing 2
        433/500)))