Image Shader
Intro
A Shader for images, image sequences and video.
UI
File - Connect an image asset. This can be directly from the Assets Window or via an Asset Array or Asset from Smart Folder. Still images, image sequences and video are supported.
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 image fits a Shape's bounding box:
- None - Do not scale.
- Fit Contain - Fit the image to the bounding box of the Shape so that the whole image is always visible.
- Fit Width - Fit the image's width to the width of the Shape's bounding box.
- Fit Height - Fit the image's height to height of the Shape's bounding box.
- Fit Cover - Fit the image 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 image:
- 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 image.
Offset - Offset the position of the image.
Looping - When checked an Image Sequence, video or gif will be set to infinitely loop.
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 length of an image sequence or video in frames.