Nourepide-ComfyUI-Allor/README.MD

This image from start to end was done in ComfyUI. How?

1. Install plugin.
2. Load fonts Overlock SC and Merienda.
3. Put OverlockSC-Regular.ttf and Merienda-Regular.ttf in to fonts folder.
4. Load RealESRNet_x4plus.pth and put in to models/upscale folder.
5. Load AOM3A1B_orangemixs.safetensors and put in to models/chekpoints folder.
6. Load orangemix.vae.pt and put in to models/vae folder.
7. Drag-and-drop this image to ComfyUI or load JSON.
8. Press the Queue Promt button.

About Allor:

• Allor is a plugin for ComfyUI with an emphasis on transparency and performance.
• All modules support transparency, multi-image and are easy to use.
• One of the main features is the ability to combine several images of different sizes.
• Almost all functionality is implemented in tensor space without transformation into an image, where possible. This allows you to achieve an incredible speed of work, in some places the speed increases from 1-2 seconds to 4-6 milliseconds.

Installation:

1. cd custom_nodes
2. git clone https://github.com/Nourepide/ComfyUI-Allor.git comfyui_allor
3. cd comfyui_allor
4. pip install -r requirements.txt
5. You can also create fonts folder in comfy_extras or just start ComfyUI and folder will create automatically.

Updating:

1. cd custom_nodes/comfyui_allor or cd custom_nodes/{name of ComfyUI Allor folder}
2. git checkout main && git pull

Modules:

Details:

Alpha chanel

Helpers for work with alpha chanel in exiting images.

Nodes:

By Mask

Applies transparency to the image using a mask.

Params:

• method -
  • default - Standard mask overlay.
  • invert - Inverted mask overlay.

As Mask

Get alpha chanel from first image and returns it as mask.

Params:

• method -
  • default - Standard mask overlay.
  • invert - Inverted mask overlay.

Restore

Add alpha dimension to images. Or restore if it already exists.

Params:

• method -
  • default - Apply adding new alpha chanel or restore chanel values to max if it already exists.
  • only_add - Only add new alpha chanel if it does not exist.
  • only_restore - Only restore alpha chanel values to max if it already exists.

---

Image Container

Creating blank images of fixed or inherited size.

Nodes:

All

• [red, green, blue] [0 - 255] - Color of the container in RGB.
• alpha [0.0 - 1.0] - Transparency of the container.

Default

Create an empty container.

Params:

• [width, height] [1 - *] - Size of a new container.

Inheritance Add

Get images size and create a container with adding value to this size.

Params:

• add_[width, height] [0 - *] - The value that will then be added to the size of the container.

Inheritance Scale

Get images size and create a container with scaling this size.

Params:

• scale_[width, height] [0.0 - *] - Scale factor that will then be change the size of the container.

Inheritance Max

Get max width and max height from images_a and images_b and create a new container with this size.

Inheritance Sum

Get width and/or height from images_a and images_b and create a new container with a sum this size.

PS:

The first letter i in the word Inheritance is barely noticeable. But in the end, I decided to leave it as it is. At first, I thought to replace this word with the word Extended, but one would think that this node expands the incoming images by adding size to it, and does not create a new image inheriting size from the incoming images.

---

Image Composite

Allows you to place one image on top of another.

Nodes:

All

• background - The placement order of images in the container.
• method - The method of connecting images makes sense only when 2 or more images are passed to the input.

Methods:

Inputs - [a1, a2, a3] and [b1, b2, b3].
Outputs -
    pair: [a1, b1], [a2, b2], [a3, b3]
    matrix: [a1, b1], [a1, b2], [a1, b3]
            [a2, b1], [a2, b2], [a2, b3]
            [a3, b1], [a3, b2], [a3, b3]

Absolute

Use it for pixel-perfect images compositing.

Params:

• images_[a, b]_x [0 - *] - Images horizontal position. [left -> right].
• images_[a, b]_y [0 - *] - Images vertical position. [top -> bottom].
• container_[width, height] [0 - *] - Container size. If 0, then the container will be with the maximum width and height of the images.

Relative

Use it for percentage images compositing.

Params:

• images_[a, b]_x [0.0 - 1.0] - First images horizontal offset. [left edge -> right edge].
• images_[a, b]_y [0.0 - 1.0] - First images vertical offset. [top edge -> bottom edge].
• container_size_type
• • max - Maximum of width and height from images_a and images_b.
• • sum - Sum of width and height from images_a and images_b.
• • sum_[width, height] -

How it works.

• Images in relative mode cannot go beyond the edges of the container.
• In horizontal [0.0 - images is located on the left of the container], [1.0 - on right of container].
• In vertical [0.0 - images is located on the top of the container], [1.0 - on bottom of container].
• In all cases, [0.5] means that the images will be in the center.

---

