@DATABASE AddImageSize
@(C) Copyright © Vex/Shoah 1997
@$VER: AddImageSize.Guide V1.0	(18 August 1997)
@AUTHOR VEX
@REM Creation 1.0 (18 Aug 97) - Basic Text.
@WIDTH 76
@SMARTWRAP
@INDEX INDEXNODE
@NODE MAIN "AddImageSize V1.04"
@{CODE}@{JCENTER}@{FG SHINE}Add Image Size

@{FG TEXT}Version : @{FG HIGHLIGHT}1.04
@{FG TEXT}Release Date : @{FG HIGHLIGHT}20 August 1997.@{FG TEXT}
@{JLEFT}
@{BG FILL}                                                                            @{BG BACK}

@{" Introduction        " LINK INTRO} - What this program does.
@{" Distribution        " LINK DISTRIBUTION} - Legal stuff.
@{" System requirements " LINK SYSREQ} - What you need to use it.
@{" Installation        " LINK INSTALL} - How to put it on your hard drive.
@{" How to use          " LINK HOWTOUSE} - How to use. (What do you expect?)
@{" Program history     " LINK HISTORY} - Previous incarnations.
@{" Future Updates      " LINK FUTURE} - What the next version will contain.
@{" Credits             " LINK CREDITS} - Who wrote this damn thing.
@{" SHOAH               " LINK "SHOAH.Guide/MAIN"} - The best in top quality software.

@{BODY}
Please  note,  this  guide  has been designed for V40 AmigaGuide.Library and
datatypes.

@ENDNODE
@NODE INTRO "Introduction"
@{CODE}@{JCENTER}@{FG SHINE}Add Image Size

@{FG TEXT}Version : @{FG HIGHLIGHT}1.04
@{FG TEXT}Release Date : @{FG HIGHLIGHT}20 August 1997.@{FG TEXT}
@{JLEFT}
@{BG FILL}                                                                            @{BG BACK}
@{BODY}
This  program  is designed to process the image elements (IMG) within a HTML
document.   It  attempts  to  read  the image file and then update the image
element with the images width and height.


The  image  elements  within  HTML  documents  don't have to have the sizing
information  contained  within them.  However, by including these attributes
the browser will know the correct size of the image and therefore it can set
aside the required space within the document before it has loaded the image.
This  is  desirable because it saves time and means that the browser doesn't
have  to  reformat  the  display  once  it obtains the full image.  Also the
layout of the page looks a lot better when the user has turned image loading
off,  because  the browser will still set aside the correct space within the
document.


Once  you've created a HTML document (or many documents for that matter) you
can  then  use  this  program to look through the file(s) and insert all the
sizing  information  into the image elements.  This saves you the trouble of
remembering/working out the sizes of all your images.


The image elements within a HTML document look something like this...


@{FG HIGHLIGHT}<IMG SRC="Logo.GIF" ALT="My Web Page">@{FG TEXT}


After  processing  with AddImageSize, the image element would look something
like this....


@{FG HIGHLIGHT}<IMG SRC="Logo.GIF" ALT="My Web Page" WIDTH=150 HEIGHT=90>@{FG TEXT}


@ENDNODE
@NODE DISTRIBUTION "Disclaimer & Distribution"
@{CODE}@{JCENTER}@{FG SHINE}Add Image Size

@{FG TEXT}Version : @{FG HIGHLIGHT}1.04
@{FG TEXT}Release Date : @{FG HIGHLIGHT}20 August 1997.@{FG TEXT}
@{JLEFT}
@{BG FILL}                                                                            @{BG BACK}

@{JCENTER}@{FG HIGHLIGHT}@{B}DISCLAIMER@{UB}

@{FG TEXT}@{BODY}@{JLEFT}The  entire  risk  as to the quality and performance of this program is with
you.   The author and SHOAH assume no responsibility or liability whatsoever
with  respect to your use or inability to use this software.  The author and
SHOAH  is  not  responsible  for  any  loss  of data, damages to software or
hardware  that  may  result  directly  or  indirectly  from  the use of this
program.   The  author and/or SHOAH reserve the right to make changes to the
software and/or documentation without prior notice.


@{JCENTER}@{FG HIGHLIGHT}@{B}DISTRIBUTION@{UB}


@{BODY}@{FG TEXT}@{JLEFT}This  program  and  documentation  is  Copyright © August 1997 Vex/Shoah.
This  program  is  freeware, it may be freely distributed for non-commercial
purposes only.


