Transform + allows you to apply mathematical functions to the size, position, color etc of a shape.

Illustrator has a Transform Each tool, however while you can scale and move shapes you are limited in setting their size and other settings. With basic settings Transfrom+ allows you to do everything the Transform Each tool does, however when you start using mathematical functions you have a very powerful tool to manipulating your artwork.

For every shape selected the script gets a list of properties for the shape, You can then use these as variables to alter the shapes size, position, stroke and fill. The key feature is that you can use any variable in any field to calculate values - this can create some very powerful transformations.

Here you can define variables to be used in other sections, Use to pre-calculate or as a basic options menu allowing the user to easily change settings.

• Name The Name of the variable
• Value The Value, Note that you can refer to previously defined variables in the value

Set a condition to filter the selection, If the result is false then the shape it not selected.

All user selected items are in an array. Use this to pre-sort the items by criteria, such as color, width, area.

• Examples
  • To sort by width [ width ]
  • To sort by random number [ random(1) ]
  • To sort by area [ area ]
  • To sort by stroke width, but treat unstroked shape as if they had a width of 100 use [ stroked ? strokeWidth : 100 ] which is if stroked then strokeWidth else 100

Make copies of the selection rather than loop through the selection. The selected items will be treated as a group.

• Copies The number of copies to make, this can also be a variable or something like [ selection.width / 10 ]
• Copy from Source If ticked it will always copy the source selection, if unticked it will copy the last copy, For example, if you scaled the height by 90%, with this ticked all copies will be 90% of the original but the same size, unticked each copy will diminish in size.
• Examples
  • To make 10 copies set to [ 10 ]
  • To make a copy every 10mm of an artboard use copies: [ floor(artboard.width / 10) ] and then later set the x position based on the copy count x:[ count * 10 ]

Change the size of the shape

• Fit to Size/Proportional Scale:
  • If ticked and both width and height are set the scale is scaled proportionally to fit within the height and width
  • If ticked and only the width or height are set the shape is scaled proportionally
  • if unticked the only the width or height are changed independently.
• Width Sets the width of the shape,
• Height Sets the height of the shape,
• Examples:
  • To scale just multiply by a number [width * 0.5 ] will scale by 50%
  • To ensure the height does not exceed a maximum number of 100 use [ min(100, width) ]
  • To round the width to be multiples of 10 use [ round(width / 10) * 10 ] or modulus math [ width - (width %10) ]

Rotate the Shape

• 9 point position Set the rotation point based on the shape
• Rotate Rotates the shape by n degrees
• Examples:
  • To rotate to a random angle use [ random() * 360 ]
  • To rotate all shapes so they are landscape [ height > width ? 90 : 0 ] … if height is greater than the width, rotate by 90 degrees else rotate by zero degrees
  • To rotate each shape 2 degrees more than the last [ index * 2 ]
  • Rotate based on how much black ink in the fill or do not rotate if no fill [ filled ? fill.black * 3.6 : 0 ]

• x Sets the x position of the shape
• y Sets the x position of the shape
• Examples
  • Set each shape to be 10mm further away from the left of the artboard [ artboard.x + (index * 10) ]
  • Align to the center of the artboard [ artboard.x + (artboard.width / 2) - (width / 2) ]
  • butt fit each shape next to the first shape in a row so they line up - set x:[ index == 0 ? first.x : previous.x + previous.width ] and set y:[ first.y ]
  • Set x to a random position on the artboard but make sure it does not go over the edge x:[ artboard.x + (artboard.width - width) * random() ]
  • Complicated example to layout shapes in a grid 5 items acoss with 100mm wide and 150mm high
    • x: [ artboard.x + (index % 5) * 100 ] … (index % 5) returns a number 0 to 4
    • y: [ artboard.y + floor(index / 5) * 150) … floor(index / 5) returns the row number

See table below for special color variables aviavable in this section

• Width Sets the width of the stroke IN POINTS
• Color Sets the Color - Choose either RGB or CMYK colors to set.
• Apply to un-stroked shape - Apply changes and settings to shapes with no stroke, otherwise shapes with no stroke are not affected
• Examples
  • See the screenshot above for an example of how to set the stroke to be the same as the fill color
  • Ensure all strokes are at least 0.25 points in width - set width:[ min( 0.25, strokeWidth ) ]
  • Set the stroke to be 5% of the width of the shape with a maximum of 10 points and minimum of 1 point [ max( 1, min( 10, width * 0.05 ) ) ]

Set or modify the fill color See table below for special color variables aviavable in this section

• Color Sets the Color - Choose either RGB or CMYK colors to set.
• C/M/K/Y or R/G/B Set the color component, If this is blank that colour channel will remain unchanged, so for example if you set K to zero it will remove all black from the color
• Apply to un-fill shape - Apply changes and settings to shapes with no fill, otherwise shapes with no fill are not affected
• Example
  • Tint a colour to 50% C:[ fill.cyan * 0.5 ]
  • Invert an RGB color R: [ 255 - R ] - Using 'R' as shortcut for fill.red
  • To eliminate any colour under 1% C:[ max(1, C) ] - Using 'C' as shortcut for fill.cyan
  • To gamma adjust an RGB color R:[ 255 * (R / 255) ^ gamma ] or R:[ 255 * (R / 255) ^ (1/gamma) ]

This will run Javascript code on each shape being transformed, giving you extra control on modifying the shape.

These are the variables passed to the code

• shape {object}: The current shape
• previousShape {null|object}: The previous shape
• index {number}: current selection index
• values {object}: object containing the values
• source {null|object} : source shape if duplicating
• copyCount {number}: copy count if duplicated or 0
• copies {number}: Number to be duplicated

Set a condition which will delete the shape if it returns true

• Example
• Delete all shapes smaller than 10 x 10 - set condition: [ width < 10 and height < 10 ]
• Delete all shapes with no fill and no stroke - set contition: [ filled == 0 and stroked == 0 ]

• Scale Positions Scale the position when resizing
• Scale Fill / Patterns Scale Fills and Patterns when resizing
• Scale Stroke Patterns Scale Strokes and Stroke Patterns when resizing
• Scale Gradients Scale Gradients when resizing
• Scale Strokes Scale Strokes ents when resizing
• Clear Selection Clear the selection when completed, same as Select None
• Apply to all items inside groups When ticked grouped items are treated as ungrouped shapes
• Size Units The units used for positioning (x / y) and size (height / width).

See the pre-saved defaults that come with the install.

Below are the variable, operators and functions you can use.

These objects give you access to the variables of other shapes

first.x 

previous.x + previous.width 

artboard.width/ 2

In addition to the shape variables you can also use

Color values can be referenced using dot notation for example fill.cyan

These only work in the fill and stroke color settings, these directly relate to the fill or stroke colour , you can just use the capital letter of the color you want to use , they are C, M, Y, K, R, G, B

For example if you wanted to divide the cyan value by two instead of writing

fill.cyan / 2

you can just write

C / 2

Size finctions

• 1.4.0 - October 2023
  • Added Extendscript code

• 1.3.1 - 17 December 2017
  • Requires PowerScripts 3.4.2
  • CC2018 Fixes
  • Saving presets also saves accordions status of expanded to closed.

• 1.3.0 - 25 November 2017
  • Added typename property
  • Added Filter section
  • Added Delete section