Skip to main content
Version: 4.0.0

Image

Image allows you to create an image plane that you can move, rotate, and resize in the scene.

properties

Add an Image Component

Add an Image component by clicking + Add Component > 2D > Image in the Inspector panel.

Properties

PropertyDescription
MaterialAdds a material from the Assets panel.
TextureSets the target image asset for the Image component. You can import a texture directly in the Inspector panel.
Blend ModeSets the current image to blend with whatever is behind it.
OpacitySets the transparency of the image. The range is from 0.0 to 1.0, with a default value of 1.0.
ColorSets the color that will blend with the image texture.
Size (Width, Height)The size of the bounding box that limits the dimensions of the image texture. The Size property is used in conjunction with Stretch Mode, and is independent of the image texture’s dimensions. The default value is (10, 10).
Pivot (X,Y)The center of the image plane that affects its movement and rotation. When the Image is manipulated in the scene, it will pivot around the defined point. The default value is (0.5, 0.5).
  • X: The closer the value is to 0, the farther left the pivot is. The closer the value is to 1, the farther right the object pivot is.
  • Y: The closer the value is to 0, the lower the pivot is. The closer the value is to 1, the higher the pivot is.
Stretch ModeDefines how the image fits into its bounding box. Below are the available Stretch Modes to choose from:
  • Fit (Default mode): The image is scaled uniformly so that its aspect ratio is preserved, and the image fits within the bounding box.
  • Fit Width: The image is scaled to fit the width dimension of the bounding box, while preserving its aspect ratio. The image can extend beyond the box on the top and bottom.
  • Fit Height: The image is scaled to fit the height dimension of the bounding box, while preserving its aspect ratio. The image can extend beyond the box on the left and right.
  • Stretch: The image is stretched to completely fill the bounding box, distorting its aspect ratio.
  • Fill: The image is scaled to completely fill the bounding box, while preserving its aspect ratio. The image extends past the bounding box to fill it completely.
  • Fill and Cut: The image is scaled to completely fill the bounding box as in the Fill setting, but is cropped to fit within the bounding box.
Flip XFlips the image horizontally.
Flip YFlips the image vertically.
Draw Mode
  • Normal (default): The image will be rendered in the center of the container.
  • Tiled: The image will be rendered as a 9-slice image where the corners will remain constant and the other sections will tile.
  • Filled: The image will be rendered to fill the container.
  • Ellipse: Render the image as a circle, and Ellipse X and Ellipse Y will control the rendering circle range in X and Y-axis.

Blend Mode

Blend ModeDescriptionPreview
NormalEdits or paints each pixel to make it the result color SrcAlpha, OneMinusSrcAlpha.
normal
Darkenmin(a,b): Looks at the color information in each channel and selects the base or blend color, choose whichever is darker as the result color.
darken
Multiplya*b: Looks at the color information in each channel and multiplies the base colors by blend colors.
multiply
Lightenmax(a.b): Looks at the color information in each channel and selects the base or blend color whichever is lighter as the result color.
lighten
Screen1-(1-a)(1-b): Looks at each channel’s color information and multiplies the inverse of the blend and base colors. The result color is always a lighter color.
screen
Burn / Color Burn1-(1-b)/a: Looks at the color information in each channel and darkens the base color to reflect the blend color by increasing the contrast between the two.
burn or color burn
Linear Burn
linear burn
Dodge / Color Dodgeb / (1 – a): Looks at the color information in each channel and brightens the base color to reflect the blend color by decreasing contrast between the two.
dodge or color dodge
Linear Dodge
linear dodge
Adda+b: Looks at the color information in each channel and brightens the base color to reflect the blend color by increasing the brightness.
add
Subtract
subtract
OverlayPatterns or colors overlay the existing pixels while preserving the highlights and shadows of the base color.
overlay
Soft LightThe effect is similar to shining a diffused spotlight on the image. If the blend color (light source) is lighter than 50% gray, the image is lightened as if it were dodged. If the blend color is darker than 50% gray, the image is darkened as if it were burned in.
soft light
Hard LightIf the blend color (light source) is lighter than 50% gray, the image is lightened, as if it were screened. This is useful for adding highlights to an image. If the blend color is darker than 50% gray, the image is darkened, as if it were multiplied.
hard light
Pin Light
pin light
Linear Light
linear light
Vivid Light
vivid light
Hard Mix
hard mix
Average
average
Difference
difference
ExclusionCreates an effect similar to but lower in contrast than the Difference mode. Blending with white inverts the base color values. Blending with black produces no change.
exclusion
Negation
negation
Phoenix
phoenix
Reflect
reflect
Snow Color
snow color
Snow Hue
snow hue