TweetFollow Us on Twitter

Reading Paint Files
Volume Number:1
Issue Number:10
Column Tag:Basic School

"Reading Paint Files"

By Dave Kelly, Hybrids Engineer, MacTutor Editorial Board

This month we will explore how to read MacPaint files via MSBASIC. We will start by generally dissecting a paint file.

The 8"X10" MacPaint pictures that we are used to seeing are represented by 576 X 720 pixels. That's 414,720 pixels which would require 51,840 bytes to store directly to disk. The first 512 bytes (first block) contain the brush and fill pattern information. Fortunately, the bit map is compressed a row at a time in order to conserve disk space or we really wouldn't have much room to do anything else. Therefore there is a block of encoded pixels for each of the 720 rows. There are two flavors of encoding these entries, a straight bitmap and a run-length encoded sequence.

PATTERN BYTES

The first 512 bytes start with 00 00 00 02. Then after these four bytes are the 38 patterns that you see when you open your MacPaint document. The patterns may be edited with the pattern editor provided in MacPaint and your custom patterns may then be used as needed. Each of the 38 patterns are represented by 8 bytes each where each byte represents a row in the pattern grid. The pattern rows are mapped from left to right and top to bottom. The order of the patterns is the same as appear at the bottom of the MacPaint screen. The patterns are not encoded. The remainder of the first 512 bytes are filled with zeros.

BITMAP FLAVORS

Both flavors start with a one byte count. In the bitmap flavor the count indicates the number of pixel bytes which will follow minus one. As an example of this see figure 1 (Flavor 1) below:

Fig. 2 Program Output

In the example, the pattern 0100101011010010 (where a 1 represents a black pixel and a 0 represents a white pixel) would be encoded as 014AD2. The first byte (01) is the count minus one, therefore the count is 2 bytes. The following 2 bytes represent the data (4AD2).

