Shadows and glows
The IDML drop shadow, inner shadow, outer and inner glow, bevel and emboss and satin settings, and how InDesign reads Size, Spread, Choke and Angle.
Six effects darken or lighten an object's edges. Their numbers are InDesign's: Size is the width of the soft band, Spread and Choke are percentages of it, and Angle says where the light comes from.
In short A drop shadow is offset by XOffset and YOffset; an inner shadow, a satin
and a bevel by an Angle and a Distance, where the angle names the direction of the light,
so the shadow falls the opposite way. Size is how wide the soft edge is, not a blur radius:
an outer shadow or glow has faded to about a sixth of its strength Size / 2 beyond the
object's edge and is nearly gone at Size. Spread (outer effects) and ChokeAmount
(inner effects) are percentages of Size that harden the edge. The drop shadow is on with
Mode="Drop", the others with Applied="true".
How InDesign reads the numbers
These rules were measured by having InDesign draw each effect and comparing its output with the values in its own IDML.
Sizeis the width of the band. For effects that spill outside the object (drop shadow, outer glow) the edge is a Gaussian falloff with a standard deviation ofSize / 2: atSize / 2outside the outline about 16 % of the strength is left, atSizeabout 2 %. Effects that stay inside the object (inner shadow, inner glow) fall off with a standard deviation of about0.4 × Size. ReadingSizeas the blur radius doubles the softness.SpreadandChokeAmountare percentages ofSize. Spread grows the shape outward before the falloff; choke moves the edge inward. Neither is a distance in points.Anglenames the light. It is measured in degrees counter-clockwise from the right, and the shadow falls away from the light: with y pointing down the page, the offset isx = −Distance × cos(Angle)andy = +Distance × sin(Angle). InDesign's default, 120°, puts the light at the upper left and the shadow down and to the right.- A drop shadow's offset is written as
XOffsetandYOffset. Positive is right and down. Inner shadows and satins are written withAngleandDistance. UseGlobalLight="true"takes the angle from the document's light,GlobalLightAngle(and for a bevelGlobalLightAltitude) on<TransparencyPreference>. It isfalsein every surveyed file.
Opacity is a percentage of the effect's strength, Noise a percentage of grain, and
EffectColor names a palette colour; n leaves the effect's default colour.
Drop shadow
| Attribute · DropShadowSetting | Values | Paged | paged.set |
|---|---|---|---|
| EffectColor | Color reference | read · written | frameDropShadowColor |
| Mode | None | Drop | read · written | frameDropShadowMode |
| Opacity | number (percent) | read · written | frameDropShadowOpacity |
| Size | length (pt) | read · written | frameDropShadowSize |
| XOffset | length (pt) | read · written | frameDropShadowXOffset |
| YOffset | length (pt) | read · written | frameDropShadowYOffset |
| BlendMode | Multiply | not read | |
| HonorOtherEffects | false | not read | |
| KnockedOut | true | written | |
| Noise | integer | not read |
On with Mode="Drop", off with Mode="None". InDesign's default is a black, 75 %-opaque
Multiply shadow, 7 pt right and 7 pt down, Size 5. KnockedOut="true" hides the shadow
behind a semi-transparent object; HonorOtherEffects lets other effects shape the shadow. In
the surveyed documents, drop shadows are switched on in 10.
Mode="Drop", XOffset and YOffset 12 pt, Size 10, Opacity 75, black, Multiply.
What casts the shadow
A drop shadow is cast by what the object paints. InDesign follows these rules for every kind of shape:
- A filled shape casts the shadow of its outline, grown by the part of a visible stroke that lies outside the outline. A rounded rectangle casts a rounded shadow, an ellipse an elliptical one.
- A shape with no fill and a visible stroke casts the shadow of its stroke band only.
- A line casts the shadow of its stroke, at the stroke's width, with its caps.
- A text frame with no fill casts the shadow of its text, glyph by glyph.
A shadow inside StrokeTransparencySetting is cast by the stroke alone; one inside
ContentTransparencySetting by the content alone.
In Paged: drop shadows are drawn for rectangles, ovals, polygons, lines and text frames by these rules, matched to InDesign on test pages for lines, ovals, polygons and rectangles. A group's shadow is drawn for the group as a whole. A shadow at the stroke level is kept as the stroke's shadow; one at the content level is not drawn.
Supported · verified
Inner shadow
| Attribute · InnerShadowSetting | Values | Paged | paged.set |
|---|---|---|---|
| Applied | bool | read · written | frameInnerShadow |
| EffectColor | color | read · written | frameInnerShadowColor |
| Opacity | number (percent) | read · written | frameInnerShadowOpacity |
| Size | length (pt) | read · written | frameInnerShadowSize |
| Angle | number (degrees) | read · written | frameInnerShadowAngle |
| BlendMode | Normal | Multiply | Screen | Overlay | SoftLight | HardLight | ColorDodge | ColorBurn | Darken | Lighten | Difference | Exclusion | Hue | Saturation | Color | Luminosity | read · written | frameInnerShadowBlendMode |
| ChokeAmount | number (percent) | read · written | frameInnerShadowChoke |
| Distance | length (pt) | read · written | frameInnerShadowDistance |
| Noise | number (percent) | read · written | frameInnerShadowNoise |
| UseGlobalLight | false | not read |
A shadow inside the object's edge, as if the object were cut out of the page. Positioned by
Angle and Distance (default 120° and 7 pt), softened by Size, hardened by
ChokeAmount. Default Multiply, 75 %.
In Paged: inner shadows are drawn by the rules above, the light angle included.
Supported · verified
Outer glow and inner glow
| Attribute · OuterGlowSetting | Values | Paged | paged.set |
|---|---|---|---|
| Applied | bool | read · written | frameOuterGlow |
| Opacity | number (percent) | read · written | frameOuterGlowOpacity |
| Size | length (pt) | read · written | frameOuterGlowSize |
| Spread | number (percent) | read · written | frameOuterGlowSpread |
| BlendMode | Normal | Multiply | Screen | Overlay | SoftLight | HardLight | ColorDodge | ColorBurn | Darken | Lighten | Difference | Exclusion | Hue | Saturation | Color | Luminosity | read · written | frameOuterGlowBlendMode |
| EffectColor | color | read · written | frameOuterGlowColor |
| Noise | number (percent) | read · written | frameOuterGlowNoise |
| Technique | Softer | not read |
| Attribute · InnerGlowSetting | Values | Paged | paged.set |
|---|---|---|---|
| Applied | bool | read · written | frameInnerGlow |
| Opacity | number (percent) | read · written | frameInnerGlowOpacity |
| Size | length (pt) | read · written | frameInnerGlowSize |
| BlendMode | Normal | Multiply | Screen | Overlay | SoftLight | HardLight | ColorDodge | ColorBurn | Darken | Lighten | Difference | Exclusion | Hue | Saturation | Color | Luminosity | read · written | frameInnerGlowBlendMode |
| EffectColor | color | read · written | frameInnerGlowColor |
| Noise | number (percent) | read · written | frameInnerGlowNoise |
| Source | EdgeSourced | CenterSourced | read · written | frameInnerGlowSource |
| Spread | number (percent) | read · written | frameInnerGlowChoke |
| Technique | Softer | not read |
A glow is an unoffset band of colour around the outside of the edge (outer) or inside it
(inner). Size sets its width, Spread hardens it. Inner glows spell their choke Spread
too. Source on an inner glow is EdgeSourced (from the edge inward) or CenterSourced
(from the centre outward). Technique is Softer in every surveyed file. The default blend
mode is Screen, which lightens; a black glow under Screen draws nothing.
In Paged: both glows are drawn; a glow whose
EffectColordoes not resolve is drawn white, a shadow black. Supported · verified
Bevel and emboss
| Attribute · BevelAndEmbossSetting | Values | Paged | paged.set |
|---|---|---|---|
| Altitude | number (degrees) | read · written | frameBevelAltitude |
| Angle | number (degrees) | read · written | frameBevelAngle |
| Applied | bool | read · written | frameBevel |
| Depth | number (percent) | read · written | frameBevelDepth |
| Direction | Up | Down | read · written | frameBevelDirection |
| Size | length (pt) | read · written | frameBevelSize |
| Soften | length (pt) | read · written | frameBevelSoften |
| Style | OuterBevel | InnerBevel | Emboss | PillowEmboss | read · written | frameBevelStyle |
| Technique | SmoothContour | ChiselHard | ChiselSoft | read · written | frameBevelTechnique |
| HighlightBlendMode | Screen | not read |
Shading that makes the object look raised or sunk. Style chooses the kind (InnerBevel by
default), Technique the profile (SmoothContour, ChiselHard, ChiselSoft), and Direction
(Up by default) whether it is raised or sunk. The light comes from Angle at the height Altitude. The facet is Size
wide; Depth, a percentage that can go far above 100, makes it steeper rather than scaling the
result; Soften blurs it. The highlight and shadow each have a colour, an opacity and a blend
mode (Screen and Multiply by default).
In Paged: bevels are drawn with a facet
Supported · verifiedSizewide, shaded against the light. Where the facet is wider than half the object, InDesign fades it and Paged does not yet.
Satin
| Attribute · SatinSetting | Values | Paged | paged.set |
|---|---|---|---|
| Angle | number (degrees) | read · written | frameSatinAngle |
| Applied | bool | read · written | frameSatin |
| Distance | length (pt) | read · written | frameSatinDistance |
| EffectColor | color | read · written | frameSatinColor |
| Opacity | number (percent) | read · written | frameSatinOpacity |
| Size | length (pt) | read · written | frameSatinSize |
| BlendMode | Normal | Multiply | Screen | Overlay | SoftLight | HardLight | ColorDodge | ColorBurn | Darken | Lighten | Difference | Exclusion | Hue | Saturation | Color | Luminosity | read · written | frameSatinBlendMode |
| InvertEffect | false | read · written | frameSatinInvert |
| Invert | boolean | read |
A soft, inner shading made of two offset copies of the shape: Angle and Distance set the
offset, Size the softness, InvertEffect swaps the light and dark areas. Default
Multiply, 50 %.
In Paged: satin is drawn from two offset, softened copies of the shape; it is not yet matched to InDesign as closely as the other effects. Parsed, partly rendered
Stacking
An outer glow and a drop shadow are drawn beneath the object; the inner effects (inner shadow, inner glow, bevel, satin) are drawn on top of its fill.
Frequently asked questions
Is Size a blur radius?
No. It is the width of the soft band. Outer effects fall off with a standard deviation of
Size / 2, inner effects about 0.4 × Size.
Which way does a shadow fall for Angle="120"?
Down and to the right. The angle names where the light is, counter-clockwise from the right, and
the shadow falls the opposite way.
Are Spread and ChokeAmount in points?
No. They are percentages of Size.
How is a drop shadow's offset written?
As XOffset and YOffset in points, positive right and down.
Does a frame with no fill cast a shadow? Yes, from what it does paint: its stroke band, or, for a text frame, its text.
How do I tell whether an effect is on?
A drop shadow is on with Mode="Drop"; the other effects here with Applied="true".
InDesign writes the settings even when the effect is off.
Transparency and blending
The IDML BlendingSetting (Opacity, BlendMode, KnockoutGroup, IsolateBlending) and the object, fill, stroke and content transparency levels it can sit in.
Feathering
The IDML FeatherSetting, DirectionalFeatherSetting and GradientFeatherSetting, which fade an object's own edges or fade it across a gradient of opacity.