1 /* Functions for the NeXT/Open/GNUstep and MacOSX window system.
3 Copyright (C) 1989, 1992-1994, 2005-2006, 2008-2013 Free Software
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
22 Originally by Carl Edman
23 Updated by Christian Limpach (chris@nice.ch)
24 OpenStep/Rhapsody port by Scott Bender (sbender@harmony-ds.com)
25 MacOSX/Aqua port by Christophe de Dinechin (descubes@earthlink.net)
26 GNUstep port and post-20 update by Adrian Robert (arobert@cogsci.ucsd.edu)
29 /* This should be the first include, as it may set up #defines affecting
30 interpretation of even the system includes. */
34 #include <c-strcase.h>
37 #include "blockinput.h"
40 #include "character.h"
43 #include "termhooks.h"
48 #include <IOKit/graphics/IOGraphicsLib.h>
49 #if MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_5
55 int fns_trace_num = 1;
56 #define NSTRACE(x) fprintf (stderr, "%s:%d: [%d] " #x "\n", \
57 __FILE__, __LINE__, ++fns_trace_num)
64 extern NSArray *ns_send_types, *ns_return_types, *ns_drag_types;
66 extern Lisp_Object Qforeground_color;
67 extern Lisp_Object Qbackground_color;
68 extern Lisp_Object Qcursor_color;
69 extern Lisp_Object Qinternal_border_width;
70 extern Lisp_Object Qvisibility;
71 extern Lisp_Object Qcursor_type;
72 extern Lisp_Object Qicon_type;
73 extern Lisp_Object Qicon_name;
74 extern Lisp_Object Qicon_left;
75 extern Lisp_Object Qicon_top;
76 extern Lisp_Object Qleft;
77 extern Lisp_Object Qright;
78 extern Lisp_Object Qtop;
79 extern Lisp_Object Qdisplay;
80 extern Lisp_Object Qvertical_scroll_bars;
81 extern Lisp_Object Qauto_raise;
82 extern Lisp_Object Qauto_lower;
83 extern Lisp_Object Qbox;
84 extern Lisp_Object Qscroll_bar_width;
85 extern Lisp_Object Qx_resource_name;
86 extern Lisp_Object Qface_set_after_frame_default;
87 extern Lisp_Object Qunderline, Qundefined;
88 extern Lisp_Object Qheight, Qminibuffer, Qname, Qonly, Qwidth;
89 extern Lisp_Object Qunsplittable, Qmenu_bar_lines, Qbuffer_predicate, Qtitle;
92 Lisp_Object Qbuffered;
93 Lisp_Object Qfontsize;
95 EmacsTooltip *ns_tooltip = nil;
97 /* Need forward declaration here to preserve organizational integrity of file */
98 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
100 /* Static variables to handle applescript execution. */
101 static Lisp_Object as_script, *as_result;
102 static int as_status;
105 static ptrdiff_t image_cache_refcount;
109 /* ==========================================================================
111 Internal utility functions
113 ========================================================================== */
115 /* Let the user specify a Nextstep display with a Lisp object.
116 OBJECT may be nil, a frame or a terminal object.
117 nil stands for the selected frame--or, if that is not a Nextstep frame,
118 the first Nextstep display on the list. */
120 static struct ns_display_info *
121 check_ns_display_info (Lisp_Object object)
123 struct ns_display_info *dpyinfo = NULL;
127 struct frame *sf = XFRAME (selected_frame);
129 if (FRAME_NS_P (sf) && FRAME_LIVE_P (sf))
130 dpyinfo = FRAME_DISPLAY_INFO (sf);
131 else if (x_display_list != 0)
132 dpyinfo = x_display_list;
134 error ("Nextstep windows are not in use or not initialized");
136 else if (TERMINALP (object))
138 struct terminal *t = get_terminal (object, 1);
140 if (t->type != output_ns)
141 error ("Terminal %d is not a Nextstep display", t->id);
143 dpyinfo = t->display_info.ns;
145 else if (STRINGP (object))
146 dpyinfo = ns_display_info_for_name (object);
149 struct frame *f = decode_window_system_frame (object);
150 dpyinfo = FRAME_DISPLAY_INFO (f);
158 ns_get_window (Lisp_Object maybeFrame)
160 id view =nil, window =nil;
162 if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
163 maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
165 if (!NILP (maybeFrame))
166 view = FRAME_NS_VIEW (XFRAME (maybeFrame));
167 if (view) window =[view window];
173 /* Return the X display structure for the display named NAME.
174 Open a new connection if necessary. */
175 struct ns_display_info *
176 ns_display_info_for_name (Lisp_Object name)
178 struct ns_display_info *dpyinfo;
182 for (dpyinfo = x_display_list; dpyinfo; dpyinfo = dpyinfo->next)
183 if (!NILP (Fstring_equal (XCAR (dpyinfo->name_list_element), name)))
186 error ("Emacs for OpenStep does not yet support multi-display.");
188 Fx_open_connection (name, Qnil, Qnil);
189 dpyinfo = x_display_list;
192 error ("OpenStep on %s not responding.\n", SDATA (name));
198 ns_filename_from_panel (NSSavePanel *panel)
200 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
201 NSURL *url = [panel URL];
202 NSString *str = [url path];
205 return [panel filename];
210 ns_directory_from_panel (NSSavePanel *panel)
212 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
213 NSURL *url = [panel directoryURL];
214 NSString *str = [url path];
217 return [panel directory];
222 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
223 /* --------------------------------------------------------------------------
224 Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
225 -------------------------------------------------------------------------- */
235 count = [menu numberOfItems];
236 for (i = 0; i<count; i++)
238 item = [menu itemAtIndex: i];
239 name = [[item title] UTF8String];
242 nameStr = build_string (name);
244 if ([item hasSubmenu])
246 old = interpret_services_menu ([item submenu],
247 Fcons (nameStr, prefix), old);
251 keys = [item keyEquivalent];
252 if (keys && [keys length] )
254 key = [keys characterAtIndex: 0];
255 res = make_number (key|super_modifier);
261 old = Fcons (Fcons (res,
262 Freverse (Fcons (nameStr,
272 /* ==========================================================================
274 Frame parameter setters
276 ========================================================================== */
280 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
283 EmacsCGFloat r, g, b, alpha;
285 if (ns_lisp_to_color (arg, &col))
287 store_frame_param (f, Qforeground_color, oldval);
288 error ("Unknown color");
292 [f->output_data.ns->foreground_color release];
293 f->output_data.ns->foreground_color = col;
295 [col getRed: &r green: &g blue: &b alpha: &alpha];
296 FRAME_FOREGROUND_PIXEL (f) =
297 ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
299 if (FRAME_NS_VIEW (f))
301 update_face_from_frame_parameter (f, Qforeground_color, arg);
302 /*recompute_basic_faces (f); */
303 if (FRAME_VISIBLE_P (f))
310 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
314 NSView *view = FRAME_NS_VIEW (f);
315 EmacsCGFloat r, g, b, alpha;
317 if (ns_lisp_to_color (arg, &col))
319 store_frame_param (f, Qbackground_color, oldval);
320 error ("Unknown color");
323 /* clear the frame; in some instances the NS-internal GC appears not to
324 update, or it does update and cannot clear old text properly */
325 if (FRAME_VISIBLE_P (f))
329 [f->output_data.ns->background_color release];
330 f->output_data.ns->background_color = col;
332 [col getRed: &r green: &g blue: &b alpha: &alpha];
333 FRAME_BACKGROUND_PIXEL (f) =
334 ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
338 [[view window] setBackgroundColor: col];
340 if (alpha != (EmacsCGFloat) 1.0)
341 [[view window] setOpaque: NO];
343 [[view window] setOpaque: YES];
345 face = FRAME_DEFAULT_FACE (f);
348 col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
349 face->background = ns_index_color
350 ([col colorWithAlphaComponent: alpha], f);
352 update_face_from_frame_parameter (f, Qbackground_color, arg);
355 if (FRAME_VISIBLE_P (f))
362 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
366 if (ns_lisp_to_color (arg, &col))
368 store_frame_param (f, Qcursor_color, oldval);
369 error ("Unknown color");
372 [FRAME_CURSOR_COLOR (f) release];
373 FRAME_CURSOR_COLOR (f) = [col retain];
375 if (FRAME_VISIBLE_P (f))
377 x_update_cursor (f, 0);
378 x_update_cursor (f, 1);
380 update_face_from_frame_parameter (f, Qcursor_color, arg);
385 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
387 NSView *view = FRAME_NS_VIEW (f);
388 NSTRACE (x_set_icon_name);
390 /* see if it's changed */
393 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
396 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
399 fset_icon_name (f, arg);
403 if (!NILP (f->title))
406 /* explicit name and no icon-name -> explicit_name */
407 if (f->explicit_name)
411 /* no explicit name and no icon-name ->
412 name has to be rebuild from icon_title_format */
413 windows_or_buffers_changed++;
418 /* Don't change the name if it's already NAME. */
419 if ([[view window] miniwindowTitle] &&
420 ([[[view window] miniwindowTitle]
421 isEqualToString: [NSString stringWithUTF8String:
425 [[view window] setMiniwindowTitle:
426 [NSString stringWithUTF8String: SSDATA (arg)]];
430 ns_set_name_internal (struct frame *f, Lisp_Object name)
433 Lisp_Object encoded_name, encoded_icon_name;
435 NSView *view = FRAME_NS_VIEW (f);
438 encoded_name = ENCODE_UTF_8 (name);
441 str = [NSString stringWithUTF8String: SSDATA (encoded_name)];
443 /* Don't change the name if it's already NAME. */
444 if (! [[[view window] title] isEqualToString: str])
445 [[view window] setTitle: str];
447 if (!STRINGP (f->icon_name))
448 encoded_icon_name = encoded_name;
450 encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
452 str = [NSString stringWithUTF8String: SSDATA (encoded_icon_name)];
454 if ([[view window] miniwindowTitle] &&
455 ! [[[view window] miniwindowTitle] isEqualToString: str])
456 [[view window] setMiniwindowTitle: str];
461 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
463 NSTRACE (ns_set_name);
465 /* Make sure that requests from lisp code override requests from
466 Emacs redisplay code. */
469 /* If we're switching from explicit to implicit, we had better
470 update the mode lines and thereby update the title. */
471 if (f->explicit_name && NILP (name))
472 update_mode_lines = 1;
474 f->explicit_name = ! NILP (name);
476 else if (f->explicit_name)
480 name = build_string([ns_app_name UTF8String]);
484 /* Don't change the name if it's already NAME. */
485 if (! NILP (Fstring_equal (name, f->name)))
490 /* title overrides explicit name */
491 if (! NILP (f->title))
494 ns_set_name_internal (f, name);
498 /* This function should be called when the user's lisp code has
499 specified a name for the frame; the name will override any set by the
502 x_explicitly_set_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
504 NSTRACE (x_explicitly_set_name);
505 ns_set_name (f, arg, 1);
509 /* This function should be called by Emacs redisplay code to set the
510 name; names set this way will never override names set by the user's
513 x_implicitly_set_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
515 NSTRACE (x_implicitly_set_name);
517 /* Deal with NS specific format t. */
518 if (FRAME_NS_P (f) && ((FRAME_ICONIFIED_P (f) && EQ (Vicon_title_format, Qt))
519 || EQ (Vframe_title_format, Qt)))
520 ns_set_name_as_filename (f);
522 ns_set_name (f, arg, 0);
526 /* Change the title of frame F to NAME.
527 If NAME is nil, use the frame name as the title. */
530 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
532 NSTRACE (x_set_title);
533 /* Don't change the title if it's already NAME. */
534 if (EQ (name, f->title))
537 update_mode_lines = 1;
539 fset_title (f, name);
546 ns_set_name_internal (f, name);
551 ns_set_name_as_filename (struct frame *f)
554 Lisp_Object name, filename;
555 Lisp_Object buf = XWINDOW (f->selected_window)->contents;
557 NSAutoreleasePool *pool;
559 Lisp_Object encoded_name, encoded_filename;
561 NSTRACE (ns_set_name_as_filename);
563 if (f->explicit_name || ! NILP (f->title))
567 pool = [[NSAutoreleasePool alloc] init];
568 filename = BVAR (XBUFFER (buf), filename);
569 name = BVAR (XBUFFER (buf), name);
573 if (! NILP (filename))
574 name = Ffile_name_nondirectory (filename);
576 name = build_string ([ns_app_name UTF8String]);
580 encoded_name = ENCODE_UTF_8 (name);
583 view = FRAME_NS_VIEW (f);
585 title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
586 : [[[view window] title] UTF8String];
588 if (title && (! strcmp (title, SSDATA (encoded_name))))
595 str = [NSString stringWithUTF8String: SSDATA (encoded_name)];
596 if (str == nil) str = @"Bad coding";
598 if (FRAME_ICONIFIED_P (f))
599 [[view window] setMiniwindowTitle: str];
604 if (! NILP (filename))
607 encoded_filename = ENCODE_UTF_8 (filename);
610 fstr = [NSString stringWithUTF8String: SSDATA (encoded_filename)];
611 if (fstr == nil) fstr = @"";
613 /* work around a bug observed on 10.3 and later where
614 setTitleWithRepresentedFilename does not clear out previous state
615 if given filename does not exist */
616 if (! [[NSFileManager defaultManager] fileExistsAtPath: fstr])
617 [[view window] setRepresentedFilename: @""];
623 [[view window] setRepresentedFilename: fstr];
624 [[view window] setTitle: str];
634 ns_set_doc_edited (struct frame *f, Lisp_Object arg)
636 NSView *view = FRAME_NS_VIEW (f);
637 NSAutoreleasePool *pool;
638 if (!MINI_WINDOW_P (XWINDOW (f->selected_window)))
641 pool = [[NSAutoreleasePool alloc] init];
642 [[view window] setDocumentEdited: !NILP (arg)];
650 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
653 if (FRAME_MINIBUF_ONLY_P (f))
656 if (TYPE_RANGED_INTEGERP (int, value))
657 nlines = XINT (value);
661 FRAME_MENU_BAR_LINES (f) = 0;
664 FRAME_EXTERNAL_MENU_BAR (f) = 1;
665 /* does for all frames, whereas we just want for one frame
666 [NSMenu setMenuBarVisible: YES]; */
670 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
671 free_frame_menubar (f);
672 /* [NSMenu setMenuBarVisible: NO]; */
673 FRAME_EXTERNAL_MENU_BAR (f) = 0;
678 /* toolbar support */
680 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
684 if (FRAME_MINIBUF_ONLY_P (f))
687 if (RANGED_INTEGERP (0, value, INT_MAX))
688 nlines = XFASTINT (value);
694 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
695 update_frame_tool_bar (f);
699 if (FRAME_EXTERNAL_TOOL_BAR (f))
701 free_frame_tool_bar (f);
702 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
706 x_set_window_size (f, 0, f->text_cols, f->text_lines);
711 ns_implicitly_set_icon_type (struct frame *f)
714 EmacsView *view = FRAME_NS_VIEW (f);
716 Lisp_Object chain, elt;
717 NSAutoreleasePool *pool;
720 NSTRACE (ns_implicitly_set_icon_type);
723 pool = [[NSAutoreleasePool alloc] init];
724 if (f->output_data.ns->miniimage
725 && [[NSString stringWithUTF8String: SSDATA (f->name)]
726 isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
733 tem = assq_no_quit (Qicon_type, f->param_alist);
734 if (CONSP (tem) && ! NILP (XCDR (tem)))
741 for (chain = Vns_icon_type_alist;
742 image == nil && CONSP (chain);
743 chain = XCDR (chain))
746 /* special case: 't' means go by file type */
747 if (SYMBOLP (elt) && EQ (elt, Qt) && SSDATA (f->name)[0] == '/')
750 = [NSString stringWithUTF8String: SSDATA (f->name)];
751 if ([[NSFileManager defaultManager] fileExistsAtPath: str])
752 image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
754 else if (CONSP (elt) &&
755 STRINGP (XCAR (elt)) &&
756 STRINGP (XCDR (elt)) &&
757 fast_string_match (XCAR (elt), f->name) >= 0)
759 image = [EmacsImage allocInitFromFile: XCDR (elt)];
761 image = [[NSImage imageNamed:
762 [NSString stringWithUTF8String:
763 SSDATA (XCDR (elt))]] retain];
769 image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
773 [f->output_data.ns->miniimage release];
774 f->output_data.ns->miniimage = image;
775 [view setMiniwindowImage: setMini];
782 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
784 EmacsView *view = FRAME_NS_VIEW (f);
788 NSTRACE (x_set_icon_type);
790 if (!NILP (arg) && SYMBOLP (arg))
792 arg =build_string (SSDATA (SYMBOL_NAME (arg)));
793 store_frame_param (f, Qicon_type, arg);
796 /* do it the implicit way */
799 ns_implicitly_set_icon_type (f);
805 image = [EmacsImage allocInitFromFile: arg];
807 image =[NSImage imageNamed: [NSString stringWithUTF8String:
812 image = [NSImage imageNamed: @"text"];
816 f->output_data.ns->miniimage = image;
817 [view setMiniwindowImage: setMini];
821 /* TODO: move to nsterm? */
823 ns_lisp_to_cursor_type (Lisp_Object arg)
826 if (XTYPE (arg) == Lisp_String)
828 else if (XTYPE (arg) == Lisp_Symbol)
829 str = SSDATA (SYMBOL_NAME (arg));
831 if (!strcmp (str, "box")) return FILLED_BOX_CURSOR;
832 if (!strcmp (str, "hollow")) return HOLLOW_BOX_CURSOR;
833 if (!strcmp (str, "hbar")) return HBAR_CURSOR;
834 if (!strcmp (str, "bar")) return BAR_CURSOR;
835 if (!strcmp (str, "no")) return NO_CURSOR;
841 ns_cursor_type_to_lisp (int arg)
845 case FILLED_BOX_CURSOR: return Qbox;
846 case HOLLOW_BOX_CURSOR: return intern ("hollow");
847 case HBAR_CURSOR: return intern ("hbar");
848 case BAR_CURSOR: return intern ("bar");
850 default: return intern ("no");
854 /* This is the same as the xfns.c definition. */
856 x_set_cursor_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
858 set_frame_cursor_types (f, arg);
861 /* called to set mouse pointer color, but all other terms use it to
862 initialize pointer types (and don't set the color ;) */
864 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
866 /* don't think we can do this on Nextstep */
871 #define Xstr(x) Str(x)
874 ns_appkit_version_str (void)
878 #ifdef NS_IMPL_GNUSTEP
879 sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
880 #elif defined (NS_IMPL_COCOA)
881 sprintf(tmp, "apple-appkit-%.2f", NSAppKitVersionNumber);
885 return build_string (tmp);
889 /* This is for use by x-server-version and collapses all version info we
890 have into a single int. For a better picture of the implementation
891 running, use ns_appkit_version_str.*/
893 ns_appkit_version_int (void)
895 #ifdef NS_IMPL_GNUSTEP
896 return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GUI_MINOR_VERSION;
897 #elif defined (NS_IMPL_COCOA)
898 return (int)NSAppKitVersionNumber;
905 x_icon (struct frame *f, Lisp_Object parms)
906 /* --------------------------------------------------------------------------
907 Strangely-named function to set icon position parameters in frame.
908 This is irrelevant under OS X, but might be needed under GNUstep,
909 depending on the window manager used. Note, this is not a standard
910 frame parameter-setter; it is called directly from x-create-frame.
911 -------------------------------------------------------------------------- */
913 Lisp_Object icon_x, icon_y;
914 struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
916 f->output_data.ns->icon_top = Qnil;
917 f->output_data.ns->icon_left = Qnil;
919 /* Set the position of the icon. */
920 icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
921 icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
922 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
924 CHECK_NUMBER (icon_x);
925 CHECK_NUMBER (icon_y);
926 f->output_data.ns->icon_top = icon_y;
927 f->output_data.ns->icon_left = icon_x;
929 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
930 error ("Both left and top icon corners of icon must be specified");
934 /* Note: see frame.c for template, also where generic functions are impl */
935 frame_parm_handler ns_frame_parm_handlers[] =
937 x_set_autoraise, /* generic OK */
938 x_set_autolower, /* generic OK */
939 x_set_background_color,
940 0, /* x_set_border_color, may be impossible under Nextstep */
941 0, /* x_set_border_width, may be impossible under Nextstep */
944 x_set_font, /* generic OK */
945 x_set_foreground_color,
948 x_set_internal_border_width, /* generic OK */
949 x_set_menu_bar_lines,
951 x_explicitly_set_name,
952 x_set_scroll_bar_width, /* generic OK */
954 x_set_unsplittable, /* generic OK */
955 x_set_vertical_scroll_bars, /* generic OK */
956 x_set_visibility, /* generic OK */
957 x_set_tool_bar_lines,
958 0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
959 0, /* x_set_scroll_bar_background, will ignore (not possible on NS) */
960 x_set_screen_gamma, /* generic OK */
961 x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
962 x_set_fringe_width, /* generic OK */
963 x_set_fringe_width, /* generic OK */
964 0, /* x_set_wait_for_wm, will ignore */
965 x_set_fullscreen, /* generic OK */
966 x_set_font_backend, /* generic OK */
968 0, /* x_set_sticky */
969 0, /* x_set_tool_bar_position */
973 /* Handler for signals raised during x_create_frame.
974 FRAME is the frame which is partially constructed. */
977 unwind_create_frame (Lisp_Object frame)
979 struct frame *f = XFRAME (frame);
981 /* If frame is already dead, nothing to do. This can happen if the
982 display is disconnected after the frame has become official, but
983 before x_create_frame removes the unwind protect. */
984 if (!FRAME_LIVE_P (f))
987 /* If frame is ``official'', nothing to do. */
988 if (NILP (Fmemq (frame, Vframe_list)))
990 #if defined GLYPH_DEBUG && defined ENABLE_CHECKING
991 struct ns_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
994 x_free_frame_resources (f);
998 /* Check that reference counts are indeed correct. */
999 eassert (dpyinfo->terminal->image_cache->refcount == image_cache_refcount);
1005 * Read geometry related parameters from preferences if not in PARMS.
1006 * Returns the union of parms and any preferences read.
1010 get_geometry_from_preferences (struct ns_display_info *dpyinfo,
1018 { "width", "Width", Qwidth },
1019 { "height", "Height", Qheight },
1020 { "left", "Left", Qleft },
1021 { "top", "Top", Qtop },
1025 for (i = 0; i < sizeof (r)/sizeof (r[0]); ++i)
1027 if (NILP (Fassq (r[i].tem, parms)))
1030 = x_get_arg (dpyinfo, parms, r[i].tem, r[i].val, r[i].cls,
1032 if (! EQ (value, Qunbound))
1033 parms = Fcons (Fcons (r[i].tem, value), parms);
1040 /* ==========================================================================
1044 ========================================================================== */
1046 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1048 doc: /* Make a new Nextstep window, called a "frame" in Emacs terms.
1049 Return an Emacs frame object.
1050 PARMS is an alist of frame parameters.
1051 If the parameters specify that the frame should not have a minibuffer,
1052 and do not specify a specific minibuffer window to use,
1053 then `default-minibuffer-frame' must be a frame whose minibuffer can
1054 be shared by the new frame.
1056 This function is an internal primitive--use `make-frame' instead. */)
1060 Lisp_Object frame, tem;
1062 int minibuffer_only = 0;
1063 long window_prompting = 0;
1065 ptrdiff_t count = specpdl_ptr - specpdl;
1066 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1067 Lisp_Object display;
1068 struct ns_display_info *dpyinfo = NULL;
1071 static int desc_ctr = 1;
1073 /* x_get_arg modifies parms. */
1074 parms = Fcopy_alist (parms);
1076 /* Use this general default value to start with
1077 until we know if this frame has a specified name. */
1078 Vx_resource_name = Vinvocation_name;
1080 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1081 if (EQ (display, Qunbound))
1083 dpyinfo = check_ns_display_info (display);
1084 kb = dpyinfo->terminal->kboard;
1086 if (!dpyinfo->terminal->name)
1087 error ("Terminal is not live, can't create new frames on it");
1089 name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1091 && ! EQ (name, Qunbound)
1093 error ("Invalid frame name--not a string or nil");
1096 Vx_resource_name = name;
1098 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);
1104 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
1105 /* No need to protect DISPLAY because that's not used after passing
1106 it to make_frame_without_minibuffer. */
1108 GCPRO4 (parms, parent, name, frame);
1109 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1111 if (EQ (tem, Qnone) || NILP (tem))
1112 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))
1119 f = make_frame_without_minibuffer (tem, kb, display);
1123 XSETFRAME (frame, f);
1125 f->terminal = dpyinfo->terminal;
1127 f->output_method = output_ns;
1128 f->output_data.ns = xzalloc (sizeof *f->output_data.ns);
1130 FRAME_FONTSET (f) = -1;
1132 fset_icon_name (f, x_get_arg (dpyinfo, parms, Qicon_name,
1133 "iconName", "Title",
1135 if (! STRINGP (f->icon_name))
1136 fset_icon_name (f, Qnil);
1138 FRAME_DISPLAY_INFO (f) = dpyinfo;
1140 /* With FRAME_DISPLAY_INFO set up, this unwind-protect is safe. */
1141 record_unwind_protect (unwind_create_frame, frame);
1143 f->output_data.ns->window_desc = desc_ctr++;
1144 if (TYPE_RANGED_INTEGERP (Window, parent))
1146 f->output_data.ns->parent_desc = XFASTINT (parent);
1147 f->output_data.ns->explicit_parent = 1;
1151 f->output_data.ns->parent_desc = FRAME_DISPLAY_INFO (f)->root_window;
1152 f->output_data.ns->explicit_parent = 0;
1155 /* Set the name; the functions to which we pass f expect the name to
1157 if (EQ (name, Qunbound) || NILP (name) || ! STRINGP (name))
1159 fset_name (f, build_string ([ns_app_name UTF8String]));
1160 f->explicit_name = 0;
1164 fset_name (f, name);
1165 f->explicit_name = 1;
1166 specbind (Qx_resource_name, name);
1171 #ifdef NS_IMPL_COCOA
1172 #if MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_5
1173 if (CTGetCoreTextVersion != NULL
1174 && CTGetCoreTextVersion () >= kCTVersionNumber10_5)
1175 mac_register_font_driver (f);
1178 register_font_driver (&nsfont_driver, f);
1180 x_default_parameter (f, parms, Qfont_backend, Qnil,
1181 "fontBackend", "FontBackend", RES_TYPE_STRING);
1184 /* use for default font name */
1185 id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1186 x_default_parameter (f, parms, Qfontsize,
1187 make_number (0 /*(int)[font pointSize]*/),
1188 "fontSize", "FontSize", RES_TYPE_NUMBER);
1189 // Remove ' Regular', not handled by backends.
1190 char *fontname = xstrdup ([[font displayName] UTF8String]);
1191 int len = strlen (fontname);
1192 if (len > 8 && strcmp (fontname + len - 8, " Regular") == 0)
1193 fontname[len-8] = '\0';
1194 x_default_parameter (f, parms, Qfont,
1195 build_string (fontname),
1196 "font", "Font", RES_TYPE_STRING);
1200 x_default_parameter (f, parms, Qborder_width, make_number (0),
1201 "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1202 x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1203 "internalBorderWidth", "InternalBorderWidth",
1206 /* default scrollbars on right on Mac */
1209 #ifdef NS_IMPL_GNUSTEP
1214 x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1215 "verticalScrollBars", "VerticalScrollBars",
1218 x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1219 "foreground", "Foreground", RES_TYPE_STRING);
1220 x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1221 "background", "Background", RES_TYPE_STRING);
1222 /* FIXME: not supported yet in Nextstep */
1223 x_default_parameter (f, parms, Qline_spacing, Qnil,
1224 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1225 x_default_parameter (f, parms, Qleft_fringe, Qnil,
1226 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1227 x_default_parameter (f, parms, Qright_fringe, Qnil,
1228 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1231 image_cache_refcount =
1232 FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
1235 init_frame_faces (f);
1237 /* The resources controlling the menu-bar and tool-bar are
1238 processed specially at startup, and reflected in the mode
1239 variables; ignore them here. */
1240 x_default_parameter (f, parms, Qmenu_bar_lines,
1241 NILP (Vmenu_bar_mode)
1242 ? make_number (0) : make_number (1),
1243 NULL, NULL, RES_TYPE_NUMBER);
1244 x_default_parameter (f, parms, Qtool_bar_lines,
1245 NILP (Vtool_bar_mode)
1246 ? make_number (0) : make_number (1),
1247 NULL, NULL, RES_TYPE_NUMBER);
1249 x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1250 "BufferPredicate", RES_TYPE_SYMBOL);
1251 x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1254 parms = get_geometry_from_preferences (dpyinfo, parms);
1255 window_prompting = x_figure_window_size (f, parms, 1);
1257 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1258 f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1260 /* NOTE: on other terms, this is done in set_mouse_color, however this
1261 was not getting called under Nextstep */
1262 f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1263 f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1264 f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1265 f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1266 f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1267 f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1268 FRAME_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1269 = [NSCursor arrowCursor];
1270 f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1272 [[EmacsView alloc] initFrameFromEmacs: f];
1276 /* ns_display_info does not have a reference_count. */
1277 f->terminal->reference_count++;
1279 /* It is now ok to make the frame official even if we get an error below.
1280 The frame needs to be on Vframe_list or making it visible won't work. */
1281 Vframe_list = Fcons (frame, Vframe_list);
1283 x_default_parameter (f, parms, Qicon_type, Qnil,
1284 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
1286 x_default_parameter (f, parms, Qauto_raise, Qnil,
1287 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
1288 x_default_parameter (f, parms, Qauto_lower, Qnil,
1289 "autoLower", "AutoLower", RES_TYPE_BOOLEAN);
1290 x_default_parameter (f, parms, Qcursor_type, Qbox,
1291 "cursorType", "CursorType", RES_TYPE_SYMBOL);
1292 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
1293 "scrollBarWidth", "ScrollBarWidth",
1295 x_default_parameter (f, parms, Qalpha, Qnil,
1296 "alpha", "Alpha", RES_TYPE_NUMBER);
1297 x_default_parameter (f, parms, Qfullscreen, Qnil,
1298 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
1300 width = FRAME_COLS (f);
1301 height = FRAME_LINES (f);
1303 SET_FRAME_COLS (f, 0);
1304 FRAME_LINES (f) = 0;
1305 change_frame_size (f, height, width, 1, 0, 0);
1307 if (! f->output_data.ns->explicit_parent)
1309 Lisp_Object visibility;
1311 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
1313 if (EQ (visibility, Qunbound))
1316 if (EQ (visibility, Qicon))
1317 x_iconify_frame (f);
1318 else if (! NILP (visibility))
1320 x_make_frame_visible (f);
1321 [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1325 /* Must have been Qnil. */
1329 if (FRAME_HAS_MINIBUF_P (f)
1330 && (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
1331 || !FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame)))))
1332 kset_default_minibuffer_frame (kb, frame);
1334 /* All remaining specified parameters, which have not been "used"
1335 by x_get_arg and friends, now go in the misc. alist of the frame. */
1336 for (tem = parms; CONSP (tem); tem = XCDR (tem))
1337 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1338 fset_param_alist (f, Fcons (XCAR (tem), f->param_alist));
1342 if (window_prompting & USPosition)
1343 x_set_offset (f, f->left_pos, f->top_pos, 1);
1345 /* Make sure windows on this frame appear in calls to next-window
1346 and similar functions. */
1347 Vwindow_list = Qnil;
1349 return unbind_to (count, frame);
1353 x_focus_frame (struct frame *f)
1355 struct ns_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
1357 if (dpyinfo->x_focus_frame != f)
1359 EmacsView *view = FRAME_NS_VIEW (f);
1361 [NSApp activateIgnoringOtherApps: YES];
1362 [[view window] makeKeyAndOrderFront: view];
1368 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1370 doc: /* Pop up the font panel. */)
1373 struct frame *f = decode_window_system_frame (frame);
1374 id fm = [NSFontManager sharedFontManager];
1375 struct font *font = f->output_data.ns->font;
1377 if (EQ (font->driver->type, Qns))
1378 nsfont = ((struct nsfont_info *)font)->nsfont;
1379 #if MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_5
1381 nsfont = (NSFont *) macfont_get_nsctfont (font);
1383 [fm setSelectedFont: nsfont isMultiple: NO];
1384 [fm orderFrontFontPanel: NSApp];
1389 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1391 doc: /* Pop up the color panel. */)
1394 check_window_system (NULL);
1395 [NSApp orderFrontColorPanel: NSApp];
1403 #if ! defined (NS_IMPL_COCOA) || \
1404 MAC_OS_X_VERSION_MAX_ALLOWED < MAC_OS_X_VERSION_10_6
1405 NSString *dirS, *initS;
1411 ns_run_file_dialog (void)
1413 if (ns_fd_data.panel == nil) return;
1414 #if defined (NS_IMPL_COCOA) && \
1415 MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
1416 ns_fd_data.ret = [ns_fd_data.panel runModal];
1418 if (ns_fd_data.no_types)
1420 ns_fd_data.ret = [ns_fd_data.panel
1421 runModalForDirectory: ns_fd_data.dirS
1422 file: ns_fd_data.initS];
1426 ns_fd_data.ret = [ns_fd_data.panel
1427 runModalForDirectory: ns_fd_data.dirS
1428 file: ns_fd_data.initS
1432 ns_fd_data.panel = nil;
1435 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 5, 0,
1436 doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1437 Optional arg DIR, if non-nil, supplies a default directory.
1438 Optional arg MUSTMATCH, if non-nil, means the returned file or
1439 directory must exist.
1440 Optional arg INIT, if non-nil, provides a default file name to use.
1441 Optional arg DIR_ONLY_P, if non-nil, means choose only directories. */)
1442 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object mustmatch,
1443 Lisp_Object init, Lisp_Object dir_only_p)
1445 static id fileDelegate = nil;
1447 BOOL isSave = NILP (mustmatch) && NILP (dir_only_p);
1451 NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1452 [NSString stringWithUTF8String: SSDATA (prompt)];
1453 NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1454 [NSString stringWithUTF8String: SSDATA (BVAR (current_buffer, directory))] :
1455 [NSString stringWithUTF8String: SSDATA (dir)];
1456 NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1457 [NSString stringWithUTF8String: SSDATA (init)];
1460 check_window_system (NULL);
1462 if (fileDelegate == nil)
1463 fileDelegate = [EmacsFileDelegate new];
1465 [NSCursor setHiddenUntilMouseMoves: NO];
1467 if ([dirS characterAtIndex: 0] == '~')
1468 dirS = [dirS stringByExpandingTildeInPath];
1471 (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1473 [panel setTitle: promptS];
1475 [panel setAllowsOtherFileTypes: YES];
1476 [panel setTreatsFilePackagesAsDirectories: YES];
1477 [panel setDelegate: fileDelegate];
1479 if (! NILP (dir_only_p))
1481 [panel setCanChooseDirectories: YES];
1482 [panel setCanChooseFiles: NO];
1486 /* This is not quite what the documentation says, but it is compatible
1487 with the Gtk+ code. Also, the menu entry says "Open File...". */
1488 [panel setCanChooseDirectories: NO];
1489 [panel setCanChooseFiles: YES];
1493 ns_fd_data.panel = panel;
1494 ns_fd_data.ret = NO;
1495 #if defined (NS_IMPL_COCOA) && \
1496 MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
1497 if (! NILP (mustmatch) || ! NILP (dir_only_p))
1498 [panel setAllowedFileTypes: nil];
1499 if (dirS) [panel setDirectoryURL: [NSURL fileURLWithPath: dirS]];
1500 if (initS && NILP (Ffile_directory_p (init)))
1501 [panel setNameFieldStringValue: [initS lastPathComponent]];
1503 [panel setNameFieldStringValue: @""];
1506 ns_fd_data.no_types = NILP (mustmatch) && NILP (dir_only_p);
1507 ns_fd_data.dirS = dirS;
1508 ns_fd_data.initS = initS;
1511 /* runModalForDirectory/runModal restarts the main event loop when done,
1512 so we must start an event loop and then pop up the file dialog.
1513 The file dialog may pop up a confirm dialog after Ok has been pressed,
1514 so we can not simply pop down on the Ok/Cancel press.
1516 nxev = [NSEvent otherEventWithType: NSApplicationDefined
1517 location: NSMakePoint (0, 0)
1520 windowNumber: [[NSApp mainWindow] windowNumber]
1521 context: [NSApp context]
1524 data2: NSAPP_DATA2_RUNFILEDIALOG];
1526 [NSApp postEvent: nxev atStart: NO];
1527 while (ns_fd_data.panel != nil)
1530 ret = (ns_fd_data.ret == NSOKButton);
1534 NSString *str = ns_filename_from_panel (panel);
1535 if (! str) str = ns_directory_from_panel (panel);
1536 if (! str) ret = NO;
1537 else fname = build_string ([str UTF8String]);
1540 [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1543 return ret ? fname : Qnil;
1547 ns_get_defaults_value (const char *key)
1549 NSObject *obj = [[NSUserDefaults standardUserDefaults]
1550 objectForKey: [NSString stringWithUTF8String: key]];
1552 if (!obj) return NULL;
1554 return [[NSString stringWithFormat: @"%@", obj] UTF8String];
1558 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1559 doc: /* Return the value of the property NAME of OWNER from the defaults database.
1560 If OWNER is nil, Emacs is assumed. */)
1561 (Lisp_Object owner, Lisp_Object name)
1565 check_window_system (NULL);
1567 owner = build_string([ns_app_name UTF8String]);
1568 CHECK_STRING (name);
1570 value = ns_get_defaults_value (SSDATA (name));
1573 return build_string (value);
1578 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1579 doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1580 If OWNER is nil, Emacs is assumed.
1581 If VALUE is nil, the default is removed. */)
1582 (Lisp_Object owner, Lisp_Object name, Lisp_Object value)
1584 check_window_system (NULL);
1586 owner = build_string ([ns_app_name UTF8String]);
1587 CHECK_STRING (name);
1590 [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1591 [NSString stringWithUTF8String: SSDATA (name)]];
1595 CHECK_STRING (value);
1596 [[NSUserDefaults standardUserDefaults] setObject:
1597 [NSString stringWithUTF8String: SSDATA (value)]
1598 forKey: [NSString stringWithUTF8String:
1606 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1607 Sx_server_max_request_size,
1609 doc: /* This function is a no-op. It is only present for completeness. */)
1610 (Lisp_Object terminal)
1612 check_ns_display_info (terminal);
1613 /* This function has no real equivalent under NeXTstep. Return nil to
1619 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1620 doc: /* Return the "vendor ID" string of Nextstep display server TERMINAL.
1621 \(Labeling every distributor as a "vendor" embodies the false assumption
1622 that operating systems cannot be developed and distributed noncommercially.)
1623 The optional argument TERMINAL specifies which display to ask about.
1624 TERMINAL should be a terminal object, a frame or a display name (a string).
1625 If omitted or nil, that stands for the selected frame's display. */)
1626 (Lisp_Object terminal)
1628 check_ns_display_info (terminal);
1629 #ifdef NS_IMPL_GNUSTEP
1630 return build_string ("GNU");
1632 return build_string ("Apple");
1637 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1638 doc: /* Return the version numbers of the server of display TERMINAL.
1639 The value is a list of three integers: the major and minor
1640 version numbers of the X Protocol in use, and the distributor-specific release
1641 number. See also the function `x-server-vendor'.
1643 The optional argument TERMINAL specifies which display to ask about.
1644 TERMINAL should be a terminal object, a frame or a display name (a string).
1645 If omitted or nil, that stands for the selected frame's display. */)
1646 (Lisp_Object terminal)
1648 check_ns_display_info (terminal);
1649 /*NOTE: it is unclear what would best correspond with "protocol";
1650 we return 10.3, meaning Panther, since this is roughly the
1651 level that GNUstep's APIs correspond to.
1652 The last number is where we distinguish between the Apple
1653 and GNUstep implementations ("distributor-specific release
1654 number") and give int'ized versions of major.minor. */
1655 return list3i (10, 3, ns_appkit_version_int ());
1659 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1660 doc: /* Return the number of screens on Nextstep display server TERMINAL.
1661 The optional argument TERMINAL specifies which display to ask about.
1662 TERMINAL should be a terminal object, a frame or a display name (a string).
1663 If omitted or nil, that stands for the selected frame's display.
1665 Note: "screen" here is not in Nextstep terminology but in X11's. For
1666 the number of physical monitors, use `(length
1667 (display-monitor-attributes-list TERMINAL))' instead. */)
1668 (Lisp_Object terminal)
1670 check_ns_display_info (terminal);
1671 return make_number (1);
1675 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
1676 doc: /* Return the height in millimeters of the Nextstep display TERMINAL.
1677 The optional argument TERMINAL specifies which display to ask about.
1678 TERMINAL should be a terminal object, a frame or a display name (a string).
1679 If omitted or nil, that stands for the selected frame's display.
1681 On \"multi-monitor\" setups this refers to the height in millimeters for
1682 all physical monitors associated with TERMINAL. To get information
1683 for each physical monitor, use `display-monitor-attributes-list'. */)
1684 (Lisp_Object terminal)
1686 struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
1688 return make_number (x_display_pixel_height (dpyinfo) / (92.0/25.4));
1692 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
1693 doc: /* Return the width in millimeters of the Nextstep display TERMINAL.
1694 The optional argument TERMINAL specifies which display to ask about.
1695 TERMINAL should be a terminal object, a frame or a display name (a string).
1696 If omitted or nil, that stands for the selected frame's display.
1698 On \"multi-monitor\" setups this refers to the width in millimeters for
1699 all physical monitors associated with TERMINAL. To get information
1700 for each physical monitor, use `display-monitor-attributes-list'. */)
1701 (Lisp_Object terminal)
1703 struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
1705 return make_number (x_display_pixel_width (dpyinfo) / (92.0/25.4));
1709 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1710 Sx_display_backing_store, 0, 1, 0,
1711 doc: /* Return an indication of whether the Nextstep display TERMINAL does backing store.
1712 The value may be `buffered', `retained', or `non-retained'.
1713 The optional argument TERMINAL specifies which display to ask about.
1714 TERMINAL should be a terminal object, a frame or a display name (a string).
1715 If omitted or nil, that stands for the selected frame's display. */)
1716 (Lisp_Object terminal)
1718 check_ns_display_info (terminal);
1719 switch ([ns_get_window (terminal) backingType])
1721 case NSBackingStoreBuffered:
1722 return intern ("buffered");
1723 case NSBackingStoreRetained:
1724 return intern ("retained");
1725 case NSBackingStoreNonretained:
1726 return intern ("non-retained");
1728 error ("Strange value for backingType parameter of frame");
1730 return Qnil; /* not reached, shut compiler up */
1734 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1735 Sx_display_visual_class, 0, 1, 0,
1736 doc: /* Return the visual class of the Nextstep display TERMINAL.
1737 The value is one of the symbols `static-gray', `gray-scale',
1738 `static-color', `pseudo-color', `true-color', or `direct-color'.
1740 The optional argument TERMINAL specifies which display to ask about.
1741 TERMINAL should a terminal object, a frame or a display name (a string).
1742 If omitted or nil, that stands for the selected frame's display. */)
1743 (Lisp_Object terminal)
1745 NSWindowDepth depth;
1747 check_ns_display_info (terminal);
1748 depth = [[[NSScreen screens] objectAtIndex:0] depth];
1750 if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1751 return intern ("static-gray");
1752 else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1753 return intern ("gray-scale");
1754 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1755 return intern ("pseudo-color");
1756 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1757 return intern ("true-color");
1758 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1759 return intern ("direct-color");
1761 /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1762 return intern ("direct-color");
1766 DEFUN ("x-display-save-under", Fx_display_save_under,
1767 Sx_display_save_under, 0, 1, 0,
1768 doc: /* Return t if TERMINAL supports the save-under feature.
1769 The optional argument TERMINAL specifies which display to ask about.
1770 TERMINAL should be a terminal object, a frame or a display name (a string).
1771 If omitted or nil, that stands for the selected frame's display. */)
1772 (Lisp_Object terminal)
1774 check_ns_display_info (terminal);
1775 switch ([ns_get_window (terminal) backingType])
1777 case NSBackingStoreBuffered:
1780 case NSBackingStoreRetained:
1781 case NSBackingStoreNonretained:
1785 error ("Strange value for backingType parameter of frame");
1787 return Qnil; /* not reached, shut compiler up */
1791 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1793 doc: /* Open a connection to a display server.
1794 DISPLAY is the name of the display to connect to.
1795 Optional second arg XRM-STRING is a string of resources in xrdb format.
1796 If the optional third arg MUST-SUCCEED is non-nil,
1797 terminate Emacs if we can't open the connection.
1798 \(In the Nextstep version, the last two arguments are currently ignored.) */)
1799 (Lisp_Object display, Lisp_Object resource_string, Lisp_Object must_succeed)
1801 struct ns_display_info *dpyinfo;
1803 CHECK_STRING (display);
1805 nxatoms_of_nsselect ();
1806 dpyinfo = ns_term_init (display);
1809 if (!NILP (must_succeed))
1810 fatal ("OpenStep on %s not responding.\n",
1813 error ("OpenStep on %s not responding.\n",
1821 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1823 doc: /* Close the connection to TERMINAL's Nextstep display server.
1824 For TERMINAL, specify a terminal object, a frame or a display name (a
1825 string). If TERMINAL is nil, that stands for the selected frame's
1827 (Lisp_Object terminal)
1829 check_ns_display_info (terminal);
1830 [NSApp terminate: NSApp];
1835 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1836 doc: /* Return the list of display names that Emacs has connections to. */)
1839 Lisp_Object result = Qnil;
1840 struct ns_display_info *ndi;
1842 for (ndi = x_display_list; ndi; ndi = ndi->next)
1843 result = Fcons (XCAR (ndi->name_list_element), result);
1849 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1851 doc: /* Hides all applications other than Emacs. */)
1854 check_window_system (NULL);
1855 [NSApp hideOtherApplications: NSApp];
1859 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1861 doc: /* If ON is non-nil, the entire Emacs application is hidden.
1862 Otherwise if Emacs is hidden, it is unhidden.
1863 If ON is equal to `activate', Emacs is unhidden and becomes
1864 the active application. */)
1867 check_window_system (NULL);
1868 if (EQ (on, intern ("activate")))
1870 [NSApp unhide: NSApp];
1871 [NSApp activateIgnoringOtherApps: YES];
1874 [NSApp unhide: NSApp];
1876 [NSApp hide: NSApp];
1881 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1883 doc: /* Shows the 'Info' or 'About' panel for Emacs. */)
1886 check_window_system (NULL);
1887 [NSApp orderFrontStandardAboutPanel: nil];
1892 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1893 doc: /* Determine font PostScript or family name for font NAME.
1894 NAME should be a string containing either the font name or an XLFD
1895 font descriptor. If string contains `fontset' and not
1896 `fontset-startup', it is left alone. */)
1900 CHECK_STRING (name);
1905 if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1908 return build_string (ns_xlfd_to_fontname (SSDATA (name)));
1912 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1913 doc: /* Return a list of all available colors.
1914 The optional argument FRAME is currently ignored. */)
1917 Lisp_Object list = Qnil;
1918 NSEnumerator *colorlists;
1923 CHECK_FRAME (frame);
1924 if (! FRAME_NS_P (XFRAME (frame)))
1925 error ("non-Nextstep frame used in `ns-list-colors'");
1930 colorlists = [[NSColorList availableColorLists] objectEnumerator];
1931 while ((clist = [colorlists nextObject]))
1933 if ([[clist name] length] < 7 ||
1934 [[clist name] rangeOfString: @"PANTONE"].location == 0)
1936 NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1938 while ((cname = [cnames nextObject]))
1939 list = Fcons (build_string ([cname UTF8String]), list);
1940 /* for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1941 list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1942 UTF8String]), list); */
1952 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1953 doc: /* List available Nextstep services by querying NSApp. */)
1956 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
1957 /* You can't get services like this in 10.6+. */
1960 Lisp_Object ret = Qnil;
1962 #ifdef NS_IMPL_COCOA
1966 check_window_system (NULL);
1967 svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1968 [NSApp setServicesMenu: svcs];
1969 [NSApp registerServicesMenuSendTypes: ns_send_types
1970 returnTypes: ns_return_types];
1972 /* On Tiger, services menu updating was made lazier (waits for user to
1973 actually click on the menu), so we have to force things along: */
1974 #ifdef NS_IMPL_COCOA
1975 delegate = [svcs delegate];
1976 if (delegate != nil)
1978 if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1979 [delegate menuNeedsUpdate: svcs];
1980 if ([delegate respondsToSelector:
1981 @selector (menu:updateItem:atIndex:shouldCancel:)])
1983 int i, len = [delegate numberOfItemsInMenu: svcs];
1984 for (i =0; i<len; i++)
1985 [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1986 for (i =0; i<len; i++)
1987 if (![delegate menu: svcs
1988 updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1989 atIndex: i shouldCancel: NO])
1995 [svcs setAutoenablesItems: NO];
1996 #ifdef NS_IMPL_COCOA
1997 [svcs update]; /* on OS X, converts from '/' structure */
2000 ret = interpret_services_menu (svcs, Qnil, ret);
2006 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
2008 doc: /* Perform Nextstep SERVICE on SEND.
2009 SEND should be either a string or nil.
2010 The return value is the result of the service, as string, or nil if
2011 there was no result. */)
2012 (Lisp_Object service, Lisp_Object send)
2018 CHECK_STRING (service);
2019 check_window_system (NULL);
2021 utfStr = SSDATA (service);
2022 svcName = [NSString stringWithUTF8String: utfStr];
2024 pb =[NSPasteboard pasteboardWithUniqueName];
2025 ns_string_to_pasteboard (pb, send);
2027 if (NSPerformService (svcName, pb) == NO)
2028 Fsignal (Qquit, list1 (build_string ("service not available")));
2030 if ([[pb types] count] == 0)
2031 return build_string ("");
2032 return ns_string_from_pasteboard (pb);
2036 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
2037 Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
2038 doc: /* Return an NFC string that matches the UTF-8 NFD string STR. */)
2041 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
2044 Lisp_Object ret = Qnil;
2045 NSAutoreleasePool *pool;
2048 pool = [[NSAutoreleasePool alloc] init];
2049 utfStr = [NSString stringWithUTF8String: SSDATA (str)];
2050 #ifdef NS_IMPL_COCOA
2052 utfStr = [utfStr precomposedStringWithCanonicalMapping];
2056 const char *cstr = [utfStr UTF8String];
2058 ret = build_string (cstr);
2063 error ("Invalid UTF-8");
2069 #ifdef NS_IMPL_COCOA
2071 /* Compile and execute the AppleScript SCRIPT and return the error
2072 status as function value. A zero is returned if compilation and
2073 execution is successful, in which case *RESULT is set to a Lisp
2074 string or a number containing the resulting script value. Otherwise,
2077 ns_do_applescript (Lisp_Object script, Lisp_Object *result)
2079 NSAppleEventDescriptor *desc;
2080 NSDictionary* errorDict;
2081 NSAppleEventDescriptor* returnDescriptor = NULL;
2083 NSAppleScript* scriptObject =
2084 [[NSAppleScript alloc] initWithSource:
2085 [NSString stringWithUTF8String: SSDATA (script)]];
2087 returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2088 [scriptObject release];
2092 if (returnDescriptor != NULL)
2094 // successful execution
2095 if (kAENullEvent != [returnDescriptor descriptorType])
2098 // script returned an AppleScript result
2099 if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2100 #if defined (NS_IMPL_COCOA)
2101 (typeUTF16ExternalRepresentation
2102 == [returnDescriptor descriptorType]) ||
2104 (typeUTF8Text == [returnDescriptor descriptorType]) ||
2105 (typeCString == [returnDescriptor descriptorType]))
2107 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2109 *result = build_string([[desc stringValue] UTF8String]);
2113 /* use typeUTF16ExternalRepresentation? */
2114 // coerce the result to the appropriate ObjC type
2115 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2117 *result = make_number([desc int32Value]);
2123 // no script result, return error
2129 /* Helper function called from sendEvent to run applescript
2130 from within the main event loop. */
2133 ns_run_ascript (void)
2135 if (! NILP (as_script))
2136 as_status = ns_do_applescript (as_script, as_result);
2140 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2141 doc: /* Execute AppleScript SCRIPT and return the result.
2142 If compilation and execution are successful, the resulting script value
2143 is returned as a string, a number or, in the case of other constructs, t.
2144 In case the execution fails, an error is signaled. */)
2145 (Lisp_Object script)
2151 CHECK_STRING (script);
2152 check_window_system (NULL);
2157 as_result = &result;
2159 /* executing apple script requires the event loop to run, otherwise
2160 errors aren't returned and executeAndReturnError hangs forever.
2161 Post an event that runs applescript and then start the event loop.
2162 The event loop is exited when the script is done. */
2163 nxev = [NSEvent otherEventWithType: NSApplicationDefined
2164 location: NSMakePoint (0, 0)
2167 windowNumber: [[NSApp mainWindow] windowNumber]
2168 context: [NSApp context]
2171 data2: NSAPP_DATA2_RUNASSCRIPT];
2173 [NSApp postEvent: nxev atStart: NO];
2175 // If there are other events, the event loop may exit. Keep running
2176 // until the script has been handled. */
2177 while (! NILP (as_script))
2186 else if (!STRINGP (result))
2187 error ("AppleScript error %d", status);
2189 error ("%s", SSDATA (result));
2195 /* ==========================================================================
2197 Miscellaneous functions not called through hooks
2199 ========================================================================== */
2201 /* called from frame.c */
2202 struct ns_display_info *
2203 check_x_display_info (Lisp_Object frame)
2205 return check_ns_display_info (frame);
2210 x_set_scroll_bar_default_width (struct frame *f)
2212 int wid = FRAME_COLUMN_WIDTH (f);
2213 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2214 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2218 /* terms impl this instead of x-get-resource directly */
2220 x_get_string_resource (XrmDatabase rdb, const char *name, const char *class)
2222 /* remove appname prefix; TODO: allow for !="Emacs" */
2223 const char *res, *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2225 check_window_system (NULL);
2227 if (inhibit_x_resources)
2228 /* --quick was passed, so this is a no-op. */
2231 res = ns_get_defaults_value (toCheck);
2232 return (!res ? NULL :
2233 (!c_strncasecmp (res, "YES", 3) ? "true" :
2234 (!c_strncasecmp (res, "NO", 2) ? "false" : (char *) res)));
2239 x_get_focus_frame (struct frame *frame)
2241 struct ns_display_info *dpyinfo = FRAME_DISPLAY_INFO (frame);
2242 Lisp_Object nsfocus;
2244 if (!dpyinfo->x_focus_frame)
2247 XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2251 /* ==========================================================================
2253 Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2255 ========================================================================== */
2258 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2259 doc: /* Internal function called by `color-defined-p', which see.
2260 \(Note that the Nextstep version of this function ignores FRAME.) */)
2261 (Lisp_Object color, Lisp_Object frame)
2264 check_window_system (NULL);
2265 return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2269 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2270 doc: /* Internal function called by `color-values', which see. */)
2271 (Lisp_Object color, Lisp_Object frame)
2274 EmacsCGFloat red, green, blue, alpha;
2276 check_window_system (NULL);
2277 CHECK_STRING (color);
2279 if (ns_lisp_to_color (color, &col))
2282 [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2283 getRed: &red green: &green blue: &blue alpha: &alpha];
2284 return list3i (lrint (red * 65280), lrint (green * 65280),
2285 lrint (blue * 65280));
2289 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2290 doc: /* Internal function called by `display-color-p', which see. */)
2291 (Lisp_Object terminal)
2293 NSWindowDepth depth;
2294 NSString *colorSpace;
2296 check_ns_display_info (terminal);
2297 depth = [[[NSScreen screens] objectAtIndex:0] depth];
2298 colorSpace = NSColorSpaceFromDepth (depth);
2300 return [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2301 || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2306 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
2308 doc: /* Return t if the Nextstep display supports shades of gray.
2309 Note that color displays do support shades of gray.
2310 The optional argument TERMINAL specifies which display to ask about.
2311 TERMINAL should be a terminal object, a frame or a display name (a string).
2312 If omitted or nil, that stands for the selected frame's display. */)
2313 (Lisp_Object terminal)
2315 NSWindowDepth depth;
2317 check_ns_display_info (terminal);
2318 depth = [[[NSScreen screens] objectAtIndex:0] depth];
2320 return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2324 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2326 doc: /* Return the width in pixels of the Nextstep display TERMINAL.
2327 The optional argument TERMINAL specifies which display to ask about.
2328 TERMINAL should be a terminal object, a frame or a display name (a string).
2329 If omitted or nil, that stands for the selected frame's display.
2331 On \"multi-monitor\" setups this refers to the pixel width for all
2332 physical monitors associated with TERMINAL. To get information for
2333 each physical monitor, use `display-monitor-attributes-list'. */)
2334 (Lisp_Object terminal)
2336 struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
2338 return make_number (x_display_pixel_width (dpyinfo));
2342 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2343 Sx_display_pixel_height, 0, 1, 0,
2344 doc: /* Return the height in pixels of the Nextstep display TERMINAL.
2345 The optional argument TERMINAL specifies which display to ask about.
2346 TERMINAL should be a terminal object, a frame or a display name (a string).
2347 If omitted or nil, that stands for the selected frame's display.
2349 On \"multi-monitor\" setups this refers to the pixel height for all
2350 physical monitors associated with TERMINAL. To get information for
2351 each physical monitor, use `display-monitor-attributes-list'. */)
2352 (Lisp_Object terminal)
2354 struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
2356 return make_number (x_display_pixel_height (dpyinfo));
2359 #ifdef NS_IMPL_COCOA
2360 /* Returns the name for the screen that DICT came from, or NULL.
2361 Caller must free return value.
2365 ns_screen_name (CGDirectDisplayID did)
2368 NSDictionary *info = (NSDictionary *)
2369 IODisplayCreateInfoDictionary (CGDisplayIOServicePort (did),
2370 kIODisplayOnlyPreferredName);
2372 = [info objectForKey:
2373 [NSString stringWithUTF8String:kDisplayProductName]];
2375 if ([names count] > 0) {
2376 NSString *n = [names objectForKey: [[names allKeys] objectAtIndex:0]];
2378 name = xstrdup ([n UTF8String]);
2387 ns_make_monitor_attribute_list (struct MonitorInfo *monitors,
2389 int primary_monitor,
2392 Lisp_Object monitor_frames = Fmake_vector (make_number (n_monitors), Qnil);
2393 Lisp_Object frame, rest;
2394 NSArray *screens = [NSScreen screens];
2397 FOR_EACH_FRAME (rest, frame)
2399 struct frame *f = XFRAME (frame);
2403 NSView *view = FRAME_NS_VIEW (f);
2404 NSScreen *screen = [[view window] screen];
2408 for (k = 0; i == -1 && k < [screens count]; ++k)
2410 if ([screens objectAtIndex: k] == screen)
2415 ASET (monitor_frames, i, Fcons (frame, AREF (monitor_frames, i)));
2419 return make_monitor_attribute_list (monitors, n_monitors, primary_monitor,
2420 monitor_frames, source);
2423 DEFUN ("ns-display-monitor-attributes-list",
2424 Fns_display_monitor_attributes_list,
2425 Sns_display_monitor_attributes_list,
2427 doc: /* Return a list of physical monitor attributes on the X display TERMINAL.
2429 The optional argument TERMINAL specifies which display to ask about.
2430 TERMINAL should be a terminal object, a frame or a display name (a string).
2431 If omitted or nil, that stands for the selected frame's display.
2433 In addition to the standard attribute keys listed in
2434 `display-monitor-attributes-list', the following keys are contained in
2437 source -- String describing the source from which multi-monitor
2438 information is obtained, \"NS\" is always the source."
2440 Internal use only, use `display-monitor-attributes-list' instead. */)
2441 (Lisp_Object terminal)
2443 struct terminal *term = get_terminal (terminal, 1);
2445 NSUInteger i, n_monitors;
2446 struct MonitorInfo *monitors;
2447 Lisp_Object attributes_list = Qnil;
2448 CGFloat primary_display_height = 0;
2450 if (term->type != output_ns)
2453 screens = [NSScreen screens];
2454 n_monitors = [screens count];
2455 if (n_monitors == 0)
2458 monitors = xzalloc (n_monitors * sizeof *monitors);
2460 for (i = 0; i < [screens count]; ++i)
2462 NSScreen *s = [screens objectAtIndex:i];
2463 struct MonitorInfo *m = &monitors[i];
2464 NSRect fr = [s frame];
2465 NSRect vfr = [s visibleFrame];
2468 #ifdef NS_IMPL_COCOA
2469 NSDictionary *dict = [s deviceDescription];
2470 NSNumber *nid = [dict objectForKey:@"NSScreenNumber"];
2471 CGDirectDisplayID did = [nid unsignedIntValue];
2475 primary_display_height = fr.size.height;
2476 y = (short) fr.origin.y;
2477 vy = (short) vfr.origin.y;
2481 // Flip y coordinate as NS has y starting from the bottom.
2482 y = (short) (primary_display_height - fr.size.height - fr.origin.y);
2483 vy = (short) (primary_display_height -
2484 vfr.size.height - vfr.origin.y);
2487 m->geom.x = (short) fr.origin.x;
2489 m->geom.width = (unsigned short) fr.size.width;
2490 m->geom.height = (unsigned short) fr.size.height;
2492 m->work.x = (short) vfr.origin.x;
2493 // y is flipped on NS, so vy - y are pixels missing at the bottom,
2494 // and fr.size.height - vfr.size.height are pixels missing in total.
2495 // Pixels missing at top are
2496 // fr.size.height - vfr.size.height - vy + y.
2497 // work.y is then pixels missing at top + y.
2498 m->work.y = (short) (fr.size.height - vfr.size.height) - vy + y + y;
2499 m->work.width = (unsigned short) vfr.size.width;
2500 m->work.height = (unsigned short) vfr.size.height;
2502 #ifdef NS_IMPL_COCOA
2503 m->name = ns_screen_name (did);
2506 CGSize mms = CGDisplayScreenSize (did);
2507 m->mm_width = (int) mms.width;
2508 m->mm_height = (int) mms.height;
2512 // Assume 92 dpi as x-display-mm-height/x-display-mm-width does.
2513 m->mm_width = (int) (25.4 * fr.size.width / 92.0);
2514 m->mm_height = (int) (25.4 * fr.size.height / 92.0);
2518 // Primary monitor is always first for NS.
2519 attributes_list = ns_make_monitor_attribute_list (monitors, n_monitors,
2522 free_monitors (monitors, n_monitors);
2523 return attributes_list;
2527 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2529 doc: /* Return the number of bitplanes of the Nextstep display TERMINAL.
2530 The optional argument TERMINAL specifies which display to ask about.
2531 TERMINAL should be a terminal object, a frame or a display name (a string).
2532 If omitted or nil, that stands for the selected frame's display. */)
2533 (Lisp_Object terminal)
2535 check_ns_display_info (terminal);
2537 (NSBitsPerPixelFromDepth ([[[NSScreen screens] objectAtIndex:0] depth]));
2541 DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
2543 doc: /* Returns the number of color cells of the Nextstep display TERMINAL.
2544 The optional argument TERMINAL specifies which display to ask about.
2545 TERMINAL should be a terminal object, a frame or a display name (a string).
2546 If omitted or nil, that stands for the selected frame's display. */)
2547 (Lisp_Object terminal)
2549 struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
2550 /* We force 24+ bit depths to 24-bit to prevent an overflow. */
2551 return make_number (1 << min (dpyinfo->n_planes, 24));
2555 /* Unused dummy def needed for compatibility. */
2556 Lisp_Object tip_frame;
2558 /* TODO: move to xdisp or similar */
2560 compute_tip_xy (struct frame *f,
2569 Lisp_Object left, top;
2570 EmacsView *view = FRAME_NS_VIEW (f);
2571 struct ns_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
2574 /* Start with user-specified or mouse position. */
2575 left = Fcdr (Fassq (Qleft, parms));
2576 top = Fcdr (Fassq (Qtop, parms));
2578 if (!INTEGERP (left) || !INTEGERP (top))
2580 pt.x = dpyinfo->last_mouse_motion_x;
2581 pt.y = dpyinfo->last_mouse_motion_y;
2582 /* Convert to screen coordinates */
2583 pt = [view convertPoint: pt toView: nil];
2584 pt = [[view window] convertBaseToScreen: pt];
2588 /* Absolute coordinates. */
2590 pt.y = x_display_pixel_height (FRAME_DISPLAY_INFO (f)) - XINT (top)
2594 /* Ensure in bounds. (Note, screen origin = lower left.) */
2595 if (INTEGERP (left))
2597 else if (pt.x + XINT (dx) <= 0)
2598 *root_x = 0; /* Can happen for negative dx */
2599 else if (pt.x + XINT (dx) + width
2600 <= x_display_pixel_width (FRAME_DISPLAY_INFO (f)))
2601 /* It fits to the right of the pointer. */
2602 *root_x = pt.x + XINT (dx);
2603 else if (width + XINT (dx) <= pt.x)
2604 /* It fits to the left of the pointer. */
2605 *root_x = pt.x - width - XINT (dx);
2607 /* Put it left justified on the screen -- it ought to fit that way. */
2612 else if (pt.y - XINT (dy) - height >= 0)
2613 /* It fits below the pointer. */
2614 *root_y = pt.y - height - XINT (dy);
2615 else if (pt.y + XINT (dy) + height
2616 <= x_display_pixel_height (FRAME_DISPLAY_INFO (f)))
2617 /* It fits above the pointer */
2618 *root_y = pt.y + XINT (dy);
2620 /* Put it on the top. */
2621 *root_y = x_display_pixel_height (FRAME_DISPLAY_INFO (f)) - height;
2625 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2626 doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2627 A tooltip window is a small window displaying a string.
2629 This is an internal function; Lisp code should call `tooltip-show'.
2631 FRAME nil or omitted means use the selected frame.
2633 PARMS is an optional list of frame parameters which can be used to
2634 change the tooltip's appearance.
2636 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
2637 means use the default timeout of 5 seconds.
2639 If the list of frame parameters PARMS contains a `left' parameter,
2640 the tooltip is displayed at that x-position. Otherwise it is
2641 displayed at the mouse position, with offset DX added (default is 5 if
2642 DX isn't specified). Likewise for the y-position; if a `top' frame
2643 parameter is specified, it determines the y-position of the tooltip
2644 window, otherwise it is displayed at the mouse position, with offset
2645 DY added (default is -10).
2647 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2648 Text larger than the specified size is clipped. */)
2649 (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
2652 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2653 ptrdiff_t count = SPECPDL_INDEX ();
2658 specbind (Qinhibit_redisplay, Qt);
2660 GCPRO4 (string, parms, frame, timeout);
2662 CHECK_STRING (string);
2663 str = SSDATA (string);
2664 f = decode_window_system_frame (frame);
2666 timeout = make_number (5);
2668 CHECK_NATNUM (timeout);
2671 dx = make_number (5);
2676 dy = make_number (-10);
2681 if (ns_tooltip == nil)
2682 ns_tooltip = [[EmacsTooltip alloc] init];
2686 [ns_tooltip setText: str];
2687 size = [ns_tooltip frame].size;
2689 /* Move the tooltip window where the mouse pointer is. Resize and
2691 compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2694 [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2698 return unbind_to (count, Qnil);
2702 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2703 doc: /* Hide the current tooltip window, if there is any.
2704 Value is t if tooltip was open, nil otherwise. */)
2707 if (ns_tooltip == nil || ![ns_tooltip isActive])
2714 /* ==========================================================================
2716 Class implementations
2718 ========================================================================== */
2721 Handle arrow/function/control keys and copy/paste/cut in file dialogs.
2722 Return YES if handled, NO if not.
2725 handlePanelKeys (NSSavePanel *panel, NSEvent *theEvent)
2731 if ([theEvent type] != NSKeyDown) return NO;
2732 s = [theEvent characters];
2734 for (i = 0; i < [s length]; ++i)
2736 int ch = (int) [s characterAtIndex: i];
2739 case NSHomeFunctionKey:
2740 case NSDownArrowFunctionKey:
2741 case NSUpArrowFunctionKey:
2742 case NSLeftArrowFunctionKey:
2743 case NSRightArrowFunctionKey:
2744 case NSPageUpFunctionKey:
2745 case NSPageDownFunctionKey:
2746 case NSEndFunctionKey:
2747 /* Don't send command modified keys, as those are handled in the
2748 performKeyEquivalent method of the super class.
2750 if (! ([theEvent modifierFlags] & NSCommandKeyMask))
2752 [panel sendEvent: theEvent];
2756 /* As we don't have the standard key commands for
2757 copy/paste/cut/select-all in our edit menu, we must handle
2758 them here. TODO: handle Emacs key bindings for copy/cut/select-all
2759 here, paste works, because we have that in our Edit menu.
2760 I.e. refactor out code in nsterm.m, keyDown: to figure out the
2766 case 'a': // Select all
2767 if ([theEvent modifierFlags] & NSCommandKeyMask)
2776 : @selector(selectAll:))))
2781 // Send all control keys, as the text field supports C-a, C-f, C-e
2783 if ([theEvent modifierFlags] & NSControlKeyMask)
2785 [panel sendEvent: theEvent];
2796 @implementation EmacsSavePanel
2797 - (BOOL)performKeyEquivalent:(NSEvent *)theEvent
2799 BOOL ret = handlePanelKeys (self, theEvent);
2801 ret = [super performKeyEquivalent:theEvent];
2807 @implementation EmacsOpenPanel
2808 - (BOOL)performKeyEquivalent:(NSEvent *)theEvent
2810 // NSOpenPanel inherits NSSavePanel, so passing self is OK.
2811 BOOL ret = handlePanelKeys (self, theEvent);
2813 ret = [super performKeyEquivalent:theEvent];
2819 @implementation EmacsFileDelegate
2820 /* --------------------------------------------------------------------------
2821 Delegate methods for Open/Save panels
2822 -------------------------------------------------------------------------- */
2823 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2827 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2831 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2832 confirmed: (BOOL)okFlag
2841 /* ==========================================================================
2843 Lisp interface declaration
2845 ========================================================================== */
2849 syms_of_nsfns (void)
2851 Qfontsize = intern_c_string ("fontsize");
2852 staticpro (&Qfontsize);
2854 DEFVAR_LISP ("ns-icon-type-alist", Vns_icon_type_alist,
2855 doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2856 If the title of a frame matches REGEXP, then IMAGE.tiff is
2857 selected as the image of the icon representing the frame when it's
2858 miniaturized. If an element is t, then Emacs tries to select an icon
2859 based on the filetype of the visited file.
2861 The images have to be installed in a folder called English.lproj in the
2862 Emacs folder. You have to restart Emacs after installing new icons.
2864 Example: Install an icon Gnus.tiff and execute the following code
2866 (setq ns-icon-type-alist
2867 (append ns-icon-type-alist
2868 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2871 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2872 be used as the image of the icon representing the frame. */);
2873 Vns_icon_type_alist = list1 (Qt);
2875 DEFVAR_LISP ("ns-version-string", Vns_version_string,
2876 doc: /* Toolkit version for NS Windowing. */);
2877 Vns_version_string = ns_appkit_version_str ();
2879 defsubr (&Sns_read_file_name);
2880 defsubr (&Sns_get_resource);
2881 defsubr (&Sns_set_resource);
2882 defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2883 defsubr (&Sx_display_grayscale_p);
2884 defsubr (&Sns_font_name);
2885 defsubr (&Sns_list_colors);
2886 #ifdef NS_IMPL_COCOA
2887 defsubr (&Sns_do_applescript);
2889 defsubr (&Sxw_color_defined_p);
2890 defsubr (&Sxw_color_values);
2891 defsubr (&Sx_server_max_request_size);
2892 defsubr (&Sx_server_vendor);
2893 defsubr (&Sx_server_version);
2894 defsubr (&Sx_display_pixel_width);
2895 defsubr (&Sx_display_pixel_height);
2896 defsubr (&Sns_display_monitor_attributes_list);
2897 defsubr (&Sx_display_mm_width);
2898 defsubr (&Sx_display_mm_height);
2899 defsubr (&Sx_display_screens);
2900 defsubr (&Sx_display_planes);
2901 defsubr (&Sx_display_color_cells);
2902 defsubr (&Sx_display_visual_class);
2903 defsubr (&Sx_display_backing_store);
2904 defsubr (&Sx_display_save_under);
2905 defsubr (&Sx_create_frame);
2906 defsubr (&Sx_open_connection);
2907 defsubr (&Sx_close_connection);
2908 defsubr (&Sx_display_list);
2910 defsubr (&Sns_hide_others);
2911 defsubr (&Sns_hide_emacs);
2912 defsubr (&Sns_emacs_info_panel);
2913 defsubr (&Sns_list_services);
2914 defsubr (&Sns_perform_service);
2915 defsubr (&Sns_convert_utf8_nfd_to_nfc);
2916 defsubr (&Sns_popup_font_panel);
2917 defsubr (&Sns_popup_color_panel);
2919 defsubr (&Sx_show_tip);
2920 defsubr (&Sx_hide_tip);