Например, координаты можно задать так:

with(myTextFrame){
geometricBounds = ["61p", "4p", "62p", "45p"];
}

или при создании нового объекта в в составе метода add()

var myTextFrame = textFrames.add({geometricBounds:["0pt", "0pt", "100pt", "100pt"]})

Здесь задание координат Y1, X1, Y2, X2 производится при помощи массива из четырех членов. В нашем случае это четыре строки, но чаще используются числа.

geometricBounds = [25, 40, 100.5, 80.25];

Заметьте, что первой координатой в паре X-Y является координата Y. Следует также помнить, что в качестве разделителя между целой и дробной частью в числовых единицах измерения используется точка, а не запятая. Начинающие разработчики часто набивают себе шишки на этом. Возможно также задание единиц измерения, где в качестве разделителя между целой и дробной частью стоит единица измерения, напр., 1p6 т.е. 1 пика + 6 пунктов.
Если при задании geometricBounds не указаны никакие единицы измерения, например:

geometricBounds = [0,0,72,72]

то при выполнении скрипта InDesign будет использовать те единицы измерения, которые сейчас установлены для документа.
В скриптах единицы измерения задаются в установках документа viewPreferences. Для этого используется следующий код:

myDoc = app.activedocument;
// задаем единицы измерения picas
with (myDoc.viewPreferences){
	horizontalMeasurementUnits = MeasurementUnits.picas;
	verticalMeasurementUnits = MeasurementUnits.picas;
}

Здесь horizontalMeasurementUnits – единицы измерения для горизонтальной шкалы, verticalMeasurementUnits – для вертикальной.
Если надо задать другие единицы измерения, то внутри конструкции with используйте строки:

horizontalMeasurementUnits = MeasurementUnits.points;
verticalMeasurementUnits = MeasurementUnits.points;
//или
horizontalMeasurementUnits = MeasurementUnits.inches;
verticalMeasurementUnits = MeasurementUnits.inches;
//или
horizontalMeasurementUnits = MeasurementUnits.inchesDecimal;
verticalMeasurementUnits = MeasurementUnits.inchesDecimal;
//или
horizontalMeasurementUnits = MeasurementUnits.millimeters;
verticalMeasurementUnits = MeasurementUnits.millimeters;
//или
horizontalMeasurementUnits = MeasurementUnits.centimeters;
verticalMeasurementUnits = MeasurementUnits.centimeters;
//или
horizontalMeasurementUnits = MeasurementUnits.ciceros;
verticalMeasurementUnits = MeasurementUnits.ciceros;

Если вы хотите использовать в скрипте единицы измерения, отличные от тех, которые в настоящий момент использует InDesign, то хорошим тоном считается по окончании работы скрипта вернуть всё на место, как было до запуска скрипта. Фирма Adobe Systems в составе демонстрационных скриптов приводит пример этого:

 //ResetMeasurementUnits.jsx
var myDocument = app.activeDocument;
with (myDocument.viewPreferences){
	// Сохраняем старые единицы измерения в переменных myOldXUnits, myOldYUnits
	var myOldXUnits = horizontalMeasurementUnits;
	var myOldYUnits = verticalMeasurementUnits;
	// Устанавливаем новые единицы измерения
	horizontalMeasurementUnits = MeasurementUnits.points;
	verticalMeasurementUnits = MeasurementUnits.points;
}
//----------------------------------------------------------
// Основной код скрипта
//----------------------------------------------------------
// Возвращаем Индизайну старые единицы измерения
with (myDocument.viewPreferences){
	try{
		horizontalMeasurementUnits = myOldXUnits;
		verticalMeasurementUnits = myOldYUnits;
	}
	catch(myError){
		alert("Could not reset custom measurement units.");
	}
}

Определять и задавать единицы измерения можно с использованием прототипов:

var myDocument = app.activeDocument;
myDocument.prototype.setUnitsTo = function(newUnits)
{
var arrUnits = (newUnits.length) ? newUnits : [newUnits,newUnits];
with(this.viewPreferences)
	{
	horizontalMeasurementUnits = arrUnits[0];
	verticalMeasurementUnits = arrUnits[1];
	}
}
Document.prototype.getUnits = function()
{
return([
	this.viewPreferences.horizontalMeasurementUnits,
	this.viewPreferences.verticalMeasurementUnits
	]);
}

В тексте программного модуля затем формируется массив из двух значений и устанавливаются новые единицы измерения

var units = this.activeDocument.getUnits();
app.activeDocument.setUnitsTo(MeasurementUnits.points);

В конце работы программы возвращаются первоначальные единицы измерения:

app.activeDocument.setUnitsTo(units);

О чем молчит Adobe

Если требуется рассчитать geоmetricBounds для текстового фрейма, у которого размер равен размеру страницы, то можно воспользоваться функцией, которую приводит фирма Adobe в своих примерах:

myDocument = app.activeDocument
with(myDocument.documentPreferences){
var myPageWidth = pageWidth;
var myPageHeight = pageHeight;
}
var myPage = app.activeWindow.activePage;
var myTextFrame = myPage.textFrames.add(
{
geometricBounds:[0, 0, myPageHeight, myPageWidth]
}
);

