diff --git a/reference/ps/functions/ps-begin-page.xml b/reference/ps/functions/ps-begin-page.xml new file mode 100644 index 000000000..0cda0fd49 --- /dev/null +++ b/reference/ps/functions/ps-begin-page.xml @@ -0,0 +1,128 @@ + + + + + + ps_begin_page + Начинает новую страницу + + + + &reftitle.description; + + boolps_begin_page + resourcepsdoc + floatwidth + floatheight + + + Начинает новую страницу. Хотя параметры width + и height подразумевают различный размер страницы для каждой страницы, + это невозможно в PostScript. Первый вызов ps_begin_page устанавливает размер страницы + для всего документа. Последующие вызовы не будут иметь никакого эффекта, кроме создания новой страницы. + Ситуация иная, если вы собираетесь преобразовать документ PostScript в PDF. Функция помещает в документ метки PDF, + которые могут индивидуально устанавливать размер каждой страницы. + Полученный PDF-документ будет иметь разные размеры страниц. + + + Хотя PostScript не знает разных размеров страниц, pslib помещает в документ ограничительную рамку для каждой страницы. + Этот размер оценивается некоторыми программами просмотра PostScript и имеет приоритет над BoundingBox в заголовке документа. + Это может привести к неожиданным результатам, если вы установите BoundingBox, нижний левый угол которого не равен (0, 0), + потому что у ограничивающей рамки страницы всегда будет нижний левый угол (0, 0) и перезапишет глобальную настройку. + + + Каждая страница инкапсулируется в режим сохранения/восстановления. Это означает, что большинство настроек, + сделанных на одной странице, не будут сохранены на следующей странице. + + + Если до первого вызова ps_begin_page не было вызова ps_findfont, + то будет выведен заголовок документа PostScript, а размер ограничивающей рамки будет установлен на первая страница. + Нижний левый угол ограничивающей рамки установлен в (0, 0). + Если ps_findfont была вызвана раньше, значит, заголовок уже был выведен + и документ не будет иметь корректной ограничительной рамки. + Чтобы предотвратить это, следует вызвать ps_set_info, чтобы установить + информационное поле BoundingBox и, возможно, Orientation + перед любым вызовом ps_findfont или + ps_begin_page. + + + + До версии 0.2.6 pslib функция всегда будет перезаписывать BoundingBox и Orientation, + если они была установлены ранее с помощью ps_set_info + и ps_findfont ранее не вызывалась. + + + + + + &reftitle.parameters; + + + + psdoc + + + Идентификатор ресурса файла postscript, + возвращённый функцией ps_new. + + + + + width + + + Ширина страницы в пикселях, например, 596 для формата А4. + + + + + height + + + Высота страницы в пикселях, например, 842 для формата А4. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + + ps_end_page + ps_findfont + ps_set_info + + + + + + diff --git a/reference/ps/functions/ps-begin-pattern.xml b/reference/ps/functions/ps-begin-pattern.xml new file mode 100644 index 000000000..97f07e175 --- /dev/null +++ b/reference/ps/functions/ps-begin-pattern.xml @@ -0,0 +1,171 @@ + + + + + + ps_begin_pattern + Начинает новый узор + + + + &reftitle.description; + + intfalseps_begin_pattern + resourcepsdoc + floatwidth + floatheight + floatxstep + floatystep + intpainttype + + + Начинает новый узор. Узор похож на страницу, содержащую, например, рисунок, + который можно использовать для заливки областей. Он используется как цвет, + вызывая ps_setcolor и устанавливая + цветовое пространство в pattern. + + + + + &reftitle.parameters; + + + + psdoc + + + Идентификатор ресурса файла postscript, + возвращённый функцией ps_new. + + + + + width + + + Ширина узора в пикселях. + + + + + height + + + Высота узора в пикселях. + + + + + x-step + + + Расстояние в пикселях размещений узора по горизонтали. + + + + + y-step + + + Расстояние в пикселях размещений узора по вертикали. + + + + + painttype + + + Может быть 1 или 2. + + + + + + + + + &reftitle.returnvalues; + + Идентификатор узора&return.falseforfailure;. + + + + + &reftitle.examples; + + + Создание и использование узора + + +]]> + + + + + + + &reftitle.seealso; + + + ps_end_pattern + ps_setcolor + ps_shading_pattern + + + + + + diff --git a/reference/ps/functions/ps-begin-template.xml b/reference/ps/functions/ps-begin-template.xml new file mode 100644 index 000000000..4c2334168 --- /dev/null +++ b/reference/ps/functions/ps-begin-template.xml @@ -0,0 +1,140 @@ + + + + + + ps_begin_template + Начинает новый шаблон + + + + &reftitle.description; + + intps_begin_template + resourcepsdoc + floatwidth + floatheight + + + Начинает новый шаблон. На языке postscript шаблон называется формой. + Он создаётся аналогично узору, но используется как изображение. + Шаблоны часто используются для рисунков, которые размещаются в документе несколько раз, + например как логотип компании. В шаблоне можно использовать все функции рисования. + Шаблон не будет нарисован, пока он не будет размещён с помощью ps_place_image. + + + + + &reftitle.parameters; + + + + psdoc + + + Идентификатор ресурса файла postscript, + возвращённый функцией ps_new. + + + + + width + + + Ширина шаблона в пикселях. + + + + + height + + + Высота шаблона в пикселях. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.examples; + + + Создание и использование шаблона + + +]]> + + + + + + + &reftitle.seealso; + + + ps_end_template + + + + + + diff --git a/reference/ps/functions/ps-circle.xml b/reference/ps/functions/ps-circle.xml new file mode 100644 index 000000000..670002115 --- /dev/null +++ b/reference/ps/functions/ps-circle.xml @@ -0,0 +1,107 @@ + + + + + + ps_circle + Рисует круг + + + + &reftitle.description; + + boolps_circle + resourcepsdoc + floatx + floaty + floatradius + + + Рисует круг со средней точкой в точке (x, + y). Круг начинается и заканчивается в позиции (x+radius, + y). + Если функция вызывается вне пути, она начнёт новый путь. Если функция вызывается внутри пути, она добавит круг как дочерний путь. + Если последняя операция рисования не заканчивается точкой (x+radius, + y), тогда на пути будет разрыв. + + + + + &reftitle.parameters; + + + + psdoc + + + Идентификатор ресурса файла postscript, + возвращённый функцией ps_new. + + + + + x + + + Координата X центра круга. + + + + + y + + + Координата Y центра круга. + + + + + radius + + + Радиус круга. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + + ps_arc + ps_arcn + + + + + + diff --git a/reference/ps/functions/ps-get-buffer.xml b/reference/ps/functions/ps-get-buffer.xml new file mode 100644 index 000000000..2d34d27ea --- /dev/null +++ b/reference/ps/functions/ps-get-buffer.xml @@ -0,0 +1,71 @@ + + + + + + ps_get_buffer + Получает полный буфер, содержащий сгенерированные данные PS + + + + &reftitle.description; + + stringps_get_buffer + resourcepsdoc + + + Функция пока не реализована. Она всегда будет возвращать пустую строку. + Идея для более поздней реализации состоит в том, чтобы записать содержимое файла postscript + во внутренний буфер, если требуется создание в памяти, и получить содержимое буфера с помощью этой функции. + В настоящее время документы, созданные в памяти, отправляются в браузер без буферизации. + + &warn.undocumented.func; + + + + &reftitle.parameters; + + + + psdoc + + + Идентификатор ресурса файла postscript, + возвращённый функцией ps_new. + + + + + + + + + &reftitle.seealso; + + + ps_open_file + + + + + +