Differences

This shows you the differences between two versions of the page.

--- proof_color_list [2026/10/25 02:27] – Markup fix for the DokuWiki upgrade (spaces inside bold/italic) 0.0.0.0
+++ proof_color_list [2026/10/25 02:53] (current) – Help pages updated for PowerScripts 3.8 (help pages session) remoteuser
@@ Line 1: / Line 1: @@
-====== Proof Color List  ======
+====== Color List ======
+Add a list of the colours in your artwork to proofs, approval forms and spec sheets in one click: a swatch and the name (or formula) of every colour, laid out neatly. It also shows up colours that shouldn't be in the artwork. (In the shop: Proof Color List.)
+[[https://o2creative.co.nz/shop/Proof_Color_List_PowerScript_for_Adobe_Illustrator|See it in the shop]] · Version 3.0.9 · Needs PowerScripts 3.8.42 or later
-===== Overview =====
+===== Where to find it =====
-This PowerScript creates a list of colors from your document, perfect for quickly listing colors on approval forms or in asset documentation.
+Open the PowerScripts panel (**Window > Extensions > PowerScripts**) and choose **Color List** from the **Color Tools** scripts. The script has three tabs: **Options**, **Color Name Library** and **Layout**.
-  * Create lists from selected shapes or swatches.
+===== Quick start =====
-  * Only list Spot colors or include process colors as well.
-  * Select the layout, including font size, rows and columns.
-  * Choose a swatch shape such as circles, rectangles or custom shapes to be the swatch color.
-  * **NEW** Preview the list of colors and edit the descriptions or uncheck them so they don't show
-  * **NEW** Setup a colour library
-    * Common colors such as CMYK 0,0,100,0 will be re-labeled as "CMYK Yellow"
-    * Select the match type, an exact match, delta or close with a tolerance
-  * NEW Set the position, above or below your artboard or at a fixed position on the page
+  - Select the artwork.
+  - Press **Get Colors**. The colours are listed in the panel.
+  - Untick any you don't want on the proof, and change names if you like.
+  - Press **Create List**.
+===== Options =====
+==== Options ====
-===== Why is it needed =====
+{{:proof_color_list:options_tab.png?380|The Options tab}}
-For approval forms, specifications sheets and the like the designer often needs to create a list of colors used in the artwork , this script simplifies the process. It can also pickup colors that should not be in the artwork, because the will also be listed.
+  * **Source**: the colours of the **Selection**, **All Swatches**, or the **Selected Swatches**.
-===== Interface =====
+  * **Include process colors**: list CMYK and RGB colours too. Untick for spot colours only.
+  * **Include color formula for spot colors**: show each spot colour's formula (CMYK, RGB or Lab) as well as its name.
+  * **Position**: put the list **Below Artboard**, **Below Selection**, or at a **Fixed Position** (**x** and **y**).
+  * **Get Colors**: fill the list below from the **Source**.
+  * **Select All**, **Select None**: tick or untick every colour.
+  * **The colour list**: untick colours to leave them off, type a new name, or delete a colour with the **X**.
+  * **Create List**: adds the colour list to your document.
-==== Options Tab ====
+==== Color Name Library ====
-{{::color_list_2023_options.png?400|}} \\
+{{:proof_color_list:library_tab.png?380|The Color Name Library tab}}
-  * **Source** Select the source of the colours, Selection is the current selection in Illustrator, All Swatches or just selected Swatches
+Give common colours friendly names automatically, for example CMYK 0,0,100,0 is listed as "CMYK Yellow".
-  * **Include process colors:** If ticked then all colours will be listed, if un-ticked then just Spot colors will be listed
-  * **Include full color breakdown**: By default the name of the color is used, ticking this option will show the actual color formula in RGB, CMYK or Lab
-  * **Position:** Set where the color list will appear
-  * **[Get Colors]** This will get the colours from the source and display them in the list below
-  * **[Select All]** This will check all the colours in the list, if a color has not check mark it will now appear in the generated list on the page
-  * **[Select None]**
-  * **Colour List** You can use this list
-    * Uncheck colors so they won't appear on the generated list
-    * Change colour names
-    * Delete colours (pressing the X)_
-Pressing [Create List] will generate the colour list in your document
+  * **Matching Color**: the colour to look for.
-\\
+  * **Display Name**: the name to show instead of its formula.
-\\
+  * **Match**:
-==== Color Name Library Tab ====
+    * **Exact**: the formula must be exactly the same (CMYK 0,0,100,0 matches, 0,0,99.7,0 doesn't).
+    * **Close**: within the **Tolerance** on each ink, for example a tolerance of 2 matches CMYK 50,90,0,0 to anything from 48,88,0,0 to 52,92,0,0.
+    * **Lab ΔE**: when the colours look alike, within the **Tolerance** in Delta E.
+    * **None**: never matches.
+  * **Lab ΔE Method**: the Delta E formula for **Lab ΔE** matching (1976, 1994 or 2000).
-{{::color_list_2023_library.png?400|}}
+==== Layout ====
-Use this library to replace color formulas with named colors.
+{{:proof_color_list:layout_tab.png?380|The Layout tab}}
-  * **Matching Colour:** Edit the colour to match to
+  * **Font**, **Font Size**.
-  * **Display name:** The name the color formula will be changed to
+  * **Text Left Padding**: the gap between the swatch and its name.
-  * **Match type:**
+  * **Vertical Spacing**: the gap between colours.
-    * **Exact:** The color formula must be an exact match for example, CMYK:0,0,100,0 will match to "Yellow", but CMYK:0,0,99.7,0 will not
+  * **Shape Width**, **Shape Height**: the size of each swatch.
-    * **Close:** Uses the tolerance value to match the color, for example, with a tolerance of 2, CMYK:50,90,0,0 will match any color from CMYK:48,88,0,0 to CMYK:52,92,0,0
+  * **Color Shape**: **Circle**, **Rectangle**, **Custom** or **None**.
-    ***Lab ΔE:**  calculates the Delta-E difference between two colours and matches if below the tolerance value.
+  * **Custom Shape**: your own swatch shape. Select a shape in Illustrator and press **Use Selected Shape as Custom** (**Reset** goes back to the default).
-    * **None**: Will not match
+  * **Fit Custom Shape to size**: fit the custom shape to the **Shape Width** and **Height**. Untick to use it at its own size.
-  ***Lab ΔE Method:** Set the Delta E formula to use
+  * **Rows**: how many colours in a column before starting a new one.
-==== Layout Tab ====
+  * **Column Spacing**: the gap between columns.
-{{::color_list_2023_layout.png?400|}}
+===== How to... =====
+==== A colour list on every approval form ====
-  * **Font:** The font used
+  - Set **Position** to **Fixed Position**, at the place on your form for the colours.
-  * **Font Size:** the font size used
+  - Set up the **Layout** to match the form, and save it as a preset (see [[using_presets|Using Presets]]).
-  * **Text left padding:** This is the space between the color swatch shape the color name
+  - On each job: select the artwork, **Get Colors**, **Create List**.
-  * **Vertical spacing:** The vertical space between color samples
-  * **Shape Width:** The width of the color swatch shape
+===== Tips =====
-  * **Shape Height:** The height of the color swatch shape
-  * **Color Shape:**
+  * Use the **Color Name Library** for your house colours, so the list says "Logo Blue" instead of a formula.
-      * **Custom** Will use the custom shape from one you have previously saved
+  * A colour you didn't expect in the list? Find and fix it with [[color_replacer|Color Replacer]].
-      * **Circle** Will generate a circle the size of the shape width and height
+  * For printed colour test patches instead of a list, see [[color_print_samples|Color Print Samples]].
-      * **Rectange** Will generate a rectangle the size of the shape width and height
-      * **None** No color swatch
+===== Good to know =====
-  * **Shape:** This is code used to generate the shape for the swatch shape. To create your own custom swatch shape, select a shape in Illustrator and press the **Use Selected Shape as Preview** button
-  ***Fit Custom shape to size:** When not checked, the custom shape will be used at its original size; checking this will FIT the shape inside the shape width and height sizes.
+  * Making a colour list never changes the colours in your document.
-  ***Rows:** The maximum number of vertical rows
+  * On a long list a **Stop** button shows while it works.
-  ***Column Spacing:** The distance between columns
+===== What's new =====
+  * **3.0.9**
+    * New: a long colour list can be stopped.
+    * Fixed: making a colour list no longer changes the spot colours in your document (their values were rounded).
+    * Fixed: Get Colors with All Swatches works again, and the list uses the Font you pick.
+    * Improved: long lists are made faster, and general bug fixes and reliability.
+  * **3.0.5**: Buy in PowerScripts now opens this script's page in the shop.
+  * **3.0.4**: Updated for PowerScripts 3.8.32.
+  * Older changes: [[releasenotes|PowerScripts Release Notes]]

User Tools

Site Tools

Differences