Copyright (C) 2000-2012 |
Manpages XLITOSection: User Commands (1)Updated: 7 Jul 1993 Index Return to Main Contents NAMExlito (XLoadImageTrailingOptions) - Append/Delete/Show a Trailing Option string in a file.SYNOPSISxlito [option] [string] files ...DESCRIPTIONxlito (XLoadImageTrailingOptions) is a utility that provides a file format independent way of marking image files with the appropriate options to display correctly. It does this by appending to a file, a string specified by the user. The string is marked with some magic numbers so that it can be extracted by a program that knows what to look for. Since almost all image files have some sort of image dimension information in the file, the programs that load or manipulate these files generally do not look beyond the point at which they have read the complete image, so trailing information is safely be hidden. If appending this information causes trouble with other utilities, it can simply be deleted.Appropriate version of xloadimage (ie. xli 1.00) will recognise these trailing options at the end of the image files, and will treat the embedded string as if it were a sequence of command line Image Options. Any Global Options will be ignored, and unlike command line image Options, Trailing Options are never propagated to other images. Old versions of xloadimage (3.01 or less) can be made forward compatible by using the -x option to pull the trailing options out of the image files, and put them on the command line where xloadimage can see them. OPTIONSThe default behavior is to display the trailing option strings (if any) of the files on the argument line. The following options change the behavior of xlito:
EXAMPLESIf fred.gif has the wrong aspect ratio, then it might need viewing with the xloadimage options:
This option can then be appended to the file by:
and from then on some new versions of xloadimage will get the appropriate options from the image file itself. Old versions of xloadimage can be made to work by using:
This can be made transparent by using a script containing something like:
The script could be called xli for instance. The options can be deleted with: AUTHORGraeme Gill Labtam Australia graeme@labtam.oz.au MAINTAINERsmar@reptiles.org COMPATIBILITY WITH IMAGE FILESSome image files are actually ascii files that are used in other contexts. X Bitmap files are an example. They are formatted as 'C' style #defines and an initialised array of characters, so that they can be included in 'C' source code. Adding trailing options would therefore render the file unusable with a compiler, since it will get a syntax error on the railing option string and the magic numbers. The solution to this is that xlito will ignore a certain amount (a few hundred bytes) after the trailing options, and uses a padding of 20 bytes before the trailing options. These two areas will be maintained when changing an existing trailing option. In the case of an X bitmap then, the solution is to edit the file and place the embedded string in some 'C' comments:
eg: say the file starts as:
and you add a trailing options:
Then the trailing options can be commented out:
BUGSxlito doesn't cope with compressed files. A files will need uncompressing, the options added, and then compressing again.
IndexThis document was created by man2html, using the manual pages. Time: 17:52:26 GMT, November 06, 2024 |