home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / zip / utility / desktop1.arc / DESKTOP.TXT < prev    next >
Text File  |  1989-08-01  |  6KB  |  132 lines
  1.  
  2. This ARC file contains the next files:
  3.  
  4. - DESKTOP1.PRG
  5. - DESKTOP2.PRG
  6. - DESKTOP1.ACC
  7. - DESKTOP2.ACC
  8. - DESKTOP3.ACC
  9. - DESKTOP.TXT   (This text)
  10.  
  11. The primary concern of all these programs/accesorys is to  change 
  12. the  desktop gray in the monochrome high-resolution with a  Degas 
  13. (Elite) file.
  14.  
  15. -----------------------------------------------------------------
  16.  
  17. -  DESKTOP1.PRG is the simplest of them all:  put it in the  AUTO 
  18. folder  of your boot device and put DESKTOP.PI3 in the same  AUTO
  19. folder or in the root directory.  This picture will be loaded and 
  20. will appear every time the desktop has to be (re)drawn.  If  this 
  21. picture does not exist an error message wil be given (***  Error: 
  22. DESKTOP.PI3 ??  ***).  If the picture is not 32034 bytes or  more 
  23. long  it will be loaded,  but a warning will be  given  (Warning: 
  24. DESKTOP.PI3<32000).
  25.  
  26. (Project version 1.0).
  27.  
  28. This  version has no bugs!  The program is as short  as  possible 
  29. (since files are written to disk in clusters of 1024 bytes,  pro-
  30. gram  lengths  should be just under a 1024 boundary.  It  has  no 
  31. advantages  to make a file of just 120 bytes,  because  it  still 
  32. needs 2 sectors on disk!!).
  33.  
  34. - DESKTOP1.ACC is the simplest accessory: it loads DESKTOP.PI3 or 
  35. DESKTOP.PC3 (the Degas form of compression) from the root  direc-
  36. tory.  After the start-up it is possible to reload a Degas  file: 
  37. click   on the 'Desktop Picture' menu at the   accessories,   and  
  38. an  alertbox  will  ask  you whether  you  want  a  new  picture,  
  39. (de)select  the old gray background or do  nothing.  Clicking  on 
  40. 'New'  displays the  fileselectbox with all the P?3 files on  the 
  41. device  and  the name of the picture in the background memory  at 
  42. this moment. Just try it out ...
  43.  
  44. (Project version 2.01).
  45.  
  46. This version has no problems when no other GEM vector programs or 
  47. accessories are used.  With the 'Show' option of the desktop or a 
  48. TOS or TTP program the original GEM vector is reinstalled by  the 
  49. system,  so this accessory then reinstalls its own  vector.  When 
  50. other GEM vector programs are used,  the vectors get mixed up and 
  51. your computer will at least bomb. In this cases you can use
  52.  
  53. - DESKTOP2.ACC,  which is similar to DESKTOP1.ACC, except for the 
  54. GEM  vector reinstallment.  When you have troubles using  one  of 
  55. them, you should be able to use the other.
  56.  
  57. (Project number 2.02).
  58.  
  59. I  have troubles with GEMKEY and DESKTOP when they are booted  in 
  60. the reverse order (!),  so I'm using this version. When GEMKEY is 
  61. booted before DESKTOP the 2.01 version should be used (you should 
  62. be able to see why now ...).
  63.  
  64. -  DESKTOP2.PRG is an advanced version of 1.0:  it does the  same 
  65. and something extra. Since the 1.0 version has no bugs (but it is 
  66. not possible to reload a picture) it should be able to obtain the 
  67. picture  adress from the AUTO program and use this in  an  acces-
  68. sory!  That  is exactly what DESKTOP2 does:  when you're  calling 
  69. vs_clip(handle,-1,clip) with  clip[0]=0,  clip[1]=0,  clip[2]=639 
  70. and clip[3]=399,  and the interior and style are set to 2 and  4, 
  71. you   obtain   the picture adress in  *(long   *)(intout+4).   To  
  72. control  whether  DESKTOP2  has been  installed  *(long  *)intout  
  73. contains 'N_DP' ($4e5f4450) when the picture adress is valid or a 
  74. 0  when it  is  not.  More  information in the sources  of  these 
  75. programs which are in another ARC file.
  76.  
  77. (project number (1.1).
  78.  
  79. This program has no bugs.  The intout array normally returns  no-
  80. thing when vs_clip() is called.  If DESKTOP2.PRG is not resident, 
  81. the  normal  version of vs_clip(handle,1,clip)  is  carried  out, 
  82. which has no negative effects, because it clips the output to the 
  83. whole screen!  When you're using BIGSCRN or similar programs  you 
  84. should call vs_clip again with the actual screen sizes.
  85.  
  86. - DESKTOP3.ACC is the accessory that uses DESKTOP2.PRG.  The pic-
  87. ture adress is asked by the accessory and given by the AUTO  pro-
  88. gram.  It is now possible to reload a picture at this adress with 
  89. this accessory.
  90.  
  91. (project number 2.03).
  92.  
  93. This accessory does not (re)install its own GEM vector,  so there 
  94. should not be any any errors with other programs/accessories.
  95.  
  96. -----------------------------------------------------------------
  97.  
  98. When  all  you want is a PI3 file as background  you  should  use 
  99. version 1.0.  If you want to be able to change the  picture,  and 
  100. don't  use any (other) fancy accessories you should  use  version 
  101. 2.01.  If that does not work you should try 2.02.  If you want to 
  102. be  able  to  change  the desktop  picture  even  from  your  own 
  103. application you should use the combination of 1.1 and  2.03.  How 
  104. this  can  be done is mentioned in principle.  As  you  can  see: 
  105. there's  a  solution to every problem  (well,  every  ...:  these 
  106. programs  do  all  kind  of  weird  things  when  used  on  other 
  107. resolutions than high!).
  108.  
  109. -----------------------------------------------------------------
  110.  
  111. The  sources  of these programs are in another  ARC  file.  These 
  112. sources and the programs in this ARC file are all Public  Domain, 
  113. which means that they should not be sold,  but copied only. It is 
  114. not more then logical that the name of the author is mentioned in 
  115. programs using this source(s)...
  116.  
  117. For  remarks,   critics,   wishes,  questions  or  cheques  don't 
  118. hesitate to contact the author.
  119.  
  120. -----------------------------------------------------------------
  121.  
  122. Noud van Kruysbergen
  123. Nijmegen   Institute  for  Cognition  Research  and   Information 
  124. Technology (NICI)
  125. P.O. Box 9104
  126. 6500 HE Nijmegen
  127. The Netherlands
  128.  
  129. email: kruysbergen@hnykun53.bitnet
  130.  
  131.  
  132.