GIF Source

Overview

The GIF Source allows users to add animated GIF images to their LiveLens scenes.

It is optimized for high performance using GPU frame caching and includes a dedicated GIF Editor for cropping, looping, and opacity adjustments.

To open the GIF Editor:

The GIF Editor popup opens, featuring a live preview with cropping tools and control panels.

To maintain app stability and smooth streaming, LiveLens enforces the following limits:

GIFs exceeding these limits will trigger a warning and will not be loaded.

The preview area allows you to precisely frame your animation.

Interactive Cropper: Drag the blue handles at the Top-Left and Bottom-Right to crop the GIF.
Dimmed Areas: Parts of the GIF outside the crop frame are shown with a dark overlay, indicating they will be hidden on the main canvas.

Select GIF: Pick a .gif file from your device storage.
Loop GIF: Check this box to make the animation play infinitely. If unchecked, the GIF will play once and stop at the last frame.
Opacity: Use the slider (0-100%) to adjust transparency.

The GIF Source supports full interactive controls on the canvas:

Move: Drag to reposition.
Resize: Pinch to scale up or down.
Rotate: Use the rotation handle (bottom-right).
Rotation Degree: A degree indicator appears at the top-center during rotation.
Reset Rotation: Tap the reset handle at the top-right corner of the crop frame to return to 0°.
Double Tap: Quickly scale the GIF to fill the canvas. Double-tap again to return to the previous size.

Setting	Description
Select GIF	Browse and load a GIF file from your phone
Loop GIF	Toggle between infinite playback and single play
Opacity	Adjust transparency level
Cropping	Manually crop the animated area
Reset Rotation	Instantly aligns the GIF to the original orientation