ComfyUI Node: 🐠 Fisheye

🐠 Fisheye:

The FisheyeNode is designed to apply a fisheye distortion effect to images, creating a unique and visually striking transformation that mimics the appearance of a fisheye lens. This effect is particularly useful for artists and designers looking to add a dynamic and immersive perspective to their images. By manipulating the field of view and the distortion strength, the node allows for a wide range of creative possibilities, from subtle curvature to extreme warping. The node's primary function is to remap the image pixels based on a fisheye projection, which can be customized using different mapping techniques such as equidistant, equisolid, orthographic, and stereographic. This flexibility makes the FisheyeNode a powerful tool for enhancing visual storytelling and creating captivating imagery.

🐠 Fisheye Input Parameters:

image

The image parameter is the input image that you want to apply the fisheye effect to. It should be provided as a tensor, and the node will handle the conversion to a NumPy array for processing. The image's dimensions and color channels are preserved during the transformation.

fov

The fov (field of view) parameter determines the extent of the fisheye effect. It is measured in degrees and influences how much of the image is captured in the fisheye distortion. A higher field of view results in a more pronounced fisheye effect, while a lower field of view creates a subtler distortion. The typical range is from 0 to 180 degrees, with a default value that suits most artistic needs.

mapping

The mapping parameter specifies the type of fisheye projection to use. Options include "equidistant," "equisolid," "orthographic," and "stereographic." Each mapping type offers a different way of projecting the image onto the fisheye lens, affecting the distortion's appearance. Choosing the right mapping can enhance the artistic effect you wish to achieve.

format

The format parameter defines the shape of the fisheye effect, with "circular" being a common choice. This parameter ensures that the distortion is applied within a circular boundary, maintaining the aesthetic integrity of the fisheye effect.

center_x

The center_x parameter sets the horizontal center of the fisheye effect as a fraction of the image width. By default, it is set to 0.5, which centers the effect horizontally. Adjusting this value allows you to shift the fisheye effect to the left or right, providing more control over the distortion's focal point.

center_y

The center_y parameter sets the vertical center of the fisheye effect as a fraction of the image height. Like center_x, it defaults to 0.5, centering the effect vertically. Modifying this value lets you move the fisheye effect up or down, offering additional creative flexibility.

strength

The strength parameter controls the intensity of the fisheye distortion. A value of 1.0 applies the standard distortion, while values greater than 1.0 increase the effect's intensity, and values less than 1.0 reduce it. This parameter allows you to fine-tune the visual impact of the fisheye effect to suit your artistic vision.

🐠 Fisheye Output Parameters:

result_tensor

The result_tensor is the output of the FisheyeNode, containing the image with the applied fisheye effect. It is returned as a tensor, ready for further processing or display. The output retains the original image's dimensions and color channels, ensuring compatibility with subsequent nodes or applications.

🐠 Fisheye Usage Tips:

• Experiment with different fov values to achieve varying levels of distortion, from subtle to extreme, depending on your artistic goals.
• Use the mapping parameter to explore different fisheye projections, each offering a unique visual style that can enhance your creative work.
• Adjust the center_x and center_y parameters to shift the focal point of the fisheye effect, allowing you to emphasize specific areas of the image.

🐠 Fisheye Common Errors and Solutions:

Image shape mismatch

• Explanation: This error occurs when the input image does not have the expected shape or dimensions, which can prevent the node from processing it correctly.
• Solution: Ensure that the input image is a tensor with the correct dimensions and color channels. If necessary, preprocess the image to match the expected format.

Invalid fov value

• Explanation: An invalid fov value, such as a negative number or a value exceeding 180 degrees, can cause unexpected results or errors.
• Solution: Verify that the fov value is within the acceptable range of 0 to 180 degrees. Adjust the value to ensure it is valid and appropriate for the desired effect.

Unsupported mapping type

• Explanation: Using an unsupported mapping type can lead to errors or incorrect fisheye effects.
• Solution: Double-check the mapping parameter to ensure it is set to one of the supported types: "equidistant," "equisolid," "orthographic," or "stereographic." Adjust the parameter as needed.