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 int fns_trace_num = 1;
49 #define NSTRACE(x) fprintf (stderr, "%s:%d: [%d] " #x "\n", \
50 __FILE__, __LINE__, ++fns_trace_num)
57 extern NSArray *ns_send_types, *ns_return_types, *ns_drag_types;
59 extern Lisp_Object Qforeground_color;
60 extern Lisp_Object Qbackground_color;
61 extern Lisp_Object Qcursor_color;
62 extern Lisp_Object Qinternal_border_width;
63 extern Lisp_Object Qvisibility;
64 extern Lisp_Object Qcursor_type;
65 extern Lisp_Object Qicon_type;
66 extern Lisp_Object Qicon_name;
67 extern Lisp_Object Qicon_left;
68 extern Lisp_Object Qicon_top;
69 extern Lisp_Object Qleft;
70 extern Lisp_Object Qright;
71 extern Lisp_Object Qtop;
72 extern Lisp_Object Qdisplay;
73 extern Lisp_Object Qvertical_scroll_bars;
74 extern Lisp_Object Qauto_raise;
75 extern Lisp_Object Qauto_lower;
76 extern Lisp_Object Qbox;
77 extern Lisp_Object Qscroll_bar_width;
78 extern Lisp_Object Qx_resource_name;
79 extern Lisp_Object Qface_set_after_frame_default;
80 extern Lisp_Object Qunderline, Qundefined;
81 extern Lisp_Object Qheight, Qminibuffer, Qname, Qonly, Qwidth;
82 extern Lisp_Object Qunsplittable, Qmenu_bar_lines, Qbuffer_predicate, Qtitle;
85 Lisp_Object Qbuffered;
86 Lisp_Object Qfontsize;
88 /* hack for OS X file panels */
91 EmacsTooltip *ns_tooltip;
93 /* Need forward declaration here to preserve organizational integrity of file */
94 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
96 /* Static variables to handle applescript execution. */
97 static Lisp_Object as_script, *as_result;
101 static ptrdiff_t image_cache_refcount;
104 /* ==========================================================================
106 Internal utility functions
108 ========================================================================== */
115 error ("OpenStep is not in use or not initialized");
119 /* Nonzero if we can use mouse menus. */
127 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
128 and checking validity for NS. */
130 check_ns_frame (Lisp_Object frame)
135 f = SELECTED_FRAME ();
138 CHECK_LIVE_FRAME (frame);
141 if (! FRAME_NS_P (f))
142 error ("non-Nextstep frame used");
147 /* Let the user specify an Nextstep display with a frame.
148 nil stands for the selected frame--or, if that is not an Nextstep frame,
149 the first Nextstep display on the list. */
150 static struct ns_display_info *
151 check_ns_display_info (Lisp_Object frame)
155 struct frame *f = SELECTED_FRAME ();
156 if (FRAME_NS_P (f) && FRAME_LIVE_P (f) )
157 return FRAME_NS_DISPLAY_INFO (f);
158 else if (x_display_list != 0)
159 return x_display_list;
161 error ("Nextstep windows are not in use or not initialized");
163 else if (INTEGERP (frame))
165 struct terminal *t = get_terminal (frame, 1);
167 if (t->type != output_ns)
168 error ("Terminal %"pI"d is not a Nextstep display", XINT (frame));
170 return t->display_info.ns;
172 else if (STRINGP (frame))
173 return ns_display_info_for_name (frame);
178 CHECK_LIVE_FRAME (frame);
180 if (! FRAME_NS_P (f))
181 error ("non-Nextstep frame used");
182 return FRAME_NS_DISPLAY_INFO (f);
184 return NULL; /* shut compiler up */
189 ns_get_window (Lisp_Object maybeFrame)
191 id view =nil, window =nil;
193 if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
194 maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
196 if (!NILP (maybeFrame))
197 view = FRAME_NS_VIEW (XFRAME (maybeFrame));
198 if (view) window =[view window];
205 ns_get_screen (Lisp_Object screen)
208 struct terminal *terminal;
210 if (EQ (Qt, screen)) /* not documented */
211 return [NSScreen mainScreen];
213 terminal = get_terminal (screen, 1);
214 if (terminal->type != output_ns)
218 f = SELECTED_FRAME ();
219 else if (FRAMEP (screen))
223 struct ns_display_info *dpyinfo = terminal->display_info.ns;
224 f = dpyinfo->x_focus_frame
225 ? dpyinfo->x_focus_frame : dpyinfo->x_highlight_frame;
228 return ((f && FRAME_NS_P (f)) ? [[FRAME_NS_VIEW (f) window] screen]
233 /* Return the X display structure for the display named NAME.
234 Open a new connection if necessary. */
235 struct ns_display_info *
236 ns_display_info_for_name (Lisp_Object name)
239 struct ns_display_info *dpyinfo;
243 for (dpyinfo = x_display_list, names = ns_display_name_list;
245 dpyinfo = dpyinfo->next, names = XCDR (names))
248 tem = Fstring_equal (XCAR (XCAR (names)), name);
253 error ("Emacs for OpenStep does not yet support multi-display.");
255 Fx_open_connection (name, Qnil, Qnil);
256 dpyinfo = x_display_list;
259 error ("OpenStep on %s not responding.\n", SDATA (name));
265 ns_filename_from_panel (NSSavePanel *panel)
267 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
268 NSURL *url = [panel URL];
269 NSString *str = [url path];
272 return [panel filename];
277 ns_directory_from_panel (NSSavePanel *panel)
279 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
280 NSURL *url = [panel directoryURL];
281 NSString *str = [url path];
284 return [panel directory];
289 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
290 /* --------------------------------------------------------------------------
291 Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
292 -------------------------------------------------------------------------- */
302 count = [menu numberOfItems];
303 for (i = 0; i<count; i++)
305 item = [menu itemAtIndex: i];
306 name = [[item title] UTF8String];
309 nameStr = build_string (name);
311 if ([item hasSubmenu])
313 old = interpret_services_menu ([item submenu],
314 Fcons (nameStr, prefix), old);
318 keys = [item keyEquivalent];
319 if (keys && [keys length] )
321 key = [keys characterAtIndex: 0];
322 res = make_number (key|super_modifier);
328 old = Fcons (Fcons (res,
329 Freverse (Fcons (nameStr,
339 /* ==========================================================================
341 Frame parameter setters
343 ========================================================================== */
347 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
350 CGFloat r, g, b, alpha;
352 if (ns_lisp_to_color (arg, &col))
354 store_frame_param (f, Qforeground_color, oldval);
355 error ("Unknown color");
359 [f->output_data.ns->foreground_color release];
360 f->output_data.ns->foreground_color = col;
362 [col getRed: &r green: &g blue: &b alpha: &alpha];
363 FRAME_FOREGROUND_PIXEL (f) =
364 ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
366 if (FRAME_NS_VIEW (f))
368 update_face_from_frame_parameter (f, Qforeground_color, arg);
369 /*recompute_basic_faces (f); */
370 if (FRAME_VISIBLE_P (f))
377 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
381 NSView *view = FRAME_NS_VIEW (f);
382 CGFloat r, g, b, alpha;
384 if (ns_lisp_to_color (arg, &col))
386 store_frame_param (f, Qbackground_color, oldval);
387 error ("Unknown color");
390 /* clear the frame; in some instances the NS-internal GC appears not to
391 update, or it does update and cannot clear old text properly */
392 if (FRAME_VISIBLE_P (f))
396 [f->output_data.ns->background_color release];
397 f->output_data.ns->background_color = col;
399 [col getRed: &r green: &g blue: &b alpha: &alpha];
400 FRAME_BACKGROUND_PIXEL (f) =
401 ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
405 [[view window] setBackgroundColor: col];
408 [[view window] setOpaque: NO];
410 [[view window] setOpaque: YES];
412 face = FRAME_DEFAULT_FACE (f);
415 col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
416 face->background = ns_index_color
417 ([col colorWithAlphaComponent: alpha], f);
419 update_face_from_frame_parameter (f, Qbackground_color, arg);
422 if (FRAME_VISIBLE_P (f))
429 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
433 if (ns_lisp_to_color (arg, &col))
435 store_frame_param (f, Qcursor_color, oldval);
436 error ("Unknown color");
439 [FRAME_CURSOR_COLOR (f) release];
440 FRAME_CURSOR_COLOR (f) = [col retain];
442 if (FRAME_VISIBLE_P (f))
444 x_update_cursor (f, 0);
445 x_update_cursor (f, 1);
447 update_face_from_frame_parameter (f, Qcursor_color, arg);
452 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
454 NSView *view = FRAME_NS_VIEW (f);
455 NSTRACE (x_set_icon_name);
457 /* see if it's changed */
460 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
463 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
466 fset_icon_name (f, arg);
470 if (!NILP (f->title))
473 /* explicit name and no icon-name -> explicit_name */
474 if (f->explicit_name)
478 /* no explicit name and no icon-name ->
479 name has to be rebuild from icon_title_format */
480 windows_or_buffers_changed++;
485 /* Don't change the name if it's already NAME. */
486 if ([[view window] miniwindowTitle] &&
487 ([[[view window] miniwindowTitle]
488 isEqualToString: [NSString stringWithUTF8String:
492 [[view window] setMiniwindowTitle:
493 [NSString stringWithUTF8String: SSDATA (arg)]];
497 ns_set_name_internal (FRAME_PTR f, Lisp_Object name)
500 Lisp_Object encoded_name, encoded_icon_name;
502 NSView *view = FRAME_NS_VIEW (f);
505 encoded_name = ENCODE_UTF_8 (name);
508 str = [NSString stringWithUTF8String: SSDATA (encoded_name)];
510 /* Don't change the name if it's already NAME. */
511 if (! [[[view window] title] isEqualToString: str])
512 [[view window] setTitle: str];
514 if (!STRINGP (f->icon_name))
515 encoded_icon_name = encoded_name;
517 encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
519 str = [NSString stringWithUTF8String: SSDATA (encoded_icon_name)];
521 if ([[view window] miniwindowTitle] &&
522 ! [[[view window] miniwindowTitle] isEqualToString: str])
523 [[view window] setMiniwindowTitle: str];
528 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
530 NSTRACE (ns_set_name);
532 /* Make sure that requests from lisp code override requests from
533 Emacs redisplay code. */
536 /* If we're switching from explicit to implicit, we had better
537 update the mode lines and thereby update the title. */
538 if (f->explicit_name && NILP (name))
539 update_mode_lines = 1;
541 f->explicit_name = ! NILP (name);
543 else if (f->explicit_name)
547 name = build_string([ns_app_name UTF8String]);
551 /* Don't change the name if it's already NAME. */
552 if (! NILP (Fstring_equal (name, f->name)))
557 /* title overrides explicit name */
558 if (! NILP (f->title))
561 ns_set_name_internal (f, name);
565 /* This function should be called when the user's lisp code has
566 specified a name for the frame; the name will override any set by the
569 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
571 NSTRACE (x_explicitly_set_name);
572 ns_set_name (f, arg, 1);
576 /* This function should be called by Emacs redisplay code to set the
577 name; names set this way will never override names set by the user's
580 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
582 NSTRACE (x_implicitly_set_name);
584 /* Deal with NS specific format t. */
585 if (FRAME_NS_P (f) && ((FRAME_ICONIFIED_P (f) && EQ (Vicon_title_format, Qt))
586 || EQ (Vframe_title_format, Qt)))
587 ns_set_name_as_filename (f);
589 ns_set_name (f, arg, 0);
593 /* Change the title of frame F to NAME.
594 If NAME is nil, use the frame name as the title. */
597 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
599 NSTRACE (x_set_title);
600 /* Don't change the title if it's already NAME. */
601 if (EQ (name, f->title))
604 update_mode_lines = 1;
606 fset_title (f, name);
613 ns_set_name_internal (f, name);
618 ns_set_name_as_filename (struct frame *f)
621 Lisp_Object name, filename;
622 Lisp_Object buf = XWINDOW (f->selected_window)->buffer;
624 NSAutoreleasePool *pool;
626 Lisp_Object encoded_name, encoded_filename;
628 NSTRACE (ns_set_name_as_filename);
630 if (f->explicit_name || ! NILP (f->title))
634 pool = [[NSAutoreleasePool alloc] init];
635 filename = BVAR (XBUFFER (buf), filename);
636 name = BVAR (XBUFFER (buf), name);
640 if (! NILP (filename))
641 name = Ffile_name_nondirectory (filename);
643 name = build_string ([ns_app_name UTF8String]);
647 encoded_name = ENCODE_UTF_8 (name);
650 view = FRAME_NS_VIEW (f);
652 title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
653 : [[[view window] title] UTF8String];
655 if (title && (! strcmp (title, SSDATA (encoded_name))))
662 str = [NSString stringWithUTF8String: SSDATA (encoded_name)];
663 if (str == nil) str = @"Bad coding";
665 if (FRAME_ICONIFIED_P (f))
666 [[view window] setMiniwindowTitle: str];
671 if (! NILP (filename))
674 encoded_filename = ENCODE_UTF_8 (filename);
677 fstr = [NSString stringWithUTF8String: SSDATA (encoded_filename)];
678 if (fstr == nil) fstr = @"";
680 /* work around a bug observed on 10.3 and later where
681 setTitleWithRepresentedFilename does not clear out previous state
682 if given filename does not exist */
683 if (! [[NSFileManager defaultManager] fileExistsAtPath: fstr])
684 [[view window] setRepresentedFilename: @""];
690 [[view window] setRepresentedFilename: fstr];
691 [[view window] setTitle: str];
701 ns_set_doc_edited (struct frame *f, Lisp_Object arg)
703 NSView *view = FRAME_NS_VIEW (f);
704 NSAutoreleasePool *pool;
705 if (!MINI_WINDOW_P (XWINDOW (f->selected_window)))
708 pool = [[NSAutoreleasePool alloc] init];
709 [[view window] setDocumentEdited: !NILP (arg)];
717 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
720 if (FRAME_MINIBUF_ONLY_P (f))
723 if (TYPE_RANGED_INTEGERP (int, value))
724 nlines = XINT (value);
728 FRAME_MENU_BAR_LINES (f) = 0;
731 FRAME_EXTERNAL_MENU_BAR (f) = 1;
732 /* does for all frames, whereas we just want for one frame
733 [NSMenu setMenuBarVisible: YES]; */
737 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
738 free_frame_menubar (f);
739 /* [NSMenu setMenuBarVisible: NO]; */
740 FRAME_EXTERNAL_MENU_BAR (f) = 0;
745 /* toolbar support */
747 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
751 if (FRAME_MINIBUF_ONLY_P (f))
754 if (RANGED_INTEGERP (0, value, INT_MAX))
755 nlines = XFASTINT (value);
761 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
762 update_frame_tool_bar (f);
766 if (FRAME_EXTERNAL_TOOL_BAR (f))
768 free_frame_tool_bar (f);
769 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
773 x_set_window_size (f, 0, f->text_cols, f->text_lines);
778 ns_implicitly_set_icon_type (struct frame *f)
781 EmacsView *view = FRAME_NS_VIEW (f);
783 Lisp_Object chain, elt;
784 NSAutoreleasePool *pool;
787 NSTRACE (ns_implicitly_set_icon_type);
790 pool = [[NSAutoreleasePool alloc] init];
791 if (f->output_data.ns->miniimage
792 && [[NSString stringWithUTF8String: SSDATA (f->name)]
793 isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
800 tem = assq_no_quit (Qicon_type, f->param_alist);
801 if (CONSP (tem) && ! NILP (XCDR (tem)))
808 for (chain = Vns_icon_type_alist;
809 image == nil && CONSP (chain);
810 chain = XCDR (chain))
813 /* special case: 't' means go by file type */
814 if (SYMBOLP (elt) && EQ (elt, Qt) && SSDATA (f->name)[0] == '/')
817 = [NSString stringWithUTF8String: SSDATA (f->name)];
818 if ([[NSFileManager defaultManager] fileExistsAtPath: str])
819 image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
821 else if (CONSP (elt) &&
822 STRINGP (XCAR (elt)) &&
823 STRINGP (XCDR (elt)) &&
824 fast_string_match (XCAR (elt), f->name) >= 0)
826 image = [EmacsImage allocInitFromFile: XCDR (elt)];
828 image = [[NSImage imageNamed:
829 [NSString stringWithUTF8String:
830 SSDATA (XCDR (elt))]] retain];
836 image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
840 [f->output_data.ns->miniimage release];
841 f->output_data.ns->miniimage = image;
842 [view setMiniwindowImage: setMini];
849 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
851 EmacsView *view = FRAME_NS_VIEW (f);
855 NSTRACE (x_set_icon_type);
857 if (!NILP (arg) && SYMBOLP (arg))
859 arg =build_string (SSDATA (SYMBOL_NAME (arg)));
860 store_frame_param (f, Qicon_type, arg);
863 /* do it the implicit way */
866 ns_implicitly_set_icon_type (f);
872 image = [EmacsImage allocInitFromFile: arg];
874 image =[NSImage imageNamed: [NSString stringWithUTF8String:
879 image = [NSImage imageNamed: @"text"];
883 f->output_data.ns->miniimage = image;
884 [view setMiniwindowImage: setMini];
888 /* TODO: move to nsterm? */
890 ns_lisp_to_cursor_type (Lisp_Object arg)
893 if (XTYPE (arg) == Lisp_String)
895 else if (XTYPE (arg) == Lisp_Symbol)
896 str = SSDATA (SYMBOL_NAME (arg));
898 if (!strcmp (str, "box")) return FILLED_BOX_CURSOR;
899 if (!strcmp (str, "hollow")) return HOLLOW_BOX_CURSOR;
900 if (!strcmp (str, "hbar")) return HBAR_CURSOR;
901 if (!strcmp (str, "bar")) return BAR_CURSOR;
902 if (!strcmp (str, "no")) return NO_CURSOR;
908 ns_cursor_type_to_lisp (int arg)
912 case FILLED_BOX_CURSOR: return Qbox;
913 case HOLLOW_BOX_CURSOR: return intern ("hollow");
914 case HBAR_CURSOR: return intern ("hbar");
915 case BAR_CURSOR: return intern ("bar");
917 default: return intern ("no");
921 /* This is the same as the xfns.c definition. */
923 x_set_cursor_type (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
925 set_frame_cursor_types (f, arg);
927 /* Make sure the cursor gets redrawn. */
928 cursor_type_changed = 1;
932 /* called to set mouse pointer color, but all other terms use it to
933 initialize pointer types (and don't set the color ;) */
935 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
937 /* don't think we can do this on Nextstep */
942 #define Xstr(x) Str(x)
945 ns_appkit_version_str (void)
949 #ifdef NS_IMPL_GNUSTEP
950 sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
951 #elif defined(NS_IMPL_COCOA)
952 sprintf(tmp, "apple-appkit-%.2f", NSAppKitVersionNumber);
956 return build_string (tmp);
960 /* This is for use by x-server-version and collapses all version info we
961 have into a single int. For a better picture of the implementation
962 running, use ns_appkit_version_str.*/
964 ns_appkit_version_int (void)
966 #ifdef NS_IMPL_GNUSTEP
967 return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GUI_MINOR_VERSION;
968 #elif defined(NS_IMPL_COCOA)
969 return (int)NSAppKitVersionNumber;
976 x_icon (struct frame *f, Lisp_Object parms)
977 /* --------------------------------------------------------------------------
978 Strangely-named function to set icon position parameters in frame.
979 This is irrelevant under OS X, but might be needed under GNUstep,
980 depending on the window manager used. Note, this is not a standard
981 frame parameter-setter; it is called directly from x-create-frame.
982 -------------------------------------------------------------------------- */
984 Lisp_Object icon_x, icon_y;
985 struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
987 f->output_data.ns->icon_top = Qnil;
988 f->output_data.ns->icon_left = Qnil;
990 /* Set the position of the icon. */
991 icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
992 icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
993 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
995 CHECK_NUMBER (icon_x);
996 CHECK_NUMBER (icon_y);
997 f->output_data.ns->icon_top = icon_y;
998 f->output_data.ns->icon_left = icon_x;
1000 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
1001 error ("Both left and top icon corners of icon must be specified");
1005 /* Note: see frame.c for template, also where generic functions are impl */
1006 frame_parm_handler ns_frame_parm_handlers[] =
1008 x_set_autoraise, /* generic OK */
1009 x_set_autolower, /* generic OK */
1010 x_set_background_color,
1011 0, /* x_set_border_color, may be impossible under Nextstep */
1012 0, /* x_set_border_width, may be impossible under Nextstep */
1015 x_set_font, /* generic OK */
1016 x_set_foreground_color,
1019 x_set_internal_border_width, /* generic OK */
1020 x_set_menu_bar_lines,
1022 x_explicitly_set_name,
1023 x_set_scroll_bar_width, /* generic OK */
1025 x_set_unsplittable, /* generic OK */
1026 x_set_vertical_scroll_bars, /* generic OK */
1027 x_set_visibility, /* generic OK */
1028 x_set_tool_bar_lines,
1029 0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
1030 0, /* x_set_scroll_bar_background, will ignore (not possible on NS) */
1031 x_set_screen_gamma, /* generic OK */
1032 x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
1033 x_set_fringe_width, /* generic OK */
1034 x_set_fringe_width, /* generic OK */
1035 0, /* x_set_wait_for_wm, will ignore */
1036 x_set_fullscreen, /* generic OK */
1037 x_set_font_backend, /* generic OK */
1039 0, /* x_set_sticky */
1040 0, /* x_set_tool_bar_position */
1044 /* Handler for signals raised during x_create_frame.
1045 FRAME is the frame which is partially constructed. */
1048 unwind_create_frame (Lisp_Object frame)
1050 struct frame *f = XFRAME (frame);
1052 /* If frame is already dead, nothing to do. This can happen if the
1053 display is disconnected after the frame has become official, but
1054 before x_create_frame removes the unwind protect. */
1055 if (!FRAME_LIVE_P (f))
1058 /* If frame is ``official'', nothing to do. */
1059 if (NILP (Fmemq (frame, Vframe_list)))
1061 #if defined GLYPH_DEBUG && defined ENABLE_CHECKING
1062 struct ns_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1065 x_free_frame_resources (f);
1069 /* Check that reference counts are indeed correct. */
1070 eassert (dpyinfo->terminal->image_cache->refcount == image_cache_refcount);
1079 * Read geometry related parameters from preferences if not in PARMS.
1080 * Returns the union of parms and any preferences read.
1084 get_geometry_from_preferences (struct ns_display_info *dpyinfo,
1092 { "width", "Width", Qwidth },
1093 { "height", "Height", Qheight },
1094 { "left", "Left", Qleft },
1095 { "top", "Top", Qtop },
1099 for (i = 0; i < sizeof (r)/sizeof (r[0]); ++i)
1101 if (NILP (Fassq (r[i].tem, parms)))
1104 = x_get_arg (dpyinfo, parms, r[i].tem, r[i].val, r[i].cls,
1106 if (! EQ (value, Qunbound))
1107 parms = Fcons (Fcons (r[i].tem, value), parms);
1114 /* ==========================================================================
1118 ========================================================================== */
1120 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1122 doc: /* Make a new Nextstep window, called a "frame" in Emacs terms.
1123 Return an Emacs frame object.
1124 PARMS is an alist of frame parameters.
1125 If the parameters specify that the frame should not have a minibuffer,
1126 and do not specify a specific minibuffer window to use,
1127 then `default-minibuffer-frame' must be a frame whose minibuffer can
1128 be shared by the new frame.
1130 This function is an internal primitive--use `make-frame' instead. */)
1134 Lisp_Object frame, tem;
1136 int minibuffer_only = 0;
1137 int window_prompting = 0;
1139 ptrdiff_t count = specpdl_ptr - specpdl;
1140 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1141 Lisp_Object display;
1142 struct ns_display_info *dpyinfo = NULL;
1145 Lisp_Object tfont, tfontsize;
1146 static int desc_ctr = 1;
1150 /* x_get_arg modifies parms. */
1151 parms = Fcopy_alist (parms);
1153 /* Use this general default value to start with
1154 until we know if this frame has a specified name. */
1155 Vx_resource_name = Vinvocation_name;
1157 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1158 if (EQ (display, Qunbound))
1160 dpyinfo = check_ns_display_info (display);
1161 kb = dpyinfo->terminal->kboard;
1163 if (!dpyinfo->terminal->name)
1164 error ("Terminal is not live, can't create new frames on it");
1166 name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1168 && ! EQ (name, Qunbound)
1170 error ("Invalid frame name--not a string or nil");
1173 Vx_resource_name = name;
1175 parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1176 if (EQ (parent, Qunbound))
1178 if (! NILP (parent))
1179 CHECK_NUMBER (parent);
1181 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
1182 /* No need to protect DISPLAY because that's not used after passing
1183 it to make_frame_without_minibuffer. */
1185 GCPRO4 (parms, parent, name, frame);
1186 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1188 if (EQ (tem, Qnone) || NILP (tem))
1189 f = make_frame_without_minibuffer (Qnil, kb, display);
1190 else if (EQ (tem, Qonly))
1192 f = make_minibuffer_frame ();
1193 minibuffer_only = 1;
1195 else if (WINDOWP (tem))
1196 f = make_frame_without_minibuffer (tem, kb, display);
1200 XSETFRAME (frame, f);
1202 f->terminal = dpyinfo->terminal;
1204 f->output_method = output_ns;
1205 f->output_data.ns = xzalloc (sizeof *f->output_data.ns);
1207 FRAME_FONTSET (f) = -1;
1209 fset_icon_name (f, x_get_arg (dpyinfo, parms, Qicon_name,
1210 "iconName", "Title",
1212 if (! STRINGP (f->icon_name))
1213 fset_icon_name (f, Qnil);
1215 FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1217 /* With FRAME_NS_DISPLAY_INFO set up, this unwind-protect is safe. */
1218 record_unwind_protect (unwind_create_frame, frame);
1220 f->output_data.ns->window_desc = desc_ctr++;
1221 if (TYPE_RANGED_INTEGERP (Window, parent))
1223 f->output_data.ns->parent_desc = XFASTINT (parent);
1224 f->output_data.ns->explicit_parent = 1;
1228 f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1229 f->output_data.ns->explicit_parent = 0;
1232 /* Set the name; the functions to which we pass f expect the name to
1234 if (EQ (name, Qunbound) || NILP (name) || ! STRINGP (name))
1236 fset_name (f, build_string ([ns_app_name UTF8String]));
1237 f->explicit_name = 0;
1241 fset_name (f, name);
1242 f->explicit_name = 1;
1243 specbind (Qx_resource_name, name);
1247 register_font_driver (&nsfont_driver, f);
1248 x_default_parameter (f, parms, Qfont_backend, Qnil,
1249 "fontBackend", "FontBackend", RES_TYPE_STRING);
1252 /* use for default font name */
1253 id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1254 tfontsize = x_default_parameter (f, parms, Qfontsize,
1255 make_number (0 /*(int)[font pointSize]*/),
1256 "fontSize", "FontSize", RES_TYPE_NUMBER);
1257 tfont = x_default_parameter (f, parms, Qfont,
1258 build_string ([[font fontName] UTF8String]),
1259 "font", "Font", RES_TYPE_STRING);
1263 x_default_parameter (f, parms, Qborder_width, make_number (0),
1264 "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1265 x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1266 "internalBorderWidth", "InternalBorderWidth",
1269 /* default scrollbars on right on Mac */
1272 #ifdef NS_IMPL_GNUSTEP
1277 x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1278 "verticalScrollBars", "VerticalScrollBars",
1281 x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1282 "foreground", "Foreground", RES_TYPE_STRING);
1283 x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1284 "background", "Background", RES_TYPE_STRING);
1285 /* FIXME: not supported yet in Nextstep */
1286 x_default_parameter (f, parms, Qline_spacing, Qnil,
1287 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1288 x_default_parameter (f, parms, Qleft_fringe, Qnil,
1289 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1290 x_default_parameter (f, parms, Qright_fringe, Qnil,
1291 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1294 image_cache_refcount =
1295 FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
1298 init_frame_faces (f);
1300 /* The resources controlling the menu-bar and tool-bar are
1301 processed specially at startup, and reflected in the mode
1302 variables; ignore them here. */
1303 x_default_parameter (f, parms, Qmenu_bar_lines,
1304 NILP (Vmenu_bar_mode)
1305 ? make_number (0) : make_number (1),
1306 NULL, NULL, RES_TYPE_NUMBER);
1307 x_default_parameter (f, parms, Qtool_bar_lines,
1308 NILP (Vtool_bar_mode)
1309 ? make_number (0) : make_number (1),
1310 NULL, NULL, RES_TYPE_NUMBER);
1312 x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1313 "BufferPredicate", RES_TYPE_SYMBOL);
1314 x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1317 parms = get_geometry_from_preferences (dpyinfo, parms);
1318 window_prompting = x_figure_window_size (f, parms, 1);
1320 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1321 f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1323 /* NOTE: on other terms, this is done in set_mouse_color, however this
1324 was not getting called under Nextstep */
1325 f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1326 f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1327 f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1328 f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1329 f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1330 f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1331 FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1332 = [NSCursor arrowCursor];
1333 f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1335 [[EmacsView alloc] initFrameFromEmacs: f];
1339 /* ns_display_info does not have a reference_count. */
1340 f->terminal->reference_count++;
1342 /* It is now ok to make the frame official even if we get an error below.
1343 The frame needs to be on Vframe_list or making it visible won't work. */
1344 Vframe_list = Fcons (frame, Vframe_list);
1346 x_default_parameter (f, parms, Qicon_type, Qnil,
1347 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
1349 x_default_parameter (f, parms, Qauto_raise, Qnil,
1350 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
1351 x_default_parameter (f, parms, Qauto_lower, Qnil,
1352 "autoLower", "AutoLower", RES_TYPE_BOOLEAN);
1353 x_default_parameter (f, parms, Qcursor_type, Qbox,
1354 "cursorType", "CursorType", RES_TYPE_SYMBOL);
1355 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
1356 "scrollBarWidth", "ScrollBarWidth",
1358 x_default_parameter (f, parms, Qalpha, Qnil,
1359 "alpha", "Alpha", RES_TYPE_NUMBER);
1360 x_default_parameter (f, parms, Qfullscreen, Qnil,
1361 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
1363 width = FRAME_COLS (f);
1364 height = FRAME_LINES (f);
1366 SET_FRAME_COLS (f, 0);
1367 FRAME_LINES (f) = 0;
1368 change_frame_size (f, height, width, 1, 0, 0);
1370 if (! f->output_data.ns->explicit_parent)
1372 Lisp_Object visibility;
1374 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
1376 if (EQ (visibility, Qunbound))
1379 if (EQ (visibility, Qicon))
1380 x_iconify_frame (f);
1381 else if (! NILP (visibility))
1383 x_make_frame_visible (f);
1384 [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1388 /* Must have been Qnil. */
1392 if (FRAME_HAS_MINIBUF_P (f)
1393 && (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
1394 || !FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame)))))
1395 kset_default_minibuffer_frame (kb, frame);
1397 /* All remaining specified parameters, which have not been "used"
1398 by x_get_arg and friends, now go in the misc. alist of the frame. */
1399 for (tem = parms; CONSP (tem); tem = XCDR (tem))
1400 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1401 fset_param_alist (f, Fcons (XCAR (tem), f->param_alist));
1405 if (window_prompting & USPosition)
1406 x_set_offset (f, f->left_pos, f->top_pos, 1);
1408 /* Make sure windows on this frame appear in calls to next-window
1409 and similar functions. */
1410 Vwindow_list = Qnil;
1412 return unbind_to (count, frame);
1416 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1417 doc: /* Set the input focus to FRAME.
1418 FRAME nil means use the selected frame. */)
1421 struct frame *f = check_ns_frame (frame);
1422 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1424 if (dpyinfo->x_focus_frame != f)
1426 EmacsView *view = FRAME_NS_VIEW (f);
1428 [NSApp activateIgnoringOtherApps: YES];
1429 [[view window] makeKeyAndOrderFront: view];
1437 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1439 doc: /* Pop up the font panel. */)
1446 fm = [NSFontManager sharedFontManager];
1448 f = SELECTED_FRAME ();
1451 CHECK_FRAME (frame);
1455 [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1457 [fm orderFrontFontPanel: NSApp];
1462 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1464 doc: /* Pop up the color panel. */)
1471 f = SELECTED_FRAME ();
1474 CHECK_FRAME (frame);
1478 [NSApp orderFrontColorPanel: NSApp];
1483 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 5, 0,
1484 doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1485 Optional arg DIR, if non-nil, supplies a default directory.
1486 Optional arg MUSTMATCH, if non-nil, means the returned file or
1487 directory must exist.
1488 Optional arg INIT, if non-nil, provides a default file name to use.
1489 Optional arg DIR_ONLY_P, if non-nil, means choose only directories. */)
1490 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object mustmatch,
1491 Lisp_Object init, Lisp_Object dir_only_p)
1493 static id fileDelegate = nil;
1498 NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1499 [NSString stringWithUTF8String: SSDATA (prompt)];
1500 NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1501 [NSString stringWithUTF8String: SSDATA (BVAR (current_buffer, directory))] :
1502 [NSString stringWithUTF8String: SSDATA (dir)];
1503 NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1504 [NSString stringWithUTF8String: SSDATA (init)];
1508 if (fileDelegate == nil)
1509 fileDelegate = [EmacsFileDelegate new];
1511 [NSCursor setHiddenUntilMouseMoves: NO];
1513 if ([dirS characterAtIndex: 0] == '~')
1514 dirS = [dirS stringByExpandingTildeInPath];
1516 panel = NILP (mustmatch) && NILP (dir_only_p) ?
1517 (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1519 [panel setTitle: promptS];
1521 [panel setAllowsOtherFileTypes: YES];
1522 [panel setTreatsFilePackagesAsDirectories: YES];
1523 [panel setDelegate: fileDelegate];
1526 if (! NILP (dir_only_p))
1528 [panel setCanChooseDirectories: YES];
1529 [panel setCanChooseFiles: NO];
1533 /* This is not quite what the documentation says, but it is compatible
1534 with the Gtk+ code. Also, the menu entry says "Open File...". */
1535 [panel setCanChooseDirectories: NO];
1536 [panel setCanChooseFiles: YES];
1540 #if defined (NS_IMPL_COCOA) && \
1541 MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
1542 if (! NILP (mustmatch) || ! NILP (dir_only_p))
1543 [panel setAllowedFileTypes: nil];
1544 if (dirS) [panel setDirectoryURL: [NSURL fileURLWithPath: dirS]];
1545 if (initS && NILP (Ffile_directory_p (init)))
1546 [panel setNameFieldStringValue: [initS lastPathComponent]];
1548 [panel setNameFieldStringValue: @""];
1550 ret = [panel runModal];
1552 if (NILP (mustmatch) && NILP (dir_only_p))
1554 ret = [panel runModalForDirectory: dirS file: initS];
1558 ret = [panel runModalForDirectory: dirS file: initS types: nil];
1562 ret = (ret == NSOKButton) || panelOK;
1566 NSString *str = [panel getFilename];
1567 if (! str) str = [panel getDirectory];
1568 if (! str) ret = NO;
1569 else fname = build_string ([str UTF8String]);
1572 [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1575 return ret ? fname : Qnil;
1579 ns_get_defaults_value (const char *key)
1581 NSObject *obj = [[NSUserDefaults standardUserDefaults]
1582 objectForKey: [NSString stringWithUTF8String: key]];
1584 if (!obj) return NULL;
1586 return [[NSString stringWithFormat: @"%@", obj] UTF8String];
1590 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1591 doc: /* Return the value of the property NAME of OWNER from the defaults database.
1592 If OWNER is nil, Emacs is assumed. */)
1593 (Lisp_Object owner, Lisp_Object name)
1599 owner = build_string([ns_app_name UTF8String]);
1600 CHECK_STRING (name);
1601 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SSDATA (name)); */
1603 value = ns_get_defaults_value (SSDATA (name));
1606 return build_string (value);
1611 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1612 doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1613 If OWNER is nil, Emacs is assumed.
1614 If VALUE is nil, the default is removed. */)
1615 (Lisp_Object owner, Lisp_Object name, Lisp_Object value)
1619 owner = build_string ([ns_app_name UTF8String]);
1620 CHECK_STRING (name);
1623 [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1624 [NSString stringWithUTF8String: SSDATA (name)]];
1628 CHECK_STRING (value);
1629 [[NSUserDefaults standardUserDefaults] setObject:
1630 [NSString stringWithUTF8String: SSDATA (value)]
1631 forKey: [NSString stringWithUTF8String:
1639 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1640 Sx_server_max_request_size,
1642 doc: /* This function is a no-op. It is only present for completeness. */)
1643 (Lisp_Object display)
1646 /* This function has no real equivalent under NeXTstep. Return nil to
1652 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1653 doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1654 DISPLAY should be either a frame or a display name (a string).
1655 If omitted or nil, the selected frame's display is used. */)
1656 (Lisp_Object display)
1658 #ifdef NS_IMPL_GNUSTEP
1659 return build_string ("GNU");
1661 return build_string ("Apple");
1666 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1667 doc: /* Return the version numbers of the server of DISPLAY.
1668 The value is a list of three integers: the major and minor
1669 version numbers of the X Protocol in use, and the distributor-specific
1670 release number. See also the function `x-server-vendor'.
1672 The optional argument DISPLAY specifies which display to ask about.
1673 DISPLAY should be either a frame or a display name (a string).
1674 If omitted or nil, that stands for the selected frame's display. */)
1675 (Lisp_Object display)
1677 /*NOTE: it is unclear what would best correspond with "protocol";
1678 we return 10.3, meaning Panther, since this is roughly the
1679 level that GNUstep's APIs correspond to.
1680 The last number is where we distinguish between the Apple
1681 and GNUstep implementations ("distributor-specific release
1682 number") and give int'ized versions of major.minor. */
1683 return list3i (10, 3, ns_appkit_version_int ());
1687 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1688 doc: /* Return the number of screens on Nextstep display server DISPLAY.
1689 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1690 If omitted or nil, the selected frame's display is used. */)
1691 (Lisp_Object display)
1696 num = [[NSScreen screens] count];
1698 return (num != 0) ? make_number (num) : Qnil;
1702 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1704 doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1705 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1706 If omitted or nil, the selected frame's display is used. */)
1707 (Lisp_Object display)
1710 return make_number ((int)
1711 ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1715 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1717 doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1718 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1719 If omitted or nil, the selected frame's display is used. */)
1720 (Lisp_Object display)
1723 return make_number ((int)
1724 ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1728 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1729 Sx_display_backing_store, 0, 1, 0,
1730 doc: /* Return whether the Nextstep display DISPLAY supports backing store.
1731 The value may be `buffered', `retained', or `non-retained'.
1732 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1733 If omitted or nil, the selected frame's display is used. */)
1734 (Lisp_Object display)
1737 switch ([ns_get_window (display) backingType])
1739 case NSBackingStoreBuffered:
1740 return intern ("buffered");
1741 case NSBackingStoreRetained:
1742 return intern ("retained");
1743 case NSBackingStoreNonretained:
1744 return intern ("non-retained");
1746 error ("Strange value for backingType parameter of frame");
1748 return Qnil; /* not reached, shut compiler up */
1752 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1753 Sx_display_visual_class, 0, 1, 0,
1754 doc: /* Return the visual class of the Nextstep display server DISPLAY.
1755 The value is one of the symbols `static-gray', `gray-scale',
1756 `static-color', `pseudo-color', `true-color', or `direct-color'.
1757 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1758 If omitted or nil, the selected frame's display is used. */)
1759 (Lisp_Object display)
1761 NSWindowDepth depth;
1763 depth = [ns_get_screen (display) depth];
1765 if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1766 return intern ("static-gray");
1767 else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1768 return intern ("gray-scale");
1769 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1770 return intern ("pseudo-color");
1771 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1772 return intern ("true-color");
1773 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1774 return intern ("direct-color");
1776 /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1777 return intern ("direct-color");
1781 DEFUN ("x-display-save-under", Fx_display_save_under,
1782 Sx_display_save_under, 0, 1, 0,
1783 doc: /* Return t if DISPLAY supports the save-under feature.
1784 The optional argument DISPLAY specifies which display to ask about.
1785 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1786 If omitted or nil, the selected frame's display is used. */)
1787 (Lisp_Object display)
1790 switch ([ns_get_window (display) backingType])
1792 case NSBackingStoreBuffered:
1795 case NSBackingStoreRetained:
1796 case NSBackingStoreNonretained:
1800 error ("Strange value for backingType parameter of frame");
1802 return Qnil; /* not reached, shut compiler up */
1806 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1808 doc: /* Open a connection to a display server.
1809 DISPLAY is the name of the display to connect to.
1810 Optional second arg XRM-STRING is a string of resources in xrdb format.
1811 If the optional third arg MUST-SUCCEED is non-nil,
1812 terminate Emacs if we can't open the connection.
1813 \(In the Nextstep version, the last two arguments are currently ignored.) */)
1814 (Lisp_Object display, Lisp_Object resource_string, Lisp_Object must_succeed)
1816 struct ns_display_info *dpyinfo;
1818 CHECK_STRING (display);
1820 nxatoms_of_nsselect ();
1821 dpyinfo = ns_term_init (display);
1824 if (!NILP (must_succeed))
1825 fatal ("OpenStep on %s not responding.\n",
1828 error ("OpenStep on %s not responding.\n",
1836 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1838 doc: /* Close the connection to the current Nextstep display server.
1839 The argument DISPLAY is currently ignored. */)
1840 (Lisp_Object display)
1843 /*ns_delete_terminal (dpyinfo->terminal); */
1844 [NSApp terminate: NSApp];
1849 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1850 doc: /* Return the list of display names that Emacs has connections to. */)
1853 Lisp_Object tail, result;
1856 for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1857 result = Fcons (XCAR (XCAR (tail)), result);
1863 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1865 doc: /* Hides all applications other than Emacs. */)
1869 [NSApp hideOtherApplications: NSApp];
1873 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1875 doc: /* If ON is non-nil, the entire Emacs application is hidden.
1876 Otherwise if Emacs is hidden, it is unhidden.
1877 If ON is equal to `activate', Emacs is unhidden and becomes
1878 the active application. */)
1882 if (EQ (on, intern ("activate")))
1884 [NSApp unhide: NSApp];
1885 [NSApp activateIgnoringOtherApps: YES];
1888 [NSApp unhide: NSApp];
1890 [NSApp hide: NSApp];
1895 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1897 doc: /* Shows the 'Info' or 'About' panel for Emacs. */)
1901 [NSApp orderFrontStandardAboutPanel: nil];
1906 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1907 doc: /* Determine font PostScript or family name for font NAME.
1908 NAME should be a string containing either the font name or an XLFD
1909 font descriptor. If string contains `fontset' and not
1910 `fontset-startup', it is left alone. */)
1914 CHECK_STRING (name);
1919 if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1922 return build_string (ns_xlfd_to_fontname (SSDATA (name)));
1926 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1927 doc: /* Return a list of all available colors.
1928 The optional argument FRAME is currently ignored. */)
1931 Lisp_Object list = Qnil;
1932 NSEnumerator *colorlists;
1937 CHECK_FRAME (frame);
1938 if (! FRAME_NS_P (XFRAME (frame)))
1939 error ("non-Nextstep frame used in `ns-list-colors'");
1944 colorlists = [[NSColorList availableColorLists] objectEnumerator];
1945 while ((clist = [colorlists nextObject]))
1947 if ([[clist name] length] < 7 ||
1948 [[clist name] rangeOfString: @"PANTONE"].location == 0)
1950 NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1952 while ((cname = [cnames nextObject]))
1953 list = Fcons (build_string ([cname UTF8String]), list);
1954 /* for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1955 list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1956 UTF8String]), list); */
1966 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1967 doc: /* List available Nextstep services by querying NSApp. */)
1970 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
1971 /* You can't get services like this in 10.6+. */
1974 Lisp_Object ret = Qnil;
1979 svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1980 [NSApp setServicesMenu: svcs];
1981 [NSApp registerServicesMenuSendTypes: ns_send_types
1982 returnTypes: ns_return_types];
1984 /* On Tiger, services menu updating was made lazier (waits for user to
1985 actually click on the menu), so we have to force things along: */
1986 #ifdef NS_IMPL_COCOA
1987 delegate = [svcs delegate];
1988 if (delegate != nil)
1990 if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1991 [delegate menuNeedsUpdate: svcs];
1992 if ([delegate respondsToSelector:
1993 @selector (menu:updateItem:atIndex:shouldCancel:)])
1995 int i, len = [delegate numberOfItemsInMenu: svcs];
1996 for (i =0; i<len; i++)
1997 [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1998 for (i =0; i<len; i++)
1999 if (![delegate menu: svcs
2000 updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
2001 atIndex: i shouldCancel: NO])
2007 [svcs setAutoenablesItems: NO];
2008 #ifdef NS_IMPL_COCOA
2009 [svcs update]; /* on OS X, converts from '/' structure */
2012 ret = interpret_services_menu (svcs, Qnil, ret);
2018 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
2020 doc: /* Perform Nextstep SERVICE on SEND.
2021 SEND should be either a string or nil.
2022 The return value is the result of the service, as string, or nil if
2023 there was no result. */)
2024 (Lisp_Object service, Lisp_Object send)
2030 CHECK_STRING (service);
2033 utfStr = SSDATA (service);
2034 svcName = [NSString stringWithUTF8String: utfStr];
2036 pb =[NSPasteboard pasteboardWithUniqueName];
2037 ns_string_to_pasteboard (pb, send);
2039 if (NSPerformService (svcName, pb) == NO)
2040 Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
2042 if ([[pb types] count] == 0)
2043 return build_string ("");
2044 return ns_string_from_pasteboard (pb);
2048 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
2049 Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
2050 doc: /* Return an NFC string that matches the UTF-8 NFD string STR. */)
2053 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
2058 utfStr = [NSString stringWithUTF8String: SSDATA (str)];
2059 if (![utfStr respondsToSelector:
2060 @selector (precomposedStringWithCanonicalMapping)])
2063 ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
2067 utfStr = [utfStr precomposedStringWithCanonicalMapping];
2068 return build_string ([utfStr UTF8String]);
2072 #ifdef NS_IMPL_COCOA
2074 /* Compile and execute the AppleScript SCRIPT and return the error
2075 status as function value. A zero is returned if compilation and
2076 execution is successful, in which case *RESULT is set to a Lisp
2077 string or a number containing the resulting script value. Otherwise,
2080 ns_do_applescript (Lisp_Object script, Lisp_Object *result)
2082 NSAppleEventDescriptor *desc;
2083 NSDictionary* errorDict;
2084 NSAppleEventDescriptor* returnDescriptor = NULL;
2086 NSAppleScript* scriptObject =
2087 [[NSAppleScript alloc] initWithSource:
2088 [NSString stringWithUTF8String: SSDATA (script)]];
2090 returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2091 [scriptObject release];
2095 if (returnDescriptor != NULL)
2097 // successful execution
2098 if (kAENullEvent != [returnDescriptor descriptorType])
2101 // script returned an AppleScript result
2102 if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2103 #if defined (NS_IMPL_COCOA)
2104 (typeUTF16ExternalRepresentation
2105 == [returnDescriptor descriptorType]) ||
2107 (typeUTF8Text == [returnDescriptor descriptorType]) ||
2108 (typeCString == [returnDescriptor descriptorType]))
2110 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2112 *result = build_string([[desc stringValue] UTF8String]);
2116 /* use typeUTF16ExternalRepresentation? */
2117 // coerce the result to the appropriate ObjC type
2118 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2120 *result = make_number([desc int32Value]);
2126 // no script result, return error
2132 /* Helper function called from sendEvent to run applescript
2133 from within the main event loop. */
2136 ns_run_ascript (void)
2138 if (! NILP (as_script))
2139 as_status = ns_do_applescript (as_script, as_result);
2143 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2144 doc: /* Execute AppleScript SCRIPT and return the result.
2145 If compilation and execution are successful, the resulting script value
2146 is returned as a string, a number or, in the case of other constructs, t.
2147 In case the execution fails, an error is signaled. */)
2148 (Lisp_Object script)
2154 CHECK_STRING (script);
2160 as_result = &result;
2162 /* executing apple script requires the event loop to run, otherwise
2163 errors aren't returned and executeAndReturnError hangs forever.
2164 Post an event that runs applescript and then start the event loop.
2165 The event loop is exited when the script is done. */
2166 nxev = [NSEvent otherEventWithType: NSApplicationDefined
2167 location: NSMakePoint (0, 0)
2170 windowNumber: [[NSApp mainWindow] windowNumber]
2171 context: [NSApp context]
2174 data2: NSAPP_DATA2_RUNASSCRIPT];
2176 [NSApp postEvent: nxev atStart: NO];
2178 // If there are other events, the event loop may exit. Keep running
2179 // until the script has been handled. */
2180 while (! NILP (as_script))
2189 else if (!STRINGP (result))
2190 error ("AppleScript error %d", status);
2192 error ("%s", SSDATA (result));
2198 /* ==========================================================================
2200 Miscellaneous functions not called through hooks
2202 ========================================================================== */
2205 /* called from image.c */
2207 check_x_frame (Lisp_Object frame)
2209 return check_ns_frame (frame);
2213 /* called from frame.c */
2214 struct ns_display_info *
2215 check_x_display_info (Lisp_Object frame)
2217 return check_ns_display_info (frame);
2222 x_set_scroll_bar_default_width (struct frame *f)
2224 int wid = FRAME_COLUMN_WIDTH (f);
2225 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2226 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2231 /* terms impl this instead of x-get-resource directly */
2233 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2235 /* remove appname prefix; TODO: allow for !="Emacs" */
2236 char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2240 if (inhibit_x_resources)
2241 /* --quick was passed, so this is a no-op. */
2244 res = ns_get_defaults_value (toCheck);
2245 return !res ? NULL :
2246 (!c_strncasecmp (res, "YES", 3) ? "true" :
2247 (!c_strncasecmp (res, "NO", 2) ? "false" : res));
2252 x_get_focus_frame (struct frame *frame)
2254 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2255 Lisp_Object nsfocus;
2257 if (!dpyinfo->x_focus_frame)
2260 XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2266 x_pixel_width (struct frame *f)
2268 return FRAME_PIXEL_WIDTH (f);
2273 x_pixel_height (struct frame *f)
2275 return FRAME_PIXEL_HEIGHT (f);
2280 x_screen_planes (struct frame *f)
2282 return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2287 x_sync (struct frame *f)
2289 /* XXX Not implemented XXX */
2295 /* ==========================================================================
2297 Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2299 ========================================================================== */
2302 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2303 doc: /* Internal function called by `color-defined-p', which see.
2304 \(Note that the Nextstep version of this function ignores FRAME.) */)
2305 (Lisp_Object color, Lisp_Object frame)
2309 return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2313 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2314 doc: /* Internal function called by `color-values', which see. */)
2315 (Lisp_Object color, Lisp_Object frame)
2318 CGFloat red, green, blue, alpha;
2321 CHECK_STRING (color);
2323 if (ns_lisp_to_color (color, &col))
2326 [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2327 getRed: &red green: &green blue: &blue alpha: &alpha];
2328 return list3i (lrint (red * 65280), lrint (green * 65280),
2329 lrint (blue * 65280));
2333 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2334 doc: /* Internal function called by `display-color-p', which see. */)
2335 (Lisp_Object display)
2337 NSWindowDepth depth;
2338 NSString *colorSpace;
2340 depth = [ns_get_screen (display) depth];
2341 colorSpace = NSColorSpaceFromDepth (depth);
2343 return [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2344 || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2349 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2350 Sx_display_grayscale_p, 0, 1, 0,
2351 doc: /* Return t if the Nextstep display supports shades of gray.
2352 Note that color displays do support shades of gray.
2353 The optional argument DISPLAY specifies which display to ask about.
2354 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2355 If omitted or nil, that stands for the selected frame's display. */)
2356 (Lisp_Object display)
2358 NSWindowDepth depth;
2360 depth = [ns_get_screen (display) 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 DISPLAY.
2369 The optional argument DISPLAY specifies which display to ask about.
2370 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2371 If omitted or nil, that stands for the selected frame's display. */)
2372 (Lisp_Object display)
2375 return make_number ((int) [ns_get_screen (display) frame].size.width);
2379 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2380 Sx_display_pixel_height, 0, 1, 0,
2381 doc: /* Return the height in pixels of the Nextstep display DISPLAY.
2382 The optional argument DISPLAY specifies which display to ask about.
2383 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2384 If omitted or nil, that stands for the selected frame's display. */)
2385 (Lisp_Object display)
2388 return make_number ((int) [ns_get_screen (display) frame].size.height);
2392 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2393 Sns_display_usable_bounds, 0, 1, 0,
2394 doc: /* Return the bounds of the usable part of the screen.
2395 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2396 are the boundaries of the usable part of the screen, excluding areas
2397 reserved for the Mac menu, dock, and so forth.
2399 The screen queried corresponds to DISPLAY, which should be either a
2400 frame, a display name (a string), or terminal ID. If omitted or nil,
2401 that stands for the selected frame's display. */)
2402 (Lisp_Object display)
2408 screen = ns_get_screen (display);
2412 vScreen = [screen visibleFrame];
2414 /* NS coordinate system is upside-down.
2415 Transform to screen-specific coordinates. */
2416 return list4i (vScreen.origin.x,
2417 [screen frame].size.height
2418 - vScreen.size.height - vScreen.origin.y,
2419 vScreen.size.width, vScreen.size.height);
2423 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2425 doc: /* Return the number of bitplanes of the Nextstep display DISPLAY.
2426 The optional argument DISPLAY specifies which display to ask about.
2427 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2428 If omitted or nil, that stands for the selected frame's display. */)
2429 (Lisp_Object display)
2433 (NSBitsPerPixelFromDepth ([ns_get_screen (display) depth]));
2437 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2438 Sx_display_color_cells, 0, 1, 0,
2439 doc: /* Returns the number of color cells of the Nextstep display DISPLAY.
2440 The optional argument DISPLAY specifies which display to ask about.
2441 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2442 If omitted or nil, that stands for the selected frame's display. */)
2443 (Lisp_Object display)
2445 struct ns_display_info *dpyinfo;
2448 dpyinfo = check_ns_display_info (display);
2449 /* We force 24+ bit depths to 24-bit to prevent an overflow. */
2450 return make_number (1 << min (dpyinfo->n_planes, 24));
2454 /* Unused dummy def needed for compatibility. */
2455 Lisp_Object tip_frame;
2457 /* TODO: move to xdisp or similar */
2459 compute_tip_xy (struct frame *f,
2468 Lisp_Object left, top;
2469 EmacsView *view = FRAME_NS_VIEW (f);
2472 /* Start with user-specified or mouse position. */
2473 left = Fcdr (Fassq (Qleft, parms));
2474 top = Fcdr (Fassq (Qtop, parms));
2476 if (!INTEGERP (left) || !INTEGERP (top))
2478 pt = last_mouse_motion_position;
2479 /* Convert to screen coordinates */
2480 pt = [view convertPoint: pt toView: nil];
2481 pt = [[view window] convertBaseToScreen: pt];
2485 /* Absolute coordinates. */
2487 pt.y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - XINT (top)
2491 /* Ensure in bounds. (Note, screen origin = lower left.) */
2492 if (INTEGERP (left))
2494 else if (pt.x + XINT (dx) <= 0)
2495 *root_x = 0; /* Can happen for negative dx */
2496 else if (pt.x + XINT (dx) + width
2497 <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2498 /* It fits to the right of the pointer. */
2499 *root_x = pt.x + XINT (dx);
2500 else if (width + XINT (dx) <= pt.x)
2501 /* It fits to the left of the pointer. */
2502 *root_x = pt.x - width - XINT (dx);
2504 /* Put it left justified on the screen -- it ought to fit that way. */
2509 else if (pt.y - XINT (dy) - height >= 0)
2510 /* It fits below the pointer. */
2511 *root_y = pt.y - height - XINT (dy);
2512 else if (pt.y + XINT (dy) + height
2513 <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2514 /* It fits above the pointer */
2515 *root_y = pt.y + XINT (dy);
2517 /* Put it on the top. */
2518 *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2522 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2523 doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2524 A tooltip window is a small window displaying a string.
2526 This is an internal function; Lisp code should call `tooltip-show'.
2528 FRAME nil or omitted means use the selected frame.
2530 PARMS is an optional list of frame parameters which can be used to
2531 change the tooltip's appearance.
2533 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
2534 means use the default timeout of 5 seconds.
2536 If the list of frame parameters PARMS contains a `left' parameter,
2537 the tooltip is displayed at that x-position. Otherwise it is
2538 displayed at the mouse position, with offset DX added (default is 5 if
2539 DX isn't specified). Likewise for the y-position; if a `top' frame
2540 parameter is specified, it determines the y-position of the tooltip
2541 window, otherwise it is displayed at the mouse position, with offset
2542 DY added (default is -10).
2544 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2545 Text larger than the specified size is clipped. */)
2546 (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
2549 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2550 ptrdiff_t count = SPECPDL_INDEX ();
2555 specbind (Qinhibit_redisplay, Qt);
2557 GCPRO4 (string, parms, frame, timeout);
2559 CHECK_STRING (string);
2560 str = SSDATA (string);
2561 f = check_x_frame (frame);
2563 timeout = make_number (5);
2565 CHECK_NATNUM (timeout);
2568 dx = make_number (5);
2573 dy = make_number (-10);
2578 if (ns_tooltip == nil)
2579 ns_tooltip = [[EmacsTooltip alloc] init];
2583 [ns_tooltip setText: str];
2584 size = [ns_tooltip frame].size;
2586 /* Move the tooltip window where the mouse pointer is. Resize and
2588 compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2591 [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2595 return unbind_to (count, Qnil);
2599 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2600 doc: /* Hide the current tooltip window, if there is any.
2601 Value is t if tooltip was open, nil otherwise. */)
2604 if (ns_tooltip == nil || ![ns_tooltip isActive])
2611 /* ==========================================================================
2613 Class implementations
2615 ========================================================================== */
2618 @implementation EmacsSavePanel
2619 #ifdef NS_IMPL_COCOA
2620 /* --------------------------------------------------------------------------
2621 These are overridden to intercept on OS X: ending panel restarts NSApp
2622 event loop if it is stopped. Not sure if this is correct behavior,
2623 perhaps should check if running and if so send an appdefined.
2624 -------------------------------------------------------------------------- */
2625 - (void) ok: (id)sender
2631 - (void) cancel: (id)sender
2633 [super cancel: sender];
2637 - (NSString *) getFilename
2639 return ns_filename_from_panel (self);
2641 - (NSString *) getDirectory
2643 return ns_directory_from_panel (self);
2648 @implementation EmacsOpenPanel
2649 #ifdef NS_IMPL_COCOA
2650 /* --------------------------------------------------------------------------
2651 These are overridden to intercept on OS X: ending panel restarts NSApp
2652 event loop if it is stopped. Not sure if this is correct behavior,
2653 perhaps should check if running and if so send an appdefined.
2654 -------------------------------------------------------------------------- */
2655 - (void) ok: (id)sender
2659 // If not choosing directories, and Open is pressed on a directory, return.
2660 if (! [self canChooseDirectories] && [self getDirectory] &&
2661 ! [self getFilename])
2667 - (void) cancel: (id)sender
2669 [super cancel: sender];
2674 - (NSString *) getFilename
2676 return ns_filename_from_panel (self);
2678 - (NSString *) getDirectory
2680 return ns_directory_from_panel (self);
2686 @implementation EmacsFileDelegate
2687 /* --------------------------------------------------------------------------
2688 Delegate methods for Open/Save panels
2689 -------------------------------------------------------------------------- */
2690 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2694 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2698 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2699 confirmed: (BOOL)okFlag
2708 /* ==========================================================================
2710 Lisp interface declaration
2712 ========================================================================== */
2716 syms_of_nsfns (void)
2718 Qfontsize = intern_c_string ("fontsize");
2719 staticpro (&Qfontsize);
2721 DEFVAR_LISP ("ns-icon-type-alist", Vns_icon_type_alist,
2722 doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2723 If the title of a frame matches REGEXP, then IMAGE.tiff is
2724 selected as the image of the icon representing the frame when it's
2725 miniaturized. If an element is t, then Emacs tries to select an icon
2726 based on the filetype of the visited file.
2728 The images have to be installed in a folder called English.lproj in the
2729 Emacs folder. You have to restart Emacs after installing new icons.
2731 Example: Install an icon Gnus.tiff and execute the following code
2733 (setq ns-icon-type-alist
2734 (append ns-icon-type-alist
2735 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2738 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2739 be used as the image of the icon representing the frame. */);
2740 Vns_icon_type_alist = Fcons (Qt, Qnil);
2742 DEFVAR_LISP ("ns-version-string", Vns_version_string,
2743 doc: /* Toolkit version for NS Windowing. */);
2744 Vns_version_string = ns_appkit_version_str ();
2746 defsubr (&Sns_read_file_name);
2747 defsubr (&Sns_get_resource);
2748 defsubr (&Sns_set_resource);
2749 defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2750 defsubr (&Sx_display_grayscale_p);
2751 defsubr (&Sns_font_name);
2752 defsubr (&Sns_list_colors);
2753 #ifdef NS_IMPL_COCOA
2754 defsubr (&Sns_do_applescript);
2756 defsubr (&Sxw_color_defined_p);
2757 defsubr (&Sxw_color_values);
2758 defsubr (&Sx_server_max_request_size);
2759 defsubr (&Sx_server_vendor);
2760 defsubr (&Sx_server_version);
2761 defsubr (&Sx_display_pixel_width);
2762 defsubr (&Sx_display_pixel_height);
2763 defsubr (&Sns_display_usable_bounds);
2764 defsubr (&Sx_display_mm_width);
2765 defsubr (&Sx_display_mm_height);
2766 defsubr (&Sx_display_screens);
2767 defsubr (&Sx_display_planes);
2768 defsubr (&Sx_display_color_cells);
2769 defsubr (&Sx_display_visual_class);
2770 defsubr (&Sx_display_backing_store);
2771 defsubr (&Sx_display_save_under);
2772 defsubr (&Sx_create_frame);
2773 defsubr (&Sx_open_connection);
2774 defsubr (&Sx_close_connection);
2775 defsubr (&Sx_display_list);
2777 defsubr (&Sns_hide_others);
2778 defsubr (&Sns_hide_emacs);
2779 defsubr (&Sns_emacs_info_panel);
2780 defsubr (&Sns_list_services);
2781 defsubr (&Sns_perform_service);
2782 defsubr (&Sns_convert_utf8_nfd_to_nfc);
2783 defsubr (&Sx_focus_frame);
2784 defsubr (&Sns_popup_font_panel);
2785 defsubr (&Sns_popup_color_panel);
2787 defsubr (&Sx_show_tip);
2788 defsubr (&Sx_hide_tip);
2790 /* used only in fontset.c */
2791 check_window_system_func = check_ns;