Home » Archimedes archive » Micro User » MU 1991-01.adf » PD-Stuff » !PD-Impres/!Help

!PD-Impres/!Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Micro User » MU 1991-01.adf » PD-Stuff
Filename: !PD-Impres/!Help
Read OK:
File size: 088F bytes
Load address: 0000
Exec address: 0000
File contents
/*
 * !PD_Impres
 *
 * � Stuart Hickinbottom 1990
 */

     This utility was written to allow data to be
transferred from Colton Software's PipeDream to
Computer Concepts' Impression. It does this by
converting the PipeDream highlight codes (eg. %H1%
meaning bold) into Impression DDF (Document
Description File) format codes (eg {"Bold" On} for
bold).

     To use the utility double-click on the
!PD-Impres icon in a filer window. Soon a similar
icon will appear on the icon bar. This icon has a
menu containing a standard information window and a
quit option to remove the utility.

     To convert a PipeDream file simply drop it onto
this icon, a short time later a standard export
window will appear, allowing the DDF version to be
saved into another filer window, or directly into an
Impression frame.

     Because of the way in which PipeDream formats
paragraphs (it actually inserts a line-feed at the
end of each line) the line-breaks must be editied
out once the file has been inserted into a frame -
but this is a small price to pay for the time saved
by highlights being converted.


/* Revision History */

0.10 First version released mainly to find bugs.
0.11 BUG FIX on RAM xfer. If the sending does not
     work, then a file xfer should be attempted.
     Used to complain, but this is now the case.
     This was spotted from what I think is a bug in
     PipeDream - it tells you it can send via RAM,
     but then does not send anything! I was
     developing with Edit - so I never noticed this
     as Edit works fine.
0.12 BUG FIX. Only accepted \x0a for EOLN (which is
     the case in PipeDream on the Arc). Would fail
     in a number of ways if terminator used was
     \x0d (which it is on Z88 PipeDream).
0.13 BUG FIX (RAM xfer). Was not extending the
     buffer when it should. Caused several obscure
     signals. Xfer should now be bug free under ALL
     circumstances(!) - just noticed still getting
     signal 3 (SIGILL) - must look into it...

/* Future enhancements */

* Implement RAM xfer from the !PD-Impress -
  currently only does this via scrap file protocol.

* When using scrap protocol, alter name from
  <Wimp$Scrap> in export box.

