Hi again @AntonioPacheco, for extra learning, please try this revised script.
I added functions to align to various points (topLeft, top, topRight, left, center, right, bottomLeft, bottom, bottomRight) so, for example, you can set it up to align the bottom center of the item to the top center of the artboard, or another useful alignment would be aligning the bottom left of the item to the top left of the artboard, with an offset of [0, -20] to move it off the artboard.
The "alignmentPoints" are functions that return the point, so you could add your own function that returned a custom point and just plug it in.
- Mark
/*
Alignment points:
topLeftPoint
topPoint
topRightPoint
leftPoint
centerPoint
rightPoint
bottomLeftPoint
bottomPoint
bottomRightPoint
*/
var items = positionNamedItems(
{
doc: app.activeDocument,
findWhat: 'positionMe',
artboardAlignmentPoint: topLeftPoint,
itemAlignmentPoint: topLeftPoint,
offset: [10, 20]
}
);
/**
* Finds a page item for each artboard
* and positions it relative to the
* nearest artboard, aligning to
* specified points of artboard and item.
* @author m1b
* @version 2022-09-29
* @param {Object} options
* @param {Document} options.doc - an Illustrator Document.
* @param {Function} [options.artboardAlignmentPoint] - function that returns the alignment point of the artboard (default: topLeft).
* @param {Function} [options.itemAlignmentPoint] - function that returns the alignment point of the item (default: topLeft).
* @param {String|RegExp} [options.findWhat] - search for this in item name (default: match all items).
* @param {Array<Number>} [options.offset] - the offset [x, y] from alignment point (default: [0, 0]).
* @returns {Array<PageItem>} the positioned items.
*/
function positionNamedItems(options) {
var doc = options.doc,
artboardAlignmentPoint = options.artboardAlignmentPoint || topLeftPoint,
itemAlignmentPoint = options.itemAlignmentPoint || topLeftPoint,
findWhat = options.findWhat,
offset = options.offset || [0, 0];
if (doc == undefined)
return [];
var items = [];
// find named items
for (var i = 0, a = doc.artboards.length; i < doc.pageItems.length; i++) {
if (
findWhat == undefined
|| doc.pageItems[i].name.search(findWhat) != -1
) {
// found one!
items.push(doc.pageItems[i]);
// stop looking when found one item for each artboard
if (!--a) break;
}
}
// collect artboards
var abs = [],
abCenters = [];
for (var a = 0; a < doc.artboards.length; a++) {
abs[a] = doc.artboards[a];
abCenters[a] = centerPoint(abs[a]);
}
// position each item
for (var i = 0; i < items.length; i++) {
var item = items[i],
itemCenter = centerPoint(item);
// find closest artboard
var smallest = -1,
closest = -1;
for (var a = abs.length - 1; a >= 0; a--) {
var ab = abs[a],
abCenter = abCenters[a],
distance = distanceBetweenPoints(abCenter, itemCenter);
if (
smallest == -1
|| distance < smallest
) {
smallest = distance;
closest = a;
}
}
$/*debug*/.writeln('closest = ' + closest);
// position item to closest artboard
var ab = abs[closest];
// get the alignmentPoints align
var itemPoint = itemAlignmentPoint(item),
artboardPoint = artboardAlignmentPoint(ab);
// translation needed to align itemPoint with artboardPoint
var delta = [artboardPoint[0] - itemPoint[0], artboardPoint[1] - itemPoint[1]];
// move the item, including offset
item.translate(delta[0] + offset[0], delta[1] - offset[1]);
}
return items;
};
/**
* Returns distance between two points.
* @author m1b
* @version 2022-07-25
*
* @param {Array} p1 - a point array [x, y].
* @param {Array} p2 - a point array [x, y].
* @returns {Number} - distance in points.
*/
function distanceBetweenPoints(p1, p2) {
var a = p1[0] - p2[0];
var b = p1[1] - p2[1];
return Math.sqrt(a * a + b * b);
};
/**
* Returns bounds of item.
* @author m1b
* @version 2022-09-29
* @param {PageItem|Artboard} obj - a page item or artboard.
* @returns {Array<Number>} - [left, top, right, bottom]
*/
function getBounds(obj) {
var bounds;
if (obj.hasOwnProperty('visibleBounds'))
bounds = obj.visibleBounds;
else if (obj.hasOwnProperty('artboardRect'))
bounds = obj.artboardRect;
return bounds;
};
/**
* Returns the item's top left point.
* @author m1b
* @version 2022-09-29
* @param {PageItem|Artboard} obj - a page item or artboard.
* @returns {Array<Number>} - [x, y]
*/
function topLeftPoint(obj) {
var bounds = getBounds(obj);
if (bounds != undefined)
return [bounds[0], bounds[1]];
};
/**
* Returns the item's top point.
* @author m1b
* @version 2022-09-29
* @param {PageItem|Artboard} obj - a page item or artboard.
* @returns {Array<Number>} - [x, y]
*/
function topPoint(obj) {
var bounds = getBounds(obj);
if (bounds != undefined)
return [bounds[0] + (bounds[2] - bounds[0]) / 2, bounds[1]];
};
/**
* Returns the item's top right point.
* @author m1b
* @version 2022-09-29
* @param {PageItem|Artboard} obj - a page item or artboard.
* @returns {Array<Number>} - [x, y]
*/
function topRightPoint(obj) {
var bounds = getBounds(obj);
if (bounds != undefined)
return [bounds[2], bounds[1]];
};
/**
* Returns the item's left point.
* @author m1b
* @version 2022-09-29
* @param {PageItem|Artboard} obj - a page item or artboard.
* @returns {Array<Number>} - [x, y]
*/
function leftPoint(obj) {
var bounds = getBounds(obj);
if (bounds != undefined)
return [bounds[0], bounds[1] + (bounds[3] - bounds[1]) / 2];
};
/**
* Returns the item's center point.
* @author m1b
* @version 2022-09-29
* @param {PageItem|Artboard} obj - a page item or artboard.
* @returns {Array<Number>} - [x, y]
*/
function centerPoint(obj) {
var bounds = getBounds(obj);
if (bounds != undefined)
return [
bounds[0] + (bounds[2] - bounds[0]) / 2,
bounds[1] + (bounds[3] - bounds[1]) / 2,
];
};
/**
* Returns the item's right point.
* @author m1b
* @version 2022-09-29
* @param {PageItem|Artboard} obj - a page item or artboard.
* @returns {Array<Number>} - [x, y]
*/
function rightPoint(obj) {
var bounds = getBounds(obj);
if (bounds != undefined)
return [bounds[2], bounds[1] + (bounds[3] - bounds[1]) / 2];
};
/**
* Returns the item's bottom left point.
* @author m1b
* @version 2022-09-29
* @param {PageItem|Artboard} obj - a page item or artboard.
* @returns {Array<Number>} - [x, y]
*/
function bottomLeftPoint(obj) {
var bounds = getBounds(obj);
if (bounds != undefined)
return [bounds[0], bounds[3]];
};
/**
* Returns the item's bottom point.
* @author m1b
* @version 2022-09-29
* @param {PageItem|Artboard} obj - a page item or artboard.
* @returns {Array<Number>} - [x, y]
*/
function bottomPoint(obj) {
var bounds = getBounds(obj);
if (bounds != undefined)
return [bounds[0] + (bounds[2] - bounds[0]) / 2, bounds[3]];
};
/**
* Returns the item's bottom right point.
* @author m1b
* @version 2022-09-29
* @param {PageItem|Artboard} obj - a page item or artboard.
* @returns {Array<Number>} - [x, y]
*/
function bottomRightPoint(obj) {
var bounds = getBounds(obj);
if (bounds != undefined)
return [bounds[2], bounds[3]];
};
2 Correct answers
15
Replies
AdChoices