The second flavor is composed of a sequence of 8 bits which is repeated. The count indicates the number of times which the sequence is repeated. For the second flavor the count byte (first byte) is set negative. Negative binary numbers have the first bit set to indicate that it is negative. In this case, the first byte is the absolute value of the of the first byte minus one. For example FDFF would represent 4 bytes of "FF", or "FF FF FF FF". FD is 11111101. The absolute value (negative) is 00000010 = 3. Therefore the count is 3+1 = 4 bytes. A row that is entirely blank is represented by B900 where B9 = -71. The inverse is 71. Add one to get the count (71+1=72 bytes of the 8-bit pattern "00". There are 72 bytes (72X8 = 576 pixels) in one row of a MacPaint document. The pattern may be any combination of ones and/or zeros. This would be most useful in coding patterns of bits which are repeated.

The tricky part is determining which of the flavors to use. In reading the file this is not too much of a problem because we can always look at the first bye. If it is negative then it is of the second flavor. Writing a MacPaint file is not quite as simple but can be done if you plan ahead.

BASIC PROGRAMS

I'm sure that you have probably seen the public domain program which will read the top left corner of a MacPaint document and display it on the screen. The program below called Paint Pokes will read any MacPaint file and display it on the screen using the Prof. Mac Pokes procedures that I have shown before (see Apr. 85 MacTutor, pg. 34). The problem is that this method of printing on the screen is extreamly slow. I would still like to convert the paint file (or a portion of it) into a BASIC PICTURE$ which could be printed to the screen much quicker, but so far I have not been able to understand how PICTURE$ (or the clipboard for that matter) is encoded. The problem is that BASIC does not recognize anything that has been poked onto the screen. Because of this the screen GET and screen PUT won't work for saving the picture via BASIC for later use. Anyone have the answer??

Paint Pokes asks for the paint file to be displayed and then reads the file and pokes it onto the screen. Press the mouse button at the end to continue when the display has finished (or when you have finished looking at it). The program then returns to BASIC.

Pattern Editor is a BASIC program which allows you to edit the patterns used in MacPaint. The pattern editor built into MacPaint is really more useful, but the BASIC pattern editor demonstrates the format of the patterns stored in a paint file. To use the pattern editor run the program and select the desired menus. First load in a Paint document. The entire document is read in so that it can be completely written back to disk again a with modified set of patterns. Select 'Display Pattern' to show the patterns as they are now defined. Choose 'Edit Pattern' to edit a particular pattern. Use the mouse to select the desired pattern and then a grid will appear and allow you to change the bits. To change the pattern as you are editing it choose 'Display Pattern' and the patterns will be re-drawn using your new pattern. If you display the pattern, the pattern will now be changed for good, you can't undo what has been displayed unless you want to re-edit the same pattern back to the original pattern. You may revert back to the original pattern set by loading the paint document again or you may want to save the changes to a new Paint document.

Thanks go to Bob Denny for his analysis of MacPaint file format.

'    Paint Pokes
'    By Dave Kelly
'    ©MACTUTOR 1985

start=108288!     'Set up beginning screen addr.
ending=130175!      'Set up ending screen addr.
mac512=(512-128)*1024    'Set up addr. for 512K Mac
IF FRE(0)>100000! THEN start=start+mac512
ending=ending+mac512
screen=start
WINDOW 1,"",(0,0)-(512,342),3
x$=FILES$(1,"PNTG")  'Get a MacPaint file
IF x$="" THEN quit   'No selection,  quit
HIDECURSOR
OPEN x$ FOR INPUT AS #1
    FOR i%= 1 TO 512  'Disgard the first 512 bytes
        x$=INPUT$(1,#1)
    NEXT i%
    pixel%=0
    WHILE NOT EOF(1)
    count=ASC(INPUT$(1, #1))
    IF count<&H80 THEN GOSUB type1 ELSE GOSUB type2  'Check if high bit 
is set
    WEND
CLOSE #1

wait.for.mouse.click:
    pause:IF MOUSE(0)>0 THEN  quit
    GOTO pause

Quit: MENU RESET:SHOWCURSOR
WINDOW 1,"Output Window",(2,40)-(510,340),1
END

Pokescreen:
    IF pixel%>511 THEN RETURN
    POKE screen,ASC(byte$)
    screen=screen+1
    IF screen >=ending THEN wait.for.mouse.click
    RETURN


type1:  'first flavor
    FOR i% = 1 TO count+1
        byte$=INPUT$(1,#1)  'Read a byte
        GOSUB Pokescreen
        pixel%=pixel%+8 'Count pixels printed
    NEXT i%
    IF pixel%>=576 THEN pixel%=0   'line is full
RETURN

type2:  'second flavor
    byte$=INPUT$(1,#1)    ' Read a byte
    FOR i%=1 TO (&H101-count)
        GOSUB Pokescreen
        pixel%=pixel%+8 'Count pixels printed
    NEXT i%
    IF pixel%>=576 THEN pixel%=0  'line is full
RETURN


***************************************
'    Pattern Editor
'    By Dave Kelly
'    ©MACTUTOR 1985

start=108288! 'Set up beginning screen addr.
ending=130175!      'Set up ending screen addr.
mac512=(512-128)*1024    'Set up address for 512K Mac
IF FRE(0)>100000! THEN start=start+mac512:ending=ending+mac512
screen=start:editor%=0:NewYork=2
Bold=1:Plain=0: DEFINT i,j,k
DIM pattern%(512), k$(1),Bound0%(72),  Bound1%(72),Bound2%(72), 
 Bound3%(72),Bstatus%(72),  
WINDOW 1,"",(2,24)-(510,150),3
FOR i%=1 TO 5
    MENU i%,0,0,""  'Erase old menus
NEXT i%
MENU 1,0,1,"File"
MENU 1,1,1,"Load Paint patterns"
MENU 1,2,0,"Save Paint patterns"
MENU 1,3,1,"Quit"
MENU 2,0,0,"Patterns"
MENU 2,1,1,"Display Patterns"
MENU 2,2,1,"Edit a Pattern"

ON MENU GOSUB menu.selection
MENU ON
pause:GOTO pause

menu.selection:
    menunumber=MENU(0)
    menuitem=MENU(1):MENU:MENU OFF
    IF menunumber=1 THEN ON menuitem GOSUB read.paint.file,    
 write.paint.file, Quit
    IF menunumber=2 THEN ON menuitem GOSUB Display.patterns,   
 Edit.pattern
    MENU ON:RETURN

read.paint.file:
    x$=FILES$(1,"PNTG")    'Get a MacPaint file
    IF x$="" THEN RETURN  'No selection,                        then 
forget it.
    MENU 1,0,0:MENU 2,0,0
    HIDECURSOR
    TEXTFONT(NewYork):TEXTSIZE(14)
    TEXTFACE(Bold)
    CLS:LOCATE 4,1
PRINT"Now Reading Macpaint document.....           Please wait."
    OPEN x$ FOR INPUT AS #1 LEN= 2000
    ERASE k$
    DIM k$(LOF(1)+1)
    FOR i%= 1 TO 512
        k$(i%)=INPUT$(1,#1)
    NEXT i%
    WHILE NOT EOF(1)
        k$(i%)=INPUT$(1,#1)
        i%=i%+1
    WEND
    number.of.bytes=i%
CLOSE #1
SHOWCURSOR:CLS
MENU 2,0,1:MENU 1,0,1:MENU 1,2,1
BEEP:RETURN 

write.paint.file:
TEXTFONT(NewYork):TEXTSIZE(14)
TEXTFACE(Bold)
CLS:LOCATE 4,1
PRINT "Now writing new MacPaint document....                   Please 
wait."
x$=FILES$(0,"Choose a new filename:") 'Get a                         
                  Paint file
IF x$="" THEN RETURN  'No selection, then                            
                                                  forget it.
MENU 2,0,0:MENU 1,0,0
OPEN x$ FOR OUTPUT AS #1
    FOR i1%=1 TO number.of.bytes
        PRINT #1, k$(i1%);
    NEXT i1%
CLOSE #1
NAME x$ AS x$,"PNTG"
MENU 1,0,1:MENU 2,0,1
LOCATE 4,1:PRINT SPACE$(80)
BEEP:RETURN

Quit: MENU RESET:SHOWCURSOR
WINDOW CLOSE 2
WINDOW 1,"Output Window", (2,40)-(510,340),1
END

Display.patterns:
'Poke the display onto the screen
HIDECURSOR:MENU 1,0,0:MENU 2,0,0
a1=start+64*50+3
b1=3
'These loops poke the patterns to the screen
FOR qloop =0 TO 9 STEP 8
FOR pat% = 0 TO 18
    FOR i%=  (pat%*8)+1 TO(8*pat%)+8
        row=i%+4
        POKE a1+((row MOD 8+qloop)*64)+            (b1*pat%), ASC(k$(row))
        POKE a1+((row MOD 8+qloop)*64)+            (b1*pat%)+1, ASC(k$(row))
        POKE a1+((row MOD 8+qloop)*64)+            (b1*pat%)+2, ASC(k$(row))
    NEXT i%
NEXT pat%
NEXT qloop
a1=start+64*70+3
FOR qloop=0 TO 9 STEP 8
FOR pat% = 19 TO 38
    FOR i%= (pat%*8)+1 TO (8*pat%)+8
        row=i%+4
        POKE a1+((row MOD 8+qloop)*64)+            (b1*(pat%-19)), ASC(k$(row))
        POKE a1+((row MOD 8+qloop)*64)+            (b1*(pat%-19))+1, 
ASC(k$(row))
     POKE a1+((row MOD 8+qloop)*64)+ (b1*(pat%-19))+2, ASC(k$(row))
    NEXT i%
NEXT pat%
NEXT qloop
SHOWCURSOR:MENU 1,0,1:MENU 2,0,1
RETURN

Choose.pattern:  'Pattern% = selected pattern #
SHOWCURSOR:WINDOW 1
IF editor%=1 THEN makeselection
GOSUB Display.patterns
makeselection:
LOCATE 5,1:PRINT"Please use mouse to select pattern"
Edit.pattern:
GOSUB Choose.pattern
IF editor%=1 THEN editor
InitEditor:
WINDOW 2,"Pattern Editor",  (10,160)-(500,320),2
x=20:y=20:offsetx=0:offsety=0:editor%=1
TEXTFONT(NewYork):TEXTSIZE(14)
TEXTFACE(Bold)
LOCATE 5,1
PRINT"Please wait.... Initializing Editor."
PICTURE ON
FOR j= 0 TO 7
    FOR k=7 TO 0 STEP -1
        rectangle%(0)=y+offsety
        Bound0%((j*8)+k)=rectangle%(0)
        rectangle%(1)=x+offsetx
        Bound1%((j*8)+k)=rectangle%(1)
        rectangle%(2)=y+offsety+12
        Bound2%((j*8)+k)=rectangle%(2)
        rectangle%(3)=x+offsetx+12
        Bound3%((j*8)+k)=rectangle%(3)
        Bstatus%((j*8)+k)=0:offsetx=11+offsetx
        FRAMERECT(VARPTR(rectangle%(0)))
    NEXT k
    offsety=11+offsety:offsetx=0
NEXT j
PICTURE OFF
grid$=PICTURE$

editor:
    WINDOW 2
    TEXTFONT(NewYork):TEXTSIZE(14)
   TEXTFACE(Bold)
    LOCATE 5,1
   PRINT"Please wait for Setup of Editor."
    GOSUB Bitstatus
    ' set up new cursor
    GOSUB print.pic
    LOCATE 2,26:PRINT"Define New Pattern"
    GOSUB Print.message
    GOSUB Draw.Datapixels
    GOSUB Define
    CLS:BUTTON CLOSE 1
    TEXTFONT(NewYork):TEXTSIZE(14)
    TEXTFACE(Bold)
    LOCATE 5,1:PRINT"Please wait."
    GOSUB Set.pattern
    LOCATE 5,1:PRINT SPACE$(70)
    GOSUB Display.patterns
    RETURN

print.pic: CLS:PICTURE,grid$ 'print the grid 
    TEXTFONT(NewYork)
    TEXTSIZE(14)
    TEXTFACE(Bold)
    RETURN

Print.message:
    TEXTFACE(Plain)
    TEXTSIZE(12)
    LOCATE 4,35
    PRINT"Click              to  continue"                           
                  'This space ^^^^belongs here
    BUTTON 1,1,"OK",(310,40)-(350,80),1
    RETURN

Draw.Datapixels:
    FOR i= 0 TO 63
        IF Bstatus%(i)=1 THEN rectangle%(0)=Bound0%(i):
 rectangle%(1)=Bound1%(i):
 rectangle%(2)=Bound2%(i):
 rectangle%(3)=Bound3%(i):
 PAINTRECT(VARPTR(rectangle%(0))):
 FRAMERECT(VARPTR(rectangle%(0)))
 'end if
    NEXT i
    RETURN

mousepress:
    GOSUB getpixel   'see which pixel is selected
    IF pixel%=64 THEN  RETURN
    IF Bstatus%(pixel%)=0 THEN     Bstatus%(pixel%)=1          ELSE Bstatus%(pixel%)=0
    rectangle%(0)=Bound0%(pixel%)
    rectangle%(1)=Bound1%(pixel%)
    rectangle%(2)=Bound2%(pixel%)
    rectangle%(3)=Bound3%(pixel%)
    INVERTRECT(VARPTR(rectangle%(0)))
    FRAMERECT(VARPTR(rectangle%(0)))
    RETURN

getpixel:
    pixel%=64
    FOR i = 0 TO 63
        IF Bound0%(i)<MOUSE(2) AND Bound2%(i)>MOUSE(2) AND     
 Bound1%(i)<MOUSE(1) AND  Bound3%(i)>MOUSE(1) THEN             pixel%=i:i=64
    NEXT i
    RETURN

Define:
    WHILE DIALOG(0)<>1
    IF MOUSE(0)>0 THEN GOSUB  mousepress
    IF MENU(0)=2 AND MENU(1)=1 THEN  GOSUB Set.pattern:        GOSUB 
Display.patterns
    WEND
    BEEP:RETURN

Bitstatus: 'get status of each grid row
    FOR j=  0 TO 7
        row=j+((pattern%-1)*8)+5
        t%=ASC(k$(row))
        FOR k=7  TO 0 STEP -1
        IF t%<2^k THEN Bstatus%(j*8+k)=0
        IF t%>=2^k THEN   Bstatus%(j*8+k)=1:t%=t%-2^k
        endloop:NEXT k
    NEXT j
RETURN

Set.pattern: 'set bits to match bit status
    FOR j=  0 TO 7
        row=j+((pattern%-1)*8)+5
        t%=0
        FOR k=7  TO 0 STEP -1
            t%=(Bstatus%(j*8+k)*2^k)+t%
        NEXT k
        k$(row)=CHR$(t%)
    NEXT j
RETURN
 

Community Search:
MacTech Search:

Software Updates via MacUpdate

MacFamilyTree 7.3.4 - Create and explore...
MacFamilyTree gives genealogy a facelift: it's modern, interactive, incredibly fast, and easy to use. We're convinced that generations of chroniclers would have loved to trade in their genealogy... Read more
Yummy FTP 1.10.2 - FTP/SFTP/FTPS client...
Yummy FTP is an FTP + SFTP + FTPS file transfer client which focuses on speed, reliability and productivity. Whether you need to transfer a few files or a few thousand, schedule automatic backups, or... Read more
VueScan 9.5.08 - Scanner software with a...
VueScan is a scanning program that works with most high-quality flatbed and film scanners to produce scans that have excellent color fidelity and color balance. VueScan is easy to use, and has... Read more
Iridient Developer 3.0.1 - Powerful imag...
Iridient Developer (was RAW Developer) is a powerful image conversion application designed specifically for OS X. Iridient Developer gives advanced photographers total control over every aspect of... Read more
Air Video Server HD 2.1.0 - Stream video...
Air Video Server HD streams videos instantly from your computer on your iPhone, iPad, iPod touch or Apple TV. No need to worry about converting or transferring files. We took everything that was... Read more
Duplicate Annihilator 5.7.5 - Find and d...
Duplicate Annihilator takes on the time-consuming task of comparing the images in your iPhoto library using effective algorithms to make sure that no duplicate escapes. Duplicate Annihilator... Read more
BusyContacts 1.0.2 - Fast, efficient con...
BusyContacts is a contact manager for OS X that makes creating, finding, and managing contacts faster and more efficient. It brings to contact management the same power, flexibility, and sharing... Read more
Capture One Pro 8.2.0.82 - RAW workflow...
Capture One Pro 8 is a professional RAW converter offering you ultimate image quality with accurate colors and incredible detail from more than 300 high-end cameras -- straight out of the box. It... Read more
Backblaze 4.0.0.872 - Online backup serv...
Backblaze is an online backup service designed from the ground-up for the Mac.With unlimited storage available for $5 per month, as well as a free 15-day trial, peace of mind is within reach with... Read more
Little Snitch 3.5.2 - Alerts you about o...
Little Snitch gives you control over your private outgoing data. Track background activity As soon as your computer connects to the Internet, applications often have permission to send any... Read more

Pie In The Sky: A Pizza Odyssey (Games)
Pie In The Sky: A Pizza Odyssey 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: A game about delivering pizza. In space. | Read more »
Chosen Gives Hopeful Singers, Songwriter...
If YouTube videos and reality TV shows like The Voice have taught us one thing, it’s that there are a lot of people out there who are anxious to show the world their talents. And if they’ve taught us a second thing, it’s that there’s an almost... | Read more »
Android's Popular OfficeSuite Now A...
Once only available for Android devices, OfficeSuite has finally landed on the app store. The Mobile Systems app lets you view, edit, create, and share Word, Excel, and PowerPoint documents as well as convert them to/from PDFs. It's touted as being... | Read more »
Warhammer: Arcane Magic is Coming Soon,...
Turbo Tape Games has announced that they're joining forces with Games Workshop to bring the turn-based strategy board game, Warhammer: Arcane Magic, to life on the iOS. | Read more »
Fast & Furious: Legacy's Creati...
| Read more »
N-Fusion and 505's Ember is Totally...
| Read more »
These are All the Apple Watch Apps and G...
The Apple Watch is less than a month from hitting store shelves, and once you get your hands on it you're probably going to want some apps and games to install. Fear not! We've compiled a list of all the Apple Watch apps and games we've been able to... | Read more »
Appy to Have Known You - Lee Hamlet Look...
Being at 148Apps these past 2 years has been an awesome experience that has taught me a great deal, and working with such a great team has been a privilege. Thank you to Rob Rich, and to both Rob LeFebvre and Jeff Scott before him, for helping me... | Read more »
Hands-On With Allstar Heroes - A Promisi...
Let’s get this out of the way quickly. Allstar Heroes looks a lot like a certain other recent action RPG release, but it turns out that while it’s not yet available here, Allstar Heroes has been around for much longer than that other title. Now that... | Read more »
Macho Man and Steve Austin Join the Rank...
WWE Immortals, by Warner Bros. Interactive Entertainment and WWE, has gotten a superstar update. You'll now have access to Macho Man Randy Savage and Steve Austin. Both characters have two different versions: Macho Man Randy Savage Renegade or Macho... | Read more »

Price Scanner via MacPrices.net

Apple offering refurbished 27-inch 5K iMacs f...
The Apple Store is offering Apple Certified Refurbished 27″ 3.5GHz 5K iMacs for $2119 including free shipping. Their price is $380 off the price of new models, and it’s the lowest price available for... Read more
16GB iPad mini on sale for $199, save $50
Walmart has 16GB iPad minis (1st generation) available for $199.99 on their online store, including free shipping. Their price is $50 off MSRP. Online orders only. Read more
New 128GB MacBook Airs on sale for $50 off MS...
 B&H Photo has 128GB 11″ and 13″ 2015 MacBook Airs on sale today for $50 off MSRP including free shipping plus NY sales tax only: - 11″ 1.6GHz/128GB MacBook Air (Model #MJVM2LL/A): $849 $50 off... Read more
13-inch 2.6GHz Retina MacBook Pro (refurbishe...
The Apple Store has Apple Certified Refurbished 13″ 2.6GHz/128GB Retina MacBook Pros available for $979 including free shipping. Original MSRP for this model was $1299. Read more
Save up to $600 with Apple refurbished Mac Pr...
The Apple Store is offering Apple Certified Refurbished Mac Pros for up to $600 off the cost of new models. An Apple one-year warranty is included with each Mac Pro, and shipping is free. The... Read more
Samsung Galaxy S 6 and Galaxy S 6 edge U.S. P...
Samsung Electronics America, Inc. has announced the Galaxy S 6 and Galaxy S 6 edge will be available in the U.S. beginning April 10, with pre-orders being accepted now. “We have completely reimagined... Read more
13-inch 2.5GHz MacBook Pro (refurbished) avai...
The Apple Store has Apple Certified Refurbished 13″ 2.5GHz MacBook Pros available for $829, or $270 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free: - 13″ 2.... Read more
Save up to $80 on iPad Air 2s, NY tax only, f...
 B&H Photo has iPad Air 2s on sale for $80 off MSRP including free shipping plus NY sales tax only: - 16GB iPad Air 2 WiFi: $469.99 $30 off - 64GB iPad Air 2 WiFi: $549.99 $50 off - 128GB iPad... Read more
iMacs on sale for up to $205 off MSRP
B&H Photo has 21″ and 27″ iMacs on sale for up to $205 off MSRP including free shipping plus NY sales tax only: - 21″ 1.4GHz iMac: $1019 $80 off - 21″ 2.7GHz iMac: $1189 $110 off - 21″ 2.9GHz... Read more
Färbe Technik Offers iPhone Battery Charge LI...
Färbe Technik, which manufactures and markets of mobile accessories for Apple, Blackberry and Samsung mobile devices, is offering tips on how to keep your iPhone charged while in the field: •... Read more

Jobs Board

DevOps Software Engineer - *Apple* Pay, iOS...
**Job Summary** Imagine what you could do here. At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring Read more
*Apple* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Sr. Technical Services Consultant, *Apple*...
**Job Summary** Apple Professional Services (APS) has an opening for a senior technical position that contributes to Apple 's efforts for strategic and transactional Read more
Lead *Apple* Solutions Consultant - Retail...
**Job Summary** Job Summary The Lead ASC is an Apple employee who serves as the Apple business manager and influencer in a hyper-business critical Reseller's store Read more
*Apple* Pay - Site Reliability Engineer - Ap...
**Job Summary** Imagine what you could do here. At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.