home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / utilities / utility_04 / jfif / !JFIF / readme < prev    next >
Text File  |  1993-06-26  |  7KB  |  149 lines
  1.  
  2.                                     JFIF
  3.                                     ---- 
  4.  
  5.                A Desktop interface to the CJPEG and DJPEG programs.
  6.  
  7.                               By Neil Hoggarth
  8.  
  9.  
  10. Introduction
  11. ------------
  12.  
  13. JFIF is a Desktop interface to the CJPEG and DJPEG programs distributed with
  14. the ChangeFSI application on the RISC OS 3.1 support disc. You will need
  15. this version of ChangeFSI to use JFIF.
  16.  
  17. JPEG is an algorithm for compressing digitized still pictures so that they
  18. take up less space on disc or take less time to transfer over a
  19. communications link. JFIF is a standardized file format for storing JPEG
  20. compressed pictures, which is promoted by a group called the "Independent
  21. JPEG Group", with the aim ensuring that all programs using the format will be
  22. able to inter-operate. CJPEG and DJPEG are programs written by the
  23. Independent JPEG Group to do encoding and decoding (respectively) of JPEG
  24. pictures. These programs are distibuted by Acorn with ChangeFSI and DJPEG is
  25. called by ChangeFSI as part of the process of turning a JFIF file into a
  26. Sprite. However, no way of converting Acorn Sprites into JFIF files is
  27. provided without using the command line.
  28.  
  29. This application was written in response to an article in Archive Magazine
  30. called "First Steps with JPEG" (Archive 6.9 page 45). The author of the
  31. article describes how to use CJPEG and a shareware program called "!Creator"
  32. to produce JFIF files but bemoans the fact that it cannot be achieved using
  33. ChangeFSI within the Desktop.
  34.  
  35. This application is a quick hack. It calls ChangeFSI and the CJPEG/DJPEG
  36. programs to do the real work but it provides a Desktop veneer on top of them
  37. to make them easier to use. It can convert sprite files to JFIF files and
  38. JFIF files to sprite files with only a few icon drags.
  39.  
  40. This application is free software. See the section "Copying" for details.
  41.  
  42.  
  43. Use
  44. ---
  45.  
  46. Copy JFIF into the same directory as your working copy of ChangeFSI (make a
  47. working copy if you don't have one). Open the !ChangeFSI application
  48. directory (hold down shift while double clicking) and load the !Boot file
  49. into Edit. Add the following line to the !Boot file and save it.
  50.  
  51. Set ChangeFSI$Dir <Obey$Dir>
  52.  
  53. This is necessary because the JTIF program needs to know where to find the
  54. ChangeFSI programs even if the ChangeFSI application hasn't been run.
  55.  
  56. Double click on JFIF to load it. It will install on the icon bar in the
  57. usual fashion. You convert files by draging them from a filer window to the
  58. icon on the icon bar. Files of type sprite will get converted to JFIF and
  59. files of any other type will be assumed to be JFIF files for conversion to
  60. sprite file format. When you drag an input file to the icon bar the normal
  61. type of "save as" box will appear. Simply edit the filename and drag the
  62. icon of the output file to a filer window. JFIF files produced by this
  63. application are filetyped as "JPEG" (numeric filetype hex C85) for
  64. compatibility with the FYEO application by the "ARM's Tech" group.
  65.  
  66. The icon bar menu contains four items. "Info" and "Quit" have the usual
  67. meanings. "Options" brings up a dialogue box which allows you to set the
  68. Quality option for the sprite to JFIF conversion (default 75%) and the mode
  69. of the sprite to be produced for JFIF conversions (default 21).
  70. "SaveáOptions" allows you make the current set of options into the default
  71. which will be used next time the program is started. 
  72.  
  73. The Quality option controls how much compression gets applied to the picture
  74. when doing the JPEG encoding. The number ranges from 1 to 100. The lower the
  75. number then the smaller the JFIF file produced (and the worse the picture).
  76. The default produces little visible distortion to most pictures. However the
  77. results obtained with JPEG are always picture dependent. When you are
  78. converting sprites to JFIF files I encourage you to convert the resulting
  79. file back to a sprite and check that you are happy with the results. If not
  80. then try changing the Quality figure and reprocessing the original sprite.
  81. You should retain the original sprite until you are sure that you have a
  82. satisfactory JFIF file.
  83.  
  84. Note that the JFIF to sprite conversion can be done directly in the desktop
  85. using FYEO or ChangeFSI and you might prefer to do it that way. This
  86. has the advantage that the sprite produced in the conversion is displayed in
  87. a window, so that you don't need to save the sprite file and load it into
  88. Paint (for example) to view it. In particular FYEO is capable of displaying
  89. multiple windows with different JPEG pictures in them. You can use this to
  90. compare the same picture at several different Quality figures side by side.
  91.  
  92. The program is written in C and distributed with full source code and a
  93. Makefile for AMU (in the application directory). I use release 4 of the C
  94. compiler but the program may compile under earlier versions.
  95.  
  96.  
  97. Further Reading
  98. ---------------
  99.  
  100. For a quick overview of JPEG, and the potential advantages of storing
  101. pictures in this form, I refer you to the Archive article.
  102.  
  103. You should also read the file "JPEGinfo" in the ChangeFSI application
  104. directory. This tells you about CJPEG and DJPEG and in particular explains
  105. about the effects of the Quality option on the JPEG file produced.
  106.  
  107. This application calls the ChangeFSI program to generate sprite files. You
  108. might want to look at the file "FSIinfo" in the ChangeFSI application
  109. directory. This tells you how the sprite mode which is chosen on the Options
  110. dialogue box affects the sprite output.
  111.  
  112.  
  113. Copying
  114. -------
  115.  
  116. The JFIF application is free software; you can redistribute it and/or modify
  117. it under the terms of the GNU General Public License as published by the
  118. Free Software Foundation; either version 1, or (at your option) any later
  119. version. This program is distributed in the hope that it will be useful, but
  120. WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  121. or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  122. more details.
  123.  
  124. You should have received a copy of the GNU General Public License along with
  125. this program; if not, write to the Free Software Foundation, Inc., 675 Mass
  126. Ave, Cambridge, MA 02139, USA.
  127.  
  128. A copy of the License is included in the application directory. To read it,
  129. open the application directory (hold down shift and double click) and load
  130. the file COPYING into Edit.
  131.  
  132. Note that unlike other many software authors I am happy to allow the
  133. circulation of modified version of my programs or the "borrowing" of code
  134. from my programs. All that I ask is that you document your changes (in the
  135. sources and a brief summery added to the file ChangeLog) and that you read
  136. the GNU General Public License and understand your obligations under it.
  137.  
  138.  
  139.  
  140. All bug reports, new versions, constructive critisism, etc. to the following
  141. address.
  142.  
  143.     e-mail: neil@ntlrd.demon.co.uk
  144.  
  145.     Neil Hoggarth
  146.     18 Stanmore Lane,
  147.     Winchester,
  148.     SO22 4AJ.
  149.