ImageScaled

ImageScaled[{x,y}]

gives the position of a graphical object in terms of coordinates scaled to run from 0 to 1 across the whole image region in each direction.

ImageScaled[{dx,dy},{x₀,y₀}]

gives a position obtained by starting at ordinary coordinates {x₀,y₀}, then moving by an image‐scaled offset {dx,dy}.

Details

ImageScaled can be used to specify scaled coordinates in any two-dimensional graphics primitive.
You can use ImageScaled to represent objects that occupy a fixed region in the image associated with a graphic.
The image region used to define ImageScaled includes only the region in which the graphic can actually be drawn. It does not include empty space arising from mismatches in shape between ImageSize and AspectRatio, or defined by ImageMargins.

Examples

open allclose all

Basic Examples (2)Summary of the most common use cases

Positions of objects by fractions of the whole image:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-g3ftrb

Out[1]=1

Radii by fractions of the whole image:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-bg2pks

Out[1]=1

Scope (4)Survey of the scope of standard use cases

ImageScaled Positions (3)

Specify coordinates by fractions of the whole image:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-jkk8qf

Out[1]=1

Specify the radii by fractions of the whole image:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-fyru1p

Out[1]=1

Specify the positions of light sources in the view coordinate system pointing to the center:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-faf6gh

Out[1]=1

ImageScaled Offsets (1)

Specify image-scaled offsets from the ordinary coordinates:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-d8k4x4

Out[1]=1

Applications (1)Sample problems that can be solved with this function

Place a watermark on top of the graphic:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-qm6i4

In[2]:=2

✖

https://wolfram.com/xid/0i1ohvb2a-epw4lt

Out[2]=2

Properties & Relations (4)Properties of the function, and connections to other functions

Scaled is proportional to PlotRange. ImageScaled is proportional to ImageSize:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-b2eq5e

Out[1]=1

ImageScaled operates relative to the whole image:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-knieim

Out[1]=1

Scaled operates relative to the plot range:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-fb3tu1

Out[1]=1

With PlotRangeClipping set to True, objects outside of the PlotRange will be clipped:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-p2w5eu

Out[1]=1

Possible Issues (3)Common pitfalls and unexpected behavior

Objects with image-scaled coordinates outside 0 and 1 may not be displayed:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-kiu3ht

Out[1]=1

By default PlotRangeClipping is set to True for plot functions:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-bgqy7

Out[1]=1

Use False to include objects outside of the PlotRange:

In[2]:=2

✖

https://wolfram.com/xid/0i1ohvb2a-cd674w

Out[2]=2

Using ImageScaled sizes, the appearance of the graphic will depend on the ImageSize and AspectRatio:

In[1]:=1

✖

https://wolfram.com/xid/0i1ohvb2a-zf4ps

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0i1ohvb2a-ezszg4

Out[2]=2

Top