=== Shader Spiral Carousel ===
Contributors: futurewebdesign
Donate link: https://fwdapps.net/p/ssc/
Tags: image slider, 3D carousel, video slider, wordpress slider
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Version: 1.0
Stable tag: 1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight, responsive multimedia spiral carousel powered by Three.js and custom shaders—smooth 3D transitions

== Description ==

**Shader Spiral Carousel** lets you showcase images, videos, or custom items in a sleek spiral horizontal or vertical layout plus full integration with Revolution Lightbox (https://fwdapps.net/p/rl). It’s fast, accessible, and customizable. Works with Gutenberg and classic shortcodes.

== Highlights ==

Experience a true 3D spiral carousel built with WebGL and Three.js. Enjoy smooth infinite scrolling and realistic item bending for a visually immersive effect with <a href="https://fwdapps.net/p/rl" target="_blank">Revolution Lightbox</a> support.

### Main features

**Responsive Layout** – Fully responsive and adaptable regardless of which device is used.

**Desktop & Mobile Optimized** – Shader Spiral Carousel adapts to any screen size and any device, whether on mobile (iPhone, Android) or desktop browsers.

**Lazy Scrolling/Loading** – Option to initialize Shader Spiral Carousel only when it becomes visible on scroll, improving performance.

**Customizable Size** – Set any width or height. Item size and aspect ratio can be configured as needed.

**Multiple Display Types** – Display using a responsive layout or an *afterparent* mode that adapts to the parent element size.

**Preloader** – Optional animated preloader for smooth initial loading.

**Items Ratio** – Seamlessly change the items’ aspect ratio to display portrait, landscape, or any custom format.

**Infinite Loop** – Optional infinite loop and [non-infinite loop](https://fwdapps.net/p/ssc/preset13.html).

**Lightbox video/audio** – Support for various video or audio formats like <a href="https://fwdapps.net/p/ssc/preset1.html#/?rlguid=fwdssc0_&rlmid=8" target="_blank">.mp3</a>, <a href="https://fwdapps.net/p/ssc/preset1.html#/?rlguid=fwdssc0_&rlmid=0" target="_blank">.mp4</a>, Shoutcast, Icecast, <a href="https://fwdapps.net/p/ssc/preset1.html#/?rlguid=fwdssc0_&rlmid=15" target="_blank">Youtube</a>, <a href="https://fwdapps.net/p/ssc/preset1.html#/?rlguid=fwdssc0_&rlmid=17" target="_blank">Vimeo</a> and Vimeo Pro, <a href="https://fwdapps.net/p/ssc/preset1.html#/?rlguid=fwdssc0_&rlmid=1" target="_blank">HLS/.m3u8</a>, DASH MPEG/.mpd live streaming, <a href="https://fwdapps.net/p/ssc/preset1.html#/?rlguid=fwdssc0_&rlmid=10" target="_blank">Google Drive</a>, Dropbox and other cloud platforms, <a href="https://fwdapps.net/p/ssc/preset1.html#/?rlguid=fwdssc0_&rlmid=22" target="_blank">Iframe</a>, PDF, <a href="https://fwdapps.net/p/ssc/preset1.html#/?rlguid=fwdssc0_&rlmid=20" target="_blank">Google Maps</a> in the ligtbox.

**Private Video & Audio** – Protected password video and audio inside the <a href="preset1.html#/?rlguid=fwdssc0_&rlmid=13" target="_blank">lightbox</a>.

**Chromecast Support** – Cast mp4, mp3, or HLS/m3u8 files to a TV and control playback via the browser.

**Video Thumbnails Live Preview** – Thumbnails generated from .vtt files or auto-generated live inside the lightbox.

**Video Subtitle Support** – Subtitle display inside the [lightbox](https://fwdapps.net/p/ssc/preset2.html#/?rlguid=fwdssc0_&rlmid=0).

**Automatic Content Detection** – [Revolution Lightbox](https://fwdapps.net/p/rl) automatically detects media type (video, audio, image, etc.) from the URL.

**Slideshow Support** – Autoplay slideshow for both carousel thumbnails and lightbox items.

**Drag & Swipe Support** – Drag or swipe to navigate carousel items or lightbox slides.

**Maximize & Minimize for Images** – Double-click/tap or use a button to zoom; custom zoom factor supported.

**Share Button & Share Window** – Share to nine social platforms; buttons can be reordered or removed.

**Noise Distortion** – Customizable noise distortion for the items, <a href="https://fwdapps.net/p/ssc/preset14.html" target="_blank">example here</a></a>.

**Caption** – Optional captions fully styleable with CSS.

**Mouse Ripple** – Optional ripple effect triggered by mouse movement with adjustable strength ([example](https://fwdapps.net/p/ssc/preset12.html)).

**Opacity Strength** – Custom opacity for non-centered items.

**Snap** – Automatically snap the closest item to center for perfect alignment.

**Scroll Speed Strength** – Fine-tune scroll speed to match your desired experience.

**Scroll Scale Strength** – Fine-tune scroll scaling for your desired visual effect.

**Default & Scroll Curvature** – Adjust item curvature at rest and while scrolling.

**Liquid Distortion** – Customizable liquid distortion that responds to scroll speed.

**Post Processing** – Shaders that improve antialiasing for a crisp, clean look. Includes effects like <a href="https://fwdapps.net/p/ssc/preset17.html" target="_blank">grid distortion</a>, <a href="https://fwdapps.net/p/ssc/preset18.html" target="_blank">fluid distortion</a>, glitch distortion, after image and more.


**Use cases**
- Product carousels
- Portfolio galleries
- Products slider
- Testimonials or logos
- Hero sliders with minimal chrome
- Whre you want to impress your users

**Links**
- Homepage & docs: https://fwdapps.net/p/ssc/
- Demo: https://fwdapps.net/p/ssc/#demos
- Support: https://fwdapps.net/contact

= Shortcode =
Basic: [fwdssc preset_name="Carousel preset 1" gallery_name="My gallery"]

== Development ==
This plugin’s full source code is publicly available for transparency and verification.  
It is developed and maintained by FutureWebDesign / FWD.

Source code and build tools: https://fwdapps.net/p/ssc/source.zip  
(The source package includes the original uncompiled files and Vite build configuration.)

The distributed plugin uses a compiled build generated by Vite for performance,  
but all source files and build scripts are included for review and rebuilding.