Mathematica 9 is now available
THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.
Wolfram Mathematica Documentation Center
DOCUMENTATION CENTER SEARCH
New to Mathematica? Find your learning path »
Mathematica > Visualization and Graphics > Data Visualization > Annotating & Combining Graphics > Combining Graphics > Inset >
Mathematica > Visualization and Graphics > Function Visualization > Annotating & Combining Graphics > Combining Graphics > Inset >
Mathematica > Visualization and Graphics > Data Visualization > Function Visualization > Annotating & Combining Graphics > Combining Graphics > Inset >
BUILT-IN MATHEMATICA SYMBOLTutorials »|See Also »|More About »

Inset

Inset[obj]
represents an object obj inset in a graphic.
Inset
specifies that the inset should be placed at position pos in the graphic.
Inset
aligns the inset so that position opos in the object lies at position pos in the enclosing graphic.
Inset
specifies the size of the inset in the coordinate system of the enclosing graphic.
Inset
specifies that the axes of the inset should be oriented in directions dirs.
MORE INFORMATION
  • In interactive manipulation, Inset is by default selected as a single unit. A double-click is required to select individual elements inside.
  • The object obj can be a graphic, cell expression, string, or any other expression.
  • Positions can be specified by:
{x,y}ordinary coordinates in a plot
Scaled[{x,y},...]scaled coordinates from 0 to 1
ImageScaled[{x,y},...]scaled coordinates from 0 to 1 across a whole image
Offset[{dx,dy},...]absolute offset in printer's points
Center, etc.{Center, Center}, etc.
  • Axis corresponds to the position of the axis in a plot or the center line in typeset text.
  • Center corresponds to a position centered with respect to the whole image.
  • The default for opos is the setting for the AlignmentPoint option of obj, or by default, the center of the bounding box for obj.
  • If size is Automatic, the inset is given at its natural size:
graphicdetermined by ImageSize setting
typeset expressionabsolute size without wrapping
  • A size of {w, Automatic} specifies that a typeset expression should be wrapped at width w.
  • If size is given as , then any object obj whose aspect ratio is not fixed will be horizontally or vertically stretched so as to fit exactly in a w×h rectangle.
  • If obj is an object with fixed aspect ratio, then blank space will be left equally on both sides if there is a direction where the object would have to be stretched in order to fit exactly.
  • The setting for the option Background specifies the background to be used for the whole region of the inset.
  • By default, the inset is arranged so that its and directions are oriented with the and directions of the enclosing graphic.
  • Inset can be used to specify different orientations.
  • Possible choices for dirs are:
Automaticdefault orientation
{xx,xy} direction along
{Automatic,{yx,yy}} direction along
{{xx,xy},{yx,yy}} and directions along and
Nonenever reorient the contents of the Inset
  • Specifying only the or only the direction in general leads to a rigid rotation of the inset.
  • Specifying both the and directions in general leads to a rotation and shear, in which the original inset rectangle becomes a parallelogram defined by the vector directions given.
  • Only the directions of the vectors and are significant; the scale of the inset is determined by .
  • With dirs specified as None, the direction of obj is always maintained as horizontal.
  • With dirs specified as {Automatic, None}, the direction is maintained as vertical.
  • The following options can be given for Inset:
AlignmentLefthow to align the contents of the inset
BackgroundNonethe background to use for the whole region of the inset
BaseStyle"Inset"the base style to use for the inset
ContentSelectableAutomaticwhether to allow contents to be selected
FormatTypeAutomaticformat type for text
  • Background->Automatic uses whatever background has been specified for the whole graphic containing the inset.
EXAMPLESCLOSE ALL
Basic Examples   (3)
Inset a plot into a disk:
Inset an expression in a graphic:
Inset 3D graphics above a 2D plot:
Inset a plot into a disk:
In[1]:=
Click for copyable input
Out[1]=
 
Inset an expression in a graphic:
In[1]:=
Click for copyable input
Out[1]=
 
Inset 3D graphics above a 2D plot:
In[1]:=
Click for copyable input
Out[1]=
Scope   (17)
By default, Center is used for the position:
Automatic is equivalent to Center:
Specify ordinary coordinates in a graphic:
Use Scaled coordinates:
ImageScaled specifies coordinates in a whole image including padding:
Use Offset coordinates:
Symbolic positions can be specified:
By default, Center is used for the alignment position:
Automatic is equivalent to Center:
Specify an alignment position within the inset, using symbolic positions:
Specify an alignment position using the inset graphics coordinates:
Set the axis as an alignment position:
If the size is not given, or is Automatic, the image size of the inset graphic is used:
For typeset expressions, absolute font size is used:
Specify the width of the inset by the units of the enclosing graphic:
Given both width and height sizes, the inset graphic will be stretched, if the aspect ratio is not fixed:
{w, Automatic} specifies the width at which a typeset expression should be wrapped:
Specify the direction with which the axis of the inset should be aligned:
Specify the direction with which the axis of the inset should be aligned:
Options   (4)
Determine how to align the contents of the inset:
Determine whether to allow the contents to be selected:
By default, expressions are displayed using TraditionalForm:
Display expressions using StandardForm:
Applications   (3)
Multiple function plot with a legend:
Select countries:
Set up an annotation function using Inset:
Display the map with the annotations:
Define a stock plot with a legend:
Draw stock price changes of a few automakers:
Properties & Relations   (2)
The symbolic positions are relative to ImageScaled coordinates:
For typeset expressions, Text offers functionality similar to Inset:
Neat Examples   (1)
Random collage of text:
New in 6 | Last modified in 7
Ask a question about this page  |  Suggest an improvement  |  Leave a message for the team
Format:   HTML  |  CDF