Parallax Motion Parameter Schedule Generator¶
Documentation¶
- Class name:
SaltParallaxMotion - Category:
SALT/Scheduling/Parallax Motion - Output node:
False
The SaltParallaxMotion node is designed to generate a schedule of parameters for parallax motion effects in audio-visual presentations. It leverages various inputs to dynamically adjust the motion and depth of elements, creating a more immersive and engaging experience.
Input types¶
Required¶
zoom_preset- unknown
- Comfy dtype:
COMBO[STRING] - Python dtype:
unknown
horizontal_pan_preset- unknown
- Comfy dtype:
COMBO[STRING] - Python dtype:
unknown
vertical_pan_preset- unknown
- Comfy dtype:
COMBO[STRING] - Python dtype:
unknown
custom_x_min- unknown
- Comfy dtype:
FLOAT - Python dtype:
unknown
custom_x_max- unknown
- Comfy dtype:
FLOAT - Python dtype:
unknown
custom_y_min- unknown
- Comfy dtype:
FLOAT - Python dtype:
unknown
custom_y_max- unknown
- Comfy dtype:
FLOAT - Python dtype:
unknown
custom_z_min- unknown
- Comfy dtype:
FLOAT - Python dtype:
unknown
custom_z_max- unknown
- Comfy dtype:
FLOAT - Python dtype:
unknown
parallax_intensity- unknown
- Comfy dtype:
FLOAT - Python dtype:
unknown
zoom_intensity- unknown
- Comfy dtype:
FLOAT - Python dtype:
unknown
Output types¶
front_x_min- Comfy dtype:
FLOAT - Minimum X-axis value for the front layer's motion range, contributing to the depth effect in the parallax motion.
- Python dtype:
float
- Comfy dtype:
front_x_max- Comfy dtype:
FLOAT - Maximum X-axis value for the front layer's motion range, contributing to the depth effect in the parallax motion.
- Python dtype:
float
- Comfy dtype:
front_y_min- Comfy dtype:
FLOAT - Minimum Y-axis value for the front layer's motion range, contributing to the depth effect in the parallax motion.
- Python dtype:
float
- Comfy dtype:
front_y_max- Comfy dtype:
FLOAT - Maximum Y-axis value for the front layer's motion range, contributing to the depth effect in the parallax motion.
- Python dtype:
float
- Comfy dtype:
front_z_min- Comfy dtype:
FLOAT - Minimum Z-axis value for the front layer's motion range, contributing to the depth effect in the parallax motion.
- Python dtype:
float
- Comfy dtype:
front_z_max- Comfy dtype:
FLOAT - Maximum Z-axis value for the front layer's motion range, contributing to the depth effect in the parallax motion.
- Python dtype:
float
- Comfy dtype:
back_x_min- Comfy dtype:
FLOAT - Minimum X-axis value for the back layer's motion range, contributing to the depth effect in the parallax motion.
- Python dtype:
float
- Comfy dtype:
back_x_max- Comfy dtype:
FLOAT - Maximum X-axis value for the back layer's motion range, contributing to the depth effect in the parallax motion.
- Python dtype:
float
- Comfy dtype:
back_y_min- Comfy dtype:
FLOAT - Minimum Y-axis value for the back layer's motion range, contributing to the depth effect in the parallax motion.
- Python dtype:
float
- Comfy dtype:
back_y_max- Comfy dtype:
FLOAT - Maximum Y-axis value for the back layer's motion range, contributing to the depth effect in the parallax motion.
- Python dtype:
float
- Comfy dtype:
back_z_min- Comfy dtype:
FLOAT - Minimum Z-axis value for the back layer's motion range, contributing to the depth effect in the parallax motion.
- Python dtype:
float
- Comfy dtype:
back_z_max- Comfy dtype:
FLOAT - Maximum Z-axis value for the back layer's motion range, contributing to the depth effect in the parallax motion.
- Python dtype:
float
- Comfy dtype:
Usage tips¶
- Infra type:
CPU - Common nodes: unknown
Source code¶
class SaltParallaxMotion:
"""
A node for generating min/max FLOAT values for Front and Back layers across X, Y, and Z axes
in 2D plane translations to create a parallax effect, based on selected presets or custom input values.
Adjusts these values based on the parallax intensity.
"""
def __init__(self):
pass
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"zoom_preset": (["None", "Zoom In", "Zoom Out", "Zoom In/Out", "Zoom Out/In", "Custom", "Select Random"], {
"default": "None"
}),
"horizontal_pan_preset": (["None", "Pan Left → Right", "Pan Right → Left", "Pan Left → Center",
"Pan Right → Center", "Pan Center → Right", "Pan Center → Left", "Custom", "Select Random"], {
"default": "None"
}),
"vertical_pan_preset": (["None", "Pan Up → Down", "Pan Down → Up", "Pan Up → Center",
"Pan Down → Center", "Pan Center → Up", "Pan Center → Down", "Custom", "Select Random"], {
"default": "None"
}),
"custom_x_min": ("FLOAT", {"default": 0.0}),
"custom_x_max": ("FLOAT", {"default": 0.0}),
"custom_y_min": ("FLOAT", {"default": 0.0}),
"custom_y_max": ("FLOAT", {"default": 0.0}),
"custom_z_min": ("FLOAT", {"default": 1.0}),
"custom_z_max": ("FLOAT", {"default": 1.0}),
"parallax_intensity": ("FLOAT", {"default": 1.0}),
"zoom_intensity": ("FLOAT", {"default": 1.0, "min": 0.1, "max": 10.0}),
},
}
RETURN_TYPES = ("FLOAT", "FLOAT", "FLOAT", "FLOAT", "FLOAT", "FLOAT", "FLOAT", "FLOAT", "FLOAT", "FLOAT", "FLOAT", "FLOAT")
RETURN_NAMES = ("front_x_min", "front_x_max", "front_y_min", "front_y_max", "front_z_min", "front_z_max", "back_x_min", "back_x_max", "back_y_min", "back_y_max", "back_z_min", "back_z_max")
FUNCTION = "generate_parameters"
CATEGORY = "SALT/Scheduling/Parallax Motion"
def generate_parameters(self, zoom_preset, horizontal_pan_preset, vertical_pan_preset,
custom_x_min, custom_x_max, custom_y_min, custom_y_max,
custom_z_min, custom_z_max, parallax_intensity, zoom_intensity):
# Handle random selection for zoom presets
if zoom_preset == "Select Random":
zoom_options = [key for key in zoom_presets.keys() if key not in ["None", "Custom", "Select Random"]]
zoom_preset = random.choice(zoom_options)
# Apply the selected or randomly chosen zoom preset
if zoom_preset in zoom_presets:
z_min, z_max = zoom_presets[zoom_preset]
# Handle random selection for horizontal pan presets
if horizontal_pan_preset == "Select Random":
horizontal_options = [key for key in horizontal_pan_presets.keys() if key not in ["None", "Custom", "Select Random"]]
horizontal_pan_preset = random.choice(horizontal_options)
# Apply the selected or randomly chosen horizontal pan preset
if horizontal_pan_preset in horizontal_pan_presets:
x_min, x_max = horizontal_pan_presets[horizontal_pan_preset]
# Handle random selection for vertical pan presets
if vertical_pan_preset == "Select Random":
vertical_options = [key for key in vertical_pan_presets.keys() if key not in ["None", "Custom", "Select Random"]]
vertical_pan_preset = random.choice(vertical_options)
# Apply the selected or randomly chosen vertical pan preset
if vertical_pan_preset in vertical_pan_presets:
y_min, y_max = vertical_pan_presets[vertical_pan_preset]
# Initialize default axis values
x_min, x_max = 0, 0
y_min, y_max = 0, 0
z_min, z_max = 1, 1 # Default Z values assume no zoom (scale of 1)
# Apply the selected zoom preset
if zoom_preset in zoom_presets:
z_min, z_max = zoom_presets[zoom_preset]
# Apply the selected horizontal pan preset
if horizontal_pan_preset in horizontal_pan_presets:
x_min, x_max = horizontal_pan_presets[horizontal_pan_preset]
# Apply the selected vertical pan preset
if vertical_pan_preset in vertical_pan_presets:
y_min, y_max = vertical_pan_presets[vertical_pan_preset]
# For 'Custom' selections, override with custom values
if zoom_preset == "Custom":
z_min, z_max = custom_z_min, custom_z_max
if horizontal_pan_preset == "Custom":
x_min, x_max = custom_x_min, custom_x_max
if vertical_pan_preset == "Custom":
y_min, y_max = custom_y_min, custom_y_max
# Calculate the back layer's values based on the parallax intensity
back_x_min = x_min / parallax_intensity if x_min != 0 else 0
back_x_max = x_max / parallax_intensity if x_max != 0 else 0
back_y_min = y_min / parallax_intensity if y_min != 0 else 0
back_y_max = y_max / parallax_intensity if y_max != 0 else 0
# Z values are not adjusted by parallax intensity
back_z_min, back_z_max = z_min, z_max
# Adjust for zoom intensity for Z axis to increase front zoom relative to back with higher intensity values
# This approach assumes the front layer's zoom can increase more than the back's as zoom_intensity increases.
# Adjust the formula as needed to align with your specific vision for the effect.
adjusted_front_z_min = z_min * (1 + zoom_intensity - 1) # Example adjustment, enhances the front zoom based on intensity
adjusted_front_z_max = z_max * (1 + zoom_intensity - 1) # Similarly for max zoom
# The back layer's zoom could remain unchanged, or you could apply a different formula if the back layer also needs adjustment.
back_z_min, back_z_max = z_min, z_max # Keeps back layer's zoom unchanged; modify as needed.
return (x_min, x_max, y_min, y_max, adjusted_front_z_min, adjusted_front_z_max, back_x_min, back_x_max, back_y_min, back_y_max, back_z_min, back_z_max)