home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Graphics 16,000
/
graphics-16000.iso
/
msdos
/
viewers
/
glist113
/
glist113.doc
< prev
next >
Wrap
Text File
|
1990-04-03
|
7KB
|
181 lines
GIFLIST
Documentation for V1.13 02 APR 1990
/*
*
* The program and its accompanying documentation are Copyright 1989
* Dragon Technologies, Ltd. It may be freely copied and distributed as
* long as no charge is made at any point of its distribution.
*
* All rights reserved with the following exceptions:
*
* This software is supplied free of charge. This software, or any part
* of it, may not be redistributed or otherwise made available to, or
* used by, any other person without the inclusion of this copyright
* notice. This software may not be used to make a profit in any way.
*
* This software is provided with absolutely no warranty, to the extent
* permitted by applicable state law. In no event, unless required by
* applicable law, will the author of this this software be liable for
* any damages caused by this software.
*
* This software is not to be placed on CompuServe Information Service.
*
*/
GIF and Graphics Interchange Format are trademarks of CompuServe
Information Services, Inc., an H&R Block company.
If you feel GIFLIST has been of any use to you, a donation is
appreciated, though not necessary. There will be future updates to
GIFLIST, as well as other GIF/graphics utilities. A donation of $10
is suggested, and will help keep quality software such as this
available. The source code for GIFLIST (written in Microsoft C 5.0
and Turbo C 2.0) is available with a donation of $20 or more. A disk
with the source code and the latest version of GIFLIST will be returned
to you, plus it will have some of the latest and greatest DragonScans to
boot.
GIFLIST lists all files matching the file mask in the specified
directory, and examines each of these files. By default, GIFLIST
examines files in the current directory with the extension of "GIF."
If you run GIFLIST in its defaul mode, after printing a short header
containing program information, the name of each file is printed,
followed by the file size in bytes, the raster image size (HxV), the
number of colors used in the picture, and color resolution (in bits).
Options include a quiet mode, so that the headers are not printed;
not printing the color resolution information, or displaying it in bit
planes rather than bits; showing the version information; and
displaying a help screen listing options.
All information is printed on standard output, so it will be shown on
your screen as a default. Output may be redirected to a file or the
printer, or may be run through the SORT filter.
Note two versions are available. Version 1.13tc has been compiled
under Borland Turbo C 2.0. Version 1.13msc has been compiled under
Microsoft C version 5.1. Both programs function identically, with the
exception that the Turbo C version displays the time the file was listed
also. Performance is similar, but the Microsoft executable is smaller
in size. There are still minor bugs in the Turbo C version (as of this
release). These will be eventually cleared up.
Sample output:
==============
GIFLIST 1.13msc (02 APR 1990) Listed on: 02 APR 1990
Copyright 1990 Dragon Technologies (All rights reserved)
FILENAME BYTES DATE RESOLUTION/COLORS/COLOR RES
AWAITING.GIF 198656 03-12-89 640x480 256 colors 18 bits
CM.GIF 47744 07-25-88 320x200 256 colors 18 bits
SEV4.GIF 139264 06-18-89 640x480 256 colors 24 bits
SHEPFIN.GIF 139264 02-13-89 640x480 256 colors 18 bits
TDL.GIF 7035 09-08-88 320x200 16 colors 9 bits
==================
End sample output.
Usage: GIFLIST [/abdhpqrsvx] [path[mask]]
/a = ANSI mode, inserts color codes
/b = Don't show color resolution
/d = Don't display date of file
/h = Show this help screen
/p = Show bit planes instead of resolution
/q = Quiet mode-no headers
/r = RemoteAccess BBS file list (no size, no date)
/s = Show size before name
/v = Show version information
/x = Phoenix BBS file list
path defaults to ".\*.gif"
"-" may be substituted for "/" as a switch character.
Usage examples:
giflist /qb
(prints information for all *.gif files in current directory,
no headers, no color resolution information)
giflist /q /b
(same as above)
giflist /p f:\tmp
(prints information for all *.gif files in f:\tmp with bit
plane information)
giflist /s
(prints information for all *.gif files with the size first
to facilitate sorting by size)
A NOTE ABOUT COLOR RESOLUTION:
It seems that not all GIFs have this information correct in
their descriptor... Don't always believe it!
Please send comments and bug reports!
GENIE: D.BRUNETTE
CIS: 76625,2243 (Dragon Technologies)
USENET: oliveb!cdes!dragnet!dragon
INTERNET: r2d2!dragon%island.uu.net
BBS: Dragon's Lair, 415-876-0299, 2400/HST/V32 account: dragon keeper
BBS: Network 23, 415-355-7162, 1200/2400/HST/V32 account: dragon keeper
Dragon Technologies
3641 Carter Drive
So. San Francisco, CA 94080
VERSION HISTORY:
1.0 17 APR 1989 Initial release.
1.1 04 JUL 1989 Slight speed up.
Added date display.
Added list date display.
Added option to print size first.
Fixed formatting when pixel rez > 1000
Can use upper/lower case switches
1.11 07 JUL 1989 Added Phoenix BBS file list compatibility
(inserts 0x04 character in listing, and
formats dates properly for "New" listing)
Suggested by Mark Williams, Network 23 BBS
1.12 30 JUL 1989 Ported to Turbo C 2.0 (1.12tc)
Increased buffer size to stop buffer clobber
Optimized size and speed
1.13 02 APR 1989 Added RemoteAccess (and QuickBBS?)
file listings. Added ANSI color.
BUGS:
Pathname parsing isn't too hot. If you find a pathname that doesn't
work (try it a few times, see bug below), please let me know the path
you were trying to pass to GIFLIST.
The Turbo C version has real problems with the pathname parsing. It is
recommended that you only run this version of GIFLIST (tc) in the
directory where the GIF files are.
Sometimes GIFLIST will not be able to open any files in a directory,
the first time you run it in the directory. This may be an MS-C bug
but then again it may be my bug. If you get a whole line of "Cannot
open file!" errors just rerun the program. If it doesn't go away,
let me know, because it is a pathname parsing problem.
Doesn't differentiate between dates in the 20th and 21st century. In
fact, will display a wrong year number for dates beyond 2080. Then
again, WWIV software displays the wrong year for any date beyond 2000.