Code cleanup. Added ChangeLog entry.
[emacs.git] / src / nsfns.m
blobfd0ec1a965c673dcab4357792970f88826477dc7
1 /* Functions for the NeXT/Open/GNUstep and MacOSX window system.
2    Copyright (C) 1989, 1992, 1993, 1994, 2005, 2006, 2008, 2009, 2010
3      Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.  */
21 Originally by Carl Edman
22 Updated by Christian Limpach (chris@nice.ch)
23 OpenStep/Rhapsody port by Scott Bender (sbender@harmony-ds.com)
24 MacOSX/Aqua port by Christophe de Dinechin (descubes@earthlink.net)
25 GNUstep port and post-20 update by Adrian Robert (arobert@cogsci.ucsd.edu)
28 /* This should be the first include, as it may set up #defines affecting
29    interpretation of even the system includes. */
30 #include <config.h>
32 #include <signal.h>
33 #include <math.h>
34 #include <setjmp.h>
36 #include "lisp.h"
37 #include "blockinput.h"
38 #include "nsterm.h"
39 #include "window.h"
40 #include "buffer.h"
41 #include "keyboard.h"
42 #include "termhooks.h"
43 #include "fontset.h"
44 #include "character.h"
45 #include "font.h"
47 #if 0
48 int fns_trace_num = 1;
49 #define NSTRACE(x)        fprintf (stderr, "%s:%d: [%d] " #x "\n",        \
50                                   __FILE__, __LINE__, ++fns_trace_num)
51 #else
52 #define NSTRACE(x)
53 #endif
55 #ifdef HAVE_NS
57 extern NSArray *ns_send_types, *ns_return_types, *ns_drag_types;
59 extern Lisp_Object Qforeground_color;
60 extern Lisp_Object Qbackground_color;
61 extern Lisp_Object Qcursor_color;
62 extern Lisp_Object Qinternal_border_width;
63 extern Lisp_Object Qvisibility;
64 extern Lisp_Object Qcursor_type;
65 extern Lisp_Object Qicon_type;
66 extern Lisp_Object Qicon_name;
67 extern Lisp_Object Qicon_left;
68 extern Lisp_Object Qicon_top;
69 extern Lisp_Object Qleft;
70 extern Lisp_Object Qright;
71 extern Lisp_Object Qtop;
72 extern Lisp_Object Qdisplay;
73 extern Lisp_Object Qvertical_scroll_bars;
74 extern Lisp_Object Qauto_raise;
75 extern Lisp_Object Qauto_lower;
76 extern Lisp_Object Qbox;
77 extern Lisp_Object Qscroll_bar_width;
78 extern Lisp_Object Qx_resource_name;
79 extern Lisp_Object Qface_set_after_frame_default;
80 extern Lisp_Object Qunderline, Qundefined;
81 extern Lisp_Object Qheight, Qminibuffer, Qname, Qonly, Qwidth;
82 extern Lisp_Object Qunsplittable, Qmenu_bar_lines, Qbuffer_predicate, Qtitle;
83 extern Lisp_Object Qnone;
84 extern Lisp_Object Vframe_title_format;
86 /* The below are defined in frame.c.  */
88 extern Lisp_Object Vmenu_bar_mode, Vtool_bar_mode;
90 Lisp_Object Qbuffered;
91 Lisp_Object Qfontsize;
93 /* hack for OS X file panels */
94 char panelOK = 0;
96 /* Alist of elements (REGEXP . IMAGE) for images of icons associated
97    to frames.*/
98 static Lisp_Object Vns_icon_type_alist;
100 /* Toolkit version support. */
101 static Lisp_Object Vns_version_string;
103 EmacsTooltip *ns_tooltip;
105 /* Need forward declaration here to preserve organizational integrity of file */
106 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
108 extern BOOL ns_in_resize;
111 /* ==========================================================================
113     Internal utility functions
115    ========================================================================== */
118 void
119 check_ns (void)
121  if (NSApp == nil)
122    error ("OpenStep is not in use or not initialized");
126 /* Nonzero if we can use mouse menus. */
128 have_menus_p ()
130   return NSApp != nil;
134 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
135    and checking validity for NS.  */
136 static FRAME_PTR
137 check_ns_frame (Lisp_Object frame)
139   FRAME_PTR f;
141   if (NILP (frame))
142       f = SELECTED_FRAME ();
143   else
144     {
145       CHECK_LIVE_FRAME (frame);
146       f = XFRAME (frame);
147     }
148   if (! FRAME_NS_P (f))
149     error ("non-Nextstep frame used");
150   return f;
154 /* Let the user specify an Nextstep display with a frame.
155    nil stands for the selected frame--or, if that is not an Nextstep frame,
156    the first Nextstep display on the list.  */
157 static struct ns_display_info *
158 check_ns_display_info (Lisp_Object frame)
160   if (NILP (frame))
161     {
162       struct frame *f = SELECTED_FRAME ();
163       if (FRAME_NS_P (f) && FRAME_LIVE_P (f) )
164         return FRAME_NS_DISPLAY_INFO (f);
165       else if (x_display_list != 0)
166         return x_display_list;
167       else
168         error ("Nextstep windows are not in use or not initialized");
169     }
170   else if (INTEGERP (frame))
171     {
172       struct terminal *t = get_terminal (frame, 1);
174       if (t->type != output_ns)
175         error ("Terminal %d is not a Nextstep display", XINT (frame));
177       return t->display_info.ns;
178     }
179   else if (STRINGP (frame))
180     return ns_display_info_for_name (frame);
181   else
182     {
183       FRAME_PTR f;
185       CHECK_LIVE_FRAME (frame);
186       f = XFRAME (frame);
187       if (! FRAME_NS_P (f))
188         error ("non-Nextstep frame used");
189       return FRAME_NS_DISPLAY_INFO (f);
190     }
191   return NULL;  /* shut compiler up */
195 static id
196 ns_get_window (Lisp_Object maybeFrame)
198   id view =nil, window =nil;
200   if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
201     maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
203   if (!NILP (maybeFrame))
204     view = FRAME_NS_VIEW (XFRAME (maybeFrame));
205   if (view) window =[view window];
207   return window;
211 static NSScreen *
212 ns_get_screen (Lisp_Object screen)
214   struct frame *f;
215   struct terminal *terminal;
217   if (EQ (Qt, screen)) /* not documented */
218     return [NSScreen mainScreen];
220   terminal = get_terminal (screen, 1);
221   if (terminal->type != output_ns)
222     return NULL;
224   if (NILP (screen))
225     f = SELECTED_FRAME ();
226   else if (FRAMEP (screen))
227     f = XFRAME (screen);
228   else
229     {
230       struct ns_display_info *dpyinfo = terminal->display_info.ns;
231       f = dpyinfo->x_focus_frame
232         ? dpyinfo->x_focus_frame : dpyinfo->x_highlight_frame;
233     }
235   return ((f && FRAME_NS_P (f)) ? [[FRAME_NS_VIEW (f) window] screen]
236           : NULL);
240 /* Return the X display structure for the display named NAME.
241    Open a new connection if necessary.  */
242 struct ns_display_info *
243 ns_display_info_for_name (name)
244      Lisp_Object name;
246   Lisp_Object names;
247   struct ns_display_info *dpyinfo;
249   CHECK_STRING (name);
251   for (dpyinfo = x_display_list, names = ns_display_name_list;
252        dpyinfo;
253        dpyinfo = dpyinfo->next, names = XCDR (names))
254     {
255       Lisp_Object tem;
256       tem = Fstring_equal (XCAR (XCAR (names)), name);
257       if (!NILP (tem))
258         return dpyinfo;
259     }
261   error ("Emacs for OpenStep does not yet support multi-display.");
263   Fx_open_connection (name, Qnil, Qnil);
264   dpyinfo = x_display_list;
266   if (dpyinfo == 0)
267     error ("OpenStep on %s not responding.\n", SDATA (name));
269   return dpyinfo;
273 static Lisp_Object
274 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
275 /* --------------------------------------------------------------------------
276    Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
277    -------------------------------------------------------------------------- */
279   int i, count;
280   NSMenuItem *item;
281   const char *name;
282   Lisp_Object nameStr;
283   unsigned short key;
284   NSString *keys;
285   Lisp_Object res;
287   count = [menu numberOfItems];
288   for (i = 0; i<count; i++)
289     {
290       item = [menu itemAtIndex: i];
291       name = [[item title] UTF8String];
292       if (!name) continue;
294       nameStr = build_string (name);
296       if ([item hasSubmenu])
297         {
298           old = interpret_services_menu ([item submenu],
299                                         Fcons (nameStr, prefix), old);
300         }
301       else
302         {
303           keys = [item keyEquivalent];
304           if (keys && [keys length] )
305             {
306               key = [keys characterAtIndex: 0];
307               res = make_number (key|super_modifier);
308             }
309           else
310             {
311               res = Qundefined;
312             }
313           old = Fcons (Fcons (res,
314                             Freverse (Fcons (nameStr,
315                                            prefix))),
316                     old);
317         }
318     }
319   return old;
324 /* ==========================================================================
326     Frame parameter setters
328    ========================================================================== */
331 static void
332 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
334   NSColor *col;
336   if (ns_lisp_to_color (arg, &col))
337     {
338       store_frame_param (f, Qforeground_color, oldval);
339       error ("Unknown color");
340     }
342   [col retain];
343   [f->output_data.ns->foreground_color release];
344   f->output_data.ns->foreground_color = col;
346   if (FRAME_NS_VIEW (f))
347     {
348       update_face_from_frame_parameter (f, Qforeground_color, arg);
349       /*recompute_basic_faces (f); */
350       if (FRAME_VISIBLE_P (f))
351         redraw_frame (f);
352     }
356 static void
357 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
359   struct face *face;
360   NSColor *col;
361   NSView *view = FRAME_NS_VIEW (f);
362   float alpha;
364   if (ns_lisp_to_color (arg, &col))
365     {
366       store_frame_param (f, Qbackground_color, oldval);
367       error ("Unknown color");
368     }
370   /* clear the frame; in some instances the NS-internal GC appears not to
371      update, or it does update and cannot clear old text properly */
372   if (FRAME_VISIBLE_P (f))
373     ns_clear_frame (f);
375   [col retain];
376   [f->output_data.ns->background_color release];
377   f->output_data.ns->background_color = col;
378   if (view != nil)
379     {
380       [[view window] setBackgroundColor: col];
381       alpha = [col alphaComponent];
383       if (alpha != 1.0)
384           [[view window] setOpaque: NO];
385       else
386           [[view window] setOpaque: YES];
388       face = FRAME_DEFAULT_FACE (f);
389       if (face)
390         {
391           col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
392           face->background
393              = (EMACS_UINT) [[col colorWithAlphaComponent: alpha] retain];
394           [col release];
396           update_face_from_frame_parameter (f, Qbackground_color, arg);
397         }
399       if (FRAME_VISIBLE_P (f))
400         redraw_frame (f);
401     }
405 static void
406 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
408   NSColor *col;
410   if (ns_lisp_to_color (arg, &col))
411     {
412       store_frame_param (f, Qcursor_color, oldval);
413       error ("Unknown color");
414     }
416   [FRAME_CURSOR_COLOR (f) release];
417   FRAME_CURSOR_COLOR (f) = [col retain];
419   if (FRAME_VISIBLE_P (f))
420     {
421       x_update_cursor (f, 0);
422       x_update_cursor (f, 1);
423     }
424   update_face_from_frame_parameter (f, Qcursor_color, arg);
428 static void
429 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
431   NSView *view = FRAME_NS_VIEW (f);
432   NSTRACE (x_set_icon_name);
434   if (ns_in_resize)
435     return;
437   /* see if it's changed */
438   if (STRINGP (arg))
439     {
440       if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
441         return;
442     }
443   else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
444     return;
446   f->icon_name = arg;
448   if (NILP (arg))
449     {
450       if (!NILP (f->title))
451         arg = f->title;
452       else
453         /* explicit name and no icon-name -> explicit_name */
454         if (f->explicit_name)
455           arg = f->name;
456         else
457           {
458             /* no explicit name and no icon-name ->
459                name has to be rebuild from icon_title_format */
460             windows_or_buffers_changed++;
461             return;
462           }
463     }
465   /* Don't change the name if it's already NAME.  */
466   if ([[view window] miniwindowTitle] &&
467       ([[[view window] miniwindowTitle]
468              isEqualToString: [NSString stringWithUTF8String:
469                                            SDATA (arg)]]))
470     return;
472   [[view window] setMiniwindowTitle:
473         [NSString stringWithUTF8String: SDATA (arg)]];
477 static void
478 ns_set_name_iconic (struct frame *f, Lisp_Object name, int explicit)
480   NSView *view = FRAME_NS_VIEW (f);
481   NSTRACE (ns_set_name_iconic);
483   if (ns_in_resize)
484     return;
486   /* Make sure that requests from lisp code override requests from
487      Emacs redisplay code.  */
488   if (explicit)
489     {
490       /* If we're switching from explicit to implicit, we had better
491          update the mode lines and thereby update the title.  */
492       if (f->explicit_name && NILP (name))
493         update_mode_lines = 1;
495       f->explicit_name = ! NILP (name);
496     }
497   else if (f->explicit_name)
498     name = f->name;
500   /* title overrides explicit name */
501   if (! NILP (f->title))
502     name = f->title;
504   /* icon_name overrides title and explicit name */
505   if (! NILP (f->icon_name))
506     name = f->icon_name;
508   if (NILP (name))
509     name = build_string([ns_app_name UTF8String]);
510   else
511     CHECK_STRING (name);
513   /* Don't change the name if it's already NAME.  */
514   if ([[view window] miniwindowTitle] &&
515       ([[[view window] miniwindowTitle]
516              isEqualToString: [NSString stringWithUTF8String:
517                                            SDATA (name)]]))
518     return;
520   [[view window] setMiniwindowTitle:
521         [NSString stringWithUTF8String: SDATA (name)]];
525 static void
526 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
528   NSView *view;
529   NSTRACE (ns_set_name);
531   if (ns_in_resize)
532     return;
534   /* Make sure that requests from lisp code override requests from
535      Emacs redisplay code.  */
536   if (explicit)
537     {
538       /* If we're switching from explicit to implicit, we had better
539          update the mode lines and thereby update the title.  */
540       if (f->explicit_name && NILP (name))
541         update_mode_lines = 1;
543       f->explicit_name = ! NILP (name);
544     }
545   else if (f->explicit_name)
546     return;
548   if (NILP (name))
549     name = build_string([ns_app_name UTF8String]);
551   f->name = name;
553   /* title overrides explicit name */
554   if (! NILP (f->title))
555     name = f->title;
557   CHECK_STRING (name);
559   view = FRAME_NS_VIEW (f);
561   /* Don't change the name if it's already NAME.  */
562   if ([[[view window] title]
563             isEqualToString: [NSString stringWithUTF8String:
564                                           SDATA (name)]])
565     return;
566   [[view window] setTitle: [NSString stringWithUTF8String:
567                                         SDATA (name)]];
571 /* This function should be called when the user's lisp code has
572    specified a name for the frame; the name will override any set by the
573    redisplay code.  */
574 static void
575 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
577   NSTRACE (x_explicitly_set_name);
578   ns_set_name_iconic (f, arg, 1);
579   ns_set_name (f, arg, 1);
583 /* This function should be called by Emacs redisplay code to set the
584    name; names set this way will never override names set by the user's
585    lisp code.  */
586 void
587 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
589   NSTRACE (x_implicitly_set_name);
590   if (FRAME_ICONIFIED_P (f))
591     ns_set_name_iconic (f, arg, 0);
592   else if (FRAME_NS_P (f) && EQ (Vframe_title_format, Qt))
593     ns_set_name_as_filename (f);
594   else
595     ns_set_name (f, arg, 0);
599 /* Change the title of frame F to NAME.
600    If NAME is nil, use the frame name as the title.
602    If EXPLICIT is non-zero, that indicates that lisp code is setting the
603    name; if NAME is a string, set F's name to NAME and set
604    F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
606    If EXPLICIT is zero, that indicates that Emacs redisplay code is
607    suggesting a new name, which lisp code should override; if
608    F->explicit_name is set, ignore the new name; otherwise, set it.  */
609 static void
610 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
612   NSTRACE (x_set_title);
613   /* Don't change the title if it's already NAME.  */
614   if (EQ (name, f->title))
615     return;
617   update_mode_lines = 1;
619   f->title = name;
623 void
624 ns_set_name_as_filename (struct frame *f)
626   NSView *view;
627   Lisp_Object name;
628   Lisp_Object buf = XWINDOW (f->selected_window)->buffer;
629   const char *title;
630   NSAutoreleasePool *pool;
631   NSTRACE (ns_set_name_as_filename);
633   if (f->explicit_name || ! NILP (f->title) || ns_in_resize)
634     return;
636   BLOCK_INPUT;
637   pool = [[NSAutoreleasePool alloc] init];
638   name = XBUFFER (buf)->filename;
639   if (NILP (name) || FRAME_ICONIFIED_P (f)) name =XBUFFER (buf)->name;
641   if (FRAME_ICONIFIED_P (f) && !NILP (f->icon_name))
642     name = f->icon_name;
644   if (NILP (name))
645     name = build_string ([ns_app_name UTF8String]);
646   else
647     CHECK_STRING (name);
649   view = FRAME_NS_VIEW (f);
651   title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
652                                 : [[[view window] title] UTF8String];
654   if (title && (! strcmp (title, SDATA (name))))
655     {
656       [pool release];
657       UNBLOCK_INPUT;
658       return;
659     }
661   if (! FRAME_ICONIFIED_P (f))
662     {
663 #ifdef NS_IMPL_COCOA
664       /* work around a bug observed on 10.3 where
665          setTitleWithRepresentedFilename does not clear out previous state
666          if given filename does not exist */
667       NSString *str = [NSString stringWithUTF8String: SDATA (name)];
668       if (![[NSFileManager defaultManager] fileExistsAtPath: str])
669         {
670           [[view window] setTitleWithRepresentedFilename: @""];
671           [[view window] setTitle: str];
672         }
673       else
674         {
675           [[view window] setTitleWithRepresentedFilename: str];
676         }
677 #else
678       [[view window] setTitleWithRepresentedFilename:
679                          [NSString stringWithUTF8String: SDATA (name)]];
680 #endif
681       f->name = name;
682     }
683   else
684     {
685       [[view window] setMiniwindowTitle:
686             [NSString stringWithUTF8String: SDATA (name)]];
687     }
688   [pool release];
689   UNBLOCK_INPUT;
693 void
694 ns_set_doc_edited (struct frame *f, Lisp_Object arg)
696   NSView *view = FRAME_NS_VIEW (f);
697   NSAutoreleasePool *pool;
698   if (!MINI_WINDOW_P (XWINDOW (f->selected_window)))
699     {
700       BLOCK_INPUT;
701       pool = [[NSAutoreleasePool alloc] init];
702       [[view window] setDocumentEdited: !NILP (arg)];
703       [pool release];
704       UNBLOCK_INPUT;
705     }
709 void
710 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
712   int nlines;
713   int olines = FRAME_MENU_BAR_LINES (f);
714   if (FRAME_MINIBUF_ONLY_P (f))
715     return;
717   if (INTEGERP (value))
718     nlines = XINT (value);
719   else
720     nlines = 0;
722   FRAME_MENU_BAR_LINES (f) = 0;
723   if (nlines)
724     {
725       FRAME_EXTERNAL_MENU_BAR (f) = 1;
726       /* does for all frames, whereas we just want for one frame
727          [NSMenu setMenuBarVisible: YES]; */
728     }
729   else
730     {
731       if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
732         free_frame_menubar (f);
733       /*      [NSMenu setMenuBarVisible: NO]; */
734       FRAME_EXTERNAL_MENU_BAR (f) = 0;
735     }
739 /* toolbar support */
740 void
741 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
743   int nlines;
744   Lisp_Object root_window;
746   if (FRAME_MINIBUF_ONLY_P (f))
747     return;
749   if (INTEGERP (value) && XINT (value) >= 0)
750     nlines = XFASTINT (value);
751   else
752     nlines = 0;
754   if (nlines)
755     {
756       FRAME_EXTERNAL_TOOL_BAR (f) = 1;
757       update_frame_tool_bar (f);
758     }
759   else
760     {
761       if (FRAME_EXTERNAL_TOOL_BAR (f))
762         {
763           free_frame_tool_bar (f);
764           FRAME_EXTERNAL_TOOL_BAR (f) = 0;
765         }
766     }
768   x_set_window_size (f, 0, f->text_cols, f->text_lines);
772 void
773 ns_implicitly_set_icon_type (struct frame *f)
775   Lisp_Object tem;
776   EmacsView *view = FRAME_NS_VIEW (f);
777   id image =nil;
778   Lisp_Object chain, elt;
779   NSAutoreleasePool *pool;
780   BOOL setMini = YES;
782   NSTRACE (ns_implicitly_set_icon_type);
784   BLOCK_INPUT;
785   pool = [[NSAutoreleasePool alloc] init];
786   if (f->output_data.ns->miniimage
787       && [[NSString stringWithUTF8String: SDATA (f->name)]
788                isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
789     {
790       [pool release];
791       UNBLOCK_INPUT;
792       return;
793     }
795   tem = assq_no_quit (Qicon_type, f->param_alist);
796   if (CONSP (tem) && ! NILP (XCDR (tem)))
797     {
798       [pool release];
799       UNBLOCK_INPUT;
800       return;
801     }
803   for (chain = Vns_icon_type_alist;
804        (image = nil) && CONSP (chain);
805        chain = XCDR (chain))
806     {
807       elt = XCAR (chain);
808       /* special case: 't' means go by file type */
809       if (SYMBOLP (elt) && EQ (elt, Qt) && SDATA (f->name)[0] == '/')
810         {
811           NSString *str
812              = [NSString stringWithUTF8String: SDATA (f->name)];
813           if ([[NSFileManager defaultManager] fileExistsAtPath: str])
814             image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
815         }
816       else if (CONSP (elt) &&
817                STRINGP (XCAR (elt)) &&
818                STRINGP (XCDR (elt)) &&
819                fast_string_match (XCAR (elt), f->name) >= 0)
820         {
821           image = [EmacsImage allocInitFromFile: XCDR (elt)];
822           if (image == nil)
823             image = [[NSImage imageNamed:
824                                [NSString stringWithUTF8String:
825                                             SDATA (XCDR (elt))]] retain];
826         }
827     }
829   if (image == nil)
830     {
831       image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
832       setMini = NO;
833     }
835   [f->output_data.ns->miniimage release];
836   f->output_data.ns->miniimage = image;
837   [view setMiniwindowImage: setMini];
838   [pool release];
839   UNBLOCK_INPUT;
843 static void
844 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
846   EmacsView *view = FRAME_NS_VIEW (f);
847   id image = nil;
848   BOOL setMini = YES;
850   NSTRACE (x_set_icon_type);
852   if (!NILP (arg) && SYMBOLP (arg))
853     {
854       arg =build_string (SDATA (SYMBOL_NAME (arg)));
855       store_frame_param (f, Qicon_type, arg);
856     }
858   /* do it the implicit way */
859   if (NILP (arg))
860     {
861       ns_implicitly_set_icon_type (f);
862       return;
863     }
865   CHECK_STRING (arg);
867   image = [EmacsImage allocInitFromFile: arg];
868   if (image == nil)
869     image =[NSImage imageNamed: [NSString stringWithUTF8String:
870                                             SDATA (arg)]];
872   if (image == nil)
873     {
874       image = [NSImage imageNamed: @"text"];
875       setMini = NO;
876     }
878   f->output_data.ns->miniimage = image;
879   [view setMiniwindowImage: setMini];
883 /* Xism; we stub out (we do implement this in ns-win.el) */
885 XParseGeometry (char *string, int *x, int *y,
886                 unsigned int *width, unsigned int *height)
888   message1 ("Warning: XParseGeometry not supported under NS.\n");
889   return 0;
893 /* TODO: move to nsterm? */
895 ns_lisp_to_cursor_type (Lisp_Object arg)
897   char *str;
898   if (XTYPE (arg) == Lisp_String)
899     str = SDATA (arg);
900   else if (XTYPE (arg) == Lisp_Symbol)
901     str = SDATA (SYMBOL_NAME (arg));
902   else return -1;
903   if (!strcmp (str, "box"))     return FILLED_BOX_CURSOR;
904   if (!strcmp (str, "hollow"))  return HOLLOW_BOX_CURSOR;
905   if (!strcmp (str, "hbar"))    return HBAR_CURSOR;
906   if (!strcmp (str, "bar"))     return BAR_CURSOR;
907   if (!strcmp (str, "no"))      return NO_CURSOR;
908   return -1;
912 Lisp_Object
913 ns_cursor_type_to_lisp (int arg)
915   switch (arg)
916     {
917     case FILLED_BOX_CURSOR: return Qbox;
918     case HOLLOW_BOX_CURSOR: return intern ("hollow");
919     case HBAR_CURSOR:       return intern ("hbar");
920     case BAR_CURSOR:        return intern ("bar");
921     case NO_CURSOR:
922     default:                return intern ("no");
923     }
926 /* This is the same as the xfns.c definition.  */
927 void
928 x_set_cursor_type (f, arg, oldval)
929      FRAME_PTR f;
930      Lisp_Object arg, oldval;
932   set_frame_cursor_types (f, arg);
934   /* Make sure the cursor gets redrawn.  */
935   cursor_type_changed = 1;
939 /* called to set mouse pointer color, but all other terms use it to
940    initialize pointer types (and don't set the color ;) */
941 static void
942 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
944   /* don't think we can do this on Nextstep */
948 #define Str(x) #x
949 #define Xstr(x) Str(x)
951 static Lisp_Object
952 ns_appkit_version_str ()
954   char tmp[80];
956 #ifdef NS_IMPL_GNUSTEP
957   sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
958 #elif defined(NS_IMPL_COCOA)
959   sprintf(tmp, "apple-appkit-%.2f", NSAppKitVersionNumber);
960 #else
961   tmp = "ns-unknown";
962 #endif
963   return build_string (tmp);
967 /* This is for use by x-server-version and collapses all version info we
968    have into a single int.  For a better picture of the implementation
969    running, use ns_appkit_version_str.*/
970 static int
971 ns_appkit_version_int ()
973 #ifdef NS_IMPL_GNUSTEP
974   return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GUI_MINOR_VERSION;
975 #elif defined(NS_IMPL_COCOA)
976   return (int)NSAppKitVersionNumber;
977 #endif
978   return 0;
982 static void
983 x_icon (struct frame *f, Lisp_Object parms)
984 /* --------------------------------------------------------------------------
985    Strangely-named function to set icon position parameters in frame.
986    This is irrelevant under OS X, but might be needed under GNUstep,
987    depending on the window manager used.  Note, this is not a standard
988    frame parameter-setter; it is called directly from x-create-frame.
989    -------------------------------------------------------------------------- */
991   Lisp_Object icon_x, icon_y;
992   struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
994   f->output_data.ns->icon_top = Qnil;
995   f->output_data.ns->icon_left = Qnil;
997   /* Set the position of the icon.  */
998   icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
999   icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0,  RES_TYPE_NUMBER);
1000   if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
1001     {
1002       CHECK_NUMBER (icon_x);
1003       CHECK_NUMBER (icon_y);
1004       f->output_data.ns->icon_top = icon_y;
1005       f->output_data.ns->icon_left = icon_x;
1006     }
1007   else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
1008     error ("Both left and top icon corners of icon must be specified");
1012 /* Note: see frame.c for template, also where generic functions are impl */
1013 frame_parm_handler ns_frame_parm_handlers[] =
1015   x_set_autoraise, /* generic OK */
1016   x_set_autolower, /* generic OK */
1017   x_set_background_color,
1018   0, /* x_set_border_color,  may be impossible under Nextstep */
1019   0, /* x_set_border_width,  may be impossible under Nextstep */
1020   x_set_cursor_color,
1021   x_set_cursor_type,
1022   x_set_font, /* generic OK */
1023   x_set_foreground_color,
1024   x_set_icon_name,
1025   x_set_icon_type,
1026   x_set_internal_border_width, /* generic OK */
1027   x_set_menu_bar_lines,
1028   x_set_mouse_color,
1029   x_explicitly_set_name,
1030   x_set_scroll_bar_width, /* generic OK */
1031   x_set_title,
1032   x_set_unsplittable, /* generic OK */
1033   x_set_vertical_scroll_bars, /* generic OK */
1034   x_set_visibility, /* generic OK */
1035   x_set_tool_bar_lines,
1036   0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
1037   0, /* x_set_scroll_bar_background,  will ignore (not possible on NS) */
1038   x_set_screen_gamma, /* generic OK */
1039   x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
1040   x_set_fringe_width, /* generic OK */
1041   x_set_fringe_width, /* generic OK */
1042   0, /* x_set_wait_for_wm, will ignore */
1043   0,  /* x_set_fullscreen will ignore */
1044   x_set_font_backend, /* generic OK */
1045   x_set_alpha,
1046   0, /* x_set_sticky */  
1051 /* ==========================================================================
1053     Lisp definitions
1055    ========================================================================== */
1057 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1058        1, 1, 0,
1059        doc: /* Make a new Nextstep window, called a \"frame\" in Emacs terms.
1060 Return an Emacs frame object.
1061 PARMS is an alist of frame parameters.
1062 If the parameters specify that the frame should not have a minibuffer,
1063 and do not specify a specific minibuffer window to use,
1064 then `default-minibuffer-frame' must be a frame whose minibuffer can
1065 be shared by the new frame.  */)
1066      (Lisp_Object parms)
1068   static int desc_ctr = 1;
1069   struct frame *f;
1070   struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1071   Lisp_Object frame, tem;
1072   Lisp_Object name;
1073   int minibuffer_only = 0;
1074   int count = specpdl_ptr - specpdl;
1075   Lisp_Object display;
1076   struct ns_display_info *dpyinfo = NULL;
1077   Lisp_Object parent;
1078   struct kboard *kb;
1079   Lisp_Object tfont, tfontsize;
1080   int window_prompting = 0;
1081   int width, height;
1083   check_ns ();
1085   /* Seems a little strange, but other terms do it. Perhaps the code below
1086      is modifying something? */
1087   parms = Fcopy_alist (parms);
1089   display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1090   if (EQ (display, Qunbound))
1091     display = Qnil;
1092   dpyinfo = check_ns_display_info (display);
1094   if (!dpyinfo->terminal->name)
1095     error ("Terminal is not live, can't create new frames on it");
1097   kb = dpyinfo->terminal->kboard;
1099   name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1100   if (!STRINGP (name)
1101       && ! EQ (name, Qunbound)
1102       && ! NILP (name))
1103     error ("Invalid frame name--not a string or nil");
1105   if (STRINGP (name))
1106     Vx_resource_name = name;
1107   else
1108     Vx_resource_name = Vinvocation_name;
1110   parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1111   if (EQ (parent, Qunbound))
1112     parent = Qnil;
1113   if (! NILP (parent))
1114     CHECK_NUMBER (parent);
1116   frame = Qnil;
1117   GCPRO4 (parms, parent, name, frame);
1119   tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1120                   RES_TYPE_SYMBOL);
1121   if (EQ (tem, Qnone) || NILP (tem))
1122     {
1123       f = make_frame_without_minibuffer (Qnil, kb, display);
1124     }
1125   else if (EQ (tem, Qonly))
1126     {
1127       f = make_minibuffer_frame ();
1128       minibuffer_only = 1;
1129     }
1130   else if (WINDOWP (tem))
1131     {
1132       f = make_frame_without_minibuffer (tem, kb, display);
1133     }
1134   else
1135     {
1136       f = make_frame (1);
1137     }
1139   /* Set the name; the functions to which we pass f expect the name to
1140      be set.  */
1141   if (EQ (name, Qunbound) || NILP (name) || (XTYPE (name) != Lisp_String))
1142     {
1143       f->name = build_string ([ns_app_name UTF8String]);
1144       f->explicit_name =0;
1145     }
1146   else
1147     {
1148       f->name = name;
1149       f->explicit_name = 1;
1150       specbind (Qx_resource_name, name);
1151     }
1153   XSETFRAME (frame, f);
1154   FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
1156   f->terminal = dpyinfo->terminal;
1157   f->terminal->reference_count++;
1159   f->output_method = output_ns;
1160   f->output_data.ns = (struct ns_output *)xmalloc (sizeof *(f->output_data.ns));
1161   memset (f->output_data.ns, 0, sizeof (*(f->output_data.ns)));
1163   FRAME_FONTSET (f) = -1;
1165   /* record_unwind_protect (unwind_create_frame, frame); safety; maybe later? */
1167   f->icon_name = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
1168                             RES_TYPE_STRING);
1169   if (! STRINGP (f->icon_name))
1170     f->icon_name = Qnil;
1172   FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1174   f->output_data.ns->window_desc = desc_ctr++;
1175   if (!NILP (parent))
1176     {
1177       f->output_data.ns->parent_desc = (Window) XFASTINT (parent);
1178       f->output_data.ns->explicit_parent = 1;
1179     }
1180   else
1181     {
1182       f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1183       f->output_data.ns->explicit_parent = 0;
1184     }
1186   f->resx = dpyinfo->resx;
1187   f->resy = dpyinfo->resy;
1189   BLOCK_INPUT;
1190   register_font_driver (&nsfont_driver, f);
1191   x_default_parameter (f, parms, Qfont_backend, Qnil,
1192                         "fontBackend", "FontBackend", RES_TYPE_STRING);
1194   {
1195     /* use for default font name */
1196     id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1197     tfontsize = x_default_parameter (f, parms, Qfontsize,
1198                                     make_number (0 /*(int)[font pointSize]*/),
1199                                     "fontSize", "FontSize", RES_TYPE_NUMBER);
1200     tfont = x_default_parameter (f, parms, Qfont,
1201                                  build_string ([[font fontName] UTF8String]),
1202                                  "font", "Font", RES_TYPE_STRING);
1203   }
1204   UNBLOCK_INPUT;
1206   x_default_parameter (f, parms, Qborder_width, make_number (0),
1207                        "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1208   x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1209                       "internalBorderWidth", "InternalBorderWidth",
1210                       RES_TYPE_NUMBER);
1212   /* default scrollbars on right on Mac */
1213   {
1214       Lisp_Object spos
1215 #ifdef NS_IMPL_GNUSTEP
1216           = Qt;
1217 #else
1218           = Qright;
1219 #endif
1220       x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1221                            "verticalScrollBars", "VerticalScrollBars",
1222                            RES_TYPE_SYMBOL);
1223   }
1224   x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1225                       "foreground", "Foreground", RES_TYPE_STRING);
1226   x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1227                       "background", "Background", RES_TYPE_STRING);
1228   x_default_parameter (f, parms, Qcursor_color, build_string ("grey"),
1229                       "cursorColor", "CursorColor", RES_TYPE_STRING);
1230   /* FIXME: not suppported yet in Nextstep */
1231   x_default_parameter (f, parms, Qline_spacing, Qnil,
1232                        "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1233   x_default_parameter (f, parms, Qleft_fringe, Qnil,
1234                        "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1235   x_default_parameter (f, parms, Qright_fringe, Qnil,
1236                        "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1237   /* end PENDING */
1239   init_frame_faces (f);
1241   /* The X resources controlling the menu-bar and tool-bar are
1242      processed specially at startup, and reflected in the mode
1243      variables; ignore them here.  */
1244   x_default_parameter (f, parms, Qmenu_bar_lines,
1245                        NILP (Vmenu_bar_mode)
1246                        ? make_number (0) : make_number (1),
1247                        NULL, NULL, RES_TYPE_NUMBER);
1248   x_default_parameter (f, parms, Qtool_bar_lines,
1249                        NILP (Vtool_bar_mode)
1250                        ? make_number (0) : make_number (1),
1251                        NULL, NULL, RES_TYPE_NUMBER);
1253   x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1254                        "BufferPredicate", RES_TYPE_SYMBOL);
1255   x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1256                        RES_TYPE_STRING);
1258 /* TODO: other terms seem to get away w/o this complexity.. */
1259   if (NILP (Fassq (Qwidth, parms)))
1260     {
1261       Lisp_Object value
1262          = x_get_arg (dpyinfo, parms, Qwidth, "width", "Width",
1263                       RES_TYPE_NUMBER);
1264       if (! EQ (value, Qunbound))
1265         parms = Fcons (Fcons (Qwidth, value), parms);
1266     }
1267   if (NILP (Fassq (Qheight, parms)))
1268     {
1269       Lisp_Object value
1270          = x_get_arg (dpyinfo, parms, Qheight, "height", "Height",
1271                       RES_TYPE_NUMBER);
1272       if (! EQ (value, Qunbound))
1273         parms = Fcons (Fcons (Qheight, value), parms);
1274     }
1275   if (NILP (Fassq (Qleft, parms)))
1276     {
1277       Lisp_Object value
1278          = x_get_arg (dpyinfo, parms, Qleft, "left", "Left", RES_TYPE_NUMBER);
1279       if (! EQ (value, Qunbound))
1280         parms = Fcons (Fcons (Qleft, value), parms);
1281     }
1282   if (NILP (Fassq (Qtop, parms)))
1283     {
1284       Lisp_Object value
1285          = x_get_arg (dpyinfo, parms, Qtop, "top", "Top", RES_TYPE_NUMBER);
1286       if (! EQ (value, Qunbound))
1287         parms = Fcons (Fcons (Qtop, value), parms);
1288     }
1290   window_prompting = x_figure_window_size (f, parms, 1);
1292   tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1293   f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1295   /* NOTE: on other terms, this is done in set_mouse_color, however this
1296      was not getting called under Nextstep */
1297   f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1298   f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1299   f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1300   f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1301   f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1302   f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1303   FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1304      = [NSCursor arrowCursor];
1305   f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1307   [[EmacsView alloc] initFrameFromEmacs: f];
1309   x_icon (f, parms);
1311   /* It is now ok to make the frame official even if we get an error below.
1312      The frame needs to be on Vframe_list or making it visible won't work. */
1313   Vframe_list = Fcons (frame, Vframe_list);
1314   /*FRAME_NS_DISPLAY_INFO (f)->reference_count++; */
1316   x_default_parameter (f, parms, Qicon_type, Qnil, "bitmapIcon", "BitmapIcon",
1317                       RES_TYPE_SYMBOL);
1318   x_default_parameter (f, parms, Qauto_raise, Qnil, "autoRaise", "AutoRaiseLower",
1319                       RES_TYPE_BOOLEAN);
1320   x_default_parameter (f, parms, Qauto_lower, Qnil, "autoLower", "AutoLower",
1321                       RES_TYPE_BOOLEAN);
1322   x_default_parameter (f, parms, Qcursor_type, Qbox, "cursorType", "CursorType",
1323                       RES_TYPE_SYMBOL);
1324   x_default_parameter (f, parms, Qscroll_bar_width, Qnil, "scrollBarWidth",
1325                       "ScrollBarWidth", RES_TYPE_NUMBER);
1326   x_default_parameter (f, parms, Qalpha, Qnil, "alpha", "Alpha",
1327                       RES_TYPE_NUMBER);
1329   width = FRAME_COLS (f);
1330   height = FRAME_LINES (f);
1332   SET_FRAME_COLS (f, 0);
1333   FRAME_LINES (f) = 0;
1334   change_frame_size (f, height, width, 1, 0, 0);
1336   if (! f->output_data.ns->explicit_parent)
1337     {
1338       tem = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL);
1339       if (EQ (tem, Qunbound))
1340         tem = Qt;
1341       x_set_visibility (f, tem, Qnil);
1342       if (EQ (tem, Qicon))
1343         x_iconify_frame (f);
1344       else if (! NILP (tem))
1345         {
1346           x_make_frame_visible (f);
1347           f->async_visible = 1;
1348           [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1349         }
1350       else
1351           f->async_visible = 0;
1352     }
1354   if (FRAME_HAS_MINIBUF_P (f)
1355       && (!FRAMEP (kb->Vdefault_minibuffer_frame)
1356           || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
1357     kb->Vdefault_minibuffer_frame = frame;
1359   /* All remaining specified parameters, which have not been "used"
1360      by x_get_arg and friends, now go in the misc. alist of the frame.  */
1361   for (tem = parms; CONSP (tem); tem = XCDR (tem))
1362     if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1363       f->param_alist = Fcons (XCAR (tem), f->param_alist);
1365   UNGCPRO;
1366   Vwindow_list = Qnil;
1368   return unbind_to (count, frame);
1372 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1373        doc: /* Set the input focus to FRAME.
1374 FRAME nil means use the selected frame.  */)
1375      (Lisp_Object frame)
1377   struct frame *f = check_ns_frame (frame);
1378   struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1380   if (dpyinfo->x_focus_frame != f)
1381     {
1382       EmacsView *view = FRAME_NS_VIEW (f);
1383       BLOCK_INPUT;
1384       [NSApp activateIgnoringOtherApps: YES];
1385       [[view window] makeKeyAndOrderFront: view];
1386       UNBLOCK_INPUT;
1387     }
1389   return Qnil;
1393 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1394        0, 1, "",
1395        doc: /* Pop up the font panel. */)
1396      (Lisp_Object frame)
1398   id fm;
1399   struct frame *f;
1401   check_ns ();
1402   fm = [NSFontManager sharedFontManager];
1403   if (NILP (frame))
1404     f = SELECTED_FRAME ();
1405   else
1406     {
1407       CHECK_FRAME (frame);
1408       f = XFRAME (frame);
1409     }
1411   [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1412            isMultiple: NO];
1413   [fm orderFrontFontPanel: NSApp];
1414   return Qnil;
1418 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1419        0, 1, "",
1420        doc: /* Pop up the color panel.  */)
1421      (Lisp_Object frame)
1423   struct frame *f;
1425   check_ns ();
1426   if (NILP (frame))
1427     f = SELECTED_FRAME ();
1428   else
1429     {
1430       CHECK_FRAME (frame);
1431       f = XFRAME (frame);
1432     }
1434   [NSApp orderFrontColorPanel: NSApp];
1435   return Qnil;
1439 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 4, 0,
1440        doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1441 Optional arg DIR, if non-nil, supplies a default directory.
1442 Optional arg ISLOAD, if non-nil, means read a file name for saving.
1443 Optional arg INIT, if non-nil, provides a default file name to use.  */)
1444      (Lisp_Object prompt, Lisp_Object dir, Lisp_Object isLoad, Lisp_Object init)
1446   static id fileDelegate = nil;
1447   int ret;
1448   id panel;
1449   Lisp_Object fname;
1451   NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1452     [NSString stringWithUTF8String: SDATA (prompt)];
1453   NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1454     [NSString stringWithUTF8String: SDATA (current_buffer->directory)] :
1455     [NSString stringWithUTF8String: SDATA (dir)];
1456   NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1457     [NSString stringWithUTF8String: SDATA (init)];
1459   check_ns ();
1461   if (fileDelegate == nil)
1462     fileDelegate = [EmacsFileDelegate new];
1464   [NSCursor setHiddenUntilMouseMoves: NO];
1466   if ([dirS characterAtIndex: 0] == '~')
1467     dirS = [dirS stringByExpandingTildeInPath];
1469   panel = NILP (isLoad) ?
1470     (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1472   [panel setTitle: promptS];
1474   /* Puma (10.1) does not have */
1475   if ([panel respondsToSelector: @selector (setAllowsOtherFileTypes:)])
1476     [panel setAllowsOtherFileTypes: YES];
1478   [panel setTreatsFilePackagesAsDirectories: YES];
1479   [panel setDelegate: fileDelegate];
1481   panelOK = 0;
1482   BLOCK_INPUT;
1483   if (NILP (isLoad))
1484     {
1485       ret = [panel runModalForDirectory: dirS file: initS];
1486     }
1487   else
1488     {
1489       [panel setCanChooseDirectories: YES];
1490       ret = [panel runModalForDirectory: dirS file: initS types: nil];
1491     }
1493   ret = (ret == NSOKButton) || panelOK;
1495   if (ret)
1496     fname = build_string ([[panel filename] UTF8String]);
1498   [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1499   UNBLOCK_INPUT;
1501   return ret ? fname : Qnil;
1505 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1506        doc: /* Return the value of the property NAME of OWNER from the defaults database.
1507 If OWNER is nil, Emacs is assumed.  */)
1508      (Lisp_Object owner, Lisp_Object name)
1510   const char *value;
1512   check_ns ();
1513   if (NILP (owner))
1514     owner = build_string([ns_app_name UTF8String]);
1515   CHECK_STRING (name);
1516 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SDATA (name)); */
1518   value =[[[NSUserDefaults standardUserDefaults]
1519             objectForKey: [NSString stringWithUTF8String: SDATA (name)]]
1520            UTF8String];
1522   if (value)
1523     return build_string (value);
1524   return Qnil;
1528 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1529        doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1530 If OWNER is nil, Emacs is assumed.
1531 If VALUE is nil, the default is removed.  */)
1532      (Lisp_Object owner, Lisp_Object name, Lisp_Object value)
1534   check_ns ();
1535   if (NILP (owner))
1536     owner = build_string ([ns_app_name UTF8String]);
1537   CHECK_STRING (name);
1538   if (NILP (value))
1539     {
1540       [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1541                          [NSString stringWithUTF8String: SDATA (name)]];
1542     }
1543   else
1544     {
1545       CHECK_STRING (value);
1546       [[NSUserDefaults standardUserDefaults] setObject:
1547                 [NSString stringWithUTF8String: SDATA (value)]
1548                                         forKey: [NSString stringWithUTF8String:
1549                                                          SDATA (name)]];
1550     }
1552   return Qnil;
1556 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1557        Sx_server_max_request_size,
1558        0, 1, 0,
1559        doc: /* This function is a no-op.  It is only present for completeness.  */)
1560      (Lisp_Object display)
1562   check_ns ();
1563   /* This function has no real equivalent under NeXTstep.  Return nil to
1564      indicate this. */
1565   return Qnil;
1569 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1570        doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1571 DISPLAY should be either a frame or a display name (a string).
1572 If omitted or nil, the selected frame's display is used.  */)
1573      (Lisp_Object display)
1575 #ifdef NS_IMPL_GNUSTEP
1576   return build_string ("GNU");
1577 #else
1578   return build_string ("Apple");
1579 #endif
1583 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1584        doc: /* Return the version numbers of the server of DISPLAY.
1585 The value is a list of three integers: the major and minor
1586 version numbers of the X Protocol in use, and the distributor-specific
1587 release number.  See also the function `x-server-vendor'.
1589 The optional argument DISPLAY specifies which display to ask about.
1590 DISPLAY should be either a frame or a display name (a string).
1591 If omitted or nil, that stands for the selected frame's display.  */)
1592      (Lisp_Object display)
1594   /*NOTE: it is unclear what would best correspond with "protocol";
1595           we return 10.3, meaning Panther, since this is roughly the
1596           level that GNUstep's APIs correspond to.
1597           The last number is where we distinguish between the Apple
1598           and GNUstep implementations ("distributor-specific release
1599           number") and give int'ized versions of major.minor. */
1600   return Fcons (make_number (10),
1601                 Fcons (make_number (3),
1602                        Fcons (make_number (ns_appkit_version_int()), Qnil)));
1606 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1607        doc: /* Return the number of screens on Nextstep display server DISPLAY.
1608 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1609 If omitted or nil, the selected frame's display is used.  */)
1610      (Lisp_Object display)
1612   int num;
1614   check_ns ();
1615   num = [[NSScreen screens] count];
1617   return (num != 0) ? make_number (num) : Qnil;
1621 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1622        0, 1, 0,
1623        doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1624 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1625 If omitted or nil, the selected frame's display is used.  */)
1626      (Lisp_Object display)
1628   check_ns ();
1629   return make_number ((int)
1630                      ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1634 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1635        0, 1, 0,
1636        doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1637 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1638 If omitted or nil, the selected frame's display is used.  */)
1639      (Lisp_Object display)
1641   check_ns ();
1642   return make_number ((int)
1643                      ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1647 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1648        Sx_display_backing_store, 0, 1, 0,
1649        doc: /* Return whether the Nexstep display DISPLAY supports backing store.
1650 The value may be `buffered', `retained', or `non-retained'.
1651 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1652 If omitted or nil, the selected frame's display is used.  */)
1653      (Lisp_Object display)
1655   check_ns ();
1656   switch ([ns_get_window (display) backingType])
1657     {
1658     case NSBackingStoreBuffered:
1659       return intern ("buffered");
1660     case NSBackingStoreRetained:
1661       return intern ("retained");
1662     case NSBackingStoreNonretained:
1663       return intern ("non-retained");
1664     default:
1665       error ("Strange value for backingType parameter of frame");
1666     }
1667   return Qnil;  /* not reached, shut compiler up */
1671 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1672        Sx_display_visual_class, 0, 1, 0,
1673        doc: /* Return the visual class of the Nextstep display server DISPLAY.
1674 The value is one of the symbols `static-gray', `gray-scale',
1675 `static-color', `pseudo-color', `true-color', or `direct-color'.
1676 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1677 If omitted or nil, the selected frame's display is used.  */)
1678      (Lisp_Object display)
1680   NSWindowDepth depth;
1681   check_ns ();
1682   depth = [ns_get_screen (display) depth];
1684   if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1685     return intern ("static-gray");
1686   else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1687     return intern ("gray-scale");
1688   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1689     return intern ("pseudo-color");
1690   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1691     return intern ("true-color");
1692   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1693     return intern ("direct-color");
1694   else
1695     /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1696     return intern ("direct-color");
1700 DEFUN ("x-display-save-under", Fx_display_save_under,
1701        Sx_display_save_under, 0, 1, 0,
1702        doc: /* Non-nil if the Nextstep display server supports the save-under feature.
1703 The optional argument DISPLAY specifies which display to ask about.
1704 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1705 If omitted or nil, the selected frame's display is used.  */)
1706      (Lisp_Object display)
1708   check_ns ();
1709   switch ([ns_get_window (display) backingType])
1710     {
1711     case NSBackingStoreBuffered:
1712       return Qt;
1714     case NSBackingStoreRetained:
1715     case NSBackingStoreNonretained:
1716       return Qnil;
1718     default:
1719       error ("Strange value for backingType parameter of frame");
1720     }
1721   return Qnil;  /* not reached, shut compiler up */
1725 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1726        1, 3, 0,
1727        doc: /* Open a connection to a Nextstep display server.
1728 DISPLAY is the name of the display to connect to.
1729 Optional arguments XRM-STRING and MUST-SUCCEED are currently ignored.  */)
1730      (Lisp_Object display, Lisp_Object resource_string, Lisp_Object must_succeed)
1732   struct ns_display_info *dpyinfo;
1734   CHECK_STRING (display);
1736   nxatoms_of_nsselect ();
1737   dpyinfo = ns_term_init (display);
1738   if (dpyinfo == 0)
1739     {
1740       if (!NILP (must_succeed))
1741         fatal ("OpenStep on %s not responding.\n",
1742                SDATA (display));
1743       else
1744         error ("OpenStep on %s not responding.\n",
1745                SDATA (display));
1746     }
1748   /* Register our external input/output types, used for determining
1749      applicable services and also drag/drop eligibility. */
1750   ns_send_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1751   ns_return_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1752   ns_drag_types = [[NSArray arrayWithObjects:
1753                             NSStringPboardType,
1754                             NSTabularTextPboardType,
1755                             NSFilenamesPboardType,
1756                             NSURLPboardType,
1757                             NSColorPboardType,
1758                             NSFontPboardType, nil] retain];
1760   return Qnil;
1764 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1765        1, 1, 0,
1766        doc: /* Close the connection to the current Nextstep display server.
1767 The argument DISPLAY is currently ignored.  */)
1768      (Lisp_Object display)
1770   check_ns ();
1771   /*ns_delete_terminal (dpyinfo->terminal); */
1772   [NSApp terminate: NSApp];
1773   return Qnil;
1777 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1778        doc: /* Return the list of display names that Emacs has connections to.  */)
1779      (void)
1781   Lisp_Object tail, result;
1783   result = Qnil;
1784   for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1785     result = Fcons (XCAR (XCAR (tail)), result);
1787   return result;
1791 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1792        0, 0, 0,
1793        doc: /* Hides all applications other than Emacs.  */)
1794      (void)
1796   check_ns ();
1797   [NSApp hideOtherApplications: NSApp];
1798   return Qnil;
1801 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1802        1, 1, 0,
1803        doc: /* If ON is non-nil, the entire Emacs application is hidden.
1804 Otherwise if Emacs is hidden, it is unhidden.
1805 If ON is equal to `activate', Emacs is unhidden and becomes
1806 the active application.  */)
1807      (Lisp_Object on)
1809   check_ns ();
1810   if (EQ (on, intern ("activate")))
1811     {
1812       [NSApp unhide: NSApp];
1813       [NSApp activateIgnoringOtherApps: YES];
1814     }
1815   else if (NILP (on))
1816     [NSApp unhide: NSApp];
1817   else
1818     [NSApp hide: NSApp];
1819   return Qnil;
1823 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1824        0, 0, 0,
1825        doc: /* Shows the 'Info' or 'About' panel for Emacs.  */)
1826      (void)
1828   check_ns ();
1829   [NSApp orderFrontStandardAboutPanel: nil];
1830   return Qnil;
1834 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1835        doc: /* Determine font postscript or family name for font NAME.
1836 NAME should be a string containing either the font name or an XLFD
1837 font descriptor.  If string contains `fontset' and not
1838 `fontset-startup', it is left alone. */)
1839      (Lisp_Object name)
1841   char *nm;
1842   CHECK_STRING (name);
1843   nm = SDATA (name);
1845   if (nm[0] != '-')
1846     return name;
1847   if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1848     return name;
1850   return build_string (ns_xlfd_to_fontname (SDATA (name)));
1854 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1855        doc: /* Return a list of all available colors.
1856 The optional argument FRAME is currently ignored.  */)
1857      (Lisp_Object frame)
1859   Lisp_Object list = Qnil;
1860   NSEnumerator *colorlists;
1861   NSColorList *clist;
1863   if (!NILP (frame))
1864     {
1865       CHECK_FRAME (frame);
1866       if (! FRAME_NS_P (XFRAME (frame)))
1867         error ("non-Nextstep frame used in `ns-list-colors'");
1868     }
1870   BLOCK_INPUT;
1872   colorlists = [[NSColorList availableColorLists] objectEnumerator];
1873   while (clist = [colorlists nextObject])
1874     {
1875       if ([[clist name] length] < 7 ||
1876           [[clist name] rangeOfString: @"PANTONE"].location == 0)
1877         {
1878           NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1879           NSString *cname;
1880           while (cname = [cnames nextObject])
1881             list = Fcons (build_string ([cname UTF8String]), list);
1882 /*           for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1883                list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1884                                              UTF8String]), list); */
1885         }
1886     }
1888   UNBLOCK_INPUT;
1890   return list;
1894 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1895        doc: /* List available Nextstep services by querying NSApp.  */)
1896      (void)
1898   Lisp_Object ret = Qnil;
1899   NSMenu *svcs;
1900   id delegate;
1902   check_ns ();
1903   svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1904   [NSApp setServicesMenu: svcs];  /* this and next rebuild on <10.4 */
1905   [NSApp registerServicesMenuSendTypes: ns_send_types
1906                            returnTypes: ns_return_types];
1908 /* On Tiger, services menu updating was made lazier (waits for user to
1909    actually click on the menu), so we have to force things along: */
1910 #ifdef NS_IMPL_COCOA
1911   if (NSAppKitVersionNumber >= 744.0)
1912     {
1913       delegate = [svcs delegate];
1914       if (delegate != nil)
1915         {
1916           if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1917               [delegate menuNeedsUpdate: svcs];
1918           if ([delegate respondsToSelector:
1919                             @selector (menu:updateItem:atIndex:shouldCancel:)])
1920             {
1921               int i, len = [delegate numberOfItemsInMenu: svcs];
1922               for (i =0; i<len; i++)
1923                   [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1924               for (i =0; i<len; i++)
1925                   if (![delegate menu: svcs
1926                            updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1927                               atIndex: i shouldCancel: NO])
1928                     break;
1929             }
1930         }
1931     }
1932 #endif
1934   [svcs setAutoenablesItems: NO];
1935 #ifdef NS_IMPL_COCOA
1936   [svcs update]; /* on OS X, converts from '/' structure */
1937 #endif
1939   ret = interpret_services_menu (svcs, Qnil, ret);
1940   return ret;
1944 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
1945        2, 2, 0,
1946        doc: /* Perform Nextstep SERVICE on SEND.
1947 SEND should be either a string or nil.
1948 The return value is the result of the service, as string, or nil if
1949 there was no result.  */)
1950      (Lisp_Object service, Lisp_Object send)
1952   id pb;
1953   NSString *svcName;
1954   char *utfStr;
1955   int len;
1957   CHECK_STRING (service);
1958   check_ns ();
1960   utfStr = SDATA (service);
1961   svcName = [NSString stringWithUTF8String: utfStr];
1963   pb =[NSPasteboard pasteboardWithUniqueName];
1964   ns_string_to_pasteboard (pb, send);
1966   if (NSPerformService (svcName, pb) == NO)
1967     Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
1969   if ([[pb types] count] == 0)
1970     return build_string ("");
1971   return ns_string_from_pasteboard (pb);
1975 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
1976        Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
1977        doc: /* Return an NFC string that matches the UTF-8 NFD string STR.  */)
1978      (Lisp_Object str)
1980 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
1981          remove this. */
1982   NSString *utfStr;
1984   CHECK_STRING (str);
1985   utfStr = [NSString stringWithUTF8String: SDATA (str)];
1986   if (![utfStr respondsToSelector:
1987                  @selector (precomposedStringWithCanonicalMapping)])
1988     {
1989       message1
1990         ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
1991       return Qnil;
1992     }
1993   else
1994     utfStr = [utfStr precomposedStringWithCanonicalMapping];
1995   return build_string ([utfStr UTF8String]);
1999 #ifdef NS_IMPL_COCOA
2001 /* Compile and execute the AppleScript SCRIPT and return the error
2002    status as function value.  A zero is returned if compilation and
2003    execution is successful, in which case *RESULT is set to a Lisp
2004    string or a number containing the resulting script value.  Otherwise,
2005    1 is returned. */
2006 static int
2007 ns_do_applescript (script, result)
2008      Lisp_Object script, *result;
2010   NSAppleEventDescriptor *desc;
2011   NSDictionary* errorDict;
2012   NSAppleEventDescriptor* returnDescriptor = NULL;
2014   NSAppleScript* scriptObject =
2015     [[NSAppleScript alloc] initWithSource:
2016                              [NSString stringWithUTF8String: SDATA (script)]];
2018   returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2019   [scriptObject release];
2021   *result = Qnil;
2023   if (returnDescriptor != NULL)
2024     {
2025       // successful execution
2026       if (kAENullEvent != [returnDescriptor descriptorType])
2027         {
2028           *result = Qt;
2029           // script returned an AppleScript result
2030           if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2031 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
2032               (typeUTF16ExternalRepresentation
2033                == [returnDescriptor descriptorType]) ||
2034 #endif
2035               (typeUTF8Text == [returnDescriptor descriptorType]) ||
2036               (typeCString == [returnDescriptor descriptorType]))
2037             {
2038               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2039               if (desc)
2040                 *result = build_string([[desc stringValue] UTF8String]);
2041             }
2042           else
2043             {
2044               /* use typeUTF16ExternalRepresentation? */
2045               // coerce the result to the appropriate ObjC type
2046               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2047               if (desc)
2048                 *result = make_number([desc int32Value]);
2049             }
2050         }
2051     }
2052   else
2053     {
2054       // no script result, return error
2055       return 1;
2056     }
2057   return 0;
2060 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2061        doc: /* Execute AppleScript SCRIPT and return the result.
2062 If compilation and execution are successful, the resulting script value
2063 is returned as a string, a number or, in the case of other constructs, t.
2064 In case the execution fails, an error is signaled. */)
2065      (Lisp_Object script)
2067   Lisp_Object result;
2068   long status;
2070   CHECK_STRING (script);
2071   check_ns ();
2073   BLOCK_INPUT;
2074   status = ns_do_applescript (script, &result);
2075   UNBLOCK_INPUT;
2076   if (status == 0)
2077     return result;
2078   else if (!STRINGP (result))
2079     error ("AppleScript error %d", status);
2080   else
2081     error ("%s", SDATA (result));
2083 #endif
2087 /* ==========================================================================
2089     Miscellaneous functions not called through hooks
2091    ========================================================================== */
2094 /* called from image.c */
2095 FRAME_PTR
2096 check_x_frame (Lisp_Object frame)
2098   return check_ns_frame (frame);
2102 /* called from frame.c */
2103 struct ns_display_info *
2104 check_x_display_info (Lisp_Object frame)
2106   return check_ns_display_info (frame);
2110 void
2111 x_set_scroll_bar_default_width (f)
2112      struct frame *f;
2114   int wid = FRAME_COLUMN_WIDTH (f);
2115   FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2116   FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2117                                       wid - 1) / wid;
2121 /* terms impl this instead of x-get-resource directly */
2122 const char *
2123 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2125   /* remove appname prefix; TODO: allow for !="Emacs" */
2126   char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2127   const char *res;
2128   check_ns ();
2130   if (inhibit_x_resources)
2131     /* --quick was passed, so this is a no-op.  */
2132     return NULL;
2134   res = [[[NSUserDefaults standardUserDefaults] objectForKey:
2135             [NSString stringWithUTF8String: toCheck]] UTF8String];
2136   return !res ? NULL :
2137       (!strncasecmp (res, "YES", 3) ? "true" :
2138           (!strncasecmp (res, "NO", 2) ? "false" : res));
2142 Lisp_Object
2143 x_get_focus_frame (struct frame *frame)
2145   struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2146   Lisp_Object nsfocus;
2148   if (!dpyinfo->x_focus_frame)
2149     return Qnil;
2151   XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2152   return nsfocus;
2157 x_pixel_width (struct frame *f)
2159   return FRAME_PIXEL_WIDTH (f);
2164 x_pixel_height (struct frame *f)
2166   return FRAME_PIXEL_HEIGHT (f);
2171 x_char_width (struct frame *f)
2173   return FRAME_COLUMN_WIDTH (f);
2178 x_char_height (struct frame *f)
2180   return FRAME_LINE_HEIGHT (f);
2185 x_screen_planes (struct frame *f)
2187   return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2191 void
2192 x_sync (Lisp_Object frame)
2194   /* XXX Not implemented XXX */
2195   return;
2200 /* ==========================================================================
2202     Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2204    ========================================================================== */
2207 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2208        doc: /* Return t if the current Nextstep display supports the color COLOR.
2209 The optional argument FRAME is currently ignored.  */)
2210      (Lisp_Object color, Lisp_Object frame)
2212   NSColor * col;
2213   check_ns ();
2214   return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2218 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2219        doc: /* Internal function called by `color-values', which see.  */)
2220      (Lisp_Object color, Lisp_Object frame)
2222   NSColor * col;
2223   CGFloat red, green, blue, alpha;
2225   check_ns ();
2226   CHECK_STRING (color);
2228   if (ns_lisp_to_color (color, &col))
2229     return Qnil;
2231   [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2232         getRed: &red green: &green blue: &blue alpha: &alpha];
2233   return list3 (make_number (lrint (red*65280)),
2234                 make_number (lrint (green*65280)),
2235                 make_number (lrint (blue*65280)));
2239 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2240        doc: /* Return t if the Nextstep display supports color.
2241 The optional argument DISPLAY specifies which display to ask about.
2242 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2243 If omitted or nil, that stands for the selected frame's display.  */)
2244      (Lisp_Object display)
2246   NSWindowDepth depth;
2247   NSString *colorSpace;
2248   check_ns ();
2249   depth = [ns_get_screen (display) depth];
2250   colorSpace = NSColorSpaceFromDepth (depth);
2252   return    [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2253          || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2254       ? Qnil : Qt;
2258 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2259        Sx_display_grayscale_p, 0, 1, 0,
2260        doc: /* Return t if the Nextstep display supports shades of gray.
2261 Note that color displays do support shades of gray.
2262 The optional argument DISPLAY specifies which display to ask about.
2263 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2264 If omitted or nil, that stands for the selected frame's display. */)
2265      (Lisp_Object display)
2267   NSWindowDepth depth;
2268   check_ns ();
2269   depth = [ns_get_screen (display) depth];
2271   return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2275 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2276        0, 1, 0,
2277        doc: /* Return the width in pixels of the Nextstep display DISPLAY.
2278 The optional argument DISPLAY specifies which display to ask about.
2279 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2280 If omitted or nil, that stands for the selected frame's display.  */)
2281      (Lisp_Object display)
2283   check_ns ();
2284   return make_number ((int) [ns_get_screen (display) frame].size.width);
2288 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2289        Sx_display_pixel_height, 0, 1, 0,
2290        doc: /* Return the height in pixels of the Nextstep display DISPLAY.
2291 The optional argument DISPLAY specifies which display to ask about.
2292 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2293 If omitted or nil, that stands for the selected frame's display.  */)
2294      (Lisp_Object display)
2296   check_ns ();
2297   return make_number ((int) [ns_get_screen (display) frame].size.height);
2301 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2302        Sns_display_usable_bounds, 0, 1, 0,
2303        doc: /* Return the bounds of the usable part of the screen.
2304 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2305 are the boundaries of the usable part of the screen, excluding areas
2306 reserved for the Mac menu, dock, and so forth.
2308 The screen queried corresponds to DISPLAY, which should be either a
2309 frame, a display name (a string), or terminal ID.  If omitted or nil,
2310 that stands for the selected frame's display. */)
2311      (Lisp_Object display)
2313   int top;
2314   NSScreen *screen;
2315   NSRect vScreen;
2317   check_ns ();
2318   screen = ns_get_screen (display);
2319   if (!screen)
2320     return Qnil;
2322   vScreen = [screen visibleFrame];
2324   /* NS coordinate system is upside-down.
2325      Transform to screen-specific coordinates. */
2326   return list4 (make_number ((int) vScreen.origin.x),
2327                 make_number ((int) [screen frame].size.height
2328                              - vScreen.size.height - vScreen.origin.y),
2329                 make_number ((int) vScreen.size.width),
2330                 make_number ((int) vScreen.size.height));
2334 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2335        0, 1, 0,
2336        doc: /* Return the number of bitplanes of the Nextstep display DISPLAY.
2337 The optional argument DISPLAY specifies which display to ask about.
2338 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2339 If omitted or nil, that stands for the selected frame's display.  */)
2340      (Lisp_Object display)
2342   check_ns ();
2343   return make_number
2344     (NSBitsPerPixelFromDepth ([ns_get_screen (display) depth]));
2348 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2349        Sx_display_color_cells, 0, 1, 0,
2350        doc: /* Returns the number of color cells of the Nextstep display DISPLAY.
2351 The optional argument DISPLAY specifies which display to ask about.
2352 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2353 If omitted or nil, that stands for the selected frame's display.  */)
2354      (Lisp_Object display)
2356   struct ns_display_info *dpyinfo;
2357   check_ns ();
2358   
2359   dpyinfo = check_ns_display_info (display);
2360   /* We force 24+ bit depths to 24-bit to prevent an overflow.  */
2361   return make_number (1 << min (dpyinfo->n_planes, 24));
2365 /* Unused dummy def needed for compatibility. */
2366 Lisp_Object tip_frame;
2368 /* TODO: move to xdisp or similar */
2369 static void
2370 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
2371      struct frame *f;
2372      Lisp_Object parms, dx, dy;
2373      int width, height;
2374      int *root_x, *root_y;
2376   Lisp_Object left, top;
2377   EmacsView *view = FRAME_NS_VIEW (f);
2378   NSPoint pt;
2380   /* Start with user-specified or mouse position.  */
2381   left = Fcdr (Fassq (Qleft, parms));
2382   top = Fcdr (Fassq (Qtop, parms));
2384   if (!INTEGERP (left) || !INTEGERP (top))
2385     {
2386       pt = last_mouse_motion_position;
2387       /* Convert to screen coordinates */
2388       pt = [view convertPoint: pt toView: nil];
2389       pt = [[view window] convertBaseToScreen: pt];
2390     }
2391   else
2392     {
2393       /* Absolute coordinates.  */
2394       pt.x = XINT (left);
2395       pt.y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - XINT (top)
2396         - height;
2397     }
2398   
2399   /* Ensure in bounds.  (Note, screen origin = lower left.) */
2400   if (INTEGERP (left))
2401     *root_x = pt.x;
2402   else if (pt.x + XINT (dx) <= 0)
2403     *root_x = 0; /* Can happen for negative dx */
2404   else if (pt.x + XINT (dx) + width
2405            <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2406     /* It fits to the right of the pointer.  */
2407     *root_x = pt.x + XINT (dx);
2408   else if (width + XINT (dx) <= pt.x)
2409     /* It fits to the left of the pointer.  */
2410     *root_x = pt.x - width - XINT (dx);
2411   else
2412     /* Put it left justified on the screen -- it ought to fit that way.  */
2413     *root_x = 0;
2415   if (INTEGERP (top))
2416     *root_y = pt.y;
2417   else if (pt.y - XINT (dy) - height >= 0)
2418     /* It fits below the pointer.  */
2419     *root_y = pt.y - height - XINT (dy);
2420   else if (pt.y + XINT (dy) + height
2421            <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2422     /* It fits above the pointer */
2423       *root_y = pt.y + XINT (dy);
2424   else
2425     /* Put it on the top.  */
2426     *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2430 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2431        doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2432 A tooltip window is a small window displaying a string.
2434 FRAME nil or omitted means use the selected frame.
2436 PARMS is an optional list of frame parameters which can be used to
2437 change the tooltip's appearance.
2439 Automatically hide the tooltip after TIMEOUT seconds.  TIMEOUT nil
2440 means use the default timeout of 5 seconds.
2442 If the list of frame parameters PARMS contains a `left' parameter,
2443 the tooltip is displayed at that x-position.  Otherwise it is
2444 displayed at the mouse position, with offset DX added (default is 5 if
2445 DX isn't specified).  Likewise for the y-position; if a `top' frame
2446 parameter is specified, it determines the y-position of the tooltip
2447 window, otherwise it is displayed at the mouse position, with offset
2448 DY added (default is -10).
2450 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2451 Text larger than the specified size is clipped.  */)
2452      (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
2454   int root_x, root_y;
2455   struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2456   int count = SPECPDL_INDEX ();
2457   struct frame *f;
2458   char *str;
2459   NSSize size;
2461   specbind (Qinhibit_redisplay, Qt);
2463   GCPRO4 (string, parms, frame, timeout);
2465   CHECK_STRING (string);
2466   str = SDATA (string);
2467   f = check_x_frame (frame);
2468   if (NILP (timeout))
2469     timeout = make_number (5);
2470   else
2471     CHECK_NATNUM (timeout);
2473   if (NILP (dx))
2474     dx = make_number (5);
2475   else
2476     CHECK_NUMBER (dx);
2478   if (NILP (dy))
2479     dy = make_number (-10);
2480   else
2481     CHECK_NUMBER (dy);
2483   BLOCK_INPUT;
2484   if (ns_tooltip == nil)
2485     ns_tooltip = [[EmacsTooltip alloc] init];
2486   else
2487     Fx_hide_tip ();
2489   [ns_tooltip setText: str];
2490   size = [ns_tooltip frame].size;
2492   /* Move the tooltip window where the mouse pointer is.  Resize and
2493      show it.  */
2494   compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2495                   &root_x, &root_y);
2497   [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2498   UNBLOCK_INPUT;
2500   UNGCPRO;
2501   return unbind_to (count, Qnil);
2505 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2506        doc: /* Hide the current tooltip window, if there is any.
2507 Value is t if tooltip was open, nil otherwise.  */)
2508      (void)
2510   if (ns_tooltip == nil || ![ns_tooltip isActive])
2511     return Qnil;
2512   [ns_tooltip hide];
2513   return Qt;
2517 /* ==========================================================================
2519     Class implementations
2521    ========================================================================== */
2524 @implementation EmacsSavePanel
2525 #ifdef NS_IMPL_COCOA
2526 /* --------------------------------------------------------------------------
2527    These are overridden to intercept on OS X: ending panel restarts NSApp
2528    event loop if it is stopped.  Not sure if this is correct behavior,
2529    perhaps should check if running and if so send an appdefined.
2530    -------------------------------------------------------------------------- */
2531 - (void) ok: (id)sender
2533   [super ok: sender];
2534   panelOK = 1;
2535   [NSApp stop: self];
2537 - (void) cancel: (id)sender
2539   [super cancel: sender];
2540   [NSApp stop: self];
2542 #endif
2543 @end
2546 @implementation EmacsOpenPanel
2547 #ifdef NS_IMPL_COCOA
2548 /* --------------------------------------------------------------------------
2549    These are overridden to intercept on OS X: ending panel restarts NSApp
2550    event loop if it is stopped.  Not sure if this is correct behavior,
2551    perhaps should check if running and if so send an appdefined.
2552    -------------------------------------------------------------------------- */
2553 - (void) ok: (id)sender
2555   [super ok: sender];
2556   panelOK = 1;
2557   [NSApp stop: self];
2559 - (void) cancel: (id)sender
2561   [super cancel: sender];
2562   [NSApp stop: self];
2564 #endif
2565 @end
2568 @implementation EmacsFileDelegate
2569 /* --------------------------------------------------------------------------
2570    Delegate methods for Open/Save panels
2571    -------------------------------------------------------------------------- */
2572 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2574   return YES;
2576 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2578   return YES;
2580 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2581           confirmed: (BOOL)okFlag
2583   return filename;
2585 @end
2587 #endif
2590 /* ==========================================================================
2592     Lisp interface declaration
2594    ========================================================================== */
2597 void
2598 syms_of_nsfns ()
2600   int i;
2602   Qfontsize = intern ("fontsize");
2603   staticpro (&Qfontsize);
2605   DEFVAR_LISP ("ns-icon-type-alist", &Vns_icon_type_alist,
2606                doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2607 If the title of a frame matches REGEXP, then IMAGE.tiff is
2608 selected as the image of the icon representing the frame when it's
2609 miniaturized.  If an element is t, then Emacs tries to select an icon
2610 based on the filetype of the visited file.
2612 The images have to be installed in a folder called English.lproj in the
2613 Emacs folder.  You have to restart Emacs after installing new icons.
2615 Example: Install an icon Gnus.tiff and execute the following code
2617   (setq ns-icon-type-alist
2618         (append ns-icon-type-alist
2619                 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2620                    . \"Gnus\"))))
2622 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2623 be used as the image of the icon representing the frame.  */);
2624   Vns_icon_type_alist = Fcons (Qt, Qnil);
2626   DEFVAR_LISP ("ns-version-string", &Vns_version_string,
2627                doc: /* Toolkit version for NS Windowing.  */);
2628   Vns_version_string = ns_appkit_version_str ();
2630   defsubr (&Sns_read_file_name);
2631   defsubr (&Sns_get_resource);
2632   defsubr (&Sns_set_resource);
2633   defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2634   defsubr (&Sx_display_grayscale_p);
2635   defsubr (&Sns_font_name);
2636   defsubr (&Sns_list_colors);
2637 #ifdef NS_IMPL_COCOA
2638   defsubr (&Sns_do_applescript);
2639 #endif
2640   defsubr (&Sxw_color_defined_p);
2641   defsubr (&Sxw_color_values);
2642   defsubr (&Sx_server_max_request_size);
2643   defsubr (&Sx_server_vendor);
2644   defsubr (&Sx_server_version);
2645   defsubr (&Sx_display_pixel_width);
2646   defsubr (&Sx_display_pixel_height);
2647   defsubr (&Sns_display_usable_bounds);
2648   defsubr (&Sx_display_mm_width);
2649   defsubr (&Sx_display_mm_height);
2650   defsubr (&Sx_display_screens);
2651   defsubr (&Sx_display_planes);
2652   defsubr (&Sx_display_color_cells);
2653   defsubr (&Sx_display_visual_class);
2654   defsubr (&Sx_display_backing_store);
2655   defsubr (&Sx_display_save_under);
2656   defsubr (&Sx_create_frame);
2657   defsubr (&Sx_open_connection);
2658   defsubr (&Sx_close_connection);
2659   defsubr (&Sx_display_list);
2661   defsubr (&Sns_hide_others);
2662   defsubr (&Sns_hide_emacs);
2663   defsubr (&Sns_emacs_info_panel);
2664   defsubr (&Sns_list_services);
2665   defsubr (&Sns_perform_service);
2666   defsubr (&Sns_convert_utf8_nfd_to_nfc);
2667   defsubr (&Sx_focus_frame);
2668   defsubr (&Sns_popup_font_panel);
2669   defsubr (&Sns_popup_color_panel);
2671   defsubr (&Sx_show_tip);
2672   defsubr (&Sx_hide_tip);
2674   /* used only in fontset.c */
2675   check_window_system_func = check_ns;
2679 // arch-tag: dc2a3f74-1123-4daa-8eed-fb78db6a5642