KIDART

Instructions for Exchanging Binary Files

These are the instructions that were distributed by Kidlink in the early days of the Kidlink Gallery of Computer Art so that participants could get the works in our collection and could submit their own files to us. Fortunately, these instructions are completely obsolete. We now have the World Wide Web on which we can view images with NO special effort. We also have mail programs that can send attachments.

The original file:

                  KIDLINK Binary Starter's Kit for MS-DOS
 
Introduction
 
      Files of computer art are binary files.  These files contain the
arbitrary bits that make up the images, not just the legal codes for
alphabetic characters.  In order to submit and retrieve artworks to/from
the KIDLINK Gallery of Computer Art, you need to be able to transfer binary
files.  This capability also makes it possible to distribute programs (like
GEOCLOCK) to KIDLINK participants.
 
      Electronic mail systems treat messages as a series of lines that are
supposed to contain only legal character codes.  Graphics and program files
can contain any possible binary code, not just the legal characters.  Thus
most mail systems cannot transmit graphics or program files.
 
      To get around this problem, there is a program called UUENCODE that
will convert a binary file (graphics or program) to a text file.  The text
file will look like a crazy jumble of meaningless letters (see the sample
at the end of this file), but it contains all of the information from the
original.  The text file can be sent by electronic mail.  Then the
recipient can use the program UUDECODE to convert the text file back into
the original binary form.  This file contains both of these programs and
brief instructions for preparing and using them.
 
      [There is another way, called FTP transfer, to move binary files
between two computers.  It avoids the need to do the conversions, but it is
available only on computers connected to the Internet.]
 
      In addition to a MS-DOS computer (IBM or clone) you will need:
 
            1) IBM-PC BASIC or GW-BASIC or DEBUG (from MS-DOS)
            2) File editor or word processor that will work with
               text files (also known as ASCII or DOS files)
 
How to create UUDECODE.COM
 
      There are two ways to create the UUDECODE program file on your
computer.  You can use either method, depending on whether you have BASIC
or DEBUG on your computer.  The first step is to edit this file to cut out
the part you need and store it in a separate text file.  If you want to use
BASIC, find the section beginning "---CUT HERE--- Save as UUDECODE.BAS" and
save it to your disk with the name UUDECODE.BAS.  If you want to use the
DEBUG program, find and save the UUDECODE.DBG section instead.  Be careful
not to include the lines that say "---CUT HERE---" in your file.
 
      If you are using BASIC, run the UUDECODE.BAS program, which will
create UUDECODE.COM.  These are the commands:
 
            BASIC UUDECODE.BAS      (for IBM-PC BASIC)
            BASICA UUDECODE.BAS     (for IBM-PC BASIC, advanced version)
            GWBASIC UUDECODE.BAS    (for GW-BASIC)
 
If you want to use the MS-DOS DEBUG program, give the command:
 
            DEBUG < UUDECODE.DBG    (the "<" is essential)
 
      You don't have to understand anything about BASIC or DEBUG.  Either
method will create the program file UUDECODE.COM on your disk.  You can
copy it to the disk or directory where you keep programs.
 
How to create UUENCODE.COM
 
      If all you want to do is download binary files, you won't need the
UUENCODE program.  But getting it will demonstrate and test your UUDECODE
program.  These are the steps for converting any uuencoded file back into
binary form:
 
      The first step is to edit the text file to create a file containing
just the uuencoded file you want.  For example, to get UUENCODE.COM, find
the section below that begins with "---CUT HERE--- Save as UUENCODE.UUE"
and save it on your disk.  For other files, use whatever name you want with
the .UUE extension.  If you have received a long file that has been broken
into more than one part, you will have to combine them together to create
one file containing the whole uuencoded file.
 
      Then all you have to is give the uudecode command.  Examples:
 
            UUDECODE UUENCODE.UUE
            UUDECODE WHATEVER.UUE
 
