Партнёры:
Хостинг:
NAME
sdtimage - Image viewer for CDE
SYNOPSIS
sdtimage [ -usage ] [ -v ] [ -verbose ] [ -timeout seconds ]
[ -tooltalk ] [ -linear ] [ -snapshot [ -region [ WxH+X+Y ]
| -screen | -window [ id | class ] ] ] [ -out output [ -f ]
[ -outType imagetype ] ] [ input [ -inType imageType ] ]
DESCRIPTION
Sdtimage is an interactive image viewer and a simple non-
interactive convertor of images.
When applied interactively sdtimage can be used to view the
contents of a variety of file types such as GIF, TIFF, JFIF
(JPEG) and POSTSCRIPT. The user may perform various opera-
tions on the image such as rotation, zooming and flipping to
view the image differently. If the file loaded in is a
multi-page document (such as a POSTSCRIPT document), the
user may page through the entire document, or skip to any
page directly.
When applied non-interactively sdtimage can convert between
various image formats, including the converting of some or
all of the screen to an image file.
OPTIONS
-usage Print out valid command line options.
-v Print out the current version of sdtimage.
-verbose Print out debugging information (not useful
to the user).
-timeout seconds
Set the timeout value for the Display
POSTSCRIPT server. The default value is 60
seconds.
-tooltalk Execute in tooltalk mode.
-linear Use a linear visual that corrects for non-
linear characteristics of the monitor (also
known as gamma correction). This option will
also ensure that a snapshot operation returns
an image that can be correctly displayed
using the linear visual. Image areas
obtained from linear visuals will remain
unmodified. Image areas obtained from non-
linear visuals involves an inverse gamma
correction transformation on the area such
that display is correct.
-snapshot Request snapshot functionality to capture an
area of the screen.
-region WxW+X+W
Specify a region of the screen to capture.
The format, of the width, height and coordi-
nates, is equivalent to the X command line
dimensions format. If no region is specified
then the region is obtained via the the mouse
pointer.
-screen Specify the whole area of the screen.
-window id | class
Specify a window of the screen to capture.
The window id may be specified in decimal or
hexadecimal, or as a class string correspond-
ing to the WM_CLASS property of a window. If
no id or class is specified then the window
is obtained via the mouse pointer.
-out output Output file to be saved.
-f Force overwrite of an existing output when
saving.
-outType imagetype
Save the output in the format specified by
imagetype.
-inType imagetype
Load the input in the format specified by
imagetype.
OPERANDS
input The path name of an image file.
USAGE
The presence of an output file determines whether sdtimage
is in non-interactive or interactive mode.
When in non-interactive mode a source of input is required.
Two sources of input are defined:
- An input file.
- Specifying an area of the screen via the the associ-
ated snapshot commands.
Only one source of input may be specified.
When in interactive mode a source of input is optional. The
sdtimage GUI will be presented and if an input source is
specified the associated image will be displayed.
When the -snapshot argument is specified the area of the
screen can be specified in one of three ways:
- A region.
- A window.
- The whole screen.
If no option is specified then the snapshot dialog will be
displayed when the sdtimage GUI is presented.
If no command line arguments are specified with either the
region or window option then the selected area may be chosen
using the pointer before either the display or saving of the
selected area.
If the image file specified in either the input or output is
'-' sdtimage reads or writes from the standard input or out-
put respectively.
An image file may also be prefixed with an image type fol-
lowed by a colon. This is equivalent to using the -inType or
-outType arguments. If the -inType or -outType arguments are
specified then they override prefix image types and they are
assumed to be part of the file name. Image types are
invariant to upper and lower case characters.
When an image type is specified for an input file it over-
rides the automatic typing mechanism. If the image type is
not recognized then sdtimage defaults back to the automatic
typing mechanism.
When an image type is specified for an output file it over-
rides the default TIFF format. If the image type is not
recognized it reverts back to the default TIFF format.
The table below presents the image types that may be recog-
nized. The last type AUTO may only be applied to input.
Under certain cases input image files may contain valid
colons that do not correspond to a delimiter between image
type and file. If the -inType option is specified as AUTO
then the image file name may contain colons.
__________________________________________________
| IMAGE TYPE| IMAGE FILE DESCRIPTION |
|___________|______________________________________|_
| RASTER | Sun Raster |
| TIFF | Tagged Image File Format |
| GIF | Graphics Interchange Format |
| PS | Postscript |
| EPSF | Encapsulated Postscript |
| JPEG | JPEG File Interchange Format (JFIF)|
| XPM | X Pixmap format |
| AUTO | Automatic image detection |
|___________|_____________________________________|
No image manipulation may be performed when in non-
interactive mode. To scale, rotate and crop images sdtimage
must be executed in interactive mode.
If an input file specified is of the type POSTSCRIPT or EPSF
then the file may not be converted to an image due to the
possibility of multiple pages being present within the
POSTSCRIPT or EPSF file.
GUI USAGE
The four menu buttons across the top of the main window are
described below:
File The File menu contains the following items.
Open... Brings up a dialog which allows the user
to select a file that is to be opened
for viewing.
Open As...
Brings up a dialog which allows the user
to select a file that is to be opened
for viewing, and also allows the user to
specify the file type.
Save... If the file has no name, this brings up
a dialog for the user to specify the
file name, and save the file. If the
file is named, then this simply saves
the currently viewed image to the file.
Save As...
Brings up a dialog which allows the user
to specify the file name, the file type,
number of colors and compression type of
the file that is to be saved.
Save Selection As...
Brings up a dialog which allows the user
to specify the file name, the file type,
number of colors and compression type of
the file that is to be saved. This menu
item is only active if the user has
selected a region of interest in the
currently displayed image.
Save Page As Image...
Brings up a dialog which allows the user
to specify the file name, the file type,
number of colors and compression type of
the file that is to be saved. This menu
item is only active if the user if view-
ing a page of a multi-page file.
Print Image
Allows user to print one copy of the
currently displayed image using the
current values (which may be the default
values) on the Print dialog. This
option is only displayed when not view-
ing POSTSCRIPT and EPSF documents.
Print Page
Allows user to print one copy of the
currently displayed page of a document
using the current values (which may be
the default values) on the Print dialog.
This option is only displayed when view-
ing POSTSCRIPT and EPSF documents.
Print Document
Allows user to print the complete docu-
ment using the current values (which may
be the default values) on the Print dia-
log. This option is only displayed when
viewing POSTSCRIPT and EPSF documents.
Print Preview...
Brings up a window and displays the
image as it would look if it were
printed, based on the settings (which
may be the default values) on the Print
dialog.
Print... Brings up a dialog which allows user to
set various parameters that affect the
printing of the currently displayed
image such as position, and size.
Options...
Brings up a dialog that allows the user
to specify options that affect how
sdtimage is run. These include whether
to display images in gray scale or
color, number of colors to display (this
option depends on the framebuffer of the
users system), whether to display
POSTSCRIPT in color or monochrome, and
whether or not the palette is to display
immediately or not.
Exit Terminates the application.
Edit The Edit menu contains the following items.
Undo If the user has selected one of the
various operations on the palette, he
may undo his last selection by choosing
this menu item.
Palette...
Brings up a palette with various opera-
tions that may be performed on the
currently displayed image, such as rota-
tion, zooming and flipping.
View The View menu contains the following items.
Image Info...
Brings up a window that displays various
information about the currently viewed
image, such as width and height.
Page Overview...
Brings up a dialog which displays at
most 16 pages of the currently viewed
document. The user may select a page
for viewing from this display. This
option is valid only if the user is
viewing a multi-page document.
Page Viewing Controls
Brings up a dialog from which the user
may set various parameters that affect
the viewing of multi-page (such as
POSTSCRIPT) files. This option is valid
only if the user is viewing a multi-page
document.
Help Standard help menu.
The toolbar contains controls that provide easier navigation
through a multi-page document. The scale in the toolbar is
used to go to a specific page where the two arrow buttons in
the toolbar are the forward and backward buttons for paging.
Both the scale and the arrow buttons become active when a
multi-page document is loaded.
The user may drag files from another application such as
dtfile(1) and drop them into the base window. This causes
them to be loaded into sdtimage and displayed.
Below the toolbar, there is a display area on which the
image is displayed. When sdtimage starts up, it tries to
create the window to fit the size of the image. However, if
the image is very large, it may only show a portion of it.
The user may however, use the scrollbars attached to the
display area to move around within the image.
RESOURCES
On startup, sdtimage will use the following X resources
which are stored in $HOME/.desksetdefaults. Note these
resource names will be prepended with deskset.imagetool.
Resource: ViewImageIn
Values: Color, GrayScale (Color)
Description: Determines if images will be displayed in
color or grayscale. If user is using a mono-
chrome monitor, this setting has no effect.
Resource: Colors
Values: BW, 16, 256, Millions (256)
Description: Sets the number of colors to be used when
viewing images. This resource only is used if
a multi-plane framebuffer is being used. Note
that for most color monitors, only 256 colors
are possible.
Resource: ViewPostScriptIn
Values: Color, Monochrome (Monochrome)
Description: Determines if a POSTSCRIPT file will be
displayed in Color or Monochrome. Setting
this resource to Monochrome will reduce the
number of colors allocated in the colormap
and will reduce the chances of color flash-
ing. If user is using a monochrome monitor,
this setting has no effect.
Resource: DisplayPalette
Values: True, False (True)
Description: Determines if palette is automatically
displayed when first image is opened by
sdtimage.
Resource: TTTimeoutSecs
Values: Integer Value (300)
Description: Number of seconds which will leave sdtimage
running as a background process even after
the user exits the program. This timeout
value applies only when sdtimage is started
by ttsession.
Resource: UseDSC
Values: True, False (False)
Description: Determines how POSTSCRIPT documents are
interpreted. A well written POSTSCRIPT file
contains Document Structuring Comments which
separate various sections of the document.
If the comments are used correctly, then it
is easy to determine where each page of the
document begins and ends. By default, sdtim-
age does not look for these comments when
determining pages. Because of this, backward
paging can be slow since the only way to ver-
ify that the displayed page will look correct
is to begin at the beginning of the document
and render pages until the desired page is
found. If the user finds that the perfor-
mance is not acceptable, then this resource
may be set, at which time, sdtimage will use
the Document Structuring Comments to deter-
mine where each page begins and ends. Note
that this may help performance, but that
displayed pages may not look correct due to
no comments being found in the document, or
the comments being used incorrectly.
EXAMPLES
The following commands:
example% sdtimage image.in -out JPEG:image.tiff
example% sdtimage image.in -out image.tiff -outType jpeg
will convert the input image file 'image.in' to the JPEG
image file format as the file 'image.jpeg'
The example:
example% sdtimage -snapshot -region 128x128+32+32
obtains a 128 by 128 region positioned at 32 by 32 on the
screen and displays the resultant image to the user.
The example:
example% sdtimage -snapshot -window dtmail -out GIF:image.gif
obtains the window with the WM_CLASS property 'dtmail' and
saves the resultant image in GIF image file format as the
file 'image.gif'.
The following:
example% sdtimage -snapshot -window 0x5000000 -out GIF:image.gif
performs the same as the previous example except for a
specific window with the id 0x5000000.
SEE ALSO
dps(7)
Solaris User's Guide
TRADEMARK
POSTSCRIPT is a registered trademark of Adobe Systems, Inc.
|
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |