LogoLogo
  • User Manual
  • Chapters
    • Welcome
      • Acknowledgments
      • History
      • Sisyphean Effort
    • Quick Start Guide
      • Installation
      • Defining a Show Directory
      • Controllers
      • Layout and Background Image definition
      • Model Definition
      • Model Group Definition
      • Creating a New Sequence
        • Adding Models to a View
      • Adding Effects
      • Saving the Sequence
      • Backup and Exit
      • Testing
    • Installation
      • Upgrade
      • Windows
      • Macintosh
      • Linux
    • Controllers Tab
      • Controllers
      • Show Directory
      • Controllers Settings
        • USB Controller
        • Ethernet Controller
        • NULL Controller
        • Controller Visualizer
    • Layout Tab
      • Layout
      • Models
        • Model Settings
          • Setting Start Channels
        • Arches Model
        • Channel Block Model
        • Candy Cane Model
        • Circle Model
        • Cube Model
        • Custom Model
        • DMX Model
          • DMX Moving Head Advance
        • Image Model
        • Icicles Model
        • Matrix Model
        • PolyLine Model
        • Single Line Model
        • Sphere Model
        • Spinner Model
        • Star Model
        • Tree Model
        • Window Frame Model
        • Wreath Model
      • Download/Import Models
      • Model Groups
      • Objects
      • Layout Preview
      • Editing Layout Preview
      • Moving Model/Objects
      • SubModels
    • Sequencer Tab
      • Sequencer
      • Rendering
      • Timeline and Waveform
      • Adding An Effect
      • Changing An Effect
        • Changing Color Settings
      • Layers
        • Layer Blending
        • Layer Settings
      • Timing Tracks
      • Render All
      • Windows
      • Value Curves
      • Effect Presets
      • Views
      • Models
      • Singing Faces
        • Adding Word to User Dictionary
      • Pixel Editor
      • Shortcuts
    • Menus
      • File
        • New Sequence
        • Preferences
          • Backup
          • View
          • Effects Grid
          • Sequences
          • Output
          • Colors
          • Other
        • Sequence Settings
        • Backup and Recovery
      • Edit
      • Tools
        • Test
        • Convert
        • Generate Custom Model
        • FPP Connect
      • View
        • Windows
        • Perspectives
      • Audio
      • Import
      • Help
    • Advanced Features
  • Effects
    • Built-in Effects
      • Off
      • On
      • Adjust
      • Bars
      • Butterfly
      • Candle
      • Circles
      • Color Wash
      • Curtain
      • DMX
      • Duplicate
      • Faces
      • Fan
      • Fill
      • Fire
      • Fireworks
      • Galaxy
      • Garlands
      • Glediator
      • Guitar
      • Kaleidoscope
      • Life
      • Lightning
      • Lines
      • Liquid
      • Marquee
      • Meteors
      • Morph
      • Moving Head
      • Music
      • Piano
      • Pictures
      • Pinwheel
      • Plasma
      • Ripple
      • Servo
      • Shader
      • Shape
      • Shimmer
      • Shockwave
      • Single Strand
      • Snowflakes
      • Snow Storm
      • Spirals
      • Spirograph
      • State
      • Strobe
      • Tendrils
      • Text
      • Tree
      • Twinkle
      • Video
      • VU Meter
      • Warp
      • Wave
  • Appendicies
    • Glossary
    • Keyboard Shortcuts
  • Tutorials
    • Configure Matrix Panels
    • Coming from LOR
    • Editing xLights_rgb.xml
Powered by GitBook
On this page
Export as PDF
  1. Effects
  2. Built-in Effects

Pictures

PreviousPianoNextPinwheel

Last updated 5 years ago

The Pictures effect is used to import a supported image type (gif, bmp, jpg etc) and render that image as an effect while also allowing the image to be manipulated and edited within xLights. You will need a image that is to be imported. Save the image as a GIF file and make the background color transparent if you don’t want the original (white) background of the image.

Place the Picture effect in on timing cells that you wish to have the effect on a model. Click on the effect on the grid and amend the parameters as required. First click on the Browse button and navigate to the location of your image, select the image and click open or double click to select the image.

Option/Settings

Description

Movement

Controls how the image will move across the model layout.

In addition to directional options such as left, right, wiggle etc, there are a number of special options, such as peekaboo, flag wave.

Movement Speed

Controls how fast the image moves across within the effect timeframe.

Frame Rate Adj

When using the pictures effect to play an GIF, this setting is used to set the playback speed if needed to speed up or slow down the playback.

Offset in Pixels

Used to specify exact number of pixels rather than % for the start and end positions offset.

"No Scaling" Image file will not be resize and excess pixels will be chopped off.

"Scale to Fit" Image file will be resize to your model. Vertical and horizontal dimension will be scaled independently.

"Scale Keep Aspect Ratio" Image file will be resize to your model but the dimension are scaled together to keep the original aspect ratio.

Shimmer

Fade in and out random pixels in the image.

Loop Animated GIF

Replay GIF animation, if GIF is shorter than effect length.

Suppress GIF Background

Remove GIF background color and make it transparent.

Transparent Black

Allow black pixel to be transparent. Slider adjust at what level "black" becomes transparent.

Start Position: (x,y)

Sets the position of the image if it does not need to be centered on the model.

Start Position: (wrap x)

Used to bound the picture image within the model. Defines and controls the coordinates of the ‘bottom left’ start corner.

End Position: (x,y)

Used to bound the picture image within the model. Defines and controls the coordinates of the ‘top right’ end corner.

Start Scale

Set the starting position scale (0 - 1000%) independently of the start position.

End Scale

Set the ending position scale (0 - 1000%) independently of the end position.

The playback rate is influenced by the length of the effect. So if you change the time length of your effect and have an image that is non stationary, the rate of movement will adjust according to the new time length.

If you move the image that you have used for the picture effect to a different location or delete it, when you next run the sequencer, if the image is not found, an error message will not be displayed, but the picture effect will render a blank image. The only time this won’t happen is if only the drive letter has changed, and the rest of the path is the same.

Icon
Sequencer Grid