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 */
85 #import <Cocoa/Cocoa.h>
88 /* ----------------------------------------------------------------------
93 * The `Type' menu. We frob this dynamically to allow the user to
94 * choose a preset set of settings from the current game.
101 extern const struct drawing_api osx_drawing;
104 * The NSApplication shared instance, which I'll want to refer to from
105 * a few places here and there.
109 /* ----------------------------------------------------------------------
110 * Miscellaneous support routines that aren't part of any object or
111 * clearly defined subsystem.
114 void fatal(char *fmt, ...)
121 vsnprintf(errorbuf, lenof(errorbuf), fmt, ap);
124 alert = [NSAlert alloc];
126 * We may have come here because we ran out of memory, in which
127 * case it's entirely likely that that alloc will fail, so we
128 * should have a fallback of some sort.
131 fprintf(stderr, "fatal error (and NSAlert failed): %s\n", errorbuf);
133 alert = [[alert init] autorelease];
134 [alert addButtonWithTitle:@"Oh dear"];
135 [alert setInformativeText:[NSString stringWithUTF8String:errorbuf]];
141 void frontend_default_colour(frontend *fe, float *output)
143 /* FIXME: Is there a system default we can tap into for this? */
144 output[0] = output[1] = output[2] = 0.8F;
147 void get_random_seed(void **randseed, int *randseedsize)
149 time_t *tp = snew(time_t);
151 *randseed = (void *)tp;
152 *randseedsize = sizeof(time_t);
155 static void savefile_write(void *wctx, void *buf, int len)
157 FILE *fp = (FILE *)wctx;
158 fwrite(buf, 1, len, fp);
161 static int savefile_read(void *wctx, void *buf, int len)
163 FILE *fp = (FILE *)wctx;
166 ret = fread(buf, 1, len, fp);
171 * Since this front end does not support printing (yet), we need
172 * this stub to satisfy the reference in midend_print_puzzle().
174 void document_add_puzzle(document *doc, const game *game, game_params *par,
175 game_state *st, game_state *st2)
180 * setAppleMenu isn't listed in the NSApplication header, but an
181 * NSApp responds to it, so we're adding it here to silence
182 * warnings. (This was removed from the headers in 10.4, so we
183 * only need to include it for 10.4+.)
185 #if MAC_OS_X_VERSION_MAX_ALLOWED >= 1040
186 @interface NSApplication(NSAppleMenu)
187 - (void)setAppleMenu:(NSMenu *)menu;
191 /* ----------------------------------------------------------------------
192 * Tiny extension to NSMenuItem which carries a payload of a `void
193 * *', allowing several menu items to invoke the same message but
194 * pass different data through it.
196 @interface DataMenuItem : NSMenuItem
200 - (void)setPayload:(void *)d;
201 - (void *)getPayload;
203 @implementation DataMenuItem
204 - (void)setPayload:(void *)d
214 /* ----------------------------------------------------------------------
215 * Utility routines for constructing OS X menus.
218 NSMenu *newmenu(const char *title)
220 return [[[NSMenu allocWithZone:[NSMenu menuZone]]
221 initWithTitle:[NSString stringWithUTF8String:title]]
225 NSMenu *newsubmenu(NSMenu *parent, const char *title)
230 item = [[[NSMenuItem allocWithZone:[NSMenu menuZone]]
231 initWithTitle:[NSString stringWithUTF8String:title]
235 child = newmenu(title);
236 [item setEnabled:YES];
237 [item setSubmenu:child];
238 [parent addItem:item];
242 id initnewitem(NSMenuItem *item, NSMenu *parent, const char *title,
243 const char *key, id target, SEL action)
245 unsigned mask = NSCommandKeyMask;
247 if (key[strcspn(key, "-")]) {
248 while (*key && *key != '-') {
249 int c = tolower((unsigned char)*key);
251 mask |= NSShiftKeyMask;
252 } else if (c == 'o' || c == 'a') {
253 mask |= NSAlternateKeyMask;
261 item = [[item initWithTitle:[NSString stringWithUTF8String:title]
263 keyEquivalent:[NSString stringWithUTF8String:key]]
267 [item setKeyEquivalentModifierMask: mask];
269 [item setEnabled:YES];
270 [item setTarget:target];
271 [item setAction:action];
273 [parent addItem:item];
278 NSMenuItem *newitem(NSMenu *parent, char *title, char *key,
279 id target, SEL action)
281 return initnewitem([NSMenuItem allocWithZone:[NSMenu menuZone]],
282 parent, title, key, target, action);
285 /* ----------------------------------------------------------------------
291 @interface AboutBox : NSWindow
297 @implementation AboutBox
305 NSFont *font1 = [NSFont systemFontOfSize:0];
306 NSFont *font2 = [NSFont boldSystemFontOfSize:[font1 pointSize] * 1.1];
307 const int border = 24;
312 * Construct the controls that go in the About box.
315 iv = [[NSImageView alloc] initWithFrame:NSMakeRect(0,0,64,64)];
316 [iv setImage:[NSImage imageNamed:@"NSApplicationIcon"]];
317 views[nviews++] = iv;
319 tf = [[NSTextField alloc]
320 initWithFrame:NSMakeRect(0,0,400,1)];
322 [tf setSelectable:NO];
324 [tf setDrawsBackground:NO];
326 [tf setStringValue:@"Simon Tatham's Portable Puzzle Collection"];
328 views[nviews++] = tf;
330 tf = [[NSTextField alloc]
331 initWithFrame:NSMakeRect(0,0,400,1)];
333 [tf setSelectable:NO];
335 [tf setDrawsBackground:NO];
337 [tf setStringValue:[NSString stringWithUTF8String:ver]];
339 views[nviews++] = tf;
342 * Lay the controls out.
344 totalrect = NSMakeRect(0,0,0,0);
345 for (i = 0; i < nviews; i++) {
346 NSRect r = [views[i] frame];
347 if (totalrect.size.width < r.size.width)
348 totalrect.size.width = r.size.width;
349 totalrect.size.height += border + r.size.height;
351 totalrect.size.width += 2 * border;
352 totalrect.size.height += border;
353 y = totalrect.size.height;
354 for (i = 0; i < nviews; i++) {
355 NSRect r = [views[i] frame];
356 r.origin.x = (totalrect.size.width - r.size.width) / 2;
357 y -= border + r.size.height;
359 [views[i] setFrame:r];
362 self = [super initWithContentRect:totalrect
363 styleMask:(NSTitledWindowMask | NSMiniaturizableWindowMask |
364 NSClosableWindowMask)
365 backing:NSBackingStoreBuffered
368 for (i = 0; i < nviews; i++)
369 [[self contentView] addSubview:views[i]];
371 [self center]; /* :-) */
377 /* ----------------------------------------------------------------------
378 * The front end presented to midend.c.
380 * This is mostly a subclass of NSWindow. The actual `frontend'
381 * structure passed to the midend contains a variety of pointers,
382 * including that window object but also including the image we
383 * draw on, an ImageView to display it in the window, and so on.
399 @interface MyImageView : NSImageView
403 - (void)setWindow:(GameWindow *)win;
404 - (void)mouseEvent:(NSEvent *)ev button:(int)b;
405 - (void)mouseDown:(NSEvent *)ev;
406 - (void)mouseDragged:(NSEvent *)ev;
407 - (void)mouseUp:(NSEvent *)ev;
408 - (void)rightMouseDown:(NSEvent *)ev;
409 - (void)rightMouseDragged:(NSEvent *)ev;
410 - (void)rightMouseUp:(NSEvent *)ev;
411 - (void)otherMouseDown:(NSEvent *)ev;
412 - (void)otherMouseDragged:(NSEvent *)ev;
413 - (void)otherMouseUp:(NSEvent *)ev;
416 @interface GameWindow : NSWindow
421 struct timeval last_time;
426 NSView **cfg_controls;
429 struct preset_menu *preset_menu;
430 NSMenuItem **preset_menu_items;
431 int n_preset_menu_items;
433 - (id)initWithGame:(const game *)g;
435 - (void)processButton:(int)b x:(int)x y:(int)y;
436 - (void)processKey:(int)b;
437 - (void)keyDown:(NSEvent *)ev;
438 - (void)activateTimer;
439 - (void)deactivateTimer;
440 - (void)setStatusLine:(char *)text;
441 - (void)resizeForNewGameParams;
442 - (void)updateTypeMenuTick;
445 @implementation MyImageView
447 - (void)setWindow:(GameWindow *)win
452 - (void)mouseEvent:(NSEvent *)ev button:(int)b
454 NSPoint point = [self convertPoint:[ev locationInWindow] fromView:nil];
455 [ourwin processButton:b x:point.x y:point.y];
458 - (void)mouseDown:(NSEvent *)ev
460 unsigned mod = [ev modifierFlags];
461 [self mouseEvent:ev button:((mod & NSCommandKeyMask) ? RIGHT_BUTTON :
462 (mod & NSShiftKeyMask) ? MIDDLE_BUTTON :
465 - (void)mouseDragged:(NSEvent *)ev
467 unsigned mod = [ev modifierFlags];
468 [self mouseEvent:ev button:((mod & NSCommandKeyMask) ? RIGHT_DRAG :
469 (mod & NSShiftKeyMask) ? MIDDLE_DRAG :
472 - (void)mouseUp:(NSEvent *)ev
474 unsigned mod = [ev modifierFlags];
475 [self mouseEvent:ev button:((mod & NSCommandKeyMask) ? RIGHT_RELEASE :
476 (mod & NSShiftKeyMask) ? MIDDLE_RELEASE :
479 - (void)rightMouseDown:(NSEvent *)ev
481 unsigned mod = [ev modifierFlags];
482 [self mouseEvent:ev button:((mod & NSShiftKeyMask) ? MIDDLE_BUTTON :
485 - (void)rightMouseDragged:(NSEvent *)ev
487 unsigned mod = [ev modifierFlags];
488 [self mouseEvent:ev button:((mod & NSShiftKeyMask) ? MIDDLE_DRAG :
491 - (void)rightMouseUp:(NSEvent *)ev
493 unsigned mod = [ev modifierFlags];
494 [self mouseEvent:ev button:((mod & NSShiftKeyMask) ? MIDDLE_RELEASE :
497 - (void)otherMouseDown:(NSEvent *)ev
499 [self mouseEvent:ev button:MIDDLE_BUTTON];
501 - (void)otherMouseDragged:(NSEvent *)ev
503 [self mouseEvent:ev button:MIDDLE_DRAG];
505 - (void)otherMouseUp:(NSEvent *)ev
507 [self mouseEvent:ev button:MIDDLE_RELEASE];
511 @implementation GameWindow
512 - (void)setupContentView
518 frame = [status frame];
519 frame.origin.y = frame.size.height;
525 midend_size(me, &w, &h, FALSE);
526 frame.size.width = w;
527 frame.size.height = h;
531 fe.image = [[NSImage alloc] initWithSize:frame.size];
532 fe.view = [[MyImageView alloc] initWithFrame:frame];
533 [fe.view setImage:fe.image];
534 [fe.view setWindow:self];
538 [[self contentView] addSubview:fe.view];
540 - (id)initWithGame:(const game *)g
542 NSRect rect = { {0,0}, {0,0} }, rect2;
547 preset_menu_items = NULL;
551 me = midend_new(&fe, ourgame, &osx_drawing, &fe);
553 * If we ever need to open a fresh window using a provided game
554 * ID, I think the right thing is to move most of this method
555 * into a new initWithGame:gameID: method, and have
556 * initWithGame: simply call that one and pass it NULL.
560 midend_size(me, &w, &h, FALSE);
562 rect.size.height = h;
567 * Create the status bar, which will just be an NSTextField.
569 if (midend_wants_statusbar(me)) {
570 status = [[NSTextField alloc] initWithFrame:NSMakeRect(0,0,100,50)];
571 [status setEditable:NO];
572 [status setSelectable:NO];
573 [status setBordered:YES];
574 [status setBezeled:YES];
575 [status setBezelStyle:NSTextFieldSquareBezel];
576 [status setDrawsBackground:YES];
577 [[status cell] setTitle:@DEFAULT_STATUSBAR_TEXT];
579 rect2 = [status frame];
580 rect.size.height += rect2.size.height;
581 rect2.size.width = rect.size.width;
582 rect2.origin.x = rect2.origin.y = 0;
583 [status setFrame:rect2];
587 self = [super initWithContentRect:rect
588 styleMask:(NSTitledWindowMask | NSMiniaturizableWindowMask |
589 NSClosableWindowMask)
590 backing:NSBackingStoreBuffered
592 [self setTitle:[NSString stringWithUTF8String:ourgame->name]];
598 colours = midend_colours(me, &ncolours);
599 fe.ncolours = ncolours;
600 fe.colours = snewn(ncolours, NSColor *);
602 for (i = 0; i < ncolours; i++) {
603 fe.colours[i] = [[NSColor colorWithDeviceRed:colours[i*3]
604 green:colours[i*3+1] blue:colours[i*3+2]
609 [self setupContentView];
611 [[self contentView] addSubview:status];
612 [self setIgnoresMouseEvents:NO];
614 [self center]; /* :-) */
622 for (i = 0; i < fe.ncolours; i++) {
623 [fe.colours[i] release];
626 sfree(preset_menu_items);
631 - (void)processButton:(int)b x:(int)x y:(int)y
633 if (!midend_process_key(me, x, fe.h - 1 - y, b))
637 - (void)processKey:(int)b
639 if (!midend_process_key(me, -1, -1, b))
643 - (void)keyDown:(NSEvent *)ev
645 NSString *s = [ev characters];
646 int i, n = [s length];
648 for (i = 0; i < n; i++) {
649 int c = [s characterAtIndex:i];
652 * ASCII gets passed straight to midend_process_key.
653 * Anything above that has to be translated to our own
654 * function key codes.
659 case NSUpArrowFunctionKey:
663 case NSDownArrowFunctionKey:
667 case NSLeftArrowFunctionKey:
671 case NSRightArrowFunctionKey:
680 if ([ev modifierFlags] & NSShiftKeyMask)
682 if ([ev modifierFlags] & NSControlKeyMask)
687 if (c >= '0' && c <= '9' && ([ev modifierFlags] & NSNumericPadKeyMask))
691 !((NSShiftKeyMask | NSControlKeyMask) & ~[ev modifierFlags]))
698 - (void)activateTimer
703 timer = [NSTimer scheduledTimerWithTimeInterval:0.02
704 target:self selector:@selector(timerTick:)
705 userInfo:nil repeats:YES];
706 gettimeofday(&last_time, NULL);
709 - (void)deactivateTimer
718 - (void)timerTick:(id)sender
722 gettimeofday(&now, NULL);
723 elapsed = ((now.tv_usec - last_time.tv_usec) * 0.000001F +
724 (now.tv_sec - last_time.tv_sec));
725 midend_timer(me, elapsed);
729 - (void)showError:(char *)message
733 alert = [[[NSAlert alloc] init] autorelease];
734 [alert addButtonWithTitle:@"Bah"];
735 [alert setInformativeText:[NSString stringWithUTF8String:message]];
736 [alert beginSheetModalForWindow:self modalDelegate:nil
737 didEndSelector:NULL contextInfo:nil];
740 - (void)newGame:(id)sender
742 [self processKey:UI_NEWGAME];
744 - (void)restartGame:(id)sender
746 midend_restart_game(me);
748 - (void)saveGame:(id)sender
750 NSSavePanel *sp = [NSSavePanel savePanel];
752 if ([sp runModal] == NSFileHandlingPanelOKButton) {
753 const char *name = [[sp filename] UTF8String];
755 FILE *fp = fopen(name, "w");
758 [self showError:"Unable to open save file"];
762 midend_serialise(me, savefile_write, fp);
767 - (void)loadSavedGame:(id)sender
769 NSOpenPanel *op = [NSOpenPanel openPanel];
771 [op setAllowsMultipleSelection:NO];
773 if ([op runModalForTypes:nil] == NSOKButton) {
777 * [[[op filenames] objectAtIndex:0] cString]
779 * but the plain cString method became deprecated and Xcode 7
780 * started complaining about it. Since OS X 10.9 we can
781 * apparently use the more modern API
783 * [[[op URLs] objectAtIndex:0] fileSystemRepresentation]
785 * but the alternative below still compiles with Xcode 7 and
786 * is a bit more backwards compatible, so I'll try it for the
789 const char *name = [[[op filenames] objectAtIndex:0]
790 cStringUsingEncoding:
791 [NSString defaultCStringEncoding]];
794 FILE *fp = fopen(name, "r");
797 [self showError:"Unable to open saved game file"];
801 err = midend_deserialise(me, savefile_read, fp);
806 [self showError:err];
810 [self resizeForNewGameParams];
811 [self updateTypeMenuTick];
814 - (void)undoMove:(id)sender
816 [self processKey:UI_UNDO];
818 - (void)redoMove:(id)sender
820 [self processKey:UI_REDO];
823 - (void)copy:(id)sender
827 if ((text = midend_text_format(me)) != NULL) {
828 NSPasteboard *pb = [NSPasteboard generalPasteboard];
829 NSArray *a = [NSArray arrayWithObject:NSStringPboardType];
830 [pb declareTypes:a owner:nil];
831 [pb setString:[NSString stringWithUTF8String:text]
832 forType:NSStringPboardType];
837 - (void)solveGame:(id)sender
841 msg = midend_solve(me);
844 [self showError:msg];
847 - (BOOL)validateMenuItem:(NSMenuItem *)item
849 if ([item action] == @selector(copy:))
850 return (ourgame->can_format_as_text_ever &&
851 midend_can_format_as_text_now(me) ? YES : NO);
852 else if ([item action] == @selector(solveGame:))
853 return (ourgame->can_solve ? YES : NO);
855 return [super validateMenuItem:item];
858 - (void)clearTypeMenu
862 while ([typemenu numberOfItems] > 1)
863 [typemenu removeItemAtIndex:0];
864 [[typemenu itemAtIndex:0] setState:NSOffState];
866 for (i = 0; i < n_preset_menu_items; i++)
867 preset_menu_items[i] = NULL;
870 - (void)updateTypeMenuTick
874 n = midend_which_preset(me);
876 for (i = 0; i < n_preset_menu_items; i++)
877 if (preset_menu_items[i])
878 [preset_menu_items[i] setState:(i == n ? NSOnState : NSOffState)];
881 * The Custom menu item is always right at the bottom of the
884 [[typemenu itemAtIndex:[typemenu numberOfItems]-1]
885 setState:(n < 0 ? NSOnState : NSOffState)];
888 - (void)populateTypeMenu:(NSMenu *)nsmenu from:(struct preset_menu *)menu
893 * We process the entries in reverse order so that (in the
894 * top-level Type menu at least) we don't disturb the 'Custom'
895 * item which remains fixed even when we change back and forth
896 * between puzzle type windows.
898 for (i = menu->n_entries; i-- > 0 ;) {
899 struct preset_menu_entry *entry = &menu->entries[i];
904 ditem = [[[DataMenuItem alloc]
905 initWithTitle:[NSString stringWithUTF8String:
907 action:NULL keyEquivalent:@""]
910 [ditem setTarget:self];
911 [ditem setAction:@selector(presetGame:)];
912 [ditem setPayload:entry->params];
914 preset_menu_items[entry->id] = ditem;
920 item = [[[NSMenuItem alloc]
921 initWithTitle:[NSString stringWithUTF8String:
923 action:NULL keyEquivalent:@""]
925 nssubmenu = newmenu(entry->title);
926 [item setSubmenu:nssubmenu];
928 [self populateTypeMenu:nssubmenu from:entry->submenu];
931 [item setEnabled:YES];
932 [nsmenu insertItem:item atIndex:0];
936 - (void)becomeKeyWindow
938 [self clearTypeMenu];
940 [super becomeKeyWindow];
944 preset_menu = midend_get_presets(me, &n_preset_menu_items);
945 preset_menu_items = snewn(n_preset_menu_items, NSMenuItem *);
946 for (i = 0; i < n_preset_menu_items; i++)
947 preset_menu_items[i] = NULL;
950 if (preset_menu->n_entries > 0) {
951 [typemenu insertItem:[NSMenuItem separatorItem] atIndex:0];
952 [self populateTypeMenu:typemenu from:preset_menu];
955 [self updateTypeMenuTick];
958 - (void)resignKeyWindow
960 [self clearTypeMenu];
961 [super resignKeyWindow];
966 [self clearTypeMenu];
970 - (void)resizeForNewGameParams
976 midend_size(me, &w, &h, FALSE);
983 NSRect frame = [status frame];
984 size.height += frame.size.height;
985 frame.size.width = size.width;
986 [status setFrame:frame];
990 NSDisableScreenUpdates();
992 [self setContentSize:size];
993 [self setupContentView];
995 NSEnableScreenUpdates();
999 - (void)presetGame:(id)sender
1001 game_params *params = [sender getPayload];
1003 midend_set_params(me, params);
1004 midend_new_game(me);
1006 [self resizeForNewGameParams];
1007 [self updateTypeMenuTick];
1010 - (void)startConfigureSheet:(int)which
1012 NSButton *ok, *cancel;
1013 int actw, acth, leftw, rightw, totalw, h, thish, y;
1015 NSRect rect, tmprect;
1016 const int SPACING = 16;
1019 int cfg_controlsize;
1024 assert(sheet == NULL);
1027 * Every control we create here is going to have this size
1028 * until we tell it to calculate a better one.
1030 tmprect = NSMakeRect(0, 0, 100, 50);
1033 * Set up OK and Cancel buttons. (Actually, MacOS doesn't seem
1034 * to be fond of generic OK and Cancel wording, so I'm going to
1035 * rename them to something nicer.)
1039 cancel = [[NSButton alloc] initWithFrame:tmprect];
1040 [cancel setBezelStyle:NSRoundedBezelStyle];
1041 [cancel setTitle:@"Abandon"];
1042 [cancel setTarget:self];
1043 [cancel setKeyEquivalent:@"\033"];
1044 [cancel setAction:@selector(sheetCancelButton:)];
1046 rect = [cancel frame];
1047 if (actw < rect.size.width) actw = rect.size.width;
1048 if (acth < rect.size.height) acth = rect.size.height;
1050 ok = [[NSButton alloc] initWithFrame:tmprect];
1051 [ok setBezelStyle:NSRoundedBezelStyle];
1052 [ok setTitle:@"Accept"];
1053 [ok setTarget:self];
1054 [ok setKeyEquivalent:@"\r"];
1055 [ok setAction:@selector(sheetOKButton:)];
1058 if (actw < rect.size.width) actw = rect.size.width;
1059 if (acth < rect.size.height) acth = rect.size.height;
1061 totalw = SPACING + 2 * actw;
1062 h = 2 * SPACING + acth;
1065 * Now fetch the midend config data and go through it creating
1068 cfg = midend_get_config(me, which, &title);
1069 sfree(title); /* FIXME: should we use this somehow? */
1072 cfg_ncontrols = cfg_controlsize = 0;
1073 cfg_controls = NULL;
1075 for (i = cfg; i->type != C_END; i++) {
1076 if (cfg_controlsize < cfg_ncontrols + 5) {
1077 cfg_controlsize = cfg_ncontrols + 32;
1078 cfg_controls = sresize(cfg_controls, cfg_controlsize, NSView *);
1086 * Two NSTextFields, one being a label and the other
1087 * being an edit box.
1090 tf = [[NSTextField alloc] initWithFrame:tmprect];
1091 [tf setEditable:NO];
1092 [tf setSelectable:NO];
1093 [tf setBordered:NO];
1094 [tf setDrawsBackground:NO];
1095 [[tf cell] setTitle:[NSString stringWithUTF8String:i->name]];
1098 if (thish < rect.size.height + 1) thish = rect.size.height + 1;
1099 if (leftw < rect.size.width + 1) leftw = rect.size.width + 1;
1100 cfg_controls[cfg_ncontrols++] = tf;
1102 tf = [[NSTextField alloc] initWithFrame:tmprect];
1103 [tf setEditable:YES];
1104 [tf setSelectable:YES];
1105 [tf setBordered:YES];
1106 [[tf cell] setTitle:[NSString stringWithUTF8String:i->sval]];
1110 * We impose a minimum and maximum width on editable
1111 * NSTextFields. If we allow them to size themselves to
1112 * the contents of the text within them, then they will
1113 * look very silly if that text is only one or two
1114 * characters, and equally silly if it's an absolutely
1115 * enormous Rectangles or Pattern game ID!
1117 if (rect.size.width < 75) rect.size.width = 75;
1118 if (rect.size.width > 400) rect.size.width = 400;
1120 if (thish < rect.size.height + 1) thish = rect.size.height + 1;
1121 if (rightw < rect.size.width + 1) rightw = rect.size.width + 1;
1122 cfg_controls[cfg_ncontrols++] = tf;
1127 * A checkbox is an NSButton with a type of
1130 b = [[NSButton alloc] initWithFrame:tmprect];
1131 [b setBezelStyle:NSRoundedBezelStyle];
1132 [b setButtonType:NSSwitchButton];
1133 [b setTitle:[NSString stringWithUTF8String:i->name]];
1135 [b setState:(i->ival ? NSOnState : NSOffState)];
1137 if (totalw < rect.size.width + 1) totalw = rect.size.width + 1;
1138 if (thish < rect.size.height + 1) thish = rect.size.height + 1;
1139 cfg_controls[cfg_ncontrols++] = b;
1144 * A pop-up menu control is an NSPopUpButton, which
1145 * takes an embedded NSMenu. We also need an
1146 * NSTextField to act as a label.
1149 tf = [[NSTextField alloc] initWithFrame:tmprect];
1150 [tf setEditable:NO];
1151 [tf setSelectable:NO];
1152 [tf setBordered:NO];
1153 [tf setDrawsBackground:NO];
1154 [[tf cell] setTitle:[NSString stringWithUTF8String:i->name]];
1157 if (thish < rect.size.height + 1) thish = rect.size.height + 1;
1158 if (leftw < rect.size.width + 1) leftw = rect.size.width + 1;
1159 cfg_controls[cfg_ncontrols++] = tf;
1161 pb = [[NSPopUpButton alloc] initWithFrame:tmprect pullsDown:NO];
1162 [pb setBezelStyle:NSRoundedBezelStyle];
1172 while (*p && *p != c) p++;
1174 copy = snewn((p-q) + 1, char);
1175 memcpy(copy, q, p-q);
1177 [pb addItemWithTitle:[NSString stringWithUTF8String:copy]];
1183 [pb selectItemAtIndex:i->ival];
1187 if (rightw < rect.size.width + 1) rightw = rect.size.width + 1;
1188 if (thish < rect.size.height + 1) thish = rect.size.height + 1;
1189 cfg_controls[cfg_ncontrols++] = pb;
1193 h += SPACING + thish;
1196 if (totalw < leftw + SPACING + rightw)
1197 totalw = leftw + SPACING + rightw;
1198 if (totalw > leftw + SPACING + rightw) {
1199 int excess = totalw - (leftw + SPACING + rightw);
1200 int leftexcess = leftw * excess / (leftw + rightw);
1201 int rightexcess = excess - leftexcess;
1202 leftw += leftexcess;
1203 rightw += rightexcess;
1207 * Now go through the list again, setting the final position
1212 for (i = cfg; i->type != C_END; i++) {
1219 * These two are treated identically, since both expect
1220 * a control on the left and another on the right.
1222 rect = [cfg_controls[k] frame];
1223 if (thish < rect.size.height + 1)
1224 thish = rect.size.height + 1;
1225 rect = [cfg_controls[k+1] frame];
1226 if (thish < rect.size.height + 1)
1227 thish = rect.size.height + 1;
1228 rect = [cfg_controls[k] frame];
1229 rect.origin.y = y - thish/2 - rect.size.height/2;
1230 rect.origin.x = SPACING;
1231 rect.size.width = leftw;
1232 [cfg_controls[k] setFrame:rect];
1233 rect = [cfg_controls[k+1] frame];
1234 rect.origin.y = y - thish/2 - rect.size.height/2;
1235 rect.origin.x = 2 * SPACING + leftw;
1236 rect.size.width = rightw;
1237 [cfg_controls[k+1] setFrame:rect];
1242 rect = [cfg_controls[k] frame];
1243 if (thish < rect.size.height + 1)
1244 thish = rect.size.height + 1;
1245 rect.origin.y = y - thish/2 - rect.size.height/2;
1246 rect.origin.x = SPACING;
1247 rect.size.width = totalw;
1248 [cfg_controls[k] setFrame:rect];
1255 assert(k == cfg_ncontrols);
1257 [cancel setFrame:NSMakeRect(SPACING+totalw/4-actw/2, SPACING, actw, acth)];
1258 [ok setFrame:NSMakeRect(SPACING+3*totalw/4-actw/2, SPACING, actw, acth)];
1260 sheet = [[NSWindow alloc]
1261 initWithContentRect:NSMakeRect(0,0,totalw + 2*SPACING,h)
1262 styleMask:NSTitledWindowMask | NSClosableWindowMask
1263 backing:NSBackingStoreBuffered
1266 [[sheet contentView] addSubview:cancel];
1267 [[sheet contentView] addSubview:ok];
1269 for (k = 0; k < cfg_ncontrols; k++)
1270 [[sheet contentView] addSubview:cfg_controls[k]];
1272 [app beginSheet:sheet modalForWindow:self
1273 modalDelegate:nil didEndSelector:NULL contextInfo:nil];
1276 - (void)specificGame:(id)sender
1278 [self startConfigureSheet:CFG_DESC];
1281 - (void)specificRandomGame:(id)sender
1283 [self startConfigureSheet:CFG_SEED];
1286 - (void)customGameType:(id)sender
1288 [self startConfigureSheet:CFG_SETTINGS];
1291 - (void)sheetEndWithStatus:(BOOL)update
1293 assert(sheet != NULL);
1294 [app endSheet:sheet];
1295 [sheet orderOut:self];
1303 for (i = cfg; i->type != C_END; i++) {
1307 i->sval = dupstr([[[(id)cfg_controls[k+1] cell]
1308 title] UTF8String]);
1312 i->ival = [(id)cfg_controls[k] state] == NSOnState;
1316 i->ival = [(id)cfg_controls[k+1] indexOfSelectedItem];
1322 error = midend_set_config(me, cfg_which, cfg);
1324 NSAlert *alert = [[[NSAlert alloc] init] autorelease];
1325 [alert addButtonWithTitle:@"Bah"];
1326 [alert setInformativeText:[NSString stringWithUTF8String:error]];
1327 [alert beginSheetModalForWindow:self modalDelegate:nil
1328 didEndSelector:NULL contextInfo:nil];
1330 midend_new_game(me);
1331 [self resizeForNewGameParams];
1332 [self updateTypeMenuTick];
1335 sfree(cfg_controls);
1336 cfg_controls = NULL;
1338 - (void)sheetOKButton:(id)sender
1340 [self sheetEndWithStatus:YES];
1342 - (void)sheetCancelButton:(id)sender
1344 [self sheetEndWithStatus:NO];
1347 - (void)setStatusLine:(char *)text
1349 [[status cell] setTitle:[NSString stringWithUTF8String:text]];
1355 * Drawing routines called by the midend.
1357 static void osx_draw_polygon(void *handle, int *coords, int npoints,
1358 int fillcolour, int outlinecolour)
1360 frontend *fe = (frontend *)handle;
1361 NSBezierPath *path = [NSBezierPath bezierPath];
1364 [[NSGraphicsContext currentContext] setShouldAntialias:YES];
1366 for (i = 0; i < npoints; i++) {
1367 NSPoint p = { coords[i*2] + 0.5, fe->h - coords[i*2+1] - 0.5 };
1369 [path moveToPoint:p];
1371 [path lineToPoint:p];
1376 if (fillcolour >= 0) {
1377 assert(fillcolour >= 0 && fillcolour < fe->ncolours);
1378 [fe->colours[fillcolour] set];
1382 assert(outlinecolour >= 0 && outlinecolour < fe->ncolours);
1383 [fe->colours[outlinecolour] set];
1386 static void osx_draw_circle(void *handle, int cx, int cy, int radius,
1387 int fillcolour, int outlinecolour)
1389 frontend *fe = (frontend *)handle;
1390 NSBezierPath *path = [NSBezierPath bezierPath];
1392 [[NSGraphicsContext currentContext] setShouldAntialias:YES];
1394 [path appendBezierPathWithArcWithCenter:NSMakePoint(cx+0.5, fe->h-cy-0.5)
1395 radius:radius startAngle:0.0 endAngle:360.0];
1399 if (fillcolour >= 0) {
1400 assert(fillcolour >= 0 && fillcolour < fe->ncolours);
1401 [fe->colours[fillcolour] set];
1405 assert(outlinecolour >= 0 && outlinecolour < fe->ncolours);
1406 [fe->colours[outlinecolour] set];
1409 static void osx_draw_line(void *handle, int x1, int y1, int x2, int y2, int colour)
1411 frontend *fe = (frontend *)handle;
1412 NSBezierPath *path = [NSBezierPath bezierPath];
1413 NSPoint p1 = { x1 + 0.5, fe->h - y1 - 0.5 };
1414 NSPoint p2 = { x2 + 0.5, fe->h - y2 - 0.5 };
1416 [[NSGraphicsContext currentContext] setShouldAntialias:NO];
1418 assert(colour >= 0 && colour < fe->ncolours);
1419 [fe->colours[colour] set];
1421 [path moveToPoint:p1];
1422 [path lineToPoint:p2];
1424 NSRectFill(NSMakeRect(x1, fe->h-y1-1, 1, 1));
1425 NSRectFill(NSMakeRect(x2, fe->h-y2-1, 1, 1));
1428 static void osx_draw_thick_line(
1429 void *handle, float thickness,
1434 frontend *fe = (frontend *)handle;
1435 NSBezierPath *path = [NSBezierPath bezierPath];
1437 assert(colour >= 0 && colour < fe->ncolours);
1438 [fe->colours[colour] set];
1439 [[NSGraphicsContext currentContext] setShouldAntialias: YES];
1440 [path setLineWidth: thickness];
1441 [path setLineCapStyle: NSButtLineCapStyle];
1442 [path moveToPoint: NSMakePoint(x1, fe->h-y1)];
1443 [path lineToPoint: NSMakePoint(x2, fe->h-y2)];
1447 static void osx_draw_rect(void *handle, int x, int y, int w, int h, int colour)
1449 frontend *fe = (frontend *)handle;
1450 NSRect r = { {x, fe->h - y - h}, {w,h} };
1452 [[NSGraphicsContext currentContext] setShouldAntialias:NO];
1454 assert(colour >= 0 && colour < fe->ncolours);
1455 [fe->colours[colour] set];
1459 static void osx_draw_text(void *handle, int x, int y, int fonttype,
1460 int fontsize, int align, int colour, char *text)
1462 frontend *fe = (frontend *)handle;
1463 NSString *string = [NSString stringWithUTF8String:text];
1469 [[NSGraphicsContext currentContext] setShouldAntialias:YES];
1471 assert(colour >= 0 && colour < fe->ncolours);
1473 if (fonttype == FONT_FIXED)
1474 font = [NSFont userFixedPitchFontOfSize:fontsize];
1476 font = [NSFont userFontOfSize:fontsize];
1478 attr = [NSDictionary dictionaryWithObjectsAndKeys:
1479 fe->colours[colour], NSForegroundColorAttributeName,
1480 font, NSFontAttributeName, nil];
1483 point.y = fe->h - y;
1485 size = [string sizeWithAttributes:attr];
1486 if (align & ALIGN_HRIGHT)
1487 point.x -= size.width;
1488 else if (align & ALIGN_HCENTRE)
1489 point.x -= size.width / 2;
1490 if (align & ALIGN_VCENTRE)
1491 point.y -= size.height / 2;
1493 [string drawAtPoint:point withAttributes:attr];
1495 static char *osx_text_fallback(void *handle, const char *const *strings,
1499 * We assume OS X can cope with any UTF-8 likely to be emitted
1502 return dupstr(strings[0]);
1509 static blitter *osx_blitter_new(void *handle, int w, int h)
1511 blitter *bl = snew(blitter);
1515 bl->img = [[NSImage alloc] initWithSize:NSMakeSize(w, h)];
1518 static void osx_blitter_free(void *handle, blitter *bl)
1523 static void osx_blitter_save(void *handle, blitter *bl, int x, int y)
1525 frontend *fe = (frontend *)handle;
1526 int sx, sy, sX, sY, dx, dy, dX, dY;
1527 [fe->image unlockFocus];
1528 [bl->img lockFocus];
1531 * Find the intersection of the source and destination rectangles,
1532 * so as to avoid trying to copy from outside the source image,
1533 * which GNUstep dislikes.
1535 * Lower-case x,y coordinates are bottom left box corners;
1536 * upper-case X,Y are the top right.
1538 sx = x; sy = fe->h - y - bl->h;
1539 sX = sx + bl->w; sY = sy + bl->h;
1541 dX = bl->w; dY = bl->h;
1559 [fe->image drawInRect:NSMakeRect(dx, dy, dX-dx, dY-dy)
1560 fromRect:NSMakeRect(sx, sy, sX-sx, sY-sy)
1561 operation:NSCompositeCopy fraction:1.0];
1562 [bl->img unlockFocus];
1563 [fe->image lockFocus];
1567 static void osx_blitter_load(void *handle, blitter *bl, int x, int y)
1569 frontend *fe = (frontend *)handle;
1570 if (x == BLITTER_FROMSAVED && y == BLITTER_FROMSAVED) {
1574 [bl->img drawInRect:NSMakeRect(x, fe->h - y - bl->h, bl->w, bl->h)
1575 fromRect:NSMakeRect(0, 0, bl->w, bl->h)
1576 operation:NSCompositeCopy fraction:1.0];
1578 static void osx_draw_update(void *handle, int x, int y, int w, int h)
1580 frontend *fe = (frontend *)handle;
1581 [fe->view setNeedsDisplayInRect:NSMakeRect(x, fe->h - y - h, w, h)];
1583 static void osx_clip(void *handle, int x, int y, int w, int h)
1585 frontend *fe = (frontend *)handle;
1586 NSRect r = { {x, fe->h - y - h}, {w, h} };
1589 [[NSGraphicsContext currentContext] saveGraphicsState];
1590 [NSBezierPath clipRect:r];
1593 static void osx_unclip(void *handle)
1595 frontend *fe = (frontend *)handle;
1597 [[NSGraphicsContext currentContext] restoreGraphicsState];
1598 fe->clipped = FALSE;
1600 static void osx_start_draw(void *handle)
1602 frontend *fe = (frontend *)handle;
1603 [fe->image lockFocus];
1604 fe->clipped = FALSE;
1606 static void osx_end_draw(void *handle)
1608 frontend *fe = (frontend *)handle;
1609 [fe->image unlockFocus];
1611 static void osx_status_bar(void *handle, char *text)
1613 frontend *fe = (frontend *)handle;
1614 [fe->window setStatusLine:text];
1617 const struct drawing_api osx_drawing = {
1633 NULL, NULL, NULL, NULL, NULL, NULL, /* {begin,end}_{doc,page,puzzle} */
1634 NULL, NULL, /* line_width, line_dotted */
1636 osx_draw_thick_line,
1639 void deactivate_timer(frontend *fe)
1641 [fe->window deactivateTimer];
1643 void activate_timer(frontend *fe)
1645 [fe->window activateTimer];
1648 /* ----------------------------------------------------------------------
1649 * AppController: the object which receives the messages from all
1650 * menu selections that aren't standard OS X functions.
1652 @interface AppController : NSObject <NSApplicationDelegate>
1655 - (void)newGameWindow:(id)sender;
1656 - (void)about:(id)sender;
1659 @implementation AppController
1661 - (void)newGameWindow:(id)sender
1663 const game *g = [sender getPayload];
1666 win = [[GameWindow alloc] initWithGame:g];
1667 [win makeKeyAndOrderFront:self];
1670 - (void)about:(id)sender
1674 win = [[AboutBox alloc] init];
1675 [win makeKeyAndOrderFront:self];
1678 - (NSMenu *)applicationDockMenu:(NSApplication *)sender
1680 NSMenu *menu = newmenu("Dock Menu");
1684 for (i = 0; i < gamecount; i++) {
1686 initnewitem([DataMenuItem allocWithZone:[NSMenu menuZone]],
1687 menu, gamelist[i]->name, "", self,
1688 @selector(newGameWindow:));
1689 [item setPayload:(void *)gamelist[i]];
1697 /* ----------------------------------------------------------------------
1698 * Main program. Constructs the menus and runs the application.
1700 int main(int argc, char **argv)
1702 NSAutoreleasePool *pool;
1704 AppController *controller;
1707 pool = [[NSAutoreleasePool alloc] init];
1709 icon = [NSImage imageNamed:@"NSApplicationIcon"];
1710 app = [NSApplication sharedApplication];
1711 [app setApplicationIconImage:icon];
1713 controller = [[[AppController alloc] init] autorelease];
1714 [app setDelegate:controller];
1716 [app setMainMenu: newmenu("Main Menu")];
1718 menu = newsubmenu([app mainMenu], "Apple Menu");
1719 newitem(menu, "About Puzzles", "", NULL, @selector(about:));
1720 [menu addItem:[NSMenuItem separatorItem]];
1721 [app setServicesMenu:newsubmenu(menu, "Services")];
1722 [menu addItem:[NSMenuItem separatorItem]];
1723 newitem(menu, "Hide Puzzles", "h", app, @selector(hide:));
1724 newitem(menu, "Hide Others", "o-h", app, @selector(hideOtherApplications:));
1725 newitem(menu, "Show All", "", app, @selector(unhideAllApplications:));
1726 [menu addItem:[NSMenuItem separatorItem]];
1727 newitem(menu, "Quit", "q", app, @selector(terminate:));
1728 [app setAppleMenu: menu];
1730 menu = newsubmenu([app mainMenu], "File");
1731 newitem(menu, "Open", "o", NULL, @selector(loadSavedGame:));
1732 newitem(menu, "Save As", "s", NULL, @selector(saveGame:));
1733 newitem(menu, "New Game", "n", NULL, @selector(newGame:));
1734 newitem(menu, "Restart Game", "r", NULL, @selector(restartGame:));
1735 newitem(menu, "Specific Game", "", NULL, @selector(specificGame:));
1736 newitem(menu, "Specific Random Seed", "", NULL,
1737 @selector(specificRandomGame:));
1738 [menu addItem:[NSMenuItem separatorItem]];
1740 NSMenu *submenu = newsubmenu(menu, "New Window");
1743 for (i = 0; i < gamecount; i++) {
1745 initnewitem([DataMenuItem allocWithZone:[NSMenu menuZone]],
1746 submenu, gamelist[i]->name, "", controller,
1747 @selector(newGameWindow:));
1748 [item setPayload:(void *)gamelist[i]];
1751 [menu addItem:[NSMenuItem separatorItem]];
1752 newitem(menu, "Close", "w", NULL, @selector(performClose:));
1754 menu = newsubmenu([app mainMenu], "Edit");
1755 newitem(menu, "Undo", "z", NULL, @selector(undoMove:));
1756 newitem(menu, "Redo", "S-z", NULL, @selector(redoMove:));
1757 [menu addItem:[NSMenuItem separatorItem]];
1758 newitem(menu, "Cut", "x", NULL, @selector(cut:));
1759 newitem(menu, "Copy", "c", NULL, @selector(copy:));
1760 newitem(menu, "Paste", "v", NULL, @selector(paste:));
1761 [menu addItem:[NSMenuItem separatorItem]];
1762 newitem(menu, "Solve", "S-s", NULL, @selector(solveGame:));
1764 menu = newsubmenu([app mainMenu], "Type");
1766 newitem(menu, "Custom", "", NULL, @selector(customGameType:));
1768 menu = newsubmenu([app mainMenu], "Window");
1769 [app setWindowsMenu: menu];
1770 newitem(menu, "Minimise Window", "m", NULL, @selector(performMiniaturize:));
1772 menu = newsubmenu([app mainMenu], "Help");
1773 newitem(menu, "Puzzles Help", "?", app, @selector(showHelp:));