Конечно редко нужно создавать текстовый фрейм размером на всю страницу. Гораздо чаще требуется ограничить создаваемый фрейм полями страницы. Рассмотрим функцию myGetBounds() (демонстрационный пример Adobe), которая рассчитывает geometricBounds в этом случае.

var myDocument = app.activeDocument;
var myTextFrame = myPage.textFrames.add({geometricBounds:myGetBounds(myDocument, myPage), contents:TextFrameContents.placeholderText});
function (myDocument, myPage)
{
var myPageWidth = myDocument.documentPreferences.pageWidth;
var myPageHeight = myDocument.documentPreferences.pageHeight
if(myPage.side == PageSideOptions.leftHand){
var myX2 = myPage.marginPreferences.left;
var myX1 = myPage.marginPreferences.right;
}
else{
var myX1 = myPage.marginPreferences.left;
var myX2 = myPage.marginPreferences.right;
}
var myY1 = myPage.marginPreferences.top;
var myX2 = myPageWidth - myX2;
var myY2 = myPageHeight - myPage.marginPreferences.bottom;
return [myY1, myX1, myY2, myX2];
}

Как видите, для правильного расчета координат в скрипте используются свойства по определению положения страницы на развороте – правая или левая (.leftHand). Но тем не менее здесь скрыт подводный камень, о котором Adobe не сказала ни слова. Засада в том, что функция myGetBounds() правильно определяет массив координат geometricBounds только в том случае, если у каждой страницы своё начало координат и своя координатная система. Если же система координат общая для всего разворота, то рассчитанные координаты для правой страницы будут неверны, и создаваемый текстовый фрейм вместо правой страницы окажется на левой. Странно, что этот факт нигде не отражен в примерах скриптов фирмы Adobe.
Для того, чтобы эта функция всегда правильно работала, перед её вызовом надо установить отдельную координатную систему на каждую страницу разворота

myDocument.viewPreferences.rulerOrigin = RulerOrigin.pageOrigin;
var myTextFrame = myPage.textFrames.add({geometricBounds:myGetBounds(myDocument, myPage), contents:TextFrameContents.placeholderText});

Если вы намерены менять координатную систему, то по окончании работы скрипта будет благородно вернуть её назад:

var oldRuler = myDocument.viewPreferences.rulerOrigin;
myDocument.viewPreferences.rulerOrigin = RulerOrigin.PAGE_ORIGIN;
var myTextFrame = myPage.textFrames.add({geometricBounds:myGetBounds(myDocument, myPage), contents:TextFrameContents.placeholderText});
// выполняем скрипт
//...............
// Возвращаем первоначальную систему координат
myDocument.viewPreferences.rulerOrigin = oldRuler;

Вы уже заметили использование параметра RulerOrigin.PAGE_ORIGIN? Этим параметром произведена установка одного из типов координатной системы. В Индизайне их три: spread, page, spine. Соответственно в объектной модели (раздел Preference > viewPreferences) свойство ruleOrigin может принимать значения RulerOrigin.SPREAD_ORIGIN, RulerOrigin.PAGE_ORIGIN, RulerOrigin.SPINE_ORIGIN.

Второй вариант получения всегда правильных координат заключается в модификации функции myGetBounds(), где происходит разветвление расчета в зависимости от установленной в текущий момент системы координат:

function myGetBounds(myDocument, myPage){
var myPageWidth = myDocument.documentPreferences.pageWidth;
var myPageHeight = myDocument.documentPreferences.pageHeight;
myRuler = myDocument.viewPreferences.rulerOrigin;
if(myPage.side == PageSideOptions.leftHand){
var myX2 = myPage.marginPreferences.left;
var myX1 = myPage.marginPreferences.right;
}
else{
if(myRuler == RulerOrigin.pageOrigin || myRuler == RulerOrigin.spineOrigin)
{
var myX1 = myPage.marginPreferences.left;
var myX2 = myPage.marginPreferences.right;
}
else // система координат общая для разворота
{
var myX1 = myPageWidth + myPage.marginPreferences.left;
var myX2 = myPageWidth + myPage.marginPreferences.right;
}
}
var myY1 = myPage.marginPreferences.top;
var myX2 = myPageWidth - myX2;
var myY2 = myPageHeight - myPage.marginPreferences.bottom;
return [myY1, myX1, myY2, myX2];
}

В этом случае менять и возвращать первоначальную координатную систему не требуется. Теоретически этот способ более медленный, но вряд ли на практике вы это заметите.

Итак,

Метод duplicate()

Синтаксис: dublicate(to, by);
Каждый из параметров может быть опущен, и оба параметра могут быть опущены одновременно. Первый параметр, «to«, обозначает место, куда будет копироваться фрейм. Это может быть разворот, страница, слой. Понимание параметра «by» немного сложнее. Он состоит из двух значений (массив), относящихся к координатам осей x и y. Это могут быть как числа, так и строки, которыми задаются координаты.
Возможны следующие варианты:
а) если параметр «to» указан, то параметром «by» задается расположение нового текстового фрейма относительно старого. То есть величины сдвига по горизонтали и по вертикали.
b) если параметр «to» опущен, параметр «by» задает абсолютные координаты x, y левого верхнего угла нового текстового фрейма.

