| | 1 | wxPoem 1.0 |
| | 2 | ---------- |
| | 3 | |
| | 4 | by Julian Smart |
| | 5 | --------------- |
| | 6 | |
| | 7 | Fancy a little intellectual stimulation after long hours spent staring |
| | 8 | at spreadsheets or reports? Does your brain long for something a little |
| | 9 | more fulfilling than Tetris or fiddling with the WIN.INI file? Then you |
| | 10 | could go out and buy a poetry book... or alternatively, if you just |
| | 11 | can't drag yourself away from the screen, click on the wxPoem icon. |
| | 12 | |
| | 13 | wxPoem is a simple Windows application which picks poems from a file at |
| | 14 | random, or finds poems according to a string criterion, and formats them |
| | 15 | nicely in a window. A displayed poem can be copied to the Windows clipboard |
| | 16 | ready for inclusion in that more imaginative report... |
| | 17 | |
| | 18 | It's small, it's free and it's totally harmless, so far as I know. |
| | 19 | No responsibility accepted, though, for any problems it might cause with |
| | 20 | your setup. |
| | 21 | |
| | 22 | wxPoem was converted to use the wxWindows toolkit, from the original |
| | 23 | WinPoem which received a favourable review from Windows Shareware 500. |
| | 24 | |
| | 25 | Since it now uses wxWindows, wxPoem may be compiled on a variety |
| | 26 | of platforms such as X (XView or Motif), Windows and NT. |
| | 27 | |
| | 28 | Files |
| | 29 | ----- |
| | 30 | |
| | 31 | The main data file is winpoem.dat, and an index file winpoem.idx is |
| | 32 | supplied or can be (re)built by deleting winpoem.idx and rerunning |
| | 33 | wxPoem. Source code is also provided in source.zip, but wxWindows is |
| | 34 | required to build it. The original WinPoem is much leaner (40K |
| | 35 | instead of 400K!) and can be compiled under Windows without wxWindows. |
| | 36 | |
| | 37 | Installation |
| | 38 | ------------ |
| | 39 | |
| | 40 | Windows |
| | 41 | ======= |
| | 42 | |
| | 43 | Copy ctl3dv2.dll to windows\system, and delete the original |
| | 44 | ctl3dv2.dll or wxPoem will not run. |
| | 45 | |
| | 46 | wxPoem can be put in the Startup folder in the Program Manager, so that |
| | 47 | a random poem will pop up every time Windows is run. |
| | 48 | |
| | 49 | UNIX |
| | 50 | ==== |
| | 51 | |
| | 52 | wxPoem comes in Open Look and Motif versions for the Sun, and a |
| | 53 | Linux Open Look version. For other platforms, you will need to |
| | 54 | recompile the source. |
| | 55 | |
| | 56 | |
| | 57 | Use |
| | 58 | --- |
| | 59 | |
| | 60 | Simply run the program, and a random poem will be displayed. |
| | 61 | You can optionally give a filename on the command line, without a suffix |
| | 62 | (e.g. winpoem). |
| | 63 | |
| | 64 | The simplest way of operating wxPoem is to keep pressing the space bar |
| | 65 | for new poems (or pages for multi-page poems). |
| | 66 | |
| | 67 | Clicking the right mouse button (or selecting the wxPoem Options menu |
| | 68 | item from the system menu) gives a choice of the following facilities: |
| | 69 | Next poem/page (Page down) Display next poem (or next page) |
| | 70 | Previous page (Page up) Display previous page (multi-line poems only) |
| | 71 | Search (S) Allows user to enter a search string |
| | 72 | Next match (N) Gives next search match |
| | 73 | Copy to clipboard Allows poems to be pasted into other applications |
| | 74 | Bigger text Increases text size |
| | 75 | Smaller text Decreases text size |
| | 76 | About wxPoem About wxPoem |
| | 77 | Exit (Esc) Quit wxPoem |
| | 78 | |
| | 79 | When wxPoem is closed, the font, text height and window position are |
| | 80 | remembered (stored in WIN.INI) for next time. Under X, the values |
| | 81 | are not written (since they are stored in .Xdefaults), so you may |
| | 82 | want to edit the following resources by hand: |
| | 83 | |
| | 84 | wxPoem.X ; X position |
| | 85 | wxPoem.Y ; Y position |
| | 86 | wxPoem.FontSize ; Font size in points (default 12) |
| | 87 | |
| | 88 | The data file |
| | 89 | ------------- |
| | 90 | |
| | 91 | The winpoem.dat file contains poems separated by a #, with optional |
| | 92 | @ codes denoting title (@T) author (@A) and page break (@P). Any |
| | 93 | unrecognized codes will cause the rest of the line to be ignored, so |
| | 94 | the user can add lines (e.g. @S for subject) which will be searched on but |
| | 95 | not displayed. |
| | 96 | |
| | 97 | The data file contains a mixture of 20th century and earlier poetry, |
| | 98 | subject to copyright constraints. Apologies if any copyrights have |
| | 99 | inadvertently been infringed, though I have tried to avoid it. |
| | 100 | |
| | 101 | Implementation |
| | 102 | -------------- |
| | 103 | |
| | 104 | The original WinPoem program was my `Windows learning application', i.e. |
| | 105 | a vehicle for getting stuck into Windows programming, whilst (possibly) |
| | 106 | affording others a modicum of amusement. Therefore the code is pretty |
| | 107 | ugly. So don't look if you're squeamish! |
| | 108 | |
| | 109 | License |
| | 110 | ------- |
| | 111 | |
| | 112 | Copyright Julian Smart, released into the public domain, October 1994. |
| | 113 | |
| | 114 | Julian Smart |
| | 115 | Artificial Intelligence Applications Institute |
| | 116 | University of Edinburgh |
| | 117 | 80 South Bridge |
| | 118 | Einburgh |
| | 119 | EH1 1HN |
| | 120 | |
| | 121 | J.Smart@ed.ac.uk |
projects / wxWidgets.git / blame_incremental