import
saves any visible window on an X server and outputs it as an image file. You can capture a single window, the entire screen, or any rectangular portion of the screen.
1. import.1.man
Manpage of import
import
Section: User Commands (1)Updated: Date: 2005/03/01 01:00:00
Index Return to Main Contents
NAME
import - saves any visible window on an X server and outputs it as an image file. You can capture a single window, the entire screen, or any rectangular portion of the screen.SYNOPSIS
- import [options] input-file
OVERVIEW
The import program is a member of the ImageMagick(1) suite of tools. Use it to capture some or all of an X server screen and save the image to a file.For more information about the import command, point your browser to file:///usr/share/doc/imagemagick-6.3.8.3-r1/www/import or http://www.imagemagick.org/script/import.php.
DESCRIPTION
Image Settings:-adjoin join images into a single multi-image file
-channel type apply option to select image channels
-colorspace type alternate image colorspace
-comment string annotate image with comment
-compress type type of pixel compression when writing the image
-define format:option
define one or more image format options
-density geometry horizontal and vertical density of the image
-depth value image depth
-descend obtain image by descending window hierarchy
-display server X server to contact
-dispose method layer disposal method
-dither apply Floyd/Steinberg error diffusion to image
-delay value display the next image after pausing
-endian type endianness (MSB or LSB) of the image
-encoding type text encoding type
-format "string" output formatted image characteristics
-frame include window manager frame
-gravity direction which direction to gravitate towards
-identify identify the format and characteristics of the image
-interlace type None, Line, Plane, or Partition
-interpolate method pixel color interpolation method
-label string assign a label to an image
-limit type value Area, Disk, Map, or Memory resource limit
-monitor monitor progress
-page geometry size and location of an image canvas
-pause value seconds delay between snapshots
-pointsize value font point size
-quality value JPEG/MIFF/PNG compression level
-quiet suppress all warning messages
-regard-warnings pay attention to warning messages
-sampling-factor geometry
horizontal and vertical sampling factor
-scene value image scene number
-screen select image from root window
-seed value seed a new sequence of pseudo-random numbers
-set property value set an image property
-silent operate silently, i.e. don't ring any bells
-snaps value number of screen snapshots
-support factor resize support: > 1.0 is blurry, < 1.0 is sharp
-transparent-color color
transparent color
-treedepth value color tree depth
-verbose print detailed information about the image
-virtual-pixel method
Constant, Edge, Mirror, or Tile
-window id select window with this id or name
Image Operators:
-annotate geometry text
annotate the image with text
-border include image borders in the output image
-colors value preferred number of colors in the image
-crop geometry preferred size and location of the cropped image
-geometry geometry perferred size or location of the image
-help print program options
-monochrome transform image to black and white
-negate replace every pixel with its complementary color
-repage geometry size and location of an image canvas
-quantize colorspace reduce colors in this colorspace
-resize geometry resize the image
-rotate degrees apply Paeth rotation to the image
-strip strip image of all profiles and comments
-thumbnail geometry create a thumbnail of the image
-transparent color make this color transparent within the image
-trim trim image edges
-type type image type
Miscellaneous Options:
-debug events display copious debugging information
-help print program options
-log format format of debugging information
-list type print a list of supported option arguments
-version print version information
By default, 'file' is written in the MIFF image format. To specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps). Specify 'file' as '-' for standard input or output.
SEE-ALSO
ImageMagick(1)COPYRIGHT
Copyright (C) 1999-2008 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/share/doc/imagemagick-6.3.8.3-r1/www/license.php or http://www.imagemagick.org/script/license.php
Index
This document was created by man2html using the manual pages.
Time: 23:21:18 GMT, July 09, 2008
2. import.3.man
Manpage of import
import
Section: AfterStep X11 window manager (1)Updated: AfterStep v.2.2.4
Index Return to Main Contents
NAME
import - functionality for reading images from files libAfterImage/import.hNAMEimport
- Image file format autodetection, reading and decoding routines.SEE ALSO
Functions :
file2ASImage(), get_asimage(), file2pixmap()
Other libAfterImage modules :
ascmap.h asfont.h asimage.h asvisual.h blender.h export.h
import.h transform.h ximage.h
AUTHOR
Sasha Vasko <sasha at aftercode dot net>
NAMESCREEN_GAMMA
- Defines default value for screen gamma correction.SOURCE
Source :#define SCREEN_GAMMA 2.2 #define DEFAULT_PNG_IMAGE_GAMMA 0.45455
NAMEASImageFileTypes
- List of known image file formats.SOURCE
Source :
typedef enum
{
ASIT_Xpm = 0,
ASIT_ZCompressedXpm,
ASIT_GZCompressedXpm,
ASIT_Png,
ASIT_Jpeg,
ASIT_Xcf,
ASIT_Ppm,
ASIT_Pnm,
ASIT_Bmp,
ASIT_Ico,
ASIT_Cur,
ASIT_Gif,
ASIT_Tiff,
ASIT_XMLScript,
ASIT_SVG,
/* reserved for future implementation : */
ASIT_Xbm,
ASIT_Targa,
ASIT_Supported = ASIT_Targa,
ASIT_Pcx,
ASIT_HTML,
ASIT_XML,
ASIT_Unknown
}ASImageFileTypes;
NAMEASImageListEntry
- entry in linked list of images loaded from single directory.SOURCE
Source :
typedef struct ASImageListEntryBuffer
{
#define ASILEB_Dirty (0x01<<0)
#define ASILEB_Binary (0x01<<1)
ASFlagType flags ;
size_t size ;
char *data ;
}ASImageListEntryBuffer;
typedef struct ASImageListEntry
{
#define MAGIC_ASIMAGE_LIST_ENTRY 0xA3A311E4
#define IS_ASIMAGE_LIST_ENTRY(e) (((e)!=NULL)&&((e)->magic==MAGIC_ASIMAGE_LIST_ENTRY)&&((e)->ref_count>0))
unsigned long magic ;
struct ASImageListEntry *prev, *next ;
char *name ;
char *fullfilename ;
ASImageFileTypes type;
ASImage *preview;
mode_t d_mode;
time_t d_mtime;
off_t d_size; /* total size, in bytes */
ASImageListEntryBuffer *buffer ;
int ref_count;
}ASImageListEntry;
NAMEfile2ASImage()
- load ASImage from file.SYNOPSIS
ASImage *file2ASImage( const char *file, ASFlagType what,
double gamma,
unsigned int compression, ... );
INPUTS
- file
- - file name with or without directory name
- what
- - reserved for future use
- gamma
- - gamma value to be used to correct image
- compression
- - compression level of the resulting ASImage
- ...
-
- NULL terminated list of strings, representing arbitrary number of directories to be searched each.
RETURN VALUE
Pointer to ASImage structure holding image data on success. NULL on failure
DESCRIPTION
file2ASImage will attempt to interpret filename in the following way: 1)It will try to find file using unmodified filename in all the provided search paths. 2)It will attempt to append .gz and then .Z to the filename and find such file in all the provided search paths. 3)If filename ends with extension consisting of digits only - it will attempt to find file with this extension stripped off. On success this extension will be used to load subimage from the file with that number. Subimages are supported only for XCF, GIF, BMP, ICO and CUR files. After the file is found file2ASImage() attempts to detect file format, and if it is known it will load it into new ASImage structure.
EXAMPLE
asview.c: ASView.2
NAMEget_asimage()
- increment reference counter if file is already loaded, or load image from file.SYNOPSIS
ASImage *get_asimage( ASImageManager* imageman, const char *file,
ASFlagType what, unsigned int compression );
INPUTS
- imageman
- - pointer to valid ASVisual structure.
- file
- - root window ID for the destination screen.
- what
- - full image file's name with path.
- compression
-
-
RETURN VALUE
Pointer to ASImage structure holding image data on success. NULL on failure
DESCRIPTION
get_asimage will attempt check with the ASImageManager's list of load images, and if image with requested filename already exists - it will increment its reference count and return its pointer. Otherwise it will call file2ASImage() to load image from file. It will use PATH and gamma values from the ASImageManager to pass to file2ASImage(). If image is successfully loaded - it will be added to the ASImageManager's list and its pointer will be returned.
SEE ALSO
file2ASImage()
NAMEfile2pixmap()
- convinience function to load file into X Pixmap.SYNOPSIS
Pixmap file2pixmap( struct ASVisual *asv, Window root,
const char *realfilename,
Pixmap *mask_out);
INPUTS
- asv
- - pointer to valid ASVisual structure.
- root
- - root window ID for the destination screen.
- realfilename
-
- full image file's name with path.
RETURN VALUE
Pixmap ID of the X Pixmap filled with loaded image. If mask_out is not NULL it will point to image mask Pixmap ID if there is an alpha channel in image, None otherwise. On failure None will be returned.
DESCRIPTION
file2pixmap() will attempt to open specified file and autodetect its format. If format is known it will load it into ASImage first, and then convert it into X Pixmap. In case image has alpha channel - mask Pixmap will be produced if mask_out is not NULL.
Index
- NAME
- NAMEimport
- SEE ALSO
- AUTHOR
- NAMESCREEN_GAMMA
- SOURCE
- NAMEASImageFileTypes
- SOURCE
- NAMEASImageListEntry
- SOURCE
- NAMEfile2ASImage()
- SYNOPSIS
- INPUTS
- RETURN VALUE
- DESCRIPTION
- EXAMPLE
- NAMEget_asimage()
- SYNOPSIS
- INPUTS
- RETURN VALUE
- DESCRIPTION
- SEE ALSO
- NAMEfile2pixmap()
- SYNOPSIS
- INPUTS
- RETURN VALUE
- DESCRIPTION
This document was created by man2html using the manual pages.
Time: 23:21:18 GMT, July 09, 2008