Пример 1.

myDoc = app.documents.add(); // Создаем новый документ
myPage = myDoc.pages[0]; // При создании нового документа всегда есть одна страница
myTextFrame = myPage.textFrames.add(); // Добавляем на страницу текстовый фрейм
myTextFrame.geometricBounds = [100,100,200,200]; // текстовый фрейм располагаем по координатам [Y1,X1,Y2,X2]
myTextFrame.duplicate(); // Дублируем текстовый фрейм

В этом примере оба параметра опущены, в результате будет создан новый текстовый фрейм на той же странице, такого же размера и расположенный по таким же координатам, как и исходный текстовый фрейм.

Пример 2.

myDoc = app.documents.add();
myPage = myDoc.pages[0];
myTextFrame = myPage.textFrames.add();
myTextFrame.geometricBounds = [100,100,200,200];
myTextFrame.duplicate([10,20]);

В этом примере параметр «to» опущен, так что массивом [10,20] задаются координаты верхнего левого угла x, y, и его geometricBounds будут [20,10,120,110]. Новый текстовый фрейм будет располагаться на той же странице, что и исходный, так как параметр «to» не задан.

Пример 3.

myPage= app.documents.add().pages[0];
myTextFrame = myPage.textFrames.add();
myTextFrame.geometricBounds = [ 100,100,200,200] ;
myTextFrame.duplicate( myPage, [10,20] );

В этом примере задан параметр «to«, это первая страница документа, значит числа второго параметра (те, что в квадратных скобках) будут задавать смещение нового текстового фрейма относительно исходного. Новыми координатами будет массив geometricBounds [120,110,220,210];

Пример 4.

myDoc = app.documents.add();
myPage = myDoc.pages[0];
myTextFrame = myPage.textFrames.add()
myTextFrame.geometricBounds = [ 100,100,200,200] ;
secondPage = myDoc.pages.add() ;
myTextFrame.duplicate( secondPage );

В четвертом примере к документу добавляется ещё одна страница и в методе duplicate представлен только первый параметр, который указывает назначение копирования. Так как не указано местопожение текстового фрейма, то оно останется таким же как и у исходного фрейма, т.е. geometricBounds = [100,100,200,200]. Но на второй странице.

Пример 5.

myDoc = app.documents.add();
myPage = myDoc.pages[0];
myTextFrame = myPage.textFrames.add();
myTextFrame.geometricBounds = [ 100,100,200,200] ;
secondPage = myDoc.pages.add() ;
myTextFrame.duplicate( secondPage, [10,20] );

Здесь задан параметр «пункт назначения» – secondPage (2-я страница документа), следовательно, вторым параметром метода duplicate задаётся смещение координат нового фрейма относительно исходного. И его geometricBounds будут… Впрочем сосчитайте сами и проверьте.

Помещение картинки в фрейм

Итак, мы хотим поместить картинку в фрейм 185х125 мм. Объявим размеры фрейма:

myFrameWidth = 185;
myFrameHeight =125;

(единица измерения не указывается, программа работает с текущими установками.)

Картинка ‘Закат.jpg’ размещена на диске С\: в каталоге tmp. Вот как надо указать доступ к ней:

myPict = "/c/tmp/Закат.jpg"

(Моя ошибка была в том, что потерялась наклонная черта после первой кавычки. И получил сообщение:

Скрипт искал каталог С\tmp\ в папке «Мои документы»! )
Добавляем документ с выключенной опцией ‘Facing Pages’ формата А4:

app.documentPreferences.facingPages = false;
var myDoc = app.documents.add();
myDoc.documentPreferences.pageSize = "A4";

и для полноты освещения вопроса добавим еще один слой:

myDoc.layers.add();

Добавленный слой стал активным, т.е. с индексом 0. Программа сама присвоила ему имя ‘Layer 2’.
Присвоим имя слою, что был при создании документа. Сейчас индекс этого слоя 1.

myDoc.layers[1].name = "Нижний слой";

В документе по умолчанию всегда есть первая страница, и пусть ссылка на неё будет myPage1.

var myPage1 = myDoc.pages[0];

Поместим на эту страницу прямоугольник

var myPicture = myPage1.rectangles.add();

и определим его габариты. Они определяются парами координат Y и X левого верхнего и правого нижнего углов фрейма.

Ytop = 10;
Xtop = 15;
myPicture.geometricBounds = [Ytop, Xtop, Ytop + myFrameHeight, Xtop + myFrameWidth];

Поместим картинку в этот фрейм

myP = myPicture.place(File(myPict));

подгоним картинку пропорционально под размер фрейма

myPicture.fit (FitOptions.PROPORTIONALLY);
//и ставим её по центру
myPicture.fit(FitOptions.CENTER_CONTENT);

Вот что получилось:

В документе одна страница. Активен второй созданный слой Layer2. В палитре LAYERS этот слой отмечен красным цветом, поэтому контур фрейма с картинкой на этом слое тоже красного цвета. Картинка подогнана под размер фрейма и стоит по центру.

