Image Shader
Intro
A Shader for images, image sequences and video.
UI
File - Connect an image, image sequence or video asset. This can be directly from the Assets Window or via an Asset Array or Asset from Smart Folder.
Filter - These settings can improve image quality in both the Viewport and for renders – particularly when resizing images:
- None (Fastest) - No resampling will be performed when the images are resized – this is the lowest quality setting.
- Bilinear - Basic resampling is performed. This is low quality but it's very fast.
- Mipmaps - Mipmaps are pre-calculated, optimised, low resolution versions of the image created via Bilinear interpolation. These are used to get the best quality and performance when scaling images down.
- Bicubic - This is the slowest method but it produces the best quality when scaling images up.
Scale Mode - Set how the File fits a Shape's bounding box:
- None - Do not scale.
- Fit Contain - Fit the File to the bounding box of the Shape so that the whole image is always visible.
- Fit Width - Fit the File's width to the width of the Shape's bounding box.
- Fit Height - Fit the File's height to height of the Shape's bounding box.
- Fit Cover - Fit the File to the width or height of the Shape's bounding box so that it fills the Shape while maintaining its aspect ratio.
Tiling - Determine what happens at the borders of the File:
- Clamp - Use the first and last values of the image.
- Repeat - Repeat/loop the image.
- Mirror - Mirror/ping pong the image.
- Decal - Cut out the image.
Scale - Increase/decrease the scale of the File.
Offset - Offset the position of the File.
Rotation - Rotate the File.
Looping - When checked, an Image Sequence, video or gif will be set to infinitely loop.
Use Footage FPS - When checked, the File's frame rate will be used regardless of the parent Composition's frame rate.
FPS - Set the frame rate an Image Sequence will play back at. By default this control is connected to the Composition's frame rate but this can be manually set by removing the connection.
Time - A connection to the Composition's Time which is used to drive the frame number of a video or image sequence.
Missing Frames - Determine how frames missing from an image sequence are displayed:
- Noise - Display a noise pattern.
- Nearest Frame - Display the nearest 'found' frame. For example:
| Source | Display |
|---|---|
| image-00 | image-00 |
missing | image-00 |
missing | image-03 |
| image-03 | image-03 |
| image-04 | image-04 |
- Black - Display a black frame.
Sequence Length - A read only attribute which returns the duration of the File in frames. A still image will output 1.
Size - A read only attribute which returns the resolution of the File.