A  charge  of  NO  MORE  than  two  (2)  UK  pounds  may  be charged for the
distrubution  of  these  files  (  If  you  have paid more, then please send
details to the Author ).


If  you  wish  to place this program on coverdisks or CD-ROMs or to use this
within a commercial product, then you must contact @{" me " LINK CREDITS 22} before hand. This is
to  ensure  that you have the most recent and upto date version.  I may also
ask  for a copy of the magazine/CD-ROM or Commercial product.  Permission is
hereby  granted for this program and related files to be archived and placed
on Aminet (including Aminet CD-ROMs).

@ENDNODE
@NODE SYSREQ "System Requirements"
@{CODE}@{JCENTER}@{FG SHINE}Add Image Size

@{FG TEXT}Version : @{FG HIGHLIGHT}1.04
@{FG TEXT}Release Date : @{FG HIGHLIGHT}20 August 1997.@{FG TEXT}
@{JLEFT}
@{BG FILL}                                                                            @{BG BACK}
@{BODY}
Add  Image  Size should run on any machine with Workbench and Kickstart 3.0.
The program needs the following standard system libraries...


@{FG SHINE}Datatypes.Library@{FG TEXT}


You  will  need an appropriate datatype for each of the images that you wish
the program to recognise.

@ENDNODE
@NODE INSTALL "Installation"
@{CODE}@{JCENTER}@{FG SHINE}Add Image Size

@{FG TEXT}Version : @{FG HIGHLIGHT}1.04
@{FG TEXT}Release Date : @{FG HIGHLIGHT}20 August 1997.@{FG TEXT}
@{JLEFT}
@{BG FILL}                                                                            @{BG BACK}
@{BODY}

To  install  this  program  simply  copy  the  executable  @{FG SHINE}AddImageSize@{FG TEXT} to
anywhere you want.  I recommend that you put it somewhere within your search
path, otherwise you'll have to use it's full pathname to run it.

@ENDNODE
@NODE HOWTOUSE "How to use the program"
@{CODE}@{JCENTER}@{FG SHINE}Add Image Size

@{FG TEXT}Version : @{FG HIGHLIGHT}1.04
@{FG TEXT}Release Date : @{FG HIGHLIGHT}20 August 1997.@{FG TEXT}
@{JLEFT}
@{BG FILL}                                                                            @{BG BACK}
@{BODY}
@{FG SHINE}AddImageSize@{FG TEXT} is a CLI only program.  It has the following template.


@{FG HIGHLIGHT}FILE/A,NOBACKUP/S@{FG TEXT}


@{FG HIGHLIGHT}FILE@{FG TEXT}   -   Must   be   specified,   and   can   be   any  standard  AmigaDOS
filename/pathname.  It can include AmigaDOS pattern matching characters.


@{FG HIGHLIGHT}NOBACKUP@{FG TEXT}  -  Normally  AddImageSize  makes  a  backup  copy  of each file it
processes.   It  does  this  by  creating a file, with the original name and
appending ".bak" to it.  If you trust this program completely and don't want
your   files  backed  up  then  specifing  the  @{FG HIGHLIGHT}NOBACKUP@{FG TEXT}  option  will  stop
AddImageSize from creating these backup files.  @{BG TEXT}@{FG SHINE}USE AT YOUR OWN RISK!@{FG TEXT}@{BG BACK}


So,  for  example,  if  you  want  to  process just one file in your current
directory then you'd use the following command in a shell...


	@{FG SHINE}AddImageSize Index.HTML@{FG TEXT}


If you want all the files with a ".HTML" extension processed, and you didn't
want any backup files then you'd use the following...


	@{FG SHINE}AddImageSize #?.HTML NOBACKUP@{FG TEXT}


This  would process all the ".HTML" files in the current directory.  You can
specify the full pathname for the files.  However each image file within the
document  is  loaded  relative to the current directory.  So if your current
directory was DH1:  and you execute the command...


	@{FG SHINE}AddImageSize DH1:WebPages/Index.HTML@{FG TEXT}


All  the  images  would  be read relative to DH1:, so if the Index.HTML file
contained the following element...


	@{FG SHINE}<IMG SRC="Logo.GIF" ALT="My Web Page">@{FG TEXT}


The  program  would  attempt to read the Image from DH1:Logo.GIF rather than
DH1:Projects/Logo.GIF.   Therefore  it  is  necessary  to make sure that the
current directory is set correctly before you process the files.


