Inset

Inset[obj]
represents an object obj inset in a graphic.

Inset[obj,pos]
specifies that the inset should be placed at position pos in the graphic.

Inset[obj,pos,opos]
aligns the inset so that position opos in the object lies at position pos in the enclosing graphic.

Inset[obj,pos,opos,size]
specifies the size of the inset in the coordinate system of the enclosing graphic.

Inset[obj,pos,opos,size,dirs]
specifies that the axes of the inset should be oriented in directions dirs.

Details and OptionsDetails and Options

  • Inset can be used in Graphics and Graphics3D.
  • In interactive manipulation, Inset[obj,] is by default selected as a single unit. A doubleclick is required to select individual elements inside.
  • The object obj can be a graphic, cell expression, string, or any other expression.
  • An object inset in Graphics3D is displayed as a billboard while the 3D graphic is rotated.
  • 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.
    {valx,valy,valz}coordinates in a 3D graphic
  • coordinates can be numbers, Automatic, or Left, Center, Right, or Axis.
  • coordinates can be numbers, Automatic, or Top, Center, Bottom, Baseline, or Axis.
  • 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.
  • Inset[obj] is equivalent to Inset[obj,Center].
  • 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[,dirs] 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 2D graphic is always taken to be oriented parallel to the viewing plane for the 3D graphic.
  • 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{}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.
  • Scaled, ImageScaled, and Offset forms can be used to specify the size.
Introduced in 2007
(6.0)
| Updated in 2014
(10.0)