1 /* Functions for the NeXT/Open/GNUstep and MacOSX window system.
2 Copyright (C) 1989, 1992, 1993, 1994, 2005, 2006, 2008
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 Originally by Carl Edman
22 Updated by Christian Limpach (chris@nice.ch)
23 OpenStep/Rhapsody port by Scott Bender (sbender@harmony-ds.com)
24 MacOSX/Aqua port by Christophe de Dinechin (descubes@earthlink.net)
25 GNUstep port and post-20 update by Adrian Robert (arobert@cogsci.ucsd.edu)
32 #include "blockinput.h"
37 #include "termhooks.h"
40 #include "character.h"
44 int fns_trace_num = 1;
45 #define NSTRACE(x) fprintf (stderr, "%s:%d: [%d] " #x "\n", \
46 __FILE__, __LINE__, ++fns_trace_num)
53 extern NSArray *ns_send_types, *ns_return_types, *ns_drag_types;
55 extern Lisp_Object Qforeground_color;
56 extern Lisp_Object Qbackground_color;
57 extern Lisp_Object Qcursor_color;
58 extern Lisp_Object Qinternal_border_width;
59 extern Lisp_Object Qvisibility;
60 extern Lisp_Object Qcursor_type;
61 extern Lisp_Object Qicon_type;
62 extern Lisp_Object Qicon_name;
63 extern Lisp_Object Qicon_left;
64 extern Lisp_Object Qicon_top;
65 extern Lisp_Object Qleft;
66 extern Lisp_Object Qright;
67 extern Lisp_Object Qtop;
68 extern Lisp_Object Qdisplay;
69 extern Lisp_Object Qvertical_scroll_bars;
70 extern Lisp_Object Qauto_raise;
71 extern Lisp_Object Qauto_lower;
72 extern Lisp_Object Qbox;
73 extern Lisp_Object Qscroll_bar_width;
74 extern Lisp_Object Qx_resource_name;
75 extern Lisp_Object Qface_set_after_frame_default;
76 extern Lisp_Object Qunderline, Qundefined;
77 extern Lisp_Object Qheight, Qminibuffer, Qname, Qonly, Qwidth;
78 extern Lisp_Object Qunsplittable, Qmenu_bar_lines, Qbuffer_predicate, Qtitle;
81 Lisp_Object Qbuffered;
82 Lisp_Object Qfontsize;
84 /* hack for OS X file panels */
87 /* Alist of elements (REGEXP . IMAGE) for images of icons associated
89 Lisp_Object Vns_icon_type_alist;
91 EmacsTooltip *ns_tooltip;
93 /* Need forward declaration here to preserve organizational integrity of file */
94 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
96 extern BOOL ns_in_resize;
99 /* ==========================================================================
101 Internal utility functions
103 ========================================================================== */
110 error ("OpenStep is not in use or not initialized");
114 /* Nonzero if we can use mouse menus. */
122 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
123 and checking validity for NS. */
125 check_ns_frame (Lisp_Object frame)
130 f = SELECTED_FRAME ();
133 CHECK_LIVE_FRAME (frame);
136 if (! FRAME_NS_P (f))
137 error ("non-Nextstep frame used");
142 /* Let the user specify an Nextstep display with a frame.
143 nil stands for the selected frame--or, if that is not an Nextstep frame,
144 the first Nextstep display on the list. */
145 static struct ns_display_info *
146 check_ns_display_info (Lisp_Object frame)
150 struct frame *f = SELECTED_FRAME ();
151 if (FRAME_NS_P (f) && FRAME_LIVE_P (f) )
152 return FRAME_NS_DISPLAY_INFO (f);
153 else if (x_display_list != 0)
154 return x_display_list;
156 error ("Nextstep windows are not in use or not initialized");
158 else if (INTEGERP (frame))
160 struct terminal *t = get_terminal (frame, 1);
162 if (t->type != output_ns)
163 error ("Terminal %d is not a Nextstep display", XINT (frame));
165 return t->display_info.ns;
167 else if (STRINGP (frame))
168 return ns_display_info_for_name (frame);
173 CHECK_LIVE_FRAME (frame);
175 if (! FRAME_NS_P (f))
176 error ("non-Nextstep frame used");
177 return FRAME_NS_DISPLAY_INFO (f);
179 return NULL; /* shut compiler up */
184 ns_get_window (Lisp_Object maybeFrame)
186 id view =nil, window =nil;
188 if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
189 maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
191 if (!NILP (maybeFrame))
192 view = FRAME_NS_VIEW (XFRAME (maybeFrame));
193 if (view) window =[view window];
200 ns_get_screen (Lisp_Object anythingUnderTheSun)
203 NSScreen *screen = 0;
205 struct terminal *terminal;
206 struct ns_display_info *dpyinfo;
207 struct frame *f = NULL;
210 if (INTEGERP (anythingUnderTheSun)) {
211 /* we got a terminal */
212 terminal = get_terminal (anythingUnderTheSun, 1);
213 dpyinfo = terminal->display_info.ns;
214 f = dpyinfo->x_focus_frame;
216 f = dpyinfo->x_highlight_frame;
218 } else if (FRAMEP (anythingUnderTheSun) &&
219 FRAME_NS_P (XFRAME (anythingUnderTheSun))) {
221 f = XFRAME (anythingUnderTheSun);
223 } else if (STRINGP (anythingUnderTheSun)) { /* FIXME/cl for multi-display */
227 f = SELECTED_FRAME ();
230 XSETFRAME (frame, f);
231 window = ns_get_window (frame);
235 screen = [window screen];
237 screen = [NSScreen mainScreen];
243 /* Return the X display structure for the display named NAME.
244 Open a new connection if necessary. */
245 struct ns_display_info *
246 ns_display_info_for_name (name)
250 struct ns_display_info *dpyinfo;
254 for (dpyinfo = x_display_list, names = ns_display_name_list;
256 dpyinfo = dpyinfo->next, names = XCDR (names))
259 tem = Fstring_equal (XCAR (XCAR (names)), name);
264 error ("Emacs for OpenStep does not yet support multi-display.");
266 Fx_open_connection (name, Qnil, Qnil);
267 dpyinfo = x_display_list;
270 error ("OpenStep on %s not responding.\n", SDATA (name));
277 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
278 /* --------------------------------------------------------------------------
279 Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
280 -------------------------------------------------------------------------- */
290 count = [menu numberOfItems];
291 for (i = 0; i<count; i++)
293 item = [menu itemAtIndex: i];
294 name = [[item title] UTF8String];
297 nameStr = build_string (name);
299 if ([item hasSubmenu])
301 old = interpret_services_menu ([item submenu],
302 Fcons (nameStr, prefix), old);
306 keys = [item keyEquivalent];
307 if (keys && [keys length] )
309 key = [keys characterAtIndex: 0];
310 res = make_number (key|super_modifier);
316 old = Fcons (Fcons (res,
317 Freverse (Fcons (nameStr,
327 /* ==========================================================================
329 Frame parameter setters
331 ========================================================================== */
335 ns_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
339 if (ns_lisp_to_color (arg, &col))
341 store_frame_param (f, Qforeground_color, oldval);
342 error ("Unknown color");
346 [f->output_data.ns->foreground_color release];
347 f->output_data.ns->foreground_color = col;
349 if (FRAME_NS_VIEW (f))
351 update_face_from_frame_parameter (f, Qforeground_color, arg);
352 /*recompute_basic_faces (f); */
353 if (FRAME_VISIBLE_P (f))
360 ns_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
364 NSView *view = FRAME_NS_VIEW (f);
367 if (ns_lisp_to_color (arg, &col))
369 store_frame_param (f, Qbackground_color, oldval);
370 error ("Unknown color");
373 /* clear the frame; in some instances the NS-internal GC appears not to
374 update, or it does update and cannot clear old text properly */
375 if (FRAME_VISIBLE_P (f))
379 [f->output_data.ns->background_color release];
380 f->output_data.ns->background_color = col;
383 [[view window] setBackgroundColor: col];
384 alpha = [col alphaComponent];
387 /* the alpha code below only works on 10.4, so we need to do something
388 else (albeit less good) otherwise.
389 Check NSApplication.h for useful NSAppKitVersionNumber values. */
390 if (NSAppKitVersionNumber < 744.0)
391 [[view window] setAlphaValue: alpha];
395 [[view window] setOpaque: NO];
397 [[view window] setOpaque: YES];
399 face = FRAME_DEFAULT_FACE (f);
402 col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
404 = (EMACS_UINT) [[col colorWithAlphaComponent: alpha] retain];
407 update_face_from_frame_parameter (f, Qbackground_color, arg);
410 if (FRAME_VISIBLE_P (f))
417 ns_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
421 if (ns_lisp_to_color (arg, &col))
423 store_frame_param (f, Qcursor_color, oldval);
424 error ("Unknown color");
427 [f->output_data.ns->desired_cursor_color release];
428 f->output_data.ns->desired_cursor_color = [col retain];
430 if (FRAME_VISIBLE_P (f))
432 x_update_cursor (f, 0);
433 x_update_cursor (f, 1);
435 update_face_from_frame_parameter (f, Qcursor_color, arg);
440 ns_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
442 NSView *view = FRAME_NS_VIEW (f);
443 NSTRACE (ns_set_icon_name);
448 /* see if it's changed */
451 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
454 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
461 if (!NILP (f->title))
464 /* explicit name and no icon-name -> explicit_name */
465 if (f->explicit_name)
469 /* no explicit name and no icon-name ->
470 name has to be rebuild from icon_title_format */
471 windows_or_buffers_changed++;
476 /* Don't change the name if it's already NAME. */
477 if ([[view window] miniwindowTitle] &&
478 ([[[view window] miniwindowTitle]
479 isEqualToString: [NSString stringWithUTF8String:
483 [[view window] setMiniwindowTitle:
484 [NSString stringWithUTF8String: SDATA (arg)]];
489 ns_set_name_iconic (struct frame *f, Lisp_Object name, int explicit)
491 NSView *view = FRAME_NS_VIEW (f);
492 NSTRACE (ns_set_name_iconic);
497 /* Make sure that requests from lisp code override requests from
498 Emacs redisplay code. */
501 /* If we're switching from explicit to implicit, we had better
502 update the mode lines and thereby update the title. */
503 if (f->explicit_name && NILP (name))
504 update_mode_lines = 1;
506 f->explicit_name = ! NILP (name);
508 else if (f->explicit_name)
511 /* title overrides explicit name */
512 if (! NILP (f->title))
515 /* icon_name overrides title and explicit name */
516 if (! NILP (f->icon_name))
521 ([[[NSProcessInfo processInfo] processName] UTF8String]);
525 /* Don't change the name if it's already NAME. */
526 if ([[view window] miniwindowTitle] &&
527 ([[[view window] miniwindowTitle]
528 isEqualToString: [NSString stringWithUTF8String:
532 [[view window] setMiniwindowTitle:
533 [NSString stringWithUTF8String: SDATA (name)]];
538 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
540 NSView *view = FRAME_NS_VIEW (f);
541 NSTRACE (ns_set_name);
546 /* Make sure that requests from lisp code override requests from
547 Emacs redisplay code. */
550 /* If we're switching from explicit to implicit, we had better
551 update the mode lines and thereby update the title. */
552 if (f->explicit_name && NILP (name))
553 update_mode_lines = 1;
555 f->explicit_name = ! NILP (name);
557 else if (f->explicit_name)
562 ([[[NSProcessInfo processInfo] processName] UTF8String]);
566 /* title overrides explicit name */
567 if (! NILP (f->title))
572 /* Don't change the name if it's already NAME. */
573 if ([[[view window] title]
574 isEqualToString: [NSString stringWithUTF8String:
577 [[view window] setTitle: [NSString stringWithUTF8String:
582 /* This function should be called when the user's lisp code has
583 specified a name for the frame; the name will override any set by the
586 ns_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
588 NSTRACE (ns_explicitly_set_name);
589 ns_set_name_iconic (f, arg, 1);
590 ns_set_name (f, arg, 1);
594 /* This function should be called by Emacs redisplay code to set the
595 name; names set this way will never override names set by the user's
598 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
600 NSTRACE (x_implicitly_set_name);
601 if (FRAME_ICONIFIED_P (f))
602 ns_set_name_iconic (f, arg, 0);
604 ns_set_name (f, arg, 0);
608 /* Change the title of frame F to NAME.
609 If NAME is nil, use the frame name as the title.
611 If EXPLICIT is non-zero, that indicates that lisp code is setting the
612 name; if NAME is a string, set F's name to NAME and set
613 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
615 If EXPLICIT is zero, that indicates that Emacs redisplay code is
616 suggesting a new name, which lisp code should override; if
617 F->explicit_name is set, ignore the new name; otherwise, set it. */
619 ns_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
621 NSTRACE (ns_set_title);
622 /* Don't change the title if it's already NAME. */
623 if (EQ (name, f->title))
626 update_mode_lines = 1;
633 ns_set_name_as_filename (struct frame *f)
635 NSView *view = FRAME_NS_VIEW (f);
637 Lisp_Object buf = XWINDOW (f->selected_window)->buffer;
639 NSAutoreleasePool *pool;
640 NSTRACE (ns_set_name_as_filename);
642 if (f->explicit_name || ! NILP (f->title) || ns_in_resize)
646 pool = [[NSAutoreleasePool alloc] init];
647 name =XBUFFER (buf)->filename;
648 if (NILP (name) || FRAME_ICONIFIED_P (f)) name =XBUFFER (buf)->name;
650 if (FRAME_ICONIFIED_P (f) && !NILP (f->icon_name))
655 ([[[NSProcessInfo processInfo] processName] UTF8String]);
659 title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
660 : [[[view window] title] UTF8String];
662 if (title && (! strcmp (title, SDATA (name))))
669 if (! FRAME_ICONIFIED_P (f))
672 /* work around a bug observed on 10.3 where
673 setTitleWithRepresentedFilename does not clear out previous state
674 if given filename does not exist */
675 NSString *str = [NSString stringWithUTF8String: SDATA (name)];
676 if (![[NSFileManager defaultManager] fileExistsAtPath: str])
678 [[view window] setTitleWithRepresentedFilename: @""];
679 [[view window] setTitle: str];
683 [[view window] setTitleWithRepresentedFilename: str];
686 [[view window] setTitleWithRepresentedFilename:
687 [NSString stringWithUTF8String: SDATA (name)]];
693 [[view window] setMiniwindowTitle:
694 [NSString stringWithUTF8String: SDATA (name)]];
702 ns_set_doc_edited (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
704 NSView *view = FRAME_NS_VIEW (f);
705 NSAutoreleasePool *pool;
707 pool = [[NSAutoreleasePool alloc] init];
708 [[view window] setDocumentEdited: !NILP (arg)];
715 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
718 int olines = FRAME_MENU_BAR_LINES (f);
719 if (FRAME_MINIBUF_ONLY_P (f))
722 if (INTEGERP (value))
723 nlines = XINT (value);
727 FRAME_MENU_BAR_LINES (f) = 0;
730 FRAME_EXTERNAL_MENU_BAR (f) = 1;
731 /* does for all frames, whereas we just want for one frame
732 [NSMenu setMenuBarVisible: YES]; */
736 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
737 free_frame_menubar (f);
738 /* [NSMenu setMenuBarVisible: NO]; */
739 FRAME_EXTERNAL_MENU_BAR (f) = 0;
744 /* 23: toolbar support */
746 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
749 Lisp_Object root_window;
751 if (FRAME_MINIBUF_ONLY_P (f))
754 if (INTEGERP (value) && XINT (value) >= 0)
755 nlines = XFASTINT (value);
761 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
762 update_frame_tool_bar (f);
766 if (FRAME_EXTERNAL_TOOL_BAR (f))
768 free_frame_tool_bar (f);
769 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
773 x_set_window_size (f, 0, f->text_cols, f->text_lines);
778 ns_implicitly_set_icon_type (struct frame *f)
781 EmacsView *view = FRAME_NS_VIEW (f);
783 Lisp_Object chain, elt;
784 NSAutoreleasePool *pool;
787 NSTRACE (ns_implicitly_set_icon_type);
790 pool = [[NSAutoreleasePool alloc] init];
791 if (f->output_data.ns->miniimage
792 && [[NSString stringWithUTF8String: SDATA (f->name)]
793 isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
800 tem = assq_no_quit (Qicon_type, f->param_alist);
801 if (CONSP (tem) && ! NILP (XCDR (tem)))
808 for (chain = Vns_icon_type_alist;
809 (image = nil) && CONSP (chain);
810 chain = XCDR (chain))
813 /* special case: 't' means go by file type */
814 if (SYMBOLP (elt) && EQ (elt, Qt) && SDATA (f->name)[0] == '/')
817 = [NSString stringWithUTF8String: SDATA (f->name)];
818 if ([[NSFileManager defaultManager] fileExistsAtPath: str])
819 image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
821 else if (CONSP (elt) &&
822 STRINGP (XCAR (elt)) &&
823 STRINGP (XCDR (elt)) &&
824 fast_string_match (XCAR (elt), f->name) >= 0)
826 image = [EmacsImage allocInitFromFile: XCDR (elt)];
828 image = [[NSImage imageNamed:
829 [NSString stringWithUTF8String:
830 SDATA (XCDR (elt))]] retain];
836 image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
840 [f->output_data.ns->miniimage release];
841 f->output_data.ns->miniimage = image;
842 [view setMiniwindowImage: setMini];
849 ns_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
851 EmacsView *view = FRAME_NS_VIEW (f);
855 NSTRACE (ns_set_icon_type);
857 if (!NILP (arg) && SYMBOLP (arg))
859 arg =build_string (SDATA (SYMBOL_NAME (arg)));
860 store_frame_param (f, Qicon_type, arg);
863 /* do it the implicit way */
866 ns_implicitly_set_icon_type (f);
872 image = [EmacsImage allocInitFromFile: arg];
874 image =[NSImage imageNamed: [NSString stringWithUTF8String:
879 image = [NSImage imageNamed: @"text"];
883 f->output_data.ns->miniimage = image;
884 [view setMiniwindowImage: setMini];
888 /* 23: added Xism; we stub out (we do implement this in ns-win.el) */
890 XParseGeometry (char *string, int *x, int *y,
891 unsigned int *width, unsigned int *height)
893 message1 ("Warning: XParseGeometry not supported under NS.\n");
898 /* TODO: move to nsterm? */
900 ns_lisp_to_cursor_type (Lisp_Object arg)
903 if (XTYPE (arg) == Lisp_String)
905 else if (XTYPE (arg) == Lisp_Symbol)
906 str = SDATA (SYMBOL_NAME (arg));
908 if (!strcmp (str, "box")) return filled_box;
909 if (!strcmp (str, "hollow")) return hollow_box;
910 if (!strcmp (str, "underscore")) return underscore;
911 if (!strcmp (str, "bar")) return bar;
912 if (!strcmp (str, "no")) return no_highlight;
918 ns_cursor_type_to_lisp (int arg)
922 case filled_box: return Qbox;
923 case hollow_box: return intern ("hollow");
924 case underscore: return intern ("underscore");
925 case bar: return intern ("bar");
927 default: return intern ("no");
933 ns_set_cursor_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
937 val = ns_lisp_to_cursor_type (arg);
940 f->output_data.ns->desired_cursor =val;
944 store_frame_param (f, Qcursor_type, oldval);
945 error ("the `cursor-type' frame parameter should be either `no', `box', \
946 `hollow', `underscore' or `bar'.");
953 /* 23: called to set mouse pointer color, but all other terms use it to
954 initialize pointer types (and don't set the color ;) */
956 ns_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
958 /* don't think we can do this on Nextstep */
963 x_icon (struct frame *f, Lisp_Object parms)
964 /* --------------------------------------------------------------------------
965 Strangely-named function to set icon position parameters in frame.
966 This is irrelevant under OS X, but might be needed under GNUstep,
967 depending on the window manager used. Note, this is not a standard
968 frame parameter-setter; it is called directly from x-create-frame.
969 -------------------------------------------------------------------------- */
971 Lisp_Object icon_x, icon_y;
972 struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
974 f->output_data.ns->icon_top = Qnil;
975 f->output_data.ns->icon_left = Qnil;
977 /* Set the position of the icon. */
978 icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
979 icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
980 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
982 CHECK_NUMBER (icon_x);
983 CHECK_NUMBER (icon_y);
984 f->output_data.ns->icon_top = icon_y;
985 f->output_data.ns->icon_left = icon_x;
987 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
988 error ("Both left and top icon corners of icon must be specified");
992 /* 23 Note: commented out ns_... entries are no longer used in 23.
993 commented out x_... entries have not been implemented yet.
994 see frame.c for template, also where all generic OK functions are impl */
995 frame_parm_handler ns_frame_parm_handlers[] =
997 x_set_autoraise, /* generic OK */
998 x_set_autolower, /* generic OK */
999 ns_set_background_color,
1000 0, /* x_set_border_color, may be impossible under Nextstep */
1001 0, /* x_set_border_width, may be impossible under Nextstep */
1002 ns_set_cursor_color,
1004 x_set_font, /* generic OK */
1005 ns_set_foreground_color,
1008 x_set_internal_border_width, /* generic OK */
1009 x_set_menu_bar_lines,
1011 ns_explicitly_set_name,
1012 x_set_scroll_bar_width, /* generic OK */
1014 x_set_unsplittable, /* generic OK */
1015 x_set_vertical_scroll_bars, /* generic OK */
1016 x_set_visibility, /* generic OK */
1017 x_set_tool_bar_lines,
1018 0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
1019 0, /* x_set_scroll_bar_background, will ignore (not possible on NS) */
1020 x_set_screen_gamma, /* generic OK */
1021 x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
1022 x_set_fringe_width, /* generic OK */
1023 x_set_fringe_width, /* generic OK */
1024 0, /* x_set_wait_for_wm, will ignore */
1025 0, /* x_set_fullscreen will ignore */
1026 x_set_font_backend /* generic OK */
1030 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1032 doc: /* Make a new Nextstep window, called a \"frame\" in Emacs terms.
1033 Return an Emacs frame object.
1034 PARMS is an alist of frame parameters.
1035 If the parameters specify that the frame should not have a minibuffer,
1036 and do not specify a specific minibuffer window to use,
1037 then `default-minibuffer-frame' must be a frame whose minibuffer can
1038 be shared by the new frame. */)
1042 static int desc_ctr = 1;
1044 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1045 Lisp_Object frame, tem;
1047 int minibuffer_only = 0;
1048 int count = specpdl_ptr - specpdl;
1049 Lisp_Object display;
1050 struct ns_display_info *dpyinfo = NULL;
1053 Lisp_Object tfont, tfontsize;
1054 int window_prompting = 0;
1059 /* Seems a little strange, but other terms do it. Perhaps the code below
1060 is modifying something? */
1061 parms = Fcopy_alist (parms);
1063 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1064 if (EQ (display, Qunbound))
1066 dpyinfo = check_ns_display_info (display);
1068 if (!dpyinfo->terminal->name)
1069 error ("Terminal is not live, can't create new frames on it");
1071 kb = dpyinfo->terminal->kboard;
1073 name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1075 && ! EQ (name, Qunbound)
1077 error ("Invalid frame name--not a string or nil");
1080 Vx_resource_name = name;
1082 Vx_resource_name = Vinvocation_name;
1084 parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1085 if (EQ (parent, Qunbound))
1087 if (! NILP (parent))
1088 CHECK_NUMBER (parent);
1091 GCPRO4 (parms, parent, name, frame);
1093 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1095 if (EQ (tem, Qnone) || NILP (tem))
1097 f = make_frame_without_minibuffer (Qnil, kb, display);
1099 else if (EQ (tem, Qonly))
1101 f = make_minibuffer_frame ();
1102 minibuffer_only = 1;
1104 else if (WINDOWP (tem))
1106 f = make_frame_without_minibuffer (tem, kb, display);
1113 /* Set the name; the functions to which we pass f expect the name to
1115 if (EQ (name, Qunbound) || NILP (name) || (XTYPE (name) != Lisp_String))
1118 = build_string ([[[NSProcessInfo processInfo] processName] UTF8String]);
1119 f->explicit_name =0;
1124 f->explicit_name = 1;
1125 specbind (Qx_resource_name, name);
1128 XSETFRAME (frame, f);
1129 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
1131 f->terminal = dpyinfo->terminal;
1132 f->terminal->reference_count++;
1134 f->output_method = output_ns;
1135 f->output_data.ns = (struct ns_output *)xmalloc (sizeof *(f->output_data.ns));
1136 bzero (f->output_data.ns, sizeof (*(f->output_data.ns)));
1138 FRAME_FONTSET (f) = -1;
1140 /* record_unwind_protect (unwind_create_frame, frame); safety; maybe later? */
1142 f->icon_name = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
1144 if (! STRINGP (f->icon_name))
1145 f->icon_name = Qnil;
1147 FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1149 f->output_data.ns->window_desc = desc_ctr++;
1152 f->output_data.ns->parent_desc = (Window) XFASTINT (parent);
1153 f->output_data.ns->explicit_parent = 1;
1157 f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1158 f->output_data.ns->explicit_parent = 0;
1161 f->resx = dpyinfo->resx;
1162 f->resy = dpyinfo->resy;
1165 register_font_driver (&nsfont_driver, f);
1166 x_default_parameter (f, parms, Qfont_backend, Qnil,
1167 "fontBackend", "FontBackend", RES_TYPE_STRING);
1170 /* use for default font name */
1171 id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1172 tfontsize = x_default_parameter (f, parms, Qfontsize,
1173 make_number (0 /*(int)[font pointSize]*/),
1174 "fontSize", "FontSize", RES_TYPE_NUMBER);
1175 tfont = x_default_parameter (f, parms, Qfont,
1176 build_string ([[font fontName] UTF8String]),
1177 "font", "Font", RES_TYPE_STRING);
1181 x_default_parameter (f, parms, Qborder_width, make_number (0),
1182 "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1183 x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1184 "internalBorderWidth", "InternalBorderWidth",
1187 /* default scrollbars on right on Mac */
1190 #ifdef NS_IMPL_GNUSTEP
1195 x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1196 "verticalScrollBars", "VerticalScrollBars",
1199 x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1200 "foreground", "Foreground", RES_TYPE_STRING);
1201 x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1202 "background", "Background", RES_TYPE_STRING);
1203 x_default_parameter (f, parms, Qcursor_color, build_string ("grey"),
1204 "cursorColor", "CursorColor", RES_TYPE_STRING);
1205 /* FIXME: not suppported yet in Nextstep */
1206 x_default_parameter (f, parms, Qline_spacing, Qnil,
1207 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1208 x_default_parameter (f, parms, Qleft_fringe, Qnil,
1209 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1210 x_default_parameter (f, parms, Qright_fringe, Qnil,
1211 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1214 init_frame_faces (f);
1216 x_default_parameter (f, parms, Qmenu_bar_lines, make_number (0), "menuBar",
1217 "menuBar", RES_TYPE_NUMBER);
1218 x_default_parameter (f, parms, Qtool_bar_lines, make_number (0), "toolBar",
1219 "toolBar", RES_TYPE_NUMBER);
1220 x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1221 "BufferPredicate", RES_TYPE_SYMBOL);
1222 x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1225 /* TODO: other terms seem to get away w/o this complexity.. */
1226 if (NILP (Fassq (Qwidth, parms)))
1229 = x_get_arg (dpyinfo, parms, Qwidth, "width", "Width",
1231 if (! EQ (value, Qunbound))
1232 parms = Fcons (Fcons (Qwidth, value), parms);
1234 if (NILP (Fassq (Qheight, parms)))
1237 = x_get_arg (dpyinfo, parms, Qheight, "height", "Height",
1239 if (! EQ (value, Qunbound))
1240 parms = Fcons (Fcons (Qheight, value), parms);
1242 if (NILP (Fassq (Qleft, parms)))
1245 = x_get_arg (dpyinfo, parms, Qleft, "left", "Left", RES_TYPE_NUMBER);
1246 if (! EQ (value, Qunbound))
1247 parms = Fcons (Fcons (Qleft, value), parms);
1249 if (NILP (Fassq (Qtop, parms)))
1252 = x_get_arg (dpyinfo, parms, Qtop, "top", "Top", RES_TYPE_NUMBER);
1253 if (! EQ (value, Qunbound))
1254 parms = Fcons (Fcons (Qtop, value), parms);
1257 window_prompting = x_figure_window_size (f, parms, 1);
1259 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1260 f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1262 /* NOTE: on other terms, this is done in set_mouse_color, however this
1263 was not getting called under Nextstep */
1264 f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1265 f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1266 f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1267 f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1268 f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1269 f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1270 FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1271 = [NSCursor arrowCursor];
1272 f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1274 [[EmacsView alloc] initFrameFromEmacs: f];
1278 /* It is now ok to make the frame official even if we get an error below.
1279 The frame needs to be on Vframe_list or making it visible won't work. */
1280 Vframe_list = Fcons (frame, Vframe_list);
1281 /*FRAME_NS_DISPLAY_INFO (f)->reference_count++; */
1283 x_default_parameter (f, parms, Qicon_type, Qnil, "bitmapIcon", "BitmapIcon",
1285 x_default_parameter (f, parms, Qauto_raise, Qnil, "autoRaise", "AutoRaiseLower",
1287 x_default_parameter (f, parms, Qauto_lower, Qnil, "autoLower", "AutoLower",
1289 x_default_parameter (f, parms, Qcursor_type, Qbox, "cursorType", "CursorType",
1291 x_default_parameter (f, parms, Qscroll_bar_width, Qnil, "scrollBarWidth",
1292 "ScrollBarWidth", RES_TYPE_NUMBER);
1293 x_default_parameter (f, parms, Qalpha, Qt, "alpha", "Alpha",
1296 width = FRAME_COLS (f);
1297 height = FRAME_LINES (f);
1299 SET_FRAME_COLS (f, 0);
1300 FRAME_LINES (f) = 0;
1301 change_frame_size (f, height, width, 1, 0, 0);
1303 if (! f->output_data.ns->explicit_parent)
1305 tem = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_BOOLEAN);
1306 if (EQ (tem, Qunbound))
1309 x_set_visibility (f, tem, Qnil);
1311 [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1314 if (FRAME_HAS_MINIBUF_P (f)
1315 && (!FRAMEP (kb->Vdefault_minibuffer_frame)
1316 || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
1317 kb->Vdefault_minibuffer_frame = frame;
1319 /* All remaining specified parameters, which have not been "used"
1320 by x_get_arg and friends, now go in the misc. alist of the frame. */
1321 for (tem = parms; CONSP (tem); tem = XCDR (tem))
1322 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1323 f->param_alist = Fcons (XCAR (tem), f->param_alist);
1326 Vwindow_list = Qnil;
1328 return unbind_to (count, frame);
1332 /* ==========================================================================
1336 ========================================================================== */
1338 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1339 doc: /* Set the input focus to FRAME.
1340 FRAME nil means use the selected frame. */)
1344 struct frame *f = check_ns_frame (frame);
1345 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1347 if (dpyinfo->x_focus_frame != f)
1349 EmacsView *view = FRAME_NS_VIEW (f);
1351 [[view window] makeKeyAndOrderFront: view];
1359 DEFUN ("ns-popup-prefs-panel", Fns_popup_prefs_panel, Sns_popup_prefs_panel,
1361 doc: /* Pop up the preferences panel. */)
1365 [(EmacsApp *)NSApp showPreferencesWindow: NSApp];
1370 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1372 doc: /* Pop up the font panel. */)
1380 fm = [NSFontManager new];
1382 f = SELECTED_FRAME ();
1385 CHECK_FRAME (frame);
1389 [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1391 [fm orderFrontFontPanel: NSApp];
1396 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1398 doc: /* Pop up the color panel. */)
1406 f = SELECTED_FRAME ();
1409 CHECK_FRAME (frame);
1413 [NSApp orderFrontColorPanel: NSApp];
1418 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 4, 0,
1419 doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1420 Optional arg DIR, if non-nil, supplies a default directory.
1421 Optional arg ISLOAD, if non-nil, means read a file name for saving.
1422 Optional arg INIT, if non-nil, provides a default file name to use. */)
1423 (prompt, dir, isLoad, init)
1424 Lisp_Object prompt, dir, isLoad, init;
1426 static id fileDelegate = nil;
1431 NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1432 [NSString stringWithUTF8String: SDATA (prompt)];
1433 NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1434 [NSString stringWithUTF8String: SDATA (current_buffer->directory)] :
1435 [NSString stringWithUTF8String: SDATA (dir)];
1436 NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1437 [NSString stringWithUTF8String: SDATA (init)];
1441 if (fileDelegate == nil)
1442 fileDelegate = [EmacsFileDelegate new];
1444 [NSCursor setHiddenUntilMouseMoves: NO];
1446 if ([dirS characterAtIndex: 0] == '~')
1447 dirS = [dirS stringByExpandingTildeInPath];
1449 panel = NILP (isLoad) ?
1450 [EmacsSavePanel savePanel] : [EmacsOpenPanel openPanel];
1452 [panel setTitle: promptS];
1454 /* Puma (10.1) does not have */
1455 if ([panel respondsToSelector: @selector (setAllowsOtherFileTypes:)])
1456 [panel setAllowsOtherFileTypes: YES];
1458 [panel setTreatsFilePackagesAsDirectories: YES];
1459 [panel setDelegate: fileDelegate];
1464 ret = [panel runModalForDirectory: dirS file: initS];
1468 [panel setCanChooseDirectories: YES];
1469 ret = [panel runModalForDirectory: dirS file: initS types: nil];
1472 ret = (ret = NSOKButton) || panelOK;
1474 fname = [panel filename];
1476 [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1478 return ret ? build_string ([fname UTF8String]) : Qnil;
1482 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1483 doc: /* Return the value of the property NAME of OWNER from the defaults database.
1484 If OWNER is nil, Emacs is assumed. */)
1486 Lisp_Object owner, name;
1492 owner = build_string
1493 ([[[NSProcessInfo processInfo] processName] UTF8String]);
1494 /* CHECK_STRING (owner); this should be just "Emacs" */
1495 CHECK_STRING (name);
1496 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SDATA (name)); */
1498 value =[[[NSUserDefaults standardUserDefaults]
1499 objectForKey: [NSString stringWithUTF8String: SDATA (name)]]
1503 return build_string (value);
1508 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1509 doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1510 If OWNER is nil, Emacs is assumed.
1511 If VALUE is nil, the default is removed. */)
1512 (owner, name, value)
1513 Lisp_Object owner, name, value;
1518 = build_string ([[[NSProcessInfo processInfo] processName] UTF8String]);
1519 CHECK_STRING (owner);
1520 CHECK_STRING (name);
1523 [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1524 [NSString stringWithUTF8String: SDATA (name)]];
1528 CHECK_STRING (value);
1529 [[NSUserDefaults standardUserDefaults] setObject:
1530 [NSString stringWithUTF8String: SDATA (value)]
1531 forKey: [NSString stringWithUTF8String:
1539 DEFUN ("ns-set-alpha", Fns_set_alpha, Sns_set_alpha, 2, 2, 0,
1540 doc: /* Return a color equivalent to COLOR with alpha setting ALPHA.
1541 The argument ALPHA should be a number between 0 and 1, where 0 is full
1542 transparency and 1 is opaque. */)
1550 CHECK_STRING (color);
1551 CHECK_NUMBER_OR_FLOAT (alpha);
1553 if (ns_lisp_to_color (color, &col))
1554 error ("Unknown color.");
1556 a = XFLOATINT (alpha);
1557 if (a < 0.0 || a > 1.0)
1558 error ("Alpha value should be between 0 and 1 inclusive.");
1560 col = [col colorWithAlphaComponent: a];
1561 return ns_color_to_lisp (col);
1565 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1566 Sx_server_max_request_size,
1568 doc: /* This function is a no-op. It is only present for completeness. */)
1570 Lisp_Object display;
1573 /* This function has no real equivalent under NeXTstep. Return nil to
1579 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1580 doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1581 DISPLAY should be either a frame or a display name (a string).
1582 If omitted or nil, the selected frame's display is used. */)
1584 Lisp_Object display;
1587 #ifdef NS_IMPL_GNUSTEP
1588 return build_string ("GNU");
1590 return build_string ("Apple");
1595 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1596 doc: /* Return the version number of Nextstep display server DISPLAY.
1597 DISPLAY should be either a frame or a display name (a string).
1598 If omitted or nil, the selected frame's display is used.
1599 See also the function `ns-server-vendor'. */)
1601 Lisp_Object display;
1603 /* FIXME: return GUI version on GNUSTEP, ?? on OS X */
1604 return build_string ("1.0");
1608 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1609 doc: /* Return the number of screens on Nextstep display server DISPLAY.
1610 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1611 If omitted or nil, the selected frame's display is used. */)
1613 Lisp_Object display;
1618 num = [[NSScreen screens] count];
1620 return (num != 0) ? make_number (num) : Qnil;
1624 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1626 doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1627 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1628 If omitted or nil, the selected frame's display is used. */)
1630 Lisp_Object display;
1633 return make_number ((int)
1634 ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1638 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1640 doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1641 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1642 If omitted or nil, the selected frame's display is used. */)
1644 Lisp_Object display;
1647 return make_number ((int)
1648 ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1652 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1653 Sx_display_backing_store, 0, 1, 0,
1654 doc: /* Return whether the Nexstep display DISPLAY supports backing store.
1655 The value may be `buffered', `retained', or `non-retained'.
1656 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1657 If omitted or nil, the selected frame's display is used. */)
1659 Lisp_Object display;
1662 switch ([ns_get_window (display) backingType])
1664 case NSBackingStoreBuffered:
1665 return intern ("buffered");
1666 case NSBackingStoreRetained:
1667 return intern ("retained");
1668 case NSBackingStoreNonretained:
1669 return intern ("non-retained");
1671 error ("Strange value for backingType parameter of frame");
1673 return Qnil; /* not reached, shut compiler up */
1677 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1678 Sx_display_visual_class, 0, 1, 0,
1679 doc: /* Return the visual class of the Nextstep display server DISPLAY.
1680 The value is one of the symbols `static-gray', `gray-scale',
1681 `static-color', `pseudo-color', `true-color', or `direct-color'.
1682 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1683 If omitted or nil, the selected frame's display is used. */)
1685 Lisp_Object display;
1687 NSWindowDepth depth;
1689 depth = [ns_get_screen (display) depth];
1691 if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1692 return intern ("static-gray");
1693 else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1694 return intern ("gray-scale");
1695 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1696 return intern ("pseudo-color");
1697 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1698 return intern ("true-color");
1699 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1700 return intern ("direct-color");
1702 /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1703 return intern ("direct-color");
1707 DEFUN ("x-display-save-under", Fx_display_save_under,
1708 Sx_display_save_under, 0, 1, 0,
1709 doc: /* Non-nil if the Nextstep display server supports the save-under feature.
1710 The optional argument DISPLAY specifies which display to ask about.
1711 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1712 If omitted or nil, the selected frame's display is used. */)
1714 Lisp_Object display;
1717 switch ([ns_get_window (display) backingType])
1719 case NSBackingStoreBuffered:
1722 case NSBackingStoreRetained:
1723 case NSBackingStoreNonretained:
1727 error ("Strange value for backingType parameter of frame");
1729 return Qnil; /* not reached, shut compiler up */
1733 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1735 doc: /* Open a connection to a Nextstep display server.
1736 DISPLAY is the name of the display to connect to.
1737 Optional arguments XRM-STRING and MUST-SUCCEED are currently ignored. */)
1738 (display, resource_string, must_succeed)
1739 Lisp_Object display, resource_string, must_succeed;
1741 struct ns_display_info *dpyinfo;
1743 CHECK_STRING (display);
1745 nxatoms_of_nsselect ();
1746 dpyinfo = ns_term_init (display);
1749 if (!NILP (must_succeed))
1750 fatal ("OpenStep on %s not responding.\n",
1753 error ("OpenStep on %s not responding.\n",
1757 /* Register our external input/output types, used for determining
1758 applicable services and also drag/drop eligibility. */
1759 ns_send_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1760 ns_return_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1761 ns_drag_types = [[NSArray arrayWithObjects:
1763 NSTabularTextPboardType,
1764 NSFilenamesPboardType,
1767 NSFontPboardType, nil] retain];
1773 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1775 doc: /* Close the connection to the current Nextstep display server.
1776 The second argument DISPLAY is currently ignored. */)
1778 Lisp_Object display;
1781 #ifdef NS_IMPL_COCOA
1784 /*ns_delete_terminal (dpyinfo->terminal); */
1785 [NSApp terminate: NSApp];
1790 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1791 doc: /* Return the list of display names that Emacs has connections to. */)
1794 Lisp_Object tail, result;
1797 for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1798 result = Fcons (XCAR (XCAR (tail)), result);
1804 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1806 doc: /* Hides all applications other than emacs. */)
1810 [NSApp hideOtherApplications: NSApp];
1814 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1816 doc: /* If ON is non-nil, the entire emacs application is hidden.
1817 Otherwise if emacs is hidden, it is unhidden.
1818 If ON is equal to `activate', emacs is unhidden and becomes
1819 the active application. */)
1824 if (EQ (on, intern ("activate")))
1826 [NSApp unhide: NSApp];
1827 [NSApp activateIgnoringOtherApps: YES];
1830 [NSApp unhide: NSApp];
1832 [NSApp hide: NSApp];
1837 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1839 doc: /* Shows the 'Info' or 'About' panel for Emacs. */)
1843 [NSApp orderFrontStandardAboutPanel: nil];
1848 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1849 doc: /* Determine font postscript or family name for font NAME.
1850 NAME should be a string containing either the font name or an XLFD
1851 font descriptor. If string contains `fontset' and not
1852 `fontset-startup', it is left alone. */)
1857 CHECK_STRING (name);
1862 if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1865 return build_string (ns_xlfd_to_fontname (SDATA (name)));
1869 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1870 doc: /* Return a list of all available colors.
1871 The optional argument FRAME is currently ignored. */)
1875 Lisp_Object list = Qnil;
1876 NSEnumerator *colorlists;
1881 CHECK_FRAME (frame);
1882 if (! FRAME_NS_P (XFRAME (frame)))
1883 error ("non-Nextstep frame used in `ns-list-colors'");
1888 colorlists = [[NSColorList availableColorLists] objectEnumerator];
1889 while (clist = [colorlists nextObject])
1891 if ([[clist name] length] < 7 ||
1892 [[clist name] rangeOfString: @"PANTONE"].location == 0)
1894 NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1896 while (cname = [cnames nextObject])
1897 list = Fcons (build_string ([cname UTF8String]), list);
1898 /* for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1899 list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1900 UTF8String]), list); */
1910 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1911 doc: /* List available Nextstep services by querying NSApp. */)
1914 Lisp_Object ret = Qnil;
1919 svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1920 [NSApp setServicesMenu: svcs]; /* this and next rebuild on <10.4 */
1921 [NSApp registerServicesMenuSendTypes: ns_send_types
1922 returnTypes: ns_return_types];
1924 /* On Tiger, services menu updating was made lazier (waits for user to
1925 actually click on the menu), so we have to force things along: */
1926 #ifdef NS_IMPL_COCOA
1927 if (NSAppKitVersionNumber >= 744.0)
1929 delegate = [svcs delegate];
1930 if (delegate != nil)
1932 if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1933 [delegate menuNeedsUpdate: svcs];
1934 if ([delegate respondsToSelector:
1935 @selector (menu:updateItem:atIndex:shouldCancel:)])
1937 int i, len = [delegate numberOfItemsInMenu: svcs];
1938 for (i =0; i<len; i++)
1939 [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1940 for (i =0; i<len; i++)
1941 if (![delegate menu: svcs
1942 updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1943 atIndex: i shouldCancel: NO])
1950 [svcs setAutoenablesItems: NO];
1951 #ifdef NS_IMPL_COCOA
1952 [svcs update]; /* on OS X, converts from '/' structure */
1955 ret = interpret_services_menu (svcs, Qnil, ret);
1960 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
1962 doc: /* Perform Nextstep SERVICE on SEND.
1963 SEND should be either a string or nil.
1964 The return value is the result of the service, as string, or nil if
1965 there was no result. */)
1967 Lisp_Object service, send;
1974 CHECK_STRING (service);
1977 utfStr = SDATA (service);
1978 svcName = [NSString stringWithUTF8String: utfStr];
1980 pb =[NSPasteboard pasteboardWithUniqueName];
1981 ns_string_to_pasteboard (pb, send);
1983 if (NSPerformService (svcName, pb) == NO)
1984 Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
1986 if ([[pb types] count] == 0)
1987 return build_string ("");
1988 return ns_string_from_pasteboard (pb);
1992 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
1993 Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
1994 doc: /* Return an NFC string that matches the UTF-8 NFD string STR. */)
2001 utfStr = [[NSString stringWithUTF8String: SDATA (str)]
2002 precomposedStringWithCanonicalMapping];
2003 return build_string ([utfStr UTF8String]);
2007 #ifdef NS_IMPL_COCOA
2009 /* Compile and execute the AppleScript SCRIPT and return the error
2010 status as function value. A zero is returned if compilation and
2011 execution is successful, in which case *RESULT is set to a Lisp
2012 string or a number containing the resulting script value. Otherwise,
2015 ns_do_applescript (script, result)
2016 Lisp_Object script, *result;
2018 NSAppleEventDescriptor *desc;
2019 NSDictionary* errorDict;
2020 NSAppleEventDescriptor* returnDescriptor = NULL;
2022 NSAppleScript* scriptObject =
2023 [[NSAppleScript alloc] initWithSource:
2024 [NSString stringWithUTF8String: SDATA (script)]];
2026 returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2027 [scriptObject release];
2031 if (returnDescriptor != NULL)
2033 // successful execution
2034 if (kAENullEvent != [returnDescriptor descriptorType])
2037 // script returned an AppleScript result
2038 if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2039 (typeUTF16ExternalRepresentation
2040 == [returnDescriptor descriptorType]) ||
2041 (typeUTF8Text == [returnDescriptor descriptorType]) ||
2042 (typeCString == [returnDescriptor descriptorType]))
2044 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2046 *result = build_string([[desc stringValue] UTF8String]);
2050 /* use typeUTF16ExternalRepresentation? */
2051 // coerce the result to the appropriate ObjC type
2052 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2054 *result = make_number([desc int32Value]);
2060 // no script result, return error
2066 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2067 doc: /* Execute AppleScript SCRIPT and return the result. If
2068 compilation and execution are successful, the resulting script value
2069 is returned as a string, a number or, in the case of other constructs,
2070 t. In case the execution fails, an error is signaled. */)
2077 CHECK_STRING (script);
2081 status = ns_do_applescript (script, &result);
2085 else if (!STRINGP (result))
2086 error ("AppleScript error %d", status);
2088 error ("%s", SDATA (result));
2094 /* ==========================================================================
2096 Miscellaneous functions not called through hooks
2098 ========================================================================== */
2101 /* 23: call in image.c */
2103 check_x_frame (Lisp_Object frame)
2105 return check_ns_frame (frame);
2108 /* 23: added, due to call in frame.c */
2109 struct ns_display_info *
2110 check_x_display_info (Lisp_Object frame)
2112 return check_ns_display_info (frame);
2116 /* 23: new function; we don't have much in the way of flexibility though */
2118 x_set_scroll_bar_default_width (f)
2121 int wid = FRAME_COLUMN_WIDTH (f);
2122 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2123 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2128 /* 23: terms now impl this instead of x-get-resource directly */
2130 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2132 /* remove appname prefix; TODO: allow for !="Emacs" */
2133 char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2137 /* Support emacs-20-style face resources for backwards compatibility */
2138 if (!strncmp (toCheck, "Face", 4))
2139 toCheck = name + (!strncmp (name, "emacs.", 6) ? 6 : 0);
2141 /*fprintf (stderr, "Checking '%s'\n", toCheck); */
2143 res = [[[NSUserDefaults standardUserDefaults] objectForKey:
2144 [NSString stringWithUTF8String: toCheck]] UTF8String];
2145 return !res ? NULL :
2146 (!strncasecmp (res, "YES", 3) ? "true" :
2147 (!strncasecmp (res, "NO", 2) ? "false" : res));
2152 x_get_focus_frame (struct frame *frame)
2154 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2155 Lisp_Object nsfocus;
2157 if (!dpyinfo->x_focus_frame)
2160 XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2166 x_pixel_width (struct frame *f)
2168 return FRAME_PIXEL_WIDTH (f);
2173 x_pixel_height (struct frame *f)
2175 return FRAME_PIXEL_HEIGHT (f);
2180 x_char_width (struct frame *f)
2182 return FRAME_COLUMN_WIDTH (f);
2187 x_char_height (struct frame *f)
2189 return FRAME_LINE_HEIGHT (f);
2194 x_screen_planes (struct frame *f)
2196 return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2201 x_sync (Lisp_Object frame)
2203 /* XXX Not implemented XXX */
2209 /* ==========================================================================
2211 Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2213 ========================================================================== */
2216 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2217 doc: /* Return t if the current Nextstep display supports the color COLOR.
2218 The optional argument FRAME is currently ignored. */)
2220 Lisp_Object color, frame;
2224 return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2228 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2229 doc: /* Return a description of the color named COLOR.
2230 The value is a list of integer RGBA values--(RED GREEN BLUE ALPHA).
2231 These values appear to range from 0 to 65280; white is (65280 65280 65280 0).
2232 The optional argument FRAME is currently ignored. */)
2234 Lisp_Object color, frame;
2237 float red, green, blue, alpha;
2238 Lisp_Object rgba[4];
2241 CHECK_STRING (color);
2243 if (ns_lisp_to_color (color, &col))
2246 [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2247 getRed: &red green: &green blue: &blue alpha: &alpha];
2248 rgba[0] = make_number (lrint (red*65280));
2249 rgba[1] = make_number (lrint (green*65280));
2250 rgba[2] = make_number (lrint (blue*65280));
2251 rgba[3] = make_number (lrint (alpha*65280));
2253 return Flist (4, rgba);
2257 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2258 doc: /* Return t if the Nextstep display supports color.
2259 The optional argument DISPLAY specifies which display to ask about.
2260 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2261 If omitted or nil, that stands for the selected frame's display. */)
2263 Lisp_Object display;
2265 NSWindowDepth depth;
2266 NSString *colorSpace;
2268 depth = [ns_get_screen (display) depth];
2269 colorSpace = NSColorSpaceFromDepth (depth);
2271 return [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2272 || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2277 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2278 Sx_display_grayscale_p, 0, 1, 0,
2279 doc: /* Return t if the Nextstep display supports shades of gray.
2280 Note that color displays do support shades of gray.
2281 The optional argument DISPLAY specifies which display to ask about.
2282 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2283 If omitted or nil, that stands for the selected frame's display. */)
2285 Lisp_Object display;
2287 NSWindowDepth depth;
2289 depth = [ns_get_screen (display) depth];
2291 return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2295 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2297 doc: /* Returns the width in pixels of the Nextstep display DISPLAY.
2298 The optional argument DISPLAY specifies which display to ask about.
2299 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2300 If omitted or nil, that stands for the selected frame's display. */)
2302 Lisp_Object display;
2305 return make_number ((int) [ns_get_screen (display) frame].size.width);
2309 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2310 Sx_display_pixel_height, 0, 1, 0,
2311 doc: /* Returns the height in pixels of the Nextstep display DISPLAY.
2312 The optional argument DISPLAY specifies which display to ask about.
2313 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2314 If omitted or nil, that stands for the selected frame's display. */)
2316 Lisp_Object display;
2319 return make_number ((int) [ns_get_screen (display) frame].size.height);
2323 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2324 Sns_display_usable_bounds, 0, 1, 0,
2325 doc: /*Return the bounds of the usable part of the screen.
2326 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2327 are the boundaries of the usable part of the screen, excluding areas
2328 reserved for the Mac menu, dock, and so forth.
2330 The screen queried corresponds to DISPLAY, which should be either a
2331 frame, a display name (a string), or terminal ID. If omitted or nil,
2332 that stands for the selected frame's display. */)
2334 Lisp_Object display;
2340 vScreen = [ns_get_screen (display) visibleFrame];
2341 top = vScreen.origin.y == 0.0 ?
2342 (int) [ns_get_screen (display) frame].size.height - vScreen.size.height : 0;
2344 return list4 (make_number ((int) vScreen.origin.x),
2346 make_number ((int) vScreen.size.width),
2347 make_number ((int) vScreen.size.height));
2351 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2353 doc: /* Returns the number of bitplanes of the Nextstep display DISPLAY.
2354 The optional argument DISPLAY specifies which display to ask about.
2355 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2356 If omitted or nil, that stands for the selected frame's display. */)
2358 Lisp_Object display;
2362 (NSBitsPerSampleFromDepth ([ns_get_screen (display) depth]));
2366 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2367 Sx_display_color_cells, 0, 1, 0,
2368 doc: /* Returns the number of color cells 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. */)
2373 Lisp_Object display;
2376 struct ns_display_info *dpyinfo = check_ns_display_info (display);
2378 /* We force 24+ bit depths to 24-bit to prevent an overflow. */
2379 return make_number (1 << min (dpyinfo->n_planes, 24));
2383 /* Unused dummy def needed for compatibility. */
2384 Lisp_Object tip_frame;
2386 /* TODO: move to xdisp or similar */
2388 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
2390 Lisp_Object parms, dx, dy;
2392 int *root_x, *root_y;
2394 Lisp_Object left, top;
2395 EmacsView *view = FRAME_NS_VIEW (f);
2398 /* Start with user-specified or mouse position. */
2399 left = Fcdr (Fassq (Qleft, parms));
2400 if (INTEGERP (left))
2403 pt.x = last_mouse_motion_position.x;
2404 top = Fcdr (Fassq (Qtop, parms));
2408 pt.y = last_mouse_motion_position.y;
2410 /* Convert to screen coordinates */
2411 pt = [view convertPoint: pt toView: nil];
2412 pt = [[view window] convertBaseToScreen: pt];
2414 /* Ensure in bounds. (Note, screen origin = lower left.) */
2415 if (pt.x + XINT (dx) <= 0)
2416 *root_x = 0; /* Can happen for negative dx */
2417 else if (pt.x + XINT (dx) + width <= FRAME_NS_DISPLAY_INFO (f)->width)
2418 /* It fits to the right of the pointer. */
2419 *root_x = pt.x + XINT (dx);
2420 else if (width + XINT (dx) <= pt.x)
2421 /* It fits to the left of the pointer. */
2422 *root_x = pt.x - width - XINT (dx);
2424 /* Put it left justified on the screen -- it ought to fit that way. */
2427 if (pt.y - XINT (dy) - height >= 0)
2428 /* It fits below the pointer. */
2429 *root_y = pt.y - height - XINT (dy);
2430 else if (pt.y + XINT (dy) + height <= FRAME_NS_DISPLAY_INFO (f)->height)
2431 /* It fits above the pointer */
2432 *root_y = pt.y + XINT (dy);
2434 /* Put it on the top. */
2435 *root_y = FRAME_NS_DISPLAY_INFO (f)->height - height;
2439 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2440 doc: /* Show STRING in a "tooltip" window on frame FRAME.
2441 A tooltip window is a small window displaying a string.
2443 FRAME nil or omitted means use the selected frame.
2445 PARMS is an optional list of frame parameters which can be used to
2446 change the tooltip's appearance.
2448 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
2449 means use the default timeout of 5 seconds.
2451 If the list of frame parameters PARMS contains a `left' parameter,
2452 the tooltip is displayed at that x-position. Otherwise it is
2453 displayed at the mouse position, with offset DX added (default is 5 if
2454 DX isn't specified). Likewise for the y-position; if a `top' frame
2455 parameter is specified, it determines the y-position of the tooltip
2456 window, otherwise it is displayed at the mouse position, with offset
2457 DY added (default is -10).
2459 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2460 Text larger than the specified size is clipped. */)
2461 (string, frame, parms, timeout, dx, dy)
2462 Lisp_Object string, frame, parms, timeout, dx, dy;
2465 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2466 int count = SPECPDL_INDEX ();
2471 specbind (Qinhibit_redisplay, Qt);
2473 GCPRO4 (string, parms, frame, timeout);
2475 CHECK_STRING (string);
2476 str = SDATA (string);
2477 f = check_x_frame (frame);
2479 timeout = make_number (5);
2481 CHECK_NATNUM (timeout);
2484 dx = make_number (5);
2489 dy = make_number (-10);
2494 if (ns_tooltip == nil)
2495 ns_tooltip = [[EmacsTooltip alloc] init];
2499 [ns_tooltip setText: str];
2500 size = [ns_tooltip frame].size;
2502 /* Move the tooltip window where the mouse pointer is. Resize and
2504 compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2507 [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2511 return unbind_to (count, Qnil);
2515 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2516 doc: /* Hide the current tooltip window, if there is any.
2517 Value is t if tooltip was open, nil otherwise. */)
2520 if (ns_tooltip == nil || ![ns_tooltip isActive])
2527 /* ==========================================================================
2529 Class implementations
2531 ========================================================================== */
2534 @implementation EmacsSavePanel
2535 #ifdef NS_IMPL_COCOA
2536 /* --------------------------------------------------------------------------
2537 These are overridden to intercept on OS X: ending panel restarts NSApp
2538 event loop if it is stopped. Not sure if this is correct behavior,
2539 perhaps should check if running and if so send an appdefined.
2540 -------------------------------------------------------------------------- */
2541 - (void) ok: (id)sender
2547 - (void) cancel: (id)sender
2549 [super cancel: sender];
2556 @implementation EmacsOpenPanel
2557 #ifdef NS_IMPL_COCOA
2558 /* --------------------------------------------------------------------------
2559 These are overridden to intercept on OS X: ending panel restarts NSApp
2560 event loop if it is stopped. Not sure if this is correct behavior,
2561 perhaps should check if running and if so send an appdefined.
2562 -------------------------------------------------------------------------- */
2563 - (void) ok: (id)sender
2569 - (void) cancel: (id)sender
2571 [super cancel: sender];
2578 @implementation EmacsFileDelegate
2579 /* --------------------------------------------------------------------------
2580 Delegate methods for Open/Save panels
2581 -------------------------------------------------------------------------- */
2582 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2586 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2590 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2591 confirmed: (BOOL)okFlag
2599 /* ==========================================================================
2601 Lisp interface declaration
2603 ========================================================================== */
2611 Qnone = intern ("none");
2613 Qbuffered = intern ("bufferd");
2614 staticpro (&Qbuffered);
2615 Qfontsize = intern ("fontsize");
2616 staticpro (&Qfontsize);
2618 DEFVAR_LISP ("ns-icon-type-alist", &Vns_icon_type_alist,
2619 doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2620 If the title of a frame matches REGEXP, then IMAGE.tiff is
2621 selected as the image of the icon representing the frame when it's
2622 miniaturized. If an element is t, then Emacs tries to select an icon
2623 based on the filetype of the visited file.
2625 The images have to be installed in a folder called English.lproj in the
2626 Emacs folder. You have to restart Emacs after installing new icons.
2628 Example: Install an icon Gnus.tiff and execute the following code
2630 (setq ns-icon-type-alist
2631 (append ns-icon-type-alist
2632 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2635 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2636 be used as the image of the icon representing the frame. */);
2637 Vns_icon_type_alist = Fcons (Qt, Qnil);
2639 defsubr (&Sns_read_file_name);
2640 defsubr (&Sns_get_resource);
2641 defsubr (&Sns_set_resource);
2642 defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2643 defsubr (&Sx_display_grayscale_p);
2644 defsubr (&Sns_font_name);
2645 defsubr (&Sns_list_colors);
2646 #ifdef NS_IMPL_COCOA
2647 defsubr (&Sns_do_applescript);
2649 defsubr (&Sxw_color_defined_p);
2650 defsubr (&Sxw_color_values);
2651 defsubr (&Sx_server_max_request_size);
2652 defsubr (&Sx_server_vendor);
2653 defsubr (&Sx_server_version);
2654 defsubr (&Sx_display_pixel_width);
2655 defsubr (&Sx_display_pixel_height);
2656 defsubr (&Sns_display_usable_bounds);
2657 defsubr (&Sx_display_mm_width);
2658 defsubr (&Sx_display_mm_height);
2659 defsubr (&Sx_display_screens);
2660 defsubr (&Sx_display_planes);
2661 defsubr (&Sx_display_color_cells);
2662 defsubr (&Sx_display_visual_class);
2663 defsubr (&Sx_display_backing_store);
2664 defsubr (&Sx_display_save_under);
2665 defsubr (&Sx_create_frame);
2666 defsubr (&Sns_set_alpha);
2667 defsubr (&Sx_open_connection);
2668 defsubr (&Sx_close_connection);
2669 defsubr (&Sx_display_list);
2671 defsubr (&Sns_hide_others);
2672 defsubr (&Sns_hide_emacs);
2673 defsubr (&Sns_emacs_info_panel);
2674 defsubr (&Sns_list_services);
2675 defsubr (&Sns_perform_service);
2676 defsubr (&Sns_convert_utf8_nfd_to_nfc);
2677 defsubr (&Sx_focus_frame);
2678 defsubr (&Sns_popup_prefs_panel);
2679 defsubr (&Sns_popup_font_panel);
2680 defsubr (&Sns_popup_color_panel);
2682 defsubr (&Sx_show_tip);
2683 defsubr (&Sx_hide_tip);
2685 /* used only in fontset.c */
2686 check_window_system_func = check_ns;
2690 // arch-tag: dc2a3f74-1123-4daa-8eed-fb78db6a5642