Помещение картинки на странице

Очевидно, что когда мы помещаем картинку в фрейм, он уже размещен на каком-то слое и имеет конкретные координаты. А можно поместить картинку на определенной странице в конкретный слой, и указать её координаты?
Да, можно. Будет создан фрейм с размерами, равными помещаемой картинке.
Добавляем в документ страницу, её имя будет myPage2:

var myPage2 = myDoc.pages.add();

Вот такая запись поместит картинку myPict на страницу myPage2. Координаты X и Y левого верхнего угла в этом примере [15,35] в текущих единицах измерения, и слой указан не индексом, а его именем:

myAnotherPict = myPage2.place(File(myPict),[15,35],myDoc.layers.item("Нижний слой"))[0];

Выделение картинки в фрейме

myAnotherPict — это объект Image. Чтобы добраться до фрейма, надо указать myAnotherPict.parent. Содержимое иллюстрационного фрейма — это первый и единственный объект массива allGraphics[].
Такая строка выделит картинку в фрейме:

myAnotherPict.parent.allGraphics[0].select();

Вот что получилось:

Выбрана вторая страница документа, активен «Нижний слой». Размеры созданного фрейма равны размерам рисунка. Выбран рисунок.

Поворот картинки

Подробную информацию, как в скрипте выполнять масштабирование, поворот и деформацию сдвигом можно найти в документе “Adobe InDesign CS3 Scripting: Working with Transformations in JavaScript”.
Тут только пример, как применить сведения из этой книги к повороту объекта. Объект — это выделенный объект, в нашем случае помещенная в фрейм картинка.
Идея всех таких преобразований — определить матрицу трансформации и опорную точку, относительно которой будет выполняться поворот, масштабирование, сдвиг.
Определим матрицу поворота против часовой стрелки на 45 градусов:

var myRotateMatrix = app.transformationMatrices.add({counterclockwiseRotationAngle:45});

выделенный объект (он указывается как app.selection[0]), поворачивается относительно центральной точки в соответствии с установками матрицы поворота myRotatematrix:

app.selection[0].transform(CoordinateSpaces.pasteboardCoordinates, AnchorPoint.centerAnchor, myRotateMatrix)

Курсором выделено и он оставлен на скриншоте, что угол поворота объекта отображается в панели измерений.

Вот, собственно, и весь опыт работы с иллюстрациями.
А началось всё с потерянной наклонной черты. : ))

Михаил Иванюшин

Иванюшин Михаил

Скачать «карту памяти»

var MyDocument = app.documents[0];
var obj1=MyDocument['graphicLines'].add({geometricBounds: [20, 10, 50, 80], fillColor: "C=15 M=100 Y=100 K=0", strokeWeight: 2, strokeColor: "Black" });
var obj2=MyDocument['textFrames'].add({geometricBounds: [50, 60, 80, 20], fillColor: "C=100 M=0 Y=0 K=0", strokeWeight: 5, strokeColor: "C=15 M=100 Y=100 K=0" });
var obj3=MyDocument['ovals'].add({geometricBounds: [40, 70, 100, 40], fillColor: "Black", strokeWeight: 5, strokeColor: "C=15 M=100 Y=100 K=0" });
var obj4=MyDocument['rectangles'].add({geometricBounds: [100, 90, 65, 45], fillColor: "C=0 M=0 Y=100 K=0", strokeWeight: 5, strokeColor: "C=15 M=100 Y=100 K=0" });
var obj5=MyDocument['polygons'].add({geometricBounds: [20,20, 70, 70], fillColor: "C=75 M=5 Y=100 K=0", strokeWeight: 5, strokeColor: "C=15 M=100 Y=100 K=0" });

В результате на экране будет вот такая стопа картинок:

Первый нарисованный объект, в данном случае, линия, оказался в самом низу, а многоугольник или полигон, нарисованный последним — на самом верху.
Очевидно, что строка

var obj=MyDocument['textFrames'].add(

эквивалентна

var obj=MyDocument.textFrames.add(

т.е. можно использовать тот вариант записи, который привычнее. Можно указать и страницу, на которую помещаются объекты:

var obj=MyDocument.pages[0]['textFrames']

В меню Объект > Обработка контуров (Object > Pathfinder) есть разные варианты взаимного перекрытия объектов:


Все эти опции доступны и в скриптинге.

Работа с парой объектов

1) Если, например, к написанному выше скрипту добавить строку, предписывающую выполнить исключающее перекрытие второго и третьего объектов:

compObj=obj2.excludeOverlapPath (obj3);

то результат будет такой:

Эта операция объединила второй и третий объекты — текстовый фрейм и овал, выбила их общую часть и присвоила созданному объекту цвет объекта, что был выше в стопе. В данном случае это черный цвет.
2) Добавление (add):

compObj=obj4.addPath (obj2);

Объединились второй и четвертый объекты, новый объект унаследовал цвет нижнего объекта.
3) Пересечение (intersect)

compObj=obj3.intersectPath (obj2);

Осталась общая часть текстового фрейма (объект 2) и овала (объект 3). Новый объект унаследовал цвет нижнего объекта.
4) Вычитание нижний (Minus back)

