2023-02-03 21:16:55 +08:00
<!DOCTYPE html>
< html lang = "en" >
< head >
< meta charset = "utf-8" / >
< meta name = "viewport" content = "width=device-width, initial-scale=1, shrink-to-fit=no" / >
< title > ImageMagick - Command-line Tools: Import< / title >
< meta name = "application-name" content = "ImageMagick" / >
< meta name = "description" content = "Use ImageMagick® to create, edit, compose, and convert bitmap images. Resize an image, crop it, change its shades and colors, add captions, and more." / >
< meta name = "application-url" content = "https://legacy.imagemagick.org" / >
< meta name = "generator" content = "PHP" / >
< meta name = "keywords" content = "command-line, tools:, import, image converter, image resizer, image editor, photo editor, jpg converter, png converter, tiff converter, vector images, online, free, swiss army" / >
< meta name = "rating" content = "GENERAL" / >
< meta name = "robots" content = "INDEX, FOLLOW" / >
< meta name = "generator" content = "ImageMagick Studio LLC" / >
< meta name = "author" content = "ImageMagick Studio LLC" / >
< meta name = "revisit-after" content = "2 DAYS" / >
< meta name = "resource-type" content = "document" / >
< meta name = "copyright" content = "Copyright (c) 1999-2020 ImageMagick Studio LLC" / >
< meta name = "distribution" content = "Global" / >
< meta name = "magick-serial" content = "P131-S030410-R485315270133-P82224-A6668-G1245-1" / >
< meta property = 'og:url' content = 'https://legacy.imagemagick.org/' / >
< meta property = 'og:title' content = 'ImageMagick Legacy' / >
< meta property = 'og:image' content = 'https://legacy.imagemagick.org/images/logo.png' / >
< meta property = 'og:type' content = 'website' / >
< meta property = 'og:site_name' content = 'ImageMagick Legacy' / >
< meta property = 'og:description' content = "Create, Edit, Compose, or Convert Bitmap Images" / >
< meta name = "google-site-verification" content = "_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" / >
< meta name = "msvalidate.01" content = "103012B23499FEB70AEA89C83C274AC7" / >
< link href = "import.html" rel = "canonical" / >
< link href = "../images/wand.png" rel = "icon" / >
< link href = "../images/wand.ico" rel = "shortcut icon" / >
< link href = "assets/magick.css" rel = "stylesheet" / >
< / head >
< body >
< nav class = "navbar navbar-expand-md navbar-dark fixed-top bg-dark" >
< a class = "navbar-brand" href = "../index.html" > < img class = "d-block" id = "wand" alt = "ImageMagick" width = "32" height = "32" src = "../images/wand.ico" / > < / a >
< button class = "navbar-toggler" type = "button" data-toggle = "collapse" data-target = "#navbarsMagick" aria-controls = "navbarsMagick" aria-expanded = "false" aria-label = "Toggle navigation" >
< span class = "navbar-toggler-icon" > < / span >
< / button >
< div class = "navbar-collapse collapse" id = "navbarsMagick" style = "" >
< ul class = "navbar-nav mr-auto" >
< li class = "nav-item " >
< a class = "nav-link" href = "../index.html" > Home < span class = "sr-only" > (current)< / span > < / a >
< / li >
< li class = "nav-item " >
< a class = "nav-link" href = "download.html" > Download< / a >
< / li >
< li class = "nav-item " >
< a class = "nav-link" href = "command-line-tools.html" > Tools< / a >
< / li >
< li class = "nav-item " >
< a class = "nav-link" href = "command-line-processing.html" > Command-line< / a >
< / li >
< li class = "nav-item " >
< a class = "nav-link" href = "develop.html" > Develop< / a >
< / li >
< li class = "nav-item" >
< a class = "nav-link" target = "_blank" href = "https://github.com/ImageMagick/ImageMagick6/discussions" > Community< / a >
< / li >
< li class = "nav-item" >
< iframe src = "https://github.com/sponsors/ImageMagick/button" title = "Sponsor ImageMagick" height = "35" width = "107" style = "border: 0;" > < / iframe >
< / li >
< / ul >
< / div >
2023-02-03 21:24:11 +08:00
< form class = "form-inline my-2 my-lg-0" action = "https://legacy.imagemagick.org/script/search.php" >
< input class = "form-control mr-sm-2" type = "text" name = "q" placeholder = "Search" aria-label = "Search" / >
2023-02-03 21:16:55 +08:00
< button class = "btn btn-outline-success my-2 my-sm-0" type = "submit" name = "sa" > Search< / button >
< / form >
< / nav >
< div role = "main" class = "container" >
< script async = "async" src = "https://localhost/pagead/js/adsbygoogle.js" > < / script > < ins class = "adsbygoogle"
style="display:block"
data-ad-client="ca-pub-3129977114552745"
data-ad-slot="6345125851"
data-full-width-responsive="true"
data-ad-format="horizontal">< / ins >
< script >
(adsbygoogle = window.adsbygoogle || []).push({});
< / script >
< / div >
< main class = "container" >
< div class = "magick-template" >
< div class = "magick-header" >
< h1 class = "text-center" > Screenshot Utility< / h1 >
< p class = "text-center" > < a href = "import.html#usage" > Example Usage< / a > • < a href = "import.html#options" > Option Summary< / a > < / p >
< p class = "lead magick-description" > Use the < code > import< / code > program to capture some or all of an X server screen and save the image to a file. < code > import< / code > captures the window selected by clicking or program argument. See < a href = "command-line-processing.html" > Command Line Processing< / a > for advice on how to structure your < code > import< / code > command or see below for example usages of the command.< / p >
< h2 > < a class = "anchor" id = "usage" > < / a > Example Usage< / h2 >
< p > We list a few examples of the < code > import< / code > command here to illustrate its usefulness and ease of use. To get started, lets import an image of an X11 window in the JPEG format:< / p >
< pre class = "highlight" > < code > import rose.jpg
< / code > < / pre >
< p > To capture the entire X server screen in the Postscript image format:< / p >
< pre class = "highlight" > < code > import -window root screen.ps
< / code > < / pre >
< p > You can find additional examples of using < code > import< / code > in < a href = "http://www.ibm.com/developerworks/library/l-graf/?ca=dnt-428" > Graphics from the Command Line< / a > . Further discussion is available in < a href = "http://www.ibm.com/developerworks/library/l-graf2/?ca=dgr-lnxw15GraphicsLine" > More Graphics from the Command Line< / a > and < a href = "https://legacy.imagemagick.org/Usage/" > Examples of ImageMagick Usage< / a > .< / p >
< h2 > < a class = "anchor" id = "options" > < / a > Option Summary< / h2 >
< p > The < code > import< / code > command recognizes these options. Click on an option to get more details about how that option works.< / p >
< table class = "table table-sm table-hover" >
< tbody >
< tr >
< th align = "left" > Option< / th >
< th align = "left" > Description< / th >
< / tr >
< tr >
< td > < a href = "command-line-options.html#adjoin" > -adjoin< / a > < / td >
< td > join images into a single multi-image file< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#annotate" > -annotate < var > geometry text< / var > < / a > < / td >
< td > annotate the image with text< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#border" > -border< / a > < / td >
< td > include window border in the output image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#channel" > -channel < var > type< / var > < / a > < / td >
< td > apply option to select image channels< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#colors" > -colors < var > value< / var > < / a > < / td >
< td > preferred number of colors in the image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#colorspace" > -colorspace < var > type< / var > < / a > < / td >
< td > set image colorspace< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#comment" > -comment < var > string< / var > < / a > < / td >
< td > annotate image with comment< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#compress" > -compress < var > type< / var > < / a > < / td >
< td > image compression type< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#contrast" > -contrast< / a > < / td >
< td > enhance or reduce the image contrast< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#crop" > -crop < var > geometry< / var > < / a > < / td >
< td > preferred size and location of the cropped image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#debug" > -debug < var > events< / var > < / a > < / td >
< td > import copious debugging information< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#define" > -define < var > format:option< / var > < / a > < / td >
< td > define one or more image format options< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#delay" > -delay < var > centiseconds< / var > < / a > < / td >
< td > import the next image after pausing< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#density" > -density < var > geometry< / var > < / a > < / td >
< td > horizontal and vertical density of the image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#depth" > -depth < var > value< / var > < / a > < / td >
< td > image depth< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#despeckle" > -descend< / a > < / td >
< td > obtain image by descending window hierarchy< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#display" > -display < var > server< / var > < / a > < / td >
< td > get image or font from this X server< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#dispose" > -dispose < var > method< / var > < / a > < / td >
< td > layer disposal method< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#dither" > -dither < var > method< / var > < / a > < / td >
< td > apply error diffusion to image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#encipher" > -encipher < var > filename< / var > < / a > < / td >
< td > convert plain pixels to cipher pixels< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#encoding" > -encoding < var > type< / var > < / a > < / td >
< td > text encoding type< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#endian" > -endian < var > type< / var > < / a > < / td >
< td > endianness (MSB or LSB) of the image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#filter" > -filter < var > type< / var > < / a > < / td >
< td > use this filter when resizing an image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#frame" > -frame< / a > < / td >
< td > include window manager frame< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#geometry" > -geometry < var > geometry< / var > < / a > < / td >
< td > preferred size or location of the image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#gravity" > -gravity < var > type< / var > < / a > < / td >
< td > horizontal and vertical text placement< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#help" > -help< / a > < / td >
< td > print program options< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#identify" > -identify< / a > < / td >
< td > identify the format and characteristics of the image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#interlace" > -interlace < var > type< / var > < / a > < / td >
< td > type of image interlacing scheme< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#interpolate" > -interpolate < var > method< / var > < / a > < / td >
< td > pixel color interpolation method< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#label" > -label < var > name< / var > < / a > < / td >
< td > assign a label to an image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#limit" > -limit < var > type value< / var > < / a > < / td >
< td > pixel cache resource limit< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#log" > -log < var > format< / var > < / a > < / td >
< td > format of debugging information< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#monitor" > -monitor< / a > < / td >
< td > monitor progress< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#monochrome" > -monochrome< / a > < / td >
< td > transform image to black and white< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#negate" > -negate< / a > < / td >
< td > replace each pixel with its complementary color < / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#page" > -page < var > geometry< / var > < / a > < / td >
< td > size and location of an image canvas (setting)< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#pause" > -pause < var > seconds< / var > < / a > < / td >
< td > seconds delay between snapshots< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#quality" > -quality < var > value< / var > < / a > < / td >
< td > JPEG/MIFF/PNG compression level< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#quantize" > -quantize < var > colorspace< / var > < / a > < / td >
< td > reduce image colors in this colorspace< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#quiet" > -quiet< / a > < / td >
< td > suppress all warning messages< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#quiet" > -quiet< / a > < / td >
< td > suppress all warning messages< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#regard-warnings" > -regard-warnings< / a > < / td >
< td > pay attention to warning messages.< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#repage" > -repage < var > geometry< / var > < / a > < / td >
< td > size and location of an image canvas< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#resize" > -resize < var > geometry< / var > < / a > < / td >
< td > resize the image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#respect-parentheses" > -respect-parentheses< / a > < / td >
< td > settings remain in effect until parenthesis boundary.< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#rotate" > -rotate < var > degrees< / var > < / a > < / td >
< td > apply Paeth rotation to the image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#sampling-factor" > -sampling-factor < var > geometry< / var > < / a > < / td >
< td > horizontal and vertical sampling factor< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#scene" > -scene < var > value< / var > < / a > < / td >
< td > image scene number< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#screen" > -screen< / a > < / td >
< td > select image from root window< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#seed" > -seed < var > value< / var > < / a > < / td >
< td > seed a new sequence of pseudo-random numbers< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#set" > -set < var > attribute value< / var > < / a > < / td >
< td > set an image attribute< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#sharpen" > -silent< / a > < / td >
< td > operate silently, i.e. don't ring any bells< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#strip" > -strip< / a > < / td >
< td > strip image of all profiles and comments< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#synchronize" > -synchronize< / a > < / td >
< td > synchronize image to storage device< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#taint" > -taint< / a > < / td >
< td > mark the image as modified< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#transparent-color" > -transparent-color < var > color< / var > < / a > < / td >
< td > transparent color< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#trim" > -trim< / a > < / td >
< td > trim image edges< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#update" > -type < var > type< / var > < / a > < / td >
< td > image type< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#verbose" > -verbose< / a > < / td >
< td > print detailed information about the image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#version" > -version< / a > < / td >
< td > print version information< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#virtual-pixel" > -virtual-pixel < var > method< / var > < / a > < / td >
< td > access method for pixels outside the boundaries of the image< / td >
< / tr >
< tr >
< td > < a href = "command-line-options.html#write" > -window < var > id< / var > < / a > < / td >
< td > select window with this id or name< / td >
< / tr >
< / tbody >
< / table >
< / div >
< / div >
< / main > <!-- /.container -->
< footer class = "magick-footer" >
< div class = "container" >
< p > < a href = "security-policy.html" > Security< / a > •
< a href = "news.html" > News< / a >
< a href = "import.html#" > < img class = "d-inline" id = "wand" alt = "And Now a Touch of Magick" width = "16" height = "16" src = "../images/wand.ico" / > < / a >
< a href = "links.html" > Related< / a > •
< a href = "sitemap.html" > Sitemap< / a >
< br / >
< a href = "support.html" > Sponsor< / a > •
< a href = "http://pgp.mit.edu/pks/lookup?op=get&search=0x89AB63D48277377A" > Public Key< / a > •
< a href = "https://imagemagick.org/script/contact.php" > Contact Us< / a >
< br / >
< a href = "https://github.com/imagemagick/imagemagick6" target = "_blank" rel = "noopener" aria-label = "GitHub" > < svg xmlns = "http://www.w3.org/2000/svg" class = "navbar-nav-svg" viewBox = "0 0 512 499.36" width = "2%" height = "2%" role = "img" focusable = "false" > < title > GitHub< / title > < path fill = "currentColor" fill-rule = "evenodd" d = "M256 0C114.64 0 0 114.61 0 256c0 113.09 73.34 209 175.08 242.9 12.8 2.35 17.47-5.56 17.47-12.34 0-6.08-.22-22.18-.35-43.54-71.2 15.49-86.2-34.34-86.2-34.34-11.64-29.57-28.42-37.45-28.42-37.45-23.27-15.84 1.73-15.55 1.73-15.55 25.69 1.81 39.21 26.38 39.21 26.38 22.84 39.12 59.92 27.82 74.5 21.27 2.33-16.54 8.94-27.82 16.25-34.22-56.84-6.43-116.6-28.43-116.6-126.49 0-27.95 10-50.8 26.35-68.69-2.63-6.48-11.42-32.5 2.51-67.75 0 0 21.49-6.88 70.4 26.24a242.65 242.65 0 0 1 128.18 0c48.87-33.13 70.33-26.24 70.33-26.24 14 35.25 5.18 61.27 2.55 67.75 16.41 17.9 26.31 40.75 26.31 68.69 0 98.35-59.85 120-116.88 126.32 9.19 7.9 17.38 23.53 17.38 47.41 0 34.22-.31 61.83-.31 70.23 0 6.85 4.61 14.81 17.6 12.31C438.72 464.97 512 369.08 512 256.02 512 114.62 397.37 0 256 0z" / > < / svg > < / a > •
< a href = "https://twitter.com/imagemagick" target = "_blank" rel = "noopener" aria-label = "Twitter" > < svg xmlns = "http://www.w3.org/2000/svg" class = "navbar-nav-svg" viewBox = "0 0 512 416.32" width = "2%" height = "2%" role = "img" focusable = "false" > < title > Twitter< / title > < path fill = "currentColor" d = "M160.83 416.32c193.2 0 298.92-160.22 298.92-298.92 0-4.51 0-9-.2-13.52A214 214 0 0 0 512 49.38a212.93 212.93 0 0 1-60.44 16.6 105.7 105.7 0 0 0 46.3-58.19 209 209 0 0 1-66.79 25.37 105.09 105.09 0 0 0-181.73 71.91 116.12 116.12 0 0 0 2.66 24c-87.28-4.3-164.73-46.3-216.56-109.82A105.48 105.48 0 0 0 68 159.6a106.27 106.27 0 0 1-47.53-13.11v1.43a105.28 105.28 0 0 0 84.21 103.06 105.67 105.67 0 0 1-47.33 1.84 105.06 105.06 0 0 0 98.14 72.94A210.72 210.72 0 0 1 25 370.84a202.17 202.17 0 0 1-25-1.43 298.85 298.85 0 0 0 160.83 46.92" / > < / svg > < / a >
< br / >
< small > © 1999-2021 ImageMagick Studio LLC< / small > < / p >
< / div >
< / footer >
<!-- Javascript assets -->
2023-02-03 21:24:11 +08:00
< script > window . jQuery || document . write ( '<script src="assets/jquery.slim.min.js"><\/script>' ) < / script > < script src = "assets/bootstrap.bundle.min.js" crossorigin = "anonymous" / >
2023-02-03 21:16:55 +08:00
< / body >
< / html >
2023-02-03 21:24:11 +08:00
<!-- Magick Cache 1st January 2021 19:38 -->