The UUDECODE program will recreate the binary file that was converted to
text form.  If you do this with UUENCODE.UUE, you will have a copy of the
UUENCODE.COM program file on your disk.  Copy it to the place you keep your
other program files.
 
Using UUENCODE
 
      The UUENCODE program converts binary files to text files which can be
sent through electronic mail.  For example, suppose that you have a
graphics file named WILSON.PCX.  The command
 
            UUENCODE WILSON.PCX
 
will create a file named WILSON.UUE.  This file can be included in an
ordinary email message and sent to anyone you wish.  The recipient can then
use UUDECODE to create an exact copy of your original WILSON.PCX file.
 
File sizes
 
      One important consideration in sending graphics files via email is
the size of the files.  The uuencoding process increases the size of a file
by about one third.  Many mail systems have limitations on the length of
messages.  If the uuencoded file is too long (more than a thousand lines or
64K), it can be divided into parts to be sent separately.  But the parts
have a way of getting lost.  For artwork submitted to the KIDLINK Gallery
of Computer Art, it is better to avoid high-resolution graphics modes that
require very large file sizes.  A reasonable upper limit is 45K bytes for
the original graphics file.
 
Credits
 
      This file is based on the Starter's Kit distributed through the
UseNet group comp.binaries.ibm.pc.  It was modified for use by KIDLINK
participants who want to receive or contribute computer artwork.  The
UUENCODE program, by David P. Kirschbaum, was not part of the original kit.
 
            --Dan Wheeler  (Dan.Wheeler@UC.Edu or wheeler@ucbeh.bitnet)
 