compObj=obj3.minusBack(obj5);

compObj=obj5.minusBack(obj3);

Обрабатываются овал, это объект 3 и полигон, это объект 5.
В данном случае хоть команда и называется Минус нижний, но кто из объектов будет нижним, определяется очередностью указания объектов в команде. Остается часть объекта, указанного в скобках команды minusBack. Всё, что пересекалось с объектом, указанным после знака равенства, удаляется вместе с этим объектом.
5) Составной контур (Объект > Контуры > Создать составной контур или
Object > Path > Make Compound Path)

compObj=obj2.makeCompoundPath (obj5);

Если среди объединяемых такой командой объектов есть текстовый фрейм, то созданный объект получает его цвет.

compObj=obj3.makeCompoundPath (obj5);

Работа с несколькими объектами

В приведенных выше примерах показано, как взаимодействуют два объекта.
Но можно собрать объекты в массив, и указать его в качестве второго объекта в любой из перечисленных выше операций с объектами.

var myObjArray=new Array();
myObjArray.push(obj1);
myObjArray.push(obj2);
myObjArray.push(obj3);
myObjArray.push(obj4);
myObjArray.push(obj5);
compObj=obj2.excludeOverlapPath (myObjArray);

compObj=obj2.excludeOverlapPath (myObjArray);

Тут может быть любой объект от obj1 до obj4;

compObj=obj5.excludeOverlapPath (myObjArray);

В большинстве случаев созданная фигура красится цветом верхнего объекта, как это показано на предпоследнем рисунке. Но если в качестве опорного объекта выбран верхний объект, obj5, как показано на последнем рисунке, то созданный объект красится цветом предыдущей фигуры. В нашем случае предпоследний сверху объект окрашен желтым цветом.

М.И.

Но среди обновлений нашлась такая «вкусная» тема, что жаль, если скриптописатели, листая экран с обновленным переводом, вдруг пропустят её. Поэтому расскажу об этом специально.

Итак, в инструментарии JavaScript есть класс Image, который, в свою очередь, имеет метод onDraw.

Этот метод вызывается всякий раз, когда помещается картинка:

add("image", ...)

Например, вот этот скрипт выведет на экран картинку в масштабе 100%, и величина окна будет определяться размерами картинки:

var w = new Window ("dialog");
var pict = w.add ("image", undefined, File ("/c/tmp/флаг-колокольчик.png"));
w.show ();

Если задать размеры окна, то метод onDraw поместит картинку в центр окна, но масштаб её останется 100%:

var w = new Window ("dialog");
var pict = w.add ("image", undefined, File ("/c/tmp/флаг-колокольчик.png"));
pict.size = [200,200];
w.show();

Можно ли при помещении картинки в фрейм предустановленного размера автоматически масштабировать её?
Да, и Карел приводит решение этой задачи. Автор идеи Марк Аутрет (Marc Autret), который придумал, как переопределить стандартный метод onDraw, чтобы он при помещении картинки подгонял её под размер фрейма.
Вот код:

Image.prototype.onDraw = function()
{ // written by Marc Autret
// "this" is the container; "this.image" is the graphic
if( !this.image ) return;
var WH = this.size,
wh = this.image.size,
k = Math.min(WH[0]/wh[0], WH[1]/wh[1]), xy;
// Resize proportionally:
wh = [k*wh[0],k*wh[1]];
// Center:
xy = [ (WH[0]-wh[0])/2, (WH[1]-wh[1])/2 ];
this.graphics.drawImage(this.image,xy[0],xy[1],wh[0],wh[1]);
WH = wh = xy = null;
}
var w = new Window ("dialog");
var pict = w.add ("image", undefined, File ("/c/tmp/флаг-колокольчик.png"));
pict.size = [200,200];
w.show ();

Вот результат:

Отличное решение, правда?

М. Иванюшин

В обсуждавшейся недавно теме пост 20 вывел на такую ссылку: пост 527 и 528. Этот пример организации прогрессбара стал мне знаком после перевода на русский язык руководства Питера Карела по интерефейсу скриптов:

Элемент интерфейса progressbar (индикатор выполнения задания)

Этот элемент управления используется для вывода на экран одной или нескольких линий, отображающих ход исполнения задания. В основе простая идея — длительность линии и время исполнения скрипта связаны между собой. Пока не было лучшего примера использования этого инструмента, кроме скрипта Марка Аутрета (Marc Autret). Вот код этого скрипта: (далее идет код, на который ссылается упомянутый ранее пост 527).

Для меня слова Карела «Пока не было лучшего примера использования этого инструмента, кроме скрипта Марка Аутрета» стали аргументом сделать этот скрипт своим инструментом, и он уже успешно используется в нескольких последних программах. Приглашаю всех скриптописцев попробовать его в деле. Карел прав — этот скрипт действительно лучший.

Скрипт отображения прогрессбара. Инструкция по эксплуатации

Что делает каждая из строк

Исходный скрипт был несколько видоизменен, и вот объяснение его организации:

