home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / windows / graphs / arjpapr1.arj / ARJPAPER.DOC next >
Text File  |  1993-08-04  |  14KB  |  409 lines
  1.                            
  2.                      
  3.                      
  4.                      
  5.                      
  6.                      
  7.                              A  R  J  P  A  P  E  R  
  8.                            
  9.                                       v1.0
  10.  
  11.                            
  12.                                
  13.                                
  14.                                
  15.                                
  16.                                
  17.                                
  18.                                
  19.                                
  20.                                
  21.                                
  22.                                
  23.                                
  24.                                
  25.                                
  26.                                
  27.                                
  28.                                
  29.                                
  30.                                
  31.  
  32.                                        by
  33.  
  34.                                     Ted Trost
  35.  
  36.                           
  37.                           
  38.                           
  39.                           
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                  August 4, 1993
  59.  
  60.                          Copyright (c) 1993 by Ted Trost
  61.  
  62.  
  63.  
  64. ARJPAPER                                                       Page 1 
  65.  
  66.  
  67.  
  68.  
  69.  PURPOSE                                                              
  70.  =======                                                              
  71.  
  72.    ArjPaper is a DOS-based program which automatically changes the 
  73.  Windows wallpaper settings so that each Windows session will have a
  74.  different wallpaper background.
  75.  
  76.  
  77.  FEATURES                                                             
  78.  ========                                                             
  79.  
  80.  Here are the features of the ArjPaper program:                       
  81.  
  82.    1. All wallpaper BMP files are stored in compressed form in an     
  83.       archive file created with the ARJ compression utility, thereby 
  84.       conserving disk space. (Note: ARJ is a stand alone program 
  85.       (written by Robert Jung) and is neither supplied with, nor part 
  86.       of, ArjPaper).   
  87.  
  88.    2. You specify the pool of BMP files (which are contained in    
  89.       the archive) from which Windows wallpaper may be selected. This
  90.       enables you to store all of your BMP files in one compressed 
  91.       archive (thereby conserving disk space) with the added benefit 
  92.       of only using the BMP files you specify.
  93.  
  94.    3. You specify whether a particular BMP file is to be tiled or  
  95.       untiled wallpaper.                                                   
  96.  
  97.    4. You may choose either sequential or random BMP selection.               
  98.  
  99.    5. You specify the directory + name of the WIN.INI file.          
  100.  
  101.    6. You specify the directory + name of the archive file containing
  102.       the BMPs.
  103.  
  104.    7. You specify the directory + name of the Windows wallpaper file.
  105.  
  106.    8. You specify the directory + name of the ARJ compression utility.  
  107.  
  108.    9. The parameters for all of the above options are kept in an 
  109.       easily editable file called ARJPAPER.INI.
  110.  
  111.  
  112.  
  113. ARJPAPER                                                       Page 2 
  114.  
  115.  
  116.  
  117.  
  118.  ARJPAPER.INI                                                         
  119.  ============                                                         
  120.  
  121.    Parameters for ArjPaper are stored in ARJPAPER.INI. This file must 
  122.  reside in the same directory as the ArjPaper program. The format of  
  123.  the ARJPAPER.INI file is as follows:                                 
  124.                                                                       
  125.    1. [Options] section                                               
  126.  
  127.         - Contains the following program options:                     
  128.  
  129.             a. Mode = Random | Sequential                               
  130.  
  131.                  - Indicates whether to choose the next wallpaper
  132.                    candidate randomly or sequentially.                
  133.  
  134.                  - Examples:  
  135.                      
  136.                      Mode = Random                             
  137.                      Mode = Sequential                         
  138.  
  139.             b. CurrentBmp = <bmp file number>                           
  140.  
  141.                  - <bmp file number> is the position of the current   
  142.                    wallpaper file in the [Bmps] section. Files without
  143.                    the BMP extension and files which are commented out
  144.                    are not counted.
  145.                    
  146.                  - This parameter indicates which BMP file is being   
  147.                    used as the current Windows wallpaper. It is 
  148.                    updated automatically by ArjPaper after the BMP file
  149.                    is chosen. The user may also change this value if so
  150.                    desired. 
  151.  
  152.                  - Example:  
  153.                  
  154.                      CurrentBmp = 5                             
  155.  
  156.                        - The 5th BMP file in the [Bmps] section is the    
  157.                          current Windows wallpaper.                       
  158.                                                                       
  159.  
  160. ARJPAPER                                                       Page 3
  161.  
  162.  
  163.  
  164.  
  165.    2. [Paths] section                                                 
  166.  
  167.         - ArjPaper needs to know where certain files reside on your
  168.           system. This section provides that information.
  169.         
  170.         - The required parameters are:
  171.  
  172.            a. WinIniName
  173.  
  174.                 - This is the full name of your Windows WIN.INI file.
  175.                 
  176.                 - Example: 
  177.                     
  178.                     WinIniName = c:\windows\win.ini              
  179.  
  180.            b. ArjProgName
  181.                
  182.                 - This is the full name of your ARJ compression program.
  183.  
  184.                 - Example: 
  185.                     
  186.                     ArjProgName = d:\utility\arj.exe             
  187.  
  188.            c. WinPaperName
  189.  
  190.                 - This is the full name of the Windows wallpaper file.
  191.  
  192.                 - Example: 
  193.                     
  194.                     WinPaperName = c:\windows\walpaper.bmp       
  195.  
  196.            d. ArchiveName
  197.  
  198.                 - This is the full name of the ARJ archive file which
  199.                   contains the BMP files.
  200.  
  201.                 - Example: 
  202.                     
  203.                     ArchiveName = e:\win\graphics\bmps.arj       
  204.                                                                       
  205.    
  206. ARJPAPER                                                       Page 4   
  207.    
  208.    
  209.    
  210.    
  211.    3. [Bmps] section                                                  
  212.  
  213.         - Contains the names of the BMP files (stored in the archive  
  214.           file) from which to select the Windows wallpaper, and       
  215.           whether the BMP should be tiled or untiled. IMPORTANT: the  
  216.           file must have a 'BMP' extension or it will be ignored!     
  217.           Currently, you may specify up to 497 BMP files.             
  218.  
  219.         - Format is:                                                  
  220.  
  221.             <filename>, 0 | 1                                           
  222.  
  223.           where <filename> is the name of the BMP file, and           
  224.                 0 indicates 'untiled', or                             
  225.                 1 indicates 'tiled'.                                  
  226.  
  227.         - Examples:                                                   
  228.  
  229.             LEAVES.BMP, 0                                             
  230.             MARBLE.BMP, 0                                             
  231.             SCENERY.BMP, 1                                            
  232.                                                                       
  233.    4. Comment lines                                                   
  234.  
  235.         - Any line beginning with a semi-colon (;) is considered a    
  236.           comment line. This is useful for inserting descriptive text
  237.           or temporarily removing a line from consideration by ArjPaper.  
  238.  
  239.         - Example:                                                    
  240.  
  241.             ;This is a comment line.                                  
  242.                                                                       
  243.    5. Miscellaneous                                                   
  244.  
  245.         - Blank lines, blanks within lines, and upper/lower case text 
  246.           are permitted.                                                  
  247.  
  248.         - Any line which does not fit into the sections/categories    
  249.           mentioned above is ignored.                                     
  250.                                                                       
  251.         - If the [Options] section is missing or incorrect, ArjPaper 
  252.           assumes sequential mode and uses the first BMP file in the 
  253.           [Bmps] section. ArjPaper will continue based on these 
  254.           assumptions; however, the ARJPAPER.INI file will not be 
  255.           updated.                               
  256.  
  257.         - If the [Paths] section is missing or incorrect, ArjPaper 
  258.           displays a message indicating which files it cannot locate.  
  259.           ArjPaper will then terminate since it cannot find the files 
  260.           it requires.           
  261.  
  262.         
  263. ARJPAPER                                                       Page 5        
  264.         
  265.         
  266.  
  267.  
  268.    5. Miscellaneous (continued)     
  269.         
  270.         - If the [Bmps] section is missing or there are no files listed 
  271.           with the BMP extension, ArjPaper displays an error message 
  272.           and terminates. If a file with an extension other than BMP 
  273.           is found in this section, the file is ignored. If 
  274.           untiled/tiled (0 | 1) is not specified for a particular BMP 
  275.           file, tiled is assumed.                               
  276.  
  277.         - Errors returned by the ARJ compression program itself are 
  278.           displayed by ArjPaper for the benefit of the user (e.g. file 
  279.           not found in the archive). Since ARJ is a standalone program, 
  280.           it is up to the user to determine the cause of the error 
  281.           generated by the ARJ utility.       
  282.  
  283.  The following is a sample ARJPAPER.INI file:
  284.  
  285.     ; This is a sample ARJPAPER.INI file.
  286.  
  287.     [Options]        
  288.     CurrentBmp=4
  289.     Mode=Sequential
  290.  
  291.     [Paths]
  292.     WinIniName=c:\windows\win.ini
  293.     ArchiveName=e:\bmp\bmp.arj
  294.     WinPaperName=e:\bmp\walpaper.bmp
  295.     ArjProgName=c:\util\arj.exe
  296.  
  297.     [Bmps]
  298.     EARTH.BMP,0
  299.     LEAVES.BMP,1
  300.     CALNHOBS.BMP,0
  301.     MARBLE.BMP,1
  302.     FLETCHER.BMP,0
  303.     NCC1701.BMP,0
  304.  
  305.    In the above example, the current Windows wallpaper is BMP #4 in 
  306.  the [Bmps] section, i.e. MARBLE.BMP, and it would be tiled. Since
  307.  the selection mode is 'Sequential', the next Windows wallpaper will
  308.  be FLETCHER.BMP, and it will not be tiled.
  309.  
  310.  
  311.  
  312. ARJPAPER                                                       Page 6 
  313.  
  314.  
  315.  
  316.  
  317.  USING ARJPAPER
  318.  ==============
  319.  
  320.    Before using ArjPaper, it must be configured. This is a very easy
  321.  process consisting of the following steps:
  322.  
  323.    1. Using the ARJ compression utility, place all of your BMP files
  324.       in a single ARJ archive file.
  325.  
  326.    2. Using a text editor, create the ARJPAPER.INI file. Remember, 
  327.       the ARJPAPER.INI file must reside in the same directory as the 
  328.       ArjPaper program.
  329.  
  330.    3. To run ArjPaper, at the DOS prompt, simply enter:
  331.         
  332.         ARJPAPER
  333.       
  334.       ArjPaper will run and choose the next Windows wallpaper file 
  335.       based on the parameters in the ARJPAPER.INI file. The next time 
  336.       you start Windows, it will use the new wallpaper file selected 
  337.       by ArjPaper.
  338.  
  339.    4. That's all there is to it!
  340.  
  341.  
  342.  HINT
  343.  ====
  344.    
  345.    To run ArjPaper automatically prior to starting Windows, place
  346.  the ARJPAPER command in a batch file, followed by the command you
  347.  use to start Windows. 
  348.  
  349.    For example, if the ArjPaper program and your Windows program are 
  350.  both in directories declared in your system's path statement, you
  351.  could use the following batch file to run ArjPaper and then start
  352.  Windows:
  353.  
  354.      rem W.BAT
  355.      rem
  356.      rem This batch file runs ArjPaper prior to starting Windows so I 
  357.      rem always have a new wallpaper background!
  358.      rem
  359.      rem Run ArjPaper
  360.      ARJPAPER
  361.      rem
  362.      rem Start Windows
  363.      WIN
  364.  
  365.  
  366. ARJPAPER                                                       Page 7
  367.  
  368.  
  369.  
  370.  
  371.  HOW TO CONTACT THE AUTHOR
  372.  =========================
  373.  
  374.    Comments and suggestions would be greatly appreciated.  You may 
  375.  reach me by writing to the following address:
  376.  
  377.                 Ted Trost         
  378.                 Box 38, Group 13, SS1              
  379.                 Winnipeg, MB  R3C2E8
  380.                 Canada
  381.  
  382.  
  383.  HOW TO REGISTER ARJPAPER
  384.  ========================
  385.  
  386.    ArjPaper is ShareWare.  
  387.  
  388.    You may make copies of this program and give them to others as
  389.  long as the documentation is provided with the program, both
  390.  unaltered.
  391.  
  392.    If you like ArjPaper, a registration fee of $5.00 would be
  393.  appreciated. See above for address.
  394.  
  395.  
  396.  DISCLAIMER
  397.  ==========
  398.  
  399.    The author of this software is not responsible for any damages or
  400.  loss of data due to the use of this program. No warrantees are given,
  401.  either express or implied.
  402.  
  403.  
  404.  DEDICATION
  405.  ==========
  406.  
  407.    For Fletcher...gone, but not forgotten.
  408.  
  409.