1 /* Functions for the NeXT/Open/GNUstep and MacOSX window system.
3 Copyright (C) 1989, 1992-1994, 2005-2006, 2008-2011
4 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
22 Originally by Carl Edman
23 Updated by Christian Limpach (chris@nice.ch)
24 OpenStep/Rhapsody port by Scott Bender (sbender@harmony-ds.com)
25 MacOSX/Aqua port by Christophe de Dinechin (descubes@earthlink.net)
26 GNUstep port and post-20 update by Adrian Robert (arobert@cogsci.ucsd.edu)
29 /* This should be the first include, as it may set up #defines affecting
30 interpretation of even the system includes. */
38 #include "blockinput.h"
43 #include "termhooks.h"
45 #include "character.h"
49 int fns_trace_num = 1;
50 #define NSTRACE(x) fprintf (stderr, "%s:%d: [%d] " #x "\n", \
51 __FILE__, __LINE__, ++fns_trace_num)
58 extern NSArray *ns_send_types, *ns_return_types, *ns_drag_types;
60 extern Lisp_Object Qforeground_color;
61 extern Lisp_Object Qbackground_color;
62 extern Lisp_Object Qcursor_color;
63 extern Lisp_Object Qinternal_border_width;
64 extern Lisp_Object Qvisibility;
65 extern Lisp_Object Qcursor_type;
66 extern Lisp_Object Qicon_type;
67 extern Lisp_Object Qicon_name;
68 extern Lisp_Object Qicon_left;
69 extern Lisp_Object Qicon_top;
70 extern Lisp_Object Qleft;
71 extern Lisp_Object Qright;
72 extern Lisp_Object Qtop;
73 extern Lisp_Object Qdisplay;
74 extern Lisp_Object Qvertical_scroll_bars;
75 extern Lisp_Object Qauto_raise;
76 extern Lisp_Object Qauto_lower;
77 extern Lisp_Object Qbox;
78 extern Lisp_Object Qscroll_bar_width;
79 extern Lisp_Object Qx_resource_name;
80 extern Lisp_Object Qface_set_after_frame_default;
81 extern Lisp_Object Qunderline, Qundefined;
82 extern Lisp_Object Qheight, Qminibuffer, Qname, Qonly, Qwidth;
83 extern Lisp_Object Qunsplittable, Qmenu_bar_lines, Qbuffer_predicate, Qtitle;
84 extern Lisp_Object Qnone;
87 Lisp_Object Qbuffered;
88 Lisp_Object Qfontsize;
90 /* hack for OS X file panels */
93 EmacsTooltip *ns_tooltip;
95 /* Need forward declaration here to preserve organizational integrity of file */
96 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
98 extern BOOL ns_in_resize;
100 /* Static variables to handle applescript execution. */
101 static Lisp_Object as_script, *as_result;
102 static int as_status;
105 static ptrdiff_t image_cache_refcount;
108 /* ==========================================================================
110 Internal utility functions
112 ========================================================================== */
119 error ("OpenStep is not in use or not initialized");
123 /* Nonzero if we can use mouse menus. */
131 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
132 and checking validity for NS. */
134 check_ns_frame (Lisp_Object frame)
139 f = SELECTED_FRAME ();
142 CHECK_LIVE_FRAME (frame);
145 if (! FRAME_NS_P (f))
146 error ("non-Nextstep frame used");
151 /* Let the user specify an Nextstep display with a frame.
152 nil stands for the selected frame--or, if that is not an Nextstep frame,
153 the first Nextstep display on the list. */
154 static struct ns_display_info *
155 check_ns_display_info (Lisp_Object frame)
159 struct frame *f = SELECTED_FRAME ();
160 if (FRAME_NS_P (f) && FRAME_LIVE_P (f) )
161 return FRAME_NS_DISPLAY_INFO (f);
162 else if (x_display_list != 0)
163 return x_display_list;
165 error ("Nextstep windows are not in use or not initialized");
167 else if (INTEGERP (frame))
169 struct terminal *t = get_terminal (frame, 1);
171 if (t->type != output_ns)
172 error ("Terminal %"pI"d is not a Nextstep display", XINT (frame));
174 return t->display_info.ns;
176 else if (STRINGP (frame))
177 return ns_display_info_for_name (frame);
182 CHECK_LIVE_FRAME (frame);
184 if (! FRAME_NS_P (f))
185 error ("non-Nextstep frame used");
186 return FRAME_NS_DISPLAY_INFO (f);
188 return NULL; /* shut compiler up */
193 ns_get_window (Lisp_Object maybeFrame)
195 id view =nil, window =nil;
197 if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
198 maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
200 if (!NILP (maybeFrame))
201 view = FRAME_NS_VIEW (XFRAME (maybeFrame));
202 if (view) window =[view window];
209 ns_get_screen (Lisp_Object screen)
212 struct terminal *terminal;
214 if (EQ (Qt, screen)) /* not documented */
215 return [NSScreen mainScreen];
217 terminal = get_terminal (screen, 1);
218 if (terminal->type != output_ns)
222 f = SELECTED_FRAME ();
223 else if (FRAMEP (screen))
227 struct ns_display_info *dpyinfo = terminal->display_info.ns;
228 f = dpyinfo->x_focus_frame
229 ? dpyinfo->x_focus_frame : dpyinfo->x_highlight_frame;
232 return ((f && FRAME_NS_P (f)) ? [[FRAME_NS_VIEW (f) window] screen]
237 /* Return the X display structure for the display named NAME.
238 Open a new connection if necessary. */
239 struct ns_display_info *
240 ns_display_info_for_name (Lisp_Object name)
243 struct ns_display_info *dpyinfo;
247 for (dpyinfo = x_display_list, names = ns_display_name_list;
249 dpyinfo = dpyinfo->next, names = XCDR (names))
252 tem = Fstring_equal (XCAR (XCAR (names)), name);
257 error ("Emacs for OpenStep does not yet support multi-display.");
259 Fx_open_connection (name, Qnil, Qnil);
260 dpyinfo = x_display_list;
263 error ("OpenStep on %s not responding.\n", SDATA (name));
270 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
271 /* --------------------------------------------------------------------------
272 Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
273 -------------------------------------------------------------------------- */
283 count = [menu numberOfItems];
284 for (i = 0; i<count; i++)
286 item = [menu itemAtIndex: i];
287 name = [[item title] UTF8String];
290 nameStr = build_string (name);
292 if ([item hasSubmenu])
294 old = interpret_services_menu ([item submenu],
295 Fcons (nameStr, prefix), old);
299 keys = [item keyEquivalent];
300 if (keys && [keys length] )
302 key = [keys characterAtIndex: 0];
303 res = make_number (key|super_modifier);
309 old = Fcons (Fcons (res,
310 Freverse (Fcons (nameStr,
320 /* ==========================================================================
322 Frame parameter setters
324 ========================================================================== */
328 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
331 CGFloat r, g, b, alpha;
333 if (ns_lisp_to_color (arg, &col))
335 store_frame_param (f, Qforeground_color, oldval);
336 error ("Unknown color");
340 [f->output_data.ns->foreground_color release];
341 f->output_data.ns->foreground_color = col;
343 [col getRed: &r green: &g blue: &b alpha: &alpha];
344 FRAME_FOREGROUND_PIXEL (f) =
345 ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
347 if (FRAME_NS_VIEW (f))
349 update_face_from_frame_parameter (f, Qforeground_color, arg);
350 /*recompute_basic_faces (f); */
351 if (FRAME_VISIBLE_P (f))
358 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
362 NSView *view = FRAME_NS_VIEW (f);
363 CGFloat r, g, b, alpha;
365 if (ns_lisp_to_color (arg, &col))
367 store_frame_param (f, Qbackground_color, oldval);
368 error ("Unknown color");
371 /* clear the frame; in some instances the NS-internal GC appears not to
372 update, or it does update and cannot clear old text properly */
373 if (FRAME_VISIBLE_P (f))
377 [f->output_data.ns->background_color release];
378 f->output_data.ns->background_color = col;
380 [col getRed: &r green: &g blue: &b alpha: &alpha];
381 FRAME_BACKGROUND_PIXEL (f) =
382 ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
386 [[view window] setBackgroundColor: col];
389 [[view window] setOpaque: NO];
391 [[view window] setOpaque: YES];
393 face = FRAME_DEFAULT_FACE (f);
396 col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
398 = (EMACS_UINT) [[col colorWithAlphaComponent: alpha] retain];
401 update_face_from_frame_parameter (f, Qbackground_color, arg);
404 if (FRAME_VISIBLE_P (f))
411 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
415 if (ns_lisp_to_color (arg, &col))
417 store_frame_param (f, Qcursor_color, oldval);
418 error ("Unknown color");
421 [FRAME_CURSOR_COLOR (f) release];
422 FRAME_CURSOR_COLOR (f) = [col retain];
424 if (FRAME_VISIBLE_P (f))
426 x_update_cursor (f, 0);
427 x_update_cursor (f, 1);
429 update_face_from_frame_parameter (f, Qcursor_color, arg);
434 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
436 NSView *view = FRAME_NS_VIEW (f);
437 NSTRACE (x_set_icon_name);
442 /* see if it's changed */
445 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
448 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
455 if (!NILP (f->title))
458 /* explicit name and no icon-name -> explicit_name */
459 if (f->explicit_name)
463 /* no explicit name and no icon-name ->
464 name has to be rebuild from icon_title_format */
465 windows_or_buffers_changed++;
470 /* Don't change the name if it's already NAME. */
471 if ([[view window] miniwindowTitle] &&
472 ([[[view window] miniwindowTitle]
473 isEqualToString: [NSString stringWithUTF8String:
477 [[view window] setMiniwindowTitle:
478 [NSString stringWithUTF8String: SDATA (arg)]];
482 ns_set_name_internal (FRAME_PTR f, Lisp_Object name)
485 Lisp_Object encoded_name, encoded_icon_name;
487 NSView *view = FRAME_NS_VIEW (f);
490 encoded_name = ENCODE_UTF_8 (name);
493 str = [NSString stringWithUTF8String: SDATA (encoded_name)];
495 /* Don't change the name if it's already NAME. */
496 if (! [[[view window] title] isEqualToString: str])
497 [[view window] setTitle: str];
499 if (!STRINGP (f->icon_name))
500 encoded_icon_name = encoded_name;
502 encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
504 str = [NSString stringWithUTF8String: SDATA (encoded_icon_name)];
506 if ([[view window] miniwindowTitle] &&
507 ! [[[view window] miniwindowTitle] isEqualToString: str])
508 [[view window] setMiniwindowTitle: str];
513 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
516 NSTRACE (ns_set_name);
521 /* Make sure that requests from lisp code override requests from
522 Emacs redisplay code. */
525 /* If we're switching from explicit to implicit, we had better
526 update the mode lines and thereby update the title. */
527 if (f->explicit_name && NILP (name))
528 update_mode_lines = 1;
530 f->explicit_name = ! NILP (name);
532 else if (f->explicit_name)
536 name = build_string([ns_app_name UTF8String]);
540 /* Don't change the name if it's already NAME. */
541 if (! NILP (Fstring_equal (name, f->name)))
546 /* title overrides explicit name */
547 if (! NILP (f->title))
550 ns_set_name_internal (f, name);
554 /* This function should be called when the user's lisp code has
555 specified a name for the frame; the name will override any set by the
558 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
560 NSTRACE (x_explicitly_set_name);
561 ns_set_name (f, arg, 1);
565 /* This function should be called by Emacs redisplay code to set the
566 name; names set this way will never override names set by the user's
569 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
571 NSTRACE (x_implicitly_set_name);
573 /* Deal with NS specific format t. */
574 if (FRAME_NS_P (f) && ((FRAME_ICONIFIED_P (f) && EQ (Vicon_title_format, Qt))
575 || EQ (Vframe_title_format, Qt)))
576 ns_set_name_as_filename (f);
578 ns_set_name (f, arg, 0);
582 /* Change the title of frame F to NAME.
583 If NAME is nil, use the frame name as the title. */
586 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
588 NSTRACE (x_set_title);
589 /* Don't change the title if it's already NAME. */
590 if (EQ (name, f->title))
593 update_mode_lines = 1;
602 ns_set_name_internal (f, name);
607 ns_set_name_as_filename (struct frame *f)
610 Lisp_Object name, filename;
611 Lisp_Object buf = XWINDOW (f->selected_window)->buffer;
613 NSAutoreleasePool *pool;
615 Lisp_Object encoded_name, encoded_filename;
617 NSTRACE (ns_set_name_as_filename);
619 if (f->explicit_name || ! NILP (f->title) || ns_in_resize)
623 pool = [[NSAutoreleasePool alloc] init];
624 filename = BVAR (XBUFFER (buf), filename);
625 name = BVAR (XBUFFER (buf), name);
629 if (! NILP (filename))
630 name = Ffile_name_nondirectory (filename);
632 name = build_string ([ns_app_name UTF8String]);
636 encoded_name = ENCODE_UTF_8 (name);
639 view = FRAME_NS_VIEW (f);
641 title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
642 : [[[view window] title] UTF8String];
644 if (title && (! strcmp (title, SDATA (encoded_name))))
651 str = [NSString stringWithUTF8String: SDATA (encoded_name)];
652 if (str == nil) str = @"Bad coding";
654 if (FRAME_ICONIFIED_P (f))
655 [[view window] setMiniwindowTitle: str];
660 if (! NILP (filename))
663 encoded_filename = ENCODE_UTF_8 (filename);
666 fstr = [NSString stringWithUTF8String: SDATA (encoded_filename)];
667 if (fstr == nil) fstr = @"";
669 /* work around a bug observed on 10.3 and later where
670 setTitleWithRepresentedFilename does not clear out previous state
671 if given filename does not exist */
672 if (! [[NSFileManager defaultManager] fileExistsAtPath: fstr])
673 [[view window] setRepresentedFilename: @""];
679 [[view window] setRepresentedFilename: fstr];
680 [[view window] setTitle: str];
690 ns_set_doc_edited (struct frame *f, Lisp_Object arg)
692 NSView *view = FRAME_NS_VIEW (f);
693 NSAutoreleasePool *pool;
694 if (!MINI_WINDOW_P (XWINDOW (f->selected_window)))
697 pool = [[NSAutoreleasePool alloc] init];
698 [[view window] setDocumentEdited: !NILP (arg)];
706 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
709 int olines = FRAME_MENU_BAR_LINES (f);
710 if (FRAME_MINIBUF_ONLY_P (f))
713 if (TYPE_RANGED_INTEGERP (int, value))
714 nlines = XINT (value);
718 FRAME_MENU_BAR_LINES (f) = 0;
721 FRAME_EXTERNAL_MENU_BAR (f) = 1;
722 /* does for all frames, whereas we just want for one frame
723 [NSMenu setMenuBarVisible: YES]; */
727 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
728 free_frame_menubar (f);
729 /* [NSMenu setMenuBarVisible: NO]; */
730 FRAME_EXTERNAL_MENU_BAR (f) = 0;
735 /* toolbar support */
737 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
740 Lisp_Object root_window;
742 if (FRAME_MINIBUF_ONLY_P (f))
745 if (RANGED_INTEGERP (0, value, INT_MAX))
746 nlines = XFASTINT (value);
752 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
753 update_frame_tool_bar (f);
757 if (FRAME_EXTERNAL_TOOL_BAR (f))
759 free_frame_tool_bar (f);
760 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
764 x_set_window_size (f, 0, f->text_cols, f->text_lines);
769 ns_implicitly_set_icon_type (struct frame *f)
772 EmacsView *view = FRAME_NS_VIEW (f);
774 Lisp_Object chain, elt;
775 NSAutoreleasePool *pool;
778 NSTRACE (ns_implicitly_set_icon_type);
781 pool = [[NSAutoreleasePool alloc] init];
782 if (f->output_data.ns->miniimage
783 && [[NSString stringWithUTF8String: SDATA (f->name)]
784 isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
791 tem = assq_no_quit (Qicon_type, f->param_alist);
792 if (CONSP (tem) && ! NILP (XCDR (tem)))
799 for (chain = Vns_icon_type_alist;
800 (image = nil) && CONSP (chain);
801 chain = XCDR (chain))
804 /* special case: 't' means go by file type */
805 if (SYMBOLP (elt) && EQ (elt, Qt) && SDATA (f->name)[0] == '/')
808 = [NSString stringWithUTF8String: SDATA (f->name)];
809 if ([[NSFileManager defaultManager] fileExistsAtPath: str])
810 image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
812 else if (CONSP (elt) &&
813 STRINGP (XCAR (elt)) &&
814 STRINGP (XCDR (elt)) &&
815 fast_string_match (XCAR (elt), f->name) >= 0)
817 image = [EmacsImage allocInitFromFile: XCDR (elt)];
819 image = [[NSImage imageNamed:
820 [NSString stringWithUTF8String:
821 SDATA (XCDR (elt))]] retain];
827 image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
831 [f->output_data.ns->miniimage release];
832 f->output_data.ns->miniimage = image;
833 [view setMiniwindowImage: setMini];
840 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
842 EmacsView *view = FRAME_NS_VIEW (f);
846 NSTRACE (x_set_icon_type);
848 if (!NILP (arg) && SYMBOLP (arg))
850 arg =build_string (SDATA (SYMBOL_NAME (arg)));
851 store_frame_param (f, Qicon_type, arg);
854 /* do it the implicit way */
857 ns_implicitly_set_icon_type (f);
863 image = [EmacsImage allocInitFromFile: arg];
865 image =[NSImage imageNamed: [NSString stringWithUTF8String:
870 image = [NSImage imageNamed: @"text"];
874 f->output_data.ns->miniimage = image;
875 [view setMiniwindowImage: setMini];
879 /* Xism; we stub out (we do implement this in ns-win.el) */
881 XParseGeometry (char *string, int *x, int *y,
882 unsigned int *width, unsigned int *height)
884 message1 ("Warning: XParseGeometry not supported under NS.\n");
889 /* TODO: move to nsterm? */
891 ns_lisp_to_cursor_type (Lisp_Object arg)
894 if (XTYPE (arg) == Lisp_String)
896 else if (XTYPE (arg) == Lisp_Symbol)
897 str = SDATA (SYMBOL_NAME (arg));
899 if (!strcmp (str, "box")) return FILLED_BOX_CURSOR;
900 if (!strcmp (str, "hollow")) return HOLLOW_BOX_CURSOR;
901 if (!strcmp (str, "hbar")) return HBAR_CURSOR;
902 if (!strcmp (str, "bar")) return BAR_CURSOR;
903 if (!strcmp (str, "no")) return NO_CURSOR;
909 ns_cursor_type_to_lisp (int arg)
913 case FILLED_BOX_CURSOR: return Qbox;
914 case HOLLOW_BOX_CURSOR: return intern ("hollow");
915 case HBAR_CURSOR: return intern ("hbar");
916 case BAR_CURSOR: return intern ("bar");
918 default: return intern ("no");
922 /* This is the same as the xfns.c definition. */
924 x_set_cursor_type (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
926 set_frame_cursor_types (f, arg);
928 /* Make sure the cursor gets redrawn. */
929 cursor_type_changed = 1;
933 /* called to set mouse pointer color, but all other terms use it to
934 initialize pointer types (and don't set the color ;) */
936 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
938 /* don't think we can do this on Nextstep */
943 #define Xstr(x) Str(x)
946 ns_appkit_version_str (void)
950 #ifdef NS_IMPL_GNUSTEP
951 sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
952 #elif defined(NS_IMPL_COCOA)
953 sprintf(tmp, "apple-appkit-%.2f", NSAppKitVersionNumber);
957 return build_string (tmp);
961 /* This is for use by x-server-version and collapses all version info we
962 have into a single int. For a better picture of the implementation
963 running, use ns_appkit_version_str.*/
965 ns_appkit_version_int (void)
967 #ifdef NS_IMPL_GNUSTEP
968 return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GUI_MINOR_VERSION;
969 #elif defined(NS_IMPL_COCOA)
970 return (int)NSAppKitVersionNumber;
977 x_icon (struct frame *f, Lisp_Object parms)
978 /* --------------------------------------------------------------------------
979 Strangely-named function to set icon position parameters in frame.
980 This is irrelevant under OS X, but might be needed under GNUstep,
981 depending on the window manager used. Note, this is not a standard
982 frame parameter-setter; it is called directly from x-create-frame.
983 -------------------------------------------------------------------------- */
985 Lisp_Object icon_x, icon_y;
986 struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
988 f->output_data.ns->icon_top = Qnil;
989 f->output_data.ns->icon_left = Qnil;
991 /* Set the position of the icon. */
992 icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
993 icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
994 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
996 CHECK_NUMBER (icon_x);
997 CHECK_NUMBER (icon_y);
998 f->output_data.ns->icon_top = icon_y;
999 f->output_data.ns->icon_left = icon_x;
1001 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
1002 error ("Both left and top icon corners of icon must be specified");
1006 /* Note: see frame.c for template, also where generic functions are impl */
1007 frame_parm_handler ns_frame_parm_handlers[] =
1009 x_set_autoraise, /* generic OK */
1010 x_set_autolower, /* generic OK */
1011 x_set_background_color,
1012 0, /* x_set_border_color, may be impossible under Nextstep */
1013 0, /* x_set_border_width, may be impossible under Nextstep */
1016 x_set_font, /* generic OK */
1017 x_set_foreground_color,
1020 x_set_internal_border_width, /* generic OK */
1021 x_set_menu_bar_lines,
1023 x_explicitly_set_name,
1024 x_set_scroll_bar_width, /* generic OK */
1026 x_set_unsplittable, /* generic OK */
1027 x_set_vertical_scroll_bars, /* generic OK */
1028 x_set_visibility, /* generic OK */
1029 x_set_tool_bar_lines,
1030 0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
1031 0, /* x_set_scroll_bar_background, will ignore (not possible on NS) */
1032 x_set_screen_gamma, /* generic OK */
1033 x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
1034 x_set_fringe_width, /* generic OK */
1035 x_set_fringe_width, /* generic OK */
1036 0, /* x_set_wait_for_wm, will ignore */
1037 0, /* x_set_fullscreen will ignore */
1038 x_set_font_backend, /* generic OK */
1040 0, /* x_set_sticky */
1041 0, /* x_set_tool_bar_position */
1045 /* Handler for signals raised during x_create_frame.
1046 FRAME is the frame which is partially constructed. */
1049 unwind_create_frame (Lisp_Object frame)
1051 struct frame *f = XFRAME (frame);
1053 /* If frame is already dead, nothing to do. This can happen if the
1054 display is disconnected after the frame has become official, but
1055 before x_create_frame removes the unwind protect. */
1056 if (!FRAME_LIVE_P (f))
1059 /* If frame is ``official'', nothing to do. */
1060 if (NILP (Fmemq (frame, Vframe_list)))
1062 #if GLYPH_DEBUG && XASSERTS
1063 struct ns_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1066 x_free_frame_resources (f);
1070 /* Check that reference counts are indeed correct. */
1071 xassert (dpyinfo->terminal->image_cache->refcount == image_cache_refcount);
1080 * Read geometry related parameters from preferences if not in PARMS.
1081 * Returns the union of parms and any preferences read.
1085 get_geometry_from_preferences (struct ns_display_info *dpyinfo,
1093 { "width", "Width", Qwidth },
1094 { "height", "Height", Qheight },
1095 { "left", "Left", Qleft },
1096 { "top", "Top", Qtop },
1100 for (i = 0; i < sizeof (r)/sizeof (r[0]); ++i)
1102 if (NILP (Fassq (r[i].tem, parms)))
1105 = x_get_arg (dpyinfo, parms, r[i].tem, r[i].val, r[i].cls,
1107 if (! EQ (value, Qunbound))
1108 parms = Fcons (Fcons (r[i].tem, value), parms);
1115 /* ==========================================================================
1119 ========================================================================== */
1121 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1123 doc: /* Make a new Nextstep window, called a "frame" in Emacs terms.
1124 Return an Emacs frame object.
1125 PARMS is an alist of frame parameters.
1126 If the parameters specify that the frame should not have a minibuffer,
1127 and do not specify a specific minibuffer window to use,
1128 then `default-minibuffer-frame' must be a frame whose minibuffer can
1129 be shared by the new frame.
1131 This function is an internal primitive--use `make-frame' instead. */)
1135 Lisp_Object frame, tem;
1137 int minibuffer_only = 0;
1138 int window_prompting = 0;
1140 ptrdiff_t count = specpdl_ptr - specpdl;
1141 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1142 Lisp_Object display;
1143 struct ns_display_info *dpyinfo = NULL;
1146 Lisp_Object tfont, tfontsize;
1147 static int desc_ctr = 1;
1151 /* x_get_arg modifies parms. */
1152 parms = Fcopy_alist (parms);
1154 /* Use this general default value to start with
1155 until we know if this frame has a specified name. */
1156 Vx_resource_name = Vinvocation_name;
1158 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1159 if (EQ (display, Qunbound))
1161 dpyinfo = check_ns_display_info (display);
1162 kb = dpyinfo->terminal->kboard;
1164 if (!dpyinfo->terminal->name)
1165 error ("Terminal is not live, can't create new frames on it");
1167 name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1169 && ! EQ (name, Qunbound)
1171 error ("Invalid frame name--not a string or nil");
1174 Vx_resource_name = name;
1176 parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1177 if (EQ (parent, Qunbound))
1179 if (! NILP (parent))
1180 CHECK_NUMBER (parent);
1182 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
1183 /* No need to protect DISPLAY because that's not used after passing
1184 it to make_frame_without_minibuffer. */
1186 GCPRO4 (parms, parent, name, frame);
1187 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1189 if (EQ (tem, Qnone) || NILP (tem))
1190 f = make_frame_without_minibuffer (Qnil, kb, display);
1191 else if (EQ (tem, Qonly))
1193 f = make_minibuffer_frame ();
1194 minibuffer_only = 1;
1196 else if (WINDOWP (tem))
1197 f = make_frame_without_minibuffer (tem, kb, display);
1201 XSETFRAME (frame, f);
1202 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
1204 f->terminal = dpyinfo->terminal;
1206 f->output_method = output_ns;
1207 f->output_data.ns = (struct ns_output *)xmalloc (sizeof *(f->output_data.ns));
1208 memset (f->output_data.ns, 0, sizeof *(f->output_data.ns));
1210 FRAME_FONTSET (f) = -1;
1212 f->icon_name = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
1214 if (! STRINGP (f->icon_name))
1215 f->icon_name = Qnil;
1217 FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1219 /* With FRAME_NS_DISPLAY_INFO set up, this unwind-protect is safe. */
1220 record_unwind_protect (unwind_create_frame, frame);
1222 f->output_data.ns->window_desc = desc_ctr++;
1223 if (TYPE_RANGED_INTEGERP (Window, parent))
1225 f->output_data.ns->parent_desc = XFASTINT (parent);
1226 f->output_data.ns->explicit_parent = 1;
1230 f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1231 f->output_data.ns->explicit_parent = 0;
1234 /* Set the name; the functions to which we pass f expect the name to
1236 if (EQ (name, Qunbound) || NILP (name) || ! STRINGP (name))
1238 f->name = build_string ([ns_app_name UTF8String]);
1239 f->explicit_name = 0;
1244 f->explicit_name = 1;
1245 specbind (Qx_resource_name, name);
1248 f->resx = dpyinfo->resx;
1249 f->resy = dpyinfo->resy;
1252 register_font_driver (&nsfont_driver, f);
1253 x_default_parameter (f, parms, Qfont_backend, Qnil,
1254 "fontBackend", "FontBackend", RES_TYPE_STRING);
1257 /* use for default font name */
1258 id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1259 tfontsize = x_default_parameter (f, parms, Qfontsize,
1260 make_number (0 /*(int)[font pointSize]*/),
1261 "fontSize", "FontSize", RES_TYPE_NUMBER);
1262 tfont = x_default_parameter (f, parms, Qfont,
1263 build_string ([[font fontName] UTF8String]),
1264 "font", "Font", RES_TYPE_STRING);
1268 x_default_parameter (f, parms, Qborder_width, make_number (0),
1269 "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1270 x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1271 "internalBorderWidth", "InternalBorderWidth",
1274 /* default scrollbars on right on Mac */
1277 #ifdef NS_IMPL_GNUSTEP
1282 x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1283 "verticalScrollBars", "VerticalScrollBars",
1286 x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1287 "foreground", "Foreground", RES_TYPE_STRING);
1288 x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1289 "background", "Background", RES_TYPE_STRING);
1290 /* FIXME: not suppported yet in Nextstep */
1291 x_default_parameter (f, parms, Qline_spacing, Qnil,
1292 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1293 x_default_parameter (f, parms, Qleft_fringe, Qnil,
1294 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1295 x_default_parameter (f, parms, Qright_fringe, Qnil,
1296 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1299 image_cache_refcount =
1300 FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
1303 init_frame_faces (f);
1305 /* The resources controlling the menu-bar and tool-bar are
1306 processed specially at startup, and reflected in the mode
1307 variables; ignore them here. */
1308 x_default_parameter (f, parms, Qmenu_bar_lines,
1309 NILP (Vmenu_bar_mode)
1310 ? make_number (0) : make_number (1),
1311 NULL, NULL, RES_TYPE_NUMBER);
1312 x_default_parameter (f, parms, Qtool_bar_lines,
1313 NILP (Vtool_bar_mode)
1314 ? make_number (0) : make_number (1),
1315 NULL, NULL, RES_TYPE_NUMBER);
1317 x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1318 "BufferPredicate", RES_TYPE_SYMBOL);
1319 x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1322 parms = get_geometry_from_preferences (dpyinfo, parms);
1323 window_prompting = x_figure_window_size (f, parms, 1);
1325 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1326 f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1328 /* NOTE: on other terms, this is done in set_mouse_color, however this
1329 was not getting called under Nextstep */
1330 f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1331 f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1332 f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1333 f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1334 f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1335 f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1336 FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1337 = [NSCursor arrowCursor];
1338 f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1340 [[EmacsView alloc] initFrameFromEmacs: f];
1344 /* ns_display_info does not have a reference_count. */
1345 f->terminal->reference_count++;
1347 /* It is now ok to make the frame official even if we get an error below.
1348 The frame needs to be on Vframe_list or making it visible won't work. */
1349 Vframe_list = Fcons (frame, Vframe_list);
1351 x_default_parameter (f, parms, Qicon_type, Qnil,
1352 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
1354 x_default_parameter (f, parms, Qauto_raise, Qnil,
1355 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
1356 x_default_parameter (f, parms, Qauto_lower, Qnil,
1357 "autoLower", "AutoLower", RES_TYPE_BOOLEAN);
1358 x_default_parameter (f, parms, Qcursor_type, Qbox,
1359 "cursorType", "CursorType", RES_TYPE_SYMBOL);
1360 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
1361 "scrollBarWidth", "ScrollBarWidth",
1363 x_default_parameter (f, parms, Qalpha, Qnil,
1364 "alpha", "Alpha", RES_TYPE_NUMBER);
1366 width = FRAME_COLS (f);
1367 height = FRAME_LINES (f);
1369 SET_FRAME_COLS (f, 0);
1370 FRAME_LINES (f) = 0;
1371 change_frame_size (f, height, width, 1, 0, 0);
1373 if (! f->output_data.ns->explicit_parent)
1375 Lisp_Object visibility;
1377 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
1379 if (EQ (visibility, Qunbound))
1382 if (EQ (visibility, Qicon))
1383 x_iconify_frame (f);
1384 else if (! NILP (visibility))
1386 x_make_frame_visible (f);
1387 [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1391 /* Must have been Qnil. */
1395 if (FRAME_HAS_MINIBUF_P (f)
1396 && (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
1397 || !FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame)))))
1398 KVAR (kb, Vdefault_minibuffer_frame) = frame;
1400 /* All remaining specified parameters, which have not been "used"
1401 by x_get_arg and friends, now go in the misc. alist of the frame. */
1402 for (tem = parms; CONSP (tem); tem = XCDR (tem))
1403 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1404 f->param_alist = Fcons (XCAR (tem), f->param_alist);
1408 /* Make sure windows on this frame appear in calls to next-window
1409 and similar functions. */
1410 Vwindow_list = Qnil;
1412 return unbind_to (count, frame);
1416 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1417 doc: /* Set the input focus to FRAME.
1418 FRAME nil means use the selected frame. */)
1421 struct frame *f = check_ns_frame (frame);
1422 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1424 if (dpyinfo->x_focus_frame != f)
1426 EmacsView *view = FRAME_NS_VIEW (f);
1428 [NSApp activateIgnoringOtherApps: YES];
1429 [[view window] makeKeyAndOrderFront: view];
1437 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1439 doc: /* Pop up the font panel. */)
1446 fm = [NSFontManager sharedFontManager];
1448 f = SELECTED_FRAME ();
1451 CHECK_FRAME (frame);
1455 [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1457 [fm orderFrontFontPanel: NSApp];
1462 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1464 doc: /* Pop up the color panel. */)
1471 f = SELECTED_FRAME ();
1474 CHECK_FRAME (frame);
1478 [NSApp orderFrontColorPanel: NSApp];
1483 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 4, 0,
1484 doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1485 Optional arg DIR, if non-nil, supplies a default directory.
1486 Optional arg MUSTMATCH, if non-nil, means the returned file or
1487 directory must exist.
1488 Optional arg INIT, if non-nil, provides a default file name to use. */)
1489 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object mustmatch, Lisp_Object init)
1491 static id fileDelegate = nil;
1496 NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1497 [NSString stringWithUTF8String: SDATA (prompt)];
1498 NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1499 [NSString stringWithUTF8String: SDATA (BVAR (current_buffer, directory))] :
1500 [NSString stringWithUTF8String: SDATA (dir)];
1501 NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1502 [NSString stringWithUTF8String: SDATA (init)];
1506 if (fileDelegate == nil)
1507 fileDelegate = [EmacsFileDelegate new];
1509 [NSCursor setHiddenUntilMouseMoves: NO];
1511 if ([dirS characterAtIndex: 0] == '~')
1512 dirS = [dirS stringByExpandingTildeInPath];
1514 panel = NILP (mustmatch) ?
1515 (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1517 [panel setTitle: promptS];
1519 /* Puma (10.1) does not have */
1520 if ([panel respondsToSelector: @selector (setAllowsOtherFileTypes:)])
1521 [panel setAllowsOtherFileTypes: YES];
1523 [panel setTreatsFilePackagesAsDirectories: YES];
1524 [panel setDelegate: fileDelegate];
1528 if (NILP (mustmatch))
1530 ret = [panel runModalForDirectory: dirS file: initS];
1534 [panel setCanChooseDirectories: YES];
1535 ret = [panel runModalForDirectory: dirS file: initS types: nil];
1538 ret = (ret == NSOKButton) || panelOK;
1541 fname = build_string ([[panel filename] UTF8String]);
1543 [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1546 return ret ? fname : Qnil;
1550 ns_get_defaults_value (const char *key)
1552 NSObject *obj = [[NSUserDefaults standardUserDefaults]
1553 objectForKey: [NSString stringWithUTF8String: key]];
1555 if (!obj) return NULL;
1557 return [[NSString stringWithFormat: @"%@", obj] UTF8String];
1561 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1562 doc: /* Return the value of the property NAME of OWNER from the defaults database.
1563 If OWNER is nil, Emacs is assumed. */)
1564 (Lisp_Object owner, Lisp_Object name)
1570 owner = build_string([ns_app_name UTF8String]);
1571 CHECK_STRING (name);
1572 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SDATA (name)); */
1574 value = ns_get_defaults_value (SDATA (name));
1577 return build_string (value);
1582 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1583 doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1584 If OWNER is nil, Emacs is assumed.
1585 If VALUE is nil, the default is removed. */)
1586 (Lisp_Object owner, Lisp_Object name, Lisp_Object value)
1590 owner = build_string ([ns_app_name UTF8String]);
1591 CHECK_STRING (name);
1594 [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1595 [NSString stringWithUTF8String: SDATA (name)]];
1599 CHECK_STRING (value);
1600 [[NSUserDefaults standardUserDefaults] setObject:
1601 [NSString stringWithUTF8String: SDATA (value)]
1602 forKey: [NSString stringWithUTF8String:
1610 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1611 Sx_server_max_request_size,
1613 doc: /* This function is a no-op. It is only present for completeness. */)
1614 (Lisp_Object display)
1617 /* This function has no real equivalent under NeXTstep. Return nil to
1623 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1624 doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1625 DISPLAY should be either a frame or a display name (a string).
1626 If omitted or nil, the selected frame's display is used. */)
1627 (Lisp_Object display)
1629 #ifdef NS_IMPL_GNUSTEP
1630 return build_string ("GNU");
1632 return build_string ("Apple");
1637 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1638 doc: /* Return the version numbers of the server of DISPLAY.
1639 The value is a list of three integers: the major and minor
1640 version numbers of the X Protocol in use, and the distributor-specific
1641 release number. See also the function `x-server-vendor'.
1643 The optional argument DISPLAY specifies which display to ask about.
1644 DISPLAY should be either a frame or a display name (a string).
1645 If omitted or nil, that stands for the selected frame's display. */)
1646 (Lisp_Object display)
1648 /*NOTE: it is unclear what would best correspond with "protocol";
1649 we return 10.3, meaning Panther, since this is roughly the
1650 level that GNUstep's APIs correspond to.
1651 The last number is where we distinguish between the Apple
1652 and GNUstep implementations ("distributor-specific release
1653 number") and give int'ized versions of major.minor. */
1654 return Fcons (make_number (10),
1655 Fcons (make_number (3),
1656 Fcons (make_number (ns_appkit_version_int()), Qnil)));
1660 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1661 doc: /* Return the number of screens on Nextstep display server DISPLAY.
1662 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1663 If omitted or nil, the selected frame's display is used. */)
1664 (Lisp_Object display)
1669 num = [[NSScreen screens] count];
1671 return (num != 0) ? make_number (num) : Qnil;
1675 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1677 doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1678 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1679 If omitted or nil, the selected frame's display is used. */)
1680 (Lisp_Object display)
1683 return make_number ((int)
1684 ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1688 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1690 doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1691 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1692 If omitted or nil, the selected frame's display is used. */)
1693 (Lisp_Object display)
1696 return make_number ((int)
1697 ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1701 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1702 Sx_display_backing_store, 0, 1, 0,
1703 doc: /* Return whether the Nextstep display DISPLAY supports backing store.
1704 The value may be `buffered', `retained', or `non-retained'.
1705 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1706 If omitted or nil, the selected frame's display is used. */)
1707 (Lisp_Object display)
1710 switch ([ns_get_window (display) backingType])
1712 case NSBackingStoreBuffered:
1713 return intern ("buffered");
1714 case NSBackingStoreRetained:
1715 return intern ("retained");
1716 case NSBackingStoreNonretained:
1717 return intern ("non-retained");
1719 error ("Strange value for backingType parameter of frame");
1721 return Qnil; /* not reached, shut compiler up */
1725 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1726 Sx_display_visual_class, 0, 1, 0,
1727 doc: /* Return the visual class of the Nextstep display server DISPLAY.
1728 The value is one of the symbols `static-gray', `gray-scale',
1729 `static-color', `pseudo-color', `true-color', or `direct-color'.
1730 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1731 If omitted or nil, the selected frame's display is used. */)
1732 (Lisp_Object display)
1734 NSWindowDepth depth;
1736 depth = [ns_get_screen (display) depth];
1738 if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1739 return intern ("static-gray");
1740 else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1741 return intern ("gray-scale");
1742 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1743 return intern ("pseudo-color");
1744 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1745 return intern ("true-color");
1746 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1747 return intern ("direct-color");
1749 /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1750 return intern ("direct-color");
1754 DEFUN ("x-display-save-under", Fx_display_save_under,
1755 Sx_display_save_under, 0, 1, 0,
1756 doc: /* Return t if DISPLAY supports the save-under feature.
1757 The optional argument DISPLAY specifies which display to ask about.
1758 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1759 If omitted or nil, the selected frame's display is used. */)
1760 (Lisp_Object display)
1763 switch ([ns_get_window (display) backingType])
1765 case NSBackingStoreBuffered:
1768 case NSBackingStoreRetained:
1769 case NSBackingStoreNonretained:
1773 error ("Strange value for backingType parameter of frame");
1775 return Qnil; /* not reached, shut compiler up */
1779 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1781 doc: /* Open a connection to a display server.
1782 DISPLAY is the name of the display to connect to.
1783 Optional second arg XRM-STRING is a string of resources in xrdb format.
1784 If the optional third arg MUST-SUCCEED is non-nil,
1785 terminate Emacs if we can't open the connection.
1786 \(In the Nextstep version, the last two arguments are currently ignored.) */)
1787 (Lisp_Object display, Lisp_Object resource_string, Lisp_Object must_succeed)
1789 struct ns_display_info *dpyinfo;
1791 CHECK_STRING (display);
1793 nxatoms_of_nsselect ();
1794 dpyinfo = ns_term_init (display);
1797 if (!NILP (must_succeed))
1798 fatal ("OpenStep on %s not responding.\n",
1801 error ("OpenStep on %s not responding.\n",
1805 /* Register our external input/output types, used for determining
1806 applicable services and also drag/drop eligibility. */
1807 ns_send_types = [[NSArray arrayWithObjects: NSStringPboardType, nil] retain];
1808 ns_return_types = [[NSArray arrayWithObjects: NSStringPboardType, nil]
1810 ns_drag_types = [[NSArray arrayWithObjects:
1812 NSTabularTextPboardType,
1813 NSFilenamesPboardType,
1816 NSFontPboardType, nil] retain];
1822 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1824 doc: /* Close the connection to the current Nextstep display server.
1825 The argument DISPLAY is currently ignored. */)
1826 (Lisp_Object display)
1829 /*ns_delete_terminal (dpyinfo->terminal); */
1830 [NSApp terminate: NSApp];
1835 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1836 doc: /* Return the list of display names that Emacs has connections to. */)
1839 Lisp_Object tail, result;
1842 for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1843 result = Fcons (XCAR (XCAR (tail)), result);
1849 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1851 doc: /* Hides all applications other than Emacs. */)
1855 [NSApp hideOtherApplications: NSApp];
1859 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1861 doc: /* If ON is non-nil, the entire Emacs application is hidden.
1862 Otherwise if Emacs is hidden, it is unhidden.
1863 If ON is equal to `activate', Emacs is unhidden and becomes
1864 the active application. */)
1868 if (EQ (on, intern ("activate")))
1870 [NSApp unhide: NSApp];
1871 [NSApp activateIgnoringOtherApps: YES];
1874 [NSApp unhide: NSApp];
1876 [NSApp hide: NSApp];
1881 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1883 doc: /* Shows the 'Info' or 'About' panel for Emacs. */)
1887 [NSApp orderFrontStandardAboutPanel: nil];
1892 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1893 doc: /* Determine font PostScript or family name for font NAME.
1894 NAME should be a string containing either the font name or an XLFD
1895 font descriptor. If string contains `fontset' and not
1896 `fontset-startup', it is left alone. */)
1900 CHECK_STRING (name);
1905 if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1908 return build_string (ns_xlfd_to_fontname (SDATA (name)));
1912 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1913 doc: /* Return a list of all available colors.
1914 The optional argument FRAME is currently ignored. */)
1917 Lisp_Object list = Qnil;
1918 NSEnumerator *colorlists;
1923 CHECK_FRAME (frame);
1924 if (! FRAME_NS_P (XFRAME (frame)))
1925 error ("non-Nextstep frame used in `ns-list-colors'");
1930 colorlists = [[NSColorList availableColorLists] objectEnumerator];
1931 while (clist = [colorlists nextObject])
1933 if ([[clist name] length] < 7 ||
1934 [[clist name] rangeOfString: @"PANTONE"].location == 0)
1936 NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1938 while (cname = [cnames nextObject])
1939 list = Fcons (build_string ([cname UTF8String]), list);
1940 /* for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1941 list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1942 UTF8String]), list); */
1952 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1953 doc: /* List available Nextstep services by querying NSApp. */)
1956 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
1957 /* You can't get services like this in 10.6+. */
1960 Lisp_Object ret = Qnil;
1965 svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1966 [NSApp setServicesMenu: svcs]; /* this and next rebuild on <10.4 */
1967 [NSApp registerServicesMenuSendTypes: ns_send_types
1968 returnTypes: ns_return_types];
1970 /* On Tiger, services menu updating was made lazier (waits for user to
1971 actually click on the menu), so we have to force things along: */
1972 #ifdef NS_IMPL_COCOA
1973 if (NSAppKitVersionNumber >= 744.0)
1975 delegate = [svcs delegate];
1976 if (delegate != nil)
1978 if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1979 [delegate menuNeedsUpdate: svcs];
1980 if ([delegate respondsToSelector:
1981 @selector (menu:updateItem:atIndex:shouldCancel:)])
1983 int i, len = [delegate numberOfItemsInMenu: svcs];
1984 for (i =0; i<len; i++)
1985 [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1986 for (i =0; i<len; i++)
1987 if (![delegate menu: svcs
1988 updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1989 atIndex: i shouldCancel: NO])
1996 [svcs setAutoenablesItems: NO];
1997 #ifdef NS_IMPL_COCOA
1998 [svcs update]; /* on OS X, converts from '/' structure */
2001 ret = interpret_services_menu (svcs, Qnil, ret);
2007 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
2009 doc: /* Perform Nextstep SERVICE on SEND.
2010 SEND should be either a string or nil.
2011 The return value is the result of the service, as string, or nil if
2012 there was no result. */)
2013 (Lisp_Object service, Lisp_Object send)
2020 CHECK_STRING (service);
2023 utfStr = SDATA (service);
2024 svcName = [NSString stringWithUTF8String: utfStr];
2026 pb =[NSPasteboard pasteboardWithUniqueName];
2027 ns_string_to_pasteboard (pb, send);
2029 if (NSPerformService (svcName, pb) == NO)
2030 Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
2032 if ([[pb types] count] == 0)
2033 return build_string ("");
2034 return ns_string_from_pasteboard (pb);
2038 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
2039 Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
2040 doc: /* Return an NFC string that matches the UTF-8 NFD string STR. */)
2043 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
2048 utfStr = [NSString stringWithUTF8String: SDATA (str)];
2049 if (![utfStr respondsToSelector:
2050 @selector (precomposedStringWithCanonicalMapping)])
2053 ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
2057 utfStr = [utfStr precomposedStringWithCanonicalMapping];
2058 return build_string ([utfStr UTF8String]);
2062 #ifdef NS_IMPL_COCOA
2064 /* Compile and execute the AppleScript SCRIPT and return the error
2065 status as function value. A zero is returned if compilation and
2066 execution is successful, in which case *RESULT is set to a Lisp
2067 string or a number containing the resulting script value. Otherwise,
2070 ns_do_applescript (Lisp_Object script, Lisp_Object *result)
2072 NSAppleEventDescriptor *desc;
2073 NSDictionary* errorDict;
2074 NSAppleEventDescriptor* returnDescriptor = NULL;
2076 NSAppleScript* scriptObject =
2077 [[NSAppleScript alloc] initWithSource:
2078 [NSString stringWithUTF8String: SDATA (script)]];
2080 returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2081 [scriptObject release];
2085 if (returnDescriptor != NULL)
2087 // successful execution
2088 if (kAENullEvent != [returnDescriptor descriptorType])
2091 // script returned an AppleScript result
2092 if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2093 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
2094 (typeUTF16ExternalRepresentation
2095 == [returnDescriptor descriptorType]) ||
2097 (typeUTF8Text == [returnDescriptor descriptorType]) ||
2098 (typeCString == [returnDescriptor descriptorType]))
2100 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2102 *result = build_string([[desc stringValue] UTF8String]);
2106 /* use typeUTF16ExternalRepresentation? */
2107 // coerce the result to the appropriate ObjC type
2108 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2110 *result = make_number([desc int32Value]);
2116 // no script result, return error
2122 /* Helper function called from sendEvent to run applescript
2123 from within the main event loop. */
2126 ns_run_ascript (void)
2128 as_status = ns_do_applescript (as_script, as_result);
2131 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2132 doc: /* Execute AppleScript SCRIPT and return the result.
2133 If compilation and execution are successful, the resulting script value
2134 is returned as a string, a number or, in the case of other constructs, t.
2135 In case the execution fails, an error is signaled. */)
2136 (Lisp_Object script)
2142 CHECK_STRING (script);
2148 as_result = &result;
2150 /* executing apple script requires the event loop to run, otherwise
2151 errors aren't returned and executeAndReturnError hangs forever.
2152 Post an event that runs applescript and then start the event loop.
2153 The event loop is exited when the script is done. */
2154 nxev = [NSEvent otherEventWithType: NSApplicationDefined
2155 location: NSMakePoint (0, 0)
2158 windowNumber: [[NSApp mainWindow] windowNumber]
2159 context: [NSApp context]
2162 data2: NSAPP_DATA2_RUNASSCRIPT];
2164 [NSApp postEvent: nxev atStart: NO];
2174 else if (!STRINGP (result))
2175 error ("AppleScript error %d", status);
2177 error ("%s", SDATA (result));
2183 /* ==========================================================================
2185 Miscellaneous functions not called through hooks
2187 ========================================================================== */
2190 /* called from image.c */
2192 check_x_frame (Lisp_Object frame)
2194 return check_ns_frame (frame);
2198 /* called from frame.c */
2199 struct ns_display_info *
2200 check_x_display_info (Lisp_Object frame)
2202 return check_ns_display_info (frame);
2207 x_set_scroll_bar_default_width (struct frame *f)
2209 int wid = FRAME_COLUMN_WIDTH (f);
2210 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2211 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2216 /* terms impl this instead of x-get-resource directly */
2218 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2220 /* remove appname prefix; TODO: allow for !="Emacs" */
2221 char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2225 if (inhibit_x_resources)
2226 /* --quick was passed, so this is a no-op. */
2229 res = ns_get_defaults_value (toCheck);
2230 return !res ? NULL :
2231 (!strncasecmp (res, "YES", 3) ? "true" :
2232 (!strncasecmp (res, "NO", 2) ? "false" : res));
2237 x_get_focus_frame (struct frame *frame)
2239 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2240 Lisp_Object nsfocus;
2242 if (!dpyinfo->x_focus_frame)
2245 XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2251 x_pixel_width (struct frame *f)
2253 return FRAME_PIXEL_WIDTH (f);
2258 x_pixel_height (struct frame *f)
2260 return FRAME_PIXEL_HEIGHT (f);
2265 x_char_width (struct frame *f)
2267 return FRAME_COLUMN_WIDTH (f);
2272 x_char_height (struct frame *f)
2274 return FRAME_LINE_HEIGHT (f);
2279 x_screen_planes (struct frame *f)
2281 return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2286 x_sync (struct frame *f)
2288 /* XXX Not implemented XXX */
2294 /* ==========================================================================
2296 Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2298 ========================================================================== */
2301 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2302 doc: /* Internal function called by `color-defined-p', which see.
2303 \(Note that the Nextstep version of this function ignores FRAME.) */)
2304 (Lisp_Object color, Lisp_Object frame)
2308 return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2312 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2313 doc: /* Internal function called by `color-values', which see. */)
2314 (Lisp_Object color, Lisp_Object frame)
2317 CGFloat red, green, blue, alpha;
2320 CHECK_STRING (color);
2322 if (ns_lisp_to_color (color, &col))
2325 [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2326 getRed: &red green: &green blue: &blue alpha: &alpha];
2327 return list3 (make_number (lrint (red*65280)),
2328 make_number (lrint (green*65280)),
2329 make_number (lrint (blue*65280)));
2333 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2334 doc: /* Internal function called by `display-color-p', which see. */)
2335 (Lisp_Object display)
2337 NSWindowDepth depth;
2338 NSString *colorSpace;
2340 depth = [ns_get_screen (display) depth];
2341 colorSpace = NSColorSpaceFromDepth (depth);
2343 return [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2344 || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2349 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2350 Sx_display_grayscale_p, 0, 1, 0,
2351 doc: /* Return t if the Nextstep display supports shades of gray.
2352 Note that color displays do support shades of gray.
2353 The optional argument DISPLAY specifies which display to ask about.
2354 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2355 If omitted or nil, that stands for the selected frame's display. */)
2356 (Lisp_Object display)
2358 NSWindowDepth depth;
2360 depth = [ns_get_screen (display) depth];
2362 return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2366 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2368 doc: /* Return the width in pixels of the Nextstep display DISPLAY.
2369 The optional argument DISPLAY specifies which display to ask about.
2370 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2371 If omitted or nil, that stands for the selected frame's display. */)
2372 (Lisp_Object display)
2375 return make_number ((int) [ns_get_screen (display) frame].size.width);
2379 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2380 Sx_display_pixel_height, 0, 1, 0,
2381 doc: /* Return the height in pixels of the Nextstep display DISPLAY.
2382 The optional argument DISPLAY specifies which display to ask about.
2383 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2384 If omitted or nil, that stands for the selected frame's display. */)
2385 (Lisp_Object display)
2388 return make_number ((int) [ns_get_screen (display) frame].size.height);
2392 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2393 Sns_display_usable_bounds, 0, 1, 0,
2394 doc: /* Return the bounds of the usable part of the screen.
2395 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2396 are the boundaries of the usable part of the screen, excluding areas
2397 reserved for the Mac menu, dock, and so forth.
2399 The screen queried corresponds to DISPLAY, which should be either a
2400 frame, a display name (a string), or terminal ID. If omitted or nil,
2401 that stands for the selected frame's display. */)
2402 (Lisp_Object display)
2409 screen = ns_get_screen (display);
2413 vScreen = [screen visibleFrame];
2415 /* NS coordinate system is upside-down.
2416 Transform to screen-specific coordinates. */
2417 return list4 (make_number ((int) vScreen.origin.x),
2418 make_number ((int) [screen frame].size.height
2419 - vScreen.size.height - vScreen.origin.y),
2420 make_number ((int) vScreen.size.width),
2421 make_number ((int) vScreen.size.height));
2425 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2427 doc: /* Return the number of bitplanes of the Nextstep display DISPLAY.
2428 The optional argument DISPLAY specifies which display to ask about.
2429 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2430 If omitted or nil, that stands for the selected frame's display. */)
2431 (Lisp_Object display)
2435 (NSBitsPerPixelFromDepth ([ns_get_screen (display) depth]));
2439 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2440 Sx_display_color_cells, 0, 1, 0,
2441 doc: /* Returns the number of color cells of the Nextstep display DISPLAY.
2442 The optional argument DISPLAY specifies which display to ask about.
2443 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2444 If omitted or nil, that stands for the selected frame's display. */)
2445 (Lisp_Object display)
2447 struct ns_display_info *dpyinfo;
2450 dpyinfo = check_ns_display_info (display);
2451 /* We force 24+ bit depths to 24-bit to prevent an overflow. */
2452 return make_number (1 << min (dpyinfo->n_planes, 24));
2456 /* Unused dummy def needed for compatibility. */
2457 Lisp_Object tip_frame;
2459 /* TODO: move to xdisp or similar */
2461 compute_tip_xy (struct frame *f,
2470 Lisp_Object left, top;
2471 EmacsView *view = FRAME_NS_VIEW (f);
2474 /* Start with user-specified or mouse position. */
2475 left = Fcdr (Fassq (Qleft, parms));
2476 top = Fcdr (Fassq (Qtop, parms));
2478 if (!INTEGERP (left) || !INTEGERP (top))
2480 pt = last_mouse_motion_position;
2481 /* Convert to screen coordinates */
2482 pt = [view convertPoint: pt toView: nil];
2483 pt = [[view window] convertBaseToScreen: pt];
2487 /* Absolute coordinates. */
2489 pt.y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - XINT (top)
2493 /* Ensure in bounds. (Note, screen origin = lower left.) */
2494 if (INTEGERP (left))
2496 else if (pt.x + XINT (dx) <= 0)
2497 *root_x = 0; /* Can happen for negative dx */
2498 else if (pt.x + XINT (dx) + width
2499 <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2500 /* It fits to the right of the pointer. */
2501 *root_x = pt.x + XINT (dx);
2502 else if (width + XINT (dx) <= pt.x)
2503 /* It fits to the left of the pointer. */
2504 *root_x = pt.x - width - XINT (dx);
2506 /* Put it left justified on the screen -- it ought to fit that way. */
2511 else if (pt.y - XINT (dy) - height >= 0)
2512 /* It fits below the pointer. */
2513 *root_y = pt.y - height - XINT (dy);
2514 else if (pt.y + XINT (dy) + height
2515 <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2516 /* It fits above the pointer */
2517 *root_y = pt.y + XINT (dy);
2519 /* Put it on the top. */
2520 *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2524 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2525 doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2526 A tooltip window is a small window displaying a string.
2528 This is an internal function; Lisp code should call `tooltip-show'.
2530 FRAME nil or omitted means use the selected frame.
2532 PARMS is an optional list of frame parameters which can be used to
2533 change the tooltip's appearance.
2535 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
2536 means use the default timeout of 5 seconds.
2538 If the list of frame parameters PARMS contains a `left' parameter,
2539 the tooltip is displayed at that x-position. Otherwise it is
2540 displayed at the mouse position, with offset DX added (default is 5 if
2541 DX isn't specified). Likewise for the y-position; if a `top' frame
2542 parameter is specified, it determines the y-position of the tooltip
2543 window, otherwise it is displayed at the mouse position, with offset
2544 DY added (default is -10).
2546 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2547 Text larger than the specified size is clipped. */)
2548 (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
2551 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2552 ptrdiff_t count = SPECPDL_INDEX ();
2557 specbind (Qinhibit_redisplay, Qt);
2559 GCPRO4 (string, parms, frame, timeout);
2561 CHECK_STRING (string);
2562 str = SDATA (string);
2563 f = check_x_frame (frame);
2565 timeout = make_number (5);
2567 CHECK_NATNUM (timeout);
2570 dx = make_number (5);
2575 dy = make_number (-10);
2580 if (ns_tooltip == nil)
2581 ns_tooltip = [[EmacsTooltip alloc] init];
2585 [ns_tooltip setText: str];
2586 size = [ns_tooltip frame].size;
2588 /* Move the tooltip window where the mouse pointer is. Resize and
2590 compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2593 [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2597 return unbind_to (count, Qnil);
2601 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2602 doc: /* Hide the current tooltip window, if there is any.
2603 Value is t if tooltip was open, nil otherwise. */)
2606 if (ns_tooltip == nil || ![ns_tooltip isActive])
2613 /* ==========================================================================
2615 Class implementations
2617 ========================================================================== */
2620 @implementation EmacsSavePanel
2621 #ifdef NS_IMPL_COCOA
2622 /* --------------------------------------------------------------------------
2623 These are overridden to intercept on OS X: ending panel restarts NSApp
2624 event loop if it is stopped. Not sure if this is correct behavior,
2625 perhaps should check if running and if so send an appdefined.
2626 -------------------------------------------------------------------------- */
2627 - (void) ok: (id)sender
2633 - (void) cancel: (id)sender
2635 [super cancel: sender];
2642 @implementation EmacsOpenPanel
2643 #ifdef NS_IMPL_COCOA
2644 /* --------------------------------------------------------------------------
2645 These are overridden to intercept on OS X: ending panel restarts NSApp
2646 event loop if it is stopped. Not sure if this is correct behavior,
2647 perhaps should check if running and if so send an appdefined.
2648 -------------------------------------------------------------------------- */
2649 - (void) ok: (id)sender
2655 - (void) cancel: (id)sender
2657 [super cancel: sender];
2664 @implementation EmacsFileDelegate
2665 /* --------------------------------------------------------------------------
2666 Delegate methods for Open/Save panels
2667 -------------------------------------------------------------------------- */
2668 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2672 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2676 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2677 confirmed: (BOOL)okFlag
2686 /* ==========================================================================
2688 Lisp interface declaration
2690 ========================================================================== */
2694 syms_of_nsfns (void)
2698 Qfontsize = intern_c_string ("fontsize");
2699 staticpro (&Qfontsize);
2701 DEFVAR_LISP ("ns-icon-type-alist", Vns_icon_type_alist,
2702 doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2703 If the title of a frame matches REGEXP, then IMAGE.tiff is
2704 selected as the image of the icon representing the frame when it's
2705 miniaturized. If an element is t, then Emacs tries to select an icon
2706 based on the filetype of the visited file.
2708 The images have to be installed in a folder called English.lproj in the
2709 Emacs folder. You have to restart Emacs after installing new icons.
2711 Example: Install an icon Gnus.tiff and execute the following code
2713 (setq ns-icon-type-alist
2714 (append ns-icon-type-alist
2715 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2718 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2719 be used as the image of the icon representing the frame. */);
2720 Vns_icon_type_alist = Fcons (Qt, Qnil);
2722 DEFVAR_LISP ("ns-version-string", Vns_version_string,
2723 doc: /* Toolkit version for NS Windowing. */);
2724 Vns_version_string = ns_appkit_version_str ();
2726 defsubr (&Sns_read_file_name);
2727 defsubr (&Sns_get_resource);
2728 defsubr (&Sns_set_resource);
2729 defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2730 defsubr (&Sx_display_grayscale_p);
2731 defsubr (&Sns_font_name);
2732 defsubr (&Sns_list_colors);
2733 #ifdef NS_IMPL_COCOA
2734 defsubr (&Sns_do_applescript);
2736 defsubr (&Sxw_color_defined_p);
2737 defsubr (&Sxw_color_values);
2738 defsubr (&Sx_server_max_request_size);
2739 defsubr (&Sx_server_vendor);
2740 defsubr (&Sx_server_version);
2741 defsubr (&Sx_display_pixel_width);
2742 defsubr (&Sx_display_pixel_height);
2743 defsubr (&Sns_display_usable_bounds);
2744 defsubr (&Sx_display_mm_width);
2745 defsubr (&Sx_display_mm_height);
2746 defsubr (&Sx_display_screens);
2747 defsubr (&Sx_display_planes);
2748 defsubr (&Sx_display_color_cells);
2749 defsubr (&Sx_display_visual_class);
2750 defsubr (&Sx_display_backing_store);
2751 defsubr (&Sx_display_save_under);
2752 defsubr (&Sx_create_frame);
2753 defsubr (&Sx_open_connection);
2754 defsubr (&Sx_close_connection);
2755 defsubr (&Sx_display_list);
2757 defsubr (&Sns_hide_others);
2758 defsubr (&Sns_hide_emacs);
2759 defsubr (&Sns_emacs_info_panel);
2760 defsubr (&Sns_list_services);
2761 defsubr (&Sns_perform_service);
2762 defsubr (&Sns_convert_utf8_nfd_to_nfc);
2763 defsubr (&Sx_focus_frame);
2764 defsubr (&Sns_popup_font_panel);
2765 defsubr (&Sns_popup_color_panel);
2767 defsubr (&Sx_show_tip);
2768 defsubr (&Sx_hide_tip);
2770 /* used only in fontset.c */
2771 check_window_system_func = check_ns;