var ProgressBar = function(title)
{
var w = new Window('palette', title, {x:0, y:0, width:640, height:60},{closeButton: false}),
pb = w.add('progressbar', {x:20, y:32, width:600, height:12}),
st = w.add('statictext', {x:20, y:12, width:600, height:20});
st.justify = 'left';
w.center();
this.reset = function(msg,maxValue) {
st.text = msg;
pb.value = 0;
pb.maxvalue = maxValue;
w.show();
};
this.hit = function() {++pb.value;};
this.hide = function() {w.hide();}; // эта функция гасит окно процесса исполнения задания
this.close = function() {w.close();};
}

this здесь — ключевое слово, указывающее на владельца исполняемой функции, в данном случае ProgressBar.

1 — объявление функции, titul — передаваемый параметр.

3 — окно типа palette шириной 640 и высотой 80 точек, кнопка закрытия окна отключена.

4 — строка, определяющая геометрические размеры и положение прогрессбара внутри окна, определенного строкой выше.

5 — определено место информационной строки. Её положение определено так, что она появится над полосой прогрессбара.

6 — выравнивание строки влево

7 — выравнивание объявленного в строке 3 окна по центру экрана

8 — сброс отображения прогрессбара. Параметры этой функции — сообщение и максимальное значение.

9 — Сообщение из параметров предыдущей строки выводится в поле окна, определенном в 4-й строке.

10 — определено начальное значение прогрессбара.

11 — определено максимальное значение прогрессбара, это второй параметр функции из строки 8

12 — включение отображения окна

14 — функция пошагового наращения текущего значения шкалы

15 — функция скрытия окна

16 — функция закрытия окна

Примечание. Если интересно, в чем состоит изменение исходного кода, так вот описание:

а) добавлено условие {closeButton: false} в строке 3. Сделано по той причине, что коль скоро невозможно щелчком на красном крестике закрыть это окно в процессе исполнения задания, то и пиктограммы быть не должно.

б) в оригинале строка 4 выглядит так: pb = w.add(‘progressbar’, {x:20, y:12, width:300, height:12}, 0, 100), но эти 0, 100 смысла не имеют.

в) в оригинале 11 строка выглядит так: pb.maxvalue = maxValue||0. Т.е. если maxValue определено, его значение присваивается переменной pb.maxvalue. Если не определено, этой переменной присваивается нулевое значение. На мой взгляд, это ненужное усложнение кода. Во-первых, если предполагается воспользоваться этим индикатором, то значение maxValue будет определено. Во-вторых, мало проку иметь для pb.maxvalue нулевое значение.

г) вообще убрана строка pb.visible = !!maxValue; не вижу смысла управлять видимостью шкалы. Если скрипт запускается, прогрессбар должен быть виден всегда.

Как его использовать

Вот несколько строк работающего кода:

var myProgramTitul = " Что для иностранца progressbar, то для русского градусник  ";
var pBar = new ProgressBar(myProgramTitul);
pBar.reset(" Задание выполняется... " , 150);
for( i=0 ; i < 150; ++i, pBar.hit())  { // обращение к функци pBar.hit()
…
}
pBar.close();

… и комментарий этих строк:

1 — определен заголовок окна с прогрессбаром;

2 — обращение к описанной выше функции ProgressBar

3 — сброс прогрессбара. Вот пример работы упомянутого ранее ключевого слова this: определив в строке прогресс бар с именем pBar, определив в скрипте this.reset = function(msg,maxValue), тут пишем pBar.reset(» Задание выполняется… » , 150), и в окне этого прогрессбара будет выведено сообщение » Задание выполняется… «, и максимальное значение прогрессбара установлено равным 150.

4 — в цикле for, в поле изменения счетчика цикла ++i через запятую указано обращение к функции pBar.hit(), которая при каждом вызове её наращивает длину полосы на один шаг.

Вот, собственно, и всё! Весь интерфейс скрипта как на ладони!

Этот пример в файле gradusnik.jsx, дорабатывайте его под свои задачи — добавьте строки в свой скрипт, сделайте свой заголовок окна прогрессбара (в моем примере это переменная myProgramTitul) и свое сообщение, выводимое в окне (текстовая переменная в третьей строке), и получите замечательный градусник!

Ну а когда всё так просто, почему бы не покуролесить, не попробовать найти другие варианты использования этого инструмента? : ))

А можно двигать полоску не вперед, а назад?

В скрипте gradusnik1.jsx, полоска сперва нарастает, двигаясь слева направо, а затем уменьшается справа налево. Сделано это с помощью введения новой функции сброса this.reset_dn, устанавливающей начальное значение прогрессбара в максимальное значение, и в цикле for при наращении переменной вызывается функция this.decr(), пошагово уменьшающая длину прогрессбара: this.decr = function() {–pb.value;}

А можно в одном окне отображать несколько процессов?

Хороший вопрос, на который есть утвердительный ответ.

Действительно, мы определили текстовое поле st для вывода названия процесса, и переменную pb для графического отображения состояния этого процесса. А кто мешает сделать несколько таких пар параметров в одном окне? Например, первая пара отображала бы общее число заданий, а вторая — состояние исполнения текущего задания.