Stuart
00000000  2f 2a 0a 20 2a 20 21 50  44 5f 49 6d 70 72 65 73  |/*. * !PD_Impres|
00000010  0a 20 2a 0a 20 2a 20 a9  20 53 74 75 61 72 74 20  |. *. * . Stuart |
00000020  48 69 63 6b 69 6e 62 6f  74 74 6f 6d 20 31 39 39  |Hickinbottom 199|
00000030  30 0a 20 2a 2f 0a 0a 20  20 20 20 20 54 68 69 73  |0. */..     This|
00000040  20 75 74 69 6c 69 74 79  20 77 61 73 20 77 72 69  | utility was wri|
00000050  74 74 65 6e 20 74 6f 20  61 6c 6c 6f 77 20 64 61  |tten to allow da|
00000060  74 61 20 74 6f 20 62 65  0a 74 72 61 6e 73 66 65  |ta to be.transfe|
00000070  72 72 65 64 20 66 72 6f  6d 20 43 6f 6c 74 6f 6e  |rred from Colton|
00000080  20 53 6f 66 74 77 61 72  65 27 73 20 50 69 70 65  | Software's Pipe|
00000090  44 72 65 61 6d 20 74 6f  0a 43 6f 6d 70 75 74 65  |Dream to.Compute|
000000a0  72 20 43 6f 6e 63 65 70  74 73 27 20 49 6d 70 72  |r Concepts' Impr|
000000b0  65 73 73 69 6f 6e 2e 20  49 74 20 64 6f 65 73 20  |ession. It does |
000000c0  74 68 69 73 20 62 79 0a  63 6f 6e 76 65 72 74 69  |this by.converti|
000000d0  6e 67 20 74 68 65 20 50  69 70 65 44 72 65 61 6d  |ng the PipeDream|
000000e0  20 68 69 67 68 6c 69 67  68 74 20 63 6f 64 65 73  | highlight codes|
000000f0  20 28 65 67 2e 20 25 48  31 25 0a 6d 65 61 6e 69  | (eg. %H1%.meani|
00000100  6e 67 20 62 6f 6c 64 29  20 69 6e 74 6f 20 49 6d  |ng bold) into Im|
00000110  70 72 65 73 73 69 6f 6e  20 44 44 46 20 28 44 6f  |pression DDF (Do|
00000120  63 75 6d 65 6e 74 0a 44  65 73 63 72 69 70 74 69  |cument.Descripti|
00000130  6f 6e 20 46 69 6c 65 29  20 66 6f 72 6d 61 74 20  |on File) format |
00000140  63 6f 64 65 73 20 28 65  67 20 7b 22 42 6f 6c 64  |codes (eg {"Bold|
00000150  22 20 4f 6e 7d 20 66 6f  72 0a 62 6f 6c 64 29 2e  |" On} for.bold).|
00000160  0a 0a 20 20 20 20 20 54  6f 20 75 73 65 20 74 68  |..     To use th|
00000170  65 20 75 74 69 6c 69 74  79 20 64 6f 75 62 6c 65  |e utility double|
00000180  2d 63 6c 69 63 6b 20 6f  6e 20 74 68 65 0a 21 50  |-click on the.!P|
00000190  44 2d 49 6d 70 72 65 73  20 69 63 6f 6e 20 69 6e  |D-Impres icon in|
000001a0  20 61 20 66 69 6c 65 72  20 77 69 6e 64 6f 77 2e  | a filer window.|
000001b0  20 53 6f 6f 6e 20 61 20  73 69 6d 69 6c 61 72 0a  | Soon a similar.|
000001c0  69 63 6f 6e 20 77 69 6c  6c 20 61 70 70 65 61 72  |icon will appear|
000001d0  20 6f 6e 20 74 68 65 20  69 63 6f 6e 20 62 61 72  | on the icon bar|
000001e0  2e 20 54 68 69 73 20 69  63 6f 6e 20 68 61 73 20  |. This icon has |
000001f0  61 0a 6d 65 6e 75 20 63  6f 6e 74 61 69 6e 69 6e  |a.menu containin|
00000200  67 20 61 20 73 74 61 6e  64 61 72 64 20 69 6e 66  |g a standard inf|
00000210  6f 72 6d 61 74 69 6f 6e  20 77 69 6e 64 6f 77 20  |ormation window |
00000220  61 6e 64 20 61 0a 71 75  69 74 20 6f 70 74 69 6f  |and a.quit optio|
00000230  6e 20 74 6f 20 72 65 6d  6f 76 65 20 74 68 65 20  |n to remove the |
00000240  75 74 69 6c 69 74 79 2e  0a 0a 20 20 20 20 20 54  |utility...     T|
00000250  6f 20 63 6f 6e 76 65 72  74 20 61 20 50 69 70 65  |o convert a Pipe|
00000260  44 72 65 61 6d 20 66 69  6c 65 20 73 69 6d 70 6c  |Dream file simpl|
00000270  79 20 64 72 6f 70 20 69  74 20 6f 6e 74 6f 0a 74  |y drop it onto.t|
00000280  68 69 73 20 69 63 6f 6e  2c 20 61 20 73 68 6f 72  |his icon, a shor|
00000290  74 20 74 69 6d 65 20 6c  61 74 65 72 20 61 20 73  |t time later a s|
000002a0  74 61 6e 64 61 72 64 20  65 78 70 6f 72 74 0a 77  |tandard export.w|
000002b0  69 6e 64 6f 77 20 77 69  6c 6c 20 61 70 70 65 61  |indow will appea|
000002c0  72 2c 20 61 6c 6c 6f 77  69 6e 67 20 74 68 65 20  |r, allowing the |
000002d0  44 44 46 20 76 65 72 73  69 6f 6e 20 74 6f 20 62  |DDF version to b|
000002e0  65 0a 73 61 76 65 64 20  69 6e 74 6f 20 61 6e 6f  |e.saved into ano|
000002f0  74 68 65 72 20 66 69 6c  65 72 20 77 69 6e 64 6f  |ther filer windo|
00000300  77 2c 20 6f 72 20 64 69  72 65 63 74 6c 79 20 69  |w, or directly i|
00000310  6e 74 6f 20 61 6e 0a 49  6d 70 72 65 73 73 69 6f  |nto an.Impressio|
00000320  6e 20 66 72 61 6d 65 2e  0a 0a 20 20 20 20 20 42  |n frame...     B|
00000330  65 63 61 75 73 65 20 6f  66 20 74 68 65 20 77 61  |ecause of the wa|
00000340  79 20 69 6e 20 77 68 69  63 68 20 50 69 70 65 44  |y in which PipeD|
00000350  72 65 61 6d 20 66 6f 72  6d 61 74 73 0a 70 61 72  |ream formats.par|
00000360  61 67 72 61 70 68 73 20  28 69 74 20 61 63 74 75  |agraphs (it actu|
00000370  61 6c 6c 79 20 69 6e 73  65 72 74 73 20 61 20 6c  |ally inserts a l|
00000380  69 6e 65 2d 66 65 65 64  20 61 74 20 74 68 65 0a  |ine-feed at the.|
00000390  65 6e 64 20 6f 66 20 65  61 63 68 20 6c 69 6e 65  |end of each line|
000003a0  29 20 74 68 65 20 6c 69  6e 65 2d 62 72 65 61 6b  |) the line-break|
000003b0  73 20 6d 75 73 74 20 62  65 20 65 64 69 74 69 65  |s must be editie|
000003c0  64 0a 6f 75 74 20 6f 6e  63 65 20 74 68 65 20 66  |d.out once the f|
000003d0  69 6c 65 20 68 61 73 20  62 65 65 6e 20 69 6e 73  |ile has been ins|
000003e0  65 72 74 65 64 20 69 6e  74 6f 20 61 20 66 72 61  |erted into a fra|
000003f0  6d 65 20 2d 0a 62 75 74  20 74 68 69 73 20 69 73  |me -.but this is|
00000400  20 61 20 73 6d 61 6c 6c  20 70 72 69 63 65 20 74  | a small price t|
00000410  6f 20 70 61 79 20 66 6f  72 20 74 68 65 20 74 69  |o pay for the ti|
00000420  6d 65 20 73 61 76 65 64  0a 62 79 20 68 69 67 68  |me saved.by high|
00000430  6c 69 67 68 74 73 20 62  65 69 6e 67 20 63 6f 6e  |lights being con|
00000440  76 65 72 74 65 64 2e 0a  0a 0a 2f 2a 20 52 65 76  |verted..../* Rev|
00000450  69 73 69 6f 6e 20 48 69  73 74 6f 72 79 20 2a 2f  |ision History */|
00000460  0a 0a 30 2e 31 30 20 46  69 72 73 74 20 76 65 72  |..0.10 First ver|
00000470  73 69 6f 6e 20 72 65 6c  65 61 73 65 64 20 6d 61  |sion released ma|
00000480  69 6e 6c 79 20 74 6f 20  66 69 6e 64 20 62 75 67  |inly to find bug|
00000490  73 2e 0a 30 2e 31 31 20  42 55 47 20 46 49 58 20  |s..0.11 BUG FIX |
000004a0  6f 6e 20 52 41 4d 20 78  66 65 72 2e 20 49 66 20  |on RAM xfer. If |
000004b0  74 68 65 20 73 65 6e 64  69 6e 67 20 64 6f 65 73  |the sending does|
000004c0  20 6e 6f 74 0a 20 20 20  20 20 77 6f 72 6b 2c 20  | not.     work, |
000004d0  74 68 65 6e 20 61 20 66  69 6c 65 20 78 66 65 72  |then a file xfer|
000004e0  20 73 68 6f 75 6c 64 20  62 65 20 61 74 74 65 6d  | should be attem|
000004f0  70 74 65 64 2e 0a 20 20  20 20 20 55 73 65 64 20  |pted..     Used |
00000500  74 6f 20 63 6f 6d 70 6c  61 69 6e 2c 20 62 75 74  |to complain, but|
00000510  20 74 68 69 73 20 69 73  20 6e 6f 77 20 74 68 65  | this is now the|
00000520  20 63 61 73 65 2e 0a 20  20 20 20 20 54 68 69 73  | case..     This|
00000530  20 77 61 73 20 73 70 6f  74 74 65 64 20 66 72 6f  | was spotted fro|
00000540  6d 20 77 68 61 74 20 49  20 74 68 69 6e 6b 20 69  |m what I think i|
00000550  73 20 61 20 62 75 67 20  69 6e 0a 20 20 20 20 20  |s a bug in.     |
00000560  50 69 70 65 44 72 65 61  6d 20 2d 20 69 74 20 74  |PipeDream - it t|
00000570  65 6c 6c 73 20 79 6f 75  20 69 74 20 63 61 6e 20  |ells you it can |
00000580  73 65 6e 64 20 76 69 61  20 52 41 4d 2c 0a 20 20  |send via RAM,.  |
00000590  20 20 20 62 75 74 20 74  68 65 6e 20 64 6f 65 73  |   but then does|
000005a0  20 6e 6f 74 20 73 65 6e  64 20 61 6e 79 74 68 69  | not send anythi|
000005b0  6e 67 21 20 49 20 77 61  73 0a 20 20 20 20 20 64  |ng! I was.     d|
000005c0  65 76 65 6c 6f 70 69 6e  67 20 77 69 74 68 20 45  |eveloping with E|
000005d0  64 69 74 20 2d 20 73 6f  20 49 20 6e 65 76 65 72  |dit - so I never|
000005e0  20 6e 6f 74 69 63 65 64  20 74 68 69 73 0a 20 20  | noticed this.  |
000005f0  20 20 20 61 73 20 45 64  69 74 20 77 6f 72 6b 73  |   as Edit works|
00000600  20 66 69 6e 65 2e 0a 30  2e 31 32 20 42 55 47 20  | fine..0.12 BUG |
00000610  46 49 58 2e 20 4f 6e 6c  79 20 61 63 63 65 70 74  |FIX. Only accept|
00000620  65 64 20 5c 78 30 61 20  66 6f 72 20 45 4f 4c 4e  |ed \x0a for EOLN|
00000630  20 28 77 68 69 63 68 20  69 73 0a 20 20 20 20 20  | (which is.     |
00000640  74 68 65 20 63 61 73 65  20 69 6e 20 50 69 70 65  |the case in Pipe|
00000650  44 72 65 61 6d 20 6f 6e  20 74 68 65 20 41 72 63  |Dream on the Arc|
00000660  29 2e 20 57 6f 75 6c 64  20 66 61 69 6c 0a 20 20  |). Would fail.  |
00000670  20 20 20 69 6e 20 61 20  6e 75 6d 62 65 72 20 6f  |   in a number o|
00000680  66 20 77 61 79 73 20 69  66 20 74 65 72 6d 69 6e  |f ways if termin|
00000690  61 74 6f 72 20 75 73 65  64 20 77 61 73 0a 20 20  |ator used was.  |
000006a0  20 20 20 5c 78 30 64 20  28 77 68 69 63 68 20 69  |   \x0d (which i|
000006b0  74 20 69 73 20 6f 6e 20  5a 38 38 20 50 69 70 65  |t is on Z88 Pipe|
000006c0  44 72 65 61 6d 29 2e 0a  30 2e 31 33 20 42 55 47  |Dream)..0.13 BUG|
000006d0  20 46 49 58 20 28 52 41  4d 20 78 66 65 72 29 2e  | FIX (RAM xfer).|
000006e0  20 57 61 73 20 6e 6f 74  20 65 78 74 65 6e 64 69  | Was not extendi|
000006f0  6e 67 20 74 68 65 0a 20  20 20 20 20 62 75 66 66  |ng the.     buff|
00000700  65 72 20 77 68 65 6e 20  69 74 20 73 68 6f 75 6c  |er when it shoul|
00000710  64 2e 20 43 61 75 73 65  64 20 73 65 76 65 72 61  |d. Caused severa|
00000720  6c 20 6f 62 73 63 75 72  65 0a 20 20 20 20 20 73  |l obscure.     s|
00000730  69 67 6e 61 6c 73 2e 20  58 66 65 72 20 73 68 6f  |ignals. Xfer sho|
00000740  75 6c 64 20 6e 6f 77 20  62 65 20 62 75 67 20 66  |uld now be bug f|
00000750  72 65 65 20 75 6e 64 65  72 20 41 4c 4c 0a 20 20  |ree under ALL.  |
00000760  20 20 20 63 69 72 63 75  6d 73 74 61 6e 63 65 73  |   circumstances|
00000770  28 21 29 20 2d 20 6a 75  73 74 20 6e 6f 74 69 63  |(!) - just notic|
00000780  65 64 20 73 74 69 6c 6c  20 67 65 74 74 69 6e 67  |ed still getting|
00000790  0a 20 20 20 20 20 73 69  67 6e 61 6c 20 33 20 28  |.     signal 3 (|
000007a0  53 49 47 49 4c 4c 29 20  2d 20 6d 75 73 74 20 6c  |SIGILL) - must l|
000007b0  6f 6f 6b 20 69 6e 74 6f  20 69 74 2e 2e 2e 0a 0a  |ook into it.....|
000007c0  2f 2a 20 46 75 74 75 72  65 20 65 6e 68 61 6e 63  |/* Future enhanc|
000007d0  65 6d 65 6e 74 73 20 2a  2f 0a 0a 2a 20 49 6d 70  |ements */..* Imp|
000007e0  6c 65 6d 65 6e 74 20 52  41 4d 20 78 66 65 72 20  |lement RAM xfer |
000007f0  66 72 6f 6d 20 74 68 65  20 21 50 44 2d 49 6d 70  |from the !PD-Imp|
00000800  72 65 73 73 20 2d 0a 20  20 63 75 72 72 65 6e 74  |ress -.  current|
00000810  6c 79 20 6f 6e 6c 79 20  64 6f 65 73 20 74 68 69  |ly only does thi|
00000820  73 20 76 69 61 20 73 63  72 61 70 20 66 69 6c 65  |s via scrap file|
00000830  20 70 72 6f 74 6f 63 6f  6c 2e 0a 0a 2a 20 57 68  | protocol...* Wh|
00000840  65 6e 20 75 73 69 6e 67  20 73 63 72 61 70 20 70  |en using scrap p|
00000850  72 6f 74 6f 63 6f 6c 2c  20 61 6c 74 65 72 20 6e  |rotocol, alter n|
00000860  61 6d 65 20 66 72 6f 6d  0a 20 20 3c 57 69 6d 70  |ame from.  <Wimp|
00000870  24 53 63 72 61 70 3e 20  69 6e 20 65 78 70 6f 72  |$Scrap> in expor|
00000880  74 20 62 6f 78 2e 0a 0a  53 74 75 61 72 74 0a     |t box...Stuart.|
0000088f