1 /* Functions for the NeXT/Open/GNUstep and MacOSX window system.
2 Copyright (C) 1989, 1992, 1993, 1994, 2005, 2006, 2008, 2009, 2010
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 Originally by Carl Edman
22 Updated by Christian Limpach (chris@nice.ch)
23 OpenStep/Rhapsody port by Scott Bender (sbender@harmony-ds.com)
24 MacOSX/Aqua port by Christophe de Dinechin (descubes@earthlink.net)
25 GNUstep port and post-20 update by Adrian Robert (arobert@cogsci.ucsd.edu)
28 /* This should be the first include, as it may set up #defines affecting
29 interpretation of even the system includes. */
37 #include "blockinput.h"
42 #include "termhooks.h"
44 #include "character.h"
48 int fns_trace_num = 1;
49 #define NSTRACE(x) fprintf (stderr, "%s:%d: [%d] " #x "\n", \
50 __FILE__, __LINE__, ++fns_trace_num)
57 extern NSArray *ns_send_types, *ns_return_types, *ns_drag_types;
59 extern Lisp_Object Qforeground_color;
60 extern Lisp_Object Qbackground_color;
61 extern Lisp_Object Qcursor_color;
62 extern Lisp_Object Qinternal_border_width;
63 extern Lisp_Object Qvisibility;
64 extern Lisp_Object Qcursor_type;
65 extern Lisp_Object Qicon_type;
66 extern Lisp_Object Qicon_name;
67 extern Lisp_Object Qicon_left;
68 extern Lisp_Object Qicon_top;
69 extern Lisp_Object Qleft;
70 extern Lisp_Object Qright;
71 extern Lisp_Object Qtop;
72 extern Lisp_Object Qdisplay;
73 extern Lisp_Object Qvertical_scroll_bars;
74 extern Lisp_Object Qauto_raise;
75 extern Lisp_Object Qauto_lower;
76 extern Lisp_Object Qbox;
77 extern Lisp_Object Qscroll_bar_width;
78 extern Lisp_Object Qx_resource_name;
79 extern Lisp_Object Qface_set_after_frame_default;
80 extern Lisp_Object Qunderline, Qundefined;
81 extern Lisp_Object Qheight, Qminibuffer, Qname, Qonly, Qwidth;
82 extern Lisp_Object Qunsplittable, Qmenu_bar_lines, Qbuffer_predicate, Qtitle;
83 extern Lisp_Object Qnone;
85 Lisp_Object Qbuffered;
86 Lisp_Object Qfontsize;
88 /* hack for OS X file panels */
91 /* Alist of elements (REGEXP . IMAGE) for images of icons associated
93 static Lisp_Object Vns_icon_type_alist;
95 /* Toolkit version support. */
96 static Lisp_Object Vns_version_string;
98 EmacsTooltip *ns_tooltip;
100 /* Need forward declaration here to preserve organizational integrity of file */
101 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
103 extern BOOL ns_in_resize;
106 /* ==========================================================================
108 Internal utility functions
110 ========================================================================== */
117 error ("OpenStep is not in use or not initialized");
121 /* Nonzero if we can use mouse menus. */
129 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
130 and checking validity for NS. */
132 check_ns_frame (Lisp_Object frame)
137 f = SELECTED_FRAME ();
140 CHECK_LIVE_FRAME (frame);
143 if (! FRAME_NS_P (f))
144 error ("non-Nextstep frame used");
149 /* Let the user specify an Nextstep display with a frame.
150 nil stands for the selected frame--or, if that is not an Nextstep frame,
151 the first Nextstep display on the list. */
152 static struct ns_display_info *
153 check_ns_display_info (Lisp_Object frame)
157 struct frame *f = SELECTED_FRAME ();
158 if (FRAME_NS_P (f) && FRAME_LIVE_P (f) )
159 return FRAME_NS_DISPLAY_INFO (f);
160 else if (x_display_list != 0)
161 return x_display_list;
163 error ("Nextstep windows are not in use or not initialized");
165 else if (INTEGERP (frame))
167 struct terminal *t = get_terminal (frame, 1);
169 if (t->type != output_ns)
170 error ("Terminal %d is not a Nextstep display", XINT (frame));
172 return t->display_info.ns;
174 else if (STRINGP (frame))
175 return ns_display_info_for_name (frame);
180 CHECK_LIVE_FRAME (frame);
182 if (! FRAME_NS_P (f))
183 error ("non-Nextstep frame used");
184 return FRAME_NS_DISPLAY_INFO (f);
186 return NULL; /* shut compiler up */
191 ns_get_window (Lisp_Object maybeFrame)
193 id view =nil, window =nil;
195 if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
196 maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
198 if (!NILP (maybeFrame))
199 view = FRAME_NS_VIEW (XFRAME (maybeFrame));
200 if (view) window =[view window];
207 ns_get_screen (Lisp_Object screen)
210 struct terminal *terminal;
212 if (EQ (Qt, screen)) /* not documented */
213 return [NSScreen mainScreen];
215 terminal = get_terminal (screen, 1);
216 if (terminal->type != output_ns)
220 f = SELECTED_FRAME ();
221 else if (FRAMEP (screen))
225 struct ns_display_info *dpyinfo = terminal->display_info.ns;
226 f = (dpyinfo->x_focus_frame || dpyinfo->x_highlight_frame);
229 return ((f && FRAME_NS_P (f)) ? [[FRAME_NS_VIEW (f) window] screen]
234 /* Return the X display structure for the display named NAME.
235 Open a new connection if necessary. */
236 struct ns_display_info *
237 ns_display_info_for_name (name)
241 struct ns_display_info *dpyinfo;
245 for (dpyinfo = x_display_list, names = ns_display_name_list;
247 dpyinfo = dpyinfo->next, names = XCDR (names))
250 tem = Fstring_equal (XCAR (XCAR (names)), name);
255 error ("Emacs for OpenStep does not yet support multi-display.");
257 Fx_open_connection (name, Qnil, Qnil);
258 dpyinfo = x_display_list;
261 error ("OpenStep on %s not responding.\n", SDATA (name));
268 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
269 /* --------------------------------------------------------------------------
270 Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
271 -------------------------------------------------------------------------- */
281 count = [menu numberOfItems];
282 for (i = 0; i<count; i++)
284 item = [menu itemAtIndex: i];
285 name = [[item title] UTF8String];
288 nameStr = build_string (name);
290 if ([item hasSubmenu])
292 old = interpret_services_menu ([item submenu],
293 Fcons (nameStr, prefix), old);
297 keys = [item keyEquivalent];
298 if (keys && [keys length] )
300 key = [keys characterAtIndex: 0];
301 res = make_number (key|super_modifier);
307 old = Fcons (Fcons (res,
308 Freverse (Fcons (nameStr,
318 /* ==========================================================================
320 Frame parameter setters
322 ========================================================================== */
326 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
330 if (ns_lisp_to_color (arg, &col))
332 store_frame_param (f, Qforeground_color, oldval);
333 error ("Unknown color");
337 [f->output_data.ns->foreground_color release];
338 f->output_data.ns->foreground_color = col;
340 if (FRAME_NS_VIEW (f))
342 update_face_from_frame_parameter (f, Qforeground_color, arg);
343 /*recompute_basic_faces (f); */
344 if (FRAME_VISIBLE_P (f))
351 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
355 NSView *view = FRAME_NS_VIEW (f);
358 if (ns_lisp_to_color (arg, &col))
360 store_frame_param (f, Qbackground_color, oldval);
361 error ("Unknown color");
364 /* clear the frame; in some instances the NS-internal GC appears not to
365 update, or it does update and cannot clear old text properly */
366 if (FRAME_VISIBLE_P (f))
370 [f->output_data.ns->background_color release];
371 f->output_data.ns->background_color = col;
374 [[view window] setBackgroundColor: col];
375 alpha = [col alphaComponent];
378 [[view window] setOpaque: NO];
380 [[view window] setOpaque: YES];
382 face = FRAME_DEFAULT_FACE (f);
385 col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
387 = (EMACS_UINT) [[col colorWithAlphaComponent: alpha] retain];
390 update_face_from_frame_parameter (f, Qbackground_color, arg);
393 if (FRAME_VISIBLE_P (f))
400 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
404 if (ns_lisp_to_color (arg, &col))
406 store_frame_param (f, Qcursor_color, oldval);
407 error ("Unknown color");
410 [FRAME_CURSOR_COLOR (f) release];
411 FRAME_CURSOR_COLOR (f) = [col retain];
413 if (FRAME_VISIBLE_P (f))
415 x_update_cursor (f, 0);
416 x_update_cursor (f, 1);
418 update_face_from_frame_parameter (f, Qcursor_color, arg);
423 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
425 NSView *view = FRAME_NS_VIEW (f);
426 NSTRACE (x_set_icon_name);
431 /* see if it's changed */
434 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
437 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
444 if (!NILP (f->title))
447 /* explicit name and no icon-name -> explicit_name */
448 if (f->explicit_name)
452 /* no explicit name and no icon-name ->
453 name has to be rebuild from icon_title_format */
454 windows_or_buffers_changed++;
459 /* Don't change the name if it's already NAME. */
460 if ([[view window] miniwindowTitle] &&
461 ([[[view window] miniwindowTitle]
462 isEqualToString: [NSString stringWithUTF8String:
466 [[view window] setMiniwindowTitle:
467 [NSString stringWithUTF8String: SDATA (arg)]];
472 ns_set_name_iconic (struct frame *f, Lisp_Object name, int explicit)
474 NSView *view = FRAME_NS_VIEW (f);
475 NSTRACE (ns_set_name_iconic);
480 /* Make sure that requests from lisp code override requests from
481 Emacs redisplay code. */
484 /* If we're switching from explicit to implicit, we had better
485 update the mode lines and thereby update the title. */
486 if (f->explicit_name && NILP (name))
487 update_mode_lines = 1;
489 f->explicit_name = ! NILP (name);
491 else if (f->explicit_name)
494 /* title overrides explicit name */
495 if (! NILP (f->title))
498 /* icon_name overrides title and explicit name */
499 if (! NILP (f->icon_name))
503 name = build_string([ns_app_name UTF8String]);
507 /* Don't change the name if it's already NAME. */
508 if ([[view window] miniwindowTitle] &&
509 ([[[view window] miniwindowTitle]
510 isEqualToString: [NSString stringWithUTF8String:
514 [[view window] setMiniwindowTitle:
515 [NSString stringWithUTF8String: SDATA (name)]];
520 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
523 NSTRACE (ns_set_name);
528 /* Make sure that requests from lisp code override requests from
529 Emacs redisplay code. */
532 /* If we're switching from explicit to implicit, we had better
533 update the mode lines and thereby update the title. */
534 if (f->explicit_name && NILP (name))
535 update_mode_lines = 1;
537 f->explicit_name = ! NILP (name);
539 else if (f->explicit_name)
543 name = build_string([ns_app_name UTF8String]);
547 /* title overrides explicit name */
548 if (! NILP (f->title))
553 view = FRAME_NS_VIEW (f);
555 /* Don't change the name if it's already NAME. */
556 if ([[[view window] title]
557 isEqualToString: [NSString stringWithUTF8String:
560 [[view window] setTitle: [NSString stringWithUTF8String:
565 /* This function should be called when the user's lisp code has
566 specified a name for the frame; the name will override any set by the
569 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
571 NSTRACE (x_explicitly_set_name);
572 ns_set_name_iconic (f, arg, 1);
573 ns_set_name (f, arg, 1);
577 /* This function should be called by Emacs redisplay code to set the
578 name; names set this way will never override names set by the user's
581 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
583 NSTRACE (x_implicitly_set_name);
584 if (FRAME_ICONIFIED_P (f))
585 ns_set_name_iconic (f, arg, 0);
587 ns_set_name (f, arg, 0);
591 /* Change the title of frame F to NAME.
592 If NAME is nil, use the frame name as the title.
594 If EXPLICIT is non-zero, that indicates that lisp code is setting the
595 name; if NAME is a string, set F's name to NAME and set
596 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
598 If EXPLICIT is zero, that indicates that Emacs redisplay code is
599 suggesting a new name, which lisp code should override; if
600 F->explicit_name is set, ignore the new name; otherwise, set it. */
602 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
604 NSTRACE (x_set_title);
605 /* Don't change the title if it's already NAME. */
606 if (EQ (name, f->title))
609 update_mode_lines = 1;
616 ns_set_name_as_filename (struct frame *f)
620 Lisp_Object buf = XWINDOW (f->selected_window)->buffer;
622 NSAutoreleasePool *pool;
623 NSTRACE (ns_set_name_as_filename);
625 if (f->explicit_name || ! NILP (f->title) || ns_in_resize)
629 pool = [[NSAutoreleasePool alloc] init];
630 name =XBUFFER (buf)->filename;
631 if (NILP (name) || FRAME_ICONIFIED_P (f)) name =XBUFFER (buf)->name;
633 if (FRAME_ICONIFIED_P (f) && !NILP (f->icon_name))
637 name = build_string([ns_app_name UTF8String]);
641 view = FRAME_NS_VIEW (f);
643 title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
644 : [[[view window] title] UTF8String];
646 if (title && (! strcmp (title, SDATA (name))))
653 if (! FRAME_ICONIFIED_P (f))
656 /* work around a bug observed on 10.3 where
657 setTitleWithRepresentedFilename does not clear out previous state
658 if given filename does not exist */
659 NSString *str = [NSString stringWithUTF8String: SDATA (name)];
660 if (![[NSFileManager defaultManager] fileExistsAtPath: str])
662 [[view window] setTitleWithRepresentedFilename: @""];
663 [[view window] setTitle: str];
667 [[view window] setTitleWithRepresentedFilename: str];
670 [[view window] setTitleWithRepresentedFilename:
671 [NSString stringWithUTF8String: SDATA (name)]];
677 [[view window] setMiniwindowTitle:
678 [NSString stringWithUTF8String: SDATA (name)]];
686 ns_set_doc_edited (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
688 NSView *view = FRAME_NS_VIEW (f);
689 NSAutoreleasePool *pool;
691 pool = [[NSAutoreleasePool alloc] init];
692 [[view window] setDocumentEdited: !NILP (arg)];
699 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
702 int olines = FRAME_MENU_BAR_LINES (f);
703 if (FRAME_MINIBUF_ONLY_P (f))
706 if (INTEGERP (value))
707 nlines = XINT (value);
711 FRAME_MENU_BAR_LINES (f) = 0;
714 FRAME_EXTERNAL_MENU_BAR (f) = 1;
715 /* does for all frames, whereas we just want for one frame
716 [NSMenu setMenuBarVisible: YES]; */
720 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
721 free_frame_menubar (f);
722 /* [NSMenu setMenuBarVisible: NO]; */
723 FRAME_EXTERNAL_MENU_BAR (f) = 0;
728 /* toolbar support */
730 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
733 Lisp_Object root_window;
735 if (FRAME_MINIBUF_ONLY_P (f))
738 if (INTEGERP (value) && XINT (value) >= 0)
739 nlines = XFASTINT (value);
745 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
746 update_frame_tool_bar (f);
750 if (FRAME_EXTERNAL_TOOL_BAR (f))
752 free_frame_tool_bar (f);
753 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
757 x_set_window_size (f, 0, f->text_cols, f->text_lines);
762 ns_implicitly_set_icon_type (struct frame *f)
765 EmacsView *view = FRAME_NS_VIEW (f);
767 Lisp_Object chain, elt;
768 NSAutoreleasePool *pool;
771 NSTRACE (ns_implicitly_set_icon_type);
774 pool = [[NSAutoreleasePool alloc] init];
775 if (f->output_data.ns->miniimage
776 && [[NSString stringWithUTF8String: SDATA (f->name)]
777 isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
784 tem = assq_no_quit (Qicon_type, f->param_alist);
785 if (CONSP (tem) && ! NILP (XCDR (tem)))
792 for (chain = Vns_icon_type_alist;
793 (image = nil) && CONSP (chain);
794 chain = XCDR (chain))
797 /* special case: 't' means go by file type */
798 if (SYMBOLP (elt) && EQ (elt, Qt) && SDATA (f->name)[0] == '/')
801 = [NSString stringWithUTF8String: SDATA (f->name)];
802 if ([[NSFileManager defaultManager] fileExistsAtPath: str])
803 image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
805 else if (CONSP (elt) &&
806 STRINGP (XCAR (elt)) &&
807 STRINGP (XCDR (elt)) &&
808 fast_string_match (XCAR (elt), f->name) >= 0)
810 image = [EmacsImage allocInitFromFile: XCDR (elt)];
812 image = [[NSImage imageNamed:
813 [NSString stringWithUTF8String:
814 SDATA (XCDR (elt))]] retain];
820 image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
824 [f->output_data.ns->miniimage release];
825 f->output_data.ns->miniimage = image;
826 [view setMiniwindowImage: setMini];
833 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
835 EmacsView *view = FRAME_NS_VIEW (f);
839 NSTRACE (x_set_icon_type);
841 if (!NILP (arg) && SYMBOLP (arg))
843 arg =build_string (SDATA (SYMBOL_NAME (arg)));
844 store_frame_param (f, Qicon_type, arg);
847 /* do it the implicit way */
850 ns_implicitly_set_icon_type (f);
856 image = [EmacsImage allocInitFromFile: arg];
858 image =[NSImage imageNamed: [NSString stringWithUTF8String:
863 image = [NSImage imageNamed: @"text"];
867 f->output_data.ns->miniimage = image;
868 [view setMiniwindowImage: setMini];
872 /* Xism; we stub out (we do implement this in ns-win.el) */
874 XParseGeometry (char *string, int *x, int *y,
875 unsigned int *width, unsigned int *height)
877 message1 ("Warning: XParseGeometry not supported under NS.\n");
882 /* TODO: move to nsterm? */
884 ns_lisp_to_cursor_type (Lisp_Object arg)
887 if (XTYPE (arg) == Lisp_String)
889 else if (XTYPE (arg) == Lisp_Symbol)
890 str = SDATA (SYMBOL_NAME (arg));
892 if (!strcmp (str, "box")) return FILLED_BOX_CURSOR;
893 if (!strcmp (str, "hollow")) return HOLLOW_BOX_CURSOR;
894 if (!strcmp (str, "hbar")) return HBAR_CURSOR;
895 if (!strcmp (str, "bar")) return BAR_CURSOR;
896 if (!strcmp (str, "no")) return NO_CURSOR;
902 ns_cursor_type_to_lisp (int arg)
906 case FILLED_BOX_CURSOR: return Qbox;
907 case HOLLOW_BOX_CURSOR: return intern ("hollow");
908 case HBAR_CURSOR: return intern ("hbar");
909 case BAR_CURSOR: return intern ("bar");
911 default: return intern ("no");
915 /* This is the same as the xfns.c definition. */
917 x_set_cursor_type (f, arg, oldval)
919 Lisp_Object arg, oldval;
921 set_frame_cursor_types (f, arg);
923 /* Make sure the cursor gets redrawn. */
924 cursor_type_changed = 1;
928 /* called to set mouse pointer color, but all other terms use it to
929 initialize pointer types (and don't set the color ;) */
931 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
933 /* don't think we can do this on Nextstep */
938 #define Xstr(x) Str(x)
941 ns_appkit_version_str ()
945 #ifdef NS_IMPL_GNUSTEP
946 sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
947 #elif defined(NS_IMPL_COCOA)
948 sprintf(tmp, "apple-appkit-%.2f", NSAppKitVersionNumber);
952 return build_string (tmp);
956 /* This is for use by x-server-version and collapses all version info we
957 have into a single int. For a better picture of the implementation
958 running, use ns_appkit_version_str.*/
960 ns_appkit_version_int ()
962 #ifdef NS_IMPL_GNUSTEP
963 return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GUI_MINOR_VERSION;
964 #elif defined(NS_IMPL_COCOA)
965 return (int)NSAppKitVersionNumber;
972 x_icon (struct frame *f, Lisp_Object parms)
973 /* --------------------------------------------------------------------------
974 Strangely-named function to set icon position parameters in frame.
975 This is irrelevant under OS X, but might be needed under GNUstep,
976 depending on the window manager used. Note, this is not a standard
977 frame parameter-setter; it is called directly from x-create-frame.
978 -------------------------------------------------------------------------- */
980 Lisp_Object icon_x, icon_y;
981 struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
983 f->output_data.ns->icon_top = Qnil;
984 f->output_data.ns->icon_left = Qnil;
986 /* Set the position of the icon. */
987 icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
988 icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
989 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
991 CHECK_NUMBER (icon_x);
992 CHECK_NUMBER (icon_y);
993 f->output_data.ns->icon_top = icon_y;
994 f->output_data.ns->icon_left = icon_x;
996 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
997 error ("Both left and top icon corners of icon must be specified");
1001 /* Note: see frame.c for template, also where generic functions are impl */
1002 frame_parm_handler ns_frame_parm_handlers[] =
1004 x_set_autoraise, /* generic OK */
1005 x_set_autolower, /* generic OK */
1006 x_set_background_color,
1007 0, /* x_set_border_color, may be impossible under Nextstep */
1008 0, /* x_set_border_width, may be impossible under Nextstep */
1011 x_set_font, /* generic OK */
1012 x_set_foreground_color,
1015 x_set_internal_border_width, /* generic OK */
1016 x_set_menu_bar_lines,
1018 x_explicitly_set_name,
1019 x_set_scroll_bar_width, /* generic OK */
1021 x_set_unsplittable, /* generic OK */
1022 x_set_vertical_scroll_bars, /* generic OK */
1023 x_set_visibility, /* generic OK */
1024 x_set_tool_bar_lines,
1025 0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
1026 0, /* x_set_scroll_bar_background, will ignore (not possible on NS) */
1027 x_set_screen_gamma, /* generic OK */
1028 x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
1029 x_set_fringe_width, /* generic OK */
1030 x_set_fringe_width, /* generic OK */
1031 0, /* x_set_wait_for_wm, will ignore */
1032 0, /* x_set_fullscreen will ignore */
1033 x_set_font_backend, /* generic OK */
1035 0, /* x_set_sticky */
1040 /* ==========================================================================
1044 ========================================================================== */
1046 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1048 doc: /* Make a new Nextstep window, called a \"frame\" in Emacs terms.
1049 Return an Emacs frame object.
1050 PARMS is an alist of frame parameters.
1051 If the parameters specify that the frame should not have a minibuffer,
1052 and do not specify a specific minibuffer window to use,
1053 then `default-minibuffer-frame' must be a frame whose minibuffer can
1054 be shared by the new frame. */)
1058 static int desc_ctr = 1;
1060 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1061 Lisp_Object frame, tem;
1063 int minibuffer_only = 0;
1064 int count = specpdl_ptr - specpdl;
1065 Lisp_Object display;
1066 struct ns_display_info *dpyinfo = NULL;
1069 Lisp_Object tfont, tfontsize;
1070 int window_prompting = 0;
1075 /* Seems a little strange, but other terms do it. Perhaps the code below
1076 is modifying something? */
1077 parms = Fcopy_alist (parms);
1079 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1080 if (EQ (display, Qunbound))
1082 dpyinfo = check_ns_display_info (display);
1084 if (!dpyinfo->terminal->name)
1085 error ("Terminal is not live, can't create new frames on it");
1087 kb = dpyinfo->terminal->kboard;
1089 name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1091 && ! EQ (name, Qunbound)
1093 error ("Invalid frame name--not a string or nil");
1096 Vx_resource_name = name;
1098 Vx_resource_name = Vinvocation_name;
1100 parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1101 if (EQ (parent, Qunbound))
1103 if (! NILP (parent))
1104 CHECK_NUMBER (parent);
1107 GCPRO4 (parms, parent, name, frame);
1109 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1111 if (EQ (tem, Qnone) || NILP (tem))
1113 f = make_frame_without_minibuffer (Qnil, kb, display);
1115 else if (EQ (tem, Qonly))
1117 f = make_minibuffer_frame ();
1118 minibuffer_only = 1;
1120 else if (WINDOWP (tem))
1122 f = make_frame_without_minibuffer (tem, kb, display);
1129 /* Set the name; the functions to which we pass f expect the name to
1131 if (EQ (name, Qunbound) || NILP (name) || (XTYPE (name) != Lisp_String))
1133 f->name = build_string ([ns_app_name UTF8String]);
1134 f->explicit_name =0;
1139 f->explicit_name = 1;
1140 specbind (Qx_resource_name, name);
1143 XSETFRAME (frame, f);
1144 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
1146 f->terminal = dpyinfo->terminal;
1147 f->terminal->reference_count++;
1149 f->output_method = output_ns;
1150 f->output_data.ns = (struct ns_output *)xmalloc (sizeof *(f->output_data.ns));
1151 bzero (f->output_data.ns, sizeof (*(f->output_data.ns)));
1153 FRAME_FONTSET (f) = -1;
1155 /* record_unwind_protect (unwind_create_frame, frame); safety; maybe later? */
1157 f->icon_name = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
1159 if (! STRINGP (f->icon_name))
1160 f->icon_name = Qnil;
1162 FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1164 f->output_data.ns->window_desc = desc_ctr++;
1167 f->output_data.ns->parent_desc = (Window) XFASTINT (parent);
1168 f->output_data.ns->explicit_parent = 1;
1172 f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1173 f->output_data.ns->explicit_parent = 0;
1176 f->resx = dpyinfo->resx;
1177 f->resy = dpyinfo->resy;
1180 register_font_driver (&nsfont_driver, f);
1181 x_default_parameter (f, parms, Qfont_backend, Qnil,
1182 "fontBackend", "FontBackend", RES_TYPE_STRING);
1185 /* use for default font name */
1186 id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1187 tfontsize = x_default_parameter (f, parms, Qfontsize,
1188 make_number (0 /*(int)[font pointSize]*/),
1189 "fontSize", "FontSize", RES_TYPE_NUMBER);
1190 tfont = x_default_parameter (f, parms, Qfont,
1191 build_string ([[font fontName] UTF8String]),
1192 "font", "Font", RES_TYPE_STRING);
1196 x_default_parameter (f, parms, Qborder_width, make_number (0),
1197 "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1198 x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1199 "internalBorderWidth", "InternalBorderWidth",
1202 /* default scrollbars on right on Mac */
1205 #ifdef NS_IMPL_GNUSTEP
1210 x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1211 "verticalScrollBars", "VerticalScrollBars",
1214 x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1215 "foreground", "Foreground", RES_TYPE_STRING);
1216 x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1217 "background", "Background", RES_TYPE_STRING);
1218 x_default_parameter (f, parms, Qcursor_color, build_string ("grey"),
1219 "cursorColor", "CursorColor", RES_TYPE_STRING);
1220 /* FIXME: not suppported yet in Nextstep */
1221 x_default_parameter (f, parms, Qline_spacing, Qnil,
1222 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1223 x_default_parameter (f, parms, Qleft_fringe, Qnil,
1224 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1225 x_default_parameter (f, parms, Qright_fringe, Qnil,
1226 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1229 init_frame_faces (f);
1231 x_default_parameter (f, parms, Qmenu_bar_lines, make_number (0), "menuBar",
1232 "menuBar", RES_TYPE_NUMBER);
1233 x_default_parameter (f, parms, Qtool_bar_lines, make_number (0), "toolBar",
1234 "toolBar", RES_TYPE_NUMBER);
1235 x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1236 "BufferPredicate", RES_TYPE_SYMBOL);
1237 x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1240 /* TODO: other terms seem to get away w/o this complexity.. */
1241 if (NILP (Fassq (Qwidth, parms)))
1244 = x_get_arg (dpyinfo, parms, Qwidth, "width", "Width",
1246 if (! EQ (value, Qunbound))
1247 parms = Fcons (Fcons (Qwidth, value), parms);
1249 if (NILP (Fassq (Qheight, parms)))
1252 = x_get_arg (dpyinfo, parms, Qheight, "height", "Height",
1254 if (! EQ (value, Qunbound))
1255 parms = Fcons (Fcons (Qheight, value), parms);
1257 if (NILP (Fassq (Qleft, parms)))
1260 = x_get_arg (dpyinfo, parms, Qleft, "left", "Left", RES_TYPE_NUMBER);
1261 if (! EQ (value, Qunbound))
1262 parms = Fcons (Fcons (Qleft, value), parms);
1264 if (NILP (Fassq (Qtop, parms)))
1267 = x_get_arg (dpyinfo, parms, Qtop, "top", "Top", RES_TYPE_NUMBER);
1268 if (! EQ (value, Qunbound))
1269 parms = Fcons (Fcons (Qtop, value), parms);
1272 window_prompting = x_figure_window_size (f, parms, 1);
1274 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1275 f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1277 /* NOTE: on other terms, this is done in set_mouse_color, however this
1278 was not getting called under Nextstep */
1279 f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1280 f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1281 f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1282 f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1283 f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1284 f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1285 FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1286 = [NSCursor arrowCursor];
1287 f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1289 [[EmacsView alloc] initFrameFromEmacs: f];
1293 /* It is now ok to make the frame official even if we get an error below.
1294 The frame needs to be on Vframe_list or making it visible won't work. */
1295 Vframe_list = Fcons (frame, Vframe_list);
1296 /*FRAME_NS_DISPLAY_INFO (f)->reference_count++; */
1298 x_default_parameter (f, parms, Qicon_type, Qnil, "bitmapIcon", "BitmapIcon",
1300 x_default_parameter (f, parms, Qauto_raise, Qnil, "autoRaise", "AutoRaiseLower",
1302 x_default_parameter (f, parms, Qauto_lower, Qnil, "autoLower", "AutoLower",
1304 x_default_parameter (f, parms, Qcursor_type, Qbox, "cursorType", "CursorType",
1306 x_default_parameter (f, parms, Qscroll_bar_width, Qnil, "scrollBarWidth",
1307 "ScrollBarWidth", RES_TYPE_NUMBER);
1308 x_default_parameter (f, parms, Qalpha, Qnil, "alpha", "Alpha",
1311 width = FRAME_COLS (f);
1312 height = FRAME_LINES (f);
1314 SET_FRAME_COLS (f, 0);
1315 FRAME_LINES (f) = 0;
1316 change_frame_size (f, height, width, 1, 0, 0);
1318 if (! f->output_data.ns->explicit_parent)
1320 tem = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL);
1321 if (EQ (tem, Qunbound))
1323 x_set_visibility (f, tem, Qnil);
1324 if (EQ (tem, Qicon))
1325 x_iconify_frame (f);
1326 else if (! NILP (tem))
1328 x_make_frame_visible (f);
1329 f->async_visible = 1;
1330 [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1333 f->async_visible = 0;
1336 if (FRAME_HAS_MINIBUF_P (f)
1337 && (!FRAMEP (kb->Vdefault_minibuffer_frame)
1338 || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
1339 kb->Vdefault_minibuffer_frame = frame;
1341 /* All remaining specified parameters, which have not been "used"
1342 by x_get_arg and friends, now go in the misc. alist of the frame. */
1343 for (tem = parms; CONSP (tem); tem = XCDR (tem))
1344 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1345 f->param_alist = Fcons (XCAR (tem), f->param_alist);
1348 Vwindow_list = Qnil;
1350 return unbind_to (count, frame);
1354 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1355 doc: /* Set the input focus to FRAME.
1356 FRAME nil means use the selected frame. */)
1360 struct frame *f = check_ns_frame (frame);
1361 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1363 if (dpyinfo->x_focus_frame != f)
1365 EmacsView *view = FRAME_NS_VIEW (f);
1367 [NSApp activateIgnoringOtherApps: YES];
1368 [[view window] makeKeyAndOrderFront: view];
1376 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1378 doc: /* Pop up the font panel. */)
1386 fm = [NSFontManager sharedFontManager];
1388 f = SELECTED_FRAME ();
1391 CHECK_FRAME (frame);
1395 [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1397 [fm orderFrontFontPanel: NSApp];
1402 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1404 doc: /* Pop up the color panel. */)
1412 f = SELECTED_FRAME ();
1415 CHECK_FRAME (frame);
1419 [NSApp orderFrontColorPanel: NSApp];
1424 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 4, 0,
1425 doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1426 Optional arg DIR, if non-nil, supplies a default directory.
1427 Optional arg ISLOAD, if non-nil, means read a file name for saving.
1428 Optional arg INIT, if non-nil, provides a default file name to use. */)
1429 (prompt, dir, isLoad, init)
1430 Lisp_Object prompt, dir, isLoad, init;
1432 static id fileDelegate = nil;
1437 NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1438 [NSString stringWithUTF8String: SDATA (prompt)];
1439 NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1440 [NSString stringWithUTF8String: SDATA (current_buffer->directory)] :
1441 [NSString stringWithUTF8String: SDATA (dir)];
1442 NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1443 [NSString stringWithUTF8String: SDATA (init)];
1447 if (fileDelegate == nil)
1448 fileDelegate = [EmacsFileDelegate new];
1450 [NSCursor setHiddenUntilMouseMoves: NO];
1452 if ([dirS characterAtIndex: 0] == '~')
1453 dirS = [dirS stringByExpandingTildeInPath];
1455 panel = NILP (isLoad) ?
1456 (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1458 [panel setTitle: promptS];
1460 /* Puma (10.1) does not have */
1461 if ([panel respondsToSelector: @selector (setAllowsOtherFileTypes:)])
1462 [panel setAllowsOtherFileTypes: YES];
1464 [panel setTreatsFilePackagesAsDirectories: YES];
1465 [panel setDelegate: fileDelegate];
1471 ret = [panel runModalForDirectory: dirS file: initS];
1475 [panel setCanChooseDirectories: YES];
1476 ret = [panel runModalForDirectory: dirS file: initS types: nil];
1479 ret = (ret == NSOKButton) || panelOK;
1482 fname = build_string ([[panel filename] UTF8String]);
1484 [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1487 return ret ? fname : Qnil;
1491 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1492 doc: /* Return the value of the property NAME of OWNER from the defaults database.
1493 If OWNER is nil, Emacs is assumed. */)
1495 Lisp_Object owner, name;
1501 owner = build_string([ns_app_name UTF8String]);
1502 CHECK_STRING (name);
1503 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SDATA (name)); */
1505 value =[[[NSUserDefaults standardUserDefaults]
1506 objectForKey: [NSString stringWithUTF8String: SDATA (name)]]
1510 return build_string (value);
1515 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1516 doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1517 If OWNER is nil, Emacs is assumed.
1518 If VALUE is nil, the default is removed. */)
1519 (owner, name, value)
1520 Lisp_Object owner, name, value;
1524 owner = build_string ([ns_app_name UTF8String]);
1525 CHECK_STRING (name);
1528 [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1529 [NSString stringWithUTF8String: SDATA (name)]];
1533 CHECK_STRING (value);
1534 [[NSUserDefaults standardUserDefaults] setObject:
1535 [NSString stringWithUTF8String: SDATA (value)]
1536 forKey: [NSString stringWithUTF8String:
1544 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1545 Sx_server_max_request_size,
1547 doc: /* This function is a no-op. It is only present for completeness. */)
1549 Lisp_Object display;
1552 /* This function has no real equivalent under NeXTstep. Return nil to
1558 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1559 doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1560 DISPLAY should be either a frame or a display name (a string).
1561 If omitted or nil, the selected frame's display is used. */)
1563 Lisp_Object display;
1565 #ifdef NS_IMPL_GNUSTEP
1566 return build_string ("GNU");
1568 return build_string ("Apple");
1573 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1574 doc: /* Return the version numbers of the server of DISPLAY.
1575 The value is a list of three integers: the major and minor
1576 version numbers of the X Protocol in use, and the distributor-specific
1577 release number. See also the function `x-server-vendor'.
1579 The optional argument DISPLAY specifies which display to ask about.
1580 DISPLAY should be either a frame or a display name (a string).
1581 If omitted or nil, that stands for the selected frame's display. */)
1583 Lisp_Object display;
1585 /*NOTE: it is unclear what would best correspond with "protocol";
1586 we return 10.3, meaning Panther, since this is roughly the
1587 level that GNUstep's APIs correspond to.
1588 The last number is where we distinguish between the Apple
1589 and GNUstep implementations ("distributor-specific release
1590 number") and give int'ized versions of major.minor. */
1591 return Fcons (make_number (10),
1592 Fcons (make_number (3),
1593 Fcons (make_number (ns_appkit_version_int()), Qnil)));
1597 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1598 doc: /* Return the number of screens on Nextstep display server DISPLAY.
1599 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1600 If omitted or nil, the selected frame's display is used. */)
1602 Lisp_Object display;
1607 num = [[NSScreen screens] count];
1609 return (num != 0) ? make_number (num) : Qnil;
1613 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1615 doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1616 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1617 If omitted or nil, the selected frame's display is used. */)
1619 Lisp_Object display;
1622 return make_number ((int)
1623 ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1627 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1629 doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1630 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1631 If omitted or nil, the selected frame's display is used. */)
1633 Lisp_Object display;
1636 return make_number ((int)
1637 ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1641 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1642 Sx_display_backing_store, 0, 1, 0,
1643 doc: /* Return whether the Nexstep display DISPLAY supports backing store.
1644 The value may be `buffered', `retained', or `non-retained'.
1645 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1646 If omitted or nil, the selected frame's display is used. */)
1648 Lisp_Object display;
1651 switch ([ns_get_window (display) backingType])
1653 case NSBackingStoreBuffered:
1654 return intern ("buffered");
1655 case NSBackingStoreRetained:
1656 return intern ("retained");
1657 case NSBackingStoreNonretained:
1658 return intern ("non-retained");
1660 error ("Strange value for backingType parameter of frame");
1662 return Qnil; /* not reached, shut compiler up */
1666 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1667 Sx_display_visual_class, 0, 1, 0,
1668 doc: /* Return the visual class of the Nextstep display server DISPLAY.
1669 The value is one of the symbols `static-gray', `gray-scale',
1670 `static-color', `pseudo-color', `true-color', or `direct-color'.
1671 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1672 If omitted or nil, the selected frame's display is used. */)
1674 Lisp_Object display;
1676 NSWindowDepth depth;
1678 depth = [ns_get_screen (display) depth];
1680 if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1681 return intern ("static-gray");
1682 else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1683 return intern ("gray-scale");
1684 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1685 return intern ("pseudo-color");
1686 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1687 return intern ("true-color");
1688 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1689 return intern ("direct-color");
1691 /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1692 return intern ("direct-color");
1696 DEFUN ("x-display-save-under", Fx_display_save_under,
1697 Sx_display_save_under, 0, 1, 0,
1698 doc: /* Non-nil if the Nextstep display server supports the save-under feature.
1699 The optional argument DISPLAY specifies which display to ask about.
1700 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1701 If omitted or nil, the selected frame's display is used. */)
1703 Lisp_Object display;
1706 switch ([ns_get_window (display) backingType])
1708 case NSBackingStoreBuffered:
1711 case NSBackingStoreRetained:
1712 case NSBackingStoreNonretained:
1716 error ("Strange value for backingType parameter of frame");
1718 return Qnil; /* not reached, shut compiler up */
1722 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1724 doc: /* Open a connection to a Nextstep display server.
1725 DISPLAY is the name of the display to connect to.
1726 Optional arguments XRM-STRING and MUST-SUCCEED are currently ignored. */)
1727 (display, resource_string, must_succeed)
1728 Lisp_Object display, resource_string, must_succeed;
1730 struct ns_display_info *dpyinfo;
1732 CHECK_STRING (display);
1734 nxatoms_of_nsselect ();
1735 dpyinfo = ns_term_init (display);
1738 if (!NILP (must_succeed))
1739 fatal ("OpenStep on %s not responding.\n",
1742 error ("OpenStep on %s not responding.\n",
1746 /* Register our external input/output types, used for determining
1747 applicable services and also drag/drop eligibility. */
1748 ns_send_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1749 ns_return_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1750 ns_drag_types = [[NSArray arrayWithObjects:
1752 NSTabularTextPboardType,
1753 NSFilenamesPboardType,
1756 NSFontPboardType, nil] retain];
1762 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1764 doc: /* Close the connection to the current Nextstep display server.
1765 The argument DISPLAY is currently ignored. */)
1767 Lisp_Object display;
1770 /*ns_delete_terminal (dpyinfo->terminal); */
1771 [NSApp terminate: NSApp];
1776 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1777 doc: /* Return the list of display names that Emacs has connections to. */)
1780 Lisp_Object tail, result;
1783 for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1784 result = Fcons (XCAR (XCAR (tail)), result);
1790 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1792 doc: /* Hides all applications other than Emacs. */)
1796 [NSApp hideOtherApplications: NSApp];
1800 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1802 doc: /* If ON is non-nil, the entire Emacs application is hidden.
1803 Otherwise if Emacs is hidden, it is unhidden.
1804 If ON is equal to `activate', Emacs is unhidden and becomes
1805 the active application. */)
1810 if (EQ (on, intern ("activate")))
1812 [NSApp unhide: NSApp];
1813 [NSApp activateIgnoringOtherApps: YES];
1816 [NSApp unhide: NSApp];
1818 [NSApp hide: NSApp];
1823 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1825 doc: /* Shows the 'Info' or 'About' panel for Emacs. */)
1829 [NSApp orderFrontStandardAboutPanel: nil];
1834 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1835 doc: /* Determine font postscript or family name for font NAME.
1836 NAME should be a string containing either the font name or an XLFD
1837 font descriptor. If string contains `fontset' and not
1838 `fontset-startup', it is left alone. */)
1843 CHECK_STRING (name);
1848 if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1851 return build_string (ns_xlfd_to_fontname (SDATA (name)));
1855 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1856 doc: /* Return a list of all available colors.
1857 The optional argument FRAME is currently ignored. */)
1861 Lisp_Object list = Qnil;
1862 NSEnumerator *colorlists;
1867 CHECK_FRAME (frame);
1868 if (! FRAME_NS_P (XFRAME (frame)))
1869 error ("non-Nextstep frame used in `ns-list-colors'");
1874 colorlists = [[NSColorList availableColorLists] objectEnumerator];
1875 while (clist = [colorlists nextObject])
1877 if ([[clist name] length] < 7 ||
1878 [[clist name] rangeOfString: @"PANTONE"].location == 0)
1880 NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1882 while (cname = [cnames nextObject])
1883 list = Fcons (build_string ([cname UTF8String]), list);
1884 /* for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1885 list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1886 UTF8String]), list); */
1896 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1897 doc: /* List available Nextstep services by querying NSApp. */)
1900 Lisp_Object ret = Qnil;
1905 svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1906 [NSApp setServicesMenu: svcs]; /* this and next rebuild on <10.4 */
1907 [NSApp registerServicesMenuSendTypes: ns_send_types
1908 returnTypes: ns_return_types];
1910 /* On Tiger, services menu updating was made lazier (waits for user to
1911 actually click on the menu), so we have to force things along: */
1912 #ifdef NS_IMPL_COCOA
1913 if (NSAppKitVersionNumber >= 744.0)
1915 delegate = [svcs delegate];
1916 if (delegate != nil)
1918 if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1919 [delegate menuNeedsUpdate: svcs];
1920 if ([delegate respondsToSelector:
1921 @selector (menu:updateItem:atIndex:shouldCancel:)])
1923 int i, len = [delegate numberOfItemsInMenu: svcs];
1924 for (i =0; i<len; i++)
1925 [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1926 for (i =0; i<len; i++)
1927 if (![delegate menu: svcs
1928 updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1929 atIndex: i shouldCancel: NO])
1936 [svcs setAutoenablesItems: NO];
1937 #ifdef NS_IMPL_COCOA
1938 [svcs update]; /* on OS X, converts from '/' structure */
1941 ret = interpret_services_menu (svcs, Qnil, ret);
1946 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
1948 doc: /* Perform Nextstep SERVICE on SEND.
1949 SEND should be either a string or nil.
1950 The return value is the result of the service, as string, or nil if
1951 there was no result. */)
1953 Lisp_Object service, send;
1960 CHECK_STRING (service);
1963 utfStr = SDATA (service);
1964 svcName = [NSString stringWithUTF8String: utfStr];
1966 pb =[NSPasteboard pasteboardWithUniqueName];
1967 ns_string_to_pasteboard (pb, send);
1969 if (NSPerformService (svcName, pb) == NO)
1970 Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
1972 if ([[pb types] count] == 0)
1973 return build_string ("");
1974 return ns_string_from_pasteboard (pb);
1978 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
1979 Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
1980 doc: /* Return an NFC string that matches the UTF-8 NFD string STR. */)
1984 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
1989 utfStr = [NSString stringWithUTF8String: SDATA (str)];
1990 if (![utfStr respondsToSelector:
1991 @selector (precomposedStringWithCanonicalMapping)])
1994 ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
1998 utfStr = [utfStr precomposedStringWithCanonicalMapping];
1999 return build_string ([utfStr UTF8String]);
2003 #ifdef NS_IMPL_COCOA
2005 /* Compile and execute the AppleScript SCRIPT and return the error
2006 status as function value. A zero is returned if compilation and
2007 execution is successful, in which case *RESULT is set to a Lisp
2008 string or a number containing the resulting script value. Otherwise,
2011 ns_do_applescript (script, result)
2012 Lisp_Object script, *result;
2014 NSAppleEventDescriptor *desc;
2015 NSDictionary* errorDict;
2016 NSAppleEventDescriptor* returnDescriptor = NULL;
2018 NSAppleScript* scriptObject =
2019 [[NSAppleScript alloc] initWithSource:
2020 [NSString stringWithUTF8String: SDATA (script)]];
2022 returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2023 [scriptObject release];
2027 if (returnDescriptor != NULL)
2029 // successful execution
2030 if (kAENullEvent != [returnDescriptor descriptorType])
2033 // script returned an AppleScript result
2034 if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2035 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
2036 (typeUTF16ExternalRepresentation
2037 == [returnDescriptor descriptorType]) ||
2039 (typeUTF8Text == [returnDescriptor descriptorType]) ||
2040 (typeCString == [returnDescriptor descriptorType]))
2042 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2044 *result = build_string([[desc stringValue] UTF8String]);
2048 /* use typeUTF16ExternalRepresentation? */
2049 // coerce the result to the appropriate ObjC type
2050 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2052 *result = make_number([desc int32Value]);
2058 // no script result, return error
2064 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2065 doc: /* Execute AppleScript SCRIPT and return the result.
2066 If compilation and execution are successful, the resulting script value
2067 is returned as a string, a number or, in the case of other constructs, t.
2068 In case the execution fails, an error is signaled. */)
2075 CHECK_STRING (script);
2079 status = ns_do_applescript (script, &result);
2083 else if (!STRINGP (result))
2084 error ("AppleScript error %d", status);
2086 error ("%s", SDATA (result));
2092 /* ==========================================================================
2094 Miscellaneous functions not called through hooks
2096 ========================================================================== */
2099 /* called from image.c */
2101 check_x_frame (Lisp_Object frame)
2103 return check_ns_frame (frame);
2107 /* called from frame.c */
2108 struct ns_display_info *
2109 check_x_display_info (Lisp_Object frame)
2111 return check_ns_display_info (frame);
2116 x_set_scroll_bar_default_width (f)
2119 int wid = FRAME_COLUMN_WIDTH (f);
2120 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2121 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2126 /* terms impl this instead of x-get-resource directly */
2128 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2130 /* remove appname prefix; TODO: allow for !="Emacs" */
2131 char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2135 if (inhibit_x_resources)
2136 /* --quick was passed, so this is a no-op. */
2139 res = [[[NSUserDefaults standardUserDefaults] objectForKey:
2140 [NSString stringWithUTF8String: toCheck]] UTF8String];
2141 return !res ? NULL :
2142 (!strncasecmp (res, "YES", 3) ? "true" :
2143 (!strncasecmp (res, "NO", 2) ? "false" : res));
2148 x_get_focus_frame (struct frame *frame)
2150 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2151 Lisp_Object nsfocus;
2153 if (!dpyinfo->x_focus_frame)
2156 XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2162 x_pixel_width (struct frame *f)
2164 return FRAME_PIXEL_WIDTH (f);
2169 x_pixel_height (struct frame *f)
2171 return FRAME_PIXEL_HEIGHT (f);
2176 x_char_width (struct frame *f)
2178 return FRAME_COLUMN_WIDTH (f);
2183 x_char_height (struct frame *f)
2185 return FRAME_LINE_HEIGHT (f);
2190 x_screen_planes (struct frame *f)
2192 return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2197 x_sync (Lisp_Object frame)
2199 /* XXX Not implemented XXX */
2205 /* ==========================================================================
2207 Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2209 ========================================================================== */
2212 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2213 doc: /* Return t if the current Nextstep display supports the color COLOR.
2214 The optional argument FRAME is currently ignored. */)
2216 Lisp_Object color, frame;
2220 return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2224 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2225 doc: /* Internal function called by `color-values', which see. */)
2227 Lisp_Object color, frame;
2230 CGFloat red, green, blue, alpha;
2233 CHECK_STRING (color);
2235 if (ns_lisp_to_color (color, &col))
2238 [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2239 getRed: &red green: &green blue: &blue alpha: &alpha];
2240 return list3 (make_number (lrint (red*65280)),
2241 make_number (lrint (green*65280)),
2242 make_number (lrint (blue*65280)));
2246 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2247 doc: /* Return t if the Nextstep display supports color.
2248 The optional argument DISPLAY specifies which display to ask about.
2249 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2250 If omitted or nil, that stands for the selected frame's display. */)
2252 Lisp_Object display;
2254 NSWindowDepth depth;
2255 NSString *colorSpace;
2257 depth = [ns_get_screen (display) depth];
2258 colorSpace = NSColorSpaceFromDepth (depth);
2260 return [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2261 || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2266 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2267 Sx_display_grayscale_p, 0, 1, 0,
2268 doc: /* Return t if the Nextstep display supports shades of gray.
2269 Note that color displays do support shades of gray.
2270 The optional argument DISPLAY specifies which display to ask about.
2271 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2272 If omitted or nil, that stands for the selected frame's display. */)
2274 Lisp_Object display;
2276 NSWindowDepth depth;
2278 depth = [ns_get_screen (display) depth];
2280 return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2284 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2286 doc: /* Return the width in pixels of the Nextstep display DISPLAY.
2287 The optional argument DISPLAY specifies which display to ask about.
2288 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2289 If omitted or nil, that stands for the selected frame's display. */)
2291 Lisp_Object display;
2294 return make_number ((int) [ns_get_screen (display) frame].size.width);
2298 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2299 Sx_display_pixel_height, 0, 1, 0,
2300 doc: /* Return the height in pixels of the Nextstep display DISPLAY.
2301 The optional argument DISPLAY specifies which display to ask about.
2302 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2303 If omitted or nil, that stands for the selected frame's display. */)
2305 Lisp_Object display;
2308 return make_number ((int) [ns_get_screen (display) frame].size.height);
2312 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2313 Sns_display_usable_bounds, 0, 1, 0,
2314 doc: /* Return the bounds of the usable part of the screen.
2315 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2316 are the boundaries of the usable part of the screen, excluding areas
2317 reserved for the Mac menu, dock, and so forth.
2319 The screen queried corresponds to DISPLAY, which should be either a
2320 frame, a display name (a string), or terminal ID. If omitted or nil,
2321 that stands for the selected frame's display. */)
2323 Lisp_Object display;
2330 screen = ns_get_screen (display);
2334 vScreen = [screen visibleFrame];
2336 /* NS coordinate system is upside-down.
2337 Transform to screen-specific coordinates. */
2338 return list4 (make_number ((int) vScreen.origin.x),
2339 make_number ((int) [screen frame].size.height
2340 - vScreen.size.height - vScreen.origin.y),
2341 make_number ((int) vScreen.size.width),
2342 make_number ((int) vScreen.size.height));
2346 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2348 doc: /* Return the number of bitplanes of the Nextstep display DISPLAY.
2349 The optional argument DISPLAY specifies which display to ask about.
2350 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2351 If omitted or nil, that stands for the selected frame's display. */)
2353 Lisp_Object display;
2357 (NSBitsPerPixelFromDepth ([ns_get_screen (display) depth]));
2361 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2362 Sx_display_color_cells, 0, 1, 0,
2363 doc: /* Returns the number of color cells of the Nextstep display DISPLAY.
2364 The optional argument DISPLAY specifies which display to ask about.
2365 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2366 If omitted or nil, that stands for the selected frame's display. */)
2368 Lisp_Object display;
2371 struct ns_display_info *dpyinfo = check_ns_display_info (display);
2373 /* We force 24+ bit depths to 24-bit to prevent an overflow. */
2374 return make_number (1 << min (dpyinfo->n_planes, 24));
2378 /* Unused dummy def needed for compatibility. */
2379 Lisp_Object tip_frame;
2381 /* TODO: move to xdisp or similar */
2383 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
2385 Lisp_Object parms, dx, dy;
2387 int *root_x, *root_y;
2389 Lisp_Object left, top;
2390 EmacsView *view = FRAME_NS_VIEW (f);
2393 /* Start with user-specified or mouse position. */
2394 left = Fcdr (Fassq (Qleft, parms));
2395 if (INTEGERP (left))
2398 pt.x = last_mouse_motion_position.x;
2399 top = Fcdr (Fassq (Qtop, parms));
2403 pt.y = last_mouse_motion_position.y;
2405 /* Convert to screen coordinates */
2406 pt = [view convertPoint: pt toView: nil];
2407 pt = [[view window] convertBaseToScreen: pt];
2409 /* Ensure in bounds. (Note, screen origin = lower left.) */
2410 if (pt.x + XINT (dx) <= 0)
2411 *root_x = 0; /* Can happen for negative dx */
2412 else if (pt.x + XINT (dx) + width
2413 <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2414 /* It fits to the right of the pointer. */
2415 *root_x = pt.x + XINT (dx);
2416 else if (width + XINT (dx) <= pt.x)
2417 /* It fits to the left of the pointer. */
2418 *root_x = pt.x - width - XINT (dx);
2420 /* Put it left justified on the screen -- it ought to fit that way. */
2423 if (pt.y - XINT (dy) - height >= 0)
2424 /* It fits below the pointer. */
2425 *root_y = pt.y - height - XINT (dy);
2426 else if (pt.y + XINT (dy) + height
2427 <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2428 /* It fits above the pointer */
2429 *root_y = pt.y + XINT (dy);
2431 /* Put it on the top. */
2432 *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2436 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2437 doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2438 A tooltip window is a small window displaying a string.
2440 FRAME nil or omitted means use the selected frame.
2442 PARMS is an optional list of frame parameters which can be used to
2443 change the tooltip's appearance.
2445 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
2446 means use the default timeout of 5 seconds.
2448 If the list of frame parameters PARMS contains a `left' parameter,
2449 the tooltip is displayed at that x-position. Otherwise it is
2450 displayed at the mouse position, with offset DX added (default is 5 if
2451 DX isn't specified). Likewise for the y-position; if a `top' frame
2452 parameter is specified, it determines the y-position of the tooltip
2453 window, otherwise it is displayed at the mouse position, with offset
2454 DY added (default is -10).
2456 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2457 Text larger than the specified size is clipped. */)
2458 (string, frame, parms, timeout, dx, dy)
2459 Lisp_Object string, frame, parms, timeout, dx, dy;
2462 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2463 int count = SPECPDL_INDEX ();
2468 specbind (Qinhibit_redisplay, Qt);
2470 GCPRO4 (string, parms, frame, timeout);
2472 CHECK_STRING (string);
2473 str = SDATA (string);
2474 f = check_x_frame (frame);
2476 timeout = make_number (5);
2478 CHECK_NATNUM (timeout);
2481 dx = make_number (5);
2486 dy = make_number (-10);
2491 if (ns_tooltip == nil)
2492 ns_tooltip = [[EmacsTooltip alloc] init];
2496 [ns_tooltip setText: str];
2497 size = [ns_tooltip frame].size;
2499 /* Move the tooltip window where the mouse pointer is. Resize and
2501 compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2504 [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2508 return unbind_to (count, Qnil);
2512 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2513 doc: /* Hide the current tooltip window, if there is any.
2514 Value is t if tooltip was open, nil otherwise. */)
2517 if (ns_tooltip == nil || ![ns_tooltip isActive])
2524 /* ==========================================================================
2526 Class implementations
2528 ========================================================================== */
2531 @implementation EmacsSavePanel
2532 #ifdef NS_IMPL_COCOA
2533 /* --------------------------------------------------------------------------
2534 These are overridden to intercept on OS X: ending panel restarts NSApp
2535 event loop if it is stopped. Not sure if this is correct behavior,
2536 perhaps should check if running and if so send an appdefined.
2537 -------------------------------------------------------------------------- */
2538 - (void) ok: (id)sender
2544 - (void) cancel: (id)sender
2546 [super cancel: sender];
2553 @implementation EmacsOpenPanel
2554 #ifdef NS_IMPL_COCOA
2555 /* --------------------------------------------------------------------------
2556 These are overridden to intercept on OS X: ending panel restarts NSApp
2557 event loop if it is stopped. Not sure if this is correct behavior,
2558 perhaps should check if running and if so send an appdefined.
2559 -------------------------------------------------------------------------- */
2560 - (void) ok: (id)sender
2566 - (void) cancel: (id)sender
2568 [super cancel: sender];
2575 @implementation EmacsFileDelegate
2576 /* --------------------------------------------------------------------------
2577 Delegate methods for Open/Save panels
2578 -------------------------------------------------------------------------- */
2579 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2583 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2587 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2588 confirmed: (BOOL)okFlag
2597 /* ==========================================================================
2599 Lisp interface declaration
2601 ========================================================================== */
2609 Qfontsize = intern ("fontsize");
2610 staticpro (&Qfontsize);
2612 DEFVAR_LISP ("ns-icon-type-alist", &Vns_icon_type_alist,
2613 doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2614 If the title of a frame matches REGEXP, then IMAGE.tiff is
2615 selected as the image of the icon representing the frame when it's
2616 miniaturized. If an element is t, then Emacs tries to select an icon
2617 based on the filetype of the visited file.
2619 The images have to be installed in a folder called English.lproj in the
2620 Emacs folder. You have to restart Emacs after installing new icons.
2622 Example: Install an icon Gnus.tiff and execute the following code
2624 (setq ns-icon-type-alist
2625 (append ns-icon-type-alist
2626 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2629 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2630 be used as the image of the icon representing the frame. */);
2631 Vns_icon_type_alist = Fcons (Qt, Qnil);
2633 DEFVAR_LISP ("ns-version-string", &Vns_version_string,
2634 doc: /* Toolkit version for NS Windowing. */);
2635 Vns_version_string = ns_appkit_version_str ();
2637 defsubr (&Sns_read_file_name);
2638 defsubr (&Sns_get_resource);
2639 defsubr (&Sns_set_resource);
2640 defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2641 defsubr (&Sx_display_grayscale_p);
2642 defsubr (&Sns_font_name);
2643 defsubr (&Sns_list_colors);
2644 #ifdef NS_IMPL_COCOA
2645 defsubr (&Sns_do_applescript);
2647 defsubr (&Sxw_color_defined_p);
2648 defsubr (&Sxw_color_values);
2649 defsubr (&Sx_server_max_request_size);
2650 defsubr (&Sx_server_vendor);
2651 defsubr (&Sx_server_version);
2652 defsubr (&Sx_display_pixel_width);
2653 defsubr (&Sx_display_pixel_height);
2654 defsubr (&Sns_display_usable_bounds);
2655 defsubr (&Sx_display_mm_width);
2656 defsubr (&Sx_display_mm_height);
2657 defsubr (&Sx_display_screens);
2658 defsubr (&Sx_display_planes);
2659 defsubr (&Sx_display_color_cells);
2660 defsubr (&Sx_display_visual_class);
2661 defsubr (&Sx_display_backing_store);
2662 defsubr (&Sx_display_save_under);
2663 defsubr (&Sx_create_frame);
2664 defsubr (&Sx_open_connection);
2665 defsubr (&Sx_close_connection);
2666 defsubr (&Sx_display_list);
2668 defsubr (&Sns_hide_others);
2669 defsubr (&Sns_hide_emacs);
2670 defsubr (&Sns_emacs_info_panel);
2671 defsubr (&Sns_list_services);
2672 defsubr (&Sns_perform_service);
2673 defsubr (&Sns_convert_utf8_nfd_to_nfc);
2674 defsubr (&Sx_focus_frame);
2675 defsubr (&Sns_popup_font_panel);
2676 defsubr (&Sns_popup_color_panel);
2678 defsubr (&Sx_show_tip);
2679 defsubr (&Sx_hide_tip);
2681 /* used only in fontset.c */
2682 check_window_system_func = check_ns;
2686 // arch-tag: dc2a3f74-1123-4daa-8eed-fb78db6a5642