Image Segmentation

Removes background from image.

Nodes:

All

• alpha_matting [boolean] - Alpha matting is a post-processing step that can be used to improve the quality of the output.
• alpha_matting_foreground_threshold [0 - 250] - Trimap foreground threshold.
• alpha_matting_background_threshold [0 - 250] - Trimap background threshold.
• alpha_matting_erode_size [0 - *] - How far will the transparency spread from the original mask.
• post_process_mask [boolean] - Post-processing mask, makes it rougher.

Default

Allows you to select a model with pre-specified settings.:

Params:

• u2net - GitHub
• u2netp - GitHub
• u2net_human_seg - GitHub
• u2net_cloth_seg - GitHub
• silueta - GitHub
• isnet-general-use - GitHub
• isnetis - GitHub (I recommend alpha_matting parameter set to false)
• modnet-p - GitHub (Not calibrated)
• modnet-w - GitHub (Not calibrated)

Custom

Allows you to select a model from the onnx folder and specify the parameters yourself.

Params:

• model [*.onnx] - Your model in ComfyUI/models/onnx folder.
• mean [0.0 - 1.0] - Clarifying value.
• std [0.0 - 1.0] - The divisor of the final value. I recommend leaving it at 1.0.
• size [0 - *] - Title size. Different models support different sizes. Or their multiple values [512 -> 1024 -> 2048...]. If the size does not match the desired one, you will see a notification in the console.

Custom Advanced

Allows you to select a model from the onnx folder and finely specify the parameters yourself.

Params:

• model [*.onnx] - Your model in ComfyUI/models/onnx folder.
• mean_r [0.0 - 1.0] - Clarifying value. Red chanel.
• mean_g [0.0 - 1.0] - Clarifying value. Green chanel.
• mean_b [0.0 - 1.0] - Clarifying value. Blue chanel.
• std_r [0.0 - 1.0] - The divisor of the final value. Red chanel.
• std_g [0.0 - 1.0] - The divisor of the final value. Green chanel.
• std_b [0.0 - 1.0] - The divisor of the final value. Blue chanel.
• width [0 - *] - Width of title size.
• height [0 - *] - Height of title size.

Some models support non-standard title size. For example [w:1024 - h:2048].

PS:

Made on rembg. The solution of some problems may be dependent on the rembg developer.

---

ImageText

Creating text as image.

Fonts should be contained in ComfyUI/comfy_extras/fonts.

You also can change the fonts folder in config.

Nodes:

Default

Create an image with text.

Params:

• text - Your input. Shouldn't be empty.
• font [*.otf, *.ttf] - Font from ComfyUI/comfy_extras/fonts folder.
• size [1 - *] - Font size in SP. Warning!: It's not PX size of the container. The size of the container is calculated using a variety of parameters. Example: o and j will have different height and exactly different size compared to 树.
• [red, green, blue] [0 - 255] - Color of the text in RGB.
• alpha [0.0 - 1.0] - Transparency of the text.
• margin_x [0 - *] - Horizontal offset.
• margin_y [0 - *] - Vertical offset.

Outlined

Create an image with outlined text.

Params:

• outline_size [0 - *] - Outline size in PX.
• outline_[red, green, blue] [0 - 255] - Color of the outline in RGB.

---

ImageDraw

Draw figures as image.

Nodes:

All

• SSAO [1 - 16] - Super Sampling Anti-Aliasing. The figure is drawn initially at a higher resolution, and then compressed to the specified resolution.

The difference of SSAA strength:

From left to right, x1, x2, x4, x8, x16. Image container size 256x256px.

Arc

Draws an arc (a portion of a circle outline) between the start and end angles, inside the given bounding box.

Params:

• [width, height] [1 - *] - Size of image container.
• size [1 - *] - contour width.
• start_[x, y] [0.0 - 1.0] - Start points to define the bounding box in percent of image container.
• end_[x, y] [0.0 - 1.0] - End points to define the bounding box in percent of image container.
• [start, end] [0 - 360] - Starting and ending angle, in degrees. Angles are measured from 3 o’clock, increasing clockwise.
• [red, green, blue] [0 - 255] - Color of the figure in RGB.
• alpha [0.0 - 1.0] - Transparency of the figure.

Chord

Same as Arc, but connects the end points with a straight line.

Params:

• [width, height] [1 - *] - Size of image container.
• size [1 - *] - contour width.
• start_[x, y] [0.0 - 1.0] - Start points to define the bounding box in percent of image container.
• end_[x, y] [0.0 - 1.0] - End points to define the bounding box in percent of image container.
• [start, end] [0 - 360] - Starting and ending angle, in degrees. Angles are measured from 3 o’clock, increasing clockwise.
• [red, green, blue] [0 - 255] - Color of the figure in RGB.
• alpha [0.0 - 1.0] - Transparency of the figure.

