2 * Mac OS X / Cocoa front end to puzzles.
6 * - I'd like to be able to call up context help for a specific
9 * Mac interface issues that possibly could be done better:
11 * - is there a better approach to frontend_default_colour?
13 * - do we need any more options in the Window menu?
15 * - can / should we be doing anything with the titles of the
16 * configuration boxes?
18 * - not sure what I should be doing about default window
19 * placement. Centring new windows is a bit feeble, but what's
20 * better? Is there a standard way to tell the OS "here's the
21 * _size_ of window I want, now use your best judgment about the
23 * + there's a standard _policy_ on window placement, given in
24 * the HI guidelines. Have to implement it ourselves though,
27 * - a brief frob of the Mac numeric keypad suggests that it
28 * generates numbers no matter what you do. I wonder if I should
29 * try to figure out a way of detecting keypad codes so I can
30 * implement UP_LEFT and friends. Alternatively, perhaps I
31 * should simply assign the number keys to UP_LEFT et al?
32 * They're not in use for anything else right now.
34 * - see if we can do anything to one-button-ise the multi-button
35 * dependent puzzle UIs:
36 * - Pattern is a _little_ unwieldy but not too bad (since
37 * generally you never need the middle button unless you've
38 * made a mistake, so it's just click versus command-click).
39 * - Net is utterly vile; having normal click be one rotate and
40 * command-click be the other introduces a horrid asymmetry,
41 * and yet requiring a shift key for _each_ click would be
42 * even worse because rotation feels as if it ought to be the
43 * default action. I fear this is why the Flash Net had the
45 * + I've tried out an alternative dragging interface for
46 * Net; it might work nicely for stylus-based platforms
47 * where you have better hand/eye feedback for the thing
48 * you're clicking on, but it's rather unwieldy on the
49 * Mac. I fear even shift-clicking is better than that.
51 * - Should we _return_ to a game configuration sheet once an
52 * error is reported by midend_set_config, to allow the user to
53 * correct the one faulty input and keep the other five OK ones?
54 * The Apple `one sheet at a time' restriction would require me
55 * to do this by closing the config sheet, opening the alert
56 * sheet, and then reopening the config sheet when the alert is
57 * closed; and the human interface types, who presumably
58 * invented the one-sheet-at-a-time rule for good reasons, might
59 * look with disfavour on me trying to get round them to fake a
60 * nested sheet. On the other hand I think there are good
61 * practical reasons for wanting it that way. Uncertain.
63 * - User feedback dislikes nothing happening when you start the
64 * app; they suggest a finder-like window containing an icon for
65 * each puzzle type, enabling you to start one easily. Needs
68 * Grotty implementation details that could probably be improved:
70 * - I am _utterly_ unconvinced that NSImageView was the right way
71 * to go about having a window with a reliable backing store! It
72 * just doesn't feel right; NSImageView is a _control_. Is there
75 * - Resizing is currently very bad; rather than bother to work
76 * out how to resize the NSImageView, I just splatter and
80 #define COMBINED /* we put all the puzzles in one binary in this port */
84 #import <Cocoa/Cocoa.h>
87 /* ----------------------------------------------------------------------
92 * The `Type' menu. We frob this dynamically to allow the user to
93 * choose a preset set of settings from the current game.
100 extern const struct drawing_api osx_drawing;
102 /* ----------------------------------------------------------------------
103 * Miscellaneous support routines that aren't part of any object or
104 * clearly defined subsystem.
107 void fatal(char *fmt, ...)
114 vsnprintf(errorbuf, lenof(errorbuf), fmt, ap);
117 alert = [NSAlert alloc];
119 * We may have come here because we ran out of memory, in which
120 * case it's entirely likely that that alloc will fail, so we
121 * should have a fallback of some sort.
124 fprintf(stderr, "fatal error (and NSAlert failed): %s\n", errorbuf);
126 alert = [[alert init] autorelease];
127 [alert addButtonWithTitle:@"Oh dear"];
128 [alert setInformativeText:[NSString stringWithCString:errorbuf]];
134 void frontend_default_colour(frontend *fe, float *output)
136 /* FIXME: Is there a system default we can tap into for this? */
137 output[0] = output[1] = output[2] = 0.8F;
140 void get_random_seed(void **randseed, int *randseedsize)
142 time_t *tp = snew(time_t);
144 *randseed = (void *)tp;
145 *randseedsize = sizeof(time_t);
148 static void savefile_write(void *wctx, void *buf, int len)
150 FILE *fp = (FILE *)wctx;
151 fwrite(buf, 1, len, fp);
154 static int savefile_read(void *wctx, void *buf, int len)
156 FILE *fp = (FILE *)wctx;
159 ret = fread(buf, 1, len, fp);
164 * Since this front end does not support printing (yet), we need
165 * this stub to satisfy the reference in midend_print_puzzle().
167 void document_add_puzzle(document *doc, const game *game, game_params *par,
168 game_state *st, game_state *st2)
173 * setAppleMenu isn't listed in the NSApplication header, but an
174 * NSApp responds to it, so we're adding it here to silence
175 * warnings. (This was removed from the headers in 10.4, so we
176 * only need to include it for 10.4+.)
178 #if MAC_OS_X_VERSION_MAX_ALLOWED >= 1040
179 @interface NSApplication(NSAppleMenu)
180 - (void)setAppleMenu:(NSMenu *)menu;
184 /* ----------------------------------------------------------------------
185 * Tiny extension to NSMenuItem which carries a payload of a `void
186 * *', allowing several menu items to invoke the same message but
187 * pass different data through it.
189 @interface DataMenuItem : NSMenuItem
193 - (void)setPayload:(void *)d;
194 - (void *)getPayload;
196 @implementation DataMenuItem
197 - (void)setPayload:(void *)d
207 /* ----------------------------------------------------------------------
208 * Utility routines for constructing OS X menus.
211 NSMenu *newmenu(const char *title)
213 return [[[NSMenu allocWithZone:[NSMenu menuZone]]
214 initWithTitle:[NSString stringWithCString:title]]
218 NSMenu *newsubmenu(NSMenu *parent, const char *title)
223 item = [[[NSMenuItem allocWithZone:[NSMenu menuZone]]
224 initWithTitle:[NSString stringWithCString:title]
228 child = newmenu(title);
229 [item setEnabled:YES];
230 [item setSubmenu:child];
231 [parent addItem:item];
235 id initnewitem(NSMenuItem *item, NSMenu *parent, const char *title,
236 const char *key, id target, SEL action)
238 unsigned mask = NSCommandKeyMask;
240 if (key[strcspn(key, "-")]) {
241 while (*key && *key != '-') {
242 int c = tolower((unsigned char)*key);
244 mask |= NSShiftKeyMask;
245 } else if (c == 'o' || c == 'a') {
246 mask |= NSAlternateKeyMask;
254 item = [[item initWithTitle:[NSString stringWithCString:title]
256 keyEquivalent:[NSString stringWithCString:key]]
260 [item setKeyEquivalentModifierMask: mask];
262 [item setEnabled:YES];
263 [item setTarget:target];
264 [item setAction:action];
266 [parent addItem:item];
271 NSMenuItem *newitem(NSMenu *parent, char *title, char *key,
272 id target, SEL action)
274 return initnewitem([NSMenuItem allocWithZone:[NSMenu menuZone]],
275 parent, title, key, target, action);
278 /* ----------------------------------------------------------------------
284 @interface AboutBox : NSWindow
290 @implementation AboutBox
298 NSFont *font1 = [NSFont systemFontOfSize:0];
299 NSFont *font2 = [NSFont boldSystemFontOfSize:[font1 pointSize] * 1.1];
300 const int border = 24;
305 * Construct the controls that go in the About box.
308 iv = [[NSImageView alloc] initWithFrame:NSMakeRect(0,0,64,64)];
309 [iv setImage:[NSImage imageNamed:@"NSApplicationIcon"]];
310 views[nviews++] = iv;
312 tf = [[NSTextField alloc]
313 initWithFrame:NSMakeRect(0,0,400,1)];
315 [tf setSelectable:NO];
317 [tf setDrawsBackground:NO];
319 [tf setStringValue:@"Simon Tatham's Portable Puzzle Collection"];
321 views[nviews++] = tf;
323 tf = [[NSTextField alloc]
324 initWithFrame:NSMakeRect(0,0,400,1)];
326 [tf setSelectable:NO];
328 [tf setDrawsBackground:NO];
330 [tf setStringValue:[NSString stringWithCString:ver]];
332 views[nviews++] = tf;
335 * Lay the controls out.
337 totalrect = NSMakeRect(0,0,0,0);
338 for (i = 0; i < nviews; i++) {
339 NSRect r = [views[i] frame];
340 if (totalrect.size.width < r.size.width)
341 totalrect.size.width = r.size.width;
342 totalrect.size.height += border + r.size.height;
344 totalrect.size.width += 2 * border;
345 totalrect.size.height += border;
346 y = totalrect.size.height;
347 for (i = 0; i < nviews; i++) {
348 NSRect r = [views[i] frame];
349 r.origin.x = (totalrect.size.width - r.size.width) / 2;
350 y -= border + r.size.height;
352 [views[i] setFrame:r];
355 self = [super initWithContentRect:totalrect
356 styleMask:(NSTitledWindowMask | NSMiniaturizableWindowMask |
357 NSClosableWindowMask)
358 backing:NSBackingStoreBuffered
361 for (i = 0; i < nviews; i++)
362 [[self contentView] addSubview:views[i]];
364 [self center]; /* :-) */
370 /* ----------------------------------------------------------------------
371 * The front end presented to midend.c.
373 * This is mostly a subclass of NSWindow. The actual `frontend'
374 * structure passed to the midend contains a variety of pointers,
375 * including that window object but also including the image we
376 * draw on, an ImageView to display it in the window, and so on.
391 @interface MyImageView : NSImageView
395 - (void)setWindow:(GameWindow *)win;
397 - (void)mouseEvent:(NSEvent *)ev button:(int)b;
398 - (void)mouseDown:(NSEvent *)ev;
399 - (void)mouseDragged:(NSEvent *)ev;
400 - (void)mouseUp:(NSEvent *)ev;
401 - (void)rightMouseDown:(NSEvent *)ev;
402 - (void)rightMouseDragged:(NSEvent *)ev;
403 - (void)rightMouseUp:(NSEvent *)ev;
404 - (void)otherMouseDown:(NSEvent *)ev;
405 - (void)otherMouseDragged:(NSEvent *)ev;
406 - (void)otherMouseUp:(NSEvent *)ev;
409 @interface GameWindow : NSWindow
414 struct timeval last_time;
419 NSView **cfg_controls;
423 - (id)initWithGame:(const game *)g;
425 - (void)processButton:(int)b x:(int)x y:(int)y;
426 - (void)keyDown:(NSEvent *)ev;
427 - (void)activateTimer;
428 - (void)deactivateTimer;
429 - (void)setStatusLine:(char *)text;
430 - (void)resizeForNewGameParams;
431 - (void)updateTypeMenuTick;
434 @implementation MyImageView
436 - (void)setWindow:(GameWindow *)win
446 - (void)mouseEvent:(NSEvent *)ev button:(int)b
448 NSPoint point = [self convertPoint:[ev locationInWindow] fromView:nil];
449 [ourwin processButton:b x:point.x y:point.y];
452 - (void)mouseDown:(NSEvent *)ev
454 unsigned mod = [ev modifierFlags];
455 [self mouseEvent:ev button:((mod & NSCommandKeyMask) ? RIGHT_BUTTON :
456 (mod & NSShiftKeyMask) ? MIDDLE_BUTTON :
459 - (void)mouseDragged:(NSEvent *)ev
461 unsigned mod = [ev modifierFlags];
462 [self mouseEvent:ev button:((mod & NSCommandKeyMask) ? RIGHT_DRAG :
463 (mod & NSShiftKeyMask) ? MIDDLE_DRAG :
466 - (void)mouseUp:(NSEvent *)ev
468 unsigned mod = [ev modifierFlags];
469 [self mouseEvent:ev button:((mod & NSCommandKeyMask) ? RIGHT_RELEASE :
470 (mod & NSShiftKeyMask) ? MIDDLE_RELEASE :
473 - (void)rightMouseDown:(NSEvent *)ev
475 unsigned mod = [ev modifierFlags];
476 [self mouseEvent:ev button:((mod & NSShiftKeyMask) ? MIDDLE_BUTTON :
479 - (void)rightMouseDragged:(NSEvent *)ev
481 unsigned mod = [ev modifierFlags];
482 [self mouseEvent:ev button:((mod & NSShiftKeyMask) ? MIDDLE_DRAG :
485 - (void)rightMouseUp:(NSEvent *)ev
487 unsigned mod = [ev modifierFlags];
488 [self mouseEvent:ev button:((mod & NSShiftKeyMask) ? MIDDLE_RELEASE :
491 - (void)otherMouseDown:(NSEvent *)ev
493 [self mouseEvent:ev button:MIDDLE_BUTTON];
495 - (void)otherMouseDragged:(NSEvent *)ev
497 [self mouseEvent:ev button:MIDDLE_DRAG];
499 - (void)otherMouseUp:(NSEvent *)ev
501 [self mouseEvent:ev button:MIDDLE_RELEASE];
505 @implementation GameWindow
506 - (void)setupContentView
512 frame = [status frame];
513 frame.origin.y = frame.size.height;
519 midend_size(me, &w, &h, FALSE);
520 frame.size.width = w;
521 frame.size.height = h;
523 fe.image = [[NSImage alloc] initWithSize:frame.size];
524 [fe.image setFlipped:YES];
525 fe.view = [[MyImageView alloc] initWithFrame:frame];
526 [fe.view setImage:fe.image];
527 [fe.view setWindow:self];
531 [[self contentView] addSubview:fe.view];
533 - (id)initWithGame:(const game *)g
535 NSRect rect = { {0,0}, {0,0} }, rect2;
542 me = midend_new(&fe, ourgame, &osx_drawing, &fe);
544 * If we ever need to open a fresh window using a provided game
545 * ID, I think the right thing is to move most of this method
546 * into a new initWithGame:gameID: method, and have
547 * initWithGame: simply call that one and pass it NULL.
551 midend_size(me, &w, &h, FALSE);
553 rect.size.height = h;
556 * Create the status bar, which will just be an NSTextField.
558 if (midend_wants_statusbar(me)) {
559 status = [[NSTextField alloc] initWithFrame:NSMakeRect(0,0,100,50)];
560 [status setEditable:NO];
561 [status setSelectable:NO];
562 [status setBordered:YES];
563 [status setBezeled:YES];
564 [status setBezelStyle:NSTextFieldSquareBezel];
565 [status setDrawsBackground:YES];
566 [[status cell] setTitle:@""];
568 rect2 = [status frame];
569 rect.size.height += rect2.size.height;
570 rect2.size.width = rect.size.width;
571 rect2.origin.x = rect2.origin.y = 0;
572 [status setFrame:rect2];
576 self = [super initWithContentRect:rect
577 styleMask:(NSTitledWindowMask | NSMiniaturizableWindowMask |
578 NSClosableWindowMask)
579 backing:NSBackingStoreBuffered
581 [self setTitle:[NSString stringWithCString:ourgame->name]];
587 colours = midend_colours(me, &ncolours);
588 fe.ncolours = ncolours;
589 fe.colours = snewn(ncolours, NSColor *);
591 for (i = 0; i < ncolours; i++) {
592 fe.colours[i] = [[NSColor colorWithDeviceRed:colours[i*3]
593 green:colours[i*3+1] blue:colours[i*3+2]
598 [self setupContentView];
600 [[self contentView] addSubview:status];
601 [self setIgnoresMouseEvents:NO];
603 [self center]; /* :-) */
611 for (i = 0; i < fe.ncolours; i++) {
612 [fe.colours[i] release];
619 - (void)processButton:(int)b x:(int)x y:(int)y
621 if (!midend_process_key(me, x, y, b))
625 - (void)keyDown:(NSEvent *)ev
627 NSString *s = [ev characters];
628 int i, n = [s length];
630 for (i = 0; i < n; i++) {
631 int c = [s characterAtIndex:i];
634 * ASCII gets passed straight to midend_process_key.
635 * Anything above that has to be translated to our own
636 * function key codes.
641 case NSUpArrowFunctionKey:
645 case NSDownArrowFunctionKey:
649 case NSLeftArrowFunctionKey:
653 case NSRightArrowFunctionKey:
662 if ([ev modifierFlags] & NSShiftKeyMask)
664 if ([ev modifierFlags] & NSControlKeyMask)
669 if (c >= '0' && c <= '9' && ([ev modifierFlags] & NSNumericPadKeyMask))
672 [self processButton:c x:-1 y:-1];
676 - (void)activateTimer
681 timer = [NSTimer scheduledTimerWithTimeInterval:0.02
682 target:self selector:@selector(timerTick:)
683 userInfo:nil repeats:YES];
684 gettimeofday(&last_time, NULL);
687 - (void)deactivateTimer
696 - (void)timerTick:(id)sender
700 gettimeofday(&now, NULL);
701 elapsed = ((now.tv_usec - last_time.tv_usec) * 0.000001F +
702 (now.tv_sec - last_time.tv_sec));
703 midend_timer(me, elapsed);
707 - (void)showError:(char *)message
711 alert = [[[NSAlert alloc] init] autorelease];
712 [alert addButtonWithTitle:@"Bah"];
713 [alert setInformativeText:[NSString stringWithCString:message]];
714 [alert beginSheetModalForWindow:self modalDelegate:nil
715 didEndSelector:nil contextInfo:nil];
718 - (void)newGame:(id)sender
720 [self processButton:'n' x:-1 y:-1];
722 - (void)restartGame:(id)sender
724 midend_restart_game(me);
726 - (void)saveGame:(id)sender
728 NSSavePanel *sp = [NSSavePanel savePanel];
730 if ([sp runModal] == NSFileHandlingPanelOKButton) {
731 const char *name = [[sp filename] UTF8String];
733 FILE *fp = fopen(name, "w");
736 [self showError:"Unable to open save file"];
740 midend_serialise(me, savefile_write, fp);
745 - (void)loadSavedGame:(id)sender
747 NSOpenPanel *op = [NSOpenPanel openPanel];
749 [op setAllowsMultipleSelection:NO];
751 if ([op runModalForTypes:nil] == NSOKButton) {
752 const char *name = [[[op filenames] objectAtIndex:0] cString];
755 FILE *fp = fopen(name, "r");
758 [self showError:"Unable to open saved game file"];
762 err = midend_deserialise(me, savefile_read, fp);
767 [self showError:err];
771 [self resizeForNewGameParams];
772 [self updateTypeMenuTick];
775 - (void)undoMove:(id)sender
777 [self processButton:'u' x:-1 y:-1];
779 - (void)redoMove:(id)sender
781 [self processButton:'r'&0x1F x:-1 y:-1];
784 - (void)copy:(id)sender
788 if ((text = midend_text_format(me)) != NULL) {
789 NSPasteboard *pb = [NSPasteboard generalPasteboard];
790 NSArray *a = [NSArray arrayWithObject:NSStringPboardType];
791 [pb declareTypes:a owner:nil];
792 [pb setString:[NSString stringWithCString:text]
793 forType:NSStringPboardType];
798 - (void)solveGame:(id)sender
802 msg = midend_solve(me);
805 [self showError:msg];
808 - (BOOL)validateMenuItem:(NSMenuItem *)item
810 if ([item action] == @selector(copy:))
811 return (ourgame->can_format_as_text_ever &&
812 midend_can_format_as_text_now(me) ? YES : NO);
813 else if ([item action] == @selector(solveGame:))
814 return (ourgame->can_solve ? YES : NO);
816 return [super validateMenuItem:item];
819 - (void)clearTypeMenu
821 while ([typemenu numberOfItems] > 1)
822 [typemenu removeItemAtIndex:0];
823 [[typemenu itemAtIndex:0] setState:NSOffState];
826 - (void)updateTypeMenuTick
830 total = [typemenu numberOfItems];
831 n = midend_which_preset(me);
833 n = total - 1; /* that's always where "Custom" lives */
834 for (i = 0; i < total; i++)
835 [[typemenu itemAtIndex:i] setState:(i == n ? NSOnState : NSOffState)];
838 - (void)becomeKeyWindow
842 [self clearTypeMenu];
844 [super becomeKeyWindow];
846 n = midend_num_presets(me);
849 [typemenu insertItem:[NSMenuItem separatorItem] atIndex:0];
855 midend_fetch_preset(me, n, &name, ¶ms);
857 item = [[[DataMenuItem alloc]
858 initWithTitle:[NSString stringWithCString:name]
859 action:NULL keyEquivalent:@""]
862 [item setEnabled:YES];
863 [item setTarget:self];
864 [item setAction:@selector(presetGame:)];
865 [item setPayload:params];
867 [typemenu insertItem:item atIndex:0];
871 [self updateTypeMenuTick];
874 - (void)resignKeyWindow
876 [self clearTypeMenu];
877 [super resignKeyWindow];
882 [self clearTypeMenu];
886 - (void)resizeForNewGameParams
892 midend_size(me, &w, &h, FALSE);
897 NSRect frame = [status frame];
898 size.height += frame.size.height;
899 frame.size.width = size.width;
900 [status setFrame:frame];
903 NSDisableScreenUpdates();
904 [self setContentSize:size];
905 [self setupContentView];
906 NSEnableScreenUpdates();
909 - (void)presetGame:(id)sender
911 game_params *params = [sender getPayload];
913 midend_set_params(me, params);
916 [self resizeForNewGameParams];
917 [self updateTypeMenuTick];
920 - (void)startConfigureSheet:(int)which
922 NSButton *ok, *cancel;
923 int actw, acth, leftw, rightw, totalw, h, thish, y;
925 NSRect rect, tmprect;
926 const int SPACING = 16;
934 assert(sheet == NULL);
937 * Every control we create here is going to have this size
938 * until we tell it to calculate a better one.
940 tmprect = NSMakeRect(0, 0, 100, 50);
943 * Set up OK and Cancel buttons. (Actually, MacOS doesn't seem
944 * to be fond of generic OK and Cancel wording, so I'm going to
945 * rename them to something nicer.)
949 cancel = [[NSButton alloc] initWithFrame:tmprect];
950 [cancel setBezelStyle:NSRoundedBezelStyle];
951 [cancel setTitle:@"Abandon"];
952 [cancel setTarget:self];
953 [cancel setKeyEquivalent:@"\033"];
954 [cancel setAction:@selector(sheetCancelButton:)];
956 rect = [cancel frame];
957 if (actw < rect.size.width) actw = rect.size.width;
958 if (acth < rect.size.height) acth = rect.size.height;
960 ok = [[NSButton alloc] initWithFrame:tmprect];
961 [ok setBezelStyle:NSRoundedBezelStyle];
962 [ok setTitle:@"Accept"];
964 [ok setKeyEquivalent:@"\r"];
965 [ok setAction:@selector(sheetOKButton:)];
968 if (actw < rect.size.width) actw = rect.size.width;
969 if (acth < rect.size.height) acth = rect.size.height;
971 totalw = SPACING + 2 * actw;
972 h = 2 * SPACING + acth;
975 * Now fetch the midend config data and go through it creating
978 cfg = midend_get_config(me, which, &title);
979 sfree(title); /* FIXME: should we use this somehow? */
982 cfg_ncontrols = cfg_controlsize = 0;
985 for (i = cfg; i->type != C_END; i++) {
986 if (cfg_controlsize < cfg_ncontrols + 5) {
987 cfg_controlsize = cfg_ncontrols + 32;
988 cfg_controls = sresize(cfg_controls, cfg_controlsize, NSView *);
996 * Two NSTextFields, one being a label and the other
1000 tf = [[NSTextField alloc] initWithFrame:tmprect];
1001 [tf setEditable:NO];
1002 [tf setSelectable:NO];
1003 [tf setBordered:NO];
1004 [tf setDrawsBackground:NO];
1005 [[tf cell] setTitle:[NSString stringWithCString:i->name]];
1008 if (thish < rect.size.height + 1) thish = rect.size.height + 1;
1009 if (leftw < rect.size.width + 1) leftw = rect.size.width + 1;
1010 cfg_controls[cfg_ncontrols++] = tf;
1012 tf = [[NSTextField alloc] initWithFrame:tmprect];
1013 [tf setEditable:YES];
1014 [tf setSelectable:YES];
1015 [tf setBordered:YES];
1016 [[tf cell] setTitle:[NSString stringWithCString:i->sval]];
1020 * We impose a minimum and maximum width on editable
1021 * NSTextFields. If we allow them to size themselves to
1022 * the contents of the text within them, then they will
1023 * look very silly if that text is only one or two
1024 * characters, and equally silly if it's an absolutely
1025 * enormous Rectangles or Pattern game ID!
1027 if (rect.size.width < 75) rect.size.width = 75;
1028 if (rect.size.width > 400) rect.size.width = 400;
1030 if (thish < rect.size.height + 1) thish = rect.size.height + 1;
1031 if (rightw < rect.size.width + 1) rightw = rect.size.width + 1;
1032 cfg_controls[cfg_ncontrols++] = tf;
1037 * A checkbox is an NSButton with a type of
1040 b = [[NSButton alloc] initWithFrame:tmprect];
1041 [b setBezelStyle:NSRoundedBezelStyle];
1042 [b setButtonType:NSSwitchButton];
1043 [b setTitle:[NSString stringWithCString:i->name]];
1045 [b setState:(i->ival ? NSOnState : NSOffState)];
1047 if (totalw < rect.size.width + 1) totalw = rect.size.width + 1;
1048 if (thish < rect.size.height + 1) thish = rect.size.height + 1;
1049 cfg_controls[cfg_ncontrols++] = b;
1054 * A pop-up menu control is an NSPopUpButton, which
1055 * takes an embedded NSMenu. We also need an
1056 * NSTextField to act as a label.
1059 tf = [[NSTextField alloc] initWithFrame:tmprect];
1060 [tf setEditable:NO];
1061 [tf setSelectable:NO];
1062 [tf setBordered:NO];
1063 [tf setDrawsBackground:NO];
1064 [[tf cell] setTitle:[NSString stringWithCString:i->name]];
1067 if (thish < rect.size.height + 1) thish = rect.size.height + 1;
1068 if (leftw < rect.size.width + 1) leftw = rect.size.width + 1;
1069 cfg_controls[cfg_ncontrols++] = tf;
1071 pb = [[NSPopUpButton alloc] initWithFrame:tmprect pullsDown:NO];
1072 [pb setBezelStyle:NSRoundedBezelStyle];
1082 while (*p && *p != c) p++;
1084 [pb addItemWithTitle:[NSString stringWithCString:q
1090 [pb selectItemAtIndex:i->ival];
1094 if (rightw < rect.size.width + 1) rightw = rect.size.width + 1;
1095 if (thish < rect.size.height + 1) thish = rect.size.height + 1;
1096 cfg_controls[cfg_ncontrols++] = pb;
1100 h += SPACING + thish;
1103 if (totalw < leftw + SPACING + rightw)
1104 totalw = leftw + SPACING + rightw;
1105 if (totalw > leftw + SPACING + rightw) {
1106 int excess = totalw - (leftw + SPACING + rightw);
1107 int leftexcess = leftw * excess / (leftw + rightw);
1108 int rightexcess = excess - leftexcess;
1109 leftw += leftexcess;
1110 rightw += rightexcess;
1114 * Now go through the list again, setting the final position
1119 for (i = cfg; i->type != C_END; i++) {
1126 * These two are treated identically, since both expect
1127 * a control on the left and another on the right.
1129 rect = [cfg_controls[k] frame];
1130 if (thish < rect.size.height + 1)
1131 thish = rect.size.height + 1;
1132 rect = [cfg_controls[k+1] frame];
1133 if (thish < rect.size.height + 1)
1134 thish = rect.size.height + 1;
1135 rect = [cfg_controls[k] frame];
1136 rect.origin.y = y - thish/2 - rect.size.height/2;
1137 rect.origin.x = SPACING;
1138 rect.size.width = leftw;
1139 [cfg_controls[k] setFrame:rect];
1140 rect = [cfg_controls[k+1] frame];
1141 rect.origin.y = y - thish/2 - rect.size.height/2;
1142 rect.origin.x = 2 * SPACING + leftw;
1143 rect.size.width = rightw;
1144 [cfg_controls[k+1] setFrame:rect];
1149 rect = [cfg_controls[k] frame];
1150 if (thish < rect.size.height + 1)
1151 thish = rect.size.height + 1;
1152 rect.origin.y = y - thish/2 - rect.size.height/2;
1153 rect.origin.x = SPACING;
1154 rect.size.width = totalw;
1155 [cfg_controls[k] setFrame:rect];
1162 assert(k == cfg_ncontrols);
1164 [cancel setFrame:NSMakeRect(SPACING+totalw/4-actw/2, SPACING, actw, acth)];
1165 [ok setFrame:NSMakeRect(SPACING+3*totalw/4-actw/2, SPACING, actw, acth)];
1167 sheet = [[NSWindow alloc]
1168 initWithContentRect:NSMakeRect(0,0,totalw + 2*SPACING,h)
1169 styleMask:NSTitledWindowMask | NSClosableWindowMask
1170 backing:NSBackingStoreBuffered
1173 [[sheet contentView] addSubview:cancel];
1174 [[sheet contentView] addSubview:ok];
1176 for (k = 0; k < cfg_ncontrols; k++)
1177 [[sheet contentView] addSubview:cfg_controls[k]];
1179 [NSApp beginSheet:sheet modalForWindow:self
1180 modalDelegate:nil didEndSelector:nil contextInfo:nil];
1183 - (void)specificGame:(id)sender
1185 [self startConfigureSheet:CFG_DESC];
1188 - (void)specificRandomGame:(id)sender
1190 [self startConfigureSheet:CFG_SEED];
1193 - (void)customGameType:(id)sender
1195 [self startConfigureSheet:CFG_SETTINGS];
1198 - (void)sheetEndWithStatus:(BOOL)update
1200 assert(sheet != NULL);
1201 [NSApp endSheet:sheet];
1202 [sheet orderOut:self];
1210 for (i = cfg; i->type != C_END; i++) {
1214 i->sval = dupstr([[[(id)cfg_controls[k+1] cell]
1215 title] UTF8String]);
1219 i->ival = [(id)cfg_controls[k] state] == NSOnState;
1223 i->ival = [(id)cfg_controls[k+1] indexOfSelectedItem];
1229 error = midend_set_config(me, cfg_which, cfg);
1231 NSAlert *alert = [[[NSAlert alloc] init] autorelease];
1232 [alert addButtonWithTitle:@"Bah"];
1233 [alert setInformativeText:[NSString stringWithCString:error]];
1234 [alert beginSheetModalForWindow:self modalDelegate:nil
1235 didEndSelector:nil contextInfo:nil];
1237 midend_new_game(me);
1238 [self resizeForNewGameParams];
1239 [self updateTypeMenuTick];
1242 sfree(cfg_controls);
1243 cfg_controls = NULL;
1245 - (void)sheetOKButton:(id)sender
1247 [self sheetEndWithStatus:YES];
1249 - (void)sheetCancelButton:(id)sender
1251 [self sheetEndWithStatus:NO];
1254 - (void)setStatusLine:(char *)text
1256 [[status cell] setTitle:[NSString stringWithCString:text]];
1262 * Drawing routines called by the midend.
1264 static void osx_draw_polygon(void *handle, int *coords, int npoints,
1265 int fillcolour, int outlinecolour)
1267 frontend *fe = (frontend *)handle;
1268 NSBezierPath *path = [NSBezierPath bezierPath];
1271 [[NSGraphicsContext currentContext] setShouldAntialias:YES];
1273 for (i = 0; i < npoints; i++) {
1274 NSPoint p = { coords[i*2] + 0.5, coords[i*2+1] + 0.5 };
1276 [path moveToPoint:p];
1278 [path lineToPoint:p];
1283 if (fillcolour >= 0) {
1284 assert(fillcolour >= 0 && fillcolour < fe->ncolours);
1285 [fe->colours[fillcolour] set];
1289 assert(outlinecolour >= 0 && outlinecolour < fe->ncolours);
1290 [fe->colours[outlinecolour] set];
1293 static void osx_draw_circle(void *handle, int cx, int cy, int radius,
1294 int fillcolour, int outlinecolour)
1296 frontend *fe = (frontend *)handle;
1297 NSBezierPath *path = [NSBezierPath bezierPath];
1299 [[NSGraphicsContext currentContext] setShouldAntialias:YES];
1301 [path appendBezierPathWithArcWithCenter:NSMakePoint(cx + 0.5, cy + 0.5)
1302 radius:radius startAngle:0.0 endAngle:360.0];
1306 if (fillcolour >= 0) {
1307 assert(fillcolour >= 0 && fillcolour < fe->ncolours);
1308 [fe->colours[fillcolour] set];
1312 assert(outlinecolour >= 0 && outlinecolour < fe->ncolours);
1313 [fe->colours[outlinecolour] set];
1316 static void osx_draw_line(void *handle, int x1, int y1, int x2, int y2, int colour)
1318 frontend *fe = (frontend *)handle;
1319 NSBezierPath *path = [NSBezierPath bezierPath];
1320 NSPoint p1 = { x1 + 0.5, y1 + 0.5 }, p2 = { x2 + 0.5, y2 + 0.5 };
1322 [[NSGraphicsContext currentContext] setShouldAntialias:NO];
1324 assert(colour >= 0 && colour < fe->ncolours);
1325 [fe->colours[colour] set];
1327 [path moveToPoint:p1];
1328 [path lineToPoint:p2];
1331 static void osx_draw_rect(void *handle, int x, int y, int w, int h, int colour)
1333 frontend *fe = (frontend *)handle;
1334 NSRect r = { {x,y}, {w,h} };
1336 [[NSGraphicsContext currentContext] setShouldAntialias:NO];
1338 assert(colour >= 0 && colour < fe->ncolours);
1339 [fe->colours[colour] set];
1343 static void osx_draw_text(void *handle, int x, int y, int fonttype,
1344 int fontsize, int align, int colour, char *text)
1346 frontend *fe = (frontend *)handle;
1347 NSString *string = [NSString stringWithCString:text
1348 encoding:NSUTF8StringEncoding];
1354 [[NSGraphicsContext currentContext] setShouldAntialias:YES];
1356 assert(colour >= 0 && colour < fe->ncolours);
1358 if (fonttype == FONT_FIXED)
1359 font = [NSFont userFixedPitchFontOfSize:fontsize];
1361 font = [NSFont userFontOfSize:fontsize];
1363 attr = [NSDictionary dictionaryWithObjectsAndKeys:
1364 fe->colours[colour], NSForegroundColorAttributeName,
1365 font, NSFontAttributeName, nil];
1370 size = [string sizeWithAttributes:attr];
1371 if (align & ALIGN_HRIGHT)
1372 point.x -= size.width;
1373 else if (align & ALIGN_HCENTRE)
1374 point.x -= size.width / 2;
1375 if (align & ALIGN_VCENTRE)
1376 point.y -= size.height / 2;
1378 point.y -= size.height;
1380 [string drawAtPoint:point withAttributes:attr];
1382 static char *osx_text_fallback(void *handle, const char *const *strings,
1386 * We assume OS X can cope with any UTF-8 likely to be emitted
1389 return dupstr(strings[0]);
1396 static blitter *osx_blitter_new(void *handle, int w, int h)
1398 blitter *bl = snew(blitter);
1402 bl->img = [[NSImage alloc] initWithSize:NSMakeSize(w, h)];
1403 [bl->img setFlipped:YES];
1406 static void osx_blitter_free(void *handle, blitter *bl)
1411 static void osx_blitter_save(void *handle, blitter *bl, int x, int y)
1413 frontend *fe = (frontend *)handle;
1414 [fe->image unlockFocus];
1415 [bl->img lockFocus];
1416 [fe->image drawInRect:NSMakeRect(0, 0, bl->w, bl->h)
1417 fromRect:NSMakeRect(x, y, bl->w, bl->h)
1418 operation:NSCompositeCopy fraction:1.0];
1419 [bl->img unlockFocus];
1420 [fe->image lockFocus];
1424 static void osx_blitter_load(void *handle, blitter *bl, int x, int y)
1426 /* frontend *fe = (frontend *)handle; */
1427 if (x == BLITTER_FROMSAVED && y == BLITTER_FROMSAVED) {
1431 [bl->img drawInRect:NSMakeRect(x, y, bl->w, bl->h)
1432 fromRect:NSMakeRect(0, 0, bl->w, bl->h)
1433 operation:NSCompositeCopy fraction:1.0];
1435 static void osx_draw_update(void *handle, int x, int y, int w, int h)
1437 frontend *fe = (frontend *)handle;
1438 [fe->view setNeedsDisplayInRect:NSMakeRect(x,y,w,h)];
1440 static void osx_clip(void *handle, int x, int y, int w, int h)
1442 frontend *fe = (frontend *)handle;
1443 NSRect r = { {x,y}, {w,h} };
1446 [[NSGraphicsContext currentContext] saveGraphicsState];
1447 [NSBezierPath clipRect:r];
1450 static void osx_unclip(void *handle)
1452 frontend *fe = (frontend *)handle;
1454 [[NSGraphicsContext currentContext] restoreGraphicsState];
1455 fe->clipped = FALSE;
1457 static void osx_start_draw(void *handle)
1459 frontend *fe = (frontend *)handle;
1460 [fe->image lockFocus];
1461 fe->clipped = FALSE;
1463 static void osx_end_draw(void *handle)
1465 frontend *fe = (frontend *)handle;
1466 [fe->image unlockFocus];
1468 static void osx_status_bar(void *handle, char *text)
1470 frontend *fe = (frontend *)handle;
1471 [fe->window setStatusLine:text];
1474 const struct drawing_api osx_drawing = {
1490 NULL, NULL, NULL, NULL, NULL, NULL, /* {begin,end}_{doc,page,puzzle} */
1491 NULL, NULL, /* line_width, line_dotted */
1495 void deactivate_timer(frontend *fe)
1497 [fe->window deactivateTimer];
1499 void activate_timer(frontend *fe)
1501 [fe->window activateTimer];
1504 /* ----------------------------------------------------------------------
1505 * AppController: the object which receives the messages from all
1506 * menu selections that aren't standard OS X functions.
1508 @interface AppController : NSObject
1511 - (void)newGameWindow:(id)sender;
1512 - (void)about:(id)sender;
1515 @implementation AppController
1517 - (void)newGameWindow:(id)sender
1519 const game *g = [sender getPayload];
1522 win = [[GameWindow alloc] initWithGame:g];
1523 [win makeKeyAndOrderFront:self];
1526 - (void)about:(id)sender
1530 win = [[AboutBox alloc] init];
1531 [win makeKeyAndOrderFront:self];
1534 - (NSMenu *)applicationDockMenu:(NSApplication *)sender
1536 NSMenu *menu = newmenu("Dock Menu");
1540 for (i = 0; i < gamecount; i++) {
1542 initnewitem([DataMenuItem allocWithZone:[NSMenu menuZone]],
1543 menu, gamelist[i]->name, "", self,
1544 @selector(newGameWindow:));
1545 [item setPayload:(void *)gamelist[i]];
1553 /* ----------------------------------------------------------------------
1554 * Main program. Constructs the menus and runs the application.
1556 int main(int argc, char **argv)
1558 NSAutoreleasePool *pool;
1561 AppController *controller;
1564 pool = [[NSAutoreleasePool alloc] init];
1566 icon = [NSImage imageNamed:@"NSApplicationIcon"];
1567 [NSApplication sharedApplication];
1568 [NSApp setApplicationIconImage:icon];
1570 controller = [[[AppController alloc] init] autorelease];
1571 [NSApp setDelegate:controller];
1573 [NSApp setMainMenu: newmenu("Main Menu")];
1575 menu = newsubmenu([NSApp mainMenu], "Apple Menu");
1576 item = newitem(menu, "About Puzzles", "", NULL, @selector(about:));
1577 [menu addItem:[NSMenuItem separatorItem]];
1578 [NSApp setServicesMenu:newsubmenu(menu, "Services")];
1579 [menu addItem:[NSMenuItem separatorItem]];
1580 item = newitem(menu, "Hide Puzzles", "h", NSApp, @selector(hide:));
1581 item = newitem(menu, "Hide Others", "o-h", NSApp, @selector(hideOtherApplications:));
1582 item = newitem(menu, "Show All", "", NSApp, @selector(unhideAllApplications:));
1583 [menu addItem:[NSMenuItem separatorItem]];
1584 item = newitem(menu, "Quit", "q", NSApp, @selector(terminate:));
1585 [NSApp setAppleMenu: menu];
1587 menu = newsubmenu([NSApp mainMenu], "File");
1588 item = newitem(menu, "Open", "o", NULL, @selector(loadSavedGame:));
1589 item = newitem(menu, "Save As", "s", NULL, @selector(saveGame:));
1590 item = newitem(menu, "New Game", "n", NULL, @selector(newGame:));
1591 item = newitem(menu, "Restart Game", "r", NULL, @selector(restartGame:));
1592 item = newitem(menu, "Specific Game", "", NULL, @selector(specificGame:));
1593 item = newitem(menu, "Specific Random Seed", "", NULL,
1594 @selector(specificRandomGame:));
1595 [menu addItem:[NSMenuItem separatorItem]];
1597 NSMenu *submenu = newsubmenu(menu, "New Window");
1600 for (i = 0; i < gamecount; i++) {
1602 initnewitem([DataMenuItem allocWithZone:[NSMenu menuZone]],
1603 submenu, gamelist[i]->name, "", controller,
1604 @selector(newGameWindow:));
1605 [item setPayload:(void *)gamelist[i]];
1608 [menu addItem:[NSMenuItem separatorItem]];
1609 item = newitem(menu, "Close", "w", NULL, @selector(performClose:));
1611 menu = newsubmenu([NSApp mainMenu], "Edit");
1612 item = newitem(menu, "Undo", "z", NULL, @selector(undoMove:));
1613 item = newitem(menu, "Redo", "S-z", NULL, @selector(redoMove:));
1614 [menu addItem:[NSMenuItem separatorItem]];
1615 item = newitem(menu, "Cut", "x", NULL, @selector(cut:));
1616 item = newitem(menu, "Copy", "c", NULL, @selector(copy:));
1617 item = newitem(menu, "Paste", "v", NULL, @selector(paste:));
1618 [menu addItem:[NSMenuItem separatorItem]];
1619 item = newitem(menu, "Solve", "S-s", NULL, @selector(solveGame:));
1621 menu = newsubmenu([NSApp mainMenu], "Type");
1623 item = newitem(menu, "Custom", "", NULL, @selector(customGameType:));
1625 menu = newsubmenu([NSApp mainMenu], "Window");
1626 [NSApp setWindowsMenu: menu];
1627 item = newitem(menu, "Minimise Window", "m", NULL, @selector(performMiniaturize:));
1629 menu = newsubmenu([NSApp mainMenu], "Help");
1630 item = newitem(menu, "Puzzles Help", "?", NSApp, @selector(showHelp:));