1 /* Functions for the NeXT/Open/GNUstep and MacOSX window system.
2 Copyright (C) 1989, 1992, 1993, 1994, 2005, 2006, 2008, 2009
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;
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)
209 struct terminal *terminal = get_terminal (screen, 1);
210 if (terminal->type != output_ns)
211 // Not sure if this special case for nil is needed. It does seem to be
212 // important in xfns.c for the make-frame call in frame-initialize,
213 // so let's keep it here for now.
214 return (NILP (screen) ? [NSScreen mainScreen] : NULL);
217 struct ns_display_info *dpyinfo = terminal->display_info.ns;
218 struct frame *f = dpyinfo->x_focus_frame;
220 f = dpyinfo->x_highlight_frame;
227 eassert (FRAME_NS_P (f));
228 XSETFRAME (frame, f);
229 window = ns_get_window (frame);
230 return window ? [window screen] : NULL;
236 /* Return the X display structure for the display named NAME.
237 Open a new connection if necessary. */
238 struct ns_display_info *
239 ns_display_info_for_name (name)
243 struct ns_display_info *dpyinfo;
247 for (dpyinfo = x_display_list, names = ns_display_name_list;
249 dpyinfo = dpyinfo->next, names = XCDR (names))
252 tem = Fstring_equal (XCAR (XCAR (names)), name);
257 error ("Emacs for OpenStep does not yet support multi-display.");
259 Fx_open_connection (name, Qnil, Qnil);
260 dpyinfo = x_display_list;
263 error ("OpenStep on %s not responding.\n", SDATA (name));
270 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
271 /* --------------------------------------------------------------------------
272 Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
273 -------------------------------------------------------------------------- */
283 count = [menu numberOfItems];
284 for (i = 0; i<count; i++)
286 item = [menu itemAtIndex: i];
287 name = [[item title] UTF8String];
290 nameStr = build_string (name);
292 if ([item hasSubmenu])
294 old = interpret_services_menu ([item submenu],
295 Fcons (nameStr, prefix), old);
299 keys = [item keyEquivalent];
300 if (keys && [keys length] )
302 key = [keys characterAtIndex: 0];
303 res = make_number (key|super_modifier);
309 old = Fcons (Fcons (res,
310 Freverse (Fcons (nameStr,
320 /* ==========================================================================
322 Frame parameter setters
324 ========================================================================== */
328 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
332 if (ns_lisp_to_color (arg, &col))
334 store_frame_param (f, Qforeground_color, oldval);
335 error ("Unknown color");
339 [f->output_data.ns->foreground_color release];
340 f->output_data.ns->foreground_color = col;
342 if (FRAME_NS_VIEW (f))
344 update_face_from_frame_parameter (f, Qforeground_color, arg);
345 /*recompute_basic_faces (f); */
346 if (FRAME_VISIBLE_P (f))
353 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
357 NSView *view = FRAME_NS_VIEW (f);
360 if (ns_lisp_to_color (arg, &col))
362 store_frame_param (f, Qbackground_color, oldval);
363 error ("Unknown color");
366 /* clear the frame; in some instances the NS-internal GC appears not to
367 update, or it does update and cannot clear old text properly */
368 if (FRAME_VISIBLE_P (f))
372 [f->output_data.ns->background_color release];
373 f->output_data.ns->background_color = col;
376 [[view window] setBackgroundColor: col];
377 alpha = [col alphaComponent];
380 [[view window] setOpaque: NO];
382 [[view window] setOpaque: YES];
384 face = FRAME_DEFAULT_FACE (f);
387 col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
389 = (EMACS_UINT) [[col colorWithAlphaComponent: alpha] retain];
392 update_face_from_frame_parameter (f, Qbackground_color, arg);
395 if (FRAME_VISIBLE_P (f))
402 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
406 if (ns_lisp_to_color (arg, &col))
408 store_frame_param (f, Qcursor_color, oldval);
409 error ("Unknown color");
412 [FRAME_CURSOR_COLOR (f) release];
413 FRAME_CURSOR_COLOR (f) = [col retain];
415 if (FRAME_VISIBLE_P (f))
417 x_update_cursor (f, 0);
418 x_update_cursor (f, 1);
420 update_face_from_frame_parameter (f, Qcursor_color, arg);
425 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
427 NSView *view = FRAME_NS_VIEW (f);
428 NSTRACE (x_set_icon_name);
433 /* see if it's changed */
436 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
439 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
446 if (!NILP (f->title))
449 /* explicit name and no icon-name -> explicit_name */
450 if (f->explicit_name)
454 /* no explicit name and no icon-name ->
455 name has to be rebuild from icon_title_format */
456 windows_or_buffers_changed++;
461 /* Don't change the name if it's already NAME. */
462 if ([[view window] miniwindowTitle] &&
463 ([[[view window] miniwindowTitle]
464 isEqualToString: [NSString stringWithUTF8String:
468 [[view window] setMiniwindowTitle:
469 [NSString stringWithUTF8String: SDATA (arg)]];
474 ns_set_name_iconic (struct frame *f, Lisp_Object name, int explicit)
476 NSView *view = FRAME_NS_VIEW (f);
477 NSTRACE (ns_set_name_iconic);
482 /* Make sure that requests from lisp code override requests from
483 Emacs redisplay code. */
486 /* If we're switching from explicit to implicit, we had better
487 update the mode lines and thereby update the title. */
488 if (f->explicit_name && NILP (name))
489 update_mode_lines = 1;
491 f->explicit_name = ! NILP (name);
493 else if (f->explicit_name)
496 /* title overrides explicit name */
497 if (! NILP (f->title))
500 /* icon_name overrides title and explicit name */
501 if (! NILP (f->icon_name))
505 name = build_string([ns_app_name UTF8String]);
509 /* Don't change the name if it's already NAME. */
510 if ([[view window] miniwindowTitle] &&
511 ([[[view window] miniwindowTitle]
512 isEqualToString: [NSString stringWithUTF8String:
516 [[view window] setMiniwindowTitle:
517 [NSString stringWithUTF8String: SDATA (name)]];
522 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
525 NSTRACE (ns_set_name);
530 /* Make sure that requests from lisp code override requests from
531 Emacs redisplay code. */
534 /* If we're switching from explicit to implicit, we had better
535 update the mode lines and thereby update the title. */
536 if (f->explicit_name && NILP (name))
537 update_mode_lines = 1;
539 f->explicit_name = ! NILP (name);
541 else if (f->explicit_name)
545 name = build_string([ns_app_name UTF8String]);
549 /* title overrides explicit name */
550 if (! NILP (f->title))
555 view = FRAME_NS_VIEW (f);
557 /* Don't change the name if it's already NAME. */
558 if ([[[view window] title]
559 isEqualToString: [NSString stringWithUTF8String:
562 [[view window] setTitle: [NSString stringWithUTF8String:
567 /* This function should be called when the user's lisp code has
568 specified a name for the frame; the name will override any set by the
571 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
573 NSTRACE (x_explicitly_set_name);
574 ns_set_name_iconic (f, arg, 1);
575 ns_set_name (f, arg, 1);
579 /* This function should be called by Emacs redisplay code to set the
580 name; names set this way will never override names set by the user's
583 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
585 NSTRACE (x_implicitly_set_name);
586 if (FRAME_ICONIFIED_P (f))
587 ns_set_name_iconic (f, arg, 0);
589 ns_set_name (f, arg, 0);
593 /* Change the title of frame F to NAME.
594 If NAME is nil, use the frame name as the title.
596 If EXPLICIT is non-zero, that indicates that lisp code is setting the
597 name; if NAME is a string, set F's name to NAME and set
598 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
600 If EXPLICIT is zero, that indicates that Emacs redisplay code is
601 suggesting a new name, which lisp code should override; if
602 F->explicit_name is set, ignore the new name; otherwise, set it. */
604 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
606 NSTRACE (x_set_title);
607 /* Don't change the title if it's already NAME. */
608 if (EQ (name, f->title))
611 update_mode_lines = 1;
618 ns_set_name_as_filename (struct frame *f)
622 Lisp_Object buf = XWINDOW (f->selected_window)->buffer;
624 NSAutoreleasePool *pool;
625 NSTRACE (ns_set_name_as_filename);
627 if (f->explicit_name || ! NILP (f->title) || ns_in_resize)
631 pool = [[NSAutoreleasePool alloc] init];
632 name =XBUFFER (buf)->filename;
633 if (NILP (name) || FRAME_ICONIFIED_P (f)) name =XBUFFER (buf)->name;
635 if (FRAME_ICONIFIED_P (f) && !NILP (f->icon_name))
639 name = build_string([ns_app_name UTF8String]);
643 view = FRAME_NS_VIEW (f);
645 title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
646 : [[[view window] title] UTF8String];
648 if (title && (! strcmp (title, SDATA (name))))
655 if (! FRAME_ICONIFIED_P (f))
658 /* work around a bug observed on 10.3 where
659 setTitleWithRepresentedFilename does not clear out previous state
660 if given filename does not exist */
661 NSString *str = [NSString stringWithUTF8String: SDATA (name)];
662 if (![[NSFileManager defaultManager] fileExistsAtPath: str])
664 [[view window] setTitleWithRepresentedFilename: @""];
665 [[view window] setTitle: str];
669 [[view window] setTitleWithRepresentedFilename: str];
672 [[view window] setTitleWithRepresentedFilename:
673 [NSString stringWithUTF8String: SDATA (name)]];
679 [[view window] setMiniwindowTitle:
680 [NSString stringWithUTF8String: SDATA (name)]];
688 ns_set_doc_edited (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
690 NSView *view = FRAME_NS_VIEW (f);
691 NSAutoreleasePool *pool;
693 pool = [[NSAutoreleasePool alloc] init];
694 [[view window] setDocumentEdited: !NILP (arg)];
701 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
704 int olines = FRAME_MENU_BAR_LINES (f);
705 if (FRAME_MINIBUF_ONLY_P (f))
708 if (INTEGERP (value))
709 nlines = XINT (value);
713 FRAME_MENU_BAR_LINES (f) = 0;
716 FRAME_EXTERNAL_MENU_BAR (f) = 1;
717 /* does for all frames, whereas we just want for one frame
718 [NSMenu setMenuBarVisible: YES]; */
722 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
723 free_frame_menubar (f);
724 /* [NSMenu setMenuBarVisible: NO]; */
725 FRAME_EXTERNAL_MENU_BAR (f) = 0;
730 /* toolbar support */
732 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
735 Lisp_Object root_window;
737 if (FRAME_MINIBUF_ONLY_P (f))
740 if (INTEGERP (value) && XINT (value) >= 0)
741 nlines = XFASTINT (value);
747 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
748 update_frame_tool_bar (f);
752 if (FRAME_EXTERNAL_TOOL_BAR (f))
754 free_frame_tool_bar (f);
755 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
759 x_set_window_size (f, 0, f->text_cols, f->text_lines);
764 ns_implicitly_set_icon_type (struct frame *f)
767 EmacsView *view = FRAME_NS_VIEW (f);
769 Lisp_Object chain, elt;
770 NSAutoreleasePool *pool;
773 NSTRACE (ns_implicitly_set_icon_type);
776 pool = [[NSAutoreleasePool alloc] init];
777 if (f->output_data.ns->miniimage
778 && [[NSString stringWithUTF8String: SDATA (f->name)]
779 isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
786 tem = assq_no_quit (Qicon_type, f->param_alist);
787 if (CONSP (tem) && ! NILP (XCDR (tem)))
794 for (chain = Vns_icon_type_alist;
795 (image = nil) && CONSP (chain);
796 chain = XCDR (chain))
799 /* special case: 't' means go by file type */
800 if (SYMBOLP (elt) && EQ (elt, Qt) && SDATA (f->name)[0] == '/')
803 = [NSString stringWithUTF8String: SDATA (f->name)];
804 if ([[NSFileManager defaultManager] fileExistsAtPath: str])
805 image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
807 else if (CONSP (elt) &&
808 STRINGP (XCAR (elt)) &&
809 STRINGP (XCDR (elt)) &&
810 fast_string_match (XCAR (elt), f->name) >= 0)
812 image = [EmacsImage allocInitFromFile: XCDR (elt)];
814 image = [[NSImage imageNamed:
815 [NSString stringWithUTF8String:
816 SDATA (XCDR (elt))]] retain];
822 image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
826 [f->output_data.ns->miniimage release];
827 f->output_data.ns->miniimage = image;
828 [view setMiniwindowImage: setMini];
835 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
837 EmacsView *view = FRAME_NS_VIEW (f);
841 NSTRACE (x_set_icon_type);
843 if (!NILP (arg) && SYMBOLP (arg))
845 arg =build_string (SDATA (SYMBOL_NAME (arg)));
846 store_frame_param (f, Qicon_type, arg);
849 /* do it the implicit way */
852 ns_implicitly_set_icon_type (f);
858 image = [EmacsImage allocInitFromFile: arg];
860 image =[NSImage imageNamed: [NSString stringWithUTF8String:
865 image = [NSImage imageNamed: @"text"];
869 f->output_data.ns->miniimage = image;
870 [view setMiniwindowImage: setMini];
874 /* Xism; we stub out (we do implement this in ns-win.el) */
876 XParseGeometry (char *string, int *x, int *y,
877 unsigned int *width, unsigned int *height)
879 message1 ("Warning: XParseGeometry not supported under NS.\n");
884 /* TODO: move to nsterm? */
886 ns_lisp_to_cursor_type (Lisp_Object arg)
889 if (XTYPE (arg) == Lisp_String)
891 else if (XTYPE (arg) == Lisp_Symbol)
892 str = SDATA (SYMBOL_NAME (arg));
894 if (!strcmp (str, "box")) return FILLED_BOX_CURSOR;
895 if (!strcmp (str, "hollow")) return HOLLOW_BOX_CURSOR;
896 if (!strcmp (str, "hbar")) return HBAR_CURSOR;
897 if (!strcmp (str, "bar")) return BAR_CURSOR;
898 if (!strcmp (str, "no")) return NO_CURSOR;
904 ns_cursor_type_to_lisp (int arg)
908 case FILLED_BOX_CURSOR: return Qbox;
909 case HOLLOW_BOX_CURSOR: return intern ("hollow");
910 case HBAR_CURSOR: return intern ("hbar");
911 case BAR_CURSOR: return intern ("bar");
913 default: return intern ("no");
917 /* This is the same as the xfns.c definition. */
919 x_set_cursor_type (f, arg, oldval)
921 Lisp_Object arg, oldval;
923 set_frame_cursor_types (f, arg);
925 /* Make sure the cursor gets redrawn. */
926 cursor_type_changed = 1;
930 /* called to set mouse pointer color, but all other terms use it to
931 initialize pointer types (and don't set the color ;) */
933 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
935 /* don't think we can do this on Nextstep */
940 #define Xstr(x) Str(x)
943 ns_appkit_version_str ()
947 #ifdef NS_IMPL_GNUSTEP
948 sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
949 #elif defined(NS_IMPL_COCOA)
950 sprintf(tmp, "apple-appkit-%.2f", NSAppKitVersionNumber);
954 return build_string (tmp);
958 /* This is for use by x-server-version and collapses all version info we
959 have into a single int. For a better picture of the implementation
960 running, use ns_appkit_version_str.*/
962 ns_appkit_version_int ()
964 #ifdef NS_IMPL_GNUSTEP
965 return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GUI_MINOR_VERSION;
966 #elif defined(NS_IMPL_COCOA)
967 return (int)NSAppKitVersionNumber;
974 x_icon (struct frame *f, Lisp_Object parms)
975 /* --------------------------------------------------------------------------
976 Strangely-named function to set icon position parameters in frame.
977 This is irrelevant under OS X, but might be needed under GNUstep,
978 depending on the window manager used. Note, this is not a standard
979 frame parameter-setter; it is called directly from x-create-frame.
980 -------------------------------------------------------------------------- */
982 Lisp_Object icon_x, icon_y;
983 struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
985 f->output_data.ns->icon_top = Qnil;
986 f->output_data.ns->icon_left = Qnil;
988 /* Set the position of the icon. */
989 icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
990 icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
991 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
993 CHECK_NUMBER (icon_x);
994 CHECK_NUMBER (icon_y);
995 f->output_data.ns->icon_top = icon_y;
996 f->output_data.ns->icon_left = icon_x;
998 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
999 error ("Both left and top icon corners of icon must be specified");
1003 /* Note: see frame.c for template, also where generic functions are impl */
1004 frame_parm_handler ns_frame_parm_handlers[] =
1006 x_set_autoraise, /* generic OK */
1007 x_set_autolower, /* generic OK */
1008 x_set_background_color,
1009 0, /* x_set_border_color, may be impossible under Nextstep */
1010 0, /* x_set_border_width, may be impossible under Nextstep */
1013 x_set_font, /* generic OK */
1014 x_set_foreground_color,
1017 x_set_internal_border_width, /* generic OK */
1018 x_set_menu_bar_lines,
1020 x_explicitly_set_name,
1021 x_set_scroll_bar_width, /* generic OK */
1023 x_set_unsplittable, /* generic OK */
1024 x_set_vertical_scroll_bars, /* generic OK */
1025 x_set_visibility, /* generic OK */
1026 x_set_tool_bar_lines,
1027 0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
1028 0, /* x_set_scroll_bar_background, will ignore (not possible on NS) */
1029 x_set_screen_gamma, /* generic OK */
1030 x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
1031 x_set_fringe_width, /* generic OK */
1032 x_set_fringe_width, /* generic OK */
1033 0, /* x_set_wait_for_wm, will ignore */
1034 0, /* x_set_fullscreen will ignore */
1035 x_set_font_backend, /* generic OK */
1037 0, /* x_set_sticky */
1042 /* ==========================================================================
1046 ========================================================================== */
1048 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1050 doc: /* Make a new Nextstep window, called a \"frame\" in Emacs terms.
1051 Return an Emacs frame object.
1052 PARMS is an alist of frame parameters.
1053 If the parameters specify that the frame should not have a minibuffer,
1054 and do not specify a specific minibuffer window to use,
1055 then `default-minibuffer-frame' must be a frame whose minibuffer can
1056 be shared by the new frame. */)
1060 static int desc_ctr = 1;
1062 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1063 Lisp_Object frame, tem;
1065 int minibuffer_only = 0;
1066 int count = specpdl_ptr - specpdl;
1067 Lisp_Object display;
1068 struct ns_display_info *dpyinfo = NULL;
1071 Lisp_Object tfont, tfontsize;
1072 int window_prompting = 0;
1077 /* Seems a little strange, but other terms do it. Perhaps the code below
1078 is modifying something? */
1079 parms = Fcopy_alist (parms);
1081 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1082 if (EQ (display, Qunbound))
1084 dpyinfo = check_ns_display_info (display);
1086 if (!dpyinfo->terminal->name)
1087 error ("Terminal is not live, can't create new frames on it");
1089 kb = dpyinfo->terminal->kboard;
1091 name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1093 && ! EQ (name, Qunbound)
1095 error ("Invalid frame name--not a string or nil");
1098 Vx_resource_name = name;
1100 Vx_resource_name = Vinvocation_name;
1102 parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1103 if (EQ (parent, Qunbound))
1105 if (! NILP (parent))
1106 CHECK_NUMBER (parent);
1109 GCPRO4 (parms, parent, name, frame);
1111 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1113 if (EQ (tem, Qnone) || NILP (tem))
1115 f = make_frame_without_minibuffer (Qnil, kb, display);
1117 else if (EQ (tem, Qonly))
1119 f = make_minibuffer_frame ();
1120 minibuffer_only = 1;
1122 else if (WINDOWP (tem))
1124 f = make_frame_without_minibuffer (tem, kb, display);
1131 /* Set the name; the functions to which we pass f expect the name to
1133 if (EQ (name, Qunbound) || NILP (name) || (XTYPE (name) != Lisp_String))
1135 f->name = build_string ([ns_app_name UTF8String]);
1136 f->explicit_name =0;
1141 f->explicit_name = 1;
1142 specbind (Qx_resource_name, name);
1145 XSETFRAME (frame, f);
1146 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
1148 f->terminal = dpyinfo->terminal;
1149 f->terminal->reference_count++;
1151 f->output_method = output_ns;
1152 f->output_data.ns = (struct ns_output *)xmalloc (sizeof *(f->output_data.ns));
1153 bzero (f->output_data.ns, sizeof (*(f->output_data.ns)));
1155 FRAME_FONTSET (f) = -1;
1157 /* record_unwind_protect (unwind_create_frame, frame); safety; maybe later? */
1159 f->icon_name = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
1161 if (! STRINGP (f->icon_name))
1162 f->icon_name = Qnil;
1164 FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1166 f->output_data.ns->window_desc = desc_ctr++;
1169 f->output_data.ns->parent_desc = (Window) XFASTINT (parent);
1170 f->output_data.ns->explicit_parent = 1;
1174 f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1175 f->output_data.ns->explicit_parent = 0;
1178 f->resx = dpyinfo->resx;
1179 f->resy = dpyinfo->resy;
1182 register_font_driver (&nsfont_driver, f);
1183 x_default_parameter (f, parms, Qfont_backend, Qnil,
1184 "fontBackend", "FontBackend", RES_TYPE_STRING);
1187 /* use for default font name */
1188 id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1189 tfontsize = x_default_parameter (f, parms, Qfontsize,
1190 make_number (0 /*(int)[font pointSize]*/),
1191 "fontSize", "FontSize", RES_TYPE_NUMBER);
1192 tfont = x_default_parameter (f, parms, Qfont,
1193 build_string ([[font fontName] UTF8String]),
1194 "font", "Font", RES_TYPE_STRING);
1198 x_default_parameter (f, parms, Qborder_width, make_number (0),
1199 "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1200 x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1201 "internalBorderWidth", "InternalBorderWidth",
1204 /* default scrollbars on right on Mac */
1207 #ifdef NS_IMPL_GNUSTEP
1212 x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1213 "verticalScrollBars", "VerticalScrollBars",
1216 x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1217 "foreground", "Foreground", RES_TYPE_STRING);
1218 x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1219 "background", "Background", RES_TYPE_STRING);
1220 x_default_parameter (f, parms, Qcursor_color, build_string ("grey"),
1221 "cursorColor", "CursorColor", RES_TYPE_STRING);
1222 /* FIXME: not suppported yet in Nextstep */
1223 x_default_parameter (f, parms, Qline_spacing, Qnil,
1224 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1225 x_default_parameter (f, parms, Qleft_fringe, Qnil,
1226 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1227 x_default_parameter (f, parms, Qright_fringe, Qnil,
1228 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1231 init_frame_faces (f);
1233 x_default_parameter (f, parms, Qmenu_bar_lines, make_number (0), "menuBar",
1234 "menuBar", RES_TYPE_NUMBER);
1235 x_default_parameter (f, parms, Qtool_bar_lines, make_number (0), "toolBar",
1236 "toolBar", RES_TYPE_NUMBER);
1237 x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1238 "BufferPredicate", RES_TYPE_SYMBOL);
1239 x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1242 /* TODO: other terms seem to get away w/o this complexity.. */
1243 if (NILP (Fassq (Qwidth, parms)))
1246 = x_get_arg (dpyinfo, parms, Qwidth, "width", "Width",
1248 if (! EQ (value, Qunbound))
1249 parms = Fcons (Fcons (Qwidth, value), parms);
1251 if (NILP (Fassq (Qheight, parms)))
1254 = x_get_arg (dpyinfo, parms, Qheight, "height", "Height",
1256 if (! EQ (value, Qunbound))
1257 parms = Fcons (Fcons (Qheight, value), parms);
1259 if (NILP (Fassq (Qleft, parms)))
1262 = x_get_arg (dpyinfo, parms, Qleft, "left", "Left", RES_TYPE_NUMBER);
1263 if (! EQ (value, Qunbound))
1264 parms = Fcons (Fcons (Qleft, value), parms);
1266 if (NILP (Fassq (Qtop, parms)))
1269 = x_get_arg (dpyinfo, parms, Qtop, "top", "Top", RES_TYPE_NUMBER);
1270 if (! EQ (value, Qunbound))
1271 parms = Fcons (Fcons (Qtop, value), parms);
1274 window_prompting = x_figure_window_size (f, parms, 1);
1276 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1277 f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1279 /* NOTE: on other terms, this is done in set_mouse_color, however this
1280 was not getting called under Nextstep */
1281 f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1282 f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1283 f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1284 f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1285 f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1286 f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1287 FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1288 = [NSCursor arrowCursor];
1289 f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1291 [[EmacsView alloc] initFrameFromEmacs: f];
1295 /* It is now ok to make the frame official even if we get an error below.
1296 The frame needs to be on Vframe_list or making it visible won't work. */
1297 Vframe_list = Fcons (frame, Vframe_list);
1298 /*FRAME_NS_DISPLAY_INFO (f)->reference_count++; */
1300 x_default_parameter (f, parms, Qicon_type, Qnil, "bitmapIcon", "BitmapIcon",
1302 x_default_parameter (f, parms, Qauto_raise, Qnil, "autoRaise", "AutoRaiseLower",
1304 x_default_parameter (f, parms, Qauto_lower, Qnil, "autoLower", "AutoLower",
1306 x_default_parameter (f, parms, Qcursor_type, Qbox, "cursorType", "CursorType",
1308 x_default_parameter (f, parms, Qscroll_bar_width, Qnil, "scrollBarWidth",
1309 "ScrollBarWidth", RES_TYPE_NUMBER);
1310 x_default_parameter (f, parms, Qalpha, Qnil, "alpha", "Alpha",
1313 width = FRAME_COLS (f);
1314 height = FRAME_LINES (f);
1316 SET_FRAME_COLS (f, 0);
1317 FRAME_LINES (f) = 0;
1318 change_frame_size (f, height, width, 1, 0, 0);
1320 if (! f->output_data.ns->explicit_parent)
1322 tem = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL);
1323 if (EQ (tem, Qunbound))
1325 x_set_visibility (f, tem, Qnil);
1326 if (EQ (tem, Qicon))
1327 x_iconify_frame (f);
1328 else if (! NILP (tem))
1330 x_make_frame_visible (f);
1331 f->async_visible = 1;
1332 [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1335 f->async_visible = 0;
1338 if (FRAME_HAS_MINIBUF_P (f)
1339 && (!FRAMEP (kb->Vdefault_minibuffer_frame)
1340 || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
1341 kb->Vdefault_minibuffer_frame = frame;
1343 /* All remaining specified parameters, which have not been "used"
1344 by x_get_arg and friends, now go in the misc. alist of the frame. */
1345 for (tem = parms; CONSP (tem); tem = XCDR (tem))
1346 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1347 f->param_alist = Fcons (XCAR (tem), f->param_alist);
1350 Vwindow_list = Qnil;
1352 return unbind_to (count, frame);
1356 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1357 doc: /* Set the input focus to FRAME.
1358 FRAME nil means use the selected frame. */)
1362 struct frame *f = check_ns_frame (frame);
1363 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1365 if (dpyinfo->x_focus_frame != f)
1367 EmacsView *view = FRAME_NS_VIEW (f);
1369 [NSApp activateIgnoringOtherApps: YES];
1370 [[view window] makeKeyAndOrderFront: view];
1378 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1380 doc: /* Pop up the font panel. */)
1388 fm = [NSFontManager sharedFontManager];
1390 f = SELECTED_FRAME ();
1393 CHECK_FRAME (frame);
1397 [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1399 [fm orderFrontFontPanel: NSApp];
1404 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1406 doc: /* Pop up the color panel. */)
1414 f = SELECTED_FRAME ();
1417 CHECK_FRAME (frame);
1421 [NSApp orderFrontColorPanel: NSApp];
1426 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 4, 0,
1427 doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1428 Optional arg DIR, if non-nil, supplies a default directory.
1429 Optional arg ISLOAD, if non-nil, means read a file name for saving.
1430 Optional arg INIT, if non-nil, provides a default file name to use. */)
1431 (prompt, dir, isLoad, init)
1432 Lisp_Object prompt, dir, isLoad, init;
1434 static id fileDelegate = nil;
1439 NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1440 [NSString stringWithUTF8String: SDATA (prompt)];
1441 NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1442 [NSString stringWithUTF8String: SDATA (current_buffer->directory)] :
1443 [NSString stringWithUTF8String: SDATA (dir)];
1444 NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1445 [NSString stringWithUTF8String: SDATA (init)];
1449 if (fileDelegate == nil)
1450 fileDelegate = [EmacsFileDelegate new];
1452 [NSCursor setHiddenUntilMouseMoves: NO];
1454 if ([dirS characterAtIndex: 0] == '~')
1455 dirS = [dirS stringByExpandingTildeInPath];
1457 panel = NILP (isLoad) ?
1458 (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1460 [panel setTitle: promptS];
1462 /* Puma (10.1) does not have */
1463 if ([panel respondsToSelector: @selector (setAllowsOtherFileTypes:)])
1464 [panel setAllowsOtherFileTypes: YES];
1466 [panel setTreatsFilePackagesAsDirectories: YES];
1467 [panel setDelegate: fileDelegate];
1473 ret = [panel runModalForDirectory: dirS file: initS];
1477 [panel setCanChooseDirectories: YES];
1478 ret = [panel runModalForDirectory: dirS file: initS types: nil];
1481 ret = (ret == NSOKButton) || panelOK;
1484 fname = build_string ([[panel filename] UTF8String]);
1486 [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1489 return ret ? fname : Qnil;
1493 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1494 doc: /* Return the value of the property NAME of OWNER from the defaults database.
1495 If OWNER is nil, Emacs is assumed. */)
1497 Lisp_Object owner, name;
1503 owner = build_string([ns_app_name UTF8String]);
1504 CHECK_STRING (name);
1505 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SDATA (name)); */
1507 value =[[[NSUserDefaults standardUserDefaults]
1508 objectForKey: [NSString stringWithUTF8String: SDATA (name)]]
1512 return build_string (value);
1517 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1518 doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1519 If OWNER is nil, Emacs is assumed.
1520 If VALUE is nil, the default is removed. */)
1521 (owner, name, value)
1522 Lisp_Object owner, name, value;
1526 owner = build_string ([ns_app_name UTF8String]);
1527 CHECK_STRING (name);
1530 [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1531 [NSString stringWithUTF8String: SDATA (name)]];
1535 CHECK_STRING (value);
1536 [[NSUserDefaults standardUserDefaults] setObject:
1537 [NSString stringWithUTF8String: SDATA (value)]
1538 forKey: [NSString stringWithUTF8String:
1546 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1547 Sx_server_max_request_size,
1549 doc: /* This function is a no-op. It is only present for completeness. */)
1551 Lisp_Object display;
1554 /* This function has no real equivalent under NeXTstep. Return nil to
1560 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1561 doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1562 DISPLAY should be either a frame or a display name (a string).
1563 If omitted or nil, the selected frame's display is used. */)
1565 Lisp_Object display;
1567 #ifdef NS_IMPL_GNUSTEP
1568 return build_string ("GNU");
1570 return build_string ("Apple");
1575 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1576 doc: /* Return the version numbers of the server of DISPLAY.
1577 The value is a list of three integers: the major and minor
1578 version numbers of the X Protocol in use, and the distributor-specific
1579 release number. See also the function `x-server-vendor'.
1581 The optional argument DISPLAY specifies which display to ask about.
1582 DISPLAY should be either a frame or a display name (a string).
1583 If omitted or nil, that stands for the selected frame's display. */)
1585 Lisp_Object display;
1587 /*NOTE: it is unclear what would best correspond with "protocol";
1588 we return 10.3, meaning Panther, since this is roughly the
1589 level that GNUstep's APIs correspond to.
1590 The last number is where we distinguish between the Apple
1591 and GNUstep implementations ("distributor-specific release
1592 number") and give int'ized versions of major.minor. */
1593 return Fcons (make_number (10),
1594 Fcons (make_number (3),
1595 Fcons (make_number (ns_appkit_version_int()), Qnil)));
1599 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1600 doc: /* Return the number of screens on Nextstep display server DISPLAY.
1601 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1602 If omitted or nil, the selected frame's display is used. */)
1604 Lisp_Object display;
1609 num = [[NSScreen screens] count];
1611 return (num != 0) ? make_number (num) : Qnil;
1615 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1617 doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1618 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1619 If omitted or nil, the selected frame's display is used. */)
1621 Lisp_Object display;
1624 return make_number ((int)
1625 ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1629 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1631 doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1632 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1633 If omitted or nil, the selected frame's display is used. */)
1635 Lisp_Object display;
1638 return make_number ((int)
1639 ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1643 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1644 Sx_display_backing_store, 0, 1, 0,
1645 doc: /* Return whether the Nexstep display DISPLAY supports backing store.
1646 The value may be `buffered', `retained', or `non-retained'.
1647 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1648 If omitted or nil, the selected frame's display is used. */)
1650 Lisp_Object display;
1653 switch ([ns_get_window (display) backingType])
1655 case NSBackingStoreBuffered:
1656 return intern ("buffered");
1657 case NSBackingStoreRetained:
1658 return intern ("retained");
1659 case NSBackingStoreNonretained:
1660 return intern ("non-retained");
1662 error ("Strange value for backingType parameter of frame");
1664 return Qnil; /* not reached, shut compiler up */
1668 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1669 Sx_display_visual_class, 0, 1, 0,
1670 doc: /* Return the visual class of the Nextstep display server DISPLAY.
1671 The value is one of the symbols `static-gray', `gray-scale',
1672 `static-color', `pseudo-color', `true-color', or `direct-color'.
1673 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1674 If omitted or nil, the selected frame's display is used. */)
1676 Lisp_Object display;
1678 NSWindowDepth depth;
1680 depth = [ns_get_screen (display) depth];
1682 if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1683 return intern ("static-gray");
1684 else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1685 return intern ("gray-scale");
1686 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1687 return intern ("pseudo-color");
1688 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1689 return intern ("true-color");
1690 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1691 return intern ("direct-color");
1693 /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1694 return intern ("direct-color");
1698 DEFUN ("x-display-save-under", Fx_display_save_under,
1699 Sx_display_save_under, 0, 1, 0,
1700 doc: /* Non-nil if the Nextstep display server supports the save-under feature.
1701 The optional argument DISPLAY specifies which display to ask about.
1702 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1703 If omitted or nil, the selected frame's display is used. */)
1705 Lisp_Object display;
1708 switch ([ns_get_window (display) backingType])
1710 case NSBackingStoreBuffered:
1713 case NSBackingStoreRetained:
1714 case NSBackingStoreNonretained:
1718 error ("Strange value for backingType parameter of frame");
1720 return Qnil; /* not reached, shut compiler up */
1724 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1726 doc: /* Open a connection to a Nextstep display server.
1727 DISPLAY is the name of the display to connect to.
1728 Optional arguments XRM-STRING and MUST-SUCCEED are currently ignored. */)
1729 (display, resource_string, must_succeed)
1730 Lisp_Object display, resource_string, must_succeed;
1732 struct ns_display_info *dpyinfo;
1734 CHECK_STRING (display);
1736 nxatoms_of_nsselect ();
1737 dpyinfo = ns_term_init (display);
1740 if (!NILP (must_succeed))
1741 fatal ("OpenStep on %s not responding.\n",
1744 error ("OpenStep on %s not responding.\n",
1748 /* Register our external input/output types, used for determining
1749 applicable services and also drag/drop eligibility. */
1750 ns_send_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1751 ns_return_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1752 ns_drag_types = [[NSArray arrayWithObjects:
1754 NSTabularTextPboardType,
1755 NSFilenamesPboardType,
1758 NSFontPboardType, nil] retain];
1764 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1766 doc: /* Close the connection to the current Nextstep display server.
1767 The argument DISPLAY is currently ignored. */)
1769 Lisp_Object display;
1772 /*ns_delete_terminal (dpyinfo->terminal); */
1773 [NSApp terminate: NSApp];
1778 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1779 doc: /* Return the list of display names that Emacs has connections to. */)
1782 Lisp_Object tail, result;
1785 for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1786 result = Fcons (XCAR (XCAR (tail)), result);
1792 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1794 doc: /* Hides all applications other than Emacs. */)
1798 [NSApp hideOtherApplications: NSApp];
1802 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1804 doc: /* If ON is non-nil, the entire Emacs application is hidden.
1805 Otherwise if Emacs is hidden, it is unhidden.
1806 If ON is equal to `activate', Emacs is unhidden and becomes
1807 the active application. */)
1812 if (EQ (on, intern ("activate")))
1814 [NSApp unhide: NSApp];
1815 [NSApp activateIgnoringOtherApps: YES];
1818 [NSApp unhide: NSApp];
1820 [NSApp hide: NSApp];
1825 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1827 doc: /* Shows the 'Info' or 'About' panel for Emacs. */)
1831 [NSApp orderFrontStandardAboutPanel: nil];
1836 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1837 doc: /* Determine font postscript or family name for font NAME.
1838 NAME should be a string containing either the font name or an XLFD
1839 font descriptor. If string contains `fontset' and not
1840 `fontset-startup', it is left alone. */)
1845 CHECK_STRING (name);
1850 if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1853 return build_string (ns_xlfd_to_fontname (SDATA (name)));
1857 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1858 doc: /* Return a list of all available colors.
1859 The optional argument FRAME is currently ignored. */)
1863 Lisp_Object list = Qnil;
1864 NSEnumerator *colorlists;
1869 CHECK_FRAME (frame);
1870 if (! FRAME_NS_P (XFRAME (frame)))
1871 error ("non-Nextstep frame used in `ns-list-colors'");
1876 colorlists = [[NSColorList availableColorLists] objectEnumerator];
1877 while (clist = [colorlists nextObject])
1879 if ([[clist name] length] < 7 ||
1880 [[clist name] rangeOfString: @"PANTONE"].location == 0)
1882 NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1884 while (cname = [cnames nextObject])
1885 list = Fcons (build_string ([cname UTF8String]), list);
1886 /* for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1887 list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1888 UTF8String]), list); */
1898 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1899 doc: /* List available Nextstep services by querying NSApp. */)
1902 Lisp_Object ret = Qnil;
1907 svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1908 [NSApp setServicesMenu: svcs]; /* this and next rebuild on <10.4 */
1909 [NSApp registerServicesMenuSendTypes: ns_send_types
1910 returnTypes: ns_return_types];
1912 /* On Tiger, services menu updating was made lazier (waits for user to
1913 actually click on the menu), so we have to force things along: */
1914 #ifdef NS_IMPL_COCOA
1915 if (NSAppKitVersionNumber >= 744.0)
1917 delegate = [svcs delegate];
1918 if (delegate != nil)
1920 if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1921 [delegate menuNeedsUpdate: svcs];
1922 if ([delegate respondsToSelector:
1923 @selector (menu:updateItem:atIndex:shouldCancel:)])
1925 int i, len = [delegate numberOfItemsInMenu: svcs];
1926 for (i =0; i<len; i++)
1927 [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1928 for (i =0; i<len; i++)
1929 if (![delegate menu: svcs
1930 updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1931 atIndex: i shouldCancel: NO])
1938 [svcs setAutoenablesItems: NO];
1939 #ifdef NS_IMPL_COCOA
1940 [svcs update]; /* on OS X, converts from '/' structure */
1943 ret = interpret_services_menu (svcs, Qnil, ret);
1948 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
1950 doc: /* Perform Nextstep SERVICE on SEND.
1951 SEND should be either a string or nil.
1952 The return value is the result of the service, as string, or nil if
1953 there was no result. */)
1955 Lisp_Object service, send;
1962 CHECK_STRING (service);
1965 utfStr = SDATA (service);
1966 svcName = [NSString stringWithUTF8String: utfStr];
1968 pb =[NSPasteboard pasteboardWithUniqueName];
1969 ns_string_to_pasteboard (pb, send);
1971 if (NSPerformService (svcName, pb) == NO)
1972 Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
1974 if ([[pb types] count] == 0)
1975 return build_string ("");
1976 return ns_string_from_pasteboard (pb);
1980 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
1981 Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
1982 doc: /* Return an NFC string that matches the UTF-8 NFD string STR. */)
1986 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
1991 utfStr = [NSString stringWithUTF8String: SDATA (str)];
1992 if (![utfStr respondsToSelector:
1993 @selector (precomposedStringWithCanonicalMapping)])
1996 ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
2000 utfStr = [utfStr precomposedStringWithCanonicalMapping];
2001 return build_string ([utfStr UTF8String]);
2005 #ifdef NS_IMPL_COCOA
2007 /* Compile and execute the AppleScript SCRIPT and return the error
2008 status as function value. A zero is returned if compilation and
2009 execution is successful, in which case *RESULT is set to a Lisp
2010 string or a number containing the resulting script value. Otherwise,
2013 ns_do_applescript (script, result)
2014 Lisp_Object script, *result;
2016 NSAppleEventDescriptor *desc;
2017 NSDictionary* errorDict;
2018 NSAppleEventDescriptor* returnDescriptor = NULL;
2020 NSAppleScript* scriptObject =
2021 [[NSAppleScript alloc] initWithSource:
2022 [NSString stringWithUTF8String: SDATA (script)]];
2024 returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2025 [scriptObject release];
2029 if (returnDescriptor != NULL)
2031 // successful execution
2032 if (kAENullEvent != [returnDescriptor descriptorType])
2035 // script returned an AppleScript result
2036 if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2037 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
2038 (typeUTF16ExternalRepresentation
2039 == [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.
2068 If compilation and execution are successful, the resulting script value
2069 is returned as a string, a number or, in the case of other constructs, t.
2070 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 /* called from image.c */
2103 check_x_frame (Lisp_Object frame)
2105 return check_ns_frame (frame);
2109 /* called from frame.c */
2110 struct ns_display_info *
2111 check_x_display_info (Lisp_Object frame)
2113 return check_ns_display_info (frame);
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 /* terms 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 if (inhibit_x_resources)
2138 /* --quick was passed, so this is a no-op. */
2141 res = [[[NSUserDefaults standardUserDefaults] objectForKey:
2142 [NSString stringWithUTF8String: toCheck]] UTF8String];
2143 return !res ? NULL :
2144 (!strncasecmp (res, "YES", 3) ? "true" :
2145 (!strncasecmp (res, "NO", 2) ? "false" : res));
2150 x_get_focus_frame (struct frame *frame)
2152 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2153 Lisp_Object nsfocus;
2155 if (!dpyinfo->x_focus_frame)
2158 XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2164 x_pixel_width (struct frame *f)
2166 return FRAME_PIXEL_WIDTH (f);
2171 x_pixel_height (struct frame *f)
2173 return FRAME_PIXEL_HEIGHT (f);
2178 x_char_width (struct frame *f)
2180 return FRAME_COLUMN_WIDTH (f);
2185 x_char_height (struct frame *f)
2187 return FRAME_LINE_HEIGHT (f);
2192 x_screen_planes (struct frame *f)
2194 return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2199 x_sync (Lisp_Object frame)
2201 /* XXX Not implemented XXX */
2207 /* ==========================================================================
2209 Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2211 ========================================================================== */
2214 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2215 doc: /* Return t if the current Nextstep display supports the color COLOR.
2216 The optional argument FRAME is currently ignored. */)
2218 Lisp_Object color, frame;
2222 return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2226 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2227 doc: /* Internal function called by `color-values', which see. */)
2229 Lisp_Object color, frame;
2232 CGFloat red, green, blue, alpha;
2235 CHECK_STRING (color);
2237 if (ns_lisp_to_color (color, &col))
2240 [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2241 getRed: &red green: &green blue: &blue alpha: &alpha];
2242 return list3 (make_number (lrint (red*65280)),
2243 make_number (lrint (green*65280)),
2244 make_number (lrint (blue*65280)));
2248 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2249 doc: /* Return t if the Nextstep display supports color.
2250 The optional argument DISPLAY specifies which display to ask about.
2251 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2252 If omitted or nil, that stands for the selected frame's display. */)
2254 Lisp_Object display;
2256 NSWindowDepth depth;
2257 NSString *colorSpace;
2259 depth = [ns_get_screen (display) depth];
2260 colorSpace = NSColorSpaceFromDepth (depth);
2262 return [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2263 || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2268 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2269 Sx_display_grayscale_p, 0, 1, 0,
2270 doc: /* Return t if the Nextstep display supports shades of gray.
2271 Note that color displays do support shades of gray.
2272 The optional argument DISPLAY specifies which display to ask about.
2273 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2274 If omitted or nil, that stands for the selected frame's display. */)
2276 Lisp_Object display;
2278 NSWindowDepth depth;
2280 depth = [ns_get_screen (display) depth];
2282 return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2286 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2288 doc: /* Return the width in pixels of the Nextstep display DISPLAY.
2289 The optional argument DISPLAY specifies which display to ask about.
2290 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2291 If omitted or nil, that stands for the selected frame's display. */)
2293 Lisp_Object display;
2296 return make_number ((int) [ns_get_screen (display) frame].size.width);
2300 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2301 Sx_display_pixel_height, 0, 1, 0,
2302 doc: /* Return the height in pixels of the Nextstep display DISPLAY.
2303 The optional argument DISPLAY specifies which display to ask about.
2304 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2305 If omitted or nil, that stands for the selected frame's display. */)
2307 Lisp_Object display;
2310 return make_number ((int) [ns_get_screen (display) frame].size.height);
2314 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2315 Sns_display_usable_bounds, 0, 1, 0,
2316 doc: /* Return the bounds of the usable part of the screen.
2317 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2318 are the boundaries of the usable part of the screen, excluding areas
2319 reserved for the Mac menu, dock, and so forth.
2321 The screen queried corresponds to DISPLAY, which should be either a
2322 frame, a display name (a string), or terminal ID. If omitted or nil,
2323 that stands for the selected frame's display. */)
2325 Lisp_Object display;
2331 vScreen = [ns_get_screen (display) visibleFrame];
2332 top = vScreen.origin.y == 0.0 ?
2333 (int) [ns_get_screen (display) frame].size.height - vScreen.size.height : 0;
2335 return list4 (make_number ((int) vScreen.origin.x),
2337 make_number ((int) vScreen.size.width),
2338 make_number ((int) vScreen.size.height));
2342 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2344 doc: /* Return the number of bitplanes of the Nextstep display DISPLAY.
2345 The optional argument DISPLAY specifies which display to ask about.
2346 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2347 If omitted or nil, that stands for the selected frame's display. */)
2349 Lisp_Object display;
2353 (NSBitsPerPixelFromDepth ([ns_get_screen (display) depth]));
2357 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2358 Sx_display_color_cells, 0, 1, 0,
2359 doc: /* Returns the number of color cells of the Nextstep display DISPLAY.
2360 The optional argument DISPLAY specifies which display to ask about.
2361 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2362 If omitted or nil, that stands for the selected frame's display. */)
2364 Lisp_Object display;
2367 struct ns_display_info *dpyinfo = check_ns_display_info (display);
2369 /* We force 24+ bit depths to 24-bit to prevent an overflow. */
2370 return make_number (1 << min (dpyinfo->n_planes, 24));
2374 /* Unused dummy def needed for compatibility. */
2375 Lisp_Object tip_frame;
2377 /* TODO: move to xdisp or similar */
2379 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
2381 Lisp_Object parms, dx, dy;
2383 int *root_x, *root_y;
2385 Lisp_Object left, top;
2386 EmacsView *view = FRAME_NS_VIEW (f);
2389 /* Start with user-specified or mouse position. */
2390 left = Fcdr (Fassq (Qleft, parms));
2391 if (INTEGERP (left))
2394 pt.x = last_mouse_motion_position.x;
2395 top = Fcdr (Fassq (Qtop, parms));
2399 pt.y = last_mouse_motion_position.y;
2401 /* Convert to screen coordinates */
2402 pt = [view convertPoint: pt toView: nil];
2403 pt = [[view window] convertBaseToScreen: pt];
2405 /* Ensure in bounds. (Note, screen origin = lower left.) */
2406 if (pt.x + XINT (dx) <= 0)
2407 *root_x = 0; /* Can happen for negative dx */
2408 else if (pt.x + XINT (dx) + width
2409 <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2410 /* It fits to the right of the pointer. */
2411 *root_x = pt.x + XINT (dx);
2412 else if (width + XINT (dx) <= pt.x)
2413 /* It fits to the left of the pointer. */
2414 *root_x = pt.x - width - XINT (dx);
2416 /* Put it left justified on the screen -- it ought to fit that way. */
2419 if (pt.y - XINT (dy) - height >= 0)
2420 /* It fits below the pointer. */
2421 *root_y = pt.y - height - XINT (dy);
2422 else if (pt.y + XINT (dy) + height
2423 <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2424 /* It fits above the pointer */
2425 *root_y = pt.y + XINT (dy);
2427 /* Put it on the top. */
2428 *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2432 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2433 doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2434 A tooltip window is a small window displaying a string.
2436 FRAME nil or omitted means use the selected frame.
2438 PARMS is an optional list of frame parameters which can be used to
2439 change the tooltip's appearance.
2441 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
2442 means use the default timeout of 5 seconds.
2444 If the list of frame parameters PARMS contains a `left' parameter,
2445 the tooltip is displayed at that x-position. Otherwise it is
2446 displayed at the mouse position, with offset DX added (default is 5 if
2447 DX isn't specified). Likewise for the y-position; if a `top' frame
2448 parameter is specified, it determines the y-position of the tooltip
2449 window, otherwise it is displayed at the mouse position, with offset
2450 DY added (default is -10).
2452 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2453 Text larger than the specified size is clipped. */)
2454 (string, frame, parms, timeout, dx, dy)
2455 Lisp_Object string, frame, parms, timeout, dx, dy;
2458 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2459 int count = SPECPDL_INDEX ();
2464 specbind (Qinhibit_redisplay, Qt);
2466 GCPRO4 (string, parms, frame, timeout);
2468 CHECK_STRING (string);
2469 str = SDATA (string);
2470 f = check_x_frame (frame);
2472 timeout = make_number (5);
2474 CHECK_NATNUM (timeout);
2477 dx = make_number (5);
2482 dy = make_number (-10);
2487 if (ns_tooltip == nil)
2488 ns_tooltip = [[EmacsTooltip alloc] init];
2492 [ns_tooltip setText: str];
2493 size = [ns_tooltip frame].size;
2495 /* Move the tooltip window where the mouse pointer is. Resize and
2497 compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2500 [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2504 return unbind_to (count, Qnil);
2508 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2509 doc: /* Hide the current tooltip window, if there is any.
2510 Value is t if tooltip was open, nil otherwise. */)
2513 if (ns_tooltip == nil || ![ns_tooltip isActive])
2520 /* ==========================================================================
2522 Class implementations
2524 ========================================================================== */
2527 @implementation EmacsSavePanel
2528 #ifdef NS_IMPL_COCOA
2529 /* --------------------------------------------------------------------------
2530 These are overridden to intercept on OS X: ending panel restarts NSApp
2531 event loop if it is stopped. Not sure if this is correct behavior,
2532 perhaps should check if running and if so send an appdefined.
2533 -------------------------------------------------------------------------- */
2534 - (void) ok: (id)sender
2540 - (void) cancel: (id)sender
2542 [super cancel: sender];
2549 @implementation EmacsOpenPanel
2550 #ifdef NS_IMPL_COCOA
2551 /* --------------------------------------------------------------------------
2552 These are overridden to intercept on OS X: ending panel restarts NSApp
2553 event loop if it is stopped. Not sure if this is correct behavior,
2554 perhaps should check if running and if so send an appdefined.
2555 -------------------------------------------------------------------------- */
2556 - (void) ok: (id)sender
2562 - (void) cancel: (id)sender
2564 [super cancel: sender];
2571 @implementation EmacsFileDelegate
2572 /* --------------------------------------------------------------------------
2573 Delegate methods for Open/Save panels
2574 -------------------------------------------------------------------------- */
2575 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2579 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2583 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2584 confirmed: (BOOL)okFlag
2593 /* ==========================================================================
2595 Lisp interface declaration
2597 ========================================================================== */
2605 Qnone = intern ("none");
2607 Qfontsize = intern ("fontsize");
2608 staticpro (&Qfontsize);
2610 DEFVAR_LISP ("ns-icon-type-alist", &Vns_icon_type_alist,
2611 doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2612 If the title of a frame matches REGEXP, then IMAGE.tiff is
2613 selected as the image of the icon representing the frame when it's
2614 miniaturized. If an element is t, then Emacs tries to select an icon
2615 based on the filetype of the visited file.
2617 The images have to be installed in a folder called English.lproj in the
2618 Emacs folder. You have to restart Emacs after installing new icons.
2620 Example: Install an icon Gnus.tiff and execute the following code
2622 (setq ns-icon-type-alist
2623 (append ns-icon-type-alist
2624 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2627 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2628 be used as the image of the icon representing the frame. */);
2629 Vns_icon_type_alist = Fcons (Qt, Qnil);
2631 DEFVAR_LISP ("ns-version-string", &Vns_version_string,
2632 doc: /* Toolkit version for NS Windowing. */);
2633 Vns_version_string = ns_appkit_version_str ();
2635 defsubr (&Sns_read_file_name);
2636 defsubr (&Sns_get_resource);
2637 defsubr (&Sns_set_resource);
2638 defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2639 defsubr (&Sx_display_grayscale_p);
2640 defsubr (&Sns_font_name);
2641 defsubr (&Sns_list_colors);
2642 #ifdef NS_IMPL_COCOA
2643 defsubr (&Sns_do_applescript);
2645 defsubr (&Sxw_color_defined_p);
2646 defsubr (&Sxw_color_values);
2647 defsubr (&Sx_server_max_request_size);
2648 defsubr (&Sx_server_vendor);
2649 defsubr (&Sx_server_version);
2650 defsubr (&Sx_display_pixel_width);
2651 defsubr (&Sx_display_pixel_height);
2652 defsubr (&Sns_display_usable_bounds);
2653 defsubr (&Sx_display_mm_width);
2654 defsubr (&Sx_display_mm_height);
2655 defsubr (&Sx_display_screens);
2656 defsubr (&Sx_display_planes);
2657 defsubr (&Sx_display_color_cells);
2658 defsubr (&Sx_display_visual_class);
2659 defsubr (&Sx_display_backing_store);
2660 defsubr (&Sx_display_save_under);
2661 defsubr (&Sx_create_frame);
2662 defsubr (&Sx_open_connection);
2663 defsubr (&Sx_close_connection);
2664 defsubr (&Sx_display_list);
2666 defsubr (&Sns_hide_others);
2667 defsubr (&Sns_hide_emacs);
2668 defsubr (&Sns_emacs_info_panel);
2669 defsubr (&Sns_list_services);
2670 defsubr (&Sns_perform_service);
2671 defsubr (&Sns_convert_utf8_nfd_to_nfc);
2672 defsubr (&Sx_focus_frame);
2673 defsubr (&Sns_popup_font_panel);
2674 defsubr (&Sns_popup_color_panel);
2676 defsubr (&Sx_show_tip);
2677 defsubr (&Sx_hide_tip);
2679 /* used only in fontset.c */
2680 check_window_system_func = check_ns;
2684 // arch-tag: dc2a3f74-1123-4daa-8eed-fb78db6a5642