(I may change this in a future update.)

@ENDNODE
@NODE HISTORY "Program History"
@{CODE}@{JCENTER}@{FG SHINE}Add Image Size

@{FG TEXT}Version : @{FG HIGHLIGHT}1.04
@{FG TEXT}Release Date : @{FG HIGHLIGHT}20 August 1997.@{FG TEXT}
@{JLEFT}
@{BG FILL}                                                                            @{BG BACK}

  @{FG SHINE}01.04@{FG TEXT} - 20/08/97 @{FG HIGHLIGHT}--+ First Public Release +--@{FG TEXT}

  @{FG SHINE}01.03@{FG TEXT} - 18/08/97 Added stats display.
                   Only adds comment string when it's not already present.
                   Added error checking code.

  @{FG SHINE}01.02@{FG TEXT} - 17/08/97 All main code now works.
                   Added pattern matching. Seems to work fine.
                   Added File Backup.

  @{FG SHINE}01.01@{FG TEXT} - 17/08/97 Program can find the IMG element, and the attributes
                    for SRC, WIDTH & HEIGHT.
                   Next thing to do is load in the graphics and output
                    a new IMG element tag.

  @{FG SHINE}01.00@{FG TEXT} - 16/08/97 Creation.

@ENDNODE
@NODE FUTURE "Future"
@{CODE}@{JCENTER}@{FG SHINE}Add Image Size

@{FG TEXT}Version : @{FG HIGHLIGHT}1.04
@{FG TEXT}Release Date : @{FG HIGHLIGHT}20 August 1997.@{FG TEXT}
@{JLEFT}
@{BG FILL}                                                                            @{BG BACK}

I'm  not  sure if there's much else to add to this program.  Any suggestions
you might have, then feel free to get in touch.  See the @{"Credits" LINK CREDITS} section for
how to contact me.

@ENDNODE
@NODE CREDITS "Credits"
@{CODE}@{JCENTER}@{FG SHINE}Add Image Size

@{FG TEXT}Version : @{FG HIGHLIGHT}1.04
@{FG TEXT}Release Date : @{FG HIGHLIGHT}20 August 1997.@{FG TEXT}
@{JLEFT}
@{BG FILL}                                                                            @{BG BACK}

This  program  was  designed and created by @{FG SHINE}Vex /Shoah.@{FG TEXT}

The program and documentation are copyright © August 1997. Please see the
@{"distribution" LINK DISTRIBUTION} section for more details.

This program is Freeware, but you are more than welcome to send me something
if  you think I deserve something for my effort....  Anything from E-Mail to
Money or Job offers are welcome....  :)

AddImageSize was created using DICE C 2.07.56R and CygnusEd Pro V3.5.

The  original  idea  for  this  program came from a conversation with Andrew
Cavers  regarding  the  HTML  Map Maker program.  Thanks for the inspiration
Andrew I hope you like this program.

Check  out  Shoah's  @{"HTML Map Maker" LINK "SHOAH.Guide/HTMLMAPMAKER"} available to download from the Shoah Web
Site and Aminet.

Greetings to all the following...

Squize,  Liane,  D!ck,  Phil,  Sarah,  Furie, Firkin, Maz, Paul, Emma, Doug,
Debs,  Ali,  Nils,  Ray,  Stephen,  Paul M., Andrew Cavers and everyone whos
names escape me at the moment.

To contact the author of this program, try any of the following.

@{FG FILL}E-MAIL:@{FG TEXT}

	Vex_@HotMail.Com 	or 	Vex@Beer.Com

@{FG FILL}MAIL:@{FG TEXT}

	Vex /Shoah
	58 Cambridge Street,
	Stafford.
	Staffs.
	England.
	ST16 3PG.

@{FG FILL}HOME-PAGE:@{FG TEXT}

	HTTP://WWW.GeoCities.Com/Area51/Cavern/7340

To contact Shoah in general use either the above addresses or...

@{FG FILL}E-MAIL:@{FG TEXT}

	Shoah_@HotMail.Com

@{FG FILL}MAIL:@{FG TEXT}

	Squize /Shoah
	15 Roseberry Road,
	Grays,
	Essex,
	RM17 5YT

@{FG FILL}SHOAH HOME-PAGE:@{FG TEXT}

	HTTP://WWW.GeoCities.Com/SiliconValley/Way/7340

@ENDNODE