---CUT HERE--- Save as UUDECODE.BAS and run under GW-BASIC
100 REM - BASIC PROGRAM TO CREATE UUDECODE.COM v2.0 (a fast uudecoder)
105 REM UUDECODE.BAS created by w8sdz@WSMR-SIMTEL20.ARMY.MIL (Keith Petersen)
110 CLS:PRINT "Creating UUDECODE.COM.  See UUDECODE.DOC for instructions."
115 OPEN "UUDECODE.COM" AS #1 LEN = 1
120 FIELD #1, 1 AS A$: CHECKSUM#=0
130 FOR I = 1 TO    73
140  LINESUM#=0: LOCATE 2,3: PRINT "Countdown: "    73 - I ;
150  FOR J = 1 TO  16: READ BYTE$: CHECKSUM#=CHECKSUM#+VAL("&H"+BYTE$)
160   LINESUM#=LINESUM#+VAL("&H"+BYTE$)
170   IF (BYTE < 256) THEN LSET A$=CHR$(VAL("&H"+BYTE$)): PUT #1
180  NEXT J
190  READ LINETOT$: LINECHECK# = VAL("&H"+LINETOT$)
200  IF LINECHECK# = LINESUM# THEN GOTO 220
210  LOCATE 4,2: PRINT "Error in line #"  ;  260 +  10 * I: GOTO 260
220 NEXT I
230 CLOSE: READ FILETOT$ : FILECHECK# = VAL(FILETOT$)
240 IF CHECKSUM#  FILECHECK# THEN GOTO 260
250 PRINT: PRINT "UUDECODE.COM created successfully": SYSTEM
260 PRINT: PRINT "UUDECODE.COM is not valid!": END
270 DATA EB,5F,90,49,6E,70,75,74,20,66,69,6C,65,20,65,72,  6A1
280 DATA 72,6F,72,2E,4F,75,74,70,75,74,20,66,69,6C,65,20,  5F2
290 DATA 65,72,72,6F,72,2E,73,74,61,72,74,20,6E,6F,74,20,  617
300 DATA 66,6F,75,6E,64,2E,45,6E,64,20,6E,6F,74,20,66,6F,  5C7
310 DATA 75,6E,64,2E,20,65,78,69,73,74,73,2E,20,41,62,6F,  595
320 DATA 72,74,69,6E,67,21, 0, 0, 0, 0,AC, 3,AC, 3,5C, 3,  402
330 DATA  0,E8,FA, 1,E8,54, 1,BF,5C, 3,E8,D1, 0,AD,3D,62,  743
340 DATA 65,75,F4,AD,3D,67,69,75,EE,AD,3D,6E,20,75,E8,BF,  87F
350 DATA 5C, 3,B4,20,AC,3A,C4,76,FB,AC,3A,C4,75,FB,AC,3A,  84E
360 DATA C4,76,FB,3A,C4,74, 4,AA,AC,EB,F8,BA,5C, 3,33,C9,  8F9
370 DATA 88, D,80,3E,60, 1,FF,74,1E,B4,4E,CD,21,3C, 2,74,  5E7
380 DATA 16,3C,12,74,12,8B,CF,2B,CA,E8,2F, 1,BA,44, 1,B9,  609
390 DATA 12, 0,B0, 5,E9,16, 1,B4,3C,CD,21,73, 3,E9,E3, 0,  5E7
400 DATA A3,58, 1,BF,5C, 3,E8,65, 0,AC, A,C0,74,48,BB,20,  674
410 DATA 20,2A,C3, A,C0,74,3F,32,E4,8B,E8,B9, 4, 6,AC,8A,  70C
420 DATA E0,AC,8A,D0,2B,C3,D0,E4,D0,E4,D2,E8, A,C4,AA,4D,  ABB
430 DATA 74,D4,8A,E2,AC,8A,D0,2B,C3,D2,E4,D0,E8,D0,E8, A,  AD8
440 DATA C4,AA,4D,74,C1,8A,E2,AC,2B,C3,8A,CD,D2,E4, A,C4,  9D1
450 DATA AA,4D,75,C7,EB,B0,E8,15, 0,AD,3D,65,6E,75, 5,AC,  7AE
460 DATA 3C,64,74, 3,E8,AE, 0,E8,61, 0,B4,4C,CD,21,8B,36,  6A5
470 DATA 5A, 1,89,3E,5E, 1,BD,50, 0,BF, C, 3,33,C0,AB,B9,  5B3
480 DATA 27, 0,B8,20,20,F3,AB,BF, C, 3,3B,36,5C, 1,72, 6,  4D1
490 DATA E8,38, 0,E8,55, 0,AC,3C,60,75, 4,B0,20,EB, 8,3C,  61D
500 DATA  D,74,1B,3C, A,74,18,AA,4D,75,DF,3B,36,5C, 1,72,  4F9
510 DATA  3,E8,37, 0,AC,3C, A,75,F2,BF,5C, 3,EB,B4,46,89,  707
520 DATA 36,5A, 1,8B,3E,5E, 1,BE, C, 3,C3,BA,5C, 3,8B,CA,  5B7
530 DATA 87, E,5E, 1,2B,CA,76, A,8B,1E,58, 1,B4,40,CD,21,  54D
540 DATA 72, 1,C3,BA,14, 1,B9,12, 0,EB,22,BA,AC, 3,B9,54,  653
550 DATA FA,8B,1E,56, 1,B4,3F,CD,21,72, C, B,C0,74, 8,8B,  62B
560 DATA F2, 3,C6,A3,5C, 1,C3,BA, 3, 1,B9,11, 0,50,E8, A,  648
570 DATA  0,58,E9,55,FF,BA,36, 1,B9, E, 0,52,51,BA,3E, 3,  5EB
580 DATA B9, 2, 0,90,E8, C, 0,59,5A,E8, 7, 0,BA,3E, 3,B9,  595
590 DATA  2, 0,90,BB, 2, 0,B4,40,CD,21,C3,90, D, A,54,68,  557
600 DATA 69,73,20,50,72,6F,67,72,61,6D,20,52,65,71,75,69,  5FA
610 DATA 72,65,73,20,44,4F,53,20,56,65,72,73,69,6F,6E,20,  576
620 DATA 32,2E,30,20,6F,72,20,68,69,67,68,65,72,2E, D, A,  46D
630 DATA 24, D, A,49,6E,70,75,74,20,70,61,74,68,2F,66,69,  516
640 DATA 6C,65,3A,20,20,4E,6F,20,61,63,74,69,6F,6E,B4,30,  58A
650 DATA CD,21,3C, 2,73, C,BA, C, 3,B4, 9,CD,21,B8, 1,4C,  524
660 DATA CD,21,E8,46, 0,73,33,BA,68, 4,B9,1B, 1,90,E8,6A,  69F
670 DATA FF,BA,41, 3,B9,14, 0,BB, 2, 0,B4,40,CD,21,BF,7F,  6A7
680 DATA  0,C6, 5,50,8B,D7,B4, A,CD,21,E8,1E, 0,73, B,BA,  667
690 DATA 55, 3,B9, 9, 0,B0, 1,E9,33,FF,BA, 4, 4,B8, 0,3D,  59D
700 DATA CD,21,72, 4,A3,56, 1,C3,E9,1C,FF,BE,80, 0,BF, 4,  726
710 DATA  4,FC,AC, A,C0,74,2F,B4,20,AC,3A,C4,76,FB,3A,C4,  806
720 DATA 76,26,3C,2F,74, 4,3C,2D,75,18,8B,D0,8B, 4,3C,3F,  4DA
730 DATA 74,1B,24,5F,3D,4F,20,8B,C2,75, 7,F6,16,60, 1,46,  53A
740 DATA 46,AC,AA,AC,EB,D8,F9,C3,C6, 5, 0,F8,C3,BA,68, 4,  973
750 DATA E9,66,FF,90,55,55,44,45,43,4F,44,45,20,76,32,2E,  622
760 DATA 30, 0,4F,72,69,67,69,6E,61,6C,6C,79,20,62,79,20,  565
770 DATA 54,68,65,6F,64,6F,72,65,20,41,2E,20,4B,61,6C,64,  565
780 DATA 69,73, 0,54,68,6F,72,6F,75,67,68,6C,79,20,72,65,  608
790 DATA 68,61,63,6B,65,64,20,62,79,20,44,61,76,69,64,20,  583
800 DATA 50,20,4B,69,72,73,63,68,62,61,75,6D,2C,20,54,6F,  588
810 DATA 61,64,20,48,61,6C,6C, 0,55,55,44,45,43,4F,44,45,  4B4
820 DATA 20,5B,2D,3F,5D,5B,2D,6F,5D,20,5B,64,3A,5D,5B,5C,  4C5
830 DATA 70,61,74,68,5C,5D,62,69,6E,61,72,79,2E,55,55,45,  608
840 DATA 20,3C,52,45,54,55,52,4E,3E, D, A,55,73,69,6E,67,  497
850 DATA 20,74,68,65,20,66,69,6C,65,6E,61,6D,65,2E,74,79,  5DD
860 DATA 70,20,69,6E,20,74,68,65,20,22,62,65,67,69,6E,22,  531
870 DATA 20,6C,69,6E,65,2C, D, A,70,72,6F,64,75,63,65,73,  570
880 DATA 20,75,75,64,65,63,6F,64,65,64,20,66,69,6C,65,6E,  600
890 DATA 61,6D,65,2E,74,79,70,20,6F,6E,20,63,75,72,72,65,  5FC
900 DATA 6E,74,20,64,72,69,76,65,5C,70,61,74,68, D, A,28,  564
910 DATA 70,72,6F,76,69,64,69,6E,67,20,66,69,6C,65,6E,61,  661
920 DATA 6D,65,2E,74,79,70,20,64,6F,65,73,6E,27,74,20,61,  5B2
930 DATA 6C,72,65,61,64,79,20,65,78,69,73,74,29,2E, D, A,  53C
940 DATA 2D,6F,20,73,77,69,74,63,68,20,66,6F,72,63,65,73,  5F0
950 DATA 20,6F,76,65,72,77,72,69,74,65,20,6F,66,20,65,78,  5F9
960 DATA 69,73,74,69,6E,67,20,66,69,6C,65,6E,61,6D,65,2E,  61D
970 DATA 74,79,70, D, A,2D,3F,20,70,72,6F,64,75,63,65,73,  565
980 DATA 20,74,68,69,73,20,68,65,6C,70,20,6D,65,73,73,61,  5DA
990 DATA 67,65,2E, D, A,24, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,  135
1000 DATA 114365
 
 
---CUT HERE--- Save as UUDECODE.DBG and feed to DEBUG
E100
EB 54 90 49 6E 70 75 74 20 66 69 6C 65 20 65 72
E110
72 6F 72 2E 0D 0A 4F 75 74 70 75 74 20 66 69 6C
E120
65 20 65 72 72 6F 72 2E 0D 0A 73 74 61 72 74 20
E130
6E 6F 74 20 66 6F 75 6E 64 2E 0D 0A 45 6E 64 20
E140
6E 6F 74 20 66 6F 75 6E 64 2E 0D 0A 00 00 00 00
E150
64 03 64 03 14 03 E8 BE 01 E8 2D 01 BF 14 03 E8
E160
AA 00 AD 3D 62 65 75 F4 AD 3D 67 69 75 EE AD 3D
E170
6E 20 75 E8 BF 14 03 AC 3A C4 76 FB AC 3A C4 75
E180
FB AC 3A C4 76 FB 3A C4 74 04 AA AC EB F8 BA 14
E190
03 33 C9 88 0D B4 3C CD 21 73 03 E9 E3 00 A3 4E
E1A0
01 BF 14 03 E8 65 00 AC 0A C0 74 48 BB 20 20 2A
E1B0
C3 0A C0 74 3F 32 E4 8B E8 B9 04 06 AC 8A E0 AC
E1C0
8A D0 2B C3 D0 E4 D0 E4 D2 E8 0A C4 AA 4D 74 D4
E1D0
8A E2 AC 8A D0 2B C3 D2 E4 D0 E8 D0 E8 0A C4 AA
E1E0
4D 74 C1 8A E2 AC 2B C3 8A CD D2 E4 0A C4 AA 4D
E1F0
75 C7 EB B0 E8 15 00 AD 3D 65 6E 75 05 AC 3C 64
E200
74 03 E8 B0 00 E8 61 00 B4 4C CD 21 8B 36 50 01
E210
89 3E 54 01 BD 50 00 BF C4 02 33 C0 AB B9 27 00
E220
B8 20 20 F3 AB BF C4 02 3B 36 52 01 72 06 E8 38
E230
00 E8 55 00 AC 3C 60 75 04 B0 20 EB 08 3C 0D 74
E240
1B 3C 0A 74 18 AA 4D 75 DF 3B 36 52 01 72 03 E8
E250
37 00 AC 3C 0A 75 F2 BF 14 03 EB B4 46 89 36 50
E260
01 8B 3E 54 01 BE C4 02 C3 BA 14 03 8B CA 87 0E
E270
54 01 2B CA 76 0A 8B 1E 4E 01 B4 40 CD 21 72 01
E280
C3 BA 16 01 B9 14 00 EB 24 BA 64 03 B9 64 05 F7
E290
D1 8B 1E 4C 01 B4 3F CD 21 72 0C 0B C0 74 08 8B
E2A0
F2 03 C6 A3 52 01 C3 BA 03 01 B9 13 00 50 E8 0A
E2B0
00 58 E9 53 FF BA 3C 01 B9 10 00 BB 02 00 B4 40
E2C0
CD 21 C3 90 54 68 69 73 20 50 72 6F 67 72 61 6D
E2D0
20 52 65 71 75 69 72 65 73 20 44 4F 53 20 56 65
E2E0
72 73 69 6F 6E 20 32 2E 30 20 6F 72 20 68 69 67
E2F0
68 65 72 2E 0D 0A 24 0D 0A 49 6E 70 75 74 20 70
E300
61 74 68 2F 66 69 6C 65 3A 20 20 4E 6F 20 61 63
E310
74 69 6F 6E 0D 0A 24 B4 30 CD 21 3C 02 73 0C BA
E320
C4 02 B4 09 CD 21 B8 01 4C CD 21 BE 80 00 BF 84
E330
03 FC AC 0A C0 74 15 B4 20 AC 3A C4 76 FB 3A C4
E340
76 04 AA AC EB F8 81 FF 84 03 77 1C BA F7 02 B9
E350
14 00 BB 02 00 B4 40 CD 21 8B D7 B9 50 00 33 DB
E360
B4 3F CD 21 03 F8 4F 4F BA 84 03 3B FA 77 05 BA
E370
0B 03 EB AE B8 00 3D 88 05 CD 21 72 04 A3 4C 01
E380
C3 E9 23 FF DA
 
