From ee0d30fac48d1f3ee86a653fe537badde5e3174d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bj=C3=B6rn=20Bidar?= <bjorn.bidar@thaodan.de>
Date: Fri, 20 Dec 2024 01:00:46 +0200
Subject: [PATCH] org-link: Split link preview into two functions

* lisp/ol.el (org-link-preview-file,
org-link-preview-image-data): Split up the actual preview part into
a separate function.  The new preview function can be called by
:preview handler to display the raw image according to the correct
alignment and with for the link to be previewed. Passing the link can
be skipped if alignment and with are given.
---
 lisp/ol.el | 57 ++++++++++++++++++++++++++++++++++++------------------
 1 file changed, 38 insertions(+), 19 deletions(-)

diff --git a/lisp/ol.el b/lisp/ol.el
index 032610bad..ebfe926a1 100644
--- a/lisp/ol.el
+++ b/lisp/ol.el
@@ -2177,27 +2177,46 @@ (defun org-link-preview-file (ov path link)
                 ((string-match-p (image-file-name-regexp) file))
                 ((file-exists-p file)))
       (let* ((width (org-display-inline-image--width link))
-	     (align (org-image--align link))
-             (image (org--create-inline-image file width)))
-        (when image            ; Add image to overlay
-	  ;; See bug#59902.  We cannot rely
-          ;; on Emacs to update image if the file
-          ;; has changed.
-          (image-flush image)
-	  (overlay-put ov 'display image)
-	  (overlay-put ov 'face 'default)
-	  (overlay-put ov 'keymap image-map)
-          (when align
-            (overlay-put
-             ov 'before-string
-             (propertize
-              " " 'face 'default
-              'display
-              (pcase align
-                ("center" `(space :align-to (- center (0.5 . ,image))))
-                ("right"  `(space :align-to (- right ,image)))))))
+             (image-data (org--create-inline-image file width)))
+        (when image-data
+	  (org-link-preview-image-data ov image-data link)
           t)))))
 
+(defun org-link-preview-image-data (ov image-data &optional link align width)
+  "Display raw image data IMAGE-DATA in overlay OV for LINK.
+
+If not given ALIGN and WIDTH is derived from LINK.
+If LINK was not passed ALIGN and WIDTH have to be given.
+
+An image object is created from IMAGE-DATA to be displayed in overlay.
+
+This intended to be used by functions which provide the :preview link property
+of links such as in `org-link-preview-file'"
+  (if (or (and align width)
+          link)
+      (let* ((align (or align
+                        (org-image--align link)))
+             (width (or width
+                        (org-display-inline-image--width link)))
+             (image-object (org--create-inline-image image-data width)))
+        ;; See bug#59902.  We cannot rely
+        ;; on Emacs to update image if the file
+        ;; has changed.
+        (image-flush image-object)
+        (overlay-put ov 'display image-object)
+        (overlay-put ov 'face 'default)
+        (overlay-put ov 'keymap image-map)
+        (when align
+          (overlay-put
+           ov 'before-string
+           (propertize
+            " " 'face 'default
+            'display
+            (pcase align
+              ("center" `(space :align-to (- center (0.5 . ,image-data))))
+              ("right"  `(space :align-to (- right ,image-data))))))))
+    (error "Either align and width or link have to be passed")))
+
 ;;;; "help" link type
 (defun org-link--open-help (path _)
   "Open a \"help\" type link.
-- 
2.45.2