Skip to main content
TikTok Effect House Platform Logo
Latest
Download
Log in
3D

Image

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

Note
Note

In previous versions of Effect House, the Image object was a 2D object. Starting in Effect House v2.1.0, the Image is a 3D object that can be manipulated in 3D space, and the Screen Image object is used to manage images in 2D space. Learn more about using images in 2D space.

Add an Image Object

To add an Image object, click the Add button [+] > 3D > Image in the Hierarchy panel. The Image presents as a plane that can be manipulated in the Scene panel.

Image in the Hierarchy Panel

Starting in Effect House v2.1.0, the Image object appears under the General render group and can be managed as a 3D object. Learn more about render groups.

Move, Rotate, and Resize the Image

In the Scene panel, you can scale, rotate, and transform the image.

The Transform component in the Inspector panel allows you to manually adjust the Position, Rotation, and Scale properties.

Image Component and Properties

Texture: Sets the target image asset for the Image component.

Blend Mode: Sets the current image to blend with whatever is behind it. Learn more about the different blend modes.

Opacity: Sets the transparency of the image. The range is from 0.0 to 1.0, with a default value of 1.0.

Color: Sets 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 Mode: Defines 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 X: Flips the image horizontally.

Flip Y: Flips the image vertically.

Demo Effect: How to Create Mini Clones

You can use the Image object with portrait segmentation and tracking to create duplicate images of the subject captured on camera!

  1. Add an Image object by clicking the Add button [+] > 3D > Image in the Hierarchy panel.
  2. With the Image object selected in the Hierarchy panel, go to the Inspector panel and click + Add component > 3D > Look At.
  3. Add a Head Tracker object by clicking the Add button [+] > AR Tracking > Head Tracker in the Hierarchy panel.
  4. Select the Image object in the Hierarchy panel, then go to the Look At component in the Inspector panel, and change the Target property to Head Tracker.
  5. Change the Look At component’s Mode property to Look At Direction.
  6. Add a Portrait Segmentation Texture by clicking the Add button [+] > Texture > Segmentation Texture > Portrait in the Assets panel.
  7. Select the Image object in the Hierarchy panel, then go to the Image component in the Inspector panel, and change the Texture to Portrait Segmentation Texture.
  8. Resize and position the Image in the Scene panel to your desire.
  9. Feel free to duplicate the Image in the Hierarchy panel and create as many mini clones as you want!