changeset 66197:53c764d16ccf

* display.texi (Showing Images): Document max-image-size.
author Chong Yidong <cyd@stupidchicken.com>
date Wed, 19 Oct 2005 03:55:44 +0000
parents 2e59eea25fcf
children 34cdb895f63b
files lispref/ChangeLog lispref/display.texi
diffstat 2 files changed, 19 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/ChangeLog	Wed Oct 19 03:55:20 2005 +0000
+++ b/lispref/ChangeLog	Wed Oct 19 03:55:44 2005 +0000
@@ -1,3 +1,7 @@
+2005-10-18  Chong Yidong  <cyd@stupidchicken.com>
+
+	* display.texi (Showing Images): Document max-image-size.
+
 2005-10-17  Richard M. Stallman  <rms@gnu.org>
 
 	* commands.texi (Quitting): Minor clarification.
--- a/lispref/display.texi	Wed Oct 19 03:55:20 2005 +0000
+++ b/lispref/display.texi	Wed Oct 19 03:55:44 2005 +0000
@@ -4058,6 +4058,21 @@
 Focus}).
 @end defun
 
+@defvar max-image-size
+@tindex max-image-size
+This variable is used to define the maximum size of image that Emacs
+will load.  If its value is a floating point number, that number is
+multiplied by the width and height of the selected frame, in pixels,
+to give the maximum image width and height.  Emacs will refuse to load
+and display any image that is larger than this.
+
+The purpose of this variable is to prevent unreasonably large images
+from accidentally being loaded into Emacs.  It only takes effect the
+first time an image is loaded.  Once an image is placed in the image
+cache, it can always be displayed, even if the value of
+@var{max-image-size} is subsequently changed (@pxref{Image Cache}).
+@end defvar
+
 @node Image Cache
 @subsection Image Cache