Ellipse

Draws an ellipse inside the given bounding box.

Params:

• [width, height] [1 - *] - Size of image container.
• start_[x, y] [0.0 - 1.0] - Start points to define the bounding box in percent of image container.
• end_[x, y] [0.0 - 1.0] - End points to define the bounding box in percent of image container.
• outline_size [0 - *] - Outline size in PX.
• outline_[red, green, blue] [0 - 255] - Color of the outline in RGB.
• outline_alpha [0.0 - 1.0] - Transparency of the outline.
• fill_[red, green, blue] [0 - 255] - Color of the fill in RGB.
• fill_alpha [0.0 - 1.0] - Transparency of the fill.

Line

Draws a line between the coordinates.

Params:

• [width, height] [1 - *] - Size of image container.
• size [1 - *] - contour width.
• start_[x, y] [0.0 - 1.0] - Starting point of line.
• end_[x, y] [0.0 - 1.0] - Ending point of line.
• [red, green, blue] [0 - 255] - Color of the line in RGB.
• alpha [0.0 - 1.0] - Transparency of the line.

Pieslice

Same as Arc, but also draws straight lines between the end points and the center of the bounding box.

Params:

• [width, height] [1 - *] - Size of image container.
• start_[x, y] [0.0 - 1.0] - Start points to define the bounding box in percent of image container.
• end_[x, y] [0.0 - 1.0] - End points to define the bounding box in percent of image container.
• [start, end] [0 - 360] - Starting and ending angle, in degrees. Angles are measured from 3 o’clock, increasing clockwise.
• outline_size [0 - *] - Outline size in PX.
• outline_[red, green, blue] [0 - 255] - Color of the outline in RGB.
• outline_alpha [0.0 - 1.0] - Transparency of the outline.
• fill_[red, green, blue] [0 - 255] - Color of the fill in RGB.
• fill_alpha [0.0 - 1.0] - Transparency of the fill.

Polygon

Draws a polygon.

Params:

• size [1 - *] - Size of image.
• sides [3 - *] - Sides of polygon.
• rotation [0 - 360] - Apply an arbitrary rotation to the polygon in degree.
• outline_size [0 - *] - Outline size in PX.
• outline_[red, green, blue] [0 - 255] - Color of the outline in RGB.
• outline_alpha [0.0 - 1.0] - Transparency of the outline.
• fill_[red, green, blue] [0 - 255] - Color of the fill in RGB.
• fill_alpha [0.0 - 1.0] - Transparency of the fill.

Rectangle

Draws a rectangle.

Params:

• [width, height] [1 - *] - Size of image container.
• start_[x, y] [0.0 - 1.0] - Start points to define the bounding box in percent of image container.
• end_[x, y] [0.0 - 1.0] - End points to define the bounding box in percent of image container.
• outline_size [0 - *] - Outline size in PX.
• outline_[red, green, blue] [0 - 255] - Color of the outline in RGB.
• outline_alpha [0.0 - 1.0] - Transparency of the outline.
• fill_[red, green, blue] [0 - 255] - Color of the fill in RGB.
• fill_alpha [0.0 - 1.0] - Transparency of the fill.

Rectangle Rounded

Draws a rounded rectangle.

Params:

• [width, height] [1 - *] - Size of image container.
• start_[x, y] [0.0 - 1.0] - Start points to define the bounding box in percent of image container.
• end_[x, y] [0.0 - 1.0] - End points to define the bounding box in percent of image container.
• radius [0 -360] - Radius of the corners.
• outline_size [0 - *] - Outline size in PX.
• outline_[red, green, blue] [0 - 255] - Color of the outline in RGB.
• outline_alpha [0.0 - 1.0] - Transparency of the outline.
• fill_[red, green, blue] [0 - 255] - Color of the fill in RGB.
• fill_alpha [0.0 - 1.0] - Transparency of the fill.
• [top_left, top_right, bottom_right, bottom_left]_corner [boolean] - The ability to choose for which angle to apply the radius.

---

Clamp

Clamps help to control the "web" of nodes and improve readability.

Nodes:

• ClipClamp
• ClipVisionClamp
• ClipVisionOutputClamp
• ConditioningClamp
• ControlNetClamp
• GligenClamp
• ImageClamp
• LatentClamp
• MaskClamp
• ModelClamp
• StyleModelClamp
• UpscaleModelClamp
• VaeClamp

Configuration:

You can configurate Allor with config.json.

• fonts_folder_path - Array with a relative path to fonts folder, by default is ["comfy_extras", "fonts"]. (Converted to ComfyUI/comfy_extras/fonts for Unix and ComfyUI\comfy_extras\fonts for Windows).
• modules - You can disable (or enable) modules at will. Nodes from disabled modules will not be loaded during the start of ComfyUI.