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;
84 extern Lisp_Object Vframe_title_format;
86 Lisp_Object Qbuffered;
87 Lisp_Object Qfontsize;
89 /* hack for OS X file panels */
92 /* Alist of elements (REGEXP . IMAGE) for images of icons associated
94 static Lisp_Object Vns_icon_type_alist;
96 /* Toolkit version support. */
97 static Lisp_Object Vns_version_string;
99 EmacsTooltip *ns_tooltip;
101 /* Need forward declaration here to preserve organizational integrity of file */
102 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
104 extern BOOL ns_in_resize;
107 /* ==========================================================================
109 Internal utility functions
111 ========================================================================== */
118 error ("OpenStep is not in use or not initialized");
122 /* Nonzero if we can use mouse menus. */
130 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
131 and checking validity for NS. */
133 check_ns_frame (Lisp_Object frame)
138 f = SELECTED_FRAME ();
141 CHECK_LIVE_FRAME (frame);
144 if (! FRAME_NS_P (f))
145 error ("non-Nextstep frame used");
150 /* Let the user specify an Nextstep display with a frame.
151 nil stands for the selected frame--or, if that is not an Nextstep frame,
152 the first Nextstep display on the list. */
153 static struct ns_display_info *
154 check_ns_display_info (Lisp_Object frame)
158 struct frame *f = SELECTED_FRAME ();
159 if (FRAME_NS_P (f) && FRAME_LIVE_P (f) )
160 return FRAME_NS_DISPLAY_INFO (f);
161 else if (x_display_list != 0)
162 return x_display_list;
164 error ("Nextstep windows are not in use or not initialized");
166 else if (INTEGERP (frame))
168 struct terminal *t = get_terminal (frame, 1);
170 if (t->type != output_ns)
171 error ("Terminal %d is not a Nextstep display", XINT (frame));
173 return t->display_info.ns;
175 else if (STRINGP (frame))
176 return ns_display_info_for_name (frame);
181 CHECK_LIVE_FRAME (frame);
183 if (! FRAME_NS_P (f))
184 error ("non-Nextstep frame used");
185 return FRAME_NS_DISPLAY_INFO (f);
187 return NULL; /* shut compiler up */
192 ns_get_window (Lisp_Object maybeFrame)
194 id view =nil, window =nil;
196 if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
197 maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
199 if (!NILP (maybeFrame))
200 view = FRAME_NS_VIEW (XFRAME (maybeFrame));
201 if (view) window =[view window];
208 ns_get_screen (Lisp_Object screen)
211 struct terminal *terminal;
213 if (EQ (Qt, screen)) /* not documented */
214 return [NSScreen mainScreen];
216 terminal = get_terminal (screen, 1);
217 if (terminal->type != output_ns)
221 f = SELECTED_FRAME ();
222 else if (FRAMEP (screen))
226 struct ns_display_info *dpyinfo = terminal->display_info.ns;
227 f = (dpyinfo->x_focus_frame || dpyinfo->x_highlight_frame);
230 return ((f && FRAME_NS_P (f)) ? [[FRAME_NS_VIEW (f) window] screen]
235 /* Return the X display structure for the display named NAME.
236 Open a new connection if necessary. */
237 struct ns_display_info *
238 ns_display_info_for_name (name)
242 struct ns_display_info *dpyinfo;
246 for (dpyinfo = x_display_list, names = ns_display_name_list;
248 dpyinfo = dpyinfo->next, names = XCDR (names))
251 tem = Fstring_equal (XCAR (XCAR (names)), name);
256 error ("Emacs for OpenStep does not yet support multi-display.");
258 Fx_open_connection (name, Qnil, Qnil);
259 dpyinfo = x_display_list;
262 error ("OpenStep on %s not responding.\n", SDATA (name));
269 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
270 /* --------------------------------------------------------------------------
271 Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
272 -------------------------------------------------------------------------- */
282 count = [menu numberOfItems];
283 for (i = 0; i<count; i++)
285 item = [menu itemAtIndex: i];
286 name = [[item title] UTF8String];
289 nameStr = build_string (name);
291 if ([item hasSubmenu])
293 old = interpret_services_menu ([item submenu],
294 Fcons (nameStr, prefix), old);
298 keys = [item keyEquivalent];
299 if (keys && [keys length] )
301 key = [keys characterAtIndex: 0];
302 res = make_number (key|super_modifier);
308 old = Fcons (Fcons (res,
309 Freverse (Fcons (nameStr,
319 /* ==========================================================================
321 Frame parameter setters
323 ========================================================================== */
327 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
331 if (ns_lisp_to_color (arg, &col))
333 store_frame_param (f, Qforeground_color, oldval);
334 error ("Unknown color");
338 [f->output_data.ns->foreground_color release];
339 f->output_data.ns->foreground_color = col;
341 if (FRAME_NS_VIEW (f))
343 update_face_from_frame_parameter (f, Qforeground_color, arg);
344 /*recompute_basic_faces (f); */
345 if (FRAME_VISIBLE_P (f))
352 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
356 NSView *view = FRAME_NS_VIEW (f);
359 if (ns_lisp_to_color (arg, &col))
361 store_frame_param (f, Qbackground_color, oldval);
362 error ("Unknown color");
365 /* clear the frame; in some instances the NS-internal GC appears not to
366 update, or it does update and cannot clear old text properly */
367 if (FRAME_VISIBLE_P (f))
371 [f->output_data.ns->background_color release];
372 f->output_data.ns->background_color = col;
375 [[view window] setBackgroundColor: col];
376 alpha = [col alphaComponent];
379 [[view window] setOpaque: NO];
381 [[view window] setOpaque: YES];
383 face = FRAME_DEFAULT_FACE (f);
386 col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
388 = (EMACS_UINT) [[col colorWithAlphaComponent: alpha] retain];
391 update_face_from_frame_parameter (f, Qbackground_color, arg);
394 if (FRAME_VISIBLE_P (f))
401 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
405 if (ns_lisp_to_color (arg, &col))
407 store_frame_param (f, Qcursor_color, oldval);
408 error ("Unknown color");
411 [FRAME_CURSOR_COLOR (f) release];
412 FRAME_CURSOR_COLOR (f) = [col retain];
414 if (FRAME_VISIBLE_P (f))
416 x_update_cursor (f, 0);
417 x_update_cursor (f, 1);
419 update_face_from_frame_parameter (f, Qcursor_color, arg);
424 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
426 NSView *view = FRAME_NS_VIEW (f);
427 NSTRACE (x_set_icon_name);
432 /* see if it's changed */
435 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
438 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
445 if (!NILP (f->title))
448 /* explicit name and no icon-name -> explicit_name */
449 if (f->explicit_name)
453 /* no explicit name and no icon-name ->
454 name has to be rebuild from icon_title_format */
455 windows_or_buffers_changed++;
460 /* Don't change the name if it's already NAME. */
461 if ([[view window] miniwindowTitle] &&
462 ([[[view window] miniwindowTitle]
463 isEqualToString: [NSString stringWithUTF8String:
467 [[view window] setMiniwindowTitle:
468 [NSString stringWithUTF8String: SDATA (arg)]];
473 ns_set_name_iconic (struct frame *f, Lisp_Object name, int explicit)
475 NSView *view = FRAME_NS_VIEW (f);
476 NSTRACE (ns_set_name_iconic);
481 /* Make sure that requests from lisp code override requests from
482 Emacs redisplay code. */
485 /* If we're switching from explicit to implicit, we had better
486 update the mode lines and thereby update the title. */
487 if (f->explicit_name && NILP (name))
488 update_mode_lines = 1;
490 f->explicit_name = ! NILP (name);
492 else if (f->explicit_name)
495 /* title overrides explicit name */
496 if (! NILP (f->title))
499 /* icon_name overrides title and explicit name */
500 if (! NILP (f->icon_name))
504 name = build_string([ns_app_name UTF8String]);
508 /* Don't change the name if it's already NAME. */
509 if ([[view window] miniwindowTitle] &&
510 ([[[view window] miniwindowTitle]
511 isEqualToString: [NSString stringWithUTF8String:
515 [[view window] setMiniwindowTitle:
516 [NSString stringWithUTF8String: SDATA (name)]];
521 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
524 NSTRACE (ns_set_name);
529 /* Make sure that requests from lisp code override requests from
530 Emacs redisplay code. */
533 /* If we're switching from explicit to implicit, we had better
534 update the mode lines and thereby update the title. */
535 if (f->explicit_name && NILP (name))
536 update_mode_lines = 1;
538 f->explicit_name = ! NILP (name);
540 else if (f->explicit_name)
544 name = build_string([ns_app_name UTF8String]);
548 /* title overrides explicit name */
549 if (! NILP (f->title))
554 view = FRAME_NS_VIEW (f);
556 /* Don't change the name if it's already NAME. */
557 if ([[[view window] title]
558 isEqualToString: [NSString stringWithUTF8String:
561 [[view window] setTitle: [NSString stringWithUTF8String:
566 /* This function should be called when the user's lisp code has
567 specified a name for the frame; the name will override any set by the
570 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
572 NSTRACE (x_explicitly_set_name);
573 ns_set_name_iconic (f, arg, 1);
574 ns_set_name (f, arg, 1);
578 /* This function should be called by Emacs redisplay code to set the
579 name; names set this way will never override names set by the user's
582 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
584 NSTRACE (x_implicitly_set_name);
585 if (FRAME_ICONIFIED_P (f))
586 ns_set_name_iconic (f, arg, 0);
587 else if (FRAME_NS_P (f) && EQ (Vframe_title_format, Qt))
588 ns_set_name_as_filename (f);
590 ns_set_name (f, arg, 0);
594 /* Change the title of frame F to NAME.
595 If NAME is nil, use the frame name as the title.
597 If EXPLICIT is non-zero, that indicates that lisp code is setting the
598 name; if NAME is a string, set F's name to NAME and set
599 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
601 If EXPLICIT is zero, that indicates that Emacs redisplay code is
602 suggesting a new name, which lisp code should override; if
603 F->explicit_name is set, ignore the new name; otherwise, set it. */
605 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
607 NSTRACE (x_set_title);
608 /* Don't change the title if it's already NAME. */
609 if (EQ (name, f->title))
612 update_mode_lines = 1;
619 ns_set_name_as_filename (struct frame *f)
623 Lisp_Object buf = XWINDOW (f->selected_window)->buffer;
625 NSAutoreleasePool *pool;
626 NSTRACE (ns_set_name_as_filename);
628 if (f->explicit_name || ! NILP (f->title) || ns_in_resize)
632 pool = [[NSAutoreleasePool alloc] init];
633 name = XBUFFER (buf)->filename;
634 if (NILP (name) || FRAME_ICONIFIED_P (f)) name =XBUFFER (buf)->name;
636 if (FRAME_ICONIFIED_P (f) && !NILP (f->icon_name))
640 name = build_string ([ns_app_name UTF8String]);
644 view = FRAME_NS_VIEW (f);
646 title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
647 : [[[view window] title] UTF8String];
649 if (title && (! strcmp (title, SDATA (name))))
656 if (! FRAME_ICONIFIED_P (f))
659 /* work around a bug observed on 10.3 where
660 setTitleWithRepresentedFilename does not clear out previous state
661 if given filename does not exist */
662 NSString *str = [NSString stringWithUTF8String: SDATA (name)];
663 if (![[NSFileManager defaultManager] fileExistsAtPath: str])
665 [[view window] setTitleWithRepresentedFilename: @""];
666 [[view window] setTitle: str];
670 [[view window] setTitleWithRepresentedFilename: str];
673 [[view window] setTitleWithRepresentedFilename:
674 [NSString stringWithUTF8String: SDATA (name)]];
680 [[view window] setMiniwindowTitle:
681 [NSString stringWithUTF8String: SDATA (name)]];
689 ns_set_doc_edited (struct frame *f, Lisp_Object arg)
691 NSView *view = FRAME_NS_VIEW (f);
692 NSAutoreleasePool *pool;
693 if (!MINI_WINDOW_P (XWINDOW (f->selected_window)))
696 pool = [[NSAutoreleasePool alloc] init];
697 [[view window] setDocumentEdited: !NILP (arg)];
705 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
708 int olines = FRAME_MENU_BAR_LINES (f);
709 if (FRAME_MINIBUF_ONLY_P (f))
712 if (INTEGERP (value))
713 nlines = XINT (value);
717 FRAME_MENU_BAR_LINES (f) = 0;
720 FRAME_EXTERNAL_MENU_BAR (f) = 1;
721 /* does for all frames, whereas we just want for one frame
722 [NSMenu setMenuBarVisible: YES]; */
726 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
727 free_frame_menubar (f);
728 /* [NSMenu setMenuBarVisible: NO]; */
729 FRAME_EXTERNAL_MENU_BAR (f) = 0;
734 /* toolbar support */
736 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
739 Lisp_Object root_window;
741 if (FRAME_MINIBUF_ONLY_P (f))
744 if (INTEGERP (value) && XINT (value) >= 0)
745 nlines = XFASTINT (value);
751 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
752 update_frame_tool_bar (f);
756 if (FRAME_EXTERNAL_TOOL_BAR (f))
758 free_frame_tool_bar (f);
759 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
763 x_set_window_size (f, 0, f->text_cols, f->text_lines);
768 ns_implicitly_set_icon_type (struct frame *f)
771 EmacsView *view = FRAME_NS_VIEW (f);
773 Lisp_Object chain, elt;
774 NSAutoreleasePool *pool;
777 NSTRACE (ns_implicitly_set_icon_type);
780 pool = [[NSAutoreleasePool alloc] init];
781 if (f->output_data.ns->miniimage
782 && [[NSString stringWithUTF8String: SDATA (f->name)]
783 isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
790 tem = assq_no_quit (Qicon_type, f->param_alist);
791 if (CONSP (tem) && ! NILP (XCDR (tem)))
798 for (chain = Vns_icon_type_alist;
799 (image = nil) && CONSP (chain);
800 chain = XCDR (chain))
803 /* special case: 't' means go by file type */
804 if (SYMBOLP (elt) && EQ (elt, Qt) && SDATA (f->name)[0] == '/')
807 = [NSString stringWithUTF8String: SDATA (f->name)];
808 if ([[NSFileManager defaultManager] fileExistsAtPath: str])
809 image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
811 else if (CONSP (elt) &&
812 STRINGP (XCAR (elt)) &&
813 STRINGP (XCDR (elt)) &&
814 fast_string_match (XCAR (elt), f->name) >= 0)
816 image = [EmacsImage allocInitFromFile: XCDR (elt)];
818 image = [[NSImage imageNamed:
819 [NSString stringWithUTF8String:
820 SDATA (XCDR (elt))]] retain];
826 image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
830 [f->output_data.ns->miniimage release];
831 f->output_data.ns->miniimage = image;
832 [view setMiniwindowImage: setMini];
839 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
841 EmacsView *view = FRAME_NS_VIEW (f);
845 NSTRACE (x_set_icon_type);
847 if (!NILP (arg) && SYMBOLP (arg))
849 arg =build_string (SDATA (SYMBOL_NAME (arg)));
850 store_frame_param (f, Qicon_type, arg);
853 /* do it the implicit way */
856 ns_implicitly_set_icon_type (f);
862 image = [EmacsImage allocInitFromFile: arg];
864 image =[NSImage imageNamed: [NSString stringWithUTF8String:
869 image = [NSImage imageNamed: @"text"];
873 f->output_data.ns->miniimage = image;
874 [view setMiniwindowImage: setMini];
878 /* Xism; we stub out (we do implement this in ns-win.el) */
880 XParseGeometry (char *string, int *x, int *y,
881 unsigned int *width, unsigned int *height)
883 message1 ("Warning: XParseGeometry not supported under NS.\n");
888 /* TODO: move to nsterm? */
890 ns_lisp_to_cursor_type (Lisp_Object arg)
893 if (XTYPE (arg) == Lisp_String)
895 else if (XTYPE (arg) == Lisp_Symbol)
896 str = SDATA (SYMBOL_NAME (arg));
898 if (!strcmp (str, "box")) return FILLED_BOX_CURSOR;
899 if (!strcmp (str, "hollow")) return HOLLOW_BOX_CURSOR;
900 if (!strcmp (str, "hbar")) return HBAR_CURSOR;
901 if (!strcmp (str, "bar")) return BAR_CURSOR;
902 if (!strcmp (str, "no")) return NO_CURSOR;
908 ns_cursor_type_to_lisp (int arg)
912 case FILLED_BOX_CURSOR: return Qbox;
913 case HOLLOW_BOX_CURSOR: return intern ("hollow");
914 case HBAR_CURSOR: return intern ("hbar");
915 case BAR_CURSOR: return intern ("bar");
917 default: return intern ("no");
921 /* This is the same as the xfns.c definition. */
923 x_set_cursor_type (f, arg, oldval)
925 Lisp_Object arg, oldval;
927 set_frame_cursor_types (f, arg);
929 /* Make sure the cursor gets redrawn. */
930 cursor_type_changed = 1;
934 /* called to set mouse pointer color, but all other terms use it to
935 initialize pointer types (and don't set the color ;) */
937 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
939 /* don't think we can do this on Nextstep */
944 #define Xstr(x) Str(x)
947 ns_appkit_version_str ()
951 #ifdef NS_IMPL_GNUSTEP
952 sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
953 #elif defined(NS_IMPL_COCOA)
954 sprintf(tmp, "apple-appkit-%.2f", NSAppKitVersionNumber);
958 return build_string (tmp);
962 /* This is for use by x-server-version and collapses all version info we
963 have into a single int. For a better picture of the implementation
964 running, use ns_appkit_version_str.*/
966 ns_appkit_version_int ()
968 #ifdef NS_IMPL_GNUSTEP
969 return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GUI_MINOR_VERSION;
970 #elif defined(NS_IMPL_COCOA)
971 return (int)NSAppKitVersionNumber;
978 x_icon (struct frame *f, Lisp_Object parms)
979 /* --------------------------------------------------------------------------
980 Strangely-named function to set icon position parameters in frame.
981 This is irrelevant under OS X, but might be needed under GNUstep,
982 depending on the window manager used. Note, this is not a standard
983 frame parameter-setter; it is called directly from x-create-frame.
984 -------------------------------------------------------------------------- */
986 Lisp_Object icon_x, icon_y;
987 struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
989 f->output_data.ns->icon_top = Qnil;
990 f->output_data.ns->icon_left = Qnil;
992 /* Set the position of the icon. */
993 icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
994 icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
995 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
997 CHECK_NUMBER (icon_x);
998 CHECK_NUMBER (icon_y);
999 f->output_data.ns->icon_top = icon_y;
1000 f->output_data.ns->icon_left = icon_x;
1002 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
1003 error ("Both left and top icon corners of icon must be specified");
1007 /* Note: see frame.c for template, also where generic functions are impl */
1008 frame_parm_handler ns_frame_parm_handlers[] =
1010 x_set_autoraise, /* generic OK */
1011 x_set_autolower, /* generic OK */
1012 x_set_background_color,
1013 0, /* x_set_border_color, may be impossible under Nextstep */
1014 0, /* x_set_border_width, may be impossible under Nextstep */
1017 x_set_font, /* generic OK */
1018 x_set_foreground_color,
1021 x_set_internal_border_width, /* generic OK */
1022 x_set_menu_bar_lines,
1024 x_explicitly_set_name,
1025 x_set_scroll_bar_width, /* generic OK */
1027 x_set_unsplittable, /* generic OK */
1028 x_set_vertical_scroll_bars, /* generic OK */
1029 x_set_visibility, /* generic OK */
1030 x_set_tool_bar_lines,
1031 0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
1032 0, /* x_set_scroll_bar_background, will ignore (not possible on NS) */
1033 x_set_screen_gamma, /* generic OK */
1034 x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
1035 x_set_fringe_width, /* generic OK */
1036 x_set_fringe_width, /* generic OK */
1037 0, /* x_set_wait_for_wm, will ignore */
1038 0, /* x_set_fullscreen will ignore */
1039 x_set_font_backend, /* generic OK */
1041 0, /* x_set_sticky */
1046 /* ==========================================================================
1050 ========================================================================== */
1052 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1054 doc: /* Make a new Nextstep window, called a \"frame\" in Emacs terms.
1055 Return an Emacs frame object.
1056 PARMS is an alist of frame parameters.
1057 If the parameters specify that the frame should not have a minibuffer,
1058 and do not specify a specific minibuffer window to use,
1059 then `default-minibuffer-frame' must be a frame whose minibuffer can
1060 be shared by the new frame. */)
1064 static int desc_ctr = 1;
1066 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1067 Lisp_Object frame, tem;
1069 int minibuffer_only = 0;
1070 int count = specpdl_ptr - specpdl;
1071 Lisp_Object display;
1072 struct ns_display_info *dpyinfo = NULL;
1075 Lisp_Object tfont, tfontsize;
1076 int window_prompting = 0;
1081 /* Seems a little strange, but other terms do it. Perhaps the code below
1082 is modifying something? */
1083 parms = Fcopy_alist (parms);
1085 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1086 if (EQ (display, Qunbound))
1088 dpyinfo = check_ns_display_info (display);
1090 if (!dpyinfo->terminal->name)
1091 error ("Terminal is not live, can't create new frames on it");
1093 kb = dpyinfo->terminal->kboard;
1095 name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1097 && ! EQ (name, Qunbound)
1099 error ("Invalid frame name--not a string or nil");
1102 Vx_resource_name = name;
1104 Vx_resource_name = Vinvocation_name;
1106 parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1107 if (EQ (parent, Qunbound))
1109 if (! NILP (parent))
1110 CHECK_NUMBER (parent);
1113 GCPRO4 (parms, parent, name, frame);
1115 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1117 if (EQ (tem, Qnone) || NILP (tem))
1119 f = make_frame_without_minibuffer (Qnil, kb, display);
1121 else if (EQ (tem, Qonly))
1123 f = make_minibuffer_frame ();
1124 minibuffer_only = 1;
1126 else if (WINDOWP (tem))
1128 f = make_frame_without_minibuffer (tem, kb, display);
1135 /* Set the name; the functions to which we pass f expect the name to
1137 if (EQ (name, Qunbound) || NILP (name) || (XTYPE (name) != Lisp_String))
1139 f->name = build_string ([ns_app_name UTF8String]);
1140 f->explicit_name =0;
1145 f->explicit_name = 1;
1146 specbind (Qx_resource_name, name);
1149 XSETFRAME (frame, f);
1150 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
1152 f->terminal = dpyinfo->terminal;
1153 f->terminal->reference_count++;
1155 f->output_method = output_ns;
1156 f->output_data.ns = (struct ns_output *)xmalloc (sizeof *(f->output_data.ns));
1157 bzero (f->output_data.ns, sizeof (*(f->output_data.ns)));
1159 FRAME_FONTSET (f) = -1;
1161 /* record_unwind_protect (unwind_create_frame, frame); safety; maybe later? */
1163 f->icon_name = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
1165 if (! STRINGP (f->icon_name))
1166 f->icon_name = Qnil;
1168 FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1170 f->output_data.ns->window_desc = desc_ctr++;
1173 f->output_data.ns->parent_desc = (Window) XFASTINT (parent);
1174 f->output_data.ns->explicit_parent = 1;
1178 f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1179 f->output_data.ns->explicit_parent = 0;
1182 f->resx = dpyinfo->resx;
1183 f->resy = dpyinfo->resy;
1186 register_font_driver (&nsfont_driver, f);
1187 x_default_parameter (f, parms, Qfont_backend, Qnil,
1188 "fontBackend", "FontBackend", RES_TYPE_STRING);
1191 /* use for default font name */
1192 id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1193 tfontsize = x_default_parameter (f, parms, Qfontsize,
1194 make_number (0 /*(int)[font pointSize]*/),
1195 "fontSize", "FontSize", RES_TYPE_NUMBER);
1196 tfont = x_default_parameter (f, parms, Qfont,
1197 build_string ([[font fontName] UTF8String]),
1198 "font", "Font", RES_TYPE_STRING);
1202 x_default_parameter (f, parms, Qborder_width, make_number (0),
1203 "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1204 x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1205 "internalBorderWidth", "InternalBorderWidth",
1208 /* default scrollbars on right on Mac */
1211 #ifdef NS_IMPL_GNUSTEP
1216 x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1217 "verticalScrollBars", "VerticalScrollBars",
1220 x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1221 "foreground", "Foreground", RES_TYPE_STRING);
1222 x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1223 "background", "Background", RES_TYPE_STRING);
1224 x_default_parameter (f, parms, Qcursor_color, build_string ("grey"),
1225 "cursorColor", "CursorColor", RES_TYPE_STRING);
1226 /* FIXME: not suppported yet in Nextstep */
1227 x_default_parameter (f, parms, Qline_spacing, Qnil,
1228 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1229 x_default_parameter (f, parms, Qleft_fringe, Qnil,
1230 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1231 x_default_parameter (f, parms, Qright_fringe, Qnil,
1232 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1235 init_frame_faces (f);
1237 x_default_parameter (f, parms, Qmenu_bar_lines, make_number (0), "menuBar",
1238 "menuBar", RES_TYPE_NUMBER);
1239 x_default_parameter (f, parms, Qtool_bar_lines, make_number (0), "toolBar",
1240 "toolBar", RES_TYPE_NUMBER);
1241 x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1242 "BufferPredicate", RES_TYPE_SYMBOL);
1243 x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1246 /* TODO: other terms seem to get away w/o this complexity.. */
1247 if (NILP (Fassq (Qwidth, parms)))
1250 = x_get_arg (dpyinfo, parms, Qwidth, "width", "Width",
1252 if (! EQ (value, Qunbound))
1253 parms = Fcons (Fcons (Qwidth, value), parms);
1255 if (NILP (Fassq (Qheight, parms)))
1258 = x_get_arg (dpyinfo, parms, Qheight, "height", "Height",
1260 if (! EQ (value, Qunbound))
1261 parms = Fcons (Fcons (Qheight, value), parms);
1263 if (NILP (Fassq (Qleft, parms)))
1266 = x_get_arg (dpyinfo, parms, Qleft, "left", "Left", RES_TYPE_NUMBER);
1267 if (! EQ (value, Qunbound))
1268 parms = Fcons (Fcons (Qleft, value), parms);
1270 if (NILP (Fassq (Qtop, parms)))
1273 = x_get_arg (dpyinfo, parms, Qtop, "top", "Top", RES_TYPE_NUMBER);
1274 if (! EQ (value, Qunbound))
1275 parms = Fcons (Fcons (Qtop, value), parms);
1278 window_prompting = x_figure_window_size (f, parms, 1);
1280 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1281 f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1283 /* NOTE: on other terms, this is done in set_mouse_color, however this
1284 was not getting called under Nextstep */
1285 f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1286 f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1287 f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1288 f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1289 f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1290 f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1291 FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1292 = [NSCursor arrowCursor];
1293 f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1295 [[EmacsView alloc] initFrameFromEmacs: f];
1299 /* It is now ok to make the frame official even if we get an error below.
1300 The frame needs to be on Vframe_list or making it visible won't work. */
1301 Vframe_list = Fcons (frame, Vframe_list);
1302 /*FRAME_NS_DISPLAY_INFO (f)->reference_count++; */
1304 x_default_parameter (f, parms, Qicon_type, Qnil, "bitmapIcon", "BitmapIcon",
1306 x_default_parameter (f, parms, Qauto_raise, Qnil, "autoRaise", "AutoRaiseLower",
1308 x_default_parameter (f, parms, Qauto_lower, Qnil, "autoLower", "AutoLower",
1310 x_default_parameter (f, parms, Qcursor_type, Qbox, "cursorType", "CursorType",
1312 x_default_parameter (f, parms, Qscroll_bar_width, Qnil, "scrollBarWidth",
1313 "ScrollBarWidth", RES_TYPE_NUMBER);
1314 x_default_parameter (f, parms, Qalpha, Qnil, "alpha", "Alpha",
1317 width = FRAME_COLS (f);
1318 height = FRAME_LINES (f);
1320 SET_FRAME_COLS (f, 0);
1321 FRAME_LINES (f) = 0;
1322 change_frame_size (f, height, width, 1, 0, 0);
1324 if (! f->output_data.ns->explicit_parent)
1326 tem = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL);
1327 if (EQ (tem, Qunbound))
1329 x_set_visibility (f, tem, Qnil);
1330 if (EQ (tem, Qicon))
1331 x_iconify_frame (f);
1332 else if (! NILP (tem))
1334 x_make_frame_visible (f);
1335 f->async_visible = 1;
1336 [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1339 f->async_visible = 0;
1342 if (FRAME_HAS_MINIBUF_P (f)
1343 && (!FRAMEP (kb->Vdefault_minibuffer_frame)
1344 || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
1345 kb->Vdefault_minibuffer_frame = frame;
1347 /* All remaining specified parameters, which have not been "used"
1348 by x_get_arg and friends, now go in the misc. alist of the frame. */
1349 for (tem = parms; CONSP (tem); tem = XCDR (tem))
1350 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1351 f->param_alist = Fcons (XCAR (tem), f->param_alist);
1354 Vwindow_list = Qnil;
1356 return unbind_to (count, frame);
1360 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1361 doc: /* Set the input focus to FRAME.
1362 FRAME nil means use the selected frame. */)
1366 struct frame *f = check_ns_frame (frame);
1367 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1369 if (dpyinfo->x_focus_frame != f)
1371 EmacsView *view = FRAME_NS_VIEW (f);
1373 [NSApp activateIgnoringOtherApps: YES];
1374 [[view window] makeKeyAndOrderFront: view];
1382 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1384 doc: /* Pop up the font panel. */)
1392 fm = [NSFontManager sharedFontManager];
1394 f = SELECTED_FRAME ();
1397 CHECK_FRAME (frame);
1401 [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1403 [fm orderFrontFontPanel: NSApp];
1408 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1410 doc: /* Pop up the color panel. */)
1418 f = SELECTED_FRAME ();
1421 CHECK_FRAME (frame);
1425 [NSApp orderFrontColorPanel: NSApp];
1430 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 4, 0,
1431 doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1432 Optional arg DIR, if non-nil, supplies a default directory.
1433 Optional arg ISLOAD, if non-nil, means read a file name for saving.
1434 Optional arg INIT, if non-nil, provides a default file name to use. */)
1435 (prompt, dir, isLoad, init)
1436 Lisp_Object prompt, dir, isLoad, init;
1438 static id fileDelegate = nil;
1443 NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1444 [NSString stringWithUTF8String: SDATA (prompt)];
1445 NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1446 [NSString stringWithUTF8String: SDATA (current_buffer->directory)] :
1447 [NSString stringWithUTF8String: SDATA (dir)];
1448 NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1449 [NSString stringWithUTF8String: SDATA (init)];
1453 if (fileDelegate == nil)
1454 fileDelegate = [EmacsFileDelegate new];
1456 [NSCursor setHiddenUntilMouseMoves: NO];
1458 if ([dirS characterAtIndex: 0] == '~')
1459 dirS = [dirS stringByExpandingTildeInPath];
1461 panel = NILP (isLoad) ?
1462 (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1464 [panel setTitle: promptS];
1466 /* Puma (10.1) does not have */
1467 if ([panel respondsToSelector: @selector (setAllowsOtherFileTypes:)])
1468 [panel setAllowsOtherFileTypes: YES];
1470 [panel setTreatsFilePackagesAsDirectories: YES];
1471 [panel setDelegate: fileDelegate];
1477 ret = [panel runModalForDirectory: dirS file: initS];
1481 [panel setCanChooseDirectories: YES];
1482 ret = [panel runModalForDirectory: dirS file: initS types: nil];
1485 ret = (ret == NSOKButton) || panelOK;
1488 fname = build_string ([[panel filename] UTF8String]);
1490 [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1493 return ret ? fname : Qnil;
1497 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1498 doc: /* Return the value of the property NAME of OWNER from the defaults database.
1499 If OWNER is nil, Emacs is assumed. */)
1501 Lisp_Object owner, name;
1507 owner = build_string([ns_app_name UTF8String]);
1508 CHECK_STRING (name);
1509 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SDATA (name)); */
1511 value =[[[NSUserDefaults standardUserDefaults]
1512 objectForKey: [NSString stringWithUTF8String: SDATA (name)]]
1516 return build_string (value);
1521 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1522 doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1523 If OWNER is nil, Emacs is assumed.
1524 If VALUE is nil, the default is removed. */)
1525 (owner, name, value)
1526 Lisp_Object owner, name, value;
1530 owner = build_string ([ns_app_name UTF8String]);
1531 CHECK_STRING (name);
1534 [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1535 [NSString stringWithUTF8String: SDATA (name)]];
1539 CHECK_STRING (value);
1540 [[NSUserDefaults standardUserDefaults] setObject:
1541 [NSString stringWithUTF8String: SDATA (value)]
1542 forKey: [NSString stringWithUTF8String:
1550 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1551 Sx_server_max_request_size,
1553 doc: /* This function is a no-op. It is only present for completeness. */)
1555 Lisp_Object display;
1558 /* This function has no real equivalent under NeXTstep. Return nil to
1564 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1565 doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1566 DISPLAY should be either a frame or a display name (a string).
1567 If omitted or nil, the selected frame's display is used. */)
1569 Lisp_Object display;
1571 #ifdef NS_IMPL_GNUSTEP
1572 return build_string ("GNU");
1574 return build_string ("Apple");
1579 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1580 doc: /* Return the version numbers of the server of DISPLAY.
1581 The value is a list of three integers: the major and minor
1582 version numbers of the X Protocol in use, and the distributor-specific
1583 release number. See also the function `x-server-vendor'.
1585 The optional argument DISPLAY specifies which display to ask about.
1586 DISPLAY should be either a frame or a display name (a string).
1587 If omitted or nil, that stands for the selected frame's display. */)
1589 Lisp_Object display;
1591 /*NOTE: it is unclear what would best correspond with "protocol";
1592 we return 10.3, meaning Panther, since this is roughly the
1593 level that GNUstep's APIs correspond to.
1594 The last number is where we distinguish between the Apple
1595 and GNUstep implementations ("distributor-specific release
1596 number") and give int'ized versions of major.minor. */
1597 return Fcons (make_number (10),
1598 Fcons (make_number (3),
1599 Fcons (make_number (ns_appkit_version_int()), Qnil)));
1603 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1604 doc: /* Return the number of screens on Nextstep display server DISPLAY.
1605 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1606 If omitted or nil, the selected frame's display is used. */)
1608 Lisp_Object display;
1613 num = [[NSScreen screens] count];
1615 return (num != 0) ? make_number (num) : Qnil;
1619 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1621 doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1622 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1623 If omitted or nil, the selected frame's display is used. */)
1625 Lisp_Object display;
1628 return make_number ((int)
1629 ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1633 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1635 doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1636 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1637 If omitted or nil, the selected frame's display is used. */)
1639 Lisp_Object display;
1642 return make_number ((int)
1643 ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1647 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1648 Sx_display_backing_store, 0, 1, 0,
1649 doc: /* Return whether the Nexstep display DISPLAY supports backing store.
1650 The value may be `buffered', `retained', or `non-retained'.
1651 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1652 If omitted or nil, the selected frame's display is used. */)
1654 Lisp_Object display;
1657 switch ([ns_get_window (display) backingType])
1659 case NSBackingStoreBuffered:
1660 return intern ("buffered");
1661 case NSBackingStoreRetained:
1662 return intern ("retained");
1663 case NSBackingStoreNonretained:
1664 return intern ("non-retained");
1666 error ("Strange value for backingType parameter of frame");
1668 return Qnil; /* not reached, shut compiler up */
1672 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1673 Sx_display_visual_class, 0, 1, 0,
1674 doc: /* Return the visual class of the Nextstep display server DISPLAY.
1675 The value is one of the symbols `static-gray', `gray-scale',
1676 `static-color', `pseudo-color', `true-color', or `direct-color'.
1677 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1678 If omitted or nil, the selected frame's display is used. */)
1680 Lisp_Object display;
1682 NSWindowDepth depth;
1684 depth = [ns_get_screen (display) depth];
1686 if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1687 return intern ("static-gray");
1688 else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1689 return intern ("gray-scale");
1690 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1691 return intern ("pseudo-color");
1692 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1693 return intern ("true-color");
1694 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1695 return intern ("direct-color");
1697 /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1698 return intern ("direct-color");
1702 DEFUN ("x-display-save-under", Fx_display_save_under,
1703 Sx_display_save_under, 0, 1, 0,
1704 doc: /* Non-nil if the Nextstep display server supports the save-under feature.
1705 The optional argument DISPLAY specifies which display to ask about.
1706 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1707 If omitted or nil, the selected frame's display is used. */)
1709 Lisp_Object display;
1712 switch ([ns_get_window (display) backingType])
1714 case NSBackingStoreBuffered:
1717 case NSBackingStoreRetained:
1718 case NSBackingStoreNonretained:
1722 error ("Strange value for backingType parameter of frame");
1724 return Qnil; /* not reached, shut compiler up */
1728 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1730 doc: /* Open a connection to a Nextstep display server.
1731 DISPLAY is the name of the display to connect to.
1732 Optional arguments XRM-STRING and MUST-SUCCEED are currently ignored. */)
1733 (display, resource_string, must_succeed)
1734 Lisp_Object display, resource_string, must_succeed;
1736 struct ns_display_info *dpyinfo;
1738 CHECK_STRING (display);
1740 nxatoms_of_nsselect ();
1741 dpyinfo = ns_term_init (display);
1744 if (!NILP (must_succeed))
1745 fatal ("OpenStep on %s not responding.\n",
1748 error ("OpenStep on %s not responding.\n",
1752 /* Register our external input/output types, used for determining
1753 applicable services and also drag/drop eligibility. */
1754 ns_send_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1755 ns_return_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1756 ns_drag_types = [[NSArray arrayWithObjects:
1758 NSTabularTextPboardType,
1759 NSFilenamesPboardType,
1762 NSFontPboardType, nil] retain];
1768 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1770 doc: /* Close the connection to the current Nextstep display server.
1771 The argument DISPLAY is currently ignored. */)
1773 Lisp_Object display;
1776 /*ns_delete_terminal (dpyinfo->terminal); */
1777 [NSApp terminate: NSApp];
1782 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1783 doc: /* Return the list of display names that Emacs has connections to. */)
1786 Lisp_Object tail, result;
1789 for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1790 result = Fcons (XCAR (XCAR (tail)), result);
1796 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1798 doc: /* Hides all applications other than Emacs. */)
1802 [NSApp hideOtherApplications: NSApp];
1806 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1808 doc: /* If ON is non-nil, the entire Emacs application is hidden.
1809 Otherwise if Emacs is hidden, it is unhidden.
1810 If ON is equal to `activate', Emacs is unhidden and becomes
1811 the active application. */)
1816 if (EQ (on, intern ("activate")))
1818 [NSApp unhide: NSApp];
1819 [NSApp activateIgnoringOtherApps: YES];
1822 [NSApp unhide: NSApp];
1824 [NSApp hide: NSApp];
1829 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1831 doc: /* Shows the 'Info' or 'About' panel for Emacs. */)
1835 [NSApp orderFrontStandardAboutPanel: nil];
1840 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1841 doc: /* Determine font postscript or family name for font NAME.
1842 NAME should be a string containing either the font name or an XLFD
1843 font descriptor. If string contains `fontset' and not
1844 `fontset-startup', it is left alone. */)
1849 CHECK_STRING (name);
1854 if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1857 return build_string (ns_xlfd_to_fontname (SDATA (name)));
1861 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1862 doc: /* Return a list of all available colors.
1863 The optional argument FRAME is currently ignored. */)
1867 Lisp_Object list = Qnil;
1868 NSEnumerator *colorlists;
1873 CHECK_FRAME (frame);
1874 if (! FRAME_NS_P (XFRAME (frame)))
1875 error ("non-Nextstep frame used in `ns-list-colors'");
1880 colorlists = [[NSColorList availableColorLists] objectEnumerator];
1881 while (clist = [colorlists nextObject])
1883 if ([[clist name] length] < 7 ||
1884 [[clist name] rangeOfString: @"PANTONE"].location == 0)
1886 NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1888 while (cname = [cnames nextObject])
1889 list = Fcons (build_string ([cname UTF8String]), list);
1890 /* for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1891 list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1892 UTF8String]), list); */
1902 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1903 doc: /* List available Nextstep services by querying NSApp. */)
1906 Lisp_Object ret = Qnil;
1911 svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1912 [NSApp setServicesMenu: svcs]; /* this and next rebuild on <10.4 */
1913 [NSApp registerServicesMenuSendTypes: ns_send_types
1914 returnTypes: ns_return_types];
1916 /* On Tiger, services menu updating was made lazier (waits for user to
1917 actually click on the menu), so we have to force things along: */
1918 #ifdef NS_IMPL_COCOA
1919 if (NSAppKitVersionNumber >= 744.0)
1921 delegate = [svcs delegate];
1922 if (delegate != nil)
1924 if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1925 [delegate menuNeedsUpdate: svcs];
1926 if ([delegate respondsToSelector:
1927 @selector (menu:updateItem:atIndex:shouldCancel:)])
1929 int i, len = [delegate numberOfItemsInMenu: svcs];
1930 for (i =0; i<len; i++)
1931 [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1932 for (i =0; i<len; i++)
1933 if (![delegate menu: svcs
1934 updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1935 atIndex: i shouldCancel: NO])
1942 [svcs setAutoenablesItems: NO];
1943 #ifdef NS_IMPL_COCOA
1944 [svcs update]; /* on OS X, converts from '/' structure */
1947 ret = interpret_services_menu (svcs, Qnil, ret);
1952 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
1954 doc: /* Perform Nextstep SERVICE on SEND.
1955 SEND should be either a string or nil.
1956 The return value is the result of the service, as string, or nil if
1957 there was no result. */)
1959 Lisp_Object service, send;
1966 CHECK_STRING (service);
1969 utfStr = SDATA (service);
1970 svcName = [NSString stringWithUTF8String: utfStr];
1972 pb =[NSPasteboard pasteboardWithUniqueName];
1973 ns_string_to_pasteboard (pb, send);
1975 if (NSPerformService (svcName, pb) == NO)
1976 Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
1978 if ([[pb types] count] == 0)
1979 return build_string ("");
1980 return ns_string_from_pasteboard (pb);
1984 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
1985 Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
1986 doc: /* Return an NFC string that matches the UTF-8 NFD string STR. */)
1990 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
1995 utfStr = [NSString stringWithUTF8String: SDATA (str)];
1996 if (![utfStr respondsToSelector:
1997 @selector (precomposedStringWithCanonicalMapping)])
2000 ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
2004 utfStr = [utfStr precomposedStringWithCanonicalMapping];
2005 return build_string ([utfStr UTF8String]);
2009 #ifdef NS_IMPL_COCOA
2011 /* Compile and execute the AppleScript SCRIPT and return the error
2012 status as function value. A zero is returned if compilation and
2013 execution is successful, in which case *RESULT is set to a Lisp
2014 string or a number containing the resulting script value. Otherwise,
2017 ns_do_applescript (script, result)
2018 Lisp_Object script, *result;
2020 NSAppleEventDescriptor *desc;
2021 NSDictionary* errorDict;
2022 NSAppleEventDescriptor* returnDescriptor = NULL;
2024 NSAppleScript* scriptObject =
2025 [[NSAppleScript alloc] initWithSource:
2026 [NSString stringWithUTF8String: SDATA (script)]];
2028 returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2029 [scriptObject release];
2033 if (returnDescriptor != NULL)
2035 // successful execution
2036 if (kAENullEvent != [returnDescriptor descriptorType])
2039 // script returned an AppleScript result
2040 if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2041 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
2042 (typeUTF16ExternalRepresentation
2043 == [returnDescriptor descriptorType]) ||
2045 (typeUTF8Text == [returnDescriptor descriptorType]) ||
2046 (typeCString == [returnDescriptor descriptorType]))
2048 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2050 *result = build_string([[desc stringValue] UTF8String]);
2054 /* use typeUTF16ExternalRepresentation? */
2055 // coerce the result to the appropriate ObjC type
2056 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2058 *result = make_number([desc int32Value]);
2064 // no script result, return error
2070 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2071 doc: /* Execute AppleScript SCRIPT and return the result.
2072 If compilation and execution are successful, the resulting script value
2073 is returned as a string, a number or, in the case of other constructs, t.
2074 In case the execution fails, an error is signaled. */)
2081 CHECK_STRING (script);
2085 status = ns_do_applescript (script, &result);
2089 else if (!STRINGP (result))
2090 error ("AppleScript error %d", status);
2092 error ("%s", SDATA (result));
2098 /* ==========================================================================
2100 Miscellaneous functions not called through hooks
2102 ========================================================================== */
2105 /* called from image.c */
2107 check_x_frame (Lisp_Object frame)
2109 return check_ns_frame (frame);
2113 /* called from frame.c */
2114 struct ns_display_info *
2115 check_x_display_info (Lisp_Object frame)
2117 return check_ns_display_info (frame);
2122 x_set_scroll_bar_default_width (f)
2125 int wid = FRAME_COLUMN_WIDTH (f);
2126 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2127 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2132 /* terms impl this instead of x-get-resource directly */
2134 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2136 /* remove appname prefix; TODO: allow for !="Emacs" */
2137 char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2141 if (inhibit_x_resources)
2142 /* --quick was passed, so this is a no-op. */
2145 res = [[[NSUserDefaults standardUserDefaults] objectForKey:
2146 [NSString stringWithUTF8String: toCheck]] UTF8String];
2147 return !res ? NULL :
2148 (!strncasecmp (res, "YES", 3) ? "true" :
2149 (!strncasecmp (res, "NO", 2) ? "false" : res));
2154 x_get_focus_frame (struct frame *frame)
2156 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2157 Lisp_Object nsfocus;
2159 if (!dpyinfo->x_focus_frame)
2162 XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2168 x_pixel_width (struct frame *f)
2170 return FRAME_PIXEL_WIDTH (f);
2175 x_pixel_height (struct frame *f)
2177 return FRAME_PIXEL_HEIGHT (f);
2182 x_char_width (struct frame *f)
2184 return FRAME_COLUMN_WIDTH (f);
2189 x_char_height (struct frame *f)
2191 return FRAME_LINE_HEIGHT (f);
2196 x_screen_planes (struct frame *f)
2198 return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2203 x_sync (Lisp_Object frame)
2205 /* XXX Not implemented XXX */
2211 /* ==========================================================================
2213 Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2215 ========================================================================== */
2218 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2219 doc: /* Return t if the current Nextstep display supports the color COLOR.
2220 The optional argument FRAME is currently ignored. */)
2222 Lisp_Object color, frame;
2226 return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2230 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2231 doc: /* Internal function called by `color-values', which see. */)
2233 Lisp_Object color, frame;
2236 CGFloat red, green, blue, alpha;
2239 CHECK_STRING (color);
2241 if (ns_lisp_to_color (color, &col))
2244 [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2245 getRed: &red green: &green blue: &blue alpha: &alpha];
2246 return list3 (make_number (lrint (red*65280)),
2247 make_number (lrint (green*65280)),
2248 make_number (lrint (blue*65280)));
2252 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2253 doc: /* Return t if the Nextstep display supports color.
2254 The optional argument DISPLAY specifies which display to ask about.
2255 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2256 If omitted or nil, that stands for the selected frame's display. */)
2258 Lisp_Object display;
2260 NSWindowDepth depth;
2261 NSString *colorSpace;
2263 depth = [ns_get_screen (display) depth];
2264 colorSpace = NSColorSpaceFromDepth (depth);
2266 return [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2267 || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2272 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2273 Sx_display_grayscale_p, 0, 1, 0,
2274 doc: /* Return t if the Nextstep display supports shades of gray.
2275 Note that color displays do support shades of gray.
2276 The optional argument DISPLAY specifies which display to ask about.
2277 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2278 If omitted or nil, that stands for the selected frame's display. */)
2280 Lisp_Object display;
2282 NSWindowDepth depth;
2284 depth = [ns_get_screen (display) depth];
2286 return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2290 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2292 doc: /* Return the width in pixels of the Nextstep display DISPLAY.
2293 The optional argument DISPLAY specifies which display to ask about.
2294 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2295 If omitted or nil, that stands for the selected frame's display. */)
2297 Lisp_Object display;
2300 return make_number ((int) [ns_get_screen (display) frame].size.width);
2304 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2305 Sx_display_pixel_height, 0, 1, 0,
2306 doc: /* Return the height in pixels of the Nextstep display DISPLAY.
2307 The optional argument DISPLAY specifies which display to ask about.
2308 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2309 If omitted or nil, that stands for the selected frame's display. */)
2311 Lisp_Object display;
2314 return make_number ((int) [ns_get_screen (display) frame].size.height);
2318 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2319 Sns_display_usable_bounds, 0, 1, 0,
2320 doc: /* Return the bounds of the usable part of the screen.
2321 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2322 are the boundaries of the usable part of the screen, excluding areas
2323 reserved for the Mac menu, dock, and so forth.
2325 The screen queried corresponds to DISPLAY, which should be either a
2326 frame, a display name (a string), or terminal ID. If omitted or nil,
2327 that stands for the selected frame's display. */)
2329 Lisp_Object display;
2336 screen = ns_get_screen (display);
2340 vScreen = [screen visibleFrame];
2342 /* NS coordinate system is upside-down.
2343 Transform to screen-specific coordinates. */
2344 return list4 (make_number ((int) vScreen.origin.x),
2345 make_number ((int) [screen frame].size.height
2346 - vScreen.size.height - vScreen.origin.y),
2347 make_number ((int) vScreen.size.width),
2348 make_number ((int) vScreen.size.height));
2352 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2354 doc: /* Return the number of bitplanes of the Nextstep display DISPLAY.
2355 The optional argument DISPLAY specifies which display to ask about.
2356 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2357 If omitted or nil, that stands for the selected frame's display. */)
2359 Lisp_Object display;
2363 (NSBitsPerPixelFromDepth ([ns_get_screen (display) depth]));
2367 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2368 Sx_display_color_cells, 0, 1, 0,
2369 doc: /* Returns the number of color cells of the Nextstep display DISPLAY.
2370 The optional argument DISPLAY specifies which display to ask about.
2371 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2372 If omitted or nil, that stands for the selected frame's display. */)
2374 Lisp_Object display;
2377 struct ns_display_info *dpyinfo = check_ns_display_info (display);
2379 /* We force 24+ bit depths to 24-bit to prevent an overflow. */
2380 return make_number (1 << min (dpyinfo->n_planes, 24));
2384 /* Unused dummy def needed for compatibility. */
2385 Lisp_Object tip_frame;
2387 /* TODO: move to xdisp or similar */
2389 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
2391 Lisp_Object parms, dx, dy;
2393 int *root_x, *root_y;
2395 Lisp_Object left, top;
2396 EmacsView *view = FRAME_NS_VIEW (f);
2399 /* Start with user-specified or mouse position. */
2400 left = Fcdr (Fassq (Qleft, parms));
2401 if (INTEGERP (left))
2404 pt.x = last_mouse_motion_position.x;
2405 top = Fcdr (Fassq (Qtop, parms));
2409 pt.y = last_mouse_motion_position.y;
2411 /* Convert to screen coordinates */
2412 pt = [view convertPoint: pt toView: nil];
2413 pt = [[view window] convertBaseToScreen: pt];
2415 /* Ensure in bounds. (Note, screen origin = lower left.) */
2416 if (pt.x + XINT (dx) <= 0)
2417 *root_x = 0; /* Can happen for negative dx */
2418 else if (pt.x + XINT (dx) + width
2419 <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2420 /* It fits to the right of the pointer. */
2421 *root_x = pt.x + XINT (dx);
2422 else if (width + XINT (dx) <= pt.x)
2423 /* It fits to the left of the pointer. */
2424 *root_x = pt.x - width - XINT (dx);
2426 /* Put it left justified on the screen -- it ought to fit that way. */
2429 if (pt.y - XINT (dy) - height >= 0)
2430 /* It fits below the pointer. */
2431 *root_y = pt.y - height - XINT (dy);
2432 else if (pt.y + XINT (dy) + height
2433 <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2434 /* It fits above the pointer */
2435 *root_y = pt.y + XINT (dy);
2437 /* Put it on the top. */
2438 *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2442 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2443 doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2444 A tooltip window is a small window displaying a string.
2446 FRAME nil or omitted means use the selected frame.
2448 PARMS is an optional list of frame parameters which can be used to
2449 change the tooltip's appearance.
2451 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
2452 means use the default timeout of 5 seconds.
2454 If the list of frame parameters PARMS contains a `left' parameter,
2455 the tooltip is displayed at that x-position. Otherwise it is
2456 displayed at the mouse position, with offset DX added (default is 5 if
2457 DX isn't specified). Likewise for the y-position; if a `top' frame
2458 parameter is specified, it determines the y-position of the tooltip
2459 window, otherwise it is displayed at the mouse position, with offset
2460 DY added (default is -10).
2462 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2463 Text larger than the specified size is clipped. */)
2464 (string, frame, parms, timeout, dx, dy)
2465 Lisp_Object string, frame, parms, timeout, dx, dy;
2468 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2469 int count = SPECPDL_INDEX ();
2474 specbind (Qinhibit_redisplay, Qt);
2476 GCPRO4 (string, parms, frame, timeout);
2478 CHECK_STRING (string);
2479 str = SDATA (string);
2480 f = check_x_frame (frame);
2482 timeout = make_number (5);
2484 CHECK_NATNUM (timeout);
2487 dx = make_number (5);
2492 dy = make_number (-10);
2497 if (ns_tooltip == nil)
2498 ns_tooltip = [[EmacsTooltip alloc] init];
2502 [ns_tooltip setText: str];
2503 size = [ns_tooltip frame].size;
2505 /* Move the tooltip window where the mouse pointer is. Resize and
2507 compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2510 [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2514 return unbind_to (count, Qnil);
2518 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2519 doc: /* Hide the current tooltip window, if there is any.
2520 Value is t if tooltip was open, nil otherwise. */)
2523 if (ns_tooltip == nil || ![ns_tooltip isActive])
2530 /* ==========================================================================
2532 Class implementations
2534 ========================================================================== */
2537 @implementation EmacsSavePanel
2538 #ifdef NS_IMPL_COCOA
2539 /* --------------------------------------------------------------------------
2540 These are overridden to intercept on OS X: ending panel restarts NSApp
2541 event loop if it is stopped. Not sure if this is correct behavior,
2542 perhaps should check if running and if so send an appdefined.
2543 -------------------------------------------------------------------------- */
2544 - (void) ok: (id)sender
2550 - (void) cancel: (id)sender
2552 [super cancel: sender];
2559 @implementation EmacsOpenPanel
2560 #ifdef NS_IMPL_COCOA
2561 /* --------------------------------------------------------------------------
2562 These are overridden to intercept on OS X: ending panel restarts NSApp
2563 event loop if it is stopped. Not sure if this is correct behavior,
2564 perhaps should check if running and if so send an appdefined.
2565 -------------------------------------------------------------------------- */
2566 - (void) ok: (id)sender
2572 - (void) cancel: (id)sender
2574 [super cancel: sender];
2581 @implementation EmacsFileDelegate
2582 /* --------------------------------------------------------------------------
2583 Delegate methods for Open/Save panels
2584 -------------------------------------------------------------------------- */
2585 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2589 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2593 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2594 confirmed: (BOOL)okFlag
2603 /* ==========================================================================
2605 Lisp interface declaration
2607 ========================================================================== */
2615 Qfontsize = intern ("fontsize");
2616 staticpro (&Qfontsize);
2618 DEFVAR_LISP ("ns-icon-type-alist", &Vns_icon_type_alist,
2619 doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2620 If the title of a frame matches REGEXP, then IMAGE.tiff is
2621 selected as the image of the icon representing the frame when it's
2622 miniaturized. If an element is t, then Emacs tries to select an icon
2623 based on the filetype of the visited file.
2625 The images have to be installed in a folder called English.lproj in the
2626 Emacs folder. You have to restart Emacs after installing new icons.
2628 Example: Install an icon Gnus.tiff and execute the following code
2630 (setq ns-icon-type-alist
2631 (append ns-icon-type-alist
2632 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2635 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2636 be used as the image of the icon representing the frame. */);
2637 Vns_icon_type_alist = Fcons (Qt, Qnil);
2639 DEFVAR_LISP ("ns-version-string", &Vns_version_string,
2640 doc: /* Toolkit version for NS Windowing. */);
2641 Vns_version_string = ns_appkit_version_str ();
2643 defsubr (&Sns_read_file_name);
2644 defsubr (&Sns_get_resource);
2645 defsubr (&Sns_set_resource);
2646 defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2647 defsubr (&Sx_display_grayscale_p);
2648 defsubr (&Sns_font_name);
2649 defsubr (&Sns_list_colors);
2650 #ifdef NS_IMPL_COCOA
2651 defsubr (&Sns_do_applescript);
2653 defsubr (&Sxw_color_defined_p);
2654 defsubr (&Sxw_color_values);
2655 defsubr (&Sx_server_max_request_size);
2656 defsubr (&Sx_server_vendor);
2657 defsubr (&Sx_server_version);
2658 defsubr (&Sx_display_pixel_width);
2659 defsubr (&Sx_display_pixel_height);
2660 defsubr (&Sns_display_usable_bounds);
2661 defsubr (&Sx_display_mm_width);
2662 defsubr (&Sx_display_mm_height);
2663 defsubr (&Sx_display_screens);
2664 defsubr (&Sx_display_planes);
2665 defsubr (&Sx_display_color_cells);
2666 defsubr (&Sx_display_visual_class);
2667 defsubr (&Sx_display_backing_store);
2668 defsubr (&Sx_display_save_under);
2669 defsubr (&Sx_create_frame);
2670 defsubr (&Sx_open_connection);
2671 defsubr (&Sx_close_connection);
2672 defsubr (&Sx_display_list);
2674 defsubr (&Sns_hide_others);
2675 defsubr (&Sns_hide_emacs);
2676 defsubr (&Sns_emacs_info_panel);
2677 defsubr (&Sns_list_services);
2678 defsubr (&Sns_perform_service);
2679 defsubr (&Sns_convert_utf8_nfd_to_nfc);
2680 defsubr (&Sx_focus_frame);
2681 defsubr (&Sns_popup_font_panel);
2682 defsubr (&Sns_popup_color_panel);
2684 defsubr (&Sx_show_tip);
2685 defsubr (&Sx_hide_tip);
2687 /* used only in fontset.c */
2688 check_window_system_func = check_ns;
2692 // arch-tag: dc2a3f74-1123-4daa-8eed-fb78db6a5642