1 /* Functions for the NeXT/Open/GNUstep and MacOSX window system.
3 Copyright (C) 1989, 1992-1994, 2005-2006, 2008-2012
4 Free Software Foundation, Inc.
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. */
38 #include "blockinput.h"
41 #include "character.h"
44 #include "termhooks.h"
49 int fns_trace_num = 1;
50 #define NSTRACE(x) fprintf (stderr, "%s:%d: [%d] " #x "\n", \
51 __FILE__, __LINE__, ++fns_trace_num)
58 extern NSArray *ns_send_types, *ns_return_types, *ns_drag_types;
60 extern Lisp_Object Qforeground_color;
61 extern Lisp_Object Qbackground_color;
62 extern Lisp_Object Qcursor_color;
63 extern Lisp_Object Qinternal_border_width;
64 extern Lisp_Object Qvisibility;
65 extern Lisp_Object Qcursor_type;
66 extern Lisp_Object Qicon_type;
67 extern Lisp_Object Qicon_name;
68 extern Lisp_Object Qicon_left;
69 extern Lisp_Object Qicon_top;
70 extern Lisp_Object Qleft;
71 extern Lisp_Object Qright;
72 extern Lisp_Object Qtop;
73 extern Lisp_Object Qdisplay;
74 extern Lisp_Object Qvertical_scroll_bars;
75 extern Lisp_Object Qauto_raise;
76 extern Lisp_Object Qauto_lower;
77 extern Lisp_Object Qbox;
78 extern Lisp_Object Qscroll_bar_width;
79 extern Lisp_Object Qx_resource_name;
80 extern Lisp_Object Qface_set_after_frame_default;
81 extern Lisp_Object Qunderline, Qundefined;
82 extern Lisp_Object Qheight, Qminibuffer, Qname, Qonly, Qwidth;
83 extern Lisp_Object Qunsplittable, Qmenu_bar_lines, Qbuffer_predicate, Qtitle;
84 extern Lisp_Object Qnone;
87 Lisp_Object Qbuffered;
88 Lisp_Object Qfontsize;
90 /* hack for OS X file panels */
93 EmacsTooltip *ns_tooltip;
95 /* Need forward declaration here to preserve organizational integrity of file */
96 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
98 extern BOOL ns_in_resize;
100 /* Static variables to handle applescript execution. */
101 static Lisp_Object as_script, *as_result;
102 static int as_status;
105 static ptrdiff_t image_cache_refcount;
108 /* ==========================================================================
110 Internal utility functions
112 ========================================================================== */
119 error ("OpenStep is not in use or not initialized");
123 /* Nonzero if we can use mouse menus. */
131 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
132 and checking validity for NS. */
134 check_ns_frame (Lisp_Object frame)
139 f = SELECTED_FRAME ();
142 CHECK_LIVE_FRAME (frame);
145 if (! FRAME_NS_P (f))
146 error ("non-Nextstep frame used");
151 /* Let the user specify an Nextstep display with a frame.
152 nil stands for the selected frame--or, if that is not an Nextstep frame,
153 the first Nextstep display on the list. */
154 static struct ns_display_info *
155 check_ns_display_info (Lisp_Object frame)
159 struct frame *f = SELECTED_FRAME ();
160 if (FRAME_NS_P (f) && FRAME_LIVE_P (f) )
161 return FRAME_NS_DISPLAY_INFO (f);
162 else if (x_display_list != 0)
163 return x_display_list;
165 error ("Nextstep windows are not in use or not initialized");
167 else if (INTEGERP (frame))
169 struct terminal *t = get_terminal (frame, 1);
171 if (t->type != output_ns)
172 error ("Terminal %"pI"d is not a Nextstep display", XINT (frame));
174 return t->display_info.ns;
176 else if (STRINGP (frame))
177 return ns_display_info_for_name (frame);
182 CHECK_LIVE_FRAME (frame);
184 if (! FRAME_NS_P (f))
185 error ("non-Nextstep frame used");
186 return FRAME_NS_DISPLAY_INFO (f);
188 return NULL; /* shut compiler up */
193 ns_get_window (Lisp_Object maybeFrame)
195 id view =nil, window =nil;
197 if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
198 maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
200 if (!NILP (maybeFrame))
201 view = FRAME_NS_VIEW (XFRAME (maybeFrame));
202 if (view) window =[view window];
209 ns_get_screen (Lisp_Object screen)
212 struct terminal *terminal;
214 if (EQ (Qt, screen)) /* not documented */
215 return [NSScreen mainScreen];
217 terminal = get_terminal (screen, 1);
218 if (terminal->type != output_ns)
222 f = SELECTED_FRAME ();
223 else if (FRAMEP (screen))
227 struct ns_display_info *dpyinfo = terminal->display_info.ns;
228 f = dpyinfo->x_focus_frame
229 ? dpyinfo->x_focus_frame : dpyinfo->x_highlight_frame;
232 return ((f && FRAME_NS_P (f)) ? [[FRAME_NS_VIEW (f) window] screen]
237 /* Return the X display structure for the display named NAME.
238 Open a new connection if necessary. */
239 struct ns_display_info *
240 ns_display_info_for_name (Lisp_Object name)
243 struct ns_display_info *dpyinfo;
247 for (dpyinfo = x_display_list, names = ns_display_name_list;
249 dpyinfo = dpyinfo->next, names = XCDR (names))
252 tem = Fstring_equal (XCAR (XCAR (names)), name);
257 error ("Emacs for OpenStep does not yet support multi-display.");
259 Fx_open_connection (name, Qnil, Qnil);
260 dpyinfo = x_display_list;
263 error ("OpenStep on %s not responding.\n", SDATA (name));
270 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
271 /* --------------------------------------------------------------------------
272 Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
273 -------------------------------------------------------------------------- */
283 count = [menu numberOfItems];
284 for (i = 0; i<count; i++)
286 item = [menu itemAtIndex: i];
287 name = [[item title] UTF8String];
290 nameStr = build_string (name);
292 if ([item hasSubmenu])
294 old = interpret_services_menu ([item submenu],
295 Fcons (nameStr, prefix), old);
299 keys = [item keyEquivalent];
300 if (keys && [keys length] )
302 key = [keys characterAtIndex: 0];
303 res = make_number (key|super_modifier);
309 old = Fcons (Fcons (res,
310 Freverse (Fcons (nameStr,
320 /* ==========================================================================
322 Frame parameter setters
324 ========================================================================== */
328 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
331 CGFloat r, g, b, alpha;
333 if (ns_lisp_to_color (arg, &col))
335 store_frame_param (f, Qforeground_color, oldval);
336 error ("Unknown color");
340 [f->output_data.ns->foreground_color release];
341 f->output_data.ns->foreground_color = col;
343 [col getRed: &r green: &g blue: &b alpha: &alpha];
344 FRAME_FOREGROUND_PIXEL (f) =
345 ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
347 if (FRAME_NS_VIEW (f))
349 update_face_from_frame_parameter (f, Qforeground_color, arg);
350 /*recompute_basic_faces (f); */
351 if (FRAME_VISIBLE_P (f))
358 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
362 NSView *view = FRAME_NS_VIEW (f);
363 CGFloat r, g, b, alpha;
365 if (ns_lisp_to_color (arg, &col))
367 store_frame_param (f, Qbackground_color, oldval);
368 error ("Unknown color");
371 /* clear the frame; in some instances the NS-internal GC appears not to
372 update, or it does update and cannot clear old text properly */
373 if (FRAME_VISIBLE_P (f))
377 [f->output_data.ns->background_color release];
378 f->output_data.ns->background_color = col;
380 [col getRed: &r green: &g blue: &b alpha: &alpha];
381 FRAME_BACKGROUND_PIXEL (f) =
382 ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
386 [[view window] setBackgroundColor: col];
389 [[view window] setOpaque: NO];
391 [[view window] setOpaque: YES];
393 face = FRAME_DEFAULT_FACE (f);
396 col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
397 face->background = ns_index_color
398 ([col colorWithAlphaComponent: alpha], f);
400 update_face_from_frame_parameter (f, Qbackground_color, arg);
403 if (FRAME_VISIBLE_P (f))
410 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
414 if (ns_lisp_to_color (arg, &col))
416 store_frame_param (f, Qcursor_color, oldval);
417 error ("Unknown color");
420 [FRAME_CURSOR_COLOR (f) release];
421 FRAME_CURSOR_COLOR (f) = [col retain];
423 if (FRAME_VISIBLE_P (f))
425 x_update_cursor (f, 0);
426 x_update_cursor (f, 1);
428 update_face_from_frame_parameter (f, Qcursor_color, arg);
433 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
435 NSView *view = FRAME_NS_VIEW (f);
436 NSTRACE (x_set_icon_name);
441 /* see if it's changed */
444 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
447 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
454 if (!NILP (f->title))
457 /* explicit name and no icon-name -> explicit_name */
458 if (f->explicit_name)
462 /* no explicit name and no icon-name ->
463 name has to be rebuild from icon_title_format */
464 windows_or_buffers_changed++;
469 /* Don't change the name if it's already NAME. */
470 if ([[view window] miniwindowTitle] &&
471 ([[[view window] miniwindowTitle]
472 isEqualToString: [NSString stringWithUTF8String:
476 [[view window] setMiniwindowTitle:
477 [NSString stringWithUTF8String: SDATA (arg)]];
481 ns_set_name_internal (FRAME_PTR f, Lisp_Object name)
484 Lisp_Object encoded_name, encoded_icon_name;
486 NSView *view = FRAME_NS_VIEW (f);
489 encoded_name = ENCODE_UTF_8 (name);
492 str = [NSString stringWithUTF8String: SDATA (encoded_name)];
494 /* Don't change the name if it's already NAME. */
495 if (! [[[view window] title] isEqualToString: str])
496 [[view window] setTitle: str];
498 if (!STRINGP (f->icon_name))
499 encoded_icon_name = encoded_name;
501 encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
503 str = [NSString stringWithUTF8String: SDATA (encoded_icon_name)];
505 if ([[view window] miniwindowTitle] &&
506 ! [[[view window] miniwindowTitle] isEqualToString: str])
507 [[view window] setMiniwindowTitle: str];
512 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
515 NSTRACE (ns_set_name);
520 /* Make sure that requests from lisp code override requests from
521 Emacs redisplay code. */
524 /* If we're switching from explicit to implicit, we had better
525 update the mode lines and thereby update the title. */
526 if (f->explicit_name && NILP (name))
527 update_mode_lines = 1;
529 f->explicit_name = ! NILP (name);
531 else if (f->explicit_name)
535 name = build_string([ns_app_name UTF8String]);
539 /* Don't change the name if it's already NAME. */
540 if (! NILP (Fstring_equal (name, f->name)))
545 /* title overrides explicit name */
546 if (! NILP (f->title))
549 ns_set_name_internal (f, name);
553 /* This function should be called when the user's lisp code has
554 specified a name for the frame; the name will override any set by the
557 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
559 NSTRACE (x_explicitly_set_name);
560 ns_set_name (f, arg, 1);
564 /* This function should be called by Emacs redisplay code to set the
565 name; names set this way will never override names set by the user's
568 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
570 NSTRACE (x_implicitly_set_name);
572 /* Deal with NS specific format t. */
573 if (FRAME_NS_P (f) && ((FRAME_ICONIFIED_P (f) && EQ (Vicon_title_format, Qt))
574 || EQ (Vframe_title_format, Qt)))
575 ns_set_name_as_filename (f);
577 ns_set_name (f, arg, 0);
581 /* Change the title of frame F to NAME.
582 If NAME is nil, use the frame name as the title. */
585 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
587 NSTRACE (x_set_title);
588 /* Don't change the title if it's already NAME. */
589 if (EQ (name, f->title))
592 update_mode_lines = 1;
601 ns_set_name_internal (f, name);
606 ns_set_name_as_filename (struct frame *f)
609 Lisp_Object name, filename;
610 Lisp_Object buf = XWINDOW (f->selected_window)->buffer;
612 NSAutoreleasePool *pool;
614 Lisp_Object encoded_name, encoded_filename;
616 NSTRACE (ns_set_name_as_filename);
618 if (f->explicit_name || ! NILP (f->title) || ns_in_resize)
622 pool = [[NSAutoreleasePool alloc] init];
623 filename = BVAR (XBUFFER (buf), filename);
624 name = BVAR (XBUFFER (buf), name);
628 if (! NILP (filename))
629 name = Ffile_name_nondirectory (filename);
631 name = build_string ([ns_app_name UTF8String]);
635 encoded_name = ENCODE_UTF_8 (name);
638 view = FRAME_NS_VIEW (f);
640 title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
641 : [[[view window] title] UTF8String];
643 if (title && (! strcmp (title, SDATA (encoded_name))))
650 str = [NSString stringWithUTF8String: SDATA (encoded_name)];
651 if (str == nil) str = @"Bad coding";
653 if (FRAME_ICONIFIED_P (f))
654 [[view window] setMiniwindowTitle: str];
659 if (! NILP (filename))
662 encoded_filename = ENCODE_UTF_8 (filename);
665 fstr = [NSString stringWithUTF8String: SDATA (encoded_filename)];
666 if (fstr == nil) fstr = @"";
668 /* work around a bug observed on 10.3 and later where
669 setTitleWithRepresentedFilename does not clear out previous state
670 if given filename does not exist */
671 if (! [[NSFileManager defaultManager] fileExistsAtPath: fstr])
672 [[view window] setRepresentedFilename: @""];
678 [[view window] setRepresentedFilename: fstr];
679 [[view window] setTitle: str];
689 ns_set_doc_edited (struct frame *f, Lisp_Object arg)
691 NSView *view = FRAME_NS_VIEW (f);
692 NSAutoreleasePool *pool;
693 if (!MINI_WINDOW_P (XWINDOW (f->selected_window)))
696 pool = [[NSAutoreleasePool alloc] init];
697 [[view window] setDocumentEdited: !NILP (arg)];
705 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
708 int olines = FRAME_MENU_BAR_LINES (f);
709 if (FRAME_MINIBUF_ONLY_P (f))
712 if (TYPE_RANGED_INTEGERP (int, value))
713 nlines = XINT (value);
717 FRAME_MENU_BAR_LINES (f) = 0;
720 FRAME_EXTERNAL_MENU_BAR (f) = 1;
721 /* does for all frames, whereas we just want for one frame
722 [NSMenu setMenuBarVisible: YES]; */
726 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
727 free_frame_menubar (f);
728 /* [NSMenu setMenuBarVisible: NO]; */
729 FRAME_EXTERNAL_MENU_BAR (f) = 0;
734 /* toolbar support */
736 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
739 Lisp_Object root_window;
741 if (FRAME_MINIBUF_ONLY_P (f))
744 if (RANGED_INTEGERP (0, value, INT_MAX))
745 nlines = XFASTINT (value);
751 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
752 update_frame_tool_bar (f);
756 if (FRAME_EXTERNAL_TOOL_BAR (f))
758 free_frame_tool_bar (f);
759 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
763 x_set_window_size (f, 0, f->text_cols, f->text_lines);
768 ns_implicitly_set_icon_type (struct frame *f)
771 EmacsView *view = FRAME_NS_VIEW (f);
773 Lisp_Object chain, elt;
774 NSAutoreleasePool *pool;
777 NSTRACE (ns_implicitly_set_icon_type);
780 pool = [[NSAutoreleasePool alloc] init];
781 if (f->output_data.ns->miniimage
782 && [[NSString stringWithUTF8String: SDATA (f->name)]
783 isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
790 tem = assq_no_quit (Qicon_type, f->param_alist);
791 if (CONSP (tem) && ! NILP (XCDR (tem)))
798 for (chain = Vns_icon_type_alist;
799 image == nil && CONSP (chain);
800 chain = XCDR (chain))
803 /* special case: 't' means go by file type */
804 if (SYMBOLP (elt) && EQ (elt, Qt) && SDATA (f->name)[0] == '/')
807 = [NSString stringWithUTF8String: SDATA (f->name)];
808 if ([[NSFileManager defaultManager] fileExistsAtPath: str])
809 image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
811 else if (CONSP (elt) &&
812 STRINGP (XCAR (elt)) &&
813 STRINGP (XCDR (elt)) &&
814 fast_string_match (XCAR (elt), f->name) >= 0)
816 image = [EmacsImage allocInitFromFile: XCDR (elt)];
818 image = [[NSImage imageNamed:
819 [NSString stringWithUTF8String:
820 SDATA (XCDR (elt))]] retain];
826 image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
830 [f->output_data.ns->miniimage release];
831 f->output_data.ns->miniimage = image;
832 [view setMiniwindowImage: setMini];
839 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
841 EmacsView *view = FRAME_NS_VIEW (f);
845 NSTRACE (x_set_icon_type);
847 if (!NILP (arg) && SYMBOLP (arg))
849 arg =build_string (SDATA (SYMBOL_NAME (arg)));
850 store_frame_param (f, Qicon_type, arg);
853 /* do it the implicit way */
856 ns_implicitly_set_icon_type (f);
862 image = [EmacsImage allocInitFromFile: arg];
864 image =[NSImage imageNamed: [NSString stringWithUTF8String:
869 image = [NSImage imageNamed: @"text"];
873 f->output_data.ns->miniimage = image;
874 [view setMiniwindowImage: setMini];
878 /* Xism; we stub out (we do implement this in ns-win.el) */
880 XParseGeometry (char *string, int *x, int *y,
881 unsigned int *width, unsigned int *height)
883 message1 ("Warning: XParseGeometry not supported under NS.\n");
888 /* TODO: move to nsterm? */
890 ns_lisp_to_cursor_type (Lisp_Object arg)
893 if (XTYPE (arg) == Lisp_String)
895 else if (XTYPE (arg) == Lisp_Symbol)
896 str = SDATA (SYMBOL_NAME (arg));
898 if (!strcmp (str, "box")) return FILLED_BOX_CURSOR;
899 if (!strcmp (str, "hollow")) return HOLLOW_BOX_CURSOR;
900 if (!strcmp (str, "hbar")) return HBAR_CURSOR;
901 if (!strcmp (str, "bar")) return BAR_CURSOR;
902 if (!strcmp (str, "no")) return NO_CURSOR;
908 ns_cursor_type_to_lisp (int arg)
912 case FILLED_BOX_CURSOR: return Qbox;
913 case HOLLOW_BOX_CURSOR: return intern ("hollow");
914 case HBAR_CURSOR: return intern ("hbar");
915 case BAR_CURSOR: return intern ("bar");
917 default: return intern ("no");
921 /* This is the same as the xfns.c definition. */
923 x_set_cursor_type (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 0, /* x_set_fullscreen will ignore */
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);
1201 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
1203 f->terminal = dpyinfo->terminal;
1205 f->output_method = output_ns;
1206 f->output_data.ns = xzalloc (sizeof *f->output_data.ns);
1208 FRAME_FONTSET (f) = -1;
1210 f->icon_name = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
1212 if (! STRINGP (f->icon_name))
1213 f->icon_name = 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 f->name = build_string ([ns_app_name UTF8String]);
1237 f->explicit_name = 0;
1242 f->explicit_name = 1;
1243 specbind (Qx_resource_name, name);
1246 f->resx = dpyinfo->resx;
1247 f->resy = dpyinfo->resy;
1250 register_font_driver (&nsfont_driver, f);
1251 x_default_parameter (f, parms, Qfont_backend, Qnil,
1252 "fontBackend", "FontBackend", RES_TYPE_STRING);
1255 /* use for default font name */
1256 id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1257 tfontsize = x_default_parameter (f, parms, Qfontsize,
1258 make_number (0 /*(int)[font pointSize]*/),
1259 "fontSize", "FontSize", RES_TYPE_NUMBER);
1260 tfont = x_default_parameter (f, parms, Qfont,
1261 build_string ([[font fontName] UTF8String]),
1262 "font", "Font", RES_TYPE_STRING);
1266 x_default_parameter (f, parms, Qborder_width, make_number (0),
1267 "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1268 x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1269 "internalBorderWidth", "InternalBorderWidth",
1272 /* default scrollbars on right on Mac */
1275 #ifdef NS_IMPL_GNUSTEP
1280 x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1281 "verticalScrollBars", "VerticalScrollBars",
1284 x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1285 "foreground", "Foreground", RES_TYPE_STRING);
1286 x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1287 "background", "Background", RES_TYPE_STRING);
1288 /* FIXME: not supported yet in Nextstep */
1289 x_default_parameter (f, parms, Qline_spacing, Qnil,
1290 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1291 x_default_parameter (f, parms, Qleft_fringe, Qnil,
1292 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1293 x_default_parameter (f, parms, Qright_fringe, Qnil,
1294 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1297 image_cache_refcount =
1298 FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
1301 init_frame_faces (f);
1303 /* The resources controlling the menu-bar and tool-bar are
1304 processed specially at startup, and reflected in the mode
1305 variables; ignore them here. */
1306 x_default_parameter (f, parms, Qmenu_bar_lines,
1307 NILP (Vmenu_bar_mode)
1308 ? make_number (0) : make_number (1),
1309 NULL, NULL, RES_TYPE_NUMBER);
1310 x_default_parameter (f, parms, Qtool_bar_lines,
1311 NILP (Vtool_bar_mode)
1312 ? make_number (0) : make_number (1),
1313 NULL, NULL, RES_TYPE_NUMBER);
1315 x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1316 "BufferPredicate", RES_TYPE_SYMBOL);
1317 x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1320 parms = get_geometry_from_preferences (dpyinfo, parms);
1321 window_prompting = x_figure_window_size (f, parms, 1);
1323 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1324 f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1326 /* NOTE: on other terms, this is done in set_mouse_color, however this
1327 was not getting called under Nextstep */
1328 f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1329 f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1330 f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1331 f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1332 f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1333 f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1334 FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1335 = [NSCursor arrowCursor];
1336 f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1338 [[EmacsView alloc] initFrameFromEmacs: f];
1342 /* ns_display_info does not have a reference_count. */
1343 f->terminal->reference_count++;
1345 /* It is now ok to make the frame official even if we get an error below.
1346 The frame needs to be on Vframe_list or making it visible won't work. */
1347 Vframe_list = Fcons (frame, Vframe_list);
1349 x_default_parameter (f, parms, Qicon_type, Qnil,
1350 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
1352 x_default_parameter (f, parms, Qauto_raise, Qnil,
1353 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
1354 x_default_parameter (f, parms, Qauto_lower, Qnil,
1355 "autoLower", "AutoLower", RES_TYPE_BOOLEAN);
1356 x_default_parameter (f, parms, Qcursor_type, Qbox,
1357 "cursorType", "CursorType", RES_TYPE_SYMBOL);
1358 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
1359 "scrollBarWidth", "ScrollBarWidth",
1361 x_default_parameter (f, parms, Qalpha, Qnil,
1362 "alpha", "Alpha", RES_TYPE_NUMBER);
1364 width = FRAME_COLS (f);
1365 height = FRAME_LINES (f);
1367 SET_FRAME_COLS (f, 0);
1368 FRAME_LINES (f) = 0;
1369 change_frame_size (f, height, width, 1, 0, 0);
1371 if (! f->output_data.ns->explicit_parent)
1373 Lisp_Object visibility;
1375 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
1377 if (EQ (visibility, Qunbound))
1380 if (EQ (visibility, Qicon))
1381 x_iconify_frame (f);
1382 else if (! NILP (visibility))
1384 x_make_frame_visible (f);
1385 [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1389 /* Must have been Qnil. */
1393 if (FRAME_HAS_MINIBUF_P (f)
1394 && (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
1395 || !FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame)))))
1396 KVAR (kb, Vdefault_minibuffer_frame) = frame;
1398 /* All remaining specified parameters, which have not been "used"
1399 by x_get_arg and friends, now go in the misc. alist of the frame. */
1400 for (tem = parms; CONSP (tem); tem = XCDR (tem))
1401 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1402 f->param_alist = Fcons (XCAR (tem), f->param_alist);
1406 /* Make sure windows on this frame appear in calls to next-window
1407 and similar functions. */
1408 Vwindow_list = Qnil;
1410 return unbind_to (count, frame);
1414 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1415 doc: /* Set the input focus to FRAME.
1416 FRAME nil means use the selected frame. */)
1419 struct frame *f = check_ns_frame (frame);
1420 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1422 if (dpyinfo->x_focus_frame != f)
1424 EmacsView *view = FRAME_NS_VIEW (f);
1426 [NSApp activateIgnoringOtherApps: YES];
1427 [[view window] makeKeyAndOrderFront: view];
1435 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1437 doc: /* Pop up the font panel. */)
1444 fm = [NSFontManager sharedFontManager];
1446 f = SELECTED_FRAME ();
1449 CHECK_FRAME (frame);
1453 [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1455 [fm orderFrontFontPanel: NSApp];
1460 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1462 doc: /* Pop up the color panel. */)
1469 f = SELECTED_FRAME ();
1472 CHECK_FRAME (frame);
1476 [NSApp orderFrontColorPanel: NSApp];
1481 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 4, 0,
1482 doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1483 Optional arg DIR, if non-nil, supplies a default directory.
1484 Optional arg MUSTMATCH, if non-nil, means the returned file or
1485 directory must exist.
1486 Optional arg INIT, if non-nil, provides a default file name to use. */)
1487 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object mustmatch, Lisp_Object init)
1489 static id fileDelegate = nil;
1494 NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1495 [NSString stringWithUTF8String: SDATA (prompt)];
1496 NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1497 [NSString stringWithUTF8String: SDATA (BVAR (current_buffer, directory))] :
1498 [NSString stringWithUTF8String: SDATA (dir)];
1499 NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1500 [NSString stringWithUTF8String: SDATA (init)];
1504 if (fileDelegate == nil)
1505 fileDelegate = [EmacsFileDelegate new];
1507 [NSCursor setHiddenUntilMouseMoves: NO];
1509 if ([dirS characterAtIndex: 0] == '~')
1510 dirS = [dirS stringByExpandingTildeInPath];
1512 panel = NILP (mustmatch) ?
1513 (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1515 [panel setTitle: promptS];
1517 /* Puma (10.1) does not have */
1518 if ([panel respondsToSelector: @selector (setAllowsOtherFileTypes:)])
1519 [panel setAllowsOtherFileTypes: YES];
1521 [panel setTreatsFilePackagesAsDirectories: YES];
1522 [panel setDelegate: fileDelegate];
1526 if (NILP (mustmatch))
1528 ret = [panel runModalForDirectory: dirS file: initS];
1532 [panel setCanChooseDirectories: YES];
1533 ret = [panel runModalForDirectory: dirS file: initS types: nil];
1536 ret = (ret == NSOKButton) || panelOK;
1539 fname = build_string ([[panel filename] UTF8String]);
1541 [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1544 return ret ? fname : Qnil;
1548 ns_get_defaults_value (const char *key)
1550 NSObject *obj = [[NSUserDefaults standardUserDefaults]
1551 objectForKey: [NSString stringWithUTF8String: key]];
1553 if (!obj) return NULL;
1555 return [[NSString stringWithFormat: @"%@", obj] UTF8String];
1559 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1560 doc: /* Return the value of the property NAME of OWNER from the defaults database.
1561 If OWNER is nil, Emacs is assumed. */)
1562 (Lisp_Object owner, Lisp_Object name)
1568 owner = build_string([ns_app_name UTF8String]);
1569 CHECK_STRING (name);
1570 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SDATA (name)); */
1572 value = ns_get_defaults_value (SDATA (name));
1575 return build_string (value);
1580 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1581 doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1582 If OWNER is nil, Emacs is assumed.
1583 If VALUE is nil, the default is removed. */)
1584 (Lisp_Object owner, Lisp_Object name, Lisp_Object value)
1588 owner = build_string ([ns_app_name UTF8String]);
1589 CHECK_STRING (name);
1592 [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1593 [NSString stringWithUTF8String: SDATA (name)]];
1597 CHECK_STRING (value);
1598 [[NSUserDefaults standardUserDefaults] setObject:
1599 [NSString stringWithUTF8String: SDATA (value)]
1600 forKey: [NSString stringWithUTF8String:
1608 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1609 Sx_server_max_request_size,
1611 doc: /* This function is a no-op. It is only present for completeness. */)
1612 (Lisp_Object display)
1615 /* This function has no real equivalent under NeXTstep. Return nil to
1621 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1622 doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1623 DISPLAY should be either a frame or a display name (a string).
1624 If omitted or nil, the selected frame's display is used. */)
1625 (Lisp_Object display)
1627 #ifdef NS_IMPL_GNUSTEP
1628 return build_string ("GNU");
1630 return build_string ("Apple");
1635 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1636 doc: /* Return the version numbers of the server of DISPLAY.
1637 The value is a list of three integers: the major and minor
1638 version numbers of the X Protocol in use, and the distributor-specific
1639 release number. See also the function `x-server-vendor'.
1641 The optional argument DISPLAY specifies which display to ask about.
1642 DISPLAY should be either a frame or a display name (a string).
1643 If omitted or nil, that stands for the selected frame's display. */)
1644 (Lisp_Object display)
1646 /*NOTE: it is unclear what would best correspond with "protocol";
1647 we return 10.3, meaning Panther, since this is roughly the
1648 level that GNUstep's APIs correspond to.
1649 The last number is where we distinguish between the Apple
1650 and GNUstep implementations ("distributor-specific release
1651 number") and give int'ized versions of major.minor. */
1652 return Fcons (make_number (10),
1653 Fcons (make_number (3),
1654 Fcons (make_number (ns_appkit_version_int()), Qnil)));
1658 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1659 doc: /* Return the number of screens on Nextstep display server DISPLAY.
1660 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1661 If omitted or nil, the selected frame's display is used. */)
1662 (Lisp_Object display)
1667 num = [[NSScreen screens] count];
1669 return (num != 0) ? make_number (num) : Qnil;
1673 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1675 doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1676 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1677 If omitted or nil, the selected frame's display is used. */)
1678 (Lisp_Object display)
1681 return make_number ((int)
1682 ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1686 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1688 doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
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)
1694 return make_number ((int)
1695 ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1699 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1700 Sx_display_backing_store, 0, 1, 0,
1701 doc: /* Return whether the Nextstep display DISPLAY supports backing store.
1702 The value may be `buffered', `retained', or `non-retained'.
1703 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1704 If omitted or nil, the selected frame's display is used. */)
1705 (Lisp_Object display)
1708 switch ([ns_get_window (display) backingType])
1710 case NSBackingStoreBuffered:
1711 return intern ("buffered");
1712 case NSBackingStoreRetained:
1713 return intern ("retained");
1714 case NSBackingStoreNonretained:
1715 return intern ("non-retained");
1717 error ("Strange value for backingType parameter of frame");
1719 return Qnil; /* not reached, shut compiler up */
1723 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1724 Sx_display_visual_class, 0, 1, 0,
1725 doc: /* Return the visual class of the Nextstep display server DISPLAY.
1726 The value is one of the symbols `static-gray', `gray-scale',
1727 `static-color', `pseudo-color', `true-color', or `direct-color'.
1728 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1729 If omitted or nil, the selected frame's display is used. */)
1730 (Lisp_Object display)
1732 NSWindowDepth depth;
1734 depth = [ns_get_screen (display) depth];
1736 if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1737 return intern ("static-gray");
1738 else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1739 return intern ("gray-scale");
1740 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1741 return intern ("pseudo-color");
1742 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1743 return intern ("true-color");
1744 else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1745 return intern ("direct-color");
1747 /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1748 return intern ("direct-color");
1752 DEFUN ("x-display-save-under", Fx_display_save_under,
1753 Sx_display_save_under, 0, 1, 0,
1754 doc: /* Return t if DISPLAY supports the save-under feature.
1755 The optional argument DISPLAY specifies which display to ask about.
1756 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1757 If omitted or nil, the selected frame's display is used. */)
1758 (Lisp_Object display)
1761 switch ([ns_get_window (display) backingType])
1763 case NSBackingStoreBuffered:
1766 case NSBackingStoreRetained:
1767 case NSBackingStoreNonretained:
1771 error ("Strange value for backingType parameter of frame");
1773 return Qnil; /* not reached, shut compiler up */
1777 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1779 doc: /* Open a connection to a display server.
1780 DISPLAY is the name of the display to connect to.
1781 Optional second arg XRM-STRING is a string of resources in xrdb format.
1782 If the optional third arg MUST-SUCCEED is non-nil,
1783 terminate Emacs if we can't open the connection.
1784 \(In the Nextstep version, the last two arguments are currently ignored.) */)
1785 (Lisp_Object display, Lisp_Object resource_string, Lisp_Object must_succeed)
1787 struct ns_display_info *dpyinfo;
1789 CHECK_STRING (display);
1791 nxatoms_of_nsselect ();
1792 dpyinfo = ns_term_init (display);
1795 if (!NILP (must_succeed))
1796 fatal ("OpenStep on %s not responding.\n",
1799 error ("OpenStep on %s not responding.\n",
1803 /* Register our external input/output types, used for determining
1804 applicable services and also drag/drop eligibility. */
1805 ns_send_types = [[NSArray arrayWithObjects: NSStringPboardType, nil] retain];
1806 ns_return_types = [[NSArray arrayWithObjects: NSStringPboardType, nil]
1808 ns_drag_types = [[NSArray arrayWithObjects:
1810 NSTabularTextPboardType,
1811 NSFilenamesPboardType,
1814 NSFontPboardType, nil] retain];
1820 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1822 doc: /* Close the connection to the current Nextstep display server.
1823 The argument DISPLAY is currently ignored. */)
1824 (Lisp_Object display)
1827 /*ns_delete_terminal (dpyinfo->terminal); */
1828 [NSApp terminate: NSApp];
1833 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1834 doc: /* Return the list of display names that Emacs has connections to. */)
1837 Lisp_Object tail, result;
1840 for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1841 result = Fcons (XCAR (XCAR (tail)), result);
1847 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1849 doc: /* Hides all applications other than Emacs. */)
1853 [NSApp hideOtherApplications: NSApp];
1857 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1859 doc: /* If ON is non-nil, the entire Emacs application is hidden.
1860 Otherwise if Emacs is hidden, it is unhidden.
1861 If ON is equal to `activate', Emacs is unhidden and becomes
1862 the active application. */)
1866 if (EQ (on, intern ("activate")))
1868 [NSApp unhide: NSApp];
1869 [NSApp activateIgnoringOtherApps: YES];
1872 [NSApp unhide: NSApp];
1874 [NSApp hide: NSApp];
1879 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1881 doc: /* Shows the 'Info' or 'About' panel for Emacs. */)
1885 [NSApp orderFrontStandardAboutPanel: nil];
1890 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1891 doc: /* Determine font PostScript or family name for font NAME.
1892 NAME should be a string containing either the font name or an XLFD
1893 font descriptor. If string contains `fontset' and not
1894 `fontset-startup', it is left alone. */)
1898 CHECK_STRING (name);
1903 if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1906 return build_string (ns_xlfd_to_fontname (SDATA (name)));
1910 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1911 doc: /* Return a list of all available colors.
1912 The optional argument FRAME is currently ignored. */)
1915 Lisp_Object list = Qnil;
1916 NSEnumerator *colorlists;
1921 CHECK_FRAME (frame);
1922 if (! FRAME_NS_P (XFRAME (frame)))
1923 error ("non-Nextstep frame used in `ns-list-colors'");
1928 colorlists = [[NSColorList availableColorLists] objectEnumerator];
1929 while (clist = [colorlists nextObject])
1931 if ([[clist name] length] < 7 ||
1932 [[clist name] rangeOfString: @"PANTONE"].location == 0)
1934 NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1936 while (cname = [cnames nextObject])
1937 list = Fcons (build_string ([cname UTF8String]), list);
1938 /* for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1939 list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1940 UTF8String]), list); */
1950 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1951 doc: /* List available Nextstep services by querying NSApp. */)
1954 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
1955 /* You can't get services like this in 10.6+. */
1958 Lisp_Object ret = Qnil;
1963 svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1964 [NSApp setServicesMenu: svcs]; /* this and next rebuild on <10.4 */
1965 [NSApp registerServicesMenuSendTypes: ns_send_types
1966 returnTypes: ns_return_types];
1968 /* On Tiger, services menu updating was made lazier (waits for user to
1969 actually click on the menu), so we have to force things along: */
1970 #ifdef NS_IMPL_COCOA
1971 if (NSAppKitVersionNumber >= 744.0)
1973 delegate = [svcs delegate];
1974 if (delegate != nil)
1976 if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1977 [delegate menuNeedsUpdate: svcs];
1978 if ([delegate respondsToSelector:
1979 @selector (menu:updateItem:atIndex:shouldCancel:)])
1981 int i, len = [delegate numberOfItemsInMenu: svcs];
1982 for (i =0; i<len; i++)
1983 [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1984 for (i =0; i<len; i++)
1985 if (![delegate menu: svcs
1986 updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1987 atIndex: i shouldCancel: NO])
1994 [svcs setAutoenablesItems: NO];
1995 #ifdef NS_IMPL_COCOA
1996 [svcs update]; /* on OS X, converts from '/' structure */
1999 ret = interpret_services_menu (svcs, Qnil, ret);
2005 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
2007 doc: /* Perform Nextstep SERVICE on SEND.
2008 SEND should be either a string or nil.
2009 The return value is the result of the service, as string, or nil if
2010 there was no result. */)
2011 (Lisp_Object service, Lisp_Object send)
2018 CHECK_STRING (service);
2021 utfStr = SDATA (service);
2022 svcName = [NSString stringWithUTF8String: utfStr];
2024 pb =[NSPasteboard pasteboardWithUniqueName];
2025 ns_string_to_pasteboard (pb, send);
2027 if (NSPerformService (svcName, pb) == NO)
2028 Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
2030 if ([[pb types] count] == 0)
2031 return build_string ("");
2032 return ns_string_from_pasteboard (pb);
2036 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
2037 Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
2038 doc: /* Return an NFC string that matches the UTF-8 NFD string STR. */)
2041 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
2046 utfStr = [NSString stringWithUTF8String: SDATA (str)];
2047 if (![utfStr respondsToSelector:
2048 @selector (precomposedStringWithCanonicalMapping)])
2051 ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
2055 utfStr = [utfStr precomposedStringWithCanonicalMapping];
2056 return build_string ([utfStr UTF8String]);
2060 #ifdef NS_IMPL_COCOA
2062 /* Compile and execute the AppleScript SCRIPT and return the error
2063 status as function value. A zero is returned if compilation and
2064 execution is successful, in which case *RESULT is set to a Lisp
2065 string or a number containing the resulting script value. Otherwise,
2068 ns_do_applescript (Lisp_Object script, Lisp_Object *result)
2070 NSAppleEventDescriptor *desc;
2071 NSDictionary* errorDict;
2072 NSAppleEventDescriptor* returnDescriptor = NULL;
2074 NSAppleScript* scriptObject =
2075 [[NSAppleScript alloc] initWithSource:
2076 [NSString stringWithUTF8String: SDATA (script)]];
2078 returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2079 [scriptObject release];
2083 if (returnDescriptor != NULL)
2085 // successful execution
2086 if (kAENullEvent != [returnDescriptor descriptorType])
2089 // script returned an AppleScript result
2090 if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2091 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
2092 (typeUTF16ExternalRepresentation
2093 == [returnDescriptor descriptorType]) ||
2095 (typeUTF8Text == [returnDescriptor descriptorType]) ||
2096 (typeCString == [returnDescriptor descriptorType]))
2098 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2100 *result = build_string([[desc stringValue] UTF8String]);
2104 /* use typeUTF16ExternalRepresentation? */
2105 // coerce the result to the appropriate ObjC type
2106 desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2108 *result = make_number([desc int32Value]);
2114 // no script result, return error
2120 /* Helper function called from sendEvent to run applescript
2121 from within the main event loop. */
2124 ns_run_ascript (void)
2126 as_status = ns_do_applescript (as_script, as_result);
2129 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2130 doc: /* Execute AppleScript SCRIPT and return the result.
2131 If compilation and execution are successful, the resulting script value
2132 is returned as a string, a number or, in the case of other constructs, t.
2133 In case the execution fails, an error is signaled. */)
2134 (Lisp_Object script)
2140 CHECK_STRING (script);
2146 as_result = &result;
2148 /* executing apple script requires the event loop to run, otherwise
2149 errors aren't returned and executeAndReturnError hangs forever.
2150 Post an event that runs applescript and then start the event loop.
2151 The event loop is exited when the script is done. */
2152 nxev = [NSEvent otherEventWithType: NSApplicationDefined
2153 location: NSMakePoint (0, 0)
2156 windowNumber: [[NSApp mainWindow] windowNumber]
2157 context: [NSApp context]
2160 data2: NSAPP_DATA2_RUNASSCRIPT];
2162 [NSApp postEvent: nxev atStart: NO];
2172 else if (!STRINGP (result))
2173 error ("AppleScript error %d", status);
2175 error ("%s", SDATA (result));
2181 /* ==========================================================================
2183 Miscellaneous functions not called through hooks
2185 ========================================================================== */
2188 /* called from image.c */
2190 check_x_frame (Lisp_Object frame)
2192 return check_ns_frame (frame);
2196 /* called from frame.c */
2197 struct ns_display_info *
2198 check_x_display_info (Lisp_Object frame)
2200 return check_ns_display_info (frame);
2205 x_set_scroll_bar_default_width (struct frame *f)
2207 int wid = FRAME_COLUMN_WIDTH (f);
2208 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2209 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2214 /* terms impl this instead of x-get-resource directly */
2216 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2218 /* remove appname prefix; TODO: allow for !="Emacs" */
2219 char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2223 if (inhibit_x_resources)
2224 /* --quick was passed, so this is a no-op. */
2227 res = ns_get_defaults_value (toCheck);
2228 return !res ? NULL :
2229 (!strncasecmp (res, "YES", 3) ? "true" :
2230 (!strncasecmp (res, "NO", 2) ? "false" : res));
2235 x_get_focus_frame (struct frame *frame)
2237 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2238 Lisp_Object nsfocus;
2240 if (!dpyinfo->x_focus_frame)
2243 XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2249 x_pixel_width (struct frame *f)
2251 return FRAME_PIXEL_WIDTH (f);
2256 x_pixel_height (struct frame *f)
2258 return FRAME_PIXEL_HEIGHT (f);
2263 x_char_width (struct frame *f)
2265 return FRAME_COLUMN_WIDTH (f);
2270 x_char_height (struct frame *f)
2272 return FRAME_LINE_HEIGHT (f);
2277 x_screen_planes (struct frame *f)
2279 return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2284 x_sync (struct frame *f)
2286 /* XXX Not implemented XXX */
2292 /* ==========================================================================
2294 Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2296 ========================================================================== */
2299 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2300 doc: /* Internal function called by `color-defined-p', which see.
2301 \(Note that the Nextstep version of this function ignores FRAME.) */)
2302 (Lisp_Object color, Lisp_Object frame)
2306 return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2310 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2311 doc: /* Internal function called by `color-values', which see. */)
2312 (Lisp_Object color, Lisp_Object frame)
2315 CGFloat red, green, blue, alpha;
2318 CHECK_STRING (color);
2320 if (ns_lisp_to_color (color, &col))
2323 [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2324 getRed: &red green: &green blue: &blue alpha: &alpha];
2325 return list3 (make_number (lrint (red*65280)),
2326 make_number (lrint (green*65280)),
2327 make_number (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 display)
2335 NSWindowDepth depth;
2336 NSString *colorSpace;
2338 depth = [ns_get_screen (display) depth];
2339 colorSpace = NSColorSpaceFromDepth (depth);
2341 return [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2342 || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2347 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2348 Sx_display_grayscale_p, 0, 1, 0,
2349 doc: /* Return t if the Nextstep display supports shades of gray.
2350 Note that color displays do support shades of gray.
2351 The optional argument DISPLAY specifies which display to ask about.
2352 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2353 If omitted or nil, that stands for the selected frame's display. */)
2354 (Lisp_Object display)
2356 NSWindowDepth depth;
2358 depth = [ns_get_screen (display) depth];
2360 return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2364 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2366 doc: /* Return the width in pixels of the Nextstep display DISPLAY.
2367 The optional argument DISPLAY specifies which display to ask about.
2368 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2369 If omitted or nil, that stands for the selected frame's display. */)
2370 (Lisp_Object display)
2373 return make_number ((int) [ns_get_screen (display) frame].size.width);
2377 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2378 Sx_display_pixel_height, 0, 1, 0,
2379 doc: /* Return the height in pixels of the Nextstep display DISPLAY.
2380 The optional argument DISPLAY specifies which display to ask about.
2381 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2382 If omitted or nil, that stands for the selected frame's display. */)
2383 (Lisp_Object display)
2386 return make_number ((int) [ns_get_screen (display) frame].size.height);
2390 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2391 Sns_display_usable_bounds, 0, 1, 0,
2392 doc: /* Return the bounds of the usable part of the screen.
2393 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2394 are the boundaries of the usable part of the screen, excluding areas
2395 reserved for the Mac menu, dock, and so forth.
2397 The screen queried corresponds to DISPLAY, which should be either a
2398 frame, a display name (a string), or terminal ID. If omitted or nil,
2399 that stands for the selected frame's display. */)
2400 (Lisp_Object display)
2407 screen = ns_get_screen (display);
2411 vScreen = [screen visibleFrame];
2413 /* NS coordinate system is upside-down.
2414 Transform to screen-specific coordinates. */
2415 return list4 (make_number ((int) vScreen.origin.x),
2416 make_number ((int) [screen frame].size.height
2417 - vScreen.size.height - vScreen.origin.y),
2418 make_number ((int) vScreen.size.width),
2419 make_number ((int) 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 = SDATA (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];
2640 @implementation EmacsOpenPanel
2641 #ifdef NS_IMPL_COCOA
2642 /* --------------------------------------------------------------------------
2643 These are overridden to intercept on OS X: ending panel restarts NSApp
2644 event loop if it is stopped. Not sure if this is correct behavior,
2645 perhaps should check if running and if so send an appdefined.
2646 -------------------------------------------------------------------------- */
2647 - (void) ok: (id)sender
2653 - (void) cancel: (id)sender
2655 [super cancel: sender];
2662 @implementation EmacsFileDelegate
2663 /* --------------------------------------------------------------------------
2664 Delegate methods for Open/Save panels
2665 -------------------------------------------------------------------------- */
2666 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2670 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2674 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2675 confirmed: (BOOL)okFlag
2684 /* ==========================================================================
2686 Lisp interface declaration
2688 ========================================================================== */
2692 syms_of_nsfns (void)
2696 Qfontsize = intern_c_string ("fontsize");
2697 staticpro (&Qfontsize);
2699 DEFVAR_LISP ("ns-icon-type-alist", Vns_icon_type_alist,
2700 doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2701 If the title of a frame matches REGEXP, then IMAGE.tiff is
2702 selected as the image of the icon representing the frame when it's
2703 miniaturized. If an element is t, then Emacs tries to select an icon
2704 based on the filetype of the visited file.
2706 The images have to be installed in a folder called English.lproj in the
2707 Emacs folder. You have to restart Emacs after installing new icons.
2709 Example: Install an icon Gnus.tiff and execute the following code
2711 (setq ns-icon-type-alist
2712 (append ns-icon-type-alist
2713 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2716 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2717 be used as the image of the icon representing the frame. */);
2718 Vns_icon_type_alist = Fcons (Qt, Qnil);
2720 DEFVAR_LISP ("ns-version-string", Vns_version_string,
2721 doc: /* Toolkit version for NS Windowing. */);
2722 Vns_version_string = ns_appkit_version_str ();
2724 defsubr (&Sns_read_file_name);
2725 defsubr (&Sns_get_resource);
2726 defsubr (&Sns_set_resource);
2727 defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2728 defsubr (&Sx_display_grayscale_p);
2729 defsubr (&Sns_font_name);
2730 defsubr (&Sns_list_colors);
2731 #ifdef NS_IMPL_COCOA
2732 defsubr (&Sns_do_applescript);
2734 defsubr (&Sxw_color_defined_p);
2735 defsubr (&Sxw_color_values);
2736 defsubr (&Sx_server_max_request_size);
2737 defsubr (&Sx_server_vendor);
2738 defsubr (&Sx_server_version);
2739 defsubr (&Sx_display_pixel_width);
2740 defsubr (&Sx_display_pixel_height);
2741 defsubr (&Sns_display_usable_bounds);
2742 defsubr (&Sx_display_mm_width);
2743 defsubr (&Sx_display_mm_height);
2744 defsubr (&Sx_display_screens);
2745 defsubr (&Sx_display_planes);
2746 defsubr (&Sx_display_color_cells);
2747 defsubr (&Sx_display_visual_class);
2748 defsubr (&Sx_display_backing_store);
2749 defsubr (&Sx_display_save_under);
2750 defsubr (&Sx_create_frame);
2751 defsubr (&Sx_open_connection);
2752 defsubr (&Sx_close_connection);
2753 defsubr (&Sx_display_list);
2755 defsubr (&Sns_hide_others);
2756 defsubr (&Sns_hide_emacs);
2757 defsubr (&Sns_emacs_info_panel);
2758 defsubr (&Sns_list_services);
2759 defsubr (&Sns_perform_service);
2760 defsubr (&Sns_convert_utf8_nfd_to_nfc);
2761 defsubr (&Sx_focus_frame);
2762 defsubr (&Sns_popup_font_panel);
2763 defsubr (&Sns_popup_color_panel);
2765 defsubr (&Sx_show_tip);
2766 defsubr (&Sx_hide_tip);
2768 /* used only in fontset.c */
2769 check_window_system_func = check_ns;