1 ;;; mime-view.el --- interactive MIME viewer for GNU Emacs
3 ;; Copyright (C) 1995,1996,1997,1998 Free Software Foundation, Inc.
5 ;; Author: MORIOKA Tomohiko <morioka@jaist.ac.jp>
7 ;; Renamed: 1994/08/31 from tm-body.el
8 ;; Renamed: 1997/02/19 from tm-view.el
9 ;; Keywords: MIME, multimedia, mail, news
11 ;; This file is part of SEMI (Sophisticated Emacs MIME Interfaces).
13 ;; This program is free software; you can redistribute it and/or
14 ;; modify it under the terms of the GNU General Public License as
15 ;; published by the Free Software Foundation; either version 2, or (at
16 ;; your option) any later version.
18 ;; This program is distributed in the hope that it will be useful, but
19 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
21 ;; General Public License for more details.
23 ;; You should have received a copy of the GNU General Public License
24 ;; along with GNU Emacs; see the file COPYING. If not, write to the
25 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
26 ;; Boston, MA 02111-1307, USA.
41 (defconst mime-view-version-string
42 `,(concat (car mime-user-interface-version) " MIME-View "
43 (mapconcat #'number-to-string
44 (cddr mime-user-interface-version) ".")
45 " (" (cadr mime-user-interface-version) ")"))
51 (defgroup mime-view nil
55 (defcustom mime-view-find-every-acting-situation t
56 "*Find every available acting-situation if non-nil."
60 (defcustom mime-acting-situation-examples-file "~/.mime-example"
61 "*File name of example about acting-situation demonstrated by user."
66 ;;; @ in raw-buffer (representation space)
69 (defvar mime-preview-buffer nil
70 "MIME-preview buffer corresponding with the (raw) buffer.")
71 (make-variable-buffer-local 'mime-preview-buffer)
74 (defvar mime-raw-representation-type nil
75 "Representation-type of mime-raw-buffer.
76 It must be nil, `binary' or `cooked'.
77 If it is nil, `mime-raw-representation-type-alist' is used as default
79 Notice that this variable is usually used as buffer local variable in
82 (make-variable-buffer-local 'mime-raw-representation-type)
84 (defvar mime-raw-representation-type-alist
85 '((mime-show-message-mode . binary)
86 (mime-temp-message-mode . binary)
89 "Alist of major-mode vs. representation-type of mime-raw-buffer.
90 Each element looks like (SYMBOL . REPRESENTATION-TYPE). SYMBOL is
91 major-mode or t. t means default. REPRESENTATION-TYPE must be
93 This value is overridden by buffer local variable
94 `mime-raw-representation-type' if it is not nil.")
97 (defsubst mime-raw-find-entity-from-node-id (entity-node-id
98 &optional message-info)
99 "Return entity from ENTITY-NODE-ID in mime-raw-buffer.
100 If optional argument MESSAGE-INFO is not specified,
101 `mime-message-structure' is used."
102 (mime-raw-find-entity-from-number (reverse entity-node-id) message-info))
104 (defun mime-raw-find-entity-from-number (entity-number &optional message-info)
105 "Return entity from ENTITY-NUMBER in mime-raw-buffer.
106 If optional argument MESSAGE-INFO is not specified,
107 `mime-message-structure' is used."
109 (setq message-info mime-message-structure))
110 (if (eq entity-number t)
112 (let ((sn (car entity-number)))
115 (let ((rc (nth sn (mime-entity-children message-info))))
117 (mime-raw-find-entity-from-number (cdr entity-number) rc)
121 (defun mime-raw-find-entity-from-point (point &optional message-info)
122 "Return entity from POINT in mime-raw-buffer.
123 If optional argument MESSAGE-INFO is not specified,
124 `mime-message-structure' is used."
126 (setq message-info mime-message-structure))
127 (if (and (<= (mime-entity-point-min message-info) point)
128 (<= point (mime-entity-point-max message-info)))
129 (let ((children (mime-entity-children message-info)))
133 (mime-raw-find-entity-from-point point (car children))))
137 (setq children (cdr children)))
141 ;;; @ in preview-buffer (presentation space)
144 (defvar mime-mother-buffer nil
145 "Mother buffer corresponding with the (MIME-preview) buffer.
146 If current MIME-preview buffer is generated by other buffer, such as
147 message/partial, it is called `mother-buffer'.")
148 (make-variable-buffer-local 'mime-mother-buffer)
150 (defvar mime-raw-buffer nil
151 "Raw buffer corresponding with the (MIME-preview) buffer.")
152 (make-variable-buffer-local 'mime-raw-buffer)
154 (defvar mime-preview-original-window-configuration nil
155 "Window-configuration before mime-view-mode is called.")
156 (make-variable-buffer-local 'mime-preview-original-window-configuration)
158 (defun mime-preview-original-major-mode (&optional recursive)
159 "Return major-mode of original buffer.
160 If optional argument RECURSIVE is non-nil and current buffer has
161 mime-mother-buffer, it returns original major-mode of the
163 (if (and recursive mime-mother-buffer)
165 (set-buffer mime-mother-buffer)
166 (mime-preview-original-major-mode recursive)
171 (get-text-property (point-min) 'mime-view-entity)))
175 ;;; @ entity information
178 (defsubst mime-entity-representation-type (entity)
179 (with-current-buffer (mime-entity-buffer entity)
180 (or mime-raw-representation-type
181 (cdr (or (assq major-mode mime-raw-representation-type-alist)
182 (assq t mime-raw-representation-type-alist))))))
184 (defsubst mime-entity-cooked-p (entity)
185 (eq (mime-entity-representation-type entity) 'cooked))
187 (defsubst mime-entity-parent (entity &optional message-info)
188 "Return mother entity of ENTITY.
189 If optional argument MESSAGE-INFO is not specified,
190 `mime-message-structure' in buffer of ENTITY is used."
191 (mime-raw-find-entity-from-node-id
192 (cdr (mime-entity-node-id entity))
195 (set-buffer (mime-entity-buffer entity))
196 mime-message-structure))))
198 (defun mime-entity-situation (entity)
199 "Return situation of ENTITY."
200 (append (or (mime-entity-content-type entity)
201 (make-mime-content-type 'text 'plain))
202 (let ((d (mime-entity-content-disposition entity)))
203 (cons (cons 'disposition-type
204 (mime-content-disposition-type d))
207 (let ((name (car param)))
208 (cons (cond ((string= name "filename")
210 ((string= name "creation-date")
212 ((string= name "modification-date")
214 ((string= name "read-date")
216 ((string= name "size")
218 (t (cons 'disposition (car param))))
220 (mime-content-disposition-parameters d))
222 (list (cons 'encoding (mime-entity-encoding entity))
225 (set-buffer (mime-entity-buffer entity))
230 (defvar mime-view-uuencode-encoding-name-list '("x-uue" "x-uuencode"))
232 (defun mime-entity-uu-filename (entity)
233 (if (member (mime-entity-encoding entity)
234 mime-view-uuencode-encoding-name-list)
236 (set-buffer (mime-entity-buffer entity))
237 (goto-char (mime-entity-body-start entity))
238 (if (re-search-forward "^begin [0-9]+ "
239 (mime-entity-body-end entity) t)
240 (if (looking-at ".+$")
241 (buffer-substring (match-beginning 0)(match-end 0))
244 (defun mime-entity-filename (entity)
245 (or (mime-entity-uu-filename entity)
246 (let ((ret (mime-entity-content-disposition entity)))
248 (setq ret (mime-content-disposition-filename ret))
249 (std11-strip-quoted-string ret)
251 (let ((ret (mime-entity-content-type entity)))
255 (let ((param (mime-content-type-parameters ret)))
256 (or (assoc "name" param)
257 (assoc "x-name" param))
259 (std11-strip-quoted-string ret)
263 (defun mime-view-entity-title (entity)
264 (or (mime-entity-read-field entity 'Content-Description)
265 (mime-entity-read-field entity 'Subject)
266 (mime-entity-filename entity)
270 (defsubst mime-raw-point-to-entity-node-id (point &optional message-info)
271 "Return entity-node-id from POINT in mime-raw-buffer.
272 If optional argument MESSAGE-INFO is not specified,
273 `mime-message-structure' is used."
274 (mime-entity-node-id (mime-raw-find-entity-from-point point message-info)))
276 (defsubst mime-raw-point-to-entity-number (point &optional message-info)
277 "Return entity-number from POINT in mime-raw-buffer.
278 If optional argument MESSAGE-INFO is not specified,
279 `mime-message-structure' is used."
280 (mime-entity-number (mime-raw-find-entity-from-point point message-info)))
282 (defun mime-raw-flatten-message-info (&optional message-info)
283 "Return list of entity in mime-raw-buffer.
284 If optional argument MESSAGE-INFO is not specified,
285 `mime-message-structure' is used."
287 (setq message-info mime-message-structure))
288 (let ((dest (list message-info))
289 (rcl (mime-entity-children message-info)))
291 (setq dest (nconc dest (mime-raw-flatten-message-info (car rcl))))
292 (setq rcl (cdr rcl)))
296 ;;; @ presentation of preview
302 ;;; @@@ predicate function
305 (defun mime-view-entity-button-visible-p (entity)
306 "Return non-nil if header of ENTITY is visible.
307 Please redefine this function if you want to change default setting."
308 (let ((media-type (mime-entity-media-type entity))
309 (media-subtype (mime-entity-media-subtype entity)))
310 (or (not (eq media-type 'application))
311 (and (not (eq media-subtype 'x-selection))
312 (or (not (eq media-subtype 'octet-stream))
313 (let ((mother-entity (mime-entity-parent entity)))
314 (or (not (eq (mime-entity-media-type mother-entity)
316 (not (eq (mime-entity-media-subtype mother-entity)
321 ;;; @@@ entity button generator
324 (defun mime-view-insert-entity-button (entity)
325 "Insert entity-button of ENTITY."
326 (let ((entity-node-id (mime-entity-node-id entity))
327 (params (mime-entity-parameters entity))
328 (subject (mime-view-entity-title entity)))
330 (let ((access-type (assoc "access-type" params))
331 (num (or (cdr (assoc "x-part-number" params))
332 (if (consp entity-node-id)
335 (format "%s" (1+ num))
337 (reverse entity-node-id) ".")
341 (let ((server (assoc "server" params)))
342 (setq access-type (cdr access-type))
344 (format "%s %s ([%s] %s)"
345 num subject access-type (cdr server))
346 (let ((site (cdr (assoc "site" params)))
347 (dir (cdr (assoc "directory" params)))
349 (format "%s %s ([%s] %s:%s)"
350 num subject access-type site dir)
354 (let ((media-type (mime-entity-media-type entity))
355 (media-subtype (mime-entity-media-subtype entity))
356 (charset (cdr (assoc "charset" params)))
357 (encoding (mime-entity-encoding entity)))
361 (format " <%s/%s%s%s>"
362 media-type media-subtype
364 (concat "; " charset)
367 (concat " (" encoding ")")
369 (if (>= (+ (current-column)(length rest))(window-width))
373 (function mime-preview-play-current-entity))
380 (defvar mime-header-presentation-method-alist nil
381 "Alist of major mode vs. corresponding header-presentation-method functions.
382 Each element looks like (SYMBOL . FUNCTION).
383 SYMBOL must be major mode in raw-buffer or t. t means default.
384 Interface of FUNCTION must be (ENTITY SITUATION).")
386 (defvar mime-view-ignored-field-list
387 '(".*Received" ".*Path" ".*Id" "References"
388 "Replied" "Errors-To"
389 "Lines" "Sender" ".*Host" "Xref"
390 "Content-Type" "Precedence"
392 "All fields that match this list will be hidden in MIME preview buffer.
393 Each elements are regexp of field-name.")
395 (defvar mime-view-visible-field-list '("Dnas.*" "Message-Id")
396 "All fields that match this list will be displayed in MIME preview buffer.
397 Each elements are regexp of field-name.")
403 ;;; @@@ predicate function
406 (defun mime-calist::field-match-method-as-default-rule (calist
407 field-type field-value)
408 (let ((s-field (assq field-type calist)))
409 (cond ((null s-field)
410 (cons (cons field-type field-value) calist)
414 (define-calist-field-match-method
415 'header #'mime-calist::field-match-method-as-default-rule)
417 (define-calist-field-match-method
418 'body #'mime-calist::field-match-method-as-default-rule)
421 (defvar mime-preview-condition nil
422 "Condition-tree about how to display entity.")
424 (ctree-set-calist-strictly
425 'mime-preview-condition '((type . application)(subtype . octet-stream)
428 (ctree-set-calist-strictly
429 'mime-preview-condition '((type . application)(subtype . octet-stream)
432 (ctree-set-calist-strictly
433 'mime-preview-condition '((type . application)(subtype . octet-stream)
437 (ctree-set-calist-strictly
438 'mime-preview-condition '((type . application)(subtype . pgp)
441 (ctree-set-calist-strictly
442 'mime-preview-condition '((type . application)(subtype . x-latex)
445 (ctree-set-calist-strictly
446 'mime-preview-condition '((type . application)(subtype . x-selection)
449 (ctree-set-calist-strictly
450 'mime-preview-condition '((type . application)(subtype . x-comment)
453 (ctree-set-calist-strictly
454 'mime-preview-condition '((type . message)(subtype . delivery-status)
457 (ctree-set-calist-strictly
458 'mime-preview-condition
460 (body-presentation-method . mime-display-text/plain)))
462 (ctree-set-calist-strictly
463 'mime-preview-condition
466 (body-presentation-method . mime-display-text/plain)))
468 (ctree-set-calist-strictly
469 'mime-preview-condition
470 '((type . text)(subtype . enriched)
472 (body-presentation-method . mime-display-text/enriched)))
474 (ctree-set-calist-strictly
475 'mime-preview-condition
476 '((type . text)(subtype . richtext)
478 (body-presentation-method . mime-display-text/richtext)))
480 (ctree-set-calist-strictly
481 'mime-preview-condition
482 '((type . text)(subtype . t)
484 (body-presentation-method . mime-display-text/plain)))
486 (ctree-set-calist-strictly
487 'mime-preview-condition
488 '((type . multipart)(subtype . alternative)
490 (body-presentation-method . mime-display-multipart/alternative)))
492 (ctree-set-calist-strictly
493 'mime-preview-condition '((type . message)(subtype . partial)
494 (body-presentation-method
495 . mime-display-message/partial-button)))
497 (ctree-set-calist-strictly
498 'mime-preview-condition '((type . message)(subtype . rfc822)
499 (body-presentation-method . nil)
500 (childrens-situation (header . visible)
501 (entity-button . invisible))))
503 (ctree-set-calist-strictly
504 'mime-preview-condition '((type . message)(subtype . news)
505 (body-presentation-method . nil)
506 (childrens-situation (header . visible)
507 (entity-button . invisible))))
510 ;;; @@@ entity presentation
513 (autoload 'mime-display-text/plain "mime-text")
514 (autoload 'mime-display-text/enriched "mime-text")
515 (autoload 'mime-display-text/richtext "mime-text")
517 (defvar mime-view-announcement-for-message/partial
518 (if (and (>= emacs-major-version 19) window-system)
520 \[[ This is message/partial style split message. ]]
521 \[[ Please press `v' key in this buffer ]]
522 \[[ or click here by mouse button-2. ]]"
524 \[[ This is message/partial style split message. ]]
525 \[[ Please press `v' key in this buffer. ]]"
528 (defun mime-display-message/partial-button (&optional entity situation)
530 (goto-char (point-max))
531 (if (not (search-backward "\n\n" nil t))
534 (goto-char (point-max))
535 (narrow-to-region (point-max)(point-max))
536 (insert mime-view-announcement-for-message/partial)
537 (mime-add-button (point-min)(point-max)
538 #'mime-preview-play-current-entity)
541 (defun mime-display-multipart/mixed (entity situation)
542 (let ((children (mime-entity-children entity))
544 (cdr (assq 'childrens-situation situation))))
546 (mime-display-entity (car children) nil default-situation)
547 (setq children (cdr children))
550 (defcustom mime-view-type-subtype-score-alist
551 '(((text . enriched) . 3)
552 ((text . richtext) . 2)
555 "Alist MEDIA-TYPE vs corresponding score.
556 MEDIA-TYPE must be (TYPE . SUBTYPE), TYPE or t. t means default."
558 :type '(repeat (cons (choice :tag "Media-Type"
559 (item :tag "Type/Subtype"
560 (cons symbol symbol))
561 (item :tag "Type" symbol)
562 (item :tag "Default" t))
565 (defun mime-display-multipart/alternative (entity situation)
566 (let* ((children (mime-entity-children entity))
568 (cdr (assq 'childrens-situation situation)))
576 (or (ctree-match-calist
577 mime-preview-condition
578 (append (mime-entity-situation child)
581 (if (cdr (assq 'body-presentation-method situation))
586 (cdr (assq 'type situation))
587 (cdr (assq 'subtype situation)))
588 mime-view-type-subtype-score-alist)
590 (cdr (assq 'type situation))
591 mime-view-type-subtype-score-alist)
594 mime-view-type-subtype-score-alist)
596 (if (> score max-score)
606 (let ((child (car children))
607 (situation (car situations)))
608 (mime-display-entity child (if (= i p)
610 (del-alist 'body-presentation-method
611 (copy-alist situation))))
613 (setq children (cdr children)
614 situations (cdr situations)
619 ;;; @ acting-condition
622 (defvar mime-acting-condition nil
623 "Condition-tree about how to process entity.")
625 (if (file-readable-p mailcap-file)
626 (let ((entries (mailcap-parse-file)))
628 (let ((entry (car entries))
631 (let* ((field (car entry))
632 (field-type (car field)))
633 (cond ((eq field-type 'view) (setq view field))
634 ((eq field-type 'print) (setq print field))
635 ((memq field-type '(compose composetyped edit)))
636 (t (setq shared (cons field shared))))
638 (setq entry (cdr entry))
640 (setq shared (nreverse shared))
641 (ctree-set-calist-with-default
642 'mime-acting-condition
643 (append shared (list '(mode . "play")(cons 'method (cdr view)))))
645 (ctree-set-calist-with-default
646 'mime-acting-condition
648 (list '(mode . "print")(cons 'method (cdr view))))
651 (setq entries (cdr entries))
654 (ctree-set-calist-strictly
655 'mime-acting-condition
656 '((type . application)(subtype . octet-stream)
658 (method . mime-detect-content)
661 (ctree-set-calist-with-default
662 'mime-acting-condition
664 (method . mime-save-content)))
666 (ctree-set-calist-strictly
667 'mime-acting-condition
668 '((type . text)(subtype . x-rot13-47)(mode . "play")
669 (method . mime-view-caesar)
671 (ctree-set-calist-strictly
672 'mime-acting-condition
673 '((type . text)(subtype . x-rot13-47-48)(mode . "play")
674 (method . mime-view-caesar)
677 (ctree-set-calist-strictly
678 'mime-acting-condition
679 '((type . message)(subtype . rfc822)(mode . "play")
680 (method . mime-view-message/rfc822)
682 (ctree-set-calist-strictly
683 'mime-acting-condition
684 '((type . message)(subtype . partial)(mode . "play")
685 (method . mime-store-message/partial-piece)
688 (ctree-set-calist-strictly
689 'mime-acting-condition
690 '((type . message)(subtype . external-body)
691 ("access-type" . "anon-ftp")
692 (method . mime-view-message/external-ftp)
695 (ctree-set-calist-strictly
696 'mime-acting-condition
697 '((type . application)(subtype . octet-stream)
698 (method . mime-save-content)
702 ;;; @ quitting method
705 (defvar mime-preview-quitting-method-alist
706 '((mime-show-message-mode
707 . mime-preview-quitting-method-for-mime-show-message-mode))
708 "Alist of major-mode vs. quitting-method of mime-view.")
710 (defvar mime-preview-over-to-previous-method-alist nil
711 "Alist of major-mode vs. over-to-previous-method of mime-view.")
713 (defvar mime-preview-over-to-next-method-alist nil
714 "Alist of major-mode vs. over-to-next-method of mime-view.")
717 ;;; @ following method
720 (defvar mime-preview-following-method-alist nil
721 "Alist of major-mode vs. following-method of mime-view.")
723 (defvar mime-view-following-required-fields-list
730 ;; hack from Gnus 5.0.4.
732 (defvar mime-view-x-face-to-pbm-command
733 "{ echo '/* Width=48, Height=48 */'; uncompface; } | icontopbm")
735 (defvar mime-view-x-face-command
736 (concat mime-view-x-face-to-pbm-command
738 "String to be executed to display an X-Face field.
739 The command will be executed in a sub-shell asynchronously.
740 The compressed face will be piped to this command.")
742 (defun mime-view-x-face-function ()
743 "Function to display X-Face field. You can redefine to customize."
744 ;; 1995/10/12 (c.f. tm-eng:130)
745 ;; fixed by Eric Ding <ericding@San-Jose.ate.slb.com>
747 (narrow-to-region (point-min) (re-search-forward "^$" nil t))
749 (goto-char (point-min))
750 (if (re-search-forward "^X-Face:[ \t]*" nil t)
751 (let ((beg (match-end 0))
752 (end (std11-field-end))
754 (call-process-region beg end "sh" nil 0 nil
755 "-c" mime-view-x-face-command)
762 (defun mime-display-entity (entity &optional situation
763 default-situation preview-buffer)
765 (setq preview-buffer (current-buffer)))
766 (let* ((raw-buffer (mime-entity-buffer entity))
767 (start (mime-entity-point-min entity))
769 (set-buffer raw-buffer)
773 (or (ctree-match-calist mime-preview-condition
774 (append (mime-entity-situation entity)
777 (let ((button-is-invisible
778 (eq (cdr (assq 'entity-button situation)) 'invisible))
780 (eq (cdr (assq 'header situation)) 'visible))
781 (header-presentation-method
782 (or (cdr (assq 'header-presentation-method situation))
783 (cdr (assq major-mode mime-header-presentation-method-alist))))
784 (body-presentation-method
785 (cdr (assq 'body-presentation-method situation)))
786 (children (mime-entity-children entity)))
787 (set-buffer preview-buffer)
789 (narrow-to-region nb nb)
790 (or button-is-invisible
791 (if (mime-view-entity-button-visible-p entity)
792 (mime-view-insert-entity-button entity)
794 (when header-is-visible
795 (if header-presentation-method
796 (funcall header-presentation-method entity situation)
797 (mime-insert-decoded-header entity
798 mime-view-ignored-field-list
799 mime-view-visible-field-list
800 (if (mime-entity-cooked-p entity)
802 default-mime-charset))
804 (goto-char (point-max))
806 (run-hooks 'mime-display-header-hook)
809 ((functionp body-presentation-method)
810 (funcall body-presentation-method entity situation)
813 (when button-is-invisible
814 (goto-char (point-max))
815 (mime-view-insert-entity-button entity)
817 (or header-is-visible
819 (goto-char (point-max))
823 (setq ne (point-max))
825 (put-text-property nb ne 'mime-view-entity entity)
828 (if (functionp body-presentation-method)
829 (funcall body-presentation-method entity situation)
830 (mime-display-multipart/mixed entity situation)
835 ;;; @ MIME viewer mode
838 (defconst mime-view-menu-title "MIME-View")
839 (defconst mime-view-menu-list
840 '((up "Move to upper entity" mime-preview-move-to-upper)
841 (previous "Move to previous entity" mime-preview-move-to-previous)
842 (next "Move to next entity" mime-preview-move-to-next)
843 (scroll-down "Scroll-down" mime-preview-scroll-down-entity)
844 (scroll-up "Scroll-up" mime-preview-scroll-up-entity)
845 (play "Play current entity" mime-preview-play-current-entity)
846 (extract "Extract current entity" mime-preview-extract-current-entity)
847 (print "Print current entity" mime-preview-print-current-entity)
848 (x-face "Show X Face" mime-preview-display-x-face)
850 "Menu for MIME Viewer")
852 (cond (running-xemacs
853 (defvar mime-view-xemacs-popup-menu
854 (cons mime-view-menu-title
857 (vector (nth 1 item)(nth 2 item) t)
859 mime-view-menu-list)))
860 (defun mime-view-xemacs-popup-menu (event)
861 "Popup the menu in the MIME Viewer buffer"
863 (select-window (event-window event))
864 (set-buffer (event-buffer event))
865 (popup-menu 'mime-view-xemacs-popup-menu))
866 (defvar mouse-button-2 'button2)
869 (defvar mouse-button-2 [mouse-2])
872 (defun mime-view-define-keymap (&optional default)
873 (let ((mime-view-mode-map (if (keymapp default)
874 (copy-keymap default)
877 (define-key mime-view-mode-map
878 "u" (function mime-preview-move-to-upper))
879 (define-key mime-view-mode-map
880 "p" (function mime-preview-move-to-previous))
881 (define-key mime-view-mode-map
882 "n" (function mime-preview-move-to-next))
883 (define-key mime-view-mode-map
884 "\e\t" (function mime-preview-move-to-previous))
885 (define-key mime-view-mode-map
886 "\t" (function mime-preview-move-to-next))
887 (define-key mime-view-mode-map
888 " " (function mime-preview-scroll-up-entity))
889 (define-key mime-view-mode-map
890 "\M- " (function mime-preview-scroll-down-entity))
891 (define-key mime-view-mode-map
892 "\177" (function mime-preview-scroll-down-entity))
893 (define-key mime-view-mode-map
894 "\C-m" (function mime-preview-next-line-entity))
895 (define-key mime-view-mode-map
896 "\C-\M-m" (function mime-preview-previous-line-entity))
897 (define-key mime-view-mode-map
898 "v" (function mime-preview-play-current-entity))
899 (define-key mime-view-mode-map
900 "e" (function mime-preview-extract-current-entity))
901 (define-key mime-view-mode-map
902 "\C-c\C-p" (function mime-preview-print-current-entity))
903 (define-key mime-view-mode-map
904 "a" (function mime-preview-follow-current-entity))
905 (define-key mime-view-mode-map
906 "q" (function mime-preview-quit))
907 (define-key mime-view-mode-map
908 "\C-c\C-x" (function mime-preview-kill-buffer))
909 ;; (define-key mime-view-mode-map
910 ;; "<" (function beginning-of-buffer))
911 ;; (define-key mime-view-mode-map
912 ;; ">" (function end-of-buffer))
913 (define-key mime-view-mode-map
914 "?" (function describe-mode))
915 (define-key mime-view-mode-map
916 [tab] (function mime-preview-move-to-next))
917 (define-key mime-view-mode-map
918 [delete] (function mime-preview-scroll-down-entity))
919 (define-key mime-view-mode-map
920 [backspace] (function mime-preview-scroll-down-entity))
921 (if (functionp default)
922 (cond (running-xemacs
923 (set-keymap-default-binding mime-view-mode-map default)
926 (setq mime-view-mode-map
927 (append mime-view-mode-map (list (cons t default))))
930 (define-key mime-view-mode-map
931 mouse-button-2 (function mime-button-dispatcher))
933 (cond (running-xemacs
934 (define-key mime-view-mode-map
935 mouse-button-3 (function mime-view-xemacs-popup-menu))
937 ((>= emacs-major-version 19)
938 (define-key mime-view-mode-map [menu-bar mime-view]
939 (cons mime-view-menu-title
940 (make-sparse-keymap mime-view-menu-title)))
943 (define-key mime-view-mode-map
944 (vector 'menu-bar 'mime-view (car item))
945 (cons (nth 1 item)(nth 2 item))
948 (reverse mime-view-menu-list)
951 (use-local-map mime-view-mode-map)
952 (run-hooks 'mime-view-define-keymap-hook)
955 (defsubst mime-maybe-hide-echo-buffer ()
956 "Clear mime-echo buffer and delete window for it."
957 (let ((buf (get-buffer mime-echo-buffer-name)))
962 (let ((win (get-buffer-window buf)))
969 (defvar mime-view-redisplay nil)
971 (defun mime-display-message (message &optional preview-buffer
972 mother default-keymap-or-function)
973 (mime-maybe-hide-echo-buffer)
974 (let ((win-conf (current-window-configuration))
975 (raw-buffer (mime-entity-buffer message)))
978 (concat "*Preview-" (buffer-name raw-buffer) "*")))
979 (set-buffer raw-buffer)
981 (setq mime-preview-buffer preview-buffer)
982 (let ((inhibit-read-only t))
983 (switch-to-buffer preview-buffer)
986 (setq mime-raw-buffer raw-buffer)
988 (setq mime-mother-buffer mother)
990 (setq mime-preview-original-window-configuration win-conf)
991 (setq major-mode 'mime-view-mode)
992 (setq mode-name "MIME-View")
993 (mime-display-entity message nil
994 '((entity-button . invisible)
997 (mime-view-define-keymap default-keymap-or-function)
999 (next-single-property-change (point-min) 'mime-view-entity)))
1002 (goto-char (point-min))
1003 (search-forward "\n\n" nil t)
1005 (run-hooks 'mime-view-mode-hook)
1007 (set-buffer-modified-p nil)
1008 (setq buffer-read-only t)
1011 (defun mime-view-buffer (&optional raw-buffer preview-buffer mother
1012 default-keymap-or-function)
1014 (mime-display-message
1016 (if raw-buffer (set-buffer raw-buffer))
1017 (mime-parse-message)
1019 preview-buffer mother default-keymap-or-function))
1021 (defun mime-view-mode (&optional mother ctl encoding
1022 raw-buffer preview-buffer
1023 default-keymap-or-function)
1024 "Major mode for viewing MIME message.
1026 Here is a list of the standard keys for mime-view-mode.
1031 u Move to upper content
1032 p or M-TAB Move to previous content
1033 n or TAB Move to next content
1034 SPC Scroll up or move to next content
1035 M-SPC or DEL Scroll down or move to previous content
1036 RET Move to next line
1037 M-RET Move to previous line
1038 v Decode current content as `play mode'
1039 e Decode current content as `extract mode'
1040 C-c C-p Decode current content as `print mode'
1041 a Followup to current content.
1043 button-2 Move to point under the mouse cursor
1044 and decode current content as `play mode'
1047 (mime-display-message
1049 (if raw-buffer (set-buffer raw-buffer))
1050 (or mime-view-redisplay
1051 (mime-parse-message ctl encoding))
1053 preview-buffer mother default-keymap-or-function))
1059 (autoload 'mime-preview-play-current-entity "mime-play"
1060 "Play current entity." t)
1062 (defun mime-preview-extract-current-entity ()
1063 "Extract current entity into file (maybe).
1064 It decodes current entity to call internal or external method as
1065 \"extract\" mode. The method is selected from variable
1066 `mime-acting-condition'."
1068 (mime-preview-play-current-entity "extract")
1071 (defun mime-preview-print-current-entity ()
1072 "Print current entity (maybe).
1073 It decodes current entity to call internal or external method as
1074 \"print\" mode. The method is selected from variable
1075 `mime-acting-condition'."
1077 (mime-preview-play-current-entity "print")
1084 (defun mime-preview-follow-current-entity ()
1085 "Write follow message to current entity.
1086 It calls following-method selected from variable
1087 `mime-preview-following-method-alist'."
1090 (while (null (setq entity
1091 (get-text-property (point) 'mime-view-entity)))
1095 (previous-single-property-change (point) 'mime-view-entity))
1097 (entity-node-id (mime-entity-node-id entity))
1098 (len (length entity-node-id))
1102 (if (eq (next-single-property-change (point-min)
1108 ((eq (next-single-property-change p-beg 'mime-view-entity)
1110 (setq p-beg (point))
1112 (setq p-end (next-single-property-change p-beg 'mime-view-entity))
1114 (setq p-end (point-max))
1116 ((null entity-node-id)
1117 (setq p-end (point-max))
1125 (next-single-property-change
1126 (point) 'mime-view-entity))
1128 (let ((rc (mime-entity-node-id
1129 (get-text-property (point)
1130 'mime-view-entity))))
1131 (or (equal entity-node-id
1132 (nthcdr (- (length rc) len) rc))
1137 (setq p-end (point-max))
1140 (let* ((mode (mime-preview-original-major-mode 'recursive))
1142 (format "%s-%s" (buffer-name) (reverse entity-node-id)))
1144 (the-buf (current-buffer))
1145 (a-buf mime-raw-buffer)
1148 (set-buffer (setq new-buf (get-buffer-create new-name)))
1150 (insert-buffer-substring the-buf p-beg p-end)
1151 (goto-char (point-min))
1152 (let ((entity-node-id (mime-entity-node-id entity)) ci str)
1160 (mime-raw-find-entity-from-node-id entity-node-id))
1163 (mime-entity-point-min ci)
1164 (mime-entity-point-max ci)
1166 (std11-header-string-except
1168 (apply (function regexp-or) fields)
1171 (eq (mime-entity-media-type ci) 'message)
1172 (eq (mime-entity-media-subtype ci) 'rfc822))
1178 (setq fields (std11-collect-field-names)
1179 entity-node-id (cdr entity-node-id))
1182 (let ((rest mime-view-following-required-fields-list))
1184 (let ((field-name (car rest)))
1185 (or (std11-field-body field-name)
1191 (set-buffer the-buf)
1192 (set-buffer mime-mother-buffer)
1193 (set-buffer mime-raw-buffer)
1194 (std11-field-body field-name)
1198 (setq rest (cdr rest))
1200 (eword-decode-header)
1202 (let ((f (cdr (assq mode mime-preview-following-method-alist))))
1207 "Sorry, following method for %s is not implemented yet."
1216 (defun mime-preview-display-x-face ()
1218 (save-window-excursion
1219 (set-buffer mime-raw-buffer)
1220 (mime-view-x-face-function)
1227 (defun mime-preview-move-to-upper ()
1228 "Move to upper entity.
1229 If there is no upper entity, call function `mime-preview-quit'."
1232 (while (null (setq cinfo
1233 (get-text-property (point) 'mime-view-entity)))
1236 (let ((r (mime-raw-find-entity-from-node-id
1237 (cdr (mime-entity-node-id cinfo))
1238 (get-text-property 1 'mime-view-entity)))
1241 (while (setq point (previous-single-property-change
1242 (point) 'mime-view-entity))
1244 (if (eq r (get-text-property (point) 'mime-view-entity))
1251 (defun mime-preview-move-to-previous ()
1252 "Move to previous entity.
1253 If there is no previous entity, it calls function registered in
1254 variable `mime-preview-over-to-previous-method-alist'."
1256 (while (null (get-text-property (point) 'mime-view-entity))
1259 (let ((point (previous-single-property-change (point) 'mime-view-entity)))
1261 (if (get-text-property (1- point) 'mime-view-entity)
1263 (goto-char (1- point))
1264 (mime-preview-move-to-previous)
1266 (let ((f (assq (mime-preview-original-major-mode)
1267 mime-preview-over-to-previous-method-alist)))
1273 (defun mime-preview-move-to-next ()
1274 "Move to next entity.
1275 If there is no previous entity, it calls function registered in
1276 variable `mime-preview-over-to-next-method-alist'."
1278 (while (null (get-text-property (point) 'mime-view-entity))
1281 (let ((point (next-single-property-change (point) 'mime-view-entity)))
1285 (if (null (get-text-property point 'mime-view-entity))
1286 (mime-preview-move-to-next)
1288 (let ((f (assq (mime-preview-original-major-mode)
1289 mime-preview-over-to-next-method-alist)))
1295 (defun mime-preview-scroll-up-entity (&optional h)
1296 "Scroll up current entity.
1297 If reached to (point-max), it calls function registered in variable
1298 `mime-preview-over-to-next-method-alist'."
1301 (setq h (1- (window-height)))
1303 (if (= (point) (point-max))
1304 (let ((f (assq (mime-preview-original-major-mode)
1305 mime-preview-over-to-next-method-alist)))
1310 (or (next-single-property-change (point) 'mime-view-entity)
1313 (if (> (point) point)
1318 (defun mime-preview-scroll-down-entity (&optional h)
1319 "Scroll down current entity.
1320 If reached to (point-min), it calls function registered in variable
1321 `mime-preview-over-to-previous-method-alist'."
1324 (setq h (1- (window-height)))
1326 (if (= (point) (point-min))
1327 (let ((f (assq (mime-preview-original-major-mode)
1328 mime-preview-over-to-previous-method-alist)))
1333 (or (previous-single-property-change (point) 'mime-view-entity)
1335 (forward-line (- h))
1336 (if (< (point) point)
1340 (defun mime-preview-next-line-entity ()
1342 (mime-preview-scroll-up-entity 1)
1345 (defun mime-preview-previous-line-entity ()
1347 (mime-preview-scroll-down-entity 1)
1354 (defun mime-preview-quit ()
1355 "Quit from MIME-preview buffer.
1356 It calls function registered in variable
1357 `mime-preview-quitting-method-alist'."
1359 (let ((r (assq (mime-preview-original-major-mode)
1360 mime-preview-quitting-method-alist)))
1365 (defun mime-preview-kill-buffer ()
1367 (kill-buffer (current-buffer))
1374 (provide 'mime-view)
1376 (run-hooks 'mime-view-load-hook)
1378 ;;; mime-view.el ends here