| [ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
You can use an image descriptor by setting up the display property
yourself, but it is easier to use the functions in this section.
This function inserts image in the current buffer at point. The value
image should be an image descriptor; it could be a value returned by
create-image, or the value of a symbol defined with defimage.
The argument string specifies the text to put in the buffer to hold
the image. If it is omitted or nil, insert-image uses "
" by default.
The argument area specifies whether to put the image in a margin. If
it is left-margin, the image appears in the left margin;
right-margin specifies the right margin. If area is nil
or omitted, the image is displayed at point within the buffer's text.
The argument slice specifies a slice of the image to insert. If
slice is nil or omitted the whole image is inserted.
Otherwise, slice is a list (x y width
height) which specifies the x and y positions and
width and height of the image area to insert. Integer values
are in units of pixels. A floating point number in the range 0.0–1.0
stands for that fraction of the width or height of the entire image.
Internally, this function inserts string in the buffer, and gives it a
display property which specifies image. Voir la section The display Property.
This function inserts image in the current buffer at point, like
insert-image, but splits the image into rowsxcols equally
sized slices.
This function puts image image in front of pos in the current buffer. The argument pos should be an integer or a marker. It specifies the buffer position where the image should appear. The argument string specifies the text that should hold the image as an alternative to the default.
The argument image must be an image descriptor, perhaps returned by
create-image or stored by defimage.
The argument area specifies whether to put the image in a margin. If
it is left-margin, the image appears in the left margin;
right-margin specifies the right margin. If area is nil
or omitted, the image is displayed at point within the buffer's text.
Internally, this function creates an overlay, and gives it a
before-string property containing text that has a display
property whose value is the image. (Whew!)
This function removes images in buffer between positions start
and end. If buffer is omitted or nil, images are removed
from the current buffer.
This removes only images that were put into buffer the way
put-image does it, not images that were inserted with
insert-image or in other ways.
This function returns the size of an image as a pair (width
. height). spec is an image specification. pixels
non-nil means return sizes measured in pixels, otherwise return sizes
measured in canonical character units (fractions of the width/height of the
frame's default font). frame is the frame on which the image will be
displayed. frame null or omitted means use the selected frame
(voir la section Input Focus).
This variable is used to define the maximum size of image that Emacs will load. Emacs will refuse to load (and display) any image that is larger than this limit.
If the value is an integer, it directly specifies the maximum image height and width, measured in pixels. If it is a floating point number, it specifies the maximum image height and width as a ratio to the frame height and width. If the value is non-numeric, there is no explicit limit on the size of images.
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 max-image-size is subsequently changed (voir la section Image Cache).
| [ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Ce document a été généré par Eric Reinbold le 13 Octobre 2007 en utilisant texi2html 1.78.