1 /* Functions for the NeXT/Open/GNUstep and MacOSX window system.
2 Copyright (C) 1989, 1992, 1993, 1994, 2005, 2006, 2008, 2009, 2010, 2011
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, Vicon_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
228 ? dpyinfo->x_focus_frame : dpyinfo->x_highlight_frame;
231 return ((f && FRAME_NS_P (f)) ? [[FRAME_NS_VIEW (f) window] screen]
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)]];
473 ns_set_name_internal (FRAME_PTR f, Lisp_Object name)
476 Lisp_Object encoded_name, encoded_icon_name;
478 NSView *view = FRAME_NS_VIEW (f);
481 encoded_name = ENCODE_UTF_8 (name);
484 str = [NSString stringWithUTF8String: SDATA (encoded_name)];
486 /* Don't change the name if it's already NAME. */
487 if (! [[[view window] title] isEqualToString: str])
488 [[view window] setTitle: str];
490 if (!STRINGP (f->icon_name))
491 encoded_icon_name = encoded_name;
493 encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
495 str = [NSString stringWithUTF8String: SDATA (encoded_icon_name)];
497 if ([[view window] miniwindowTitle] &&
498 ! [[[view window] miniwindowTitle] isEqualToString: str])
499 [[view window] setMiniwindowTitle: str];
504 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
507 NSTRACE (ns_set_name);
512 /* Make sure that requests from lisp code override requests from
513 Emacs redisplay code. */
516 /* If we're switching from explicit to implicit, we had better
517 update the mode lines and thereby update the title. */
518 if (f->explicit_name && NILP (name))
519 update_mode_lines = 1;
521 f->explicit_name = ! NILP (name);
523 else if (f->explicit_name)
527 name = build_string([ns_app_name UTF8String]);
531 /* Don't change the name if it's already NAME. */
532 if (! NILP (Fstring_equal (name, f->name)))
537 /* title overrides explicit name */
538 if (! NILP (f->title))
541 ns_set_name_internal (f, name);
545 /* This function should be called when the user's lisp code has
546 specified a name for the frame; the name will override any set by the
549 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
551 NSTRACE (x_explicitly_set_name);
552 ns_set_name (f, arg, 1);
556 /* This function should be called by Emacs redisplay code to set the
557 name; names set this way will never override names set by the user's
560 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
562 NSTRACE (x_implicitly_set_name);
564 /* Deal with NS specific format t. */
565 if (FRAME_NS_P (f) && ((FRAME_ICONIFIED_P (f) && EQ (Vicon_title_format, Qt))
566 || EQ (Vframe_title_format, Qt)))
567 ns_set_name_as_filename (f);
569 ns_set_name (f, arg, 0);
573 /* Change the title of frame F to NAME.
574 If NAME is nil, use the frame name as the title. */
577 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
579 NSTRACE (x_set_title);
580 /* Don't change the title if it's already NAME. */
581 if (EQ (name, f->title))
584 update_mode_lines = 1;
593 ns_set_name_internal (f, name);
598 ns_set_name_as_filename (struct frame *f)
601 Lisp_Object name, filename;
602 Lisp_Object buf = XWINDOW (f->selected_window)->buffer;
604 NSAutoreleasePool *pool;
606 Lisp_Object encoded_name, encoded_filename;
608 NSTRACE (ns_set_name_as_filename);
610 if (f->explicit_name || ! NILP (f->title) || ns_in_resize)
614 pool = [[NSAutoreleasePool alloc] init];
615 filename = XBUFFER (buf)->filename;
616 name = XBUFFER (buf)->name;
620 if (! NILP (filename))
621 name = Ffile_name_nondirectory (filename);
623 name = build_string ([ns_app_name UTF8String]);
627 encoded_name = ENCODE_UTF_8 (name);
630 view = FRAME_NS_VIEW (f);
632 title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
633 : [[[view window] title] UTF8String];
635 if (title && (! strcmp (title, SDATA (encoded_name))))
642 str = [NSString stringWithUTF8String: SDATA (encoded_name)];
643 if (str == nil) str = @"Bad coding";
645 if (FRAME_ICONIFIED_P (f))
646 [[view window] setMiniwindowTitle: str];
651 if (! NILP (filename))
654 encoded_filename = ENCODE_UTF_8 (filename);
657 fstr = [NSString stringWithUTF8String: SDATA (encoded_filename)];
658 if (fstr == nil) fstr = @"";
660 /* work around a bug observed on 10.3 and later where
661 setTitleWithRepresentedFilename does not clear out previous state
662 if given filename does not exist */
663 if (! [[NSFileManager defaultManager] fileExistsAtPath: fstr])
664 [[view window] setRepresentedFilename: @""];
670 [[view window] setRepresentedFilename: fstr];
671 [[view window] setTitle: str];
681 ns_set_doc_edited (struct frame *f, Lisp_Object arg)
683 NSView *view = FRAME_NS_VIEW (f);
684 NSAutoreleasePool *pool;
685 if (!MINI_WINDOW_P (XWINDOW (f->selected_window)))
688 pool = [[NSAutoreleasePool alloc] init];
689 [[view window] setDocumentEdited: !NILP (arg)];
697 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
700 int olines = FRAME_MENU_BAR_LINES (f);
701 if (FRAME_MINIBUF_ONLY_P (f))
704 if (INTEGERP (value))
705 nlines = XINT (value);
709 FRAME_MENU_BAR_LINES (f) = 0;
712 FRAME_EXTERNAL_MENU_BAR (f) = 1;
713 /* does for all frames, whereas we just want for one frame
714 [NSMenu setMenuBarVisible: YES]; */
718 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
719 free_frame_menubar (f);
720 /* [NSMenu setMenuBarVisible: NO]; */
721 FRAME_EXTERNAL_MENU_BAR (f) = 0;
726 /* toolbar support */
728 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
731 Lisp_Object root_window;
733 if (FRAME_MINIBUF_ONLY_P (f))
736 if (INTEGERP (value) && XINT (value) >= 0)
737 nlines = XFASTINT (value);
743 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
744 update_frame_tool_bar (f);
748 if (FRAME_EXTERNAL_TOOL_BAR (f))
750 free_frame_tool_bar (f);
751 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
755 x_set_window_size (f, 0, f->text_cols, f->text_lines);
760 ns_implicitly_set_icon_type (struct frame *f)
763 EmacsView *view = FRAME_NS_VIEW (f);
765 Lisp_Object chain, elt;
766 NSAutoreleasePool *pool;
769 NSTRACE (ns_implicitly_set_icon_type);
772 pool = [[NSAutoreleasePool alloc] init];
773 if (f->output_data.ns->miniimage
774 && [[NSString stringWithUTF8String: SDATA (f->name)]
775 isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
782 tem = assq_no_quit (Qicon_type, f->param_alist);
783 if (CONSP (tem) && ! NILP (XCDR (tem)))
790 for (chain = Vns_icon_type_alist;
791 (image = nil) && CONSP (chain);
792 chain = XCDR (chain))
795 /* special case: 't' means go by file type */
796 if (SYMBOLP (elt) && EQ (elt, Qt) && SDATA (f->name)[0] == '/')
799 = [NSString stringWithUTF8String: SDATA (f->name)];
800 if ([[NSFileManager defaultManager] fileExistsAtPath: str])
801 image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
803 else if (CONSP (elt) &&
804 STRINGP (XCAR (elt)) &&
805 STRINGP (XCDR (elt)) &&
806 fast_string_match (XCAR (elt), f->name) >= 0)
808 image = [EmacsImage allocInitFromFile: XCDR (elt)];
810 image = [[NSImage imageNamed:
811 [NSString stringWithUTF8String:
812 SDATA (XCDR (elt))]] retain];
818 image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
822 [f->output_data.ns->miniimage release];
823 f->output_data.ns->miniimage = image;
824 [view setMiniwindowImage: setMini];
831 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
833 EmacsView *view = FRAME_NS_VIEW (f);
837 NSTRACE (x_set_icon_type);
839 if (!NILP (arg) && SYMBOLP (arg))
841 arg =build_string (SDATA (SYMBOL_NAME (arg)));
842 store_frame_param (f, Qicon_type, arg);
845 /* do it the implicit way */
848 ns_implicitly_set_icon_type (f);
854 image = [EmacsImage allocInitFromFile: arg];
856 image =[NSImage imageNamed: [NSString stringWithUTF8String:
861 image = [NSImage imageNamed: @"text"];
865 f->output_data.ns->miniimage = image;
866 [view setMiniwindowImage: setMini];
870 /* Xism; we stub out (we do implement this in ns-win.el) */
872 XParseGeometry (char *string, int *x, int *y,
873 unsigned int *width, unsigned int *height)
875 message1 ("Warning: XParseGeometry not supported under NS.\n");
880 /* TODO: move to nsterm? */
882 ns_lisp_to_cursor_type (Lisp_Object arg)
885 if (XTYPE (arg) == Lisp_String)
887 else if (XTYPE (arg) == Lisp_Symbol)
888 str = SDATA (SYMBOL_NAME (arg));
890 if (!strcmp (str, "box")) return FILLED_BOX_CURSOR;
891 if (!strcmp (str, "hollow")) return HOLLOW_BOX_CURSOR;
892 if (!strcmp (str, "hbar")) return HBAR_CURSOR;
893 if (!strcmp (str, "bar")) return BAR_CURSOR;
894 if (!strcmp (str, "no")) return NO_CURSOR;
900 ns_cursor_type_to_lisp (int arg)
904 case FILLED_BOX_CURSOR: return Qbox;
905 case HOLLOW_BOX_CURSOR: return intern ("hollow");
906 case HBAR_CURSOR: return intern ("hbar");
907 case BAR_CURSOR: return intern ("bar");
909 default: return intern ("no");
913 /* This is the same as the xfns.c definition. */
915 x_set_cursor_type (f, arg, oldval)
917 Lisp_Object arg, oldval;
919 set_frame_cursor_types (f, arg);
921 /* Make sure the cursor gets redrawn. */
922 cursor_type_changed = 1;
926 /* called to set mouse pointer color, but all other terms use it to
927 initialize pointer types (and don't set the color ;) */
929 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
931 /* don't think we can do this on Nextstep */
936 #define Xstr(x) Str(x)
939 ns_appkit_version_str ()
943 #ifdef NS_IMPL_GNUSTEP
944 sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
945 #elif defined(NS_IMPL_COCOA)
946 sprintf(tmp, "apple-appkit-%.2f", NSAppKitVersionNumber);
950 return build_string (tmp);
954 /* This is for use by x-server-version and collapses all version info we
955 have into a single int. For a better picture of the implementation
956 running, use ns_appkit_version_str.*/
958 ns_appkit_version_int ()
960 #ifdef NS_IMPL_GNUSTEP
961 return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GUI_MINOR_VERSION;
962 #elif defined(NS_IMPL_COCOA)
963 return (int)NSAppKitVersionNumber;
970 x_icon (struct frame *f, Lisp_Object parms)
971 /* --------------------------------------------------------------------------
972 Strangely-named function to set icon position parameters in frame.
973 This is irrelevant under OS X, but might be needed under GNUstep,
974 depending on the window manager used. Note, this is not a standard
975 frame parameter-setter; it is called directly from x-create-frame.
976 -------------------------------------------------------------------------- */
978 Lisp_Object icon_x, icon_y;
979 struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
981 f->output_data.ns->icon_top = Qnil;
982 f->output_data.ns->icon_left = Qnil;
984 /* Set the position of the icon. */
985 icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
986 icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
987 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
989 CHECK_NUMBER (icon_x);
990 CHECK_NUMBER (icon_y);
991 f->output_data.ns->icon_top = icon_y;
992 f->output_data.ns->icon_left = icon_x;
994 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
995 error ("Both left and top icon corners of icon must be specified");
999 /* Note: see frame.c for template, also where generic functions are impl */
1000 frame_parm_handler ns_frame_parm_handlers[] =
1002 x_set_autoraise, /* generic OK */
1003 x_set_autolower, /* generic OK */
1004 x_set_background_color,
1005 0, /* x_set_border_color, may be impossible under Nextstep */
1006 0, /* x_set_border_width, may be impossible under Nextstep */
1009 x_set_font, /* generic OK */
1010 x_set_foreground_color,
1013 x_set_internal_border_width, /* generic OK */
1014 x_set_menu_bar_lines,
1016 x_explicitly_set_name,
1017 x_set_scroll_bar_width, /* generic OK */
1019 x_set_unsplittable, /* generic OK */
1020 x_set_vertical_scroll_bars, /* generic OK */
1021 x_set_visibility, /* generic OK */
1022 x_set_tool_bar_lines,
1023 0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
1024 0, /* x_set_scroll_bar_background, will ignore (not possible on NS) */
1025 x_set_screen_gamma, /* generic OK */
1026 x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
1027 x_set_fringe_width, /* generic OK */
1028 x_set_fringe_width, /* generic OK */
1029 0, /* x_set_wait_for_wm, will ignore */
1030 0, /* x_set_fullscreen will ignore */
1031 x_set_font_backend, /* generic OK */
1033 0, /* x_set_sticky */
1038 /* ==========================================================================
1042 ========================================================================== */
1044 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1046 doc: /* Make a new Nextstep window, called a \"frame\" in Emacs terms.
1047 Return an Emacs frame object.
1048 PARMS is an alist of frame parameters.
1049 If the parameters specify that the frame should not have a minibuffer,
1050 and do not specify a specific minibuffer window to use,
1051 then `default-minibuffer-frame' must be a frame whose minibuffer can
1052 be shared by the new frame. */)
1056 static int desc_ctr = 1;
1058 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1059 Lisp_Object frame, tem;
1061 int minibuffer_only = 0;
1062 int count = specpdl_ptr - specpdl;
1063 Lisp_Object display;
1064 struct ns_display_info *dpyinfo = NULL;
1067 Lisp_Object tfont, tfontsize;
1068 int window_prompting = 0;
1073 /* Seems a little strange, but other terms do it. Perhaps the code below
1074 is modifying something? */
1075 parms = Fcopy_alist (parms);
1077 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1078 if (EQ (display, Qunbound))
1080 dpyinfo = check_ns_display_info (display);
1082 if (!dpyinfo->terminal->name)
1083 error ("Terminal is not live, can't create new frames on it");
1085 kb = dpyinfo->terminal->kboard;
1087 name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1089 && ! EQ (name, Qunbound)
1091 error ("Invalid frame name--not a string or nil");
1094 Vx_resource_name = name;
1096 Vx_resource_name = Vinvocation_name;
1098 parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1099 if (EQ (parent, Qunbound))
1101 if (! NILP (parent))
1102 CHECK_NUMBER (parent);
1105 GCPRO4 (parms, parent, name, frame);
1107 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1109 if (EQ (tem, Qnone) || NILP (tem))
1111 f = make_frame_without_minibuffer (Qnil, kb, display);
1113 else if (EQ (tem, Qonly))
1115 f = make_minibuffer_frame ();
1116 minibuffer_only = 1;
1118 else if (WINDOWP (tem))
1120 f = make_frame_without_minibuffer (tem, kb, display);
1127 /* Set the name; the functions to which we pass f expect the name to
1129 if (EQ (name, Qunbound) || NILP (name) || (XTYPE (name) != Lisp_String))
1131 f->name = build_string ([ns_app_name UTF8String]);
1132 f->explicit_name =0;
1137 f->explicit_name = 1;
1138 specbind (Qx_resource_name, name);
1141 XSETFRAME (frame, f);
1142 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
1144 f->terminal = dpyinfo->terminal;
1145 f->terminal->reference_count++;
1147 f->output_method = output_ns;
1148 f->output_data.ns = (struct ns_output *)xmalloc (sizeof *(f->output_data.ns));
1149 bzero (f->output_data.ns, sizeof (*(f->output_data.ns)));
1151 FRAME_FONTSET (f) = -1;
1153 /* record_unwind_protect (unwind_create_frame, frame); safety; maybe later? */
1155 f->icon_name = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
1157 if (! STRINGP (f->icon_name))
1158 f->icon_name = Qnil;
1160 FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1162 f->output_data.ns->window_desc = desc_ctr++;
1165 f->output_data.ns->parent_desc = (Window) XFASTINT (parent);
1166 f->output_data.ns->explicit_parent = 1;
1170 f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1171 f->output_data.ns->explicit_parent = 0;
1174 f->resx = dpyinfo->resx;
1175 f->resy = dpyinfo->resy;
1178 register_font_driver (&nsfont_driver, f);
1179 x_default_parameter (f, parms, Qfont_backend, Qnil,
1180 "fontBackend", "FontBackend", RES_TYPE_STRING);
1183 /* use for default font name */
1184 id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1185 tfontsize = x_default_parameter (f, parms, Qfontsize,
1186 make_number (0 /*(int)[font pointSize]*/),
1187 "fontSize", "FontSize", RES_TYPE_NUMBER);
1188 tfont = x_default_parameter (f, parms, Qfont,
1189 build_string ([[font fontName] UTF8String]),
1190 "font", "Font", RES_TYPE_STRING);
1194 x_default_parameter (f, parms, Qborder_width, make_number (0),
1195 "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1196 x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1197 "internalBorderWidth", "InternalBorderWidth",
1200 /* default scrollbars on right on Mac */
1203 #ifdef NS_IMPL_GNUSTEP
1208 x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1209 "verticalScrollBars", "VerticalScrollBars",
1212 x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1213 "foreground", "Foreground", RES_TYPE_STRING);
1214 x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1215 "background", "Background", RES_TYPE_STRING);
1216 x_default_parameter (f, parms, Qcursor_color, build_string ("grey"),
1217 "cursorColor", "CursorColor", RES_TYPE_STRING);
1218 /* FIXME: not suppported yet in Nextstep */
1219 x_default_parameter (f, parms, Qline_spacing, Qnil,
1220 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1221 x_default_parameter (f, parms, Qleft_fringe, Qnil,
1222 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1223 x_default_parameter (f, parms, Qright_fringe, Qnil,
1224 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1227 init_frame_faces (f);
1229 x_default_parameter (f, parms, Qmenu_bar_lines, make_number (0), "menuBar",
1230 "menuBar", RES_TYPE_NUMBER);
1231 x_default_parameter (f, parms, Qtool_bar_lines, make_number (0), "toolBar",
1232 "toolBar", RES_TYPE_NUMBER);
1233 x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1234 "BufferPredicate", RES_TYPE_SYMBOL);
1235 x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1238 /* TODO: other terms seem to get away w/o this complexity.. */
1239 if (NILP (Fassq (Qwidth, parms)))
1242 = x_get_arg (dpyinfo, parms, Qwidth, "width", "Width",
1244 if (! EQ (value, Qunbound))
1245 parms = Fcons (Fcons (Qwidth, value), parms);
1247 if (NILP (Fassq (Qheight, parms)))
1250 = x_get_arg (dpyinfo, parms, Qheight, "height", "Height",
1252 if (! EQ (value, Qunbound))
1253 parms = Fcons (Fcons (Qheight, value), parms);
1255 if (NILP (Fassq (Qleft, parms)))
1258 = x_get_arg (dpyinfo, parms, Qleft, "left", "Left", RES_TYPE_NUMBER);
1259 if (! EQ (value, Qunbound))
1260 parms = Fcons (Fcons (Qleft, value), parms);
1262 if (NILP (Fassq (Qtop, parms)))
1265 = x_get_arg (dpyinfo, parms, Qtop, "top", "Top", RES_TYPE_NUMBER);
1266 if (! EQ (value, Qunbound))
1267 parms = Fcons (Fcons (Qtop, value), parms);
1270 window_prompting = x_figure_window_size (f, parms, 1);
1272 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1273 f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1275 /* NOTE: on other terms, this is done in set_mouse_color, however this
1276 was not getting called under Nextstep */
1277 f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1278 f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1279 f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1280 f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1281 f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1282 f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1283 FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1284 = [NSCursor arrowCursor];
1285 f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1287 [[EmacsView alloc] initFrameFromEmacs: f];
1291 /* It is now ok to make the frame official even if we get an error below.
1292 The frame needs to be on Vframe_list or making it visible won't work. */
1293 Vframe_list = Fcons (frame, Vframe_list);
1294 /*FRAME_NS_DISPLAY_INFO (f)->reference_count++; */
1296 x_default_parameter (f, parms, Qicon_type, Qnil, "bitmapIcon", "BitmapIcon",
1298 x_default_parameter (f, parms, Qauto_raise, Qnil, "autoRaise", "AutoRaiseLower",
1300 x_default_parameter (f, parms, Qauto_lower, Qnil, "autoLower", "AutoLower",
1302 x_default_parameter (f, parms, Qcursor_type, Qbox, "cursorType", "CursorType",
1304 x_default_parameter (f, parms, Qscroll_bar_width, Qnil, "scrollBarWidth",
1305 "ScrollBarWidth", RES_TYPE_NUMBER);
1306 x_default_parameter (f, parms, Qalpha, Qnil, "alpha", "Alpha",
1309 width = FRAME_COLS (f);
1310 height = FRAME_LINES (f);
1312 SET_FRAME_COLS (f, 0);
1313 FRAME_LINES (f) = 0;
1314 change_frame_size (f, height, width, 1, 0, 0);
1316 if (! f->output_data.ns->explicit_parent)
1318 tem = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL);
1319 if (EQ (tem, Qunbound))
1321 x_set_visibility (f, tem, Qnil);
1322 if (EQ (tem, Qicon))
1323 x_iconify_frame (f);
1324 else if (! NILP (tem))
1326 x_make_frame_visible (f);
1327 f->async_visible = 1;
1328 [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1331 f->async_visible = 0;
1334 if (FRAME_HAS_MINIBUF_P (f)
1335 && (!FRAMEP (kb->Vdefault_minibuffer_frame)
1336 || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
1337 kb->Vdefault_minibuffer_frame = frame;
1339 /* All remaining specified parameters, which have not been "used"
1340 by x_get_arg and friends, now go in the misc. alist of the frame. */
1341 for (tem = parms; CONSP (tem); tem = XCDR (tem))
1342 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1343 f->param_alist = Fcons (XCAR (tem), f->param_alist);
1346 Vwindow_list = Qnil;
1348 return unbind_to (count, frame);
1352 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1353 doc: /* Set the input focus to FRAME.
1354 FRAME nil means use the selected frame. */)
1358 struct frame *f = check_ns_frame (frame);
1359 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1361 if (dpyinfo->x_focus_frame != f)
1363 EmacsView *view = FRAME_NS_VIEW (f);
1365 [NSApp activateIgnoringOtherApps: YES];
1366 [[view window] makeKeyAndOrderFront: view];
1374 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1376 doc: /* Pop up the font panel. */)
1384 fm = [NSFontManager sharedFontManager];
1386 f = SELECTED_FRAME ();
1389 CHECK_FRAME (frame);
1393 [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1395 [fm orderFrontFontPanel: NSApp];
1400 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1402 doc: /* Pop up the color panel. */)
1410 f = SELECTED_FRAME ();
1413 CHECK_FRAME (frame);
1417 [NSApp orderFrontColorPanel: NSApp];
1422 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 4, 0,
1423 doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1424 Optional arg DIR, if non-nil, supplies a default directory.
1425 Optional arg MUSTMATCH, if non-nil, means the returned file or
1426 directory must exist.
1427 Optional arg INIT, if non-nil, provides a default file name to use. */)
1428 (prompt, dir, mustmatch, init)
1429 Lisp_Object prompt, dir, mustmatch, init;
1431 static id fileDelegate = nil;
1436 NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1437 [NSString stringWithUTF8String: SDATA (prompt)];
1438 NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1439 [NSString stringWithUTF8String: SDATA (current_buffer->directory)] :
1440 [NSString stringWithUTF8String: SDATA (dir)];
1441 NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1442 [NSString stringWithUTF8String: SDATA (init)];
1446 if (fileDelegate == nil)
1447 fileDelegate = [EmacsFileDelegate new];
1449 [NSCursor setHiddenUntilMouseMoves: NO];
1451 if ([dirS characterAtIndex: 0] == '~')
1452 dirS = [dirS stringByExpandingTildeInPath];
1454 panel = NILP (mustmatch) ?
1455 (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1457 [panel setTitle: promptS];
1459 /* Puma (10.1) does not have */
1460 if ([panel respondsToSelector: @selector (setAllowsOtherFileTypes:)])
1461 [panel setAllowsOtherFileTypes: YES];
1463 [panel setTreatsFilePackagesAsDirectories: YES];
1464 [panel setDelegate: fileDelegate];
1468 if (NILP (mustmatch))
1470 ret = [panel runModalForDirectory: dirS file: initS];
1474 [panel setCanChooseDirectories: YES];
1475 ret = [panel runModalForDirectory: dirS file: initS types: nil];
1478 ret = (ret == NSOKButton) || panelOK;
1481 fname = build_string ([[panel filename] UTF8String]);
1483 [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1486 return ret ? fname : Qnil;
1490 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1491 doc: /* Return the value of the property NAME of OWNER from the defaults database.
1492 If OWNER is nil, Emacs is assumed. */)
1494 Lisp_Object owner, name;
1500 owner = build_string([ns_app_name UTF8String]);
1501 CHECK_STRING (name);
1502 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SDATA (name)); */
1504 value =[[[NSUserDefaults standardUserDefaults]
1505 objectForKey: [NSString stringWithUTF8String: SDATA (name)]]
1509 return build_string (value);
1514 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1515 doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1516 If OWNER is nil, Emacs is assumed.
1517 If VALUE is nil, the default is removed. */)
1518 (owner, name, value)
1519 Lisp_Object owner, name, value;
1523 owner = build_string ([ns_app_name UTF8String]);
1524 CHECK_STRING (name);
1527 [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1528 [NSString stringWithUTF8String: SDATA (name)]];
1532 CHECK_STRING (value);
1533 [[NSUserDefaults standardUserDefaults] setObject:
1534 [NSString stringWithUTF8String: SDATA (value)]
1535 forKey: [NSString stringWithUTF8String:
1543 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1544 Sx_server_max_request_size,
1546 doc: /* This function is a no-op. It is only present for completeness. */)
1548 Lisp_Object display;
1551 /* This function has no real equivalent under NeXTstep. Return nil to
1557 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1558 doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1559 DISPLAY should be either a frame or a display name (a string).
1560 If omitted or nil, the selected frame's display is used. */)
1562 Lisp_Object display;
1564 #ifdef NS_IMPL_GNUSTEP
1565 return build_string ("GNU");
1567 return build_string ("Apple");
1572 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1573 doc: /* Return the version numbers of the server of DISPLAY.
1574 The value is a list of three integers: the major and minor
1575 version numbers of the X Protocol in use, and the distributor-specific
1576 release number. See also the function `x-server-vendor'.
1578 The optional argument DISPLAY specifies which display to ask about.
1579 DISPLAY should be either a frame or a display name (a string).
1580 If omitted or nil, that stands for the selected frame's display. */)
1582 Lisp_Object display;
1584 /*NOTE: it is unclear what would best correspond with "protocol";
1585 we return 10.3, meaning Panther, since this is roughly the
1586 level that GNUstep's APIs correspond to.
1587 The last number is where we distinguish between the Apple
1588 and GNUstep implementations ("distributor-specific release
1589 number") and give int'ized versions of major.minor. */
1590 return Fcons (make_number (10),
1591 Fcons (make_number (3),
1592 Fcons (make_number (ns_appkit_version_int()), Qnil)));
1596 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1597 doc: /* Return the number of screens on Nextstep display server DISPLAY.
1598 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1599 If omitted or nil, the selected frame's display is used. */)
1601 Lisp_Object display;
1606 num = [[NSScreen screens] count];
1608 return (num != 0) ? make_number (num) : Qnil;
1612 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1614 doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1615 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1616 If omitted or nil, the selected frame's display is used. */)
1618 Lisp_Object display;
1621 return make_number ((int)
1622 ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1626 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1628 doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1629 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1630 If omitted or nil, the selected frame's display is used. */)
1632 Lisp_Object display;
1635 return make_number ((int)
1636 ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1640 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1641 Sx_display_backing_store, 0, 1, 0,
1642 doc: /* Return whether the Nexstep display DISPLAY supports backing store.
1643 The value may be `buffered', `retained', or `non-retained'.
1644 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1645 If omitted or nil, the selected frame's display is used. */)
1647 Lisp_Object display;
1650 switch ([ns_get_window (display) backingType])
1652 case NSBackingStoreBuffered:
1653 return intern ("buffered");
1654 case NSBackingStoreRetained:
1655 return intern ("retained");
1656 case NSBackingStoreNonretained:
1657 return intern ("non-retained");
1659 error ("Strange value for backingType parameter of frame");
1661 return Qnil; /* not reached, shut compiler up */
1665 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1666 Sx_display_visual_class, 0, 1, 0,
1667 doc: /* Return the visual class of the Nextstep display server DISPLAY.
1668 The value is one of the symbols `static-gray', `gray-scale',
1669 `static-color', `pseudo-color', `true-color', or `direct-color'.
1670 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1671 If omitted or nil, the selected frame's display is used. */)
1673 Lisp_Object display;
1675 NSWindowDepth depth;
1677 depth = [ns_get_screen (display) depth];
1679 if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1680 return intern ("static-gray");
1681 else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1682 return intern ("gray-scale");
1683 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1684 return intern ("pseudo-color");
1685 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1686 return intern ("true-color");
1687 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1688 return intern ("direct-color");
1690 /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1691 return intern ("direct-color");
1695 DEFUN ("x-display-save-under", Fx_display_save_under,
1696 Sx_display_save_under, 0, 1, 0,
1697 doc: /* Non-nil if the Nextstep display server supports the save-under feature.
1698 The optional argument DISPLAY specifies which display to ask about.
1699 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1700 If omitted or nil, the selected frame's display is used. */)
1702 Lisp_Object display;
1705 switch ([ns_get_window (display) backingType])
1707 case NSBackingStoreBuffered:
1710 case NSBackingStoreRetained:
1711 case NSBackingStoreNonretained:
1715 error ("Strange value for backingType parameter of frame");
1717 return Qnil; /* not reached, shut compiler up */
1721 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1723 doc: /* Open a connection to a Nextstep display server.
1724 DISPLAY is the name of the display to connect to.
1725 Optional arguments XRM-STRING and MUST-SUCCEED are currently ignored. */)
1726 (display, resource_string, must_succeed)
1727 Lisp_Object display, resource_string, must_succeed;
1729 struct ns_display_info *dpyinfo;
1731 CHECK_STRING (display);
1733 nxatoms_of_nsselect ();
1734 dpyinfo = ns_term_init (display);
1737 if (!NILP (must_succeed))
1738 fatal ("OpenStep on %s not responding.\n",
1741 error ("OpenStep on %s not responding.\n",
1745 /* Register our external input/output types, used for determining
1746 applicable services and also drag/drop eligibility. */
1747 ns_send_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1748 ns_return_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1749 ns_drag_types = [[NSArray arrayWithObjects:
1751 NSTabularTextPboardType,
1752 NSFilenamesPboardType,
1755 NSFontPboardType, nil] retain];
1761 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1763 doc: /* Close the connection to the current Nextstep display server.
1764 The argument DISPLAY is currently ignored. */)
1766 Lisp_Object display;
1769 /*ns_delete_terminal (dpyinfo->terminal); */
1770 [NSApp terminate: NSApp];
1775 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1776 doc: /* Return the list of display names that Emacs has connections to. */)
1779 Lisp_Object tail, result;
1782 for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1783 result = Fcons (XCAR (XCAR (tail)), result);
1789 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1791 doc: /* Hides all applications other than Emacs. */)
1795 [NSApp hideOtherApplications: NSApp];
1799 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1801 doc: /* If ON is non-nil, the entire Emacs application is hidden.
1802 Otherwise if Emacs is hidden, it is unhidden.
1803 If ON is equal to `activate', Emacs is unhidden and becomes
1804 the active application. */)
1809 if (EQ (on, intern ("activate")))
1811 [NSApp unhide: NSApp];
1812 [NSApp activateIgnoringOtherApps: YES];
1815 [NSApp unhide: NSApp];
1817 [NSApp hide: NSApp];
1822 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1824 doc: /* Shows the 'Info' or 'About' panel for Emacs. */)
1828 [NSApp orderFrontStandardAboutPanel: nil];
1833 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1834 doc: /* Determine font postscript or family name for font NAME.
1835 NAME should be a string containing either the font name or an XLFD
1836 font descriptor. If string contains `fontset' and not
1837 `fontset-startup', it is left alone. */)
1842 CHECK_STRING (name);
1847 if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1850 return build_string (ns_xlfd_to_fontname (SDATA (name)));
1854 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1855 doc: /* Return a list of all available colors.
1856 The optional argument FRAME is currently ignored. */)
1860 Lisp_Object list = Qnil;
1861 NSEnumerator *colorlists;
1866 CHECK_FRAME (frame);
1867 if (! FRAME_NS_P (XFRAME (frame)))
1868 error ("non-Nextstep frame used in `ns-list-colors'");
1873 colorlists = [[NSColorList availableColorLists] objectEnumerator];
1874 while (clist = [colorlists nextObject])
1876 if ([[clist name] length] < 7 ||
1877 [[clist name] rangeOfString: @"PANTONE"].location == 0)
1879 NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1881 while (cname = [cnames nextObject])
1882 list = Fcons (build_string ([cname UTF8String]), list);
1883 /* for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1884 list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1885 UTF8String]), list); */
1895 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1896 doc: /* List available Nextstep services by querying NSApp. */)
1899 Lisp_Object ret = Qnil;
1904 svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1905 [NSApp setServicesMenu: svcs]; /* this and next rebuild on <10.4 */
1906 [NSApp registerServicesMenuSendTypes: ns_send_types
1907 returnTypes: ns_return_types];
1909 /* On Tiger, services menu updating was made lazier (waits for user to
1910 actually click on the menu), so we have to force things along: */
1911 #ifdef NS_IMPL_COCOA
1912 if (NSAppKitVersionNumber >= 744.0)
1914 delegate = [svcs delegate];
1915 if (delegate != nil)
1917 if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1918 [delegate menuNeedsUpdate: svcs];
1919 if ([delegate respondsToSelector:
1920 @selector (menu:updateItem:atIndex:shouldCancel:)])
1922 int i, len = [delegate numberOfItemsInMenu: svcs];
1923 for (i =0; i<len; i++)
1924 [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1925 for (i =0; i<len; i++)
1926 if (![delegate menu: svcs
1927 updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1928 atIndex: i shouldCancel: NO])
1935 [svcs setAutoenablesItems: NO];
1936 #ifdef NS_IMPL_COCOA
1937 [svcs update]; /* on OS X, converts from '/' structure */
1940 ret = interpret_services_menu (svcs, Qnil, ret);
1945 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
1947 doc: /* Perform Nextstep SERVICE on SEND.
1948 SEND should be either a string or nil.
1949 The return value is the result of the service, as string, or nil if
1950 there was no result. */)
1952 Lisp_Object service, send;
1959 CHECK_STRING (service);
1962 utfStr = SDATA (service);
1963 svcName = [NSString stringWithUTF8String: utfStr];
1965 pb =[NSPasteboard pasteboardWithUniqueName];
1966 ns_string_to_pasteboard (pb, send);
1968 if (NSPerformService (svcName, pb) == NO)
1969 Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
1971 if ([[pb types] count] == 0)
1972 return build_string ("");
1973 return ns_string_from_pasteboard (pb);
1977 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
1978 Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
1979 doc: /* Return an NFC string that matches the UTF-8 NFD string STR. */)
1983 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
1988 utfStr = [NSString stringWithUTF8String: SDATA (str)];
1989 if (![utfStr respondsToSelector:
1990 @selector (precomposedStringWithCanonicalMapping)])
1993 ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
1997 utfStr = [utfStr precomposedStringWithCanonicalMapping];
1998 return build_string ([utfStr UTF8String]);
2002 #ifdef NS_IMPL_COCOA
2004 /* Compile and execute the AppleScript SCRIPT and return the error
2005 status as function value. A zero is returned if compilation and
2006 execution is successful, in which case *RESULT is set to a Lisp
2007 string or a number containing the resulting script value. Otherwise,
2010 ns_do_applescript (script, result)
2011 Lisp_Object script, *result;
2013 NSAppleEventDescriptor *desc;
2014 NSDictionary* errorDict;
2015 NSAppleEventDescriptor* returnDescriptor = NULL;
2017 NSAppleScript* scriptObject =
2018 [[NSAppleScript alloc] initWithSource:
2019 [NSString stringWithUTF8String: SDATA (script)]];
2021 returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2022 [scriptObject release];
2026 if (returnDescriptor != NULL)
2028 // successful execution
2029 if (kAENullEvent != [returnDescriptor descriptorType])
2032 // script returned an AppleScript result
2033 if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2034 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
2035 (typeUTF16ExternalRepresentation
2036 == [returnDescriptor descriptorType]) ||
2038 (typeUTF8Text == [returnDescriptor descriptorType]) ||
2039 (typeCString == [returnDescriptor descriptorType]))
2041 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2043 *result = build_string([[desc stringValue] UTF8String]);
2047 /* use typeUTF16ExternalRepresentation? */
2048 // coerce the result to the appropriate ObjC type
2049 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2051 *result = make_number([desc int32Value]);
2057 // no script result, return error
2063 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2064 doc: /* Execute AppleScript SCRIPT and return the result.
2065 If compilation and execution are successful, the resulting script value
2066 is returned as a string, a number or, in the case of other constructs, t.
2067 In case the execution fails, an error is signaled. */)
2074 CHECK_STRING (script);
2078 status = ns_do_applescript (script, &result);
2082 else if (!STRINGP (result))
2083 error ("AppleScript error %d", status);
2085 error ("%s", SDATA (result));
2091 /* ==========================================================================
2093 Miscellaneous functions not called through hooks
2095 ========================================================================== */
2098 /* called from image.c */
2100 check_x_frame (Lisp_Object frame)
2102 return check_ns_frame (frame);
2106 /* called from frame.c */
2107 struct ns_display_info *
2108 check_x_display_info (Lisp_Object frame)
2110 return check_ns_display_info (frame);
2115 x_set_scroll_bar_default_width (f)
2118 int wid = FRAME_COLUMN_WIDTH (f);
2119 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2120 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2125 /* terms impl this instead of x-get-resource directly */
2127 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2129 /* remove appname prefix; TODO: allow for !="Emacs" */
2130 char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2134 if (inhibit_x_resources)
2135 /* --quick was passed, so this is a no-op. */
2138 res = [[[NSUserDefaults standardUserDefaults] objectForKey:
2139 [NSString stringWithUTF8String: toCheck]] UTF8String];
2140 return !res ? NULL :
2141 (!strncasecmp (res, "YES", 3) ? "true" :
2142 (!strncasecmp (res, "NO", 2) ? "false" : res));
2147 x_get_focus_frame (struct frame *frame)
2149 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2150 Lisp_Object nsfocus;
2152 if (!dpyinfo->x_focus_frame)
2155 XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2161 x_pixel_width (struct frame *f)
2163 return FRAME_PIXEL_WIDTH (f);
2168 x_pixel_height (struct frame *f)
2170 return FRAME_PIXEL_HEIGHT (f);
2175 x_char_width (struct frame *f)
2177 return FRAME_COLUMN_WIDTH (f);
2182 x_char_height (struct frame *f)
2184 return FRAME_LINE_HEIGHT (f);
2189 x_screen_planes (struct frame *f)
2191 return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2196 x_sync (Lisp_Object frame)
2198 /* XXX Not implemented XXX */
2204 /* ==========================================================================
2206 Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2208 ========================================================================== */
2211 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2212 doc: /* Return t if the current Nextstep display supports the color COLOR.
2213 The optional argument FRAME is currently ignored. */)
2215 Lisp_Object color, frame;
2219 return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2223 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2224 doc: /* Internal function called by `color-values', which see. */)
2226 Lisp_Object color, frame;
2229 CGFloat red, green, blue, alpha;
2232 CHECK_STRING (color);
2234 if (ns_lisp_to_color (color, &col))
2237 [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2238 getRed: &red green: &green blue: &blue alpha: &alpha];
2239 return list3 (make_number (lrint (red*65280)),
2240 make_number (lrint (green*65280)),
2241 make_number (lrint (blue*65280)));
2245 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2246 doc: /* Return t if the Nextstep display supports color.
2247 The optional argument DISPLAY specifies which display to ask about.
2248 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2249 If omitted or nil, that stands for the selected frame's display. */)
2251 Lisp_Object display;
2253 NSWindowDepth depth;
2254 NSString *colorSpace;
2256 depth = [ns_get_screen (display) depth];
2257 colorSpace = NSColorSpaceFromDepth (depth);
2259 return [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2260 || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2265 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2266 Sx_display_grayscale_p, 0, 1, 0,
2267 doc: /* Return t if the Nextstep display supports shades of gray.
2268 Note that color displays do support shades of gray.
2269 The optional argument DISPLAY specifies which display to ask about.
2270 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2271 If omitted or nil, that stands for the selected frame's display. */)
2273 Lisp_Object display;
2275 NSWindowDepth depth;
2277 depth = [ns_get_screen (display) depth];
2279 return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2283 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2285 doc: /* Return the width in pixels of the Nextstep display DISPLAY.
2286 The optional argument DISPLAY specifies which display to ask about.
2287 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2288 If omitted or nil, that stands for the selected frame's display. */)
2290 Lisp_Object display;
2293 return make_number ((int) [ns_get_screen (display) frame].size.width);
2297 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2298 Sx_display_pixel_height, 0, 1, 0,
2299 doc: /* Return the height in pixels of the Nextstep display DISPLAY.
2300 The optional argument DISPLAY specifies which display to ask about.
2301 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2302 If omitted or nil, that stands for the selected frame's display. */)
2304 Lisp_Object display;
2307 return make_number ((int) [ns_get_screen (display) frame].size.height);
2311 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2312 Sns_display_usable_bounds, 0, 1, 0,
2313 doc: /* Return the bounds of the usable part of the screen.
2314 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2315 are the boundaries of the usable part of the screen, excluding areas
2316 reserved for the Mac menu, dock, and so forth.
2318 The screen queried corresponds to DISPLAY, which should be either a
2319 frame, a display name (a string), or terminal ID. If omitted or nil,
2320 that stands for the selected frame's display. */)
2322 Lisp_Object display;
2329 screen = ns_get_screen (display);
2333 vScreen = [screen visibleFrame];
2335 /* NS coordinate system is upside-down.
2336 Transform to screen-specific coordinates. */
2337 return list4 (make_number ((int) vScreen.origin.x),
2338 make_number ((int) [screen frame].size.height
2339 - vScreen.size.height - vScreen.origin.y),
2340 make_number ((int) vScreen.size.width),
2341 make_number ((int) vScreen.size.height));
2345 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2347 doc: /* Return the number of bitplanes of the Nextstep display DISPLAY.
2348 The optional argument DISPLAY specifies which display to ask about.
2349 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2350 If omitted or nil, that stands for the selected frame's display. */)
2352 Lisp_Object display;
2356 (NSBitsPerPixelFromDepth ([ns_get_screen (display) depth]));
2360 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2361 Sx_display_color_cells, 0, 1, 0,
2362 doc: /* Returns the number of color cells of the Nextstep display DISPLAY.
2363 The optional argument DISPLAY specifies which display to ask about.
2364 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2365 If omitted or nil, that stands for the selected frame's display. */)
2367 Lisp_Object display;
2370 struct ns_display_info *dpyinfo = check_ns_display_info (display);
2372 /* We force 24+ bit depths to 24-bit to prevent an overflow. */
2373 return make_number (1 << min (dpyinfo->n_planes, 24));
2377 /* Unused dummy def needed for compatibility. */
2378 Lisp_Object tip_frame;
2380 /* TODO: move to xdisp or similar */
2382 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
2384 Lisp_Object parms, dx, dy;
2386 int *root_x, *root_y;
2388 Lisp_Object left, top;
2389 EmacsView *view = FRAME_NS_VIEW (f);
2392 /* Start with user-specified or mouse position. */
2393 left = Fcdr (Fassq (Qleft, parms));
2394 if (INTEGERP (left))
2397 pt.x = last_mouse_motion_position.x;
2398 top = Fcdr (Fassq (Qtop, parms));
2402 pt.y = last_mouse_motion_position.y;
2404 /* Convert to screen coordinates */
2405 pt = [view convertPoint: pt toView: nil];
2406 pt = [[view window] convertBaseToScreen: pt];
2408 /* Ensure in bounds. (Note, screen origin = lower left.) */
2409 if (pt.x + XINT (dx) <= 0)
2410 *root_x = 0; /* Can happen for negative dx */
2411 else if (pt.x + XINT (dx) + width
2412 <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2413 /* It fits to the right of the pointer. */
2414 *root_x = pt.x + XINT (dx);
2415 else if (width + XINT (dx) <= pt.x)
2416 /* It fits to the left of the pointer. */
2417 *root_x = pt.x - width - XINT (dx);
2419 /* Put it left justified on the screen -- it ought to fit that way. */
2422 if (pt.y - XINT (dy) - height >= 0)
2423 /* It fits below the pointer. */
2424 *root_y = pt.y - height - XINT (dy);
2425 else if (pt.y + XINT (dy) + height
2426 <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2427 /* It fits above the pointer */
2428 *root_y = pt.y + XINT (dy);
2430 /* Put it on the top. */
2431 *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2435 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2436 doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2437 A tooltip window is a small window displaying a string.
2439 FRAME nil or omitted means use the selected frame.
2441 PARMS is an optional list of frame parameters which can be used to
2442 change the tooltip's appearance.
2444 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
2445 means use the default timeout of 5 seconds.
2447 If the list of frame parameters PARMS contains a `left' parameter,
2448 the tooltip is displayed at that x-position. Otherwise it is
2449 displayed at the mouse position, with offset DX added (default is 5 if
2450 DX isn't specified). Likewise for the y-position; if a `top' frame
2451 parameter is specified, it determines the y-position of the tooltip
2452 window, otherwise it is displayed at the mouse position, with offset
2453 DY added (default is -10).
2455 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2456 Text larger than the specified size is clipped. */)
2457 (string, frame, parms, timeout, dx, dy)
2458 Lisp_Object string, frame, parms, timeout, dx, dy;
2461 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2462 int count = SPECPDL_INDEX ();
2467 specbind (Qinhibit_redisplay, Qt);
2469 GCPRO4 (string, parms, frame, timeout);
2471 CHECK_STRING (string);
2472 str = SDATA (string);
2473 f = check_x_frame (frame);
2475 timeout = make_number (5);
2477 CHECK_NATNUM (timeout);
2480 dx = make_number (5);
2485 dy = make_number (-10);
2490 if (ns_tooltip == nil)
2491 ns_tooltip = [[EmacsTooltip alloc] init];
2495 [ns_tooltip setText: str];
2496 size = [ns_tooltip frame].size;
2498 /* Move the tooltip window where the mouse pointer is. Resize and
2500 compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2503 [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2507 return unbind_to (count, Qnil);
2511 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2512 doc: /* Hide the current tooltip window, if there is any.
2513 Value is t if tooltip was open, nil otherwise. */)
2516 if (ns_tooltip == nil || ![ns_tooltip isActive])
2523 /* ==========================================================================
2525 Class implementations
2527 ========================================================================== */
2530 @implementation EmacsSavePanel
2531 #ifdef NS_IMPL_COCOA
2532 /* --------------------------------------------------------------------------
2533 These are overridden to intercept on OS X: ending panel restarts NSApp
2534 event loop if it is stopped. Not sure if this is correct behavior,
2535 perhaps should check if running and if so send an appdefined.
2536 -------------------------------------------------------------------------- */
2537 - (void) ok: (id)sender
2543 - (void) cancel: (id)sender
2545 [super cancel: sender];
2552 @implementation EmacsOpenPanel
2553 #ifdef NS_IMPL_COCOA
2554 /* --------------------------------------------------------------------------
2555 These are overridden to intercept on OS X: ending panel restarts NSApp
2556 event loop if it is stopped. Not sure if this is correct behavior,
2557 perhaps should check if running and if so send an appdefined.
2558 -------------------------------------------------------------------------- */
2559 - (void) ok: (id)sender
2565 - (void) cancel: (id)sender
2567 [super cancel: sender];
2574 @implementation EmacsFileDelegate
2575 /* --------------------------------------------------------------------------
2576 Delegate methods for Open/Save panels
2577 -------------------------------------------------------------------------- */
2578 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2582 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2586 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2587 confirmed: (BOOL)okFlag
2596 /* ==========================================================================
2598 Lisp interface declaration
2600 ========================================================================== */
2608 Qfontsize = intern ("fontsize");
2609 staticpro (&Qfontsize);
2611 DEFVAR_LISP ("ns-icon-type-alist", &Vns_icon_type_alist,
2612 doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2613 If the title of a frame matches REGEXP, then IMAGE.tiff is
2614 selected as the image of the icon representing the frame when it's
2615 miniaturized. If an element is t, then Emacs tries to select an icon
2616 based on the filetype of the visited file.
2618 The images have to be installed in a folder called English.lproj in the
2619 Emacs folder. You have to restart Emacs after installing new icons.
2621 Example: Install an icon Gnus.tiff and execute the following code
2623 (setq ns-icon-type-alist
2624 (append ns-icon-type-alist
2625 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2628 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2629 be used as the image of the icon representing the frame. */);
2630 Vns_icon_type_alist = Fcons (Qt, Qnil);
2632 DEFVAR_LISP ("ns-version-string", &Vns_version_string,
2633 doc: /* Toolkit version for NS Windowing. */);
2634 Vns_version_string = ns_appkit_version_str ();
2636 defsubr (&Sns_read_file_name);
2637 defsubr (&Sns_get_resource);
2638 defsubr (&Sns_set_resource);
2639 defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2640 defsubr (&Sx_display_grayscale_p);
2641 defsubr (&Sns_font_name);
2642 defsubr (&Sns_list_colors);
2643 #ifdef NS_IMPL_COCOA
2644 defsubr (&Sns_do_applescript);
2646 defsubr (&Sxw_color_defined_p);
2647 defsubr (&Sxw_color_values);
2648 defsubr (&Sx_server_max_request_size);
2649 defsubr (&Sx_server_vendor);
2650 defsubr (&Sx_server_version);
2651 defsubr (&Sx_display_pixel_width);
2652 defsubr (&Sx_display_pixel_height);
2653 defsubr (&Sns_display_usable_bounds);
2654 defsubr (&Sx_display_mm_width);
2655 defsubr (&Sx_display_mm_height);
2656 defsubr (&Sx_display_screens);
2657 defsubr (&Sx_display_planes);
2658 defsubr (&Sx_display_color_cells);
2659 defsubr (&Sx_display_visual_class);
2660 defsubr (&Sx_display_backing_store);
2661 defsubr (&Sx_display_save_under);
2662 defsubr (&Sx_create_frame);
2663 defsubr (&Sx_open_connection);
2664 defsubr (&Sx_close_connection);
2665 defsubr (&Sx_display_list);
2667 defsubr (&Sns_hide_others);
2668 defsubr (&Sns_hide_emacs);
2669 defsubr (&Sns_emacs_info_panel);
2670 defsubr (&Sns_list_services);
2671 defsubr (&Sns_perform_service);
2672 defsubr (&Sns_convert_utf8_nfd_to_nfc);
2673 defsubr (&Sx_focus_frame);
2674 defsubr (&Sns_popup_font_panel);
2675 defsubr (&Sns_popup_color_panel);
2677 defsubr (&Sx_show_tip);
2678 defsubr (&Sx_hide_tip);
2680 /* used only in fontset.c */
2681 check_window_system_func = check_ns;
2685 // arch-tag: dc2a3f74-1123-4daa-8eed-fb78db6a5642