Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files




Download 33.88 Kb.
NameAnybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files
A typeBooks
manual-guide.com > manual > Books
IIPImage JPEG2000

This Readme file includes information about IIPImage with support of JPEG2000 images, information about usage, advanced configuration and troubleshooting of installation and uninstallation problems.

1. What is IIPImage:

IIPImage is a light-weight client-server system for fast and efficient online viewing and zooming of ultra high-resolution JPEG2000 and TIFF images. It is designed to be bandwidth and memory efficient and usable over a slow Internet connection even on gigapixel size images. The IIPImage server is compatible with a large number of client-side viewers. You can use either pure web viewers (written only in HTML/JavaScript) or plugin-based viewers using Adobe Flash, Silverlight or Java. Even applications such as Seadragon for Apple iPhone or Google Earth for Mac/Linux/Windows can display your image distributed with IIPimage software.

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free IIPImage software to publish the images to the web directly from JPEG2000 or TIFF files.

IIPImage streams images to the user through either the IIP protocol (Internet Imaging Protocol) to one of the native clients or also in the latest releases via the Zoomify or Deep Zoom tile protocol.

Any Zoomify or Deep Zoom compatible viewer can, therefore, be used for easy online panning and zooming of the published images.

Neither the distribution nor the use of this application should be for financial return!

IIPImage is available for free, under an open source license (GNU GPL). It is FastCGI-based and can be embedded in most web servers. JPEG2000 support has been enabled via the Kakadu JPEG2000 library, which provides one of the fastest implementations of the JPEG2000 ISO standard and is redistributable for non-commercial use only.

2.Usage:

2.1 How to convert my images into JPEG2000?

There are many tools able to convert existing images into .JP2 format. One is included with installation. To convert files into jp2 format with attached application “JPEG2000 Transcoder”, do the following:

1. Start application, you will see graphic interface.

2. Choose files (one or more) you wish to convert to jp2 format.

3. Choose output directory, where you want store your images. In default, it is set to IIPImage Images directory

4. Choose most suitable profile for your needs, detailed information is visible in Profile Information text box. You can add your own profiles by modifying file configuration.ini in application directory.

5. Click Transcode button

You can find more detailed manual also in application menu under Help -> How to use transcoder. Please note that attached application is for non-commercial use.

Also you can use for batch processing freely available tools distributed with the Kakadu JPEG2000 Library: for encoding (kdu_compress), transcoding (kdu_transcode), viewing with metadata and file structure display (kdu_show):

You can download them for free for Windows, Mac and Linux at: http://www.kakadusoftware.com/

Please read the documentation attached to these tools.

2.2 How can I view my JPEG2000 image in browser with IIPImage?

Copy image that you want to folder Images in your virtual directory, you have created during Installation, you can find shortcut to this folder also in Start menu. In default settings folder is in Public Documents folder accessible through Documents.

Then start browser and put there address to index.html, again shortcut can be find in Start menu.

In default address is http://localhost/imageserver/index.html, but word imageserver may vary depending on how you named your virtual directory. You should now see the demo image.

For your own image put at the end of address ?image=nameOfImage. So with default settings and your image named MyImage.jp2, you should put something like this: is http://localhost/imageserver/index.html?image=MyImage.jp2

3. Advanced configuration of server:

If you want configure startup variables click Start button, write inetmgr, press enter and then click on FastCGI Settings button. Choose appropriate item and click Edit. Then click on Environment variables and put there settings from this list.

Startup variables (all optional):

LOGFILE The log file the module will (attempt) to write to. If no value is given, no log will be written. Make sure the server process has write access to this directory. Paths with spaces in them may not work correctly.

VERBOSITY The level of logging. 0 means no logging, 1 is minimal logging, 2 lots of debugging stuff and 3 even more debugging stuff and 6 a very large amount indeed. Logging is only enabled if LOGFILE has also been defined.

JPEG_QUALITY The default JPEG quality factor for compression when the client does not specify one. The value should be between 1 (highest level of compression) and 100 (highest image quality). The default is 75.

MAX_IMAGE_CACHE_SIZE Max image cache size to be held in RAM in MB. This is a cache of the compressed JPEG image tiles requested by the client. The default is 10MB.

FILESYSTEM_PREFIX This is a prefix automatically added by the server to the beginning of each file system path. This can be useful for security reasons to limit access to certain sub-directories. For example, with a prefix of “/home/images/” set on the server, a request by a client for “image.tif” will point to the path “/home/images/image.tif”. Any reverse directory path component such as ../ is also filtered out. No default value.

MAX_CVT Limits the maximum image dimensions in pixels (the WID or HEI commands) allowable for dynamic JPEG export via the CVT command. This prevents huge requests from overloading the server. The default is 5000.

MAX_LAYERS The maximum number of quality layers the client is allowed to decode for images that support progressive quality encoding, such as JPEG2000. Ignored for other file formats. The default is 1.

FILENAME_PATTERN Pattern that follows the name stem for a multispectral or 3D panoramic image sequence. eg: “_pyr_” for FZ1_pyr_000_090.tif. In this example, just supply FZ1 to the FIF command. The “000″ indicates the vertical angle and “090″ the horizontal. This is only relevant to such multiple image sources. The default is “_pyr_”.

WATERMARK (iipsrv-0.9.9 or later) TIFF image to use as watermark file. This image should be not be bigger the tile size used for TIFF tiling. If bigger, it will simply be cropped to the tile size. If smaller, the watermark will be positioned randomly within the available space. The image can be either colour or grayscale. See this section on watermarking for more information on how to create and use watermarks with iipsrv.

