Skip to content
GitLab
Projects
Groups
Snippets
Help
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Open sidebar
emacs
emacs
Commits
2cd8656e
Commit
2cd8656e
authored
Mar 12, 2001
by
Richard M. Stallman
Browse files
Move :file, :data and :margin first in the table
of subproperties of `image' property.
parent
0e824f4f
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
25 additions
and
25 deletions
+25
-25
lispref/display.texi
lispref/display.texi
+25
-25
No files found.
lispref/display.texi
View file @
2cd8656e
...
...
@@ -2450,6 +2450,31 @@ XPM format.
types
:
@
table
@
code
@
item
:
file
@
var
{
file
}
The
@
code
{:
file
}
property
specifies
to
load
the
image
from
file
@
var
{
file
}.
If
@
var
{
file
}
is
not
an
absolute
file
name
,
it
is
expanded
in
@
code
{
data
-
directory
}.
@
item
:
data
@
var
{
data
}
The
@
code
{:
data
}
property
specifies
the
actual
contents
of
the
image
.
Each
image
must
use
either
@
code
{:
data
}
or
@
code
{:
file
},
but
not
both
.
For
most
image
types
,
the
value
of
the
@
code
{:
data
}
property
should
be
a
string
containing
the
image
data
;
we
recommend
using
a
unibyte
string
.
Before
using
@
code
{:
data
},
look
for
further
information
in
the
section
below
describing
the
specific
image
format
.
For
some
image
types
,
@
code
{:
data
}
may
not
be
supported
;
for
some
,
it
allows
other
data
types
;
for
some
,
@
code
{:
data
}
alone
is
not
enough
,
so
you
need
to
use
other
image
properties
along
with
@
code
{:
data
}.
@
item
:
margin
@
var
{
margin
}
The
@
code
{:
margin
}
property
specifies
how
many
pixels
to
add
as
an
extra
margin
around
the
image
.
The
value
,
@
var
{
margin
},
must
be
a
a
non
-
negative
number
,
or
a
pair
@
code
{(@
var
{
x
}
.
@
var
{
y
})}
of
such
numbers
.
If
it
is
a
pair
,
@
var
{
x
}
specifies
how
many
pixels
to
add
horizontally
,
and
@
var
{
y
}
specifies
how
many
pixels
to
add
vertically
.
If
@
code
{:
margin
}
is
not
specified
,
the
default
is
zero
.
@
item
:
ascent
@
var
{
ascent
}
The
@
code
{:
ascent
}
property
specifies
the
amount
of
the
image
's
height to use for its ascent---that is, the part above the baseline.
...
...
@@ -2466,14 +2491,6 @@ properties and overlays that apply to the image.
If
this
property
is
omitted
,
it
defaults
to
50.
@
item
:
margin
@
var
{
margin
}
The
@
code
{:
margin
}
property
specifies
how
many
pixels
to
add
as
an
extra
margin
around
the
image
.
The
value
,
@
var
{
margin
},
must
be
a
non
-
negative
number
,
or
a
pair
@
code
{(@
var
{
x
}
.
@
var
{
y
})}
of
such
numbers
.
If
it
is
a
pair
,
@
var
{
x
}
specifies
how
many
pixels
to
add
horizontally
,
and
@
var
{
y
}
specifies
how
many
pixels
to
add
vertically
.
If
@
code
{:
margin
}
is
not
specified
,
the
default
is
zero
.
@
item
:
relief
@
var
{
relief
}
The
@
code
{:
relief
}
property
,
if
non
-@
code
{
nil
},
adds
a
shadow
rectangle
around
the
image
.
The
value
,
@
var
{
relief
},
specifies
the
width
of
the
...
...
@@ -2572,23 +2589,6 @@ specifying the color to assume for the background of the image.
If @var{mask} is nil, remove a mask from the image, if it has one. Images
in some formats include a mask which can be removed by specifying
@code{:mask nil}.
@item :file @var{file}
The @code{:file} property specifies to load the image from file
@var{file}. If @var{file} is not an absolute file name, it is expanded
in @code{data-directory}.
@item :data @var{data}
The @code{:data} property specifies the actual contents of the image.
Each image must use either @code{:data} or @code{:file}, but not both.
For most image types, the value of the @code{:data} property should be a
string containing the image data; we recommend using a unibyte string.
Before using @code{:data}, look for further information in the section
below describing the specific image format. For some image types,
@code{:data} may not be supported; for some, it allows other data types;
for some, @code{:data} alone is not enough, so you need to use other
image properties along with @code{:data}.
@end table
@defun image-mask-p spec &optional frame
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment