1 /* Functions for the NeXT/Open/GNUstep and MacOSX window system.
3 Copyright (C) 1989, 1992-1994, 2005-2006, 2008-2012
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. */
36 #include <c-strcase.h>
39 #include "blockinput.h"
42 #include "character.h"
45 #include "termhooks.h"
50 int fns_trace_num = 1;
51 #define NSTRACE(x) fprintf (stderr, "%s:%d: [%d] " #x "\n", \
52 __FILE__, __LINE__, ++fns_trace_num)
59 extern NSArray *ns_send_types, *ns_return_types, *ns_drag_types;
61 extern Lisp_Object Qforeground_color;
62 extern Lisp_Object Qbackground_color;
63 extern Lisp_Object Qcursor_color;
64 extern Lisp_Object Qinternal_border_width;
65 extern Lisp_Object Qvisibility;
66 extern Lisp_Object Qcursor_type;
67 extern Lisp_Object Qicon_type;
68 extern Lisp_Object Qicon_name;
69 extern Lisp_Object Qicon_left;
70 extern Lisp_Object Qicon_top;
71 extern Lisp_Object Qleft;
72 extern Lisp_Object Qright;
73 extern Lisp_Object Qtop;
74 extern Lisp_Object Qdisplay;
75 extern Lisp_Object Qvertical_scroll_bars;
76 extern Lisp_Object Qauto_raise;
77 extern Lisp_Object Qauto_lower;
78 extern Lisp_Object Qbox;
79 extern Lisp_Object Qscroll_bar_width;
80 extern Lisp_Object Qx_resource_name;
81 extern Lisp_Object Qface_set_after_frame_default;
82 extern Lisp_Object Qunderline, Qundefined;
83 extern Lisp_Object Qheight, Qminibuffer, Qname, Qonly, Qwidth;
84 extern Lisp_Object Qunsplittable, Qmenu_bar_lines, Qbuffer_predicate, Qtitle;
85 extern Lisp_Object Qnone;
88 Lisp_Object Qbuffered;
89 Lisp_Object Qfontsize;
91 /* hack for OS X file panels */
94 EmacsTooltip *ns_tooltip;
96 /* Need forward declaration here to preserve organizational integrity of file */
97 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
99 extern BOOL ns_in_resize;
101 /* Static variables to handle applescript execution. */
102 static Lisp_Object as_script, *as_result;
103 static int as_status;
106 static ptrdiff_t image_cache_refcount;
109 /* ==========================================================================
111 Internal utility functions
113 ========================================================================== */
120 error ("OpenStep is not in use or not initialized");
124 /* Nonzero if we can use mouse menus. */
132 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
133 and checking validity for NS. */
135 check_ns_frame (Lisp_Object frame)
140 f = SELECTED_FRAME ();
143 CHECK_LIVE_FRAME (frame);
146 if (! FRAME_NS_P (f))
147 error ("non-Nextstep frame used");
152 /* Let the user specify an Nextstep display with a frame.
153 nil stands for the selected frame--or, if that is not an Nextstep frame,
154 the first Nextstep display on the list. */
155 static struct ns_display_info *
156 check_ns_display_info (Lisp_Object frame)
160 struct frame *f = SELECTED_FRAME ();
161 if (FRAME_NS_P (f) && FRAME_LIVE_P (f) )
162 return FRAME_NS_DISPLAY_INFO (f);
163 else if (x_display_list != 0)
164 return x_display_list;
166 error ("Nextstep windows are not in use or not initialized");
168 else if (INTEGERP (frame))
170 struct terminal *t = get_terminal (frame, 1);
172 if (t->type != output_ns)
173 error ("Terminal %"pI"d is not a Nextstep display", XINT (frame));
175 return t->display_info.ns;
177 else if (STRINGP (frame))
178 return ns_display_info_for_name (frame);
183 CHECK_LIVE_FRAME (frame);
185 if (! FRAME_NS_P (f))
186 error ("non-Nextstep frame used");
187 return FRAME_NS_DISPLAY_INFO (f);
189 return NULL; /* shut compiler up */
194 ns_get_window (Lisp_Object maybeFrame)
196 id view =nil, window =nil;
198 if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
199 maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
201 if (!NILP (maybeFrame))
202 view = FRAME_NS_VIEW (XFRAME (maybeFrame));
203 if (view) window =[view window];
210 ns_get_screen (Lisp_Object screen)
213 struct terminal *terminal;
215 if (EQ (Qt, screen)) /* not documented */
216 return [NSScreen mainScreen];
218 terminal = get_terminal (screen, 1);
219 if (terminal->type != output_ns)
223 f = SELECTED_FRAME ();
224 else if (FRAMEP (screen))
228 struct ns_display_info *dpyinfo = terminal->display_info.ns;
229 f = dpyinfo->x_focus_frame
230 ? dpyinfo->x_focus_frame : dpyinfo->x_highlight_frame;
233 return ((f && FRAME_NS_P (f)) ? [[FRAME_NS_VIEW (f) window] screen]
238 /* Return the X display structure for the display named NAME.
239 Open a new connection if necessary. */
240 struct ns_display_info *
241 ns_display_info_for_name (Lisp_Object name)
244 struct ns_display_info *dpyinfo;
248 for (dpyinfo = x_display_list, names = ns_display_name_list;
250 dpyinfo = dpyinfo->next, names = XCDR (names))
253 tem = Fstring_equal (XCAR (XCAR (names)), name);
258 error ("Emacs for OpenStep does not yet support multi-display.");
260 Fx_open_connection (name, Qnil, Qnil);
261 dpyinfo = x_display_list;
264 error ("OpenStep on %s not responding.\n", SDATA (name));
271 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
272 /* --------------------------------------------------------------------------
273 Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
274 -------------------------------------------------------------------------- */
284 count = [menu numberOfItems];
285 for (i = 0; i<count; i++)
287 item = [menu itemAtIndex: i];
288 name = [[item title] UTF8String];
291 nameStr = build_string (name);
293 if ([item hasSubmenu])
295 old = interpret_services_menu ([item submenu],
296 Fcons (nameStr, prefix), old);
300 keys = [item keyEquivalent];
301 if (keys && [keys length] )
303 key = [keys characterAtIndex: 0];
304 res = make_number (key|super_modifier);
310 old = Fcons (Fcons (res,
311 Freverse (Fcons (nameStr,
321 /* ==========================================================================
323 Frame parameter setters
325 ========================================================================== */
329 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
332 CGFloat r, g, b, alpha;
334 if (ns_lisp_to_color (arg, &col))
336 store_frame_param (f, Qforeground_color, oldval);
337 error ("Unknown color");
341 [f->output_data.ns->foreground_color release];
342 f->output_data.ns->foreground_color = col;
344 [col getRed: &r green: &g blue: &b alpha: &alpha];
345 FRAME_FOREGROUND_PIXEL (f) =
346 ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
348 if (FRAME_NS_VIEW (f))
350 update_face_from_frame_parameter (f, Qforeground_color, arg);
351 /*recompute_basic_faces (f); */
352 if (FRAME_VISIBLE_P (f))
359 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
363 NSView *view = FRAME_NS_VIEW (f);
364 CGFloat r, g, b, alpha;
366 if (ns_lisp_to_color (arg, &col))
368 store_frame_param (f, Qbackground_color, oldval);
369 error ("Unknown color");
372 /* clear the frame; in some instances the NS-internal GC appears not to
373 update, or it does update and cannot clear old text properly */
374 if (FRAME_VISIBLE_P (f))
378 [f->output_data.ns->background_color release];
379 f->output_data.ns->background_color = col;
381 [col getRed: &r green: &g blue: &b alpha: &alpha];
382 FRAME_BACKGROUND_PIXEL (f) =
383 ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
387 [[view window] setBackgroundColor: col];
390 [[view window] setOpaque: NO];
392 [[view window] setOpaque: YES];
394 face = FRAME_DEFAULT_FACE (f);
397 col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
398 face->background = ns_index_color
399 ([col colorWithAlphaComponent: alpha], f);
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 defined GLYPH_DEBUG && defined ENABLE_CHECKING
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 eassert (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 = xzalloc (sizeof *f->output_data.ns);
1209 FRAME_FONTSET (f) = -1;
1211 f->icon_name = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
1213 if (! STRINGP (f->icon_name))
1214 f->icon_name = Qnil;
1216 FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1218 /* With FRAME_NS_DISPLAY_INFO set up, this unwind-protect is safe. */
1219 record_unwind_protect (unwind_create_frame, frame);
1221 f->output_data.ns->window_desc = desc_ctr++;
1222 if (TYPE_RANGED_INTEGERP (Window, parent))
1224 f->output_data.ns->parent_desc = XFASTINT (parent);
1225 f->output_data.ns->explicit_parent = 1;
1229 f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1230 f->output_data.ns->explicit_parent = 0;
1233 /* Set the name; the functions to which we pass f expect the name to
1235 if (EQ (name, Qunbound) || NILP (name) || ! STRINGP (name))
1237 f->name = build_string ([ns_app_name UTF8String]);
1238 f->explicit_name = 0;
1243 f->explicit_name = 1;
1244 specbind (Qx_resource_name, name);
1247 f->resx = dpyinfo->resx;
1248 f->resy = dpyinfo->resy;
1251 register_font_driver (&nsfont_driver, f);
1252 x_default_parameter (f, parms, Qfont_backend, Qnil,
1253 "fontBackend", "FontBackend", RES_TYPE_STRING);
1256 /* use for default font name */
1257 id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1258 tfontsize = x_default_parameter (f, parms, Qfontsize,
1259 make_number (0 /*(int)[font pointSize]*/),
1260 "fontSize", "FontSize", RES_TYPE_NUMBER);
1261 tfont = x_default_parameter (f, parms, Qfont,
1262 build_string ([[font fontName] UTF8String]),
1263 "font", "Font", RES_TYPE_STRING);
1267 x_default_parameter (f, parms, Qborder_width, make_number (0),
1268 "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1269 x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1270 "internalBorderWidth", "InternalBorderWidth",
1273 /* default scrollbars on right on Mac */
1276 #ifdef NS_IMPL_GNUSTEP
1281 x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1282 "verticalScrollBars", "VerticalScrollBars",
1285 x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1286 "foreground", "Foreground", RES_TYPE_STRING);
1287 x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1288 "background", "Background", RES_TYPE_STRING);
1289 /* FIXME: not supported yet in Nextstep */
1290 x_default_parameter (f, parms, Qline_spacing, Qnil,
1291 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1292 x_default_parameter (f, parms, Qleft_fringe, Qnil,
1293 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1294 x_default_parameter (f, parms, Qright_fringe, Qnil,
1295 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1298 image_cache_refcount =
1299 FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
1302 init_frame_faces (f);
1304 /* The resources controlling the menu-bar and tool-bar are
1305 processed specially at startup, and reflected in the mode
1306 variables; ignore them here. */
1307 x_default_parameter (f, parms, Qmenu_bar_lines,
1308 NILP (Vmenu_bar_mode)
1309 ? make_number (0) : make_number (1),
1310 NULL, NULL, RES_TYPE_NUMBER);
1311 x_default_parameter (f, parms, Qtool_bar_lines,
1312 NILP (Vtool_bar_mode)
1313 ? make_number (0) : make_number (1),
1314 NULL, NULL, RES_TYPE_NUMBER);
1316 x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1317 "BufferPredicate", RES_TYPE_SYMBOL);
1318 x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1321 parms = get_geometry_from_preferences (dpyinfo, parms);
1322 window_prompting = x_figure_window_size (f, parms, 1);
1324 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1325 f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1327 /* NOTE: on other terms, this is done in set_mouse_color, however this
1328 was not getting called under Nextstep */
1329 f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1330 f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1331 f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1332 f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1333 f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1334 f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1335 FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1336 = [NSCursor arrowCursor];
1337 f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1339 [[EmacsView alloc] initFrameFromEmacs: f];
1343 /* ns_display_info does not have a reference_count. */
1344 f->terminal->reference_count++;
1346 /* It is now ok to make the frame official even if we get an error below.
1347 The frame needs to be on Vframe_list or making it visible won't work. */
1348 Vframe_list = Fcons (frame, Vframe_list);
1350 x_default_parameter (f, parms, Qicon_type, Qnil,
1351 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
1353 x_default_parameter (f, parms, Qauto_raise, Qnil,
1354 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
1355 x_default_parameter (f, parms, Qauto_lower, Qnil,
1356 "autoLower", "AutoLower", RES_TYPE_BOOLEAN);
1357 x_default_parameter (f, parms, Qcursor_type, Qbox,
1358 "cursorType", "CursorType", RES_TYPE_SYMBOL);
1359 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
1360 "scrollBarWidth", "ScrollBarWidth",
1362 x_default_parameter (f, parms, Qalpha, Qnil,
1363 "alpha", "Alpha", RES_TYPE_NUMBER);
1365 width = FRAME_COLS (f);
1366 height = FRAME_LINES (f);
1368 SET_FRAME_COLS (f, 0);
1369 FRAME_LINES (f) = 0;
1370 change_frame_size (f, height, width, 1, 0, 0);
1372 if (! f->output_data.ns->explicit_parent)
1374 Lisp_Object visibility;
1376 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
1378 if (EQ (visibility, Qunbound))
1381 if (EQ (visibility, Qicon))
1382 x_iconify_frame (f);
1383 else if (! NILP (visibility))
1385 x_make_frame_visible (f);
1386 [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1390 /* Must have been Qnil. */
1394 if (FRAME_HAS_MINIBUF_P (f)
1395 && (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
1396 || !FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame)))))
1397 KVAR (kb, Vdefault_minibuffer_frame) = frame;
1399 /* All remaining specified parameters, which have not been "used"
1400 by x_get_arg and friends, now go in the misc. alist of the frame. */
1401 for (tem = parms; CONSP (tem); tem = XCDR (tem))
1402 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1403 f->param_alist = Fcons (XCAR (tem), f->param_alist);
1407 /* Make sure windows on this frame appear in calls to next-window
1408 and similar functions. */
1409 Vwindow_list = Qnil;
1411 return unbind_to (count, frame);
1415 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1416 doc: /* Set the input focus to FRAME.
1417 FRAME nil means use the selected frame. */)
1420 struct frame *f = check_ns_frame (frame);
1421 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1423 if (dpyinfo->x_focus_frame != f)
1425 EmacsView *view = FRAME_NS_VIEW (f);
1427 [NSApp activateIgnoringOtherApps: YES];
1428 [[view window] makeKeyAndOrderFront: view];
1436 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1438 doc: /* Pop up the font panel. */)
1445 fm = [NSFontManager sharedFontManager];
1447 f = SELECTED_FRAME ();
1450 CHECK_FRAME (frame);
1454 [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1456 [fm orderFrontFontPanel: NSApp];
1461 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1463 doc: /* Pop up the color panel. */)
1470 f = SELECTED_FRAME ();
1473 CHECK_FRAME (frame);
1477 [NSApp orderFrontColorPanel: NSApp];
1482 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 4, 0,
1483 doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1484 Optional arg DIR, if non-nil, supplies a default directory.
1485 Optional arg MUSTMATCH, if non-nil, means the returned file or
1486 directory must exist.
1487 Optional arg INIT, if non-nil, provides a default file name to use. */)
1488 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object mustmatch, Lisp_Object init)
1490 static id fileDelegate = nil;
1495 NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1496 [NSString stringWithUTF8String: SDATA (prompt)];
1497 NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1498 [NSString stringWithUTF8String: SDATA (BVAR (current_buffer, directory))] :
1499 [NSString stringWithUTF8String: SDATA (dir)];
1500 NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1501 [NSString stringWithUTF8String: SDATA (init)];
1505 if (fileDelegate == nil)
1506 fileDelegate = [EmacsFileDelegate new];
1508 [NSCursor setHiddenUntilMouseMoves: NO];
1510 if ([dirS characterAtIndex: 0] == '~')
1511 dirS = [dirS stringByExpandingTildeInPath];
1513 panel = NILP (mustmatch) ?
1514 (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1516 [panel setTitle: promptS];
1518 /* Puma (10.1) does not have */
1519 if ([panel respondsToSelector: @selector (setAllowsOtherFileTypes:)])
1520 [panel setAllowsOtherFileTypes: YES];
1522 [panel setTreatsFilePackagesAsDirectories: YES];
1523 [panel setDelegate: fileDelegate];
1527 if (NILP (mustmatch))
1529 ret = [panel runModalForDirectory: dirS file: initS];
1533 [panel setCanChooseDirectories: YES];
1534 ret = [panel runModalForDirectory: dirS file: initS types: nil];
1537 ret = (ret == NSOKButton) || panelOK;
1540 fname = build_string ([[panel filename] UTF8String]);
1542 [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1545 return ret ? fname : Qnil;
1549 ns_get_defaults_value (const char *key)
1551 NSObject *obj = [[NSUserDefaults standardUserDefaults]
1552 objectForKey: [NSString stringWithUTF8String: key]];
1554 if (!obj) return NULL;
1556 return [[NSString stringWithFormat: @"%@", obj] UTF8String];
1560 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1561 doc: /* Return the value of the property NAME of OWNER from the defaults database.
1562 If OWNER is nil, Emacs is assumed. */)
1563 (Lisp_Object owner, Lisp_Object name)
1569 owner = build_string([ns_app_name UTF8String]);
1570 CHECK_STRING (name);
1571 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SDATA (name)); */
1573 value = ns_get_defaults_value (SDATA (name));
1576 return build_string (value);
1581 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1582 doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1583 If OWNER is nil, Emacs is assumed.
1584 If VALUE is nil, the default is removed. */)
1585 (Lisp_Object owner, Lisp_Object name, Lisp_Object value)
1589 owner = build_string ([ns_app_name UTF8String]);
1590 CHECK_STRING (name);
1593 [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1594 [NSString stringWithUTF8String: SDATA (name)]];
1598 CHECK_STRING (value);
1599 [[NSUserDefaults standardUserDefaults] setObject:
1600 [NSString stringWithUTF8String: SDATA (value)]
1601 forKey: [NSString stringWithUTF8String:
1609 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1610 Sx_server_max_request_size,
1612 doc: /* This function is a no-op. It is only present for completeness. */)
1613 (Lisp_Object display)
1616 /* This function has no real equivalent under NeXTstep. Return nil to
1622 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1623 doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1624 DISPLAY should be either a frame or a display name (a string).
1625 If omitted or nil, the selected frame's display is used. */)
1626 (Lisp_Object display)
1628 #ifdef NS_IMPL_GNUSTEP
1629 return build_string ("GNU");
1631 return build_string ("Apple");
1636 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1637 doc: /* Return the version numbers of the server of DISPLAY.
1638 The value is a list of three integers: the major and minor
1639 version numbers of the X Protocol in use, and the distributor-specific
1640 release number. See also the function `x-server-vendor'.
1642 The optional argument DISPLAY specifies which display to ask about.
1643 DISPLAY should be either a frame or a display name (a string).
1644 If omitted or nil, that stands for the selected frame's display. */)
1645 (Lisp_Object display)
1647 /*NOTE: it is unclear what would best correspond with "protocol";
1648 we return 10.3, meaning Panther, since this is roughly the
1649 level that GNUstep's APIs correspond to.
1650 The last number is where we distinguish between the Apple
1651 and GNUstep implementations ("distributor-specific release
1652 number") and give int'ized versions of major.minor. */
1653 return Fcons (make_number (10),
1654 Fcons (make_number (3),
1655 Fcons (make_number (ns_appkit_version_int()), Qnil)));
1659 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1660 doc: /* Return the number of screens on Nextstep display server DISPLAY.
1661 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1662 If omitted or nil, the selected frame's display is used. */)
1663 (Lisp_Object display)
1668 num = [[NSScreen screens] count];
1670 return (num != 0) ? make_number (num) : Qnil;
1674 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1676 doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1677 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1678 If omitted or nil, the selected frame's display is used. */)
1679 (Lisp_Object display)
1682 return make_number ((int)
1683 ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1687 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1689 doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1690 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1691 If omitted or nil, the selected frame's display is used. */)
1692 (Lisp_Object display)
1695 return make_number ((int)
1696 ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1700 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1701 Sx_display_backing_store, 0, 1, 0,
1702 doc: /* Return whether the Nextstep display DISPLAY supports backing store.
1703 The value may be `buffered', `retained', or `non-retained'.
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)
1709 switch ([ns_get_window (display) backingType])
1711 case NSBackingStoreBuffered:
1712 return intern ("buffered");
1713 case NSBackingStoreRetained:
1714 return intern ("retained");
1715 case NSBackingStoreNonretained:
1716 return intern ("non-retained");
1718 error ("Strange value for backingType parameter of frame");
1720 return Qnil; /* not reached, shut compiler up */
1724 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1725 Sx_display_visual_class, 0, 1, 0,
1726 doc: /* Return the visual class of the Nextstep display server DISPLAY.
1727 The value is one of the symbols `static-gray', `gray-scale',
1728 `static-color', `pseudo-color', `true-color', or `direct-color'.
1729 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1730 If omitted or nil, the selected frame's display is used. */)
1731 (Lisp_Object display)
1733 NSWindowDepth depth;
1735 depth = [ns_get_screen (display) depth];
1737 if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1738 return intern ("static-gray");
1739 else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1740 return intern ("gray-scale");
1741 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1742 return intern ("pseudo-color");
1743 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1744 return intern ("true-color");
1745 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1746 return intern ("direct-color");
1748 /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1749 return intern ("direct-color");
1753 DEFUN ("x-display-save-under", Fx_display_save_under,
1754 Sx_display_save_under, 0, 1, 0,
1755 doc: /* Return t if DISPLAY supports the save-under feature.
1756 The optional argument DISPLAY specifies which display to ask about.
1757 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1758 If omitted or nil, the selected frame's display is used. */)
1759 (Lisp_Object display)
1762 switch ([ns_get_window (display) backingType])
1764 case NSBackingStoreBuffered:
1767 case NSBackingStoreRetained:
1768 case NSBackingStoreNonretained:
1772 error ("Strange value for backingType parameter of frame");
1774 return Qnil; /* not reached, shut compiler up */
1778 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1780 doc: /* Open a connection to a display server.
1781 DISPLAY is the name of the display to connect to.
1782 Optional second arg XRM-STRING is a string of resources in xrdb format.
1783 If the optional third arg MUST-SUCCEED is non-nil,
1784 terminate Emacs if we can't open the connection.
1785 \(In the Nextstep version, the last two arguments are currently ignored.) */)
1786 (Lisp_Object display, Lisp_Object resource_string, Lisp_Object must_succeed)
1788 struct ns_display_info *dpyinfo;
1790 CHECK_STRING (display);
1792 nxatoms_of_nsselect ();
1793 dpyinfo = ns_term_init (display);
1796 if (!NILP (must_succeed))
1797 fatal ("OpenStep on %s not responding.\n",
1800 error ("OpenStep on %s not responding.\n",
1804 /* Register our external input/output types, used for determining
1805 applicable services and also drag/drop eligibility. */
1806 ns_send_types = [[NSArray arrayWithObjects: NSStringPboardType, nil] retain];
1807 ns_return_types = [[NSArray arrayWithObjects: NSStringPboardType, nil]
1809 ns_drag_types = [[NSArray arrayWithObjects:
1811 NSTabularTextPboardType,
1812 NSFilenamesPboardType,
1815 NSFontPboardType, nil] retain];
1821 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1823 doc: /* Close the connection to the current Nextstep display server.
1824 The argument DISPLAY is currently ignored. */)
1825 (Lisp_Object display)
1828 /*ns_delete_terminal (dpyinfo->terminal); */
1829 [NSApp terminate: NSApp];
1834 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1835 doc: /* Return the list of display names that Emacs has connections to. */)
1838 Lisp_Object tail, result;
1841 for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1842 result = Fcons (XCAR (XCAR (tail)), result);
1848 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1850 doc: /* Hides all applications other than Emacs. */)
1854 [NSApp hideOtherApplications: NSApp];
1858 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1860 doc: /* If ON is non-nil, the entire Emacs application is hidden.
1861 Otherwise if Emacs is hidden, it is unhidden.
1862 If ON is equal to `activate', Emacs is unhidden and becomes
1863 the active application. */)
1867 if (EQ (on, intern ("activate")))
1869 [NSApp unhide: NSApp];
1870 [NSApp activateIgnoringOtherApps: YES];
1873 [NSApp unhide: NSApp];
1875 [NSApp hide: NSApp];
1880 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1882 doc: /* Shows the 'Info' or 'About' panel for Emacs. */)
1886 [NSApp orderFrontStandardAboutPanel: nil];
1891 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1892 doc: /* Determine font PostScript or family name for font NAME.
1893 NAME should be a string containing either the font name or an XLFD
1894 font descriptor. If string contains `fontset' and not
1895 `fontset-startup', it is left alone. */)
1899 CHECK_STRING (name);
1904 if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1907 return build_string (ns_xlfd_to_fontname (SDATA (name)));
1911 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1912 doc: /* Return a list of all available colors.
1913 The optional argument FRAME is currently ignored. */)
1916 Lisp_Object list = Qnil;
1917 NSEnumerator *colorlists;
1922 CHECK_FRAME (frame);
1923 if (! FRAME_NS_P (XFRAME (frame)))
1924 error ("non-Nextstep frame used in `ns-list-colors'");
1929 colorlists = [[NSColorList availableColorLists] objectEnumerator];
1930 while (clist = [colorlists nextObject])
1932 if ([[clist name] length] < 7 ||
1933 [[clist name] rangeOfString: @"PANTONE"].location == 0)
1935 NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1937 while (cname = [cnames nextObject])
1938 list = Fcons (build_string ([cname UTF8String]), list);
1939 /* for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1940 list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1941 UTF8String]), list); */
1951 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1952 doc: /* List available Nextstep services by querying NSApp. */)
1955 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
1956 /* You can't get services like this in 10.6+. */
1959 Lisp_Object ret = Qnil;
1964 svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1965 [NSApp setServicesMenu: svcs]; /* this and next rebuild on <10.4 */
1966 [NSApp registerServicesMenuSendTypes: ns_send_types
1967 returnTypes: ns_return_types];
1969 /* On Tiger, services menu updating was made lazier (waits for user to
1970 actually click on the menu), so we have to force things along: */
1971 #ifdef NS_IMPL_COCOA
1972 if (NSAppKitVersionNumber >= 744.0)
1974 delegate = [svcs delegate];
1975 if (delegate != nil)
1977 if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1978 [delegate menuNeedsUpdate: svcs];
1979 if ([delegate respondsToSelector:
1980 @selector (menu:updateItem:atIndex:shouldCancel:)])
1982 int i, len = [delegate numberOfItemsInMenu: svcs];
1983 for (i =0; i<len; i++)
1984 [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1985 for (i =0; i<len; i++)
1986 if (![delegate menu: svcs
1987 updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1988 atIndex: i shouldCancel: NO])
1995 [svcs setAutoenablesItems: NO];
1996 #ifdef NS_IMPL_COCOA
1997 [svcs update]; /* on OS X, converts from '/' structure */
2000 ret = interpret_services_menu (svcs, Qnil, ret);
2006 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
2008 doc: /* Perform Nextstep SERVICE on SEND.
2009 SEND should be either a string or nil.
2010 The return value is the result of the service, as string, or nil if
2011 there was no result. */)
2012 (Lisp_Object service, Lisp_Object send)
2019 CHECK_STRING (service);
2022 utfStr = SDATA (service);
2023 svcName = [NSString stringWithUTF8String: utfStr];
2025 pb =[NSPasteboard pasteboardWithUniqueName];
2026 ns_string_to_pasteboard (pb, send);
2028 if (NSPerformService (svcName, pb) == NO)
2029 Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
2031 if ([[pb types] count] == 0)
2032 return build_string ("");
2033 return ns_string_from_pasteboard (pb);
2037 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
2038 Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
2039 doc: /* Return an NFC string that matches the UTF-8 NFD string STR. */)
2042 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
2047 utfStr = [NSString stringWithUTF8String: SDATA (str)];
2048 if (![utfStr respondsToSelector:
2049 @selector (precomposedStringWithCanonicalMapping)])
2052 ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
2056 utfStr = [utfStr precomposedStringWithCanonicalMapping];
2057 return build_string ([utfStr UTF8String]);
2061 #ifdef NS_IMPL_COCOA
2063 /* Compile and execute the AppleScript SCRIPT and return the error
2064 status as function value. A zero is returned if compilation and
2065 execution is successful, in which case *RESULT is set to a Lisp
2066 string or a number containing the resulting script value. Otherwise,
2069 ns_do_applescript (Lisp_Object script, Lisp_Object *result)
2071 NSAppleEventDescriptor *desc;
2072 NSDictionary* errorDict;
2073 NSAppleEventDescriptor* returnDescriptor = NULL;
2075 NSAppleScript* scriptObject =
2076 [[NSAppleScript alloc] initWithSource:
2077 [NSString stringWithUTF8String: SDATA (script)]];
2079 returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2080 [scriptObject release];
2084 if (returnDescriptor != NULL)
2086 // successful execution
2087 if (kAENullEvent != [returnDescriptor descriptorType])
2090 // script returned an AppleScript result
2091 if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2092 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
2093 (typeUTF16ExternalRepresentation
2094 == [returnDescriptor descriptorType]) ||
2096 (typeUTF8Text == [returnDescriptor descriptorType]) ||
2097 (typeCString == [returnDescriptor descriptorType]))
2099 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2101 *result = build_string([[desc stringValue] UTF8String]);
2105 /* use typeUTF16ExternalRepresentation? */
2106 // coerce the result to the appropriate ObjC type
2107 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2109 *result = make_number([desc int32Value]);
2115 // no script result, return error
2121 /* Helper function called from sendEvent to run applescript
2122 from within the main event loop. */
2125 ns_run_ascript (void)
2127 as_status = ns_do_applescript (as_script, as_result);
2130 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2131 doc: /* Execute AppleScript SCRIPT and return the result.
2132 If compilation and execution are successful, the resulting script value
2133 is returned as a string, a number or, in the case of other constructs, t.
2134 In case the execution fails, an error is signaled. */)
2135 (Lisp_Object script)
2141 CHECK_STRING (script);
2147 as_result = &result;
2149 /* executing apple script requires the event loop to run, otherwise
2150 errors aren't returned and executeAndReturnError hangs forever.
2151 Post an event that runs applescript and then start the event loop.
2152 The event loop is exited when the script is done. */
2153 nxev = [NSEvent otherEventWithType: NSApplicationDefined
2154 location: NSMakePoint (0, 0)
2157 windowNumber: [[NSApp mainWindow] windowNumber]
2158 context: [NSApp context]
2161 data2: NSAPP_DATA2_RUNASSCRIPT];
2163 [NSApp postEvent: nxev atStart: NO];
2173 else if (!STRINGP (result))
2174 error ("AppleScript error %d", status);
2176 error ("%s", SDATA (result));
2182 /* ==========================================================================
2184 Miscellaneous functions not called through hooks
2186 ========================================================================== */
2189 /* called from image.c */
2191 check_x_frame (Lisp_Object frame)
2193 return check_ns_frame (frame);
2197 /* called from frame.c */
2198 struct ns_display_info *
2199 check_x_display_info (Lisp_Object frame)
2201 return check_ns_display_info (frame);
2206 x_set_scroll_bar_default_width (struct frame *f)
2208 int wid = FRAME_COLUMN_WIDTH (f);
2209 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2210 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2215 /* terms impl this instead of x-get-resource directly */
2217 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2219 /* remove appname prefix; TODO: allow for !="Emacs" */
2220 char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2224 if (inhibit_x_resources)
2225 /* --quick was passed, so this is a no-op. */
2228 res = ns_get_defaults_value (toCheck);
2229 return !res ? NULL :
2230 (!c_strncasecmp (res, "YES", 3) ? "true" :
2231 (!c_strncasecmp (res, "NO", 2) ? "false" : res));
2236 x_get_focus_frame (struct frame *frame)
2238 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2239 Lisp_Object nsfocus;
2241 if (!dpyinfo->x_focus_frame)
2244 XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2250 x_pixel_width (struct frame *f)
2252 return FRAME_PIXEL_WIDTH (f);
2257 x_pixel_height (struct frame *f)
2259 return FRAME_PIXEL_HEIGHT (f);
2264 x_char_width (struct frame *f)
2266 return FRAME_COLUMN_WIDTH (f);
2271 x_char_height (struct frame *f)
2273 return FRAME_LINE_HEIGHT (f);
2278 x_screen_planes (struct frame *f)
2280 return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2285 x_sync (struct frame *f)
2287 /* XXX Not implemented XXX */
2293 /* ==========================================================================
2295 Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2297 ========================================================================== */
2300 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2301 doc: /* Internal function called by `color-defined-p', which see.
2302 \(Note that the Nextstep version of this function ignores FRAME.) */)
2303 (Lisp_Object color, Lisp_Object frame)
2307 return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2311 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2312 doc: /* Internal function called by `color-values', which see. */)
2313 (Lisp_Object color, Lisp_Object frame)
2316 CGFloat red, green, blue, alpha;
2319 CHECK_STRING (color);
2321 if (ns_lisp_to_color (color, &col))
2324 [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2325 getRed: &red green: &green blue: &blue alpha: &alpha];
2326 return list3 (make_number (lrint (red*65280)),
2327 make_number (lrint (green*65280)),
2328 make_number (lrint (blue*65280)));
2332 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2333 doc: /* Internal function called by `display-color-p', which see. */)
2334 (Lisp_Object display)
2336 NSWindowDepth depth;
2337 NSString *colorSpace;
2339 depth = [ns_get_screen (display) depth];
2340 colorSpace = NSColorSpaceFromDepth (depth);
2342 return [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2343 || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2348 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2349 Sx_display_grayscale_p, 0, 1, 0,
2350 doc: /* Return t if the Nextstep display supports shades of gray.
2351 Note that color displays do support shades of gray.
2352 The optional argument DISPLAY specifies which display to ask about.
2353 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2354 If omitted or nil, that stands for the selected frame's display. */)
2355 (Lisp_Object display)
2357 NSWindowDepth depth;
2359 depth = [ns_get_screen (display) depth];
2361 return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2365 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2367 doc: /* Return the width in pixels of the Nextstep display DISPLAY.
2368 The optional argument DISPLAY specifies which display to ask about.
2369 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2370 If omitted or nil, that stands for the selected frame's display. */)
2371 (Lisp_Object display)
2374 return make_number ((int) [ns_get_screen (display) frame].size.width);
2378 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2379 Sx_display_pixel_height, 0, 1, 0,
2380 doc: /* Return the height in pixels of the Nextstep display DISPLAY.
2381 The optional argument DISPLAY specifies which display to ask about.
2382 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2383 If omitted or nil, that stands for the selected frame's display. */)
2384 (Lisp_Object display)
2387 return make_number ((int) [ns_get_screen (display) frame].size.height);
2391 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2392 Sns_display_usable_bounds, 0, 1, 0,
2393 doc: /* Return the bounds of the usable part of the screen.
2394 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2395 are the boundaries of the usable part of the screen, excluding areas
2396 reserved for the Mac menu, dock, and so forth.
2398 The screen queried corresponds to DISPLAY, which should be either a
2399 frame, a display name (a string), or terminal ID. If omitted or nil,
2400 that stands for the selected frame's display. */)
2401 (Lisp_Object display)
2408 screen = ns_get_screen (display);
2412 vScreen = [screen visibleFrame];
2414 /* NS coordinate system is upside-down.
2415 Transform to screen-specific coordinates. */
2416 return list4 (make_number ((int) vScreen.origin.x),
2417 make_number ((int) [screen frame].size.height
2418 - vScreen.size.height - vScreen.origin.y),
2419 make_number ((int) vScreen.size.width),
2420 make_number ((int) vScreen.size.height));
2424 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2426 doc: /* Return the number of bitplanes of the Nextstep display DISPLAY.
2427 The optional argument DISPLAY specifies which display to ask about.
2428 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2429 If omitted or nil, that stands for the selected frame's display. */)
2430 (Lisp_Object display)
2434 (NSBitsPerPixelFromDepth ([ns_get_screen (display) depth]));
2438 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2439 Sx_display_color_cells, 0, 1, 0,
2440 doc: /* Returns the number of color cells of the Nextstep display DISPLAY.
2441 The optional argument DISPLAY specifies which display to ask about.
2442 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2443 If omitted or nil, that stands for the selected frame's display. */)
2444 (Lisp_Object display)
2446 struct ns_display_info *dpyinfo;
2449 dpyinfo = check_ns_display_info (display);
2450 /* We force 24+ bit depths to 24-bit to prevent an overflow. */
2451 return make_number (1 << min (dpyinfo->n_planes, 24));
2455 /* Unused dummy def needed for compatibility. */
2456 Lisp_Object tip_frame;
2458 /* TODO: move to xdisp or similar */
2460 compute_tip_xy (struct frame *f,
2469 Lisp_Object left, top;
2470 EmacsView *view = FRAME_NS_VIEW (f);
2473 /* Start with user-specified or mouse position. */
2474 left = Fcdr (Fassq (Qleft, parms));
2475 top = Fcdr (Fassq (Qtop, parms));
2477 if (!INTEGERP (left) || !INTEGERP (top))
2479 pt = last_mouse_motion_position;
2480 /* Convert to screen coordinates */
2481 pt = [view convertPoint: pt toView: nil];
2482 pt = [[view window] convertBaseToScreen: pt];
2486 /* Absolute coordinates. */
2488 pt.y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - XINT (top)
2492 /* Ensure in bounds. (Note, screen origin = lower left.) */
2493 if (INTEGERP (left))
2495 else if (pt.x + XINT (dx) <= 0)
2496 *root_x = 0; /* Can happen for negative dx */
2497 else if (pt.x + XINT (dx) + width
2498 <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2499 /* It fits to the right of the pointer. */
2500 *root_x = pt.x + XINT (dx);
2501 else if (width + XINT (dx) <= pt.x)
2502 /* It fits to the left of the pointer. */
2503 *root_x = pt.x - width - XINT (dx);
2505 /* Put it left justified on the screen -- it ought to fit that way. */
2510 else if (pt.y - XINT (dy) - height >= 0)
2511 /* It fits below the pointer. */
2512 *root_y = pt.y - height - XINT (dy);
2513 else if (pt.y + XINT (dy) + height
2514 <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2515 /* It fits above the pointer */
2516 *root_y = pt.y + XINT (dy);
2518 /* Put it on the top. */
2519 *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2523 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2524 doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2525 A tooltip window is a small window displaying a string.
2527 This is an internal function; Lisp code should call `tooltip-show'.
2529 FRAME nil or omitted means use the selected frame.
2531 PARMS is an optional list of frame parameters which can be used to
2532 change the tooltip's appearance.
2534 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
2535 means use the default timeout of 5 seconds.
2537 If the list of frame parameters PARMS contains a `left' parameter,
2538 the tooltip is displayed at that x-position. Otherwise it is
2539 displayed at the mouse position, with offset DX added (default is 5 if
2540 DX isn't specified). Likewise for the y-position; if a `top' frame
2541 parameter is specified, it determines the y-position of the tooltip
2542 window, otherwise it is displayed at the mouse position, with offset
2543 DY added (default is -10).
2545 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2546 Text larger than the specified size is clipped. */)
2547 (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
2550 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2551 ptrdiff_t count = SPECPDL_INDEX ();
2556 specbind (Qinhibit_redisplay, Qt);
2558 GCPRO4 (string, parms, frame, timeout);
2560 CHECK_STRING (string);
2561 str = SDATA (string);
2562 f = check_x_frame (frame);
2564 timeout = make_number (5);
2566 CHECK_NATNUM (timeout);
2569 dx = make_number (5);
2574 dy = make_number (-10);
2579 if (ns_tooltip == nil)
2580 ns_tooltip = [[EmacsTooltip alloc] init];
2584 [ns_tooltip setText: str];
2585 size = [ns_tooltip frame].size;
2587 /* Move the tooltip window where the mouse pointer is. Resize and
2589 compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2592 [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2596 return unbind_to (count, Qnil);
2600 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2601 doc: /* Hide the current tooltip window, if there is any.
2602 Value is t if tooltip was open, nil otherwise. */)
2605 if (ns_tooltip == nil || ![ns_tooltip isActive])
2612 /* ==========================================================================
2614 Class implementations
2616 ========================================================================== */
2619 @implementation EmacsSavePanel
2620 #ifdef NS_IMPL_COCOA
2621 /* --------------------------------------------------------------------------
2622 These are overridden to intercept on OS X: ending panel restarts NSApp
2623 event loop if it is stopped. Not sure if this is correct behavior,
2624 perhaps should check if running and if so send an appdefined.
2625 -------------------------------------------------------------------------- */
2626 - (void) ok: (id)sender
2632 - (void) cancel: (id)sender
2634 [super cancel: sender];
2641 @implementation EmacsOpenPanel
2642 #ifdef NS_IMPL_COCOA
2643 /* --------------------------------------------------------------------------
2644 These are overridden to intercept on OS X: ending panel restarts NSApp
2645 event loop if it is stopped. Not sure if this is correct behavior,
2646 perhaps should check if running and if so send an appdefined.
2647 -------------------------------------------------------------------------- */
2648 - (void) ok: (id)sender
2654 - (void) cancel: (id)sender
2656 [super cancel: sender];
2663 @implementation EmacsFileDelegate
2664 /* --------------------------------------------------------------------------
2665 Delegate methods for Open/Save panels
2666 -------------------------------------------------------------------------- */
2667 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2671 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2675 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2676 confirmed: (BOOL)okFlag
2685 /* ==========================================================================
2687 Lisp interface declaration
2689 ========================================================================== */
2693 syms_of_nsfns (void)
2697 Qfontsize = intern_c_string ("fontsize");
2698 staticpro (&Qfontsize);
2700 DEFVAR_LISP ("ns-icon-type-alist", Vns_icon_type_alist,
2701 doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2702 If the title of a frame matches REGEXP, then IMAGE.tiff is
2703 selected as the image of the icon representing the frame when it's
2704 miniaturized. If an element is t, then Emacs tries to select an icon
2705 based on the filetype of the visited file.
2707 The images have to be installed in a folder called English.lproj in the
2708 Emacs folder. You have to restart Emacs after installing new icons.
2710 Example: Install an icon Gnus.tiff and execute the following code
2712 (setq ns-icon-type-alist
2713 (append ns-icon-type-alist
2714 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2717 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2718 be used as the image of the icon representing the frame. */);
2719 Vns_icon_type_alist = Fcons (Qt, Qnil);
2721 DEFVAR_LISP ("ns-version-string", Vns_version_string,
2722 doc: /* Toolkit version for NS Windowing. */);
2723 Vns_version_string = ns_appkit_version_str ();
2725 defsubr (&Sns_read_file_name);
2726 defsubr (&Sns_get_resource);
2727 defsubr (&Sns_set_resource);
2728 defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2729 defsubr (&Sx_display_grayscale_p);
2730 defsubr (&Sns_font_name);
2731 defsubr (&Sns_list_colors);
2732 #ifdef NS_IMPL_COCOA
2733 defsubr (&Sns_do_applescript);
2735 defsubr (&Sxw_color_defined_p);
2736 defsubr (&Sxw_color_values);
2737 defsubr (&Sx_server_max_request_size);
2738 defsubr (&Sx_server_vendor);
2739 defsubr (&Sx_server_version);
2740 defsubr (&Sx_display_pixel_width);
2741 defsubr (&Sx_display_pixel_height);
2742 defsubr (&Sns_display_usable_bounds);
2743 defsubr (&Sx_display_mm_width);
2744 defsubr (&Sx_display_mm_height);
2745 defsubr (&Sx_display_screens);
2746 defsubr (&Sx_display_planes);
2747 defsubr (&Sx_display_color_cells);
2748 defsubr (&Sx_display_visual_class);
2749 defsubr (&Sx_display_backing_store);
2750 defsubr (&Sx_display_save_under);
2751 defsubr (&Sx_create_frame);
2752 defsubr (&Sx_open_connection);
2753 defsubr (&Sx_close_connection);
2754 defsubr (&Sx_display_list);
2756 defsubr (&Sns_hide_others);
2757 defsubr (&Sns_hide_emacs);
2758 defsubr (&Sns_emacs_info_panel);
2759 defsubr (&Sns_list_services);
2760 defsubr (&Sns_perform_service);
2761 defsubr (&Sns_convert_utf8_nfd_to_nfc);
2762 defsubr (&Sx_focus_frame);
2763 defsubr (&Sns_popup_font_panel);
2764 defsubr (&Sns_popup_color_panel);
2766 defsubr (&Sx_show_tip);
2767 defsubr (&Sx_hide_tip);
2769 /* used only in fontset.c */
2770 check_window_system_func = check_ns;