Установка
Регистрация
Соглашения о структурировании документа (DSC)
Формат PDF
Открытие документа
Выбор страницы
Информация о документе
Печать
Conversions
Measure
Options
Page Orientation
Display Settings
Page Size
Keys
Command line options
World Wide Web
Copyright
Common Problems
Other Help Topics
Кроме того, необходимо отдельно установить Ghostscript.
Если нужно установить GSview вручную, см. топик Установка вручную.
При первом запуске GSview будет произведена настройка. Если вы позднее захотите изменить настройки, то используйте Настройка | Расширенная настройка.
См. также Настройка | Язык.
Получение Ghostscript
Установка Ghostscript
Удаление GSview
Установка вручную
Расширенная установка вручную
http://www.cs.wisc.edu/~ghost/
Чтобы настроить GSview, загрузите и установите оба, Ghostscript и GSview, а затем запустите GSview.
Более подробную информацию см. топик Расширенная установка вручную.
Если у вас в системе имеются шрифты Type 1, то Ghostscript может их использовать. Пример см. в файлах Fontmap.os2 и Fontmap.atm и топик Шрифты.
Если у вас возникли проблемы, попробуйте прочитать топик Общие проблемы.
В настоящее время плата за регистрацию составляет 40 австралийских долларов (AUD$40). GSview можно зарегистрировать по адресу
http://www.ghostgum.com.au/
или заполнив и отправив факсом или по почте регистрационную форму, которая находится в файле regorder.txt в каталоге GSview. Ghostgum Software предпочитает регистрацию через Интернет.
Если файл не содержит комментариев DSC, GSview может показывать страницы только оригинальном порядке.
Файл, который удовлетворяет DSC, начинается с комментария
%!PS-Adobe-3.0
где номер 3.0 может изменяться и говорит о версии DSC. Некоторые программы записывают PostScript-файл с символом control-D в начале, за которым идёт комментарий, упомянутый выше. GSview правильно сообщает, что такие файлы не удовлетворяют DSC, но возможность выбора страниц сохраняется. Сообщите об этом автору программы, которая создала PostScript-файл. Чтобы файл удовлетворял DSC, удалите символ control-D из начала файла.
Файлы, соответствующие DSC содержат строки подобные
%%Pages: 24 %%Page: 1 1
Эти строки говорят GSview сколько страниц содержится в документе и где они начинаются. GSview использует эту информацию для выбора отдельных страниц.
Инкапсулированные PostScript-файлы (EPSF) -- одностраничные документы, которые содержат подмножество комментариев DSC и команд PostScript. EPS-файлы начинаются со строки комментария:
%!PS-Adobe-3.0 EPSF-3.0
Обычно EPS-файлы используются для включения в другие документы и поэтому требуют включения комментария о граничной рамке (bounding box):
%%BoundingBox: llx lly urx ury
где llx, lly, urx и ury -- целые представляющие собой координаты x и y нижнего левого и правого верхнего углов граничной рамки, которая охватывает все элементы рисунка на странице.
Некоторые EPS-файлы содержат превью PostScript-документа. Это может быть метафайл Windows, файл TIFF или в формате Interchange (формат EPSI). В случае метафайла Windows или TIFF, EPS-файл в DOS содержит двоичный заголовок, в котором указано положение и длины превью, а также раздел EPS-файла на языке PostScript. В случае формата Interchange превью содержится в комментариях, которые начинаются со строк
%%BeginPreview: ширина высота глубина строки
EPS-файл с превью можно создать из EPS-файла без превью при помощи команды Добавить EPS превью.
GSview может сообщать о некорректных комментариях DSC. Это можно изменить командой Настройка | Предупреждения DSC.
При показе GSview игнорирует размер страницы в меню Бумага и вместо этого использует параметр /MediaBox из PDF-файла. Если включена опция Настройка | Границы EPS, GSview будет использовать /CropBox из PDF.
Чтобы сосчитать страницы в PDF-файле, его нужно открыть командой Открыть. Если будет использована команда Выбрать файл, то GSview не сможет использовать команды Извлечь текст, Найти, Перейти к странице и другие, для которых необходимо знать количество страниц в документе.
Поддержка переходов по pdfmark недоработана.
Для конвертирования PostScript-файла в PDF используйте команду Файл | Конвертировать и устройство pdfwrite.
Для конвертирования PDF-файла в PostScript используйте команду Файл | Конвертировать и устройство pswrite.
Команда Файл | Извлечь не работает с файлами PDF. Страницы извлекаются в формате PostScript, а не в PDF.
Для пакетного конвертирования нескольких файлов см.
ps2pdf.
Если файл содержит комментарии DSC, страницы можно выбирать при помощи команд Следующая страница, Предыдущая страница и Перейти к странице.
Если файл не содержит комментариев DSC, команды Предыдущая страница и Перейти к странице работать не будут. Не следует выбирать другой файл пока не будет показана последняя страница.
Когда файл открыт, GSview показывает имя файла, номер текущей страницы (если доступна) и, когда курсор находится над изображением, его положение в координатах указанных командой Настройка | Единицы измерения. Координаты могут быть в поинтах (1/72 дюйма), миллиметрах и дюймах (дюймы -- английские). Положение курсора удобно при вычислении граничной рамки.
Команда Выбрать файл похожа на Открыть, но она не показывает документ. Эта команда полезна для открытия документа для последующей печати.
Команда Сохранить как сохраняет копию текущего документа. Это полезно, если GSview используется в качестве программы просмотра PostScript другим приложением, и вы хотите сохранить документ, который просматриваете.
Команда Закрыть закрывает открытый документ. Её следует использовать перед тем, как другая программа изменит файл. Если этого не сделать, и GSview определит, что длина файла или его дата изменились, он закроет Ghostscript и загрузит документ заново.
См. также Печать.
Команда Просмотр | Предыдущая страница или клавиша - открывает предыдущую страницу.
Команда Просмотр | Обновить или клавиша F5 показывает текущую страницу заново.
Команда Просмотр | Перейти к странице или кнопка указывающая рука открывает диалоговое окно, в котором можно указать номер страницы для перехода. Диалог Выбор страницы показывает метки страниц, т.к. они более полезны, чем порядковые номера.
Команда Просмотр | Следующая страница и вверх или клавиша Пробел используется для перехода к верху следующей страницы.
Команда Просмотр | Предыдущая страница и вверх или клавиша BkSp используется для перехода к верху предыдущей страницы.
Команды Предыдущая страница, Обновить и Перейти к странице работают только при наличии в документе комментариев DSC.
Команда Просмотр | По размеру окна или клавиша F6 изменяет разрешение просмотра так, чтобы вся страница умещалась в окне. Повторное использование команды умещает страницу в окне либо по ширине, либо по высоте.
Команда Просмотр | Полноэкранный режим или клавиша F4 показывает страницу на всём экране (без заголовка, полос прокрутки и т.д.). Для возврата к нормальному режиму нажмите клавишу Escape.
Команда Информация в меню Файл открывает диалоговое окно со следующей информацией о комментариях DSC в текущем документе.
Файл -- полное имя файла документа.
Тип -- DSC, EPS, Комментариев DSC нет или Комментарии DSC игнорируются. EPS -- это инкапсулированный PostScript-файл, одностраничный документ, который содержит подмножество комментариев DSC и команд PostScript. EPS обычно используется для включения в другие документы. Комментарии DSC игнорируются показывается, когда выбрано Настройка | Игнорировать комментарии DSC. Этой информации могут предшествовать строки За Ctrl-D следует или За PJL следует. Обе указывают, что документ не соответствует DSC, потому что в начале файла имеется ненужная информация. Как исправить первое см. Общие проблемы. Чтобы избавиться от последнего, не используйте драйвер HP LaserJet при создании документов, которые вы собираетесь кому-то передавать.
Заголовок -- текст, который может быть использован при печати титульных страниц и для маршрутизации или при распознавании документа.
Дата -- время создания документа.
BoundingBox (габариты) -- минимальный прямоугольник, который охватывает все элементы рисунка на странице. Четыре целых числа -- это координаты левого нижнего и правого верхнего углов граничной рамки в пользовательских координатах по умолчанию (1/72 английского дюйма).
Ориентация -- ориентация страницы по умолчанию, может быть Книжная или Альбомная. См. меню Ориентация.
Порядок страниц -- одно из: По возрастанию, По убыванию или Специальный. Если Порядок страниц -- По убыванию, GSview автоматически изменит порядок страниц при показе или печати так, чтобы они располагались в возрастающем порядке. При извлечении или печати можно указать GSview печатать в убывающем (обратном) порядке. Специальный означает, что порядок страниц изменить нельзя.
Размер бумаги -- название формата бумаги, за которым следует ширина и высота листа в пользовательских координатах по умолчанию (1/72 дюйма).
Всего страниц -- количество страниц в документе.
Страница -- метка страницы и её порядковый номер.
Битмэп -- размер показанной картинки в пикселах, который может быть полезен при копировании картинки в буфер обмена.
выовод на программу, которая управляет очередью печати. Могут быть напечатаны все, отдельные или любая комбинация старниц. Кнопки Все, Нечётные и Чётные позволяют быстро выбрать нужные страницы. Если выбран один непрерывный интервал страниц, то кнопки Нечётные и Чётные выбирают нечётные и чётные страницы в заданном интервале. Установленный флажок В обратном порядке позволяет печатать по убыванию номеров страниц.
Если используется PostScript принтер, выбранные страницы будут напрямую направлены в очередь принтера, без использования Ghostscript. Это похоже на команду Файл | Печатать файл за исключением того, что здесь можно указать страницы, которые нужно напечатать. Если выбран PostScript принтер, кнопка Дополнительно позволит указать пролог и эпилог, которые будут помещены при печати до и после PostScript-файла.
Список доступных устройств и разрешений хранится в секции [Devices] файла
~/.gsview.ini
Неполный список устройств и их разрешений взят из стандартной версии Ghostscript 6.0.
Для печати документа без его показа открывайте документ командой Выбрать файл.
Если вы хотите создать битмэп-файл, то используйте драйверы bmpmono, bmp16, bmp16m или bmp256.
Команда Файл | Печатать файл выводит файл прямо в локальный порт. Это полезно для отправки документа на PostScript-принтер или для печати файла, созданного Ghostscript для принтера.
Для управления тем, как GSview обрабатывет запросы PosstScript и PDF файлов на изменение размера страницы см. топик Подбор размера страницы.
Поле Опции содержит опции командной строки Ghostscript для данного устройства.
Кнопка uniprint выбирает устройство uniprint и предоставляет список доступных конфигурационных файлов (*.upp) для данного устройства. Если вы выберете один из них, его название будет помещено в поле Опции в диалоге Настройка принтера. Как конфигурировать устройство uniprint см. файл Devices.htm из поставки Ghostscript.
В диалоговом окне Установка принтера вам нужно указать в очередь какого принтера вы отправяете задание. Эта очередь будет использоваться в следующий раз.
О сомместимости принтеров см.
http://www.cs.wisc.edu/~ghost/doc/printer.htm
PostScript принтер
Свойства
Page Size Matching
Иногда, когда PostScript-принтер присоединён к последовательному порту, бывает нужно передать символ Ctrl+D после PostScript-файла, и, в зависимости от правильности поведения других программ, перед. Это -- часть протокола соединения по последовательному порту, который используется в этих принтерах, но не часть PostScript. При использовании драйвера PostScript принтер можно указать, нужно ли посылать символ Ctrl+D до или после PostScript-файла.
Некоторые PostScript-принтеры могут обрабатывать несколько языков управления и требуют пролога для перехода в режим PostScript. Например, принтеры HP LaserJet (с PostScript-платой) требуют следующий пролог:
^[%-12345X@PJL JOB @PJL ENTER LANGUAGE = POSTSCRIPT
и следующий эпилог:
^[%-12345X@PJL EOJ ^[%12345X
Файлы пролога и эпилога можно посылать до и после PostScript-файла.
Смещение страницы можно указать для каждого устройства. Это полезно для коррекции разницы между началом координат драйвера принтера Ghostscript и конкретным принтером. Увеличение значения X смещает изображение вправо. Увеличение значения Y обычно перемещает изображение вниз.
Диалог Свойства часто используется для установки параметра BitsPerPixel для цветных принтеров и других настроек коррекции тона и цвета, а также параметров PDF.
Свойства специфичны для каждого устройства. Изменение значения параметра BitsPerPixel для одного устройства никак не отразится на его значении для других.
Когда вы нажимаете кнопку OK в диалоге Свойства, текущие значения записываются в файл ~/.gsview.ini.
В GSview некоторые Свойства предопределены, но могут не совпадать с такими же в Ghostscript. Кнопки Правка и Новое позволяют изменить доступные Свойства для данного устройства. Подробнее см. в топике Редактирование свойств.
Not every device supports the use of optional Properties. To find out which devices support Properties and which Properties are recognised by each device, read the Ghostscript file Devices.htm or look at the Ghostscript source code.
There are two ways to add or edit Properties.
The first method uses the Edit or New button on the Properties dialog box.
Each property must be either a number or a string. Number properties are equivalent to the Ghostscript -d command line option. String properties are equivalent to the Ghostscript -s command line option. Each property consists of a Name and Value. These are used as -dNAME=VALUE or -sNAME=VALUE. The Value is chosen from the comma separated list of Values entered into the Edit Properties dialog box. Spaces must not be embedded in the Name or Values.
To delete a property, select it on the Properties dialog box, then press Edit, then press the Delete button on the Edit Properties dialog box.
The second method is to manually edit the GSview INI file.
For each device, you must add two sections to the ~/.gsview.ini file. The following example shows how to add property information for the cdjcolor driver. First add a section which gives the current values. This section, after the first character is removed, gives the options that will appear in the Property list box. The first character is s for string or d for number.
[cdjcolor] dBitsPerPixel=24 dDepletion=1 dShingling=2 dBlackCorrect=4
Next add a section which gives the values to display in the Value list box.
[cdjcolor values] dBitsPerPixel=1,3,8,16,24 dDepletion=1,2,3 dShingling=0,1,2 dBlackCorrect=0,1,2,3,4,5,6,7,8,9
GSview will also add the value [Not defined] to the listbox.
When GSview prints a file, it will give Ghostscript the contents of the [cdjcolor] section of ~/.gsview.ini as follows:
-dBitsPerPixel=24 -dDepletion=1 -dShingling=2 -dBlackCorrect=4
If the value of a property is [Not defined], that property will not be sent to Ghostscript.
If Shrink to fit Page Size is selected, any page size selected by the document that is larger than the selected media will be shrunk to fit the page size on the Media menu. This is useful if you want to print an A4 sized page on letter paper (although a better idea is to buy A4 paper).
If Variable Page Size GSview will set the default page size from the Media menu, but allow the page size to be changed.
File | Convert uses Ghostscript to convert PostScript or PDF to bitmaps, PostScript or PDF.
File | Extract allows a range of pages to be copied from a PostScript document.
File | PS to EPS allows the bounding box to be updated and allows the header to be changed from PS to EPS. Read the documentation thoroughly before using this.
Edit | Add EPS Preview adds a bitmap preview to an EPS file.
Edit | Extract EPS extracts the PostScript or Preview from a DOS EPS file.
Edit | Convert to vector format uses pstoedit to convert PostScript or PDF to an editable vector format.
Edit | Text Extract uses pstotext to extract text from a PostScript or PDF document.
File conversions and tricks
Convert
Extract
PS to EPS
EPS Preview
User Supplied Preview
Text Extract and Find
Clipboard
Convert PostScript to PDF. File | Convert, select pdfwrite, 300dpi, With Ghostscript 5.50, fonts with non-standard encodings will be included as bitmaps. If you choose 72dpi, fonts will look rough. Ghostscript 6.0 will embed fonts.
Convert PDF to PostScript. File | Convert, select pswrite, 300dpi.
Convert Level 2 PostScript to Level 1 PostScript. File | Convert, select psmono, 300dpi, Instead of 300dpi, you should use the resolution of your printer.
Convert to a bitmap. File | Convert, select bmp16m, 72dpi.
Extract text (pstotext). Edit | Text Extract
Add a preview to an EPS file. Edit | Add EPS Preview. See Add EPS Preview for more details.
Remove preview from an EPS file. Edit | Extract EPS | PostScript
Display with smooth edges. Media | Display Settings. Set Text Alpha and Graphics Alpha to 4. You need a display with at least 8 bits per pixel.
Create a bitmap with smooth edges (anti-aliasing). Convert using a bitmap device and set the following in the properties.
-dTextAlphaBits=4 -dGraphicsAlphaBits=4
You need to select a Ghostscript output device and resolution. The default list of available devices and resolutions is stored in the [Convert] section of .gsview.ini and is taken from the standard distribution version of Ghostscript 6.01. You can use other devices or resolutions.
Some Ghostscript options may be added using either the Options field or the Properties button.
All pages, individual pages or any combination may be converted. The All, Odd and Even buttons provide quick selection of pages. If a single contiguous block of pages is marked, the Odd and Even buttons will select odd or even pages within this range. The Reverse check box causes the pages to be converted in descending order.
To control how GSview handles requests by the PostScript or PDF documents to change the page size, see the Page Size Matching topic.
See also Conversions.
See also Conversions.
%!PS-Adobe-3.0 EPSF-3.0
and then adding or fixing up the %%BoundingBox comment.
EPS files are commonly used for inclusion in other documents and for this reason require the bounding box comment:
%%BoundingBox: llx lly urx ury
where llx, lly, urx and ury are integers giving the x and y co-ordinates of the lower left and upper right corners of a bounding box which encloses all marks made on the page.
When used incorrectly, the PS to EPS command can produce PostScript files with incorrect DSC comments. Such a document will cause problems when you try to include it inside another document.
To convert a PostScript file to EPS, the original file must be a single page document. If the document contains DSC comments and is multi page, extract the desired page with File | Extract. If the document does not contain DSC comments, you will need to edit the file by hand to extract the desired page.
EPS documents must not use any of the following operators:
banddevice clear cleardictstack copypage erasepage exitserver framedevice grestoreall initclip initgraphics initmatrix quit renderbands setglobal setpagedevice setpageparams setshared startjob letter note legal a3 a4 a5
The following operators should be used with care:
nulldevice setgstate sethalftone setmatrix setscreen settransfer setcolortransfer
It is your responsibility to make sure that the above requirements are met.
To test if a document contains any of the above operators, select Options | EPS Warn and then Open the desired document. After the page has been displayed, Close the document and then display the Ghostscript messages with File | Show Messages. If any of the above operators have been used you should see lines like:
Warning: EPS files must not use ...
If you find these warnings then do not use PS to EPS. Remember to turn off EPS Warn afterwards.
A document must be displayed before PS to EPS is used.
For documents without DSC comments, PS to EPS allows a bounding box to be specified, then writes out an EPS file consisting of an EPS wrapper around the original document.
For documents with DSC comments, PS to EPS will change the first line of the file to
%!PS-Adobe-3.0 EPSF-3.0
then allows the %%BoundingBox comment to be changed or added.
For EPS documents, PS to EPS allows the %%BoundingBox comment to be changed.
PS to EPS does not clip the document to the %%BoundingBox. To do so would require changing the PostScript code itself. PS to EPS only changes the DSC comments.
If Automatically calculate Bounding Box is checked, GSview will calculate the bounding box from the non white pixels. If unchecked, you get to choose the bounding box by clicking at the left, bottom, right and top.
PS to EPS does not add a preview to a document. If you want a preview you add it with Edit | Add EPS Preview after first creating an EPS file with a correct %%BoundingBox.
See also Add EPS Preview, Extract, EPS Warn and Conversions.
1. Deselect Options | Ignore DSC
2. Make sure the document has a correct bounding box. Options | Show Bounding Box is useful for checking the bounding box. A bounding box can be added or changed using File | PS to EPS.
3. Select Orientation | Portrait.
4. Select Media | Display Settings and set a suitable resolution for the preview. If the resolution is too high it will make the EPS file excessively large.
5. Open an EPS file that does not contain a preview.
6. Select Edit | Add EPS Preview, then the preview format, then the new EPS filename. GSview will write a new file containing the original PostScript EPS file and a preview created from the display bitmap. The available preview formats are Interchange, TIFF 4, TIFF 6 uncompressed, TIFF 6 packbits and Windows Metafile. If adding an Interchange preview, the document must have an %%EndComments line, otherwise GSview may put the preview in the wrong place. An interchange preview is always monochrome. A TIFF 4 preview is a Baseline Bilevel Image (1 bit/pixel) with no compression as described in the TIFF 6.0 memorandum, but avoiding tags which are not described in the TIFF 4 specification. WordPerfect 5.1 requires a TIFF 4 preview. A TIFF 6 preview is a Baseline Bilevel Image, or a Baseline Palette-colour Image (4 or 8 bits/pixel) or a Baseline RGB Full Colour Image (24 bits/pixel) according to the TIFF 6.0 specification. TIFF 6 previews are either uncompressed or compressed with packbits. A Windows Metafile preview contains an uncompressed bitmap.
7. Reset Orientation | Portrait, and Media | Display Settings to their previous values.
To extract the PostScript or Preview section from a DOS EPS file, use File | Select File followed by Edit | Extract EPS then PostScript or Preview.
See also PS to EPS.
You can add a preview that has no resemblance to the PostScript, which is most undesirable.
GSview has two methods of extracting text from a PostScript file.
The quick method extracts all text from PostScript strings.
The second method uses pstotext and Ghostscript to more accurately extract text from a PostScript document.
The method used is selected by Options | PStoText. See the appropriate topic below:
See also Conversions.
Quick Text Extract and Find
PStoText Text Extract and Find
Edit | Text Extract will extract text contained in strings from specified pages and write it to a text file. Line breaks in this text file correspond to lines in the document. Spaces in the text file correspond to spaces within strings, or to separate strings. A more effective method of extracting text is to use ps2ascii.ps supplied with Ghostscript, or to use the PStoText program listed on the Ghostscript WWW page. PStoText can be used from GSview by using Options | PStoText.
Edit | Find will search for text and display the first page that contains the text. Find asks for a search text and a range of pages in which to search. The preceding comments about extracting text from a PostScript document should be noted. Find first extracts text from the document, then searches it ignoring all spaces in both the document and the search text. Case is ignored when searching. Consequently the search text these would match both These and The serial. No information is given about where the word is located on a given page because this information is not available without a complete PostScript interpreter. Find will not work for non DSC documents or DSC documents with special page order.
Edit | Find Next will continue the search from the next page.
pstotext uses the ISO-Latin1 character set. See the pstotext documentation for more details.
http://www.research.digital.com/SRC/virtualpaper/pstotext.html
Orientation must be set to match the text direction of the document.
Edit | Text Extract will extract text from specified pages and write it to a text file.
Words can be copied to the clipboard using Edit | Copy.
Edit | Find will search for text and display the first page that contains the text. Find asks for a search text and a range of pages in which to search. The search text is first broken up into words. For each search word, a search is made to find a match anywhere within a document word. Searching for frog would find frog, frogs and bullfrogs. The wildcards '*' (zero or more characters) and '?' (any one character) are supported, but it doesn't make sense to use them at the beginning or end of a word. Wildcards do not extend beyond the word being searched. Multiple complete words may be specified, e.g. GSview is a. If the search text is found, the page containing the text is displayed and the first word highlighted. Find will not work for non DSC documents or DSC documents with special page order.
Edit | Find Next will continue the search.
For most PostScript files you should use Options | PStoText | Normal.
Options | PStoText | Dvips Cork Encoding is only relevant for PostScript files produced by dvips from TeX or LaTeX documents; it tells pstotext to use the Cork encoding rather than the old TeX text encoding. Unfortunately files produced by dvips don't distinguish which font encodings were used.
Save Image as BMP will save the currently displayed page as a Windows bitmap.
If Text Extract or Find are used on a document with PStoText enabled, GSview creates an index of the words in the document. If any words are marked with the mouse, these will become the current X selection. Text cannot be marked until either Text Extract or Find has been used with Options | PStoText enabled.
This dialog box shows the start location, finish location, difference between these locations and the length and angle between these locations. The start location is set when you click the left mouse button. The default start location is the lower left corner of the page. The units can be pt, mm, inch, or custom.
Custom units allows you to display coordinates as they appear in a PostScript file. Custom units are usually specified by starting with an identity matrix and then performing a series of transformations. If a PostScript file invokes landscape orientation using
90 rotate 0 -595 translate
then to display the user coordinates you would enter the following in the Calculate Transformation dialog:
Custom initmatrix 90 rotate 0 -595 translate invertmatrix Ok
The Current Transformation Matrix (CTM) is shown in upper part of the dialog. You can enter a CTM directly if you like maths. It is easier to enter values in the Custom edit fields below this, but these have no effect until one of the transform buttons (translate, rotate, scale) is selected.
See also Units.
Easy Configure
Advanced Configure
Units
Language
PStoText
DSC Warnings
Save Settings
Safer
Save Last Directory
Button Bar
Auto Redisplay
EPS Clip
EPS Warn
Ignore DSC
Show Bounding Box
Ghostscript EXE tells GSview where to find Ghostscript. The default is gs.
Enter the correct Ghostscript include path into the Ghostscript Include Path field. This include path must include the directories where the Ghostscript library files (gs_*.ps and Fontmap) and the Ghostscript fonts (*.pfb) are located. For example:
/usr/share/ghostscript/6.0;/usr/share/ghostscript/fonts
The default is blank. Do NOT put a -I before the include path.
The Ghostscript Options field may be empty. If you wish to turn off the Platform Fonts feature under MS-Windows, put -dNOPLATFONTS in the Ghostscript Options field. If you wish to search for fonts not listed in Fontmap, add -sFONTPATH to this field. For example
-dNOPLATFONTS -sFONTPATH="c:\psfonts"
If you do not get the Ghostscript DLL field correct, GSview will not be able to load Ghostscript. If you do not get the Ghostscript Include Path correct, Ghostscript will not initialise and will then unload.
See the Installation topic.
The resolution of the units can be increased by selecting Units | Fine Resolution.
See also Measure.
On Windows NT, all existing languages are available to be selected, independent of the regional settings. On other systems, the language availability depends on the selected regional settings, in particular the chosen locale or system code page.
The Quick Text Extract and Find method does a simple extraction of PostScript strings. This method is easily confused. This is selected by the menu item PStoText | Disabled.
The PStoText Text Extract and Find method uses the external pstotext tool and Ghostscript to extract words and their co-ordinates. This method is more accurate, but there may be a long pause while pstotext and Ghostscript do the initial processing. After this, text extraction and searching should be quick. There are two modes of operation. Normal should be used for most PostScript files. Dvips Cork Encoding should be used if you have a PostScript file produced by dvips which uses Cork Encoding.
The default is Normal.
If you ask to be notified about errors and warnings, the DSC warning dialog box allows you to make the following choices: OK tells GSview to take a guess about what was probably meant (rather than what the DSC comment actually said), Cancel tells GSview to treat the DSC as being correct, Ignore DSC tells GSview to ignore all DSC comments.
If DSC Warnings is Off, GSview will assume Cancel. Documents with incorrect DSC comments will be likely to cause problems.
When the Save Settings on Exit option is checked, GSview will automatically save the above settings when you quit GSview.
When the Safer option is unchecked Ghostscript can change files.
When Save Last Directory option is unchecked, the current directory when GSview is started will be the current directory of the program that started GSview.
File | Print
File | Info
Help | Contents
View | Goto Page
Go back 5 pages
View | Previous Page
View | Next Page
Go forward 5 pages
View | Go Back
View | Go Forward
Increase resolution by 1.2
Decrease resolution by 1/1.2
Edit | Find
Edit | Find Next
If using the increase/decrease resolution buttons, Auto Redisplay should be set. Instead of using these buttons the Media | Display Settings command can be used. When the Button Bar option is unchecked, GSview will not display the Button Bar.
For non-DSC documents, if Auto Redisplay is checked, GSview will restart at the first page.
If Auto Redisplay is unchecked, the View | Redisplay command must be used to redisplay a document after changing the Orientation, Resolution, Depth or Media.
If EPS Clip is unchecked, GSview will use the page size specified on the Media menu for EPS files. This is the default.
EPS Clip does not alter the original document, it only affects how much of the document is displayed by GSview. It does not affect printing.
See also Edit | Add EPS Preview
Warning: EPS files must not use /initgraphics
EPS Warn is not infallible. It is possible to access restricted operators without EPS Warn producing a warning. If you do get a warning, do NOT used PS to EPS.
The default for EPS Warn is unchecked.
See also PS to EPS.
The default for Ignore DSC is unchecked.
The default for Show Bounding Box is unchecked.
If the Auto command on the orientation menu is checked and a DSC page orientation comment is found (%%Orientation or %%PageOrientation), the orientation will be selected automatically.
When the Swap Landscape option is checked, GSview swaps the meaning of Landscape and Seascape. Most of the Landscape documents that I have encountered require a 90 clockwise rotation of the paper to view. However, there is no standard and some documents need to be rotated the other way. The Swap Landscape button allows GSview to automatically rotate the document the right way in response to the %%Orientation comment in the PostScript file.
See also Page Size and Display Settings.
The Resolution field sets the display resolution in dots per inch. The default for a VGA display is 96 dots per inch. This can also be changed by the resolution changing buttons on the button bar.
For DSC conforming files, pressing the right mouse button will Zoom into the page at what is usually printer resolution. Pressing the right mouse button a second time will zoom back out to normal display resolution. The Zoom Resolution field sets the zoom resolution in dots per inch.
The Depth field sets the page bitmap depth in bits per pixels for the display. Default will select the highest depth supported by your display driver. In general, you shouldn't set this higher than your actual display depth because doing so will use extra memory for the page bitmap but won't improve the display.
The Text Alpha field sets anti-aliasing for fonts. The default (use anti-aliasing) is 4 bits. To disable anti-aliasing of fonts, use 1 bit.
The Graphics Alpha field sets anti-aliasing for graphics and also for text that is too large to fit in the font cache.
Using anti-aliasing slows down drawing. Text and Graphics Alpha can only be used if your display depth is set to 8bits/pixel or higher.
Zoom will only work for DSC conforming documents.
To enlarge or shrink the entire page, use the Resolution on the Media | Display Settings dialog box, use the magnifying glass toolbar buttons.
11x17 11 x 17 inch A0 840 x 1189 mm A1 594 x 840 mm A2 420 x 594 mm A3 297 x 420 mm A4 210 x 297 mm A5 148 x 210 mm B4 257 x 364 mm B5 182 x 257 mm Ledger 17 x 11 inch Letter 8.5 x 11 inch Legal 8.5 x 14 inch Note 8.5 x 11 inch
A user defined size can be specified in PostScript points (1/72 inch) with the User Defined command. A size of 480x360 points at 96 dpi will give an image size of 640x480 pixels.
If a DSC media comment is found, such as
%%DocumentPaperSizes: a4 %%DocumentMedia: a4 595 842 80 white ( )
the page type will be selected automatically. If the media specification is not one of the above page types, the User Defined size will be set.
If Rotate Media is checked, the width and height of the page are exchanged. The image drawn on the page is not rotated. This affects both display and printing. Selecting A4 and Rotate Media is equivalent to selecting User Defined with a size of 842 x 595 pt. It is more common to use the settings on the Orientation menu than Rotate Media.
WARNING - not all of these work in X11
O, o Open and display a file. (File | Open)
C, c Close file. (File | Close)
N, n, + Next Page. (View | Next Page)
Space Next Page and Home. (View | Next Page and Home)
V, v, - Previous Page. (View | Previous Page)
BackSpace Previous Page and Home. (View | Previous Page and Home)
G, g Goto Page. (View | Goto Page)
I, i File information. (File | Info)
R, r, F5 Redisplay page. (View | Redisplay)
S, s Select file: open but don't display. (File | Select File)
A, a Save As. (File | Save As)
P, p Print all or some pages to a printer. (File | Print)
F, f Convert all or some pages to a PDF or bitmap File. (File | Convert).
E, e Extract some pages to another File. (File | Extract)
M, m Show Ghostscript Messages. (File | Show Messages)
< Decrease resolution by 1/1.2
> Increase resolution by 1.2
F1 Help. (Help | Contents)
Ctrl+C, Ctrl+Insert Copy displayed bitmap to clipboard. (Edit | Copy)
Ctrl+F, Find Text. (Edit | Find)
F3, Find Next. (Edit | Find Next)
F4 Full Screen. (View | Full Screen)
F6 Fit Window. (View | Fit Window)
Arrow Keys Scroll by 1/16 of a screen.
Ctrl + Arrow Keys Scroll by one screen.
Page Up Scroll up one screen (window height).
Page Down Scroll down one screen.
Home Scroll to top of page.
End Scroll to bottom of page.
Usage:
gsview [-d] [-t] [-f[DEVICE]] [-p[QUEUE]] [-mPAPERSIZE] [-oORIENTATION] [-rXDPIxYDPI] [-geometry WIDTHxHEIGHT[+XOFF+YOFF]] filename
Options:
filename To start GSview and display filename.ps:
gsview filename.ps
-p prints filename.ps using Ghostscript. This is similar to File | Print, except that you will not be prompted for a printer (it will use the printer most recently used by GSview, or the printer name you provide) and GSview will exit after printing has finished:
gsview -p filename.ps
-f converts a PostScript file (not PDF) filename.ps to a file using Ghostscript (File | Convert):
gsview -f filename.ps
-mPAPERSIZE sets the paper size. Any of the predefined sizes on the media menu are valid.
-oORIENTATION sets the orientation and may be one of auto, portrait, landscape, upsidedown or seascape.
-rXDPIxYDPI sets the display, convert or print resolution.
To display a file with A4 paper, landscape orientation and 96dpi:
gsview -ma4 -olandscape -r96x96 filename.ps
-d Debug mode. In debug mode GSview will not remove its temporary files. This is to allow inspection of these files after GSview has finished. Debug mode also produces more verbose output for File | Show Messages. To write debugging output to standard output use -d9
-t Multi-threading. GSview by default runs multi-threaded, except for Windows 3.1/Win32s. To change this, use -t to toggle the threading mode, use -t0 to select single-thread mode and -t1 to select multi-thread mode.
On GNU/Linux you an also use:
gsview -v (display version) gsview -h (display help)
http://www.cs.wisc.edu/~ghost/
GSview can be registered on-line at
http://www.ghostgum.com.au/
GSview can be used as a PostScript file viewer for several OS/2 and MS-Windows Web browsers. See the GSview home page for details.
Thomas Merz has written a Ghostscript manual, which is available in PDF from the above WWW site. This manual is an extract from a book written by Thomas Merz titled PostScript and Acrobat/PDF, available in English and German.
gsview - A Ghostscript graphical interface Copyright (C) 1993-2002, Ghostgum Software Pty Ltd. All rights reserved.
This file is part of GSview.
This program is distributed with NO WARRANTY OF ANY KIND. No author or distributor accepts any responsibility for the consequences of using it, or for whether it serves any particular purpose or works at all, unless he or she says so in writing. Refer to the GSview Free Public Licence (the "Licence") for full details.
Every copy of GSview must include a copy of the Licence, normally in a plain ASCII text file named LICENCE. The Licence grants you the right to copy, modify and redistribute GSview, but only under certain conditions described in the Licence. Among other things, the Licence requires that the copyright notice and this notice be preserved on all copies.
Author: Russell Lang, Ghostgum Software Pty Ltd Internet: gsview@ghostgum.com.au
Please read the Common Problems topic, the GSview Readme.htm and browse the WWW page before sending mail to the author.
GSview uses pstotext in an external DLL. pstotext was written by Andrew Birrell and Paul McJones. It is
Copyright (C) 1995-1996, Digital Equipment Corporation.
See the licence in pstotext.txt or pstotext.zip for more details. If you do not agree to the pstotext licence, delete pstotext.zip, pstotxt2.dll and pstotxt3.dll.
This is because the document does not have correct DSC comments. From the Control Panel, select Printers, Options..., then in the Print to group box click on the Printer radio button. You cannot use the Print To Encapsulated PostScript File for printing multipage files. The correct method is to connect the printer to FILE:. In addition, from the Control Panel select Printers, Options..., Advanced and then check Conform to Adobe Document Structuring Convention.
The DSC comment %%Pages: 0 means that the document does not produce any pages. That is, the PostScript showpage operator is not used. If you find a PostScript document that has multiple pages and contains the %%Pages: 0 comment, change the first line from %!PS-Adobe- to %!. GSview will then ignore the DSC comments and allow you to view all pages, but only in the original order. Complain to the author of the program that produced that PostScript file.
Some PostScript printer drivers include code that is specific to a particular printer. The PostScript output from these drivers may be unportable and may not display in GSview. If you are having this problem, try using a reasonably generic PostScript driver such as Apple LaserWriter II NT for PostScript level 2 printers, or Apple LaserWriter Plus for PostScript level 1 printers.
For Windows 95, open the printer properties then select the PostScript tab, then select PostScript Output Format = PostScript (optimize for portability - ADSC).
Problem: GSview says "Page ordering is Special..."
Your document used the DSC comment %%PageOrder: Special which means that pages can not be reliably reordered. This may prevent GSview from displaying pages in any order other than the original order. If you continue and reorder the pages, PostScript errors may occur. The only way to fix this is to regenerate the PostScript without special page ordering.
By default, Windows 95 creates PostScript files which use special page ordering. To disable this, open the printer properties then select the PostScript tab, then select PostScript Output Format = PostScript (optimize for portability - ADSC).
Problem: PostScript files produced by MS-Windows start with a Control-D.
For Windows 3.1:
Since this occurs even when the PostScript printer Conform to Document Structuring Convention checkbox is checked, this must be considered a bug in the MS-Windows PostScript printer driver. The bug fix is documented in the MS-Windows PRINTERS.WRI file. Edit the win.ini file and search for the PostScript printer section. There may be more than one. In each of these sections add CTRLD=0 as shown below.
[Apple LaserWriter II NT,FILE] CTRLD=0
For Windows 95:
The PostScript printer driver setup has an option (Properties, PostScript, Advanced) for suppressing a ^D at the start of a document. Fortunately the default is do not send ^D before job.
Problem: PostScript files produced by Word for Windows 6.0 cause a "Missing %%Pages comment" message box.
Congratulations. You have just found a mistake in the DSC comments when Word included an EPS file. Word should have surrounded the included EPS file with the lines
%%BeginDocument: filename.eps %%EndDocument
Because Word didn't do this, GSview can't tell how many pages are in the document and where they are located.
Please complain to Microsoft. There is a problem in the EPSIMP.FLT filter version 2.01 which Microsoft needs to fix.
In the interim, you have two solutions:
1. Select Options | Ignore DSC
2. Edit the PostScript file to correct the DSC comments. Search the PostScript file for all lines containing
%MSEPS Preamble
From each of these lines, search forward for the start of the included EPS file which should start with a line like
%!PS-Adobe-3.0 EPSF-3.0
Above these lines add the line
%%BeginDocument: AddedByHand
Then search for all lines containing
%MSEPS Trailer
Above these lines add the line
%%EndDocument
GSview should then be able to display the file correctly.
Problem: GSview doesn't recognise the DSC comments in files produced using the Adobe PostScript driver 4.10 for Windows 32-bit.
Do not use Tagged binary communications protocol. Change this to "Printers | PostScript tab | Advanced... | Data format group box | ASCII data"
Problem: Trying to open any file gives
Unrecoverable error: configurationerror in setpagedevice Failed to open device or install ViewerPreProcess hook: returns -26 Page size may have been too large or resolution too high. Resetting page size and resolution
Either the problem described in the error message has occurred, in which case you should reduce the page size, resolution, depth or a combination of all three. Alternatively, you may have used -dFIXEDMEDIA in the Ghostscript environment variable GS_OPTIONS. When using GSview, it is safest not to use GS_OPTIONS at all and to use Options | Advanced Configure | Ghostscript Options instead.
Problem: GSview hangs or takes a very long time when displaying a file.
Resolution may have been set too high or page size too large. Reduce the resolution to the default 96dpi using Media | Display Settings. Change the page size with the Media menu.
Show Messages
bzip2
zlib
Internals
The text in the Show Messages window can be copied to the clipboard. If no text is selected, the entire text will be copied to the clipboard. If some text is highlighted, only that text will be copied to the clipboard.
Explanations of some of the error message that may appear in the Show Messages are given in the Common Problems topic.
If you get an error message Failed to load bzip2 DLL... then you probably don't have the libbz2.so available.
bzip2 is Copyright 1996-2000 by Julian Seward The source code can be obtained from
http://sourceware.cygnus.com/bzip2/index.html
If you get an error message Failed to load zlib DLL... then you probably don't have libz.so available.
zlib is Copyright 1995-1996 by Jean-loup Gailly and Mark Adler. The source code can be obtained from
http://www.info-zip.org/pub/infozip/zlib/