extern/easydiffusion
1
0
Fork 1
mirror of https://github.com/easydiffusion/easydiffusion.git synced 2025-02-16 10:29:39 +01:00
Code Issues Packages Projects Releases Wiki Activity

Added details on how to configure images for custom modifiers.

AvidGameFan 2023-03-18 15:00:39 -04:00
parent 417b083538
commit 5322acd8a9
1 changed files with 8 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
Custom-Modifiers.md

@ -1,9 +1,15 @@
This feature allows adding custom modifiers with images, instead of just text values.
This feature allows adding custom modifiers with sample images, instead of using just text values.
It looks for images in a `modifiers` folder and adds them to the object read from `modifiers.json`. If an image is directly inside of `modifiers` then it will be added to a Modifiers category. Images in direct subfolders will have the folder names as the category. Otherwise images in sub-sub folders etc... will have the folder path be the category (ex: `modifiers/Foo/Bar` will become `Foo/Bar`). The order of categories defined in `modifiers.json` is preserved, and new categories will be added at the end sorted alphabetically.
Inside your Easy Diffusion install folder, look for a `modifiers` folder -- create it if it does not exist. This is where you will copy your custom modifier images. To preserve the aspect ratio, generate your sample images at 512x512. If an image is directly inside of `modifiers` then it will be added to a Modifiers category. Images in direct subfolders will have the folder names as the category. Otherwise images in sub-sub folders, etc., will have the folder path be the category (ex: `modifiers/Foo/Bar` will become `Foo/Bar`). The original order of categories (defined in `modifiers.json`) is preserved, and new categories will be added at the end sorted alphabetically.
Rename your images to the actual text of the modifier prompt, followed by the type extension (such as `.png`).
If the image ends in ` Portrait`, `.Portrait`, `-Portrait`, or `_Portrait` (case insensitive) it will be considered a portrait image, and if it has Landscape instead it would be a landscape image, and the portrait/landscape suffix will be removed from the modifier name. Otherwise the image will be used as both the portrait and landscape.
After adding your images and organizing your folders, restart the Easy Diffusion server in order for the images to finally appear.
Note that in Windows, you may run into a limitation on the size of your path/filename combination.
![image](https://user-images.githubusercontent.com/8977984/219980954-c2b350ab-c3d1-45dc-b6a6-7d04af5b8693.png)
![image](https://user-images.githubusercontent.com/8977984/219980980-df896285-0229-4516-9c71-31d91cde41c6.png)
![image](https://user-images.githubusercontent.com/8977984/219980995-1095b386-bbf0-47a9-8ba6-d18140684c32.png)