ico2png

The ico2png utility is used to collect all the images for a system for browser client. It creates an image_manifest file used by KCML to map a filename in the file system to a url.

Operation

Typical command-line invocation is

ico2png -s /user1/DRIVE/sw -d /user1/apache/SHOWROOM/images -m $KBIN/image_manifest -u apache

The -s flag specifies a directory where images can be found. It will recurse into subdirectories. The -s flag can be specified more than once.

The -d specifies the target for where images will be created for apache to find. For each found it will either create a hard link to the existing image, or in the case of icon files expand out each image in the icon file to a separate image file, appending the dimensions of the image to the filename. For each image it also creates an equivalent image in greyscale to for when the image must be represented as disabled.

The -m flag specifies the filename where the manifest will be created. The manifest file lists all the images found and the available sizes and is used by KCML to map filenames to the url used by the client.

The -u flag is only used on Linux and is used to specify the user apache runs as. When specified all files and links created in the destination directory have read access to the specified user granted. To do this it uses Access Control Lists which must be enabled on the file system.

Long argument Short argument Description
--version -v Show version info
--help -? Show help info
--html-help Show help info in html format
--src -s Source directory
--dst -d Target directory
--stock -t Stock directory
--manifest -m Manifest file
--user -u Name user to be given acl read access (typically apache). Linux only.
--quiet -q Display no output
--copy -c Copy files rather than create hard link

See also:

Browser Client Layout