Rcx
284
Nuudecode.com
W
Q
 
 
---CUT HERE--- Save as UUENCODE.UUE and uudecode.
begin 644 uuencode.com
MZ=D`555%3D-/1$4@6V0Z75M<<&%T:%Q=8FEN87)Y+F9I;"`\4D5455)./@T*
M<')O9'5C97,@8FEN87)Y+E5512!O;B!C=7)R96YT(&1R:79E7'!A=&@N#0HD
M5&AI<R!P<F]G<F%M(')E<75I<F5S($1/4R!6,BXP(&]R(&AI9VAE<BX-"B0-
M"DEN<'5T('!A=&@O9FEL93H@($EN<'5T(&9I;&4@97)R;W(N#0I/=71P=70@
M9FEL92!E<G)O<BX-"F`-"F5N9`T*3F\@86-T:6]N#0HD```!`"@$`+0PS2$\
M`G,,NEH!M`G-(;@!3,TAZ(0!<RJZA@&Y%`"[`0"T0,TAOW\`Q@50B]>T"LTA
MZ&8!<PRZ`P&T"<TANLD!Z\BZV`.+\K@`/<TA<P/I-`&CU0&+SRO.2;!<_?*N
M_'0(B_Z`?0$Z=0)'1XOWB]:_I`.L"L!T`ZKK^+@-"JM7B_*_*`2+UZP*P'4"
ML"ZJ/"YU]+AU=:NX90")!3/)M#S-(5ES`^FL`*/7`;J:`RO*Z)$`Z*8`=$"Y
M!`:LBN#0Z-#HJJR*T-+DTN@"Q*J*XJR*T-#DT.2*S=+H`L2JBL*J@\4#@_TM
M=0/H+P`[-MD!<L>`/ML!`76["^UT"2LVV0$K[N@5`+K!`;D(`.@V`(L>UP&T
M/LTAM$S-(;J:`XO/*\I1B_J+Q8@%M""[8#^*!2+'`L0ZQ'4"BL.JXO%9N`T*
MB05!08L>UP&T0,TA<@:+^D<S[<.ZK0&Y%`#K,+HH!+G(KXL>U0&T/\TA<AJ+
M\HO:`]@[P70)QP<``,8&VP$!B1[9`0O`P[J:`;D3`%#H`P!8ZX.[`@"T0,TA
MP[Z``+_8`_RL"L!T#[0@K#K$=OLZQ'8&JJSK^/G#Q@4`^,.08F5G:6X@-C0T
M(%5514Y#3T1%('8Q+CD`1&%V:60@4"!+:7)S8VAB875M+"!4;V%D($AA;&PL
<($=I=F5N('1O('1H92!P=6)L:6,@9&]M86EN````
`
end
 
---CUT HERE--- End of KIDLINK Starter's Kit

KID-LINKS

Kid center
Kidcom chat
Kidmail
My Pages

LINKS

ONGOING PROJECTS