LinuxReviws.org --get your your Linux knowledge
> Linux Reviews > Manual Pages (man) >

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
  2. import.3.man


1. import.1.man

Manpage of import

import

Section: User Commands (1)
Updated: Date: 2009/01/10 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.7.1.0//www/import or http://www.imagemagick.org/script/import.php.  

DESCRIPTION

Image Settings:
  -adjoin              join images into a single multi-image file
  -border              include window border in the output image
  -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 method       apply error diffusion to image
  -delay value         display the next image after pausing
  -encipher filename   convert plain pixels to cipher pixels
  -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
  -synchronize         synchronize image to storage device
  -taint               declare the image as modified
  -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
  -colors value        preferred number of colors in the image
  -crop geometry       preferred size and location of the cropped image
  -geometry geometry   preferred size or location of the image
  -help                print program options
  -monochrome          transform image to black and white
  -negate              replace each 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-2011 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/share/doc/imagemagick-6.7.1.0//www/license or http://www.imagemagick.org/script/license.php


 

Index

NAME
SYNOPSIS
OVERVIEW
DESCRIPTION
SEE ALSO
COPYRIGHT

This document was created by man2html using the manual pages.
Time: 17:31:12 GMT, October 23, 2013

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.h  

NAMEimport

- 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: 17:31:12 GMT, October 23, 2013

Meet new people