1 /* Functions for the NeXT/Open/GNUstep and MacOSX window system.
3 Copyright (C) 1989, 1992-1994, 2005-2006, 2008-2015 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>
53 int fns_trace_num = 1;
54 #define NSTRACE(x) fprintf (stderr, "%s:%d: [%d] " #x "\n", \
55 __FILE__, __LINE__, ++fns_trace_num)
62 extern NSArray *ns_send_types, *ns_return_types, *ns_drag_types;
64 EmacsTooltip *ns_tooltip = nil;
66 /* Need forward declaration here to preserve organizational integrity of file */
67 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
69 /* Static variables to handle applescript execution. */
70 static Lisp_Object as_script, *as_result;
74 static ptrdiff_t image_cache_refcount;
78 /* ==========================================================================
80 Internal utility functions
82 ========================================================================== */
84 /* Let the user specify a Nextstep display with a Lisp object.
85 OBJECT may be nil, a frame or a terminal object.
86 nil stands for the selected frame--or, if that is not a Nextstep frame,
87 the first Nextstep display on the list. */
89 static struct ns_display_info *
90 check_ns_display_info (Lisp_Object object)
92 struct ns_display_info *dpyinfo = NULL;
96 struct frame *sf = XFRAME (selected_frame);
98 if (FRAME_NS_P (sf) && FRAME_LIVE_P (sf))
99 dpyinfo = FRAME_DISPLAY_INFO (sf);
100 else if (x_display_list != 0)
101 dpyinfo = x_display_list;
103 error ("Nextstep windows are not in use or not initialized");
105 else if (TERMINALP (object))
107 struct terminal *t = decode_live_terminal (object);
109 if (t->type != output_ns)
110 error ("Terminal %d is not a Nextstep display", t->id);
112 dpyinfo = t->display_info.ns;
114 else if (STRINGP (object))
115 dpyinfo = ns_display_info_for_name (object);
118 struct frame *f = decode_window_system_frame (object);
119 dpyinfo = FRAME_DISPLAY_INFO (f);
127 ns_get_window (Lisp_Object maybeFrame)
129 id view =nil, window =nil;
131 if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
132 maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
134 if (!NILP (maybeFrame))
135 view = FRAME_NS_VIEW (XFRAME (maybeFrame));
136 if (view) window =[view window];
142 /* Return the X display structure for the display named NAME.
143 Open a new connection if necessary. */
144 struct ns_display_info *
145 ns_display_info_for_name (Lisp_Object name)
147 struct ns_display_info *dpyinfo;
151 for (dpyinfo = x_display_list; dpyinfo; dpyinfo = dpyinfo->next)
152 if (!NILP (Fstring_equal (XCAR (dpyinfo->name_list_element), name)))
155 error ("Emacs for Nextstep does not yet support multi-display");
157 Fx_open_connection (name, Qnil, Qnil);
158 dpyinfo = x_display_list;
161 error ("Display on %s not responding.\n", SDATA (name));
167 ns_filename_from_panel (NSSavePanel *panel)
170 NSURL *url = [panel URL];
171 NSString *str = [url path];
174 return [panel filename];
179 ns_directory_from_panel (NSSavePanel *panel)
182 NSURL *url = [panel directoryURL];
183 NSString *str = [url path];
186 return [panel directory];
191 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
192 /* --------------------------------------------------------------------------
193 Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
194 -------------------------------------------------------------------------- */
204 count = [menu numberOfItems];
205 for (i = 0; i<count; i++)
207 item = [menu itemAtIndex: i];
208 name = [[item title] UTF8String];
211 nameStr = build_string (name);
213 if ([item hasSubmenu])
215 old = interpret_services_menu ([item submenu],
216 Fcons (nameStr, prefix), old);
220 keys = [item keyEquivalent];
221 if (keys && [keys length] )
223 key = [keys characterAtIndex: 0];
224 res = make_number (key|super_modifier);
230 old = Fcons (Fcons (res,
231 Freverse (Fcons (nameStr,
241 /* ==========================================================================
243 Frame parameter setters
245 ========================================================================== */
249 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
252 EmacsCGFloat r, g, b, alpha;
254 /* Must block_input, because ns_lisp_to_color does block/unblock_input
255 which means that col may be deallocated in its unblock_input if there
256 is user input, unless we also block_input. */
258 if (ns_lisp_to_color (arg, &col))
260 store_frame_param (f, Qforeground_color, oldval);
262 error ("Unknown color");
266 [f->output_data.ns->foreground_color release];
267 f->output_data.ns->foreground_color = col;
269 [col getRed: &r green: &g blue: &b alpha: &alpha];
270 FRAME_FOREGROUND_PIXEL (f) =
271 ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
273 if (FRAME_NS_VIEW (f))
275 update_face_from_frame_parameter (f, Qforeground_color, arg);
276 /*recompute_basic_faces (f); */
277 if (FRAME_VISIBLE_P (f))
278 SET_FRAME_GARBAGED (f);
285 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
289 NSView *view = FRAME_NS_VIEW (f);
290 EmacsCGFloat r, g, b, alpha;
293 if (ns_lisp_to_color (arg, &col))
295 store_frame_param (f, Qbackground_color, oldval);
297 error ("Unknown color");
300 /* clear the frame; in some instances the NS-internal GC appears not to
301 update, or it does update and cannot clear old text properly */
302 if (FRAME_VISIBLE_P (f))
306 [f->output_data.ns->background_color release];
307 f->output_data.ns->background_color = col;
309 [col getRed: &r green: &g blue: &b alpha: &alpha];
310 FRAME_BACKGROUND_PIXEL (f) =
311 ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
315 [[view window] setBackgroundColor: col];
317 if (alpha != (EmacsCGFloat) 1.0)
318 [[view window] setOpaque: NO];
320 [[view window] setOpaque: YES];
322 face = FRAME_DEFAULT_FACE (f);
325 col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
326 face->background = ns_index_color
327 ([col colorWithAlphaComponent: alpha], f);
329 update_face_from_frame_parameter (f, Qbackground_color, arg);
332 if (FRAME_VISIBLE_P (f))
333 SET_FRAME_GARBAGED (f);
340 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
345 if (ns_lisp_to_color (arg, &col))
347 store_frame_param (f, Qcursor_color, oldval);
349 error ("Unknown color");
352 [FRAME_CURSOR_COLOR (f) release];
353 FRAME_CURSOR_COLOR (f) = [col retain];
355 if (FRAME_VISIBLE_P (f))
357 x_update_cursor (f, 0);
358 x_update_cursor (f, 1);
360 update_face_from_frame_parameter (f, Qcursor_color, arg);
366 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
368 NSView *view = FRAME_NS_VIEW (f);
369 NSTRACE (x_set_icon_name);
371 /* see if it's changed */
374 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
377 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
380 fset_icon_name (f, arg);
384 if (!NILP (f->title))
387 /* Explicit name and no icon-name -> explicit_name. */
388 if (f->explicit_name)
392 /* No explicit name and no icon-name ->
393 name has to be rebuild from icon_title_format. */
394 windows_or_buffers_changed = 62;
399 /* Don't change the name if it's already NAME. */
400 if ([[view window] miniwindowTitle]
401 && ([[[view window] miniwindowTitle]
402 isEqualToString: [NSString stringWithUTF8String:
406 [[view window] setMiniwindowTitle:
407 [NSString stringWithUTF8String: SSDATA (arg)]];
411 ns_set_name_internal (struct frame *f, Lisp_Object name)
414 Lisp_Object encoded_name, encoded_icon_name;
416 NSView *view = FRAME_NS_VIEW (f);
419 encoded_name = ENCODE_UTF_8 (name);
422 str = [NSString stringWithUTF8String: SSDATA (encoded_name)];
424 /* Don't change the name if it's already NAME. */
425 if (! [[[view window] title] isEqualToString: str])
426 [[view window] setTitle: str];
428 if (!STRINGP (f->icon_name))
429 encoded_icon_name = encoded_name;
431 encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
433 str = [NSString stringWithUTF8String: SSDATA (encoded_icon_name)];
435 if ([[view window] miniwindowTitle]
436 && ! [[[view window] miniwindowTitle] isEqualToString: str])
437 [[view window] setMiniwindowTitle: str];
442 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
444 NSTRACE (ns_set_name);
446 /* Make sure that requests from lisp code override requests from
447 Emacs redisplay code. */
450 /* If we're switching from explicit to implicit, we had better
451 update the mode lines and thereby update the title. */
452 if (f->explicit_name && NILP (name))
453 update_mode_lines = 21;
455 f->explicit_name = ! NILP (name);
457 else if (f->explicit_name)
461 name = build_string ([ns_app_name UTF8String]);
465 /* Don't change the name if it's already NAME. */
466 if (! NILP (Fstring_equal (name, f->name)))
471 /* Title overrides explicit name. */
472 if (! NILP (f->title))
475 ns_set_name_internal (f, name);
479 /* This function should be called when the user's lisp code has
480 specified a name for the frame; the name will override any set by the
483 x_explicitly_set_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
485 NSTRACE (x_explicitly_set_name);
486 ns_set_name (f, arg, 1);
490 /* This function should be called by Emacs redisplay code to set the
491 name; names set this way will never override names set by the user's
494 x_implicitly_set_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
496 NSTRACE (x_implicitly_set_name);
498 /* Deal with NS specific format t. */
499 if (FRAME_NS_P (f) && ((FRAME_ICONIFIED_P (f) && EQ (Vicon_title_format, Qt))
500 || EQ (Vframe_title_format, Qt)))
501 ns_set_name_as_filename (f);
503 ns_set_name (f, arg, 0);
507 /* Change the title of frame F to NAME.
508 If NAME is nil, use the frame name as the title. */
511 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
513 NSTRACE (x_set_title);
514 /* Don't change the title if it's already NAME. */
515 if (EQ (name, f->title))
518 update_mode_lines = 22;
520 fset_title (f, name);
527 ns_set_name_internal (f, name);
532 ns_set_name_as_filename (struct frame *f)
535 Lisp_Object name, filename;
536 Lisp_Object buf = XWINDOW (f->selected_window)->contents;
538 NSAutoreleasePool *pool;
540 Lisp_Object encoded_name, encoded_filename;
542 NSTRACE (ns_set_name_as_filename);
544 if (f->explicit_name || ! NILP (f->title))
548 pool = [[NSAutoreleasePool alloc] init];
549 filename = BVAR (XBUFFER (buf), filename);
550 name = BVAR (XBUFFER (buf), name);
554 if (! NILP (filename))
555 name = Ffile_name_nondirectory (filename);
557 name = build_string ([ns_app_name UTF8String]);
561 encoded_name = ENCODE_UTF_8 (name);
564 view = FRAME_NS_VIEW (f);
566 title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
567 : [[[view window] title] UTF8String];
569 if (title && (! strcmp (title, SSDATA (encoded_name))))
576 str = [NSString stringWithUTF8String: SSDATA (encoded_name)];
577 if (str == nil) str = @"Bad coding";
579 if (FRAME_ICONIFIED_P (f))
580 [[view window] setMiniwindowTitle: str];
585 if (! NILP (filename))
588 encoded_filename = ENCODE_UTF_8 (filename);
591 fstr = [NSString stringWithUTF8String: SSDATA (encoded_filename)];
592 if (fstr == nil) fstr = @"";
597 ns_set_represented_filename (fstr, f);
598 [[view window] setTitle: str];
608 ns_set_doc_edited (void)
610 NSAutoreleasePool *pool;
611 Lisp_Object tail, frame;
613 pool = [[NSAutoreleasePool alloc] init];
614 FOR_EACH_FRAME (tail, frame)
617 struct frame *f = XFRAME (frame);
621 if (! FRAME_NS_P (f)) continue;
622 w = XWINDOW (FRAME_SELECTED_WINDOW (f));
623 view = FRAME_NS_VIEW (f);
624 if (!MINI_WINDOW_P (w))
625 edited = ! NILP (Fbuffer_modified_p (w->contents)) &&
626 ! NILP (Fbuffer_file_name (w->contents));
627 [[view window] setDocumentEdited: edited];
636 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
639 if (FRAME_MINIBUF_ONLY_P (f))
642 if (TYPE_RANGED_INTEGERP (int, value))
643 nlines = XINT (value);
647 FRAME_MENU_BAR_LINES (f) = 0;
650 FRAME_EXTERNAL_MENU_BAR (f) = 1;
651 /* does for all frames, whereas we just want for one frame
652 [NSMenu setMenuBarVisible: YES]; */
656 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
657 free_frame_menubar (f);
658 /* [NSMenu setMenuBarVisible: NO]; */
659 FRAME_EXTERNAL_MENU_BAR (f) = 0;
664 /* toolbar support */
666 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
670 if (FRAME_MINIBUF_ONLY_P (f))
673 if (RANGED_INTEGERP (0, value, INT_MAX))
674 nlines = XFASTINT (value);
680 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
681 update_frame_tool_bar (f);
685 if (FRAME_EXTERNAL_TOOL_BAR (f))
687 free_frame_tool_bar (f);
688 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
692 x_set_window_size (f, 0, f->text_cols, f->text_lines, 0);
697 x_set_internal_border_width (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
699 int old_width = FRAME_INTERNAL_BORDER_WIDTH (f);
701 CHECK_TYPE_RANGED_INTEGER (int, arg);
702 FRAME_INTERNAL_BORDER_WIDTH (f) = XINT (arg);
703 if (FRAME_INTERNAL_BORDER_WIDTH (f) < 0)
704 FRAME_INTERNAL_BORDER_WIDTH (f) = 0;
706 if (FRAME_INTERNAL_BORDER_WIDTH (f) == old_width)
709 if (FRAME_X_WINDOW (f) != 0)
710 adjust_frame_size (f, -1, -1, 3, 0, Qinternal_border_width);
712 SET_FRAME_GARBAGED (f);
717 ns_implicitly_set_icon_type (struct frame *f)
720 EmacsView *view = FRAME_NS_VIEW (f);
722 Lisp_Object chain, elt;
723 NSAutoreleasePool *pool;
726 NSTRACE (ns_implicitly_set_icon_type);
729 pool = [[NSAutoreleasePool alloc] init];
730 if (f->output_data.ns->miniimage
731 && [[NSString stringWithUTF8String: SSDATA (f->name)]
732 isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
739 tem = assq_no_quit (Qicon_type, f->param_alist);
740 if (CONSP (tem) && ! NILP (XCDR (tem)))
747 for (chain = Vns_icon_type_alist;
748 image == nil && CONSP (chain);
749 chain = XCDR (chain))
752 /* special case: t means go by file type */
753 if (SYMBOLP (elt) && EQ (elt, Qt) && SSDATA (f->name)[0] == '/')
756 = [NSString stringWithUTF8String: SSDATA (f->name)];
757 if ([[NSFileManager defaultManager] fileExistsAtPath: str])
758 image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
760 else if (CONSP (elt) &&
761 STRINGP (XCAR (elt)) &&
762 STRINGP (XCDR (elt)) &&
763 fast_string_match (XCAR (elt), f->name) >= 0)
765 image = [EmacsImage allocInitFromFile: XCDR (elt)];
767 image = [[NSImage imageNamed:
768 [NSString stringWithUTF8String:
769 SSDATA (XCDR (elt))]] retain];
775 image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
779 [f->output_data.ns->miniimage release];
780 f->output_data.ns->miniimage = image;
781 [view setMiniwindowImage: setMini];
788 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
790 EmacsView *view = FRAME_NS_VIEW (f);
794 NSTRACE (x_set_icon_type);
796 if (!NILP (arg) && SYMBOLP (arg))
798 arg =build_string (SSDATA (SYMBOL_NAME (arg)));
799 store_frame_param (f, Qicon_type, arg);
802 /* do it the implicit way */
805 ns_implicitly_set_icon_type (f);
811 image = [EmacsImage allocInitFromFile: arg];
813 image =[NSImage imageNamed: [NSString stringWithUTF8String:
818 image = [NSImage imageNamed: @"text"];
822 f->output_data.ns->miniimage = image;
823 [view setMiniwindowImage: setMini];
827 /* TODO: move to nsterm? */
829 ns_lisp_to_cursor_type (Lisp_Object arg)
832 if (XTYPE (arg) == Lisp_String)
834 else if (XTYPE (arg) == Lisp_Symbol)
835 str = SSDATA (SYMBOL_NAME (arg));
837 if (!strcmp (str, "box")) return FILLED_BOX_CURSOR;
838 if (!strcmp (str, "hollow")) return HOLLOW_BOX_CURSOR;
839 if (!strcmp (str, "hbar")) return HBAR_CURSOR;
840 if (!strcmp (str, "bar")) return BAR_CURSOR;
841 if (!strcmp (str, "no")) return NO_CURSOR;
847 ns_cursor_type_to_lisp (int arg)
851 case FILLED_BOX_CURSOR: return Qbox;
852 case HOLLOW_BOX_CURSOR: return Qhollow;
853 case HBAR_CURSOR: return Qhbar;
854 case BAR_CURSOR: return Qbar;
856 default: return intern ("no");
860 /* This is the same as the xfns.c definition. */
862 x_set_cursor_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
864 set_frame_cursor_types (f, arg);
867 /* called to set mouse pointer color, but all other terms use it to
868 initialize pointer types (and don't set the color ;) */
870 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
872 /* don't think we can do this on Nextstep */
877 #define Xstr(x) Str(x)
880 ns_appkit_version_str (void)
884 #ifdef NS_IMPL_GNUSTEP
885 sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
886 #elif defined (NS_IMPL_COCOA)
888 = [[NSProcessInfo processInfo] operatingSystemVersionString];
889 sprintf(tmp, "appkit-%.2f %s",
890 NSAppKitVersionNumber,
891 [osversion UTF8String]);
895 return build_string (tmp);
899 /* This is for use by x-server-version and collapses all version info we
900 have into a single int. For a better picture of the implementation
901 running, use ns_appkit_version_str.*/
903 ns_appkit_version_int (void)
905 #ifdef NS_IMPL_GNUSTEP
906 return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GUI_MINOR_VERSION;
907 #elif defined (NS_IMPL_COCOA)
908 return (int)NSAppKitVersionNumber;
915 x_icon (struct frame *f, Lisp_Object parms)
916 /* --------------------------------------------------------------------------
917 Strangely-named function to set icon position parameters in frame.
918 This is irrelevant under OS X, but might be needed under GNUstep,
919 depending on the window manager used. Note, this is not a standard
920 frame parameter-setter; it is called directly from x-create-frame.
921 -------------------------------------------------------------------------- */
923 Lisp_Object icon_x, icon_y;
924 struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
926 f->output_data.ns->icon_top = -1;
927 f->output_data.ns->icon_left = -1;
929 /* Set the position of the icon. */
930 icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
931 icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
932 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
934 CHECK_NUMBER (icon_x);
935 CHECK_NUMBER (icon_y);
936 f->output_data.ns->icon_top = XINT (icon_y);
937 f->output_data.ns->icon_left = XINT (icon_x);
939 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
940 error ("Both left and top icon corners of icon must be specified");
944 /* Note: see frame.c for template, also where generic functions are impl */
945 frame_parm_handler ns_frame_parm_handlers[] =
947 x_set_autoraise, /* generic OK */
948 x_set_autolower, /* generic OK */
949 x_set_background_color,
950 0, /* x_set_border_color, may be impossible under Nextstep */
951 0, /* x_set_border_width, may be impossible under Nextstep */
954 x_set_font, /* generic OK */
955 x_set_foreground_color,
958 x_set_internal_border_width, /* generic OK */
959 0, /* x_set_right_divider_width */
960 0, /* x_set_bottom_divider_width */
961 x_set_menu_bar_lines,
963 x_explicitly_set_name,
964 x_set_scroll_bar_width, /* generic OK */
965 x_set_scroll_bar_height, /* generic OK */
967 x_set_unsplittable, /* generic OK */
968 x_set_vertical_scroll_bars, /* generic OK */
969 x_set_horizontal_scroll_bars, /* generic OK */
970 x_set_visibility, /* generic OK */
971 x_set_tool_bar_lines,
972 0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
973 0, /* x_set_scroll_bar_background, will ignore (not possible on NS) */
974 x_set_screen_gamma, /* generic OK */
975 x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
976 x_set_left_fringe, /* generic OK */
977 x_set_right_fringe, /* generic OK */
978 0, /* x_set_wait_for_wm, will ignore */
979 x_set_fullscreen, /* generic OK */
980 x_set_font_backend, /* generic OK */
982 0, /* x_set_sticky */
983 0, /* x_set_tool_bar_position */
987 /* Handler for signals raised during x_create_frame.
988 FRAME is the frame which is partially constructed. */
991 unwind_create_frame (Lisp_Object frame)
993 struct frame *f = XFRAME (frame);
995 /* If frame is already dead, nothing to do. This can happen if the
996 display is disconnected after the frame has become official, but
997 before x_create_frame removes the unwind protect. */
998 if (!FRAME_LIVE_P (f))
1001 /* If frame is ``official'', nothing to do. */
1002 if (NILP (Fmemq (frame, Vframe_list)))
1004 #if defined GLYPH_DEBUG && defined ENABLE_CHECKING
1005 struct ns_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
1008 x_free_frame_resources (f);
1012 /* Check that reference counts are indeed correct. */
1013 eassert (dpyinfo->terminal->image_cache->refcount == image_cache_refcount);
1019 * Read geometry related parameters from preferences if not in PARMS.
1020 * Returns the union of parms and any preferences read.
1024 get_geometry_from_preferences (struct ns_display_info *dpyinfo,
1032 { "width", "Width", Qwidth },
1033 { "height", "Height", Qheight },
1034 { "left", "Left", Qleft },
1035 { "top", "Top", Qtop },
1039 for (i = 0; i < ARRAYELTS (r); ++i)
1041 if (NILP (Fassq (r[i].tem, parms)))
1044 = x_get_arg (dpyinfo, parms, r[i].tem, r[i].val, r[i].cls,
1046 if (! EQ (value, Qunbound))
1047 parms = Fcons (Fcons (r[i].tem, value), parms);
1054 /* ==========================================================================
1058 ========================================================================== */
1060 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1062 doc: /* Make a new Nextstep window, called a "frame" in Emacs terms.
1063 Return an Emacs frame object.
1064 PARMS is an alist of frame parameters.
1065 If the parameters specify that the frame should not have a minibuffer,
1066 and do not specify a specific minibuffer window to use,
1067 then `default-minibuffer-frame' must be a frame whose minibuffer can
1068 be shared by the new frame.
1070 This function is an internal primitive--use `make-frame' instead. */)
1074 Lisp_Object frame, tem;
1076 int minibuffer_only = 0;
1077 long window_prompting = 0;
1078 ptrdiff_t count = specpdl_ptr - specpdl;
1079 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1080 Lisp_Object display;
1081 struct ns_display_info *dpyinfo = NULL;
1084 static int desc_ctr = 1;
1086 /* x_get_arg modifies parms. */
1087 parms = Fcopy_alist (parms);
1089 /* Use this general default value to start with
1090 until we know if this frame has a specified name. */
1091 Vx_resource_name = Vinvocation_name;
1093 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1094 if (EQ (display, Qunbound))
1096 dpyinfo = check_ns_display_info (display);
1097 kb = dpyinfo->terminal->kboard;
1099 if (!dpyinfo->terminal->name)
1100 error ("Terminal is not live, can't create new frames on it");
1102 name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1104 && ! EQ (name, Qunbound)
1106 error ("Invalid frame name--not a string or nil");
1109 Vx_resource_name = name;
1111 parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1112 if (EQ (parent, Qunbound))
1114 if (! NILP (parent))
1115 CHECK_NUMBER (parent);
1117 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
1118 /* No need to protect DISPLAY because that's not used after passing
1119 it to make_frame_without_minibuffer. */
1121 GCPRO4 (parms, parent, name, frame);
1122 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1124 if (EQ (tem, Qnone) || NILP (tem))
1125 f = make_frame_without_minibuffer (Qnil, kb, display);
1126 else if (EQ (tem, Qonly))
1128 f = make_minibuffer_frame ();
1129 minibuffer_only = 1;
1131 else if (WINDOWP (tem))
1132 f = make_frame_without_minibuffer (tem, kb, display);
1136 XSETFRAME (frame, f);
1138 f->terminal = dpyinfo->terminal;
1140 f->output_method = output_ns;
1141 f->output_data.ns = xzalloc (sizeof *f->output_data.ns);
1143 FRAME_FONTSET (f) = -1;
1145 fset_icon_name (f, x_get_arg (dpyinfo, parms, Qicon_name,
1146 "iconName", "Title",
1148 if (! STRINGP (f->icon_name))
1149 fset_icon_name (f, Qnil);
1151 FRAME_DISPLAY_INFO (f) = dpyinfo;
1153 /* With FRAME_DISPLAY_INFO set up, this unwind-protect is safe. */
1154 record_unwind_protect (unwind_create_frame, frame);
1156 f->output_data.ns->window_desc = desc_ctr++;
1157 if (TYPE_RANGED_INTEGERP (Window, parent))
1159 f->output_data.ns->parent_desc = XFASTINT (parent);
1160 f->output_data.ns->explicit_parent = 1;
1164 f->output_data.ns->parent_desc = FRAME_DISPLAY_INFO (f)->root_window;
1165 f->output_data.ns->explicit_parent = 0;
1168 /* Set the name; the functions to which we pass f expect the name to
1170 if (EQ (name, Qunbound) || NILP (name) || ! STRINGP (name))
1172 fset_name (f, build_string ([ns_app_name UTF8String]));
1173 f->explicit_name = 0;
1177 fset_name (f, name);
1178 f->explicit_name = 1;
1179 specbind (Qx_resource_name, name);
1184 #ifdef NS_IMPL_COCOA
1185 mac_register_font_driver (f);
1187 register_font_driver (&nsfont_driver, f);
1190 x_default_parameter (f, parms, Qfont_backend, Qnil,
1191 "fontBackend", "FontBackend", RES_TYPE_STRING);
1194 /* use for default font name */
1195 id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1196 x_default_parameter (f, parms, Qfontsize,
1197 make_number (0 /*(int)[font pointSize]*/),
1198 "fontSize", "FontSize", RES_TYPE_NUMBER);
1199 // Remove ' Regular', not handled by backends.
1200 char *fontname = xstrdup ([[font displayName] UTF8String]);
1201 int len = strlen (fontname);
1202 if (len > 8 && strcmp (fontname + len - 8, " Regular") == 0)
1203 fontname[len-8] = '\0';
1204 x_default_parameter (f, parms, Qfont,
1205 build_string (fontname),
1206 "font", "Font", RES_TYPE_STRING);
1211 x_default_parameter (f, parms, Qborder_width, make_number (0),
1212 "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1213 x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1214 "internalBorderWidth", "InternalBorderWidth",
1217 /* default vertical scrollbars on right on Mac */
1220 #ifdef NS_IMPL_GNUSTEP
1225 x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1226 "verticalScrollBars", "VerticalScrollBars",
1229 x_default_parameter (f, parms, Qhorizontal_scroll_bars, Qnil,
1230 "horizontalScrollBars", "HorizontalScrollBars",
1232 x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1233 "foreground", "Foreground", RES_TYPE_STRING);
1234 x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1235 "background", "Background", RES_TYPE_STRING);
1236 /* FIXME: not supported yet in Nextstep */
1237 x_default_parameter (f, parms, Qline_spacing, Qnil,
1238 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1239 x_default_parameter (f, parms, Qleft_fringe, Qnil,
1240 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1241 x_default_parameter (f, parms, Qright_fringe, Qnil,
1242 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1245 image_cache_refcount =
1246 FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
1249 init_frame_faces (f);
1251 /* Read comment about this code in corresponding place in xfns.c. */
1252 adjust_frame_size (f, FRAME_COLS (f) * FRAME_COLUMN_WIDTH (f),
1253 FRAME_LINES (f) * FRAME_LINE_HEIGHT (f), 5, 1,
1256 /* The resources controlling the menu-bar and tool-bar are
1257 processed specially at startup, and reflected in the mode
1258 variables; ignore them here. */
1259 x_default_parameter (f, parms, Qmenu_bar_lines,
1260 NILP (Vmenu_bar_mode)
1261 ? make_number (0) : make_number (1),
1262 NULL, NULL, RES_TYPE_NUMBER);
1263 x_default_parameter (f, parms, Qtool_bar_lines,
1264 NILP (Vtool_bar_mode)
1265 ? make_number (0) : make_number (1),
1266 NULL, NULL, RES_TYPE_NUMBER);
1268 x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1269 "BufferPredicate", RES_TYPE_SYMBOL);
1270 x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1273 parms = get_geometry_from_preferences (dpyinfo, parms);
1274 window_prompting = x_figure_window_size (f, parms, 1);
1276 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1277 f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1279 /* NOTE: on other terms, this is done in set_mouse_color, however this
1280 was not getting called under Nextstep */
1281 f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1282 f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1283 f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1284 f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1285 f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1286 f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1287 f->output_data.ns->vertical_drag_cursor = [NSCursor resizeUpDownCursor];
1288 FRAME_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1289 = [NSCursor arrowCursor];
1290 FRAME_DISPLAY_INFO (f)->horizontal_scroll_bar_cursor
1291 = [NSCursor arrowCursor];
1292 f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1294 [[EmacsView alloc] initFrameFromEmacs: f];
1298 /* ns_display_info does not have a reference_count. */
1299 f->terminal->reference_count++;
1301 /* It is now ok to make the frame official even if we get an error below.
1302 The frame needs to be on Vframe_list or making it visible won't work. */
1303 Vframe_list = Fcons (frame, Vframe_list);
1305 x_default_parameter (f, parms, Qicon_type, Qnil,
1306 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
1308 x_default_parameter (f, parms, Qauto_raise, Qnil,
1309 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
1310 x_default_parameter (f, parms, Qauto_lower, Qnil,
1311 "autoLower", "AutoLower", RES_TYPE_BOOLEAN);
1312 x_default_parameter (f, parms, Qcursor_type, Qbox,
1313 "cursorType", "CursorType", RES_TYPE_SYMBOL);
1314 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
1315 "scrollBarWidth", "ScrollBarWidth",
1317 x_default_parameter (f, parms, Qscroll_bar_height, Qnil,
1318 "scrollBarHeight", "ScrollBarHeight",
1320 x_default_parameter (f, parms, Qalpha, Qnil,
1321 "alpha", "Alpha", RES_TYPE_NUMBER);
1322 x_default_parameter (f, parms, Qfullscreen, Qnil,
1323 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
1325 /* Allow x_set_window_size, now. */
1326 f->can_x_set_window_size = true;
1328 adjust_frame_size (f, FRAME_TEXT_WIDTH (f), FRAME_TEXT_HEIGHT (f), 0, 1,
1331 if (! f->output_data.ns->explicit_parent)
1333 Lisp_Object visibility;
1335 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
1337 if (EQ (visibility, Qunbound))
1340 if (EQ (visibility, Qicon))
1341 x_iconify_frame (f);
1342 else if (! NILP (visibility))
1344 x_make_frame_visible (f);
1345 [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1349 /* Must have been Qnil. */
1353 if (FRAME_HAS_MINIBUF_P (f)
1354 && (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
1355 || !FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame)))))
1356 kset_default_minibuffer_frame (kb, frame);
1358 /* All remaining specified parameters, which have not been "used"
1359 by x_get_arg and friends, now go in the misc. alist of the frame. */
1360 for (tem = parms; CONSP (tem); tem = XCDR (tem))
1361 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1362 fset_param_alist (f, Fcons (XCAR (tem), f->param_alist));
1366 if (window_prompting & USPosition)
1367 x_set_offset (f, f->left_pos, f->top_pos, 1);
1369 /* Make sure windows on this frame appear in calls to next-window
1370 and similar functions. */
1371 Vwindow_list = Qnil;
1373 return unbind_to (count, frame);
1377 x_focus_frame (struct frame *f)
1379 struct ns_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
1381 if (dpyinfo->x_focus_frame != f)
1383 EmacsView *view = FRAME_NS_VIEW (f);
1385 [NSApp activateIgnoringOtherApps: YES];
1386 [[view window] makeKeyAndOrderFront: view];
1392 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1394 doc: /* Pop up the font panel. */)
1397 struct frame *f = decode_window_system_frame (frame);
1398 id fm = [NSFontManager sharedFontManager];
1399 struct font *font = f->output_data.ns->font;
1401 #ifdef NS_IMPL_GNUSTEP
1402 nsfont = ((struct nsfont_info *)font)->nsfont;
1404 #ifdef NS_IMPL_COCOA
1405 nsfont = (NSFont *) macfont_get_nsctfont (font);
1407 [fm setSelectedFont: nsfont isMultiple: NO];
1408 [fm orderFrontFontPanel: NSApp];
1413 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1415 doc: /* Pop up the color panel. */)
1418 check_window_system (NULL);
1419 [NSApp orderFrontColorPanel: NSApp];
1427 #ifdef NS_IMPL_GNUSTEP
1428 NSString *dirS, *initS;
1434 ns_run_file_dialog (void)
1436 if (ns_fd_data.panel == nil) return;
1437 #ifdef NS_IMPL_COCOA
1438 ns_fd_data.ret = [ns_fd_data.panel runModal];
1440 if (ns_fd_data.no_types)
1442 ns_fd_data.ret = [ns_fd_data.panel
1443 runModalForDirectory: ns_fd_data.dirS
1444 file: ns_fd_data.initS];
1448 ns_fd_data.ret = [ns_fd_data.panel
1449 runModalForDirectory: ns_fd_data.dirS
1450 file: ns_fd_data.initS
1454 ns_fd_data.panel = nil;
1457 #ifdef NS_IMPL_COCOA
1458 #if MAC_OS_X_VERSION_MAX_ALLOWED > MAC_OS_X_VERSION_10_9
1459 #define MODAL_OK_RESPONSE NSModalResponseOK
1462 #ifndef MODAL_OK_RESPONSE
1463 #define MODAL_OK_RESPONSE NSOKButton
1466 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 5, 0,
1467 doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1468 Optional arg DIR, if non-nil, supplies a default directory.
1469 Optional arg MUSTMATCH, if non-nil, means the returned file or
1470 directory must exist.
1471 Optional arg INIT, if non-nil, provides a default file name to use.
1472 Optional arg DIR_ONLY_P, if non-nil, means choose only directories. */)
1473 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object mustmatch,
1474 Lisp_Object init, Lisp_Object dir_only_p)
1476 static id fileDelegate = nil;
1477 BOOL isSave = NILP (mustmatch) && NILP (dir_only_p);
1479 Lisp_Object fname = Qnil;
1481 NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1482 [NSString stringWithUTF8String: SSDATA (prompt)];
1483 NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1484 [NSString stringWithUTF8String: SSDATA (BVAR (current_buffer, directory))] :
1485 [NSString stringWithUTF8String: SSDATA (dir)];
1486 NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1487 [NSString stringWithUTF8String: SSDATA (init)];
1490 check_window_system (NULL);
1492 if (fileDelegate == nil)
1493 fileDelegate = [EmacsFileDelegate new];
1495 [NSCursor setHiddenUntilMouseMoves: NO];
1497 if ([dirS characterAtIndex: 0] == '~')
1498 dirS = [dirS stringByExpandingTildeInPath];
1501 (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1503 [panel setTitle: promptS];
1505 [panel setAllowsOtherFileTypes: YES];
1506 [panel setTreatsFilePackagesAsDirectories: YES];
1507 [panel setDelegate: fileDelegate];
1509 if (! NILP (dir_only_p))
1511 [panel setCanChooseDirectories: YES];
1512 [panel setCanChooseFiles: NO];
1516 /* This is not quite what the documentation says, but it is compatible
1517 with the Gtk+ code. Also, the menu entry says "Open File...". */
1518 [panel setCanChooseDirectories: NO];
1519 [panel setCanChooseFiles: YES];
1523 ns_fd_data.panel = panel;
1524 ns_fd_data.ret = NO;
1525 #ifdef NS_IMPL_COCOA
1526 if (! NILP (mustmatch) || ! NILP (dir_only_p))
1527 [panel setAllowedFileTypes: nil];
1528 if (dirS) [panel setDirectoryURL: [NSURL fileURLWithPath: dirS]];
1529 if (initS && NILP (Ffile_directory_p (init)))
1530 [panel setNameFieldStringValue: [initS lastPathComponent]];
1532 [panel setNameFieldStringValue: @""];
1535 ns_fd_data.no_types = NILP (mustmatch) && NILP (dir_only_p);
1536 ns_fd_data.dirS = dirS;
1537 ns_fd_data.initS = initS;
1540 /* runModalForDirectory/runModal restarts the main event loop when done,
1541 so we must start an event loop and then pop up the file dialog.
1542 The file dialog may pop up a confirm dialog after Ok has been pressed,
1543 so we can not simply pop down on the Ok/Cancel press.
1545 nxev = [NSEvent otherEventWithType: NSApplicationDefined
1546 location: NSMakePoint (0, 0)
1549 windowNumber: [[NSApp mainWindow] windowNumber]
1550 context: [NSApp context]
1553 data2: NSAPP_DATA2_RUNFILEDIALOG];
1555 [NSApp postEvent: nxev atStart: NO];
1556 while (ns_fd_data.panel != nil)
1559 if (ns_fd_data.ret == MODAL_OK_RESPONSE)
1561 NSString *str = ns_filename_from_panel (panel);
1562 if (! str) str = ns_directory_from_panel (panel);
1563 if (str) fname = build_string ([str UTF8String]);
1566 [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1573 ns_get_defaults_value (const char *key)
1575 NSObject *obj = [[NSUserDefaults standardUserDefaults]
1576 objectForKey: [NSString stringWithUTF8String: key]];
1578 if (!obj) return NULL;
1580 return [[NSString stringWithFormat: @"%@", obj] UTF8String];
1584 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1585 doc: /* Return the value of the property NAME of OWNER from the defaults database.
1586 If OWNER is nil, Emacs is assumed. */)
1587 (Lisp_Object owner, Lisp_Object name)
1591 check_window_system (NULL);
1593 owner = build_string([ns_app_name UTF8String]);
1594 CHECK_STRING (name);
1596 value = ns_get_defaults_value (SSDATA (name));
1599 return build_string (value);
1604 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1605 doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1606 If OWNER is nil, Emacs is assumed.
1607 If VALUE is nil, the default is removed. */)
1608 (Lisp_Object owner, Lisp_Object name, Lisp_Object value)
1610 check_window_system (NULL);
1612 owner = build_string ([ns_app_name UTF8String]);
1613 CHECK_STRING (name);
1616 [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1617 [NSString stringWithUTF8String: SSDATA (name)]];
1621 CHECK_STRING (value);
1622 [[NSUserDefaults standardUserDefaults] setObject:
1623 [NSString stringWithUTF8String: SSDATA (value)]
1624 forKey: [NSString stringWithUTF8String:
1632 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1633 Sx_server_max_request_size,
1635 doc: /* This function is a no-op. It is only present for completeness. */)
1636 (Lisp_Object terminal)
1638 check_ns_display_info (terminal);
1639 /* This function has no real equivalent under NeXTstep. Return nil to
1645 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1646 doc: /* Return the "vendor ID" string of Nextstep display server TERMINAL.
1647 \(Labeling every distributor as a "vendor" embodies the false assumption
1648 that operating systems cannot be developed and distributed noncommercially.)
1649 The optional argument TERMINAL specifies which display to ask about.
1650 TERMINAL should be a terminal object, a frame or a display name (a string).
1651 If omitted or nil, that stands for the selected frame's display. */)
1652 (Lisp_Object terminal)
1654 check_ns_display_info (terminal);
1655 #ifdef NS_IMPL_GNUSTEP
1656 return build_string ("GNU");
1658 return build_string ("Apple");
1663 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1664 doc: /* Return the version numbers of the server of display TERMINAL.
1665 The value is a list of three integers: the major and minor
1666 version numbers of the X Protocol in use, and the distributor-specific release
1667 number. See also the function `x-server-vendor'.
1669 The optional argument TERMINAL specifies which display to ask about.
1670 TERMINAL should be a terminal object, a frame or a display name (a string).
1671 If omitted or nil, that stands for the selected frame's display. */)
1672 (Lisp_Object terminal)
1674 check_ns_display_info (terminal);
1675 /*NOTE: it is unclear what would best correspond with "protocol";
1676 we return 10.3, meaning Panther, since this is roughly the
1677 level that GNUstep's APIs correspond to.
1678 The last number is where we distinguish between the Apple
1679 and GNUstep implementations ("distributor-specific release
1680 number") and give int'ized versions of major.minor. */
1681 return list3i (10, 3, ns_appkit_version_int ());
1685 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1686 doc: /* Return the number of screens on Nextstep display server TERMINAL.
1687 The optional argument TERMINAL specifies which display to ask about.
1688 TERMINAL should be a terminal object, a frame or a display name (a string).
1689 If omitted or nil, that stands for the selected frame's display.
1691 Note: "screen" here is not in Nextstep terminology but in X11's. For
1692 the number of physical monitors, use `(length
1693 (display-monitor-attributes-list TERMINAL))' instead. */)
1694 (Lisp_Object terminal)
1696 check_ns_display_info (terminal);
1697 return make_number (1);
1701 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
1702 doc: /* Return the height in millimeters of the Nextstep display TERMINAL.
1703 The optional argument TERMINAL specifies which display to ask about.
1704 TERMINAL should be a terminal object, a frame or a display name (a string).
1705 If omitted or nil, that stands for the selected frame's display.
1707 On \"multi-monitor\" setups this refers to the height in millimeters for
1708 all physical monitors associated with TERMINAL. To get information
1709 for each physical monitor, use `display-monitor-attributes-list'. */)
1710 (Lisp_Object terminal)
1712 struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
1714 return make_number (x_display_pixel_height (dpyinfo) / (92.0/25.4));
1718 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
1719 doc: /* Return the width in millimeters of the Nextstep display TERMINAL.
1720 The optional argument TERMINAL specifies which display to ask about.
1721 TERMINAL should be a terminal object, a frame or a display name (a string).
1722 If omitted or nil, that stands for the selected frame's display.
1724 On \"multi-monitor\" setups this refers to the width in millimeters for
1725 all physical monitors associated with TERMINAL. To get information
1726 for each physical monitor, use `display-monitor-attributes-list'. */)
1727 (Lisp_Object terminal)
1729 struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
1731 return make_number (x_display_pixel_width (dpyinfo) / (92.0/25.4));
1735 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1736 Sx_display_backing_store, 0, 1, 0,
1737 doc: /* Return an indication of whether the Nextstep display TERMINAL does backing store.
1738 The value may be `buffered', `retained', or `non-retained'.
1739 The optional argument TERMINAL specifies which display to ask about.
1740 TERMINAL should be a terminal object, a frame or a display name (a string).
1741 If omitted or nil, that stands for the selected frame's display. */)
1742 (Lisp_Object terminal)
1744 check_ns_display_info (terminal);
1745 switch ([ns_get_window (terminal) backingType])
1747 case NSBackingStoreBuffered:
1748 return intern ("buffered");
1749 case NSBackingStoreRetained:
1750 return intern ("retained");
1751 case NSBackingStoreNonretained:
1752 return intern ("non-retained");
1754 error ("Strange value for backingType parameter of frame");
1756 return Qnil; /* not reached, shut compiler up */
1760 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1761 Sx_display_visual_class, 0, 1, 0,
1762 doc: /* Return the visual class of the Nextstep display TERMINAL.
1763 The value is one of the symbols `static-gray', `gray-scale',
1764 `static-color', `pseudo-color', `true-color', or `direct-color'.
1766 The optional argument TERMINAL specifies which display to ask about.
1767 TERMINAL should a terminal object, a frame or a display name (a string).
1768 If omitted or nil, that stands for the selected frame's display. */)
1769 (Lisp_Object terminal)
1771 NSWindowDepth depth;
1773 check_ns_display_info (terminal);
1774 depth = [[[NSScreen screens] objectAtIndex:0] depth];
1776 if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1777 return intern ("static-gray");
1778 else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1779 return intern ("gray-scale");
1780 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1781 return intern ("pseudo-color");
1782 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1783 return intern ("true-color");
1784 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1785 return intern ("direct-color");
1787 /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1788 return intern ("direct-color");
1792 DEFUN ("x-display-save-under", Fx_display_save_under,
1793 Sx_display_save_under, 0, 1, 0,
1794 doc: /* Return t if TERMINAL supports the save-under feature.
1795 The optional argument TERMINAL specifies which display to ask about.
1796 TERMINAL should be a terminal object, a frame or a display name (a string).
1797 If omitted or nil, that stands for the selected frame's display. */)
1798 (Lisp_Object terminal)
1800 check_ns_display_info (terminal);
1801 switch ([ns_get_window (terminal) backingType])
1803 case NSBackingStoreBuffered:
1806 case NSBackingStoreRetained:
1807 case NSBackingStoreNonretained:
1811 error ("Strange value for backingType parameter of frame");
1813 return Qnil; /* not reached, shut compiler up */
1817 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1819 doc: /* Open a connection to a display server.
1820 DISPLAY is the name of the display to connect to.
1821 Optional second arg XRM-STRING is a string of resources in xrdb format.
1822 If the optional third arg MUST-SUCCEED is non-nil,
1823 terminate Emacs if we can't open the connection.
1824 \(In the Nextstep version, the last two arguments are currently ignored.) */)
1825 (Lisp_Object display, Lisp_Object resource_string, Lisp_Object must_succeed)
1827 struct ns_display_info *dpyinfo;
1829 CHECK_STRING (display);
1831 nxatoms_of_nsselect ();
1832 dpyinfo = ns_term_init (display);
1835 if (!NILP (must_succeed))
1836 fatal ("Display on %s not responding.\n",
1839 error ("Display on %s not responding.\n",
1847 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1849 doc: /* Close the connection to TERMINAL's Nextstep display server.
1850 For TERMINAL, specify a terminal object, a frame or a display name (a
1851 string). If TERMINAL is nil, that stands for the selected frame's
1853 (Lisp_Object terminal)
1855 check_ns_display_info (terminal);
1856 [NSApp terminate: NSApp];
1861 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1862 doc: /* Return the list of display names that Emacs has connections to. */)
1865 Lisp_Object result = Qnil;
1866 struct ns_display_info *ndi;
1868 for (ndi = x_display_list; ndi; ndi = ndi->next)
1869 result = Fcons (XCAR (ndi->name_list_element), result);
1875 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1877 doc: /* Hides all applications other than Emacs. */)
1880 check_window_system (NULL);
1881 [NSApp hideOtherApplications: NSApp];
1885 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1887 doc: /* If ON is non-nil, the entire Emacs application is hidden.
1888 Otherwise if Emacs is hidden, it is unhidden.
1889 If ON is equal to `activate', Emacs is unhidden and becomes
1890 the active application. */)
1893 check_window_system (NULL);
1894 if (EQ (on, intern ("activate")))
1896 [NSApp unhide: NSApp];
1897 [NSApp activateIgnoringOtherApps: YES];
1900 [NSApp unhide: NSApp];
1902 [NSApp hide: NSApp];
1907 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1909 doc: /* Shows the 'Info' or 'About' panel for Emacs. */)
1912 check_window_system (NULL);
1913 [NSApp orderFrontStandardAboutPanel: nil];
1918 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1919 doc: /* Determine font PostScript or family name for font NAME.
1920 NAME should be a string containing either the font name or an XLFD
1921 font descriptor. If string contains `fontset' and not
1922 `fontset-startup', it is left alone. */)
1926 CHECK_STRING (name);
1931 if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1934 return build_string (ns_xlfd_to_fontname (SSDATA (name)));
1938 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1939 doc: /* Return a list of all available colors.
1940 The optional argument FRAME is currently ignored. */)
1943 Lisp_Object list = Qnil;
1944 NSEnumerator *colorlists;
1949 CHECK_FRAME (frame);
1950 if (! FRAME_NS_P (XFRAME (frame)))
1951 error ("non-Nextstep frame used in `ns-list-colors'");
1956 colorlists = [[NSColorList availableColorLists] objectEnumerator];
1957 while ((clist = [colorlists nextObject]))
1959 if ([[clist name] length] < 7 ||
1960 [[clist name] rangeOfString: @"PANTONE"].location == 0)
1962 NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1964 while ((cname = [cnames nextObject]))
1965 list = Fcons (build_string ([cname UTF8String]), list);
1966 /* for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1967 list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1968 UTF8String]), list); */
1978 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1979 doc: /* List available Nextstep services by querying NSApp. */)
1982 #ifdef NS_IMPL_COCOA
1983 /* You can't get services like this in 10.6+. */
1986 Lisp_Object ret = Qnil;
1988 #ifdef NS_IMPL_COCOA
1992 check_window_system (NULL);
1993 svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1994 [NSApp setServicesMenu: svcs];
1995 [NSApp registerServicesMenuSendTypes: ns_send_types
1996 returnTypes: ns_return_types];
1998 /* On Tiger, services menu updating was made lazier (waits for user to
1999 actually click on the menu), so we have to force things along: */
2000 #ifdef NS_IMPL_COCOA
2001 delegate = [svcs delegate];
2002 if (delegate != nil)
2004 if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
2005 [delegate menuNeedsUpdate: svcs];
2006 if ([delegate respondsToSelector:
2007 @selector (menu:updateItem:atIndex:shouldCancel:)])
2009 int i, len = [delegate numberOfItemsInMenu: svcs];
2010 for (i =0; i<len; i++)
2011 [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
2012 for (i =0; i<len; i++)
2013 if (![delegate menu: svcs
2014 updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
2015 atIndex: i shouldCancel: NO])
2021 [svcs setAutoenablesItems: NO];
2022 #ifdef NS_IMPL_COCOA
2023 [svcs update]; /* on OS X, converts from '/' structure */
2026 ret = interpret_services_menu (svcs, Qnil, ret);
2032 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
2034 doc: /* Perform Nextstep SERVICE on SEND.
2035 SEND should be either a string or nil.
2036 The return value is the result of the service, as string, or nil if
2037 there was no result. */)
2038 (Lisp_Object service, Lisp_Object send)
2044 CHECK_STRING (service);
2045 check_window_system (NULL);
2047 utfStr = SSDATA (service);
2048 svcName = [NSString stringWithUTF8String: utfStr];
2050 pb =[NSPasteboard pasteboardWithUniqueName];
2051 ns_string_to_pasteboard (pb, send);
2053 if (NSPerformService (svcName, pb) == NO)
2054 Fsignal (Qquit, list1 (build_string ("service not available")));
2056 if ([[pb types] count] == 0)
2057 return build_string ("");
2058 return ns_string_from_pasteboard (pb);
2062 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
2063 Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
2064 doc: /* Return an NFC string that matches the UTF-8 NFD string STR. */)
2067 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
2070 Lisp_Object ret = Qnil;
2071 NSAutoreleasePool *pool;
2074 pool = [[NSAutoreleasePool alloc] init];
2075 utfStr = [NSString stringWithUTF8String: SSDATA (str)];
2076 #ifdef NS_IMPL_COCOA
2078 utfStr = [utfStr precomposedStringWithCanonicalMapping];
2082 const char *cstr = [utfStr UTF8String];
2084 ret = build_string (cstr);
2089 error ("Invalid UTF-8");
2095 #ifdef NS_IMPL_COCOA
2097 /* Compile and execute the AppleScript SCRIPT and return the error
2098 status as function value. A zero is returned if compilation and
2099 execution is successful, in which case *RESULT is set to a Lisp
2100 string or a number containing the resulting script value. Otherwise,
2103 ns_do_applescript (Lisp_Object script, Lisp_Object *result)
2105 NSAppleEventDescriptor *desc;
2106 NSDictionary* errorDict;
2107 NSAppleEventDescriptor* returnDescriptor = NULL;
2109 NSAppleScript* scriptObject =
2110 [[NSAppleScript alloc] initWithSource:
2111 [NSString stringWithUTF8String: SSDATA (script)]];
2113 returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2114 [scriptObject release];
2117 if (returnDescriptor != NULL)
2119 // successful execution
2120 if (kAENullEvent != [returnDescriptor descriptorType])
2123 // script returned an AppleScript result
2124 if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2125 #if defined (NS_IMPL_COCOA)
2126 (typeUTF16ExternalRepresentation
2127 == [returnDescriptor descriptorType]) ||
2129 (typeUTF8Text == [returnDescriptor descriptorType]) ||
2130 (typeCString == [returnDescriptor descriptorType]))
2132 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2134 *result = build_string([[desc stringValue] UTF8String]);
2138 /* use typeUTF16ExternalRepresentation? */
2139 // coerce the result to the appropriate ObjC type
2140 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2142 *result = make_number([desc int32Value]);
2148 // no script result, return error
2154 /* Helper function called from sendEvent to run applescript
2155 from within the main event loop. */
2158 ns_run_ascript (void)
2160 if (! NILP (as_script))
2161 as_status = ns_do_applescript (as_script, as_result);
2165 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2166 doc: /* Execute AppleScript SCRIPT and return the result.
2167 If compilation and execution are successful, the resulting script value
2168 is returned as a string, a number or, in the case of other constructs, t.
2169 In case the execution fails, an error is signaled. */)
2170 (Lisp_Object script)
2175 struct input_event ev;
2177 CHECK_STRING (script);
2178 check_window_system (NULL);
2183 as_result = &result;
2185 /* executing apple script requires the event loop to run, otherwise
2186 errors aren't returned and executeAndReturnError hangs forever.
2187 Post an event that runs applescript and then start the event loop.
2188 The event loop is exited when the script is done. */
2189 nxev = [NSEvent otherEventWithType: NSApplicationDefined
2190 location: NSMakePoint (0, 0)
2193 windowNumber: [[NSApp mainWindow] windowNumber]
2194 context: [NSApp context]
2197 data2: NSAPP_DATA2_RUNASSCRIPT];
2199 [NSApp postEvent: nxev atStart: NO];
2201 // If there are other events, the event loop may exit. Keep running
2202 // until the script has been handled. */
2203 ns_init_events (&ev);
2204 while (! NILP (as_script))
2206 ns_finish_events ();
2214 else if (!STRINGP (result))
2215 error ("AppleScript error %d", status);
2217 error ("%s", SSDATA (result));
2223 /* ==========================================================================
2225 Miscellaneous functions not called through hooks
2227 ========================================================================== */
2229 /* called from frame.c */
2230 struct ns_display_info *
2231 check_x_display_info (Lisp_Object frame)
2233 return check_ns_display_info (frame);
2238 x_set_scroll_bar_default_width (struct frame *f)
2240 int wid = FRAME_COLUMN_WIDTH (f);
2241 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2242 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2247 x_set_scroll_bar_default_height (struct frame *f)
2249 int height = FRAME_LINE_HEIGHT (f);
2250 FRAME_CONFIG_SCROLL_BAR_HEIGHT (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2251 FRAME_CONFIG_SCROLL_BAR_LINES (f) = (FRAME_CONFIG_SCROLL_BAR_HEIGHT (f) +
2252 height - 1) / height;
2255 /* terms impl this instead of x-get-resource directly */
2257 x_get_string_resource (XrmDatabase rdb, const char *name, const char *class)
2259 /* remove appname prefix; TODO: allow for !="Emacs" */
2260 const char *res, *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2262 check_window_system (NULL);
2264 if (inhibit_x_resources)
2265 /* --quick was passed, so this is a no-op. */
2268 res = ns_get_defaults_value (toCheck);
2269 return (!res ? NULL :
2270 (!c_strncasecmp (res, "YES", 3) ? "true" :
2271 (!c_strncasecmp (res, "NO", 2) ? "false" : (char *) res)));
2276 x_get_focus_frame (struct frame *frame)
2278 struct ns_display_info *dpyinfo = FRAME_DISPLAY_INFO (frame);
2279 Lisp_Object nsfocus;
2281 if (!dpyinfo->x_focus_frame)
2284 XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2288 /* ==========================================================================
2290 Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2292 ========================================================================== */
2295 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2296 doc: /* Internal function called by `color-defined-p', which see.
2297 \(Note that the Nextstep version of this function ignores FRAME.) */)
2298 (Lisp_Object color, Lisp_Object frame)
2301 check_window_system (NULL);
2302 return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2306 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2307 doc: /* Internal function called by `color-values', which see. */)
2308 (Lisp_Object color, Lisp_Object frame)
2311 EmacsCGFloat red, green, blue, alpha;
2313 check_window_system (NULL);
2314 CHECK_STRING (color);
2317 if (ns_lisp_to_color (color, &col))
2323 [[col colorUsingDefaultColorSpace]
2324 getRed: &red green: &green blue: &blue alpha: &alpha];
2326 return list3i (lrint (red * 65280), lrint (green * 65280),
2327 lrint (blue * 65280));
2331 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2332 doc: /* Internal function called by `display-color-p', which see. */)
2333 (Lisp_Object terminal)
2335 NSWindowDepth depth;
2336 NSString *colorSpace;
2338 check_ns_display_info (terminal);
2339 depth = [[[NSScreen screens] objectAtIndex:0] depth];
2340 colorSpace = NSColorSpaceFromDepth (depth);
2342 return [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2343 || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2348 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
2350 doc: /* Return t if the Nextstep display supports shades of gray.
2351 Note that color displays do support shades of gray.
2352 The optional argument TERMINAL specifies which display to ask about.
2353 TERMINAL should be a terminal object, a frame or a display name (a string).
2354 If omitted or nil, that stands for the selected frame's display. */)
2355 (Lisp_Object terminal)
2357 NSWindowDepth depth;
2359 check_ns_display_info (terminal);
2360 depth = [[[NSScreen screens] objectAtIndex:0] depth];
2362 return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2366 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2368 doc: /* Return the width in pixels of the Nextstep display TERMINAL.
2369 The optional argument TERMINAL specifies which display to ask about.
2370 TERMINAL should be a terminal object, a frame or a display name (a string).
2371 If omitted or nil, that stands for the selected frame's display.
2373 On \"multi-monitor\" setups this refers to the pixel width for all
2374 physical monitors associated with TERMINAL. To get information for
2375 each physical monitor, use `display-monitor-attributes-list'. */)
2376 (Lisp_Object terminal)
2378 struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
2380 return make_number (x_display_pixel_width (dpyinfo));
2384 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2385 Sx_display_pixel_height, 0, 1, 0,
2386 doc: /* Return the height in pixels of the Nextstep display TERMINAL.
2387 The optional argument TERMINAL specifies which display to ask about.
2388 TERMINAL should be a terminal object, a frame or a display name (a string).
2389 If omitted or nil, that stands for the selected frame's display.
2391 On \"multi-monitor\" setups this refers to the pixel height for all
2392 physical monitors associated with TERMINAL. To get information for
2393 each physical monitor, use `display-monitor-attributes-list'. */)
2394 (Lisp_Object terminal)
2396 struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
2398 return make_number (x_display_pixel_height (dpyinfo));
2401 #ifdef NS_IMPL_COCOA
2403 /* Returns the name for the screen that OBJ represents, or NULL.
2404 Caller must free return value.
2408 ns_get_name_from_ioreg (io_object_t obj)
2412 NSDictionary *info = (NSDictionary *)
2413 IODisplayCreateInfoDictionary (obj, kIODisplayOnlyPreferredName);
2414 NSDictionary *names = [info objectForKey:
2415 [NSString stringWithUTF8String:
2416 kDisplayProductName]];
2418 if ([names count] > 0)
2420 NSString *n = [names objectForKey: [[names allKeys]
2422 if (n != nil) name = xstrdup ([n UTF8String]);
2430 /* Returns the name for the screen that DID came from, or NULL.
2431 Caller must free return value.
2435 ns_screen_name (CGDirectDisplayID did)
2439 #if MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_9
2440 mach_port_t masterPort;
2444 // CGDisplayIOServicePort is deprecated. Do it another (harder) way.
2446 if (IOMasterPort (MACH_PORT_NULL, &masterPort) != kIOReturnSuccess
2447 || IOServiceGetMatchingServices (masterPort,
2448 IOServiceMatching ("IONDRVDevice"),
2449 &it) != kIOReturnSuccess)
2452 /* Must loop until we find a name. Many devices can have the same unit
2453 number (represents different GPU parts), but only one has a name. */
2454 while (! name && (obj = IOIteratorNext (it)))
2456 CFMutableDictionaryRef props;
2459 if (IORegistryEntryCreateCFProperties (obj,
2461 kCFAllocatorDefault,
2462 kNilOptions) == kIOReturnSuccess
2464 && (val = CFDictionaryGetValue(props, @"IOFBDependentIndex")))
2466 unsigned nr = [(NSNumber *)val unsignedIntegerValue];
2467 if (nr == CGDisplayUnitNumber (did))
2468 name = ns_get_name_from_ioreg (obj);
2472 IOObjectRelease (obj);
2475 IOObjectRelease (it);
2479 name = ns_get_name_from_ioreg (CGDisplayIOServicePort (did));
2487 ns_make_monitor_attribute_list (struct MonitorInfo *monitors,
2489 int primary_monitor,
2492 Lisp_Object monitor_frames = Fmake_vector (make_number (n_monitors), Qnil);
2493 Lisp_Object frame, rest;
2494 NSArray *screens = [NSScreen screens];
2497 FOR_EACH_FRAME (rest, frame)
2499 struct frame *f = XFRAME (frame);
2503 NSView *view = FRAME_NS_VIEW (f);
2504 NSScreen *screen = [[view window] screen];
2508 for (k = 0; i == -1 && k < [screens count]; ++k)
2510 if ([screens objectAtIndex: k] == screen)
2515 ASET (monitor_frames, i, Fcons (frame, AREF (monitor_frames, i)));
2519 return make_monitor_attribute_list (monitors, n_monitors, primary_monitor,
2520 monitor_frames, source);
2523 DEFUN ("ns-display-monitor-attributes-list",
2524 Fns_display_monitor_attributes_list,
2525 Sns_display_monitor_attributes_list,
2527 doc: /* Return a list of physical monitor attributes on the X display TERMINAL.
2529 The optional argument TERMINAL specifies which display to ask about.
2530 TERMINAL should be a terminal object, a frame or a display name (a string).
2531 If omitted or nil, that stands for the selected frame's display.
2533 In addition to the standard attribute keys listed in
2534 `display-monitor-attributes-list', the following keys are contained in
2537 source -- String describing the source from which multi-monitor
2538 information is obtained, \"NS\" is always the source."
2540 Internal use only, use `display-monitor-attributes-list' instead. */)
2541 (Lisp_Object terminal)
2543 struct terminal *term = decode_live_terminal (terminal);
2545 NSUInteger i, n_monitors;
2546 struct MonitorInfo *monitors;
2547 Lisp_Object attributes_list = Qnil;
2548 CGFloat primary_display_height = 0;
2550 if (term->type != output_ns)
2553 screens = [NSScreen screens];
2554 n_monitors = [screens count];
2555 if (n_monitors == 0)
2558 monitors = xzalloc (n_monitors * sizeof *monitors);
2560 for (i = 0; i < [screens count]; ++i)
2562 NSScreen *s = [screens objectAtIndex:i];
2563 struct MonitorInfo *m = &monitors[i];
2564 NSRect fr = [s frame];
2565 NSRect vfr = [s visibleFrame];
2568 #ifdef NS_IMPL_COCOA
2569 NSDictionary *dict = [s deviceDescription];
2570 NSNumber *nid = [dict objectForKey:@"NSScreenNumber"];
2571 CGDirectDisplayID did = [nid unsignedIntValue];
2575 primary_display_height = fr.size.height;
2576 y = (short) fr.origin.y;
2577 vy = (short) vfr.origin.y;
2581 // Flip y coordinate as NS has y starting from the bottom.
2582 y = (short) (primary_display_height - fr.size.height - fr.origin.y);
2583 vy = (short) (primary_display_height -
2584 vfr.size.height - vfr.origin.y);
2587 m->geom.x = (short) fr.origin.x;
2589 m->geom.width = (unsigned short) fr.size.width;
2590 m->geom.height = (unsigned short) fr.size.height;
2592 m->work.x = (short) vfr.origin.x;
2593 // y is flipped on NS, so vy - y are pixels missing at the bottom,
2594 // and fr.size.height - vfr.size.height are pixels missing in total.
2595 // Pixels missing at top are
2596 // fr.size.height - vfr.size.height - vy + y.
2597 // work.y is then pixels missing at top + y.
2598 m->work.y = (short) (fr.size.height - vfr.size.height) - vy + y + y;
2599 m->work.width = (unsigned short) vfr.size.width;
2600 m->work.height = (unsigned short) vfr.size.height;
2602 #ifdef NS_IMPL_COCOA
2603 m->name = ns_screen_name (did);
2606 CGSize mms = CGDisplayScreenSize (did);
2607 m->mm_width = (int) mms.width;
2608 m->mm_height = (int) mms.height;
2612 // Assume 92 dpi as x-display-mm-height/x-display-mm-width does.
2613 m->mm_width = (int) (25.4 * fr.size.width / 92.0);
2614 m->mm_height = (int) (25.4 * fr.size.height / 92.0);
2618 // Primary monitor is always first for NS.
2619 attributes_list = ns_make_monitor_attribute_list (monitors, n_monitors,
2622 free_monitors (monitors, n_monitors);
2623 return attributes_list;
2627 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2629 doc: /* Return the number of bitplanes of the Nextstep display TERMINAL.
2630 The optional argument TERMINAL specifies which display to ask about.
2631 TERMINAL should be a terminal object, a frame or a display name (a string).
2632 If omitted or nil, that stands for the selected frame's display. */)
2633 (Lisp_Object terminal)
2635 check_ns_display_info (terminal);
2637 (NSBitsPerPixelFromDepth ([[[NSScreen screens] objectAtIndex:0] depth]));
2641 DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
2643 doc: /* Returns the number of color cells of the Nextstep display TERMINAL.
2644 The optional argument TERMINAL specifies which display to ask about.
2645 TERMINAL should be a terminal object, a frame or a display name (a string).
2646 If omitted or nil, that stands for the selected frame's display. */)
2647 (Lisp_Object terminal)
2649 struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
2650 /* We force 24+ bit depths to 24-bit to prevent an overflow. */
2651 return make_number (1 << min (dpyinfo->n_planes, 24));
2655 /* Unused dummy def needed for compatibility. */
2656 Lisp_Object tip_frame;
2658 /* TODO: move to xdisp or similar */
2660 compute_tip_xy (struct frame *f,
2669 Lisp_Object left, top;
2670 EmacsView *view = FRAME_NS_VIEW (f);
2671 struct ns_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
2674 /* Start with user-specified or mouse position. */
2675 left = Fcdr (Fassq (Qleft, parms));
2676 top = Fcdr (Fassq (Qtop, parms));
2678 if (!INTEGERP (left) || !INTEGERP (top))
2680 pt.x = dpyinfo->last_mouse_motion_x;
2681 pt.y = dpyinfo->last_mouse_motion_y;
2682 /* Convert to screen coordinates */
2683 pt = [view convertPoint: pt toView: nil];
2684 #if !defined (NS_IMPL_COCOA) || MAC_OS_X_VERSION_MAX_ALLOWED < MAC_OS_X_VERSION_10_7
2685 pt = [[view window] convertBaseToScreen: pt];
2688 NSRect r = NSMakeRect (pt.x, pt.y, 0, 0);
2689 r = [[view window] convertRectToScreen: r];
2697 /* Absolute coordinates. */
2699 pt.y = x_display_pixel_height (FRAME_DISPLAY_INFO (f)) - XINT (top)
2703 /* Ensure in bounds. (Note, screen origin = lower left.) */
2704 if (INTEGERP (left))
2706 else if (pt.x + XINT (dx) <= 0)
2707 *root_x = 0; /* Can happen for negative dx */
2708 else if (pt.x + XINT (dx) + width
2709 <= x_display_pixel_width (FRAME_DISPLAY_INFO (f)))
2710 /* It fits to the right of the pointer. */
2711 *root_x = pt.x + XINT (dx);
2712 else if (width + XINT (dx) <= pt.x)
2713 /* It fits to the left of the pointer. */
2714 *root_x = pt.x - width - XINT (dx);
2716 /* Put it left justified on the screen -- it ought to fit that way. */
2721 else if (pt.y - XINT (dy) - height >= 0)
2722 /* It fits below the pointer. */
2723 *root_y = pt.y - height - XINT (dy);
2724 else if (pt.y + XINT (dy) + height
2725 <= x_display_pixel_height (FRAME_DISPLAY_INFO (f)))
2726 /* It fits above the pointer */
2727 *root_y = pt.y + XINT (dy);
2729 /* Put it on the top. */
2730 *root_y = x_display_pixel_height (FRAME_DISPLAY_INFO (f)) - height;
2734 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2735 doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2736 A tooltip window is a small window displaying a string.
2738 This is an internal function; Lisp code should call `tooltip-show'.
2740 FRAME nil or omitted means use the selected frame.
2742 PARMS is an optional list of frame parameters which can be used to
2743 change the tooltip's appearance.
2745 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
2746 means use the default timeout of 5 seconds.
2748 If the list of frame parameters PARMS contains a `left' parameter,
2749 the tooltip is displayed at that x-position. Otherwise it is
2750 displayed at the mouse position, with offset DX added (default is 5 if
2751 DX isn't specified). Likewise for the y-position; if a `top' frame
2752 parameter is specified, it determines the y-position of the tooltip
2753 window, otherwise it is displayed at the mouse position, with offset
2754 DY added (default is -10).
2756 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2757 Text larger than the specified size is clipped. */)
2758 (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
2761 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2762 ptrdiff_t count = SPECPDL_INDEX ();
2767 specbind (Qinhibit_redisplay, Qt);
2769 GCPRO4 (string, parms, frame, timeout);
2771 CHECK_STRING (string);
2772 str = SSDATA (string);
2773 f = decode_window_system_frame (frame);
2775 timeout = make_number (5);
2777 CHECK_NATNUM (timeout);
2780 dx = make_number (5);
2785 dy = make_number (-10);
2790 if (ns_tooltip == nil)
2791 ns_tooltip = [[EmacsTooltip alloc] init];
2795 [ns_tooltip setText: str];
2796 size = [ns_tooltip frame].size;
2798 /* Move the tooltip window where the mouse pointer is. Resize and
2800 compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2803 [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2807 return unbind_to (count, Qnil);
2811 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2812 doc: /* Hide the current tooltip window, if there is any.
2813 Value is t if tooltip was open, nil otherwise. */)
2816 if (ns_tooltip == nil || ![ns_tooltip isActive])
2822 DEFUN ("x-frame-geometry", Fx_frame_geometry, Sx_frame_geometry, 0, 1, 0,
2823 doc: /* Return geometric attributes of frame FRAME.
2825 FRAME must be a live frame and defaults to the selected one.
2827 The return value is an association list containing the following
2828 elements (all size values are in pixels).
2830 - `frame-outer-size' is a cons of the outer width and height of FRAME.
2831 The outer size include the title bar and the external borders as well
2832 as any menu and/or tool bar of frame.
2834 - `border' is a cons of the horizontal and vertical width of FRAME's
2837 - `title-bar-height' is the height of the title bar of FRAME.
2839 - `menu-bar-external' if t means the menu bar is external (not
2840 included in the inner edges of FRAME).
2842 - `menu-bar-size' is a cons of the width and height of the menu bar of
2845 - `tool-bar-external' if t means the tool bar is external (not
2846 included in the inner edges of FRAME).
2848 - `tool-bar-side' tells tells on which side the tool bar on FRAME is and
2849 can be one of `left', `top', `right' or `bottom'.
2851 - `tool-bar-size' is a cons of the width and height of the tool bar of
2854 - `frame-inner-size' is a cons of the inner width and height of FRAME.
2855 This excludes FRAME's title bar and external border as well as any
2856 external menu and/or tool bar. */)
2859 struct frame *f = decode_live_frame (frame);
2860 int inner_width = FRAME_PIXEL_WIDTH (f);
2861 int inner_height = FRAME_PIXEL_HEIGHT (f);
2862 Lisp_Object fullscreen = Fframe_parameter (frame, Qfullscreen);
2863 int border = f->border_width;
2864 int title = FRAME_NS_TITLEBAR_HEIGHT (f);
2865 int outer_width = FRAME_PIXEL_WIDTH (f) + 2 * border;
2866 int outer_height = FRAME_PIXEL_HEIGHT (f) + 2 * border;
2867 int tool_bar_height = FRAME_TOOLBAR_HEIGHT (f);
2868 int tool_bar_width = tool_bar_height > 0
2869 ? outer_width - 2 * FRAME_INTERNAL_BORDER_WIDTH (f)
2872 int menu_bar_height = 0;
2873 int menu_bar_width = 0;
2876 listn (CONSTYPE_HEAP, 10,
2877 Fcons (Qframe_position,
2878 Fcons (make_number (f->left_pos), make_number (f->top_pos))),
2879 Fcons (Qframe_outer_size,
2880 Fcons (make_number (outer_width), make_number (outer_height))),
2881 Fcons (Qexternal_border_size,
2882 ((EQ (fullscreen, Qfullboth) || EQ (fullscreen, Qfullscreen))
2883 ? Fcons (make_number (0), make_number (0))
2884 : Fcons (make_number (border), make_number (border)))),
2885 Fcons (Qtitle_height,
2886 ((EQ (fullscreen, Qfullboth) || EQ (fullscreen, Qfullscreen))
2888 : make_number (title))),
2889 Fcons (Qmenu_bar_external, FRAME_EXTERNAL_MENU_BAR (f) ? Qt : Qnil),
2890 Fcons (Qmenu_bar_size,
2891 Fcons (make_number (menu_bar_width),
2892 make_number (menu_bar_height))),
2893 Fcons (Qtool_bar_external, FRAME_EXTERNAL_TOOL_BAR (f) ? Qt : Qnil),
2894 Fcons (Qtool_bar_position, FRAME_TOOL_BAR_POSITION (f)),
2895 Fcons (Qtool_bar_size,
2896 Fcons (make_number (tool_bar_width),
2897 make_number (tool_bar_height))),
2898 Fcons (Qframe_inner_size,
2899 Fcons (make_number (inner_width),
2900 make_number (inner_height))));
2904 /* ==========================================================================
2906 Class implementations
2908 ========================================================================== */
2911 Handle arrow/function/control keys and copy/paste/cut in file dialogs.
2912 Return YES if handled, NO if not.
2915 handlePanelKeys (NSSavePanel *panel, NSEvent *theEvent)
2921 if ([theEvent type] != NSKeyDown) return NO;
2922 s = [theEvent characters];
2924 for (i = 0; i < [s length]; ++i)
2926 int ch = (int) [s characterAtIndex: i];
2929 case NSHomeFunctionKey:
2930 case NSDownArrowFunctionKey:
2931 case NSUpArrowFunctionKey:
2932 case NSLeftArrowFunctionKey:
2933 case NSRightArrowFunctionKey:
2934 case NSPageUpFunctionKey:
2935 case NSPageDownFunctionKey:
2936 case NSEndFunctionKey:
2937 /* Don't send command modified keys, as those are handled in the
2938 performKeyEquivalent method of the super class.
2940 if (! ([theEvent modifierFlags] & NSCommandKeyMask))
2942 [panel sendEvent: theEvent];
2946 /* As we don't have the standard key commands for
2947 copy/paste/cut/select-all in our edit menu, we must handle
2948 them here. TODO: handle Emacs key bindings for copy/cut/select-all
2949 here, paste works, because we have that in our Edit menu.
2950 I.e. refactor out code in nsterm.m, keyDown: to figure out the
2956 case 'a': // Select all
2957 if ([theEvent modifierFlags] & NSCommandKeyMask)
2966 : @selector(selectAll:))))
2971 // Send all control keys, as the text field supports C-a, C-f, C-e
2973 if ([theEvent modifierFlags] & NSControlKeyMask)
2975 [panel sendEvent: theEvent];
2986 @implementation EmacsSavePanel
2987 - (BOOL)performKeyEquivalent:(NSEvent *)theEvent
2989 BOOL ret = handlePanelKeys (self, theEvent);
2991 ret = [super performKeyEquivalent:theEvent];
2997 @implementation EmacsOpenPanel
2998 - (BOOL)performKeyEquivalent:(NSEvent *)theEvent
3000 // NSOpenPanel inherits NSSavePanel, so passing self is OK.
3001 BOOL ret = handlePanelKeys (self, theEvent);
3003 ret = [super performKeyEquivalent:theEvent];
3009 @implementation EmacsFileDelegate
3010 /* --------------------------------------------------------------------------
3011 Delegate methods for Open/Save panels
3012 -------------------------------------------------------------------------- */
3013 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
3017 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
3021 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
3022 confirmed: (BOOL)okFlag
3031 /* ==========================================================================
3033 Lisp interface declaration
3035 ========================================================================== */
3039 syms_of_nsfns (void)
3041 DEFSYM (Qfontsize, "fontsize");
3043 DEFVAR_LISP ("ns-icon-type-alist", Vns_icon_type_alist,
3044 doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
3045 If the title of a frame matches REGEXP, then IMAGE.tiff is
3046 selected as the image of the icon representing the frame when it's
3047 miniaturized. If an element is t, then Emacs tries to select an icon
3048 based on the filetype of the visited file.
3050 The images have to be installed in a folder called English.lproj in the
3051 Emacs folder. You have to restart Emacs after installing new icons.
3053 Example: Install an icon Gnus.tiff and execute the following code
3055 (setq ns-icon-type-alist
3056 (append ns-icon-type-alist
3057 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
3060 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
3061 be used as the image of the icon representing the frame. */);
3062 Vns_icon_type_alist = list1 (Qt);
3064 DEFVAR_LISP ("ns-version-string", Vns_version_string,
3065 doc: /* Toolkit version for NS Windowing. */);
3066 Vns_version_string = ns_appkit_version_str ();
3068 defsubr (&Sns_read_file_name);
3069 defsubr (&Sns_get_resource);
3070 defsubr (&Sns_set_resource);
3071 defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
3072 defsubr (&Sx_display_grayscale_p);
3073 defsubr (&Sns_font_name);
3074 defsubr (&Sns_list_colors);
3075 #ifdef NS_IMPL_COCOA
3076 defsubr (&Sns_do_applescript);
3078 defsubr (&Sxw_color_defined_p);
3079 defsubr (&Sxw_color_values);
3080 defsubr (&Sx_server_max_request_size);
3081 defsubr (&Sx_server_vendor);
3082 defsubr (&Sx_server_version);
3083 defsubr (&Sx_display_pixel_width);
3084 defsubr (&Sx_display_pixel_height);
3085 defsubr (&Sns_display_monitor_attributes_list);
3086 defsubr (&Sx_frame_geometry);
3087 defsubr (&Sx_display_mm_width);
3088 defsubr (&Sx_display_mm_height);
3089 defsubr (&Sx_display_screens);
3090 defsubr (&Sx_display_planes);
3091 defsubr (&Sx_display_color_cells);
3092 defsubr (&Sx_display_visual_class);
3093 defsubr (&Sx_display_backing_store);
3094 defsubr (&Sx_display_save_under);
3095 defsubr (&Sx_create_frame);
3096 defsubr (&Sx_open_connection);
3097 defsubr (&Sx_close_connection);
3098 defsubr (&Sx_display_list);
3100 defsubr (&Sns_hide_others);
3101 defsubr (&Sns_hide_emacs);
3102 defsubr (&Sns_emacs_info_panel);
3103 defsubr (&Sns_list_services);
3104 defsubr (&Sns_perform_service);
3105 defsubr (&Sns_convert_utf8_nfd_to_nfc);
3106 defsubr (&Sns_popup_font_panel);
3107 defsubr (&Sns_popup_color_panel);
3109 defsubr (&Sx_show_tip);
3110 defsubr (&Sx_hide_tip);