@database F1GP_BKG_dt.guide @master Code:Source/jpeg_ppc/release/WarpJPEGdt/WarpJPEG.guide @$VER: WarpJPEG.guide 1.0 (15.12.99) @author "Oliver Roberts (oliver.roberts@iname.com)" @(c) "Oliver Roberts 1999" @width 75 @remark Created with Heddley v1.20ß © Edd Dumbill 1994-5 @node "Main" "WarpJPEG.datatype 44.1" @{b}WarpJPEG.datatype 44.1@{ub} - a 24-bit JPEG picture datatype for PPC (WarpUp) Copyright © 1999 Oliver Roberts, All Rights Reserved. @{" Description " link "Intro" 0} What is this datatype for? @{" System requirements " link "Requirements" 0} what you need to use this software @{" Installation " link "Install" 0} installing this software @{" Distribution " link "Distribution" 0} distribution conditions @{" Disclaimer " link "Disclaimer" 0} important notices @{" Acknowledgements " link "Acknowledgements" 0} thankyous and credits @{" About the author " link "Author" 0} me, my addresses & other F1GP stuff @{" Future " link "Future" 0} improvements I intend to make @{" History " link "History" 0} program history @endnode @node "Intro" "Description" As you've probably guessed, WarpJPEG.datatype is a yet another JFIF/JPEG datatype. The difference is that this is for owners of PPC cards, and it has been targetted specifically at WarpUp (not PowerUp). Even better, it is compact, clean, free and well behaved - a true plug'n'play PPC datatype. I decided to write this datatype because no other decent WarpOS native JPEG datatype exists for the PPC, and I thought this would be the ideal chance to finally learn how to start coding PPC stuff on the Amiga. Yes, this is my first PPC project, although I have worked a lot with JPEG coding and datatype coding already, so I do know what I'm doing, honest ;) @endnode @node "Requirements" "System Requirements" This datatype needs the following in order to work: - PPC accelerator card + 68040/060 - WarpUp Release 4 (powerpc.library V15) or higher - picture.datatype v43 or higher (i.e. either of the ones supplied with AmigaOS 3.5, P96 or CGraphX) - Kickstart 3.0 or higher Note that a graphics card is @{i}not@{ui} necessary - the P96 or OS 3.5 picture.datatype will automatically dither images down to your display requirements. @endnode @node "Install" "Installation" To install this datatype, simply run the provided installer script by double-clicking the icon. Alternatively, the datatype can be installed manually (be sure to understand the @{"requirements" link "Requirements" 0} first though) by typing the following shell commands: Copy "Devs/Datatypes/JPEG#?" DEVS:Datatypes Copy Classes/Datatypes/WarpJPEG.datatype SYS:Classes/Datatypes AddDataTypes REFRESH You'll probably want to make a backup of your existing JPEG descriptor (the file in DEVS:Datatypes) first. You will also need to ensure there are no other JPEG/JFIF datatypes in DEVS:Datatypes. Finally, a reboot may be needed for the changes to take effect. @endnode @node "Distribution" "Distribution Conditions" WarpJPEG.datatype is public domain with the copyright remaining with the @{"author" link "Author" 0} and may be freely distributed legally providing: (1) None of the distributed files are changed in any way (2) It is not sold for profit and it is not included on any disks that are sold solely for profit (includes magazine coverdisks) (3) The distribution contents remain complete (see list below) If this software is to be sold for profit, permission must be obtained from me, the @{"author" link "Author" 0}. @{b}Aminet@{ub}, @{b}Amiga Format@{ub} and @{b}Amigactive@{ub} have been granted permission to distribute WarpJPEG.datatype on their CDs. The following files must be present in their original and unchanged form in any copies of this software: Classes/Datatypes/WarpJPEG.datatype Devs/Datatypes/JPEG Devs/Datatypes/JPEG.info WarpJPEG.guide WarpJPEG.guide.info Install_WarpJPEG Install_WarpJPEG.info @endnode @node "Disclaimer" "Disclaimer" This software is provided "as is", without warranty of any kind, either expressed or implied, statutory or otherwise. By using the archive and its contents, you accept the entire risk as to its quality and performance. Neither Oliver Roberts nor any other party involved in the creation, production or delivery of the archive and its contents shall be liable for any direct, indirect, special, consequential or incidental damages, including without limitation damages for loss of profits, loss of use or loss of anticipated costs, expenses or damages, and any data or information which may be lost or rendered inaccurate, even if Oliver Roberts is advised of the possibility of such damages. @{b}Do not@{ub} attempt to tamper with the supplied files. Doing so will cause problems and you may find things start going wrong! @endnode @node "Acknowledgements" "Acknowledgements" This software is based in part on the work of the Independent JPEG Group, using the libjpeg link library (compiled for WarpOS). It was made possible by VBCC, which was used to build and compile the datatype. Thanks to Volker Barthelmann and the other authors involved. Thanks also to Sam Jordan for WarpOS and helping me out with various queries regarding it. Finally, thanks to the OS 3.5 development team - now everyone has access to a 24-bit picture.datatype, I don't need to bother messing about adding dithering routines :) @endnode @node "Author" "About the author" You can contact me if you have any problems with this software, or if you have any suggestions/queries, at: e-mail: oliver.roberts@iname.com www: http://www.nanunanu.org/~oliver/ icq: 34640231 @endnode @node "Future" "Future" Some things that may appear in the future: - I'm currently experimenting with using asynchronous double-buffering techniques in the datatype, which will maybe make the datatype faster, but as I have not been able to get it working yet, I can't be sure ;( - If I can squeeze any more speed out of the datatype, I'll do so :) - WarpPNG.datatype (coming soon) If you have any other suggestions, please @{"let me know" link "Author" 0}. @endnode @node "History" "Program History" @{b}44.1@{ub} (15.12.99) - Initial release. @endnode