Такая задача решена в скрипте gradusnik2.jsx.

Если изменить значение переменной SecDirectionR2L на true, то в процессе демонстрации полоса второго уровня будет ползти справа налево.

Михаил Иванюшин

Скачать скрипты прогрессбара

P.S.

Обязательна ли инструкция #targetengine?

Справочное руководство по скрипам, описывая демонстрационный пример прогрессбара, предписывает включать эту инструкцию. Но на самом деле и без неё всё работает. Использование этого оператора имеет смысл, если несколько скриптов используют один и тот же прогрессбар.

Я до этого думал, что там только один хронический баг — потеря сносок. Мы на сайте не раз об этом говорили. Но оказалось, есть еще недоделки.

Вот последовательность шагов, как добраться до этих граблей:

1) сохраните на машине этот скрипт:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

#target indesign
#targetengine "session"
FRAME_TO_CONTENT = 1718906723
app.documents[0].textFrames[0].insertionPoints[0].select();
var mySelection = app.selection[0];
var myWin = myDialog();
myWin.show();
 
/////////
 
function myDialog() { // myDialog
var myWindow = new Window ("palette", "Проблема с обработкой текста");
myWindow.orientation = "column";
var myButtonGroup = myWindow.add ("panel");
myButtonGroup.alignment = "center";
myButtonGroup.orientation = "row";
myOKButon = myButtonGroup.add ("button", undefined,"Втиснуть текст в фрейм", {name:"OK"});
myCancelButon = myButtonGroup.add ("button", undefined,"Завершить", {name:"cancel"});
myCancelButon.onClick = function() { // myCancelButon.onClick
myWindow.close();
exit();
} // myCancelButon.onClick
 
myOKButon.onClick = function() { // myOKButon.onClick
app.documents[0].textFrames[0].select();
app.documents[0].textFrames[0].fit(FRAME_TO_CONTENT);
} // myOKButon.onClick
return myWindow;
} // myDialog

2) Откройте новую работу, нарисуйте текстовый фрейм, напишите в нем чего-нибудь.

3) Оставьте курсор в тексте и запустите скрипт из п. 1. Что мы видим? На экране окно диалога, в текстовом блоке мигает курсор, набирай — не хочу! Но попробуйте ввести текст — у вас ничего не выйдет!!

Это открытое окно перехватывает всю работу с клавиатурой. В сравнении с этим поведением окна, в CS5 при попытке ввода текста это открытое окно чуточку гаснет, становясь неактивным, после чего можно вводить текст. Окно станет активным опять после щелчка на нем или на одной из кнопок.

Вот такие грабли в полный рост.

Если кто знает, как средствами JavaScript обойти эту засаду, сообщите, благодарность моя будет не знать границ в разумных пределах — я скажу Вам спасибо на нашем сайте. : ))

Но пока я нашел такое решение: щелчок курсором в любом из полей панели измерений, например, в окне названия шрифта или поле размера буквы, делает это окно неактивным и можно работать с текстом.

Вот такие дела.

М.И.

#targetengine "session"

Она предписывает  сохранять на время сеанса работы программы InDesign все переменные скрипта, в котором использовалась  эта инструкция. И слово ‘session’ в этой записи вовсе не термин языка javascript. : )  На самом деле во время одного сеанса программы может быть объявлено несколько движков (этим словом часто переводят слово engine) исполнения скриптов, и на ‘session’ свет клином не сошелся, каждому движку можно присваивать своё имя.

Вот простейшие примеры, объясняющие это.

target1.jsx

// Скрипт присваивает движку имя script1.
//В рамках этого движка определяется переменная a1
#target indesign
#targetengine "script1"
var a1 =11;
alert ("Активизирован движок targetengine 'script1'.\nОпределена переменная 'a1', её значение 11.");
exit();

target2.jsx

// Скрипт присваивает движку имя script2.
// В рамках этого движка определяется переменная a2
#target indesign
#targetengine "script2"
var a2 =22;
alert ("Активизирован движок targetengine 'script2'.\nОпределена переменная 'a2', её значение 22.");
exit();

SetEngine1AndAskVariables.jsx

// Скрипт объявляет, что будет работа в рамках движка script1.
// Затем пытается вывести на экран переменные а1, а2, а3
#target indesign
#targetengine "script1"
var tt = 0;
var b;
alert ("#targetengine script1");
try {b = a1}
catch (e) { alert ("Переменная a1 не определена"); tt=1;}
if (tt == 0) alert ("a1 = " + a1);
tt = 0;
try {b = a2}
catch (e) { alert ("Переменная a2 не определена"); tt=1;}
if (tt == 0) alert ("a2 = " + a2);
tt = 0;
try {b = a3}
catch (e) { alert ("Переменная a3 не определена"); tt=1;}
if (tt == 0) alert ("a3 = " + a3);
exit();

SetEngine2AndAskVariables.jsx