WATERMARK_PROBABILITY (iipsrv-0.9.9 or later) The probability that a particular tile will have a watermark applied to it. 0 means never, 1 means always.

WATERMARK_OPACITY (iipsrv-0.9.9 or later) The opacity (between 0 and 1) applied to the watermark image.

MEMCACHED_SERVERS (iipsrv-0.9.9 or later) A comma-delimitted list of memcached servers with optional port numbers. For example: “localhost,192.168.0.1:8888,192.168.0.2″.

MEMCACHED_TIMEOUT (iipsrv-0.9.9 or later) Time in seconds that cache remains fresh. Default is 86400 seconds (24 hours).

DECODER_MODULES Comma separated list of external modules for decoding other image formats. This is only necessary if you have activated --enable-modules for ./configure and written your own image format handler(s).
4. TROUBLESHOOTING:

a) Installation:

You may experience following error: "CRITICAL ERROR: Error occurred during installation or configuration of IIS. Please read Readme.txt file for information how to solve this problem."

In that case or in case of any windows error during installation, you may try to start console as Administrator (Start -> type cmd.exe right click on icon and choose Run as Administrator) and paste there following line and press enter:

Start /w pkgmgr /iu:IIS-WebServerRole;IIS-WebServer;IIS-CommonHttpFeatures;IIS-StaticContent;IIS-DefaultDocument;IIS-DirectoryBrowsing;IIS-HttpErrors;IIS-HealthAndDiagnostics;IIS-HttpLogging;IIS-LoggingLibraries;IIS-RequestMonitor;IIS-Security;IIS-RequestFiltering;IIS-HttpCompressionStatic;IIS-WebServerManagementTools;IIS-ManagementConsole;WAS-WindowsActivationService;WAS-ProcessModel;WAS-NetFxEnvironment;WAS-ConfigurationAPI;IIS-CGI

After that try uninstall program and install it again.



Advanced troubleshooting:

If procedure above didn't work, you may try next procedure, which should be used only by advanced users.

Copy following lines into text file named configuration.bat:

%windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi /+"[fullPath='%~1\iipsrv.exe',arguments='',maxInstances='4',idleTimeout='300',activityTimeout='30',requestTimeout='90',instanceMaxRequests='200',protocol='NamedPipe',flushNamedPipe='False']" /commit:apphost

%windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi /+"[fullPath='%~1\iipsrv.exe'].environmentVariables.[name='FILESYSTEM_PREFIX',value='%~4\']" /commit:apphost

%windir%\system32\inetsrv\appcmd.exe add vdir /app.name:"Default Web Site"/ /path:/%2 /physicalPath:%3

%windir%\system32\inetsrv\appcmd.exe unlock config -section:system.webServer/handlers

%windir%\system32\inetsrv\appcmd.exe set config "Default Web Site/%~2" /section:handlers /+"[name='IIPImageFcgiHandler',path='*.fcgi',verb='*',modules='FastCgiModule',scriptProcessor='%~1\iipsrv.exe',resourceType='Unspecified',requireAccess='Execute']"

%windir%\system32\inetsrv\appcmd.exe set config "Default Web Site/%~2" /section:handlers /accessPolicy:Read,Script,Execute

Then start console as Administrator and in console go to folder where is located your configuration.bat file and write line similar to this:

configuration.bat "Path to application folder" "Name of virtual directory" "Path to virtual directory" “Path to Images Directory”

For example, in default settings you should write something similar to this:

configuration.bat "C:\Program files\IIPImage JPEG2000" "imageserver" " C:\Program files\IIPImage JPEG2000\virtual-directory" "C:\Users\Public\Documents\IIPImageServer"

Execute this command and try open image in browser again.



b) Uninstallation:

You may experience following error: "ERROR: Error occured during removing virtual directory or FCGI application. Please remove it manually."

In that case, click on Start button, write inetmgr and press enter. Double click on FastCGI Settings right click on the appropriate item and click remove.

Then on the left side click Webs, then Default Web Site, then imageserver (or whatever you named your directory), right click and choose remove.

If you don't remove these things, nothing bad happens, they will just stay there.

Share in:

Related:

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconAbstract Immersive stereoscopic imaging requires sharp wide field...

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconProduced by Annie McGuire. This book was produced from scanned images...

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconWelcome to audicy! Last Updated 03May99 introduction the disk images...

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconSeaShore is a free program available only for Macs that also allows...

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconThese are just four of the 50 stunning paintings on display in the...

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconProfile Commended for reliability and trustworthiness. Extensive...

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconAbstract a software library is presented for processing and analyzing...

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconO Users can comment on individual images

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files icon155 chan jb images photography

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconBlack & White Images to Paint

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconT oday, Wednesday 4 September 2013 at 1600 utc, WikiLeaks released...

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconMoving Images and Sound Archiving Study

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconOfficial images and information will be issued on Friday, February 25

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconResearch by Shun & Yunjie (2006) showed that there are product types,...

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files icon[image: /templates/s40 restyle 1/images/sapelink png]

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconX-rays, clinical images and ecgs are reproduced in this document without owner’s consent

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconThe images (photos) may not be used, uploaded, reposted, or reproduced...

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconTesting maps with the Web Developer Toolbar 25

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconUser Manual Quick operation guide Remark:Images for reference only! Key function

Anybody who wants stunning online presentations of scanned documents, paintings, maps, books, newspapers or other high-resolution images can use the free iipimage software to publish the images to the web directly from jpeg2000 or tiff files iconDomain Resolution Configuration Files




manual




When copying material provide a link © 2017
contacts
manual-guide.com
search