Harmonizer Script for Adobe Illustrator

Description

The harmonizer.jsx script is designed for Adobe Illustrator CS5+ and was created by Alexander Ladygin. This script allows users to harmonize the arrangement of selected objects by organizing them into a grid layout with customizable parameters. The script provides a graphical user interface (GUI) for users to specify settings such as the number of columns, gutter sizes, alignment, sorting order, and more.

Author Information

Author: Alexander Ladygin
Email: i@ladygin.pro
Website: www.ladyginpro.ru

Features

Grid Layout Creation:

Specify the number of columns for the grid.
Set gutter sizes for X and Y directions.
Align objects within the grid based on various positions (e.g., Left, Center, Right).

Sorting Options:

Sort objects by different criteria such as Y, X, Size, Width, and Height.
Reverse the sorting order.

Random Order:

Randomize the order of objects in the grid.

Grouping:

Option to group objects after arranging them in the grid.

Preview:

Preview the arrangement before applying changes.

Settings Management:

Save and load settings for future use.

Usage

Prerequisites:

Ensure you have Adobe Illustrator CS5+ installed.
Select the objects you want to apply the script to.

Running the Script:

Open the harmonizer.jsx script in Adobe Illustrator.
The script will check if there are any objects selected.
If objects are selected, the GUI will appear.

GUI Components:

Grid Settings:
- Columns: Specify the number of columns.
- Gutter X: Set the gutter size for the X direction.
- Gutter Y: Set the gutter size for the Y direction.
- Position X: Choose alignment option for the X direction (Left, Center, Right).
- Position Y: Choose alignment option for the Y direction (Top, Middle, Bottom).
Sorting Options:
- Sort Items By: Select sorting criteria (Y, X, Size, Width, Height).
- Reverse Order: Reverse the sorting order.
Additional Options:
- Group: Group objects after arranging them.
- Random Order: Randomize the order of objects.
- Preview: Enable or disable preview.

Buttons:

Cancel: Close the GUI without applying changes.
OK: Apply the grid layout with specified parameters.

Settings:

The script saves settings to a JSON file in the user’s documents folder.
Settings are loaded automatically when the script is run.

Additional Information

If no objects are selected when the script is run, an alert will prompt the user to select objects.
The script includes helper functions for handling input events, sorting, and randomizing arrays.