// Скрипт объявляет, что будет работа в рамках движка script2.
// Обратите внимание, имя активного движка можно выводить с помощью инструкции $.engineName
// Затем пытается вывести на экран переменные а1, а2, а3
#target indesign
#targetengine "script2"
var tt = 0;
var b;
alert ("#targetengine " + $.engineName);
try {b = a1}
catch (e) { alert ("Переменная a1 не определена"); tt=1;}
if (tt == 0) alert ("a1 = " + a1);
tt = 0;
try {b = a2}
catch (e) { alert ("Переменная a2 не определена"); tt=1;}
if (tt == 0) alert ("a2 = " + a2);
tt = 0;
try {b = a3}
catch (e) { alert ("Переменная a3 не определена"); tt=1;}
if (tt == 0) alert ("a3 = " + a3);
exit();

target2&newVariable.jsx

// В рамках движка script2 определяется переменная a3
#target indesign
#targetengine "script2"
var a3 =33;
alert ("Активизирован движок targetengine 'script2'.\nОпределена переменная 'a3', её значение 33.");
exit();

Запустите InDesign, затем из панели скриптов выполните скрипт target1.jsx, затем target2.jsx. По идее, это должно в рамках программы активизировать два движка, script1 и script2, и по одной переменной в каждом из движков — в первом а1, во втором а2.
Давайте теперь запуском скриптов из панели Scripts убедимся, что так и есть.
Выполним скрипт SetEngine1AndAskVariables.jsx. Он попробует в рамках движка script1 вывести все переменные, окажется, что доступна только определенная ранее в рамках этого движка а1. Скрипт SetEngine2AndAskVariables.jsx попробует ввести все переменные в рамках движка script2, но окажется, что доступна только а2.
При запуске обоих последних скриптов упоминалась не определенная нигде переменная а3. Давайте определим её и попробуем вывести. Скрипт target2&newVariable.jsx определяет её в рамках движка script2 и делает равной 33.
Теперь при запуске скрипта SetEngine2AndAskVariables.jsx на экран будет выведено значение а2 и а3. Как видите, в рамках движка дополнительные скрипты могут добавлять в перечень переменных движка новые экземпляры.
Если всё, что вы только что прочитали, для вас в новинку, то, думаю, вы удивитесь ещё больше, если я скажу, что в разработке скриптов есть ситуация, когда всё, описанное выше, не работает.
При запуске любого из этих скриптов в отладчике ExtendedScript Toolkit 2, он в основном используется при разработке скриптов для inDesign CS3, на экран будет выведено сообщение о невозможности выполнить скрипт в выбранном движке. (В каком-то из релизов этой программы выводилось усеченное сообщение “Cannot execute”, без уточнения.)

Если запустить ExtendedScript Toolkit 4, это отладчик для InDesign CS4, то при выполнении скриптов target1.jsx и target2.jsx такого сообщения не будет, и скрипт SetEngine1AndAskVariables.jsx верно сообщит название движка, но о всех переменных скажет, что они undefined!
Прелестные грабли для начинающих скриптописателей, не правда ли?
Такое может напрочь отбить охоту заниматься скриптами.  : ((
Причина такой работы программ в том, что эти версии отладчиков работают только с ранее запущенными движками, запуск нового движка из отладчика не предусмотрен.
Поэтому, чтобы движки работали в отладчике, надо сперва активизировать их запуском target1.jsx и target2.jsx. из панели скриптов. После этого SetEngine1AndAskVariables.jsx, и SetEngine2AndAskVariables.jsx будут работать верно.
Доступные для отладчика движки показаны списке движков, вот, после запуска из панели скриптов программы target1.jsx в этом меню появился script1:

Очевидно, поскольку по умолчанию используется движок main, эту недоработку можно обойти, указав в скрипте

#targetengine "main".

В версии InDesign CS5 этой ошибки уже нет: указанный в инструкции #targetengine движок сразу появляется в том списке движков.

М.И.

Класс Link имеет метод unembed(), позволяющий извлечь линк из документа и сохранить отдельным файлом или перелинковать с существующим файлом. То есть, если файла в папке назначения не существует, то InDesign создаст новый (извлекая его из документа). Причем файл хранится в документе целиком – если на одном компьютере внедрить psd со слоями, а на другой машине извлечь, то вы получите точно такой же файл! Все это замечательно, но вполне понятно, что это не лучший метод хранения файлов, поскольку размер файла верстки очень быстро растет, что в свою очередь замедляет работу с ним и создает вероятность ошибок.

Скрипт работает так:

// ищем первый линк в документе
var myLink = app.activeDocument.links[0];
// проверить статус внедрения
$.writeln(myLink.status == LinkStatus.LINK_EMBEDDED);
// извлечь в папку по умолчанию
myLink.unembed();
// извлечь в отдельную папку
// если файл существует, то он будет переписан извлеченным файлом
var myDest = Folder("/c/myDestination");
myLink.unembed(myDest);

А вот скрипт, который перед тем как извлечь линки, спросит куда именно это сделать. И если вдруг окажется, что в папке назначения файл уже существует, то скрипт просто создаст связь с ним, вместо того, чтобы переписать файл поверх существующего (что происходит по умолчанию в методе unembed()). Просто и легко!

Автор скрипта – Marijan Tompa

Взято отюда

Скачать UnEmbedAllLinks.jsx (zip)

Материал подготовил Stacco