[O] [PATCH] ox-latex: provide width and height options for images

[Aaron Ecay]

These are implemented with \resizebox, and thus are uniform across
different types of image inclusion (\includegraphics, \input of tikz
images).  This differs from the older way of using width and height
optional args to \includegraphics.

Thus, the default value for org-latex-image-default-options is left
untouched, to avoid breaking compatibility with older code.  After a
transition period, the 0.9\linewidth value should be moved into
org-latex-image-default-width, and the -options variable set to the
empty string.

Also introduce a convenience function to org-macs.el.
---
 lisp/org-macs.el |  7 +++++++
 lisp/ox-latex.el | 29 ++++++++++++++++++++++++++---
 2 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/lisp/org-macs.el b/lisp/org-macs.el
index 172d5d1..3fe62cd 100644
--- a/lisp/org-macs.el
+++ b/lisp/org-macs.el
@@ -87,6 +87,13 @@
 Otherwise return nil."
   (and v (not (equal v "nil")) v))
 
+(defun org-not-nil-or-empty (v)
+  "Return V if V is not nil, the string \"nil\", or a string
+consisting of solely whitespace.  Otherwise return nil."
+  (and (org-not-nil v)
+       (org-string-nw-p v)
+       v))
+
 (defun org-substitute-posix-classes (re)
   "Substitute posix classes in regular expression RE."
   (let ((ss re))
diff --git a/lisp/ox-latex.el b/lisp/ox-latex.el
index 13da3f0..d1f47b8 100644
--- a/lisp/ox-latex.el
+++ b/lisp/ox-latex.el
@@ -471,11 +471,24 @@ which format headlines like for Org version prior to 8.0."
 
 ;;;; Links
 
+;;; NOTE: this variable is for backwards compatibility; eventually the
+;;; width setting should be moved to the default-width variable, and
+;;; this set to the empty string.
 (defcustom org-latex-image-default-option "width=.9\\linewidth"
   "Default option for images."
   :group 'org-export-latex
   :type 'string)
 
+(defcustom org-latex-image-default-width ""
+  "Default option for images."
+  :group 'org-export-latex
+  :type 'string)
+
+(defcustom org-latex-image-default-height ""
+  "Default option for images."
+  :group 'org-export-latex
+  :type 'string)
+
 (defcustom org-latex-default-figure-position "htb"
   "Default position for latex figures."
   :group 'org-export-latex
@@ -1755,6 +1768,15 @@ used as a communication channel."
                   (format "[%s]" org-latex-default-figure-position))
                  (t ""))))
         (comment-include (if (plist-get attr :comment-include) "%" ""))
+        ;; It is possible to specify width and height in the
+        ;; ATTR_LATEX line, and also via default variables.
+        (width (format "%s" (or (plist-get attr :width)
+                                org-latex-image-default-width)))
+        (height (format "%s" (or (plist-get attr :height)
+                                 org-latex-image-default-height)))
+        (resize (format "\\resizebox{%s}{%s}{%%s}"
+                        (if (org-not-nil-or-empty width) width "!")
+                        (if (org-not-nil-or-empty height) height "!")))
         ;; Options for "includegraphics" macro. Make sure it is
         ;; a string with square brackets when non empty.  Default to
         ;; `org-latex-image-default-option' when possible.
@@ -1766,9 +1788,10 @@ used as a communication channel."
                          ((eq float 'float) "[width=0.7\\textwidth]")
                          ((eq float 'wrap) "[width=0.48\\textwidth]")
                          (t ""))))
-        (image-code (if (equal filetype "tikz")
-                        (format "\\input{%s}" path)
-                      (format "\\includegraphics%s{%s}" options path))))
+        (image-code (format resize
+                            (if (equal filetype "tikz")
+                                (format "\\input{%s}" path)
+                              (format "\\includegraphics%s{%s}" options 
path)))))
     ;; Return proper string, depending on FLOAT.
     (case float
       (wrap (format "\\begin{wrapfigure}%s
-- 
1.8.1.4