home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / d / drwimp / DrWimp / Examples / !PrintTest / Text < prev   
Encoding:
Text File  |  1997-01-17  |  16.6 KB  |  397 lines
  1. If updating from older versions of the library, take note of the altered
  2. sections (started with "****") which will point out possible changes in
  3. parameters and/or returned results for exsisting functions which are not
  4. backwards compatible.
  5. New user functions which have been added, *must* be added to exsisting
  6. !RunImage files if using a new version of DrWimp. Copy the 'blank' ones from
  7. the new !RunImage. New user functions are also marked by "****".
  8.  
  9. See also the file “Upgrading” which lists the non-backwards compatible
  10. changes in more detail.
  11.  
  12. History of the DrWimp system.
  13.  
  14.  
  15. 1.00 (29-Mar-95) Limited release for testing and evaluation.
  16.  
  17.  
  18. 1.01 (04-Apr-95)
  19.  
  20. --Added  :
  21.            PROCwimp_putmenuitem
  22.            PROCwimp_removemenuitem
  23.            PROCwimp_recreatemenu 
  24.            FNwimp_createmenuarray
  25.            PROCwimp_recreatemenuarray
  26.            PROCwimp_putmenutitle
  27.            PROCwimp_singlepoll
  28. --Altered:
  29.            ****FNwimp_createmenu - extra parameter to set the maximum number
  30.   of items allowed.
  31.            ****FNwimp_iconbar - now returns window handle instead of icon
  32.   handle in the window. In other words, it returns -2.
  33. --Improved all sections relating to indirected menu items. In particular, all
  34.   items longer than 11 characters are now indirected. Used to be items longer
  35.   than 12.
  36. --If iconbar icon has text underneath, then the background is no longer
  37.   filled, spoiling textures.
  38. --The icon positioning vertically has been tweaked.
  39. --Added !FontRun as an example.
  40.  
  41.  
  42. 1.02 (19-Apr-95)
  43.  
  44. --Vastly simplified and improved menu selection routines. Now doesn't use the
  45.   rubbish menu decoding SWI. As a result, full stops can now be used in menu
  46.   items. (I was converting item numbers into the item text, then back again!)
  47. --Added !Saver as an example. !RunImage files of examples commented.
  48. --Added text version of manual.
  49. --Altered:
  50.            ****FNwimp_initialise - last (fourth) parameter removed due to
  51.   simplification of menu decoding.
  52.            PROCwimp_iconenable - now works properly, instead of toggling the
  53.   greying out of the icon.
  54. --Refined manual to remove ambiguities.
  55. --Bug fixed. When mode was changed or desktop left, when returning, the panes
  56.   would move behind their 'parent' windows.
  57.  
  58.  
  59. 1.03 (26-Apr-95) 
  60.  
  61. --Altered:
  62.            PROCwimp_puticontext - now redraws icon after text has been
  63.   changed, so icons that are not filled don't muck up.
  64.            ****FNwimp_initialise - fourth parameter added to give the minimum
  65.   version number of the OS multiplied by 100, that the application is allowed
  66.   to run on.
  67.            FNwimp_iconbar - adjusted size of bounding box so that icons
  68.   without text below cannot have their tops rubbed out.
  69.            PROCwimp_iconbarsprite - fixed bug that stopped the sprite being
  70.   changed when the icon had no text underneath. When icon changes, DrWimp now
  71.   only updates the icon, and not the entire iconbar.  
  72. --Fixed two bugs that stopped FNwimp_errorchoice from working.
  73.  
  74.  
  75. 1.04 (16-May-95)
  76.  
  77. --Fixed bug in PROCwimp_puticontext (introduced in 1.03 by accident) which
  78.   stopped it from working.
  79. --Applications can now be quitted inside PROCwimp_singlepoll, ie. from menu
  80.   choices etc, while using this method of polling.
  81.  
  82.  
  83. 1.05 (28-May-95)
  84.  
  85. --Added  :
  86.            PROCwimp_bar - allows manipulation of bars very easy. Useful for
  87.   showing percentage done of an operation.
  88. --Fixed bug in PROCwimp_iconbar that crashed the application when you tried to
  89.   put an icon on the iconbar with no text below it!!
  90. --Added a contents page to the manual.
  91. --Added !Bar example application.
  92.  
  93.  
  94. 1.06 (15-Jun-95)
  95.  
  96. --Fixed bug so that when saving a file, it has the correct filetype specified
  97.   in the data_save message, instead of it always being &FFD.
  98. --Also, made sure that the leafname specified in the data_save message is zero
  99.   terminated. I missed this off, but have only just noticed because !Paint is
  100.   the first application that I have saved files from that has complained.
  101. --Fixed bug in PROCwimp_bar that only let it work in windows with handle
  102.   main%!!
  103.  
  104.  
  105. 1.07 (23-Jul-95)
  106.  
  107. --Added  :
  108.            PROCwimp_pollidle - if NULL=TRUE then it will call PROCuser_null
  109.   only every so many seconds instead of every time control is passed to the
  110.   app and no events have occured.
  111.  
  112.  
  113. 1.08 (20-Aug-95)
  114.  
  115. --Fixed problem with bars (controlled with PROCwimp_bar), in that no bar now
  116.   appears for a bar of zero length.
  117.  
  118.  
  119. 1.10 (24-Dec-95)
  120.  
  121. --Added  :
  122.            ****PROCuser_menuopen - called just before the menu is opened. Icon
  123.   pointer was over is passed.
  124.            ****PROCuser_minmenuwidth - return a number guarantees the menu to
  125.   be at least that width in characters.
  126.            PROCwimp_render - renders a drawfile.
  127.            PROCwimp_initdfiles - sets up blocks of memory for use with
  128.   drawfiles.
  129.            FNwimp_measurefile - measures size of drawfile.
  130.            FNwimp_loaddfile - loads drawfile into block of memory.
  131.            PROCwimp_increaseslot - increase wimpslot.
  132.  
  133.  
  134. 1.11 (10-Feb-96)
  135.  
  136. --Added start and stop bits so library can be used with BLibII.
  137.  
  138.  
  139. 1.12 (11-Mar-96)
  140.  
  141. --Added  :
  142.            PROCwimp_colouricontext - changes colour of text (not if using
  143.   font).
  144. --Fixed problem where pane didn't move if parent window was resized.
  145. --Fixed problem with DrWimp forgetting where to open menu if wimp% block is
  146.   fiddled about with in PROCuser_menuopen.
  147.  
  148.  
  149. 1.13 (26-Mar-96)
  150.  
  151. --General cleaning and tidying up.
  152. --Fixed two mistakes with BlibII start and stop bits.
  153.  
  154.  
  155. 1.14 (24-May-96)
  156.  
  157. --Fixed a bug in save windows where a line which was “hardwired” to icon 3.
  158.   This must have happened sometime in the last few versions and should have
  159.   been icon 0, which it is in earlier versions. Therfore save windows would
  160.   appear not to work in that no icons could be dragged.
  161.  
  162.  
  163. 2.00 (02-Jul-96) First major overhaul since 1.02.
  164.                  Limited release.
  165.  
  166. --Added  :
  167.            ****FNuser_saveicon - return the icon number of the icon to be
  168.   dragged in the save window. Only use if not using the standard icon 0 as the
  169.   save icon.
  170.            ****FNuser_sliderback - return icon number of slider back icon.
  171.            ****FNuser_slider - return icon number of slider icon.
  172.            ****PROCuser_slidervalue - Percentage of slider being dragged or
  173.   just finished being dragged is passed.
  174.            PROCwimp_putsliderpcent - sets the percentage of a slider.
  175.            FNwimp_getsliderpcent - gets the percentage of a slider.
  176.            FNwimp_resizewindow - resizes work area and visible area to values
  177.   specified.
  178.            FNwimp_getdfilesize - returns width or height of a drawfile in OS
  179.   co-ordinates.
  180.            PROCwimp_renderwindow - renders a drawfile in a window.
  181.            FNwimp_geticonsize - returns width or height of icon in OS
  182.   co-ordinates.
  183.            FNwimp_worktoscreen - converts a windows work coordinates into
  184.   screen coordinates.
  185.            FNwimp_screentowork - converts screen coordinates into a windows
  186.   work coordinates.
  187.            PROCwimp_setcolour - sets the current GCOL colour to the nearest
  188.   possible for the mode when the red, green and blue values are supplied.
  189.            PROCwimp_plottext - plot text in any font, size, foreground and
  190.   background colours.
  191.            FNwimp_createblock - creates a block of memory for string storage.
  192.   Returns a handle for the block.
  193.            PROCwimp_putinblock - puts a string in a block at the specified
  194.   position.
  195.            FNwimp_getfromblock - gets string from specified position in a
  196.   block.
  197.            FNwimp_geticonstate - returns 1 or 0 to denote whether icon is
  198.   selected or not.
  199.            PROCwimp_attachsubmenu - attaches a menu or a window as a submenu
  200.   of a specified menu item.
  201. --Altered:
  202.            PROCwimp_openwindow - can now use 2 as the centre value to centre
  203.   window on the pointer. Backwards compatable.
  204.            ****Changed PROCuser_savedata to FNuser_savedata. Now return a 1 if
  205.   some data was saved or a 0 if none was saved. Allows for validation checks
  206.   in this function to see if any data should be saved or not.
  207.            PROCwimp_iconselect - small change made so that if state is not
  208.   changing then icon is not redrawn.
  209.            PROCwimp_puticontext - small change made so if text is not actually
  210.   changing then the icon is not redrawn.
  211.            PROCwimp_pollsavemessage - removed EVAL.
  212.            PROCwimp_loadwindow - now allows user sprites to be indirected, so
  213.   they are now displayed, and can be changed.
  214. --Made small change of occurances of size to size% in FNwimp_getwindowsize.
  215. --Renamed wimp functions "process" to "wimp_process" and "checkbounds" to
  216.   "wimp_checkbounds", which is what they should have been.
  217. --Added search facility to !Fnc'n'Prc.
  218. --!Fnc'n'Prc is no longer an example application. The addition of the search
  219.   facility meant that large sections of code were non-trivial, and would be
  220.   very hard to follow by anyone not familiar with manipulating blocks of
  221.   memory etc.
  222. --Added sliders. Eg: the ones usually found in colour picker windows where you
  223.   can drag a slider for red, green and blue to set the amounts.
  224. --Added !DrawDisp example application to show drawfiles in windows.
  225. --Added !Slider example application to show sliders and slider ranges.
  226. --Added !PanePain example application to replace !Fnc'n'Prc as a pane example.
  227. --Added !UserDraw example application to show user graphics in windows.
  228. --Added support for DragASprite module. All save boxes will now use it as
  229.   default.
  230. --!!ReadMe!! file tided up and made more verbose.
  231. --Distribution conditions added to !!ReadMe!!.
  232. --Replaced version 1.23 (11-Jul-93) of !TemplEd with version 1.31 (25-May-95).
  233. --Fixed bug in PROCwimp_errorchoice to stop it always returning 0 (ie Cancel).
  234. --Added a BASIC linker called !Linker. Purpose written for DrWimp to get
  235.   around the problem of not being able to distribute BlibII. See its own !Help
  236.   file for more details and instructions.
  237. --Moved the manuals and the history file into a "Documents" folder.
  238. --Removed !FontRun example as I thought it had a non-standard way of running
  239.   and would have taken too much effort to update the DrWimp in it and check it
  240.   fully worked.
  241. --Updated version of DrWimp inlcuded with example applications and updated
  242.   comments accordingly.
  243. --Fixed small bug in PROCwimp_menuwrite where the maximum length of text to be
  244.   entered was always character short.
  245. --Added !MenuTrick example application to show dynamic menus, context
  246.   sensitive menus and writeable menu items.
  247. --Added !SprAreas example application to show private sprite areas.
  248. --Added !Blocks example application to show new string block handling.
  249. --Seperated DrWimp from the examples and put in a seperate "system"
  250.   application, so all examples use the same copy saving space.
  251. --Removed BlibII start and stop bits as !Linker does not need them. This
  252.   removed a staggering 7k off DrWimp!! If you want to use BlibII, then it
  253.   includes a utility to add the start at stop bits automatically.
  254. --Major new addition in the form of !Fabricate. Produces copies of the blank
  255.   template application !MyApp, but with options to change the name and add
  256.   some very common features automatically.
  257. --Removed copies of address not in the manual and added seperate "Address"
  258.   file.
  259. --Added !BSquasher utility.
  260. --Removed wimpver% line and moved FNwimp_libversion to top so no lines are
  261.   outside functions any longer.
  262. --Removed FNuser_minmenuwidth, as it seems to have no effect. Strange.
  263. --Added !ESG example application.
  264.  
  265.  
  266. 2.01 (24-Jul-96)
  267.  
  268. --I love it when that happens. I have rewritten PROCwimp_pollopenwindow (an
  269.   internal function) so it is now smaller. Removed the now redundant
  270.   PROCwimp_winandpaneback (internal), and hey presto! Multiple panes per
  271.   window are now possible and DrWimp is a few 100 bytes shorter to boot!
  272.   The original pane code which was mainly the two functions mentioned was a
  273.   bit cranky, but after stuggling for several days trying to make it work with
  274.   multiple panes I suddenly had this brainwave. I don't understand why I
  275.   didn't do things this way before...
  276.   PROCuser_openwindow is now called before the window in question is opened so
  277.   the stack ordering of the panes is easily worked out.
  278. --Added brief details of tutorial files to !!ReadMe!! file.
  279. --Added !Multipane example application.
  280. --Fixed bug in FNwimp_getwindowsize where it always returned a 0 for the
  281.   window height.
  282. --Added the Upgrading document which details exactly what needs to be
  283.   changed to what if you are upgrading an application from a previous version.
  284.  
  285.  
  286. 2.02 (04-Sep-96)
  287.  
  288. --Added  :
  289.            PROCwimp_closedown - new function to put all the close down code
  290.   in. DrWimp internal only, not to be called.
  291. --Global varaible tblk% did not start with a 'w'. Now fixed.
  292. --Now looses font handles when application is quit instead of leaving them.
  293.   New method of coping with fonts in windows also saves memory. Now just 256
  294.   bytes are required instead of 256 bytes per window template.
  295. --!Fabricate now makes !Boot files.
  296.  
  297.  
  298. 2.03 (16-Oct-96) Limited release
  299.  
  300. --Altered:
  301.            PROCwimp_resizewindow - now opens the resized window in its
  302.   current stack position instead of moving it behind all the others.
  303. --Added  :
  304.            ****PROCuser_modechange - called upon mode changes.
  305.            FNwimp_getscreensize - returns dimensions of current screen
  306.   mode in OS coordinates.
  307.  
  308.  
  309. 2.04 (20-Oct-96)
  310.  
  311. --Altered:
  312.            PROCwimp_setcolour - localised variable to stop c% getting
  313.   corrupted.
  314.            FNwimp_initialise - 'w' added to start of non-localised variable.
  315.   Now applications are started for RISC OS 3+ so DrWimp can take advantage of
  316.   extra messages, etc.
  317.            PROCwimp_help - internal DrWimp function altered to allow
  318.   interactive help for menu items.
  319. --Added  :
  320.            PROCwimp_deskplottext - Plots some text on the screen at the
  321.   given coordinates using the specified foreground and background colours. The
  322.   function plots the text how the desktop text appears. ie. for machines using
  323.   RISC 3.50+ the text will be in the current desktop font. For other machines
  324.   it will be in the system font.
  325.            ****FNuser_menuhelp - returns interactive help for menu items.
  326. --Updated !UserDraw example application to use new function.
  327. --Added !Toolbar example application.
  328. --Renamed Manual to !Manual so it appears first in the Documents folder.
  329. --Removed stray DrWimp file from !ESG example application.
  330. --Added !UnCrunch utility for StrongARM users to enable them to run the
  331.   utilities.
  332. --Added StrongARM document to tell users about !UnCrunch. Also added a short
  333.   note about StrongARM in the Security document.
  334.  
  335.  
  336. 2.05 (19-Nov-96)
  337.  
  338. --Whenever a save window is opened - either by a wimp request, user request or
  339.   as a menu or part of a menu - the caret is placed in the writeable icon (1).
  340. --Added note in manual to start of tutorials section, pointing out that its not
  341.   a good idea to add lines before the PROCwimp_initialise.
  342. --Removed some inconsistencies from the manual and !Fnc'n'Prc.
  343.  
  344.  
  345. 2.06 (25-Nov-96)
  346.  
  347. --Added  :
  348.             FNwimp_roundfloat - rounds up or down a floating point number to
  349.   an integer.
  350. --Altered:
  351.             ****PROCwimp_bar - added new fourth parameter to specify whether
  352.   the bar is horizontal or vertical.
  353. --Implementented vertical sliders.
  354. --Updated Slider example application to demonstrate vertical sliders and using
  355.   bump icons with sliders.
  356.  
  357.  
  358. 2.07 (15-Dec-96) Limited release
  359.  
  360. --Added  :
  361.             PROCwimp_redrawwindow - forces a window to be redrawn.
  362.             PROCwimp_savedfile - saves a drawfile.
  363. --Now allows files to be loaded in with double-clicks, including if the
  364.   application was run from the double-click.
  365. --Added new version (1.21) of !Crunch which produces StrongARM compatible code.
  366. --Further compressed !Fabricate, !Linker and !Fnc'n'Prc RunImages.
  367. --Replaced !TemplEd 1.31 with 1.32 which is StrongARM compatible.
  368.  
  369.  
  370. 2.08 (17-Dec-96) Limited release
  371.  
  372. --Added  :
  373.             PROCwimp_iconbit - allows icon bits to be set and unset.
  374. --Altered:
  375.             PROCwimp_openwindow - specifying a stack position of -3 now
  376.   opens the window in its current stack position.
  377.             PROCwimp_openwindowat - specifying a stack position of -3 now
  378.   opens the window in its current stack position.
  379.  
  380.  
  381. 2.09 (26-Dec-96)
  382.  
  383. --Made small change to PROCwimp_dataload - an internal function - to get
  384.   around some sort of problem with !BSquasher not be able to cope in certain
  385.   situations.
  386. --Added new version of Linker (2.00) - now more robust and fixes some bugs
  387.   in the first version. Progress bar added and speed of linking increased.
  388. --When !Fnc'n'Prc changed from version 1.20 to 1.21 the version displayed in
  389.   the info window was not updated by mistake. Now corrected. The !Help file
  390.   has always shown the correct version.
  391. --Increased indirected memory allocation sizes for the purpose and version
  392.   icons in the info windows in the tutorial template files. Same was done of
  393.   the templates file Fabricate produces.
  394.  
  395.  
  396. EOF
  397.