TweetFollow Us on Twitter

Res Formats
Volume Number:2
Issue Number:6
Column Tag:Resource Roundup

Resource Formats for Asm, RMaker and Lisa

By David Wilson, Personal Concepts

Creating Resources

When I first began to program the Mac, the accepted way to create resources was to define them in a text file (named something like ExampleR.text) using the Lisa Workshop. You then ran the text file through the Lisa's RMaker to compile this high-level "resource language" into the correct format for each resource on disk.

In the Fall of 1984, I began to present Apple's three-day Macintosh Technical Training seminars, designed to teach the basics of Mac programming, and we used this approach to do our in-class programming with the Lisa Pascal Workshop.

Things have gotten more complicated during the last year, with the development of various utility programs to help you create and modify resources, and even decompile them into text files. Furthermore, as the readers of MacTutor long ago recognized, programming directly on the Mac has grown tremendously in popularity. Many programmers still use the text file approach, but use the RMaker that runs on the Mac - one with a slightly different format from that used on the Lisa.

I had to deal with these format differences when we developed Apple's new four-day Macintosh Programing Seminars , using TML Pascal on the Mac for in-class programming. I had to convert my sample programs' source code from the Lisa Workshop to TML Pascal, and finally created the table that follows to help in the process. It is presented here in the hope that you will also find it useful.

"But wait", you cry! "I never use a Lisa - why should I care about it's obscure RMaker format?" Good question. Here are some answers:

1. There are still many Lisa source code samples, from Apple and other sources, that you may want to use. This table will help you painlessly convert them to your Mac development system.

2. There are useful utility programs, such as DialogCreator and REdit that produce text files only in the Lisa format. Again, you must do the conversion.

3. Other utility programs, such as ScrnEdit, will produce text files in either format, but the text files often become a bit garbled in the process - you will need some reference to put things in order, and the table may also be helpful in that case.

Of course, you may have decided not to use text files at all, since resources can be created directly with ResEdit, and "included" with the RMaker or Linker step. The disadvantage to this approach is that you lose the documentation provided by the text files, and you sometimes will have more difficulty in exactly aligning the rectangles for scroll bars, dialog items. etc.

In any case, good luck in your Macintosh programming, and remember Scott Knaster's motto for all Mac programmers: "Everything you know is wrong."

[For those of us fanatics that insist on doing our resources in assembly language, we've also included the assembly formats from an earlier issue of MacTutor, listed below. Following the assembler formats are the RMaker resource formats for both the Macintosh and the Lisa. -Ed.]

Assembly  Resource Formats
;Resource Prototypes for Assembler usage
;Frank Alviani
;ALL resources using local labels (labels starting with @)
;must be bracketed by regular labels; local labels can be
;re-used only if the duplicates are separated by regular
;labels. This applies even if no warning appears in the 
;  resource prototype!
;     These are arranged roughly alphabetically, altho the
;DLOG/ALRT/DITL are grouped together at the end.
;In general # represents a numeric field normally filled in.
;The name and attribute fields on the RESOURCE line are 
;The idea is to have this in one editor window, and to copy
;to the resource file being built as needed. This will
;hopefully speed the process, and give flexability the 
;RMaker doesn't.
;There are some additional explanatory comments with 
;various resources.
;Some of this is copied from MacTutor Vol. 1 No. 4.






DOCBOX  EQU 0  ;standard doc window
ALERT   EQU 1  ;alert
PLAIN   EQU 2  ;plain
PLAINSHDEQU 3  ;plain with shadow
NOGROWDOC EQU    4 ;doc window w/o grow box
ROUNDBOXEQU 16 ;rounded-corner window  ;(see IM for setting corner radius..)

CBUTTON EQU 0  ;simple button
CCHKBOX EQU 1  ;check box
CRADIO  EQU 2  ;radio button
USEWFNT EQU 8  ;add to above to use 
 ;window's fonts
CSCROLL EQU 16 ;scroll bar

; IDENTIFICATION resource - needed for Finder to locate Icon
 DC.B AA1-@1
@1:DC.B 'Ver. 0.1 3/31/85'

;BUNDLE resource
RESOURCE'BNDL' ### 'name' [(attr)]
 DC.L 'WCA1';signature
 DC.W 0,1 ;data (doesn't change)
 DC.L 'ICN#';icon mappings
 DC.W 0 ;number of mappings - 1
 DC.W 0,128 ;map 0 to icon 128
 DC.L 'FREF';FREF mappings
 DC.W 0 ;number of mappings - 1
 DC.W 0,128 ;map 0 to fref 128

;CONTROL resource
;NOTE - although the assembler definition of this claims
;that the "control type" field is a long word, IT LIES.
;Control type is a 16-bit field!!

RESOURCE'CNTL' ### 'name' [(attr)]
 DC.W # ;top
 DC.W # ;left
 DC.W # ;bottom
 DC.W # ;right
 DC.W # ;initial value
 DC.W 0 ;visible (T/F)
 DC.W # ;max value
 DC.W # ;min value
 DC.W # ;control type
 DC.L 0 ;refCon
 DC.B @2-@1 ;title length (at least 1)
@1:DC.B 'xxx'    ;title

;CURSOR resource
RESOURCE'CURS' ### 'name' [(attr)]
 DC.L #,# ;1st 8 bytes of cursor
 DC.L #,# ;2nd 8 bytes
 DC.L #,# ;3rd 8 bytes
 DC.L #,# ;4th 8 bytes

 DC.L #,# ;1st 8 bytes of mask
 DC.L #,# ;2nd 8 bytes
 DC.L #,# ;3rd 8 bytes
 DC.L #,# ;4th 8 bytes    
 DC.W #,# ;h,v of hot spot
;FREF resource
RESOURCE'FREF' ### 'name' [(attr)]
 DC.B 'APPL',0,0,0
;ICN# resource
RESOURCE'ICN#' ### 'name' [(attr)]
;there'd usually be an 'include' here...

;MENU resource
;NOTE - the "enable field": bits are number right to left 0-15.
;Bit 1 is the first menu item. A "0" bit in the mask disables
;that item. I haven't tried it, but I think turning off bit 0 of the
;mask disables the entire menu..

RESOURCE'MENU' ### 'name' [(attr)]
lbl:    DC.W1    ;MENU ID
 DC.W 0 ;width holder
 DC.W 0 ;height holder
 DC.L 0 ;std menu pro holder
 DC.L $1FF;enable all items
 DC.B @2-@1 ;title length (in bytes)
@1:DC.B 20;title (this is the apple)

;MENU ITEM resource
 DC.B # ;item length
 DC.B 'xxx' ;menu item
 DC.B 0 ;no icon
 DC.B 0 ;keyboard equivalent
 DC.B 0 ;marking character
 DC.B 0 ;style of item's text
;PATTERN stuff
RESOURCE'PAT ' ### 'name' [(attr)]
 DC.L #,# ;1st, 2nd 4 bytes of pattern
RESOURCE'PAT#' ### 'name' [(attr)]
 DC.W # ;# of patterns
 DC.L #,# ;1st, 2nd 4 bytes of pattern #1

;STRING resource
RESOURCE'STR ' ### 'name' [(attr)]
 DC.B @2-@1 ;text length
@1:DC.B 'xxx'    ;text

;STRING LIST resource
RESOURCE'STR#' ### 'name' [(attr)]
 DC.W # ;count of strings
 DC.B @2-@1 ;text length - string #1
@1:DC.B 'xxx'    ;text

;WINDOW resource
RESOURCE'WIND' ### 'name' [(attr)]
 DC.W # ;top
 DC.W # ;left
 DC.W # ;bottom
 DC.W # ;right
 DC.W # ;window type
 DC.W # ;visible (T/F)
 DC.W # ;draw goAway (T/F)
 DC.L 0 ;refCon (available)
 DC.B @2-@1 ;title length
@1:DC.B 'xxx'    ;title

; --- Dialog / Alert / DITL are grouped together ---

;DIALOG resource
RESOURCE'DLOG' ### 'name' [(attr)]
 DC.W # ;top
 DC.W # ;left
 DC.W # ;bottom
 DC.W # ;right
 DC.W # ;window type
 DC.B # ;visible (T/F)
 DC.B # ;goAway flag (T=has close box)
 DC.L 0 ;refCon
 DC.W # ;ID of DITL list  
 DC.B @2-@1 ;text length
@1:DC.B 'xxx'    ;text

;ALERT resource
RESOURCE'ALRT' ### 'name' [(attr)]
 DC.W # ;top
 DC.W # ;left
 DC.W # ;bottom
 DC.W # ;right
 DC.W # ;resource ID of DITL list  
 DC.W # ;stages (see IM for details..)

;DITL resource
RESOURCE'DITL' ### 'name' [(attr)]
 DC.W # ;# of items - 1

lbl:    DC.L0    ;handle holder
 DC.W # ;top
 DC.W # ;left
 DC.W # ;bottom
 DC.W # ;right
 DC.B type;item-type
 DC.B @2-@1 ;item length (MUST BE EVEN)
@1:DC.B 'xxx'    ;item

; items must be even length
; item types are as follows
;  control item = item + 4
;     button0
;check box1
;radio button  2
;resource 3
;static text8
;edit text16
;icon item32
;quickdraw pict  64
;user item0
; disable item = item + 128
; system icons
;stop   0
;note   1
;alert  2

RMaker Formats

The chart on the next four pages summarizes the Resource text file formats by the RMaker used by most Macintosh programming systems, including TML Pascal, Consulair C, Megamax C, and the MDS Assembler. The formats are shown in the left-hand column, with comments in the far right-hand column.

The center column shows the differences to be aware of when using the Lisa Pascal Workshop RMaker. In may cases there are no differences, but when there are, they are often subtle and easily missed, so check carefully.

The most subtle difference involves defining scroll bars, with the Macintosh RMaker needing the minimum, then maximum, then initial setting of the thumb. The Lisa RMaker wants miminum, initial, and then maximum. Your scroll bars will not work if you get these confused.

Other problems include the Macintosh RMaker's requirement that you separate items with a truly blank line (containing only a carriage return), and define a string resource with "STR(space)". The Lisa RMaker is more tolerant in these areas.

The format for dialog items (DITL) is that for Macintosh RMaker 2.0D2, shipped with the December 1985 Software Supplement (Volume I, Issue II). The ealier version is similar, but not quite as powerful.

                                 Macintosh            Lisa                          Comments

------------------------------ Bundles of Finder Information -------------------------------------------
JEN4 0                      Creator, Signature, Owner
ICN#                         Finder Icon and Mask
0  129  1  130                                       applic. is 129; document is 130
FREF                                                      File type
0  131  1  132                                       APPL is 131;  SCRN is 132

                                                             Type BNDL
                                                             JEN4 0                       Local ID 0
                                                             2                               2 types follow
                                                             ICN# 2                       2 Iicon lists
                                                             0  129                       local ID 0 goes with ICN# ID 129
                                                             1  130
                                                             FREF 2                       2 file references
                                                             0  131                       local ID 0 goes with FREF ID 131
                                                             1  132

Type JEN4 = STR                                   Creator name
                                 ,0                         Local ID of 0 for ICN# and FREF
This is for your own use                                                                      Any text that you want

Type FREF                 File reference (file type)
                                 ,130                     Resource ID = 130
APPL 0                                                  Application; local ID = 0.

                                 ,131                     Resource ID = 131
SCRN 1                                                  Document file type; local ID = 1.

Type ICN# = GNRL     Icon and Mask for Finder
                                 ,129                     Use IDs from 128 to 255
.H                                                          Hexadecimal data will follow
0001 8000 0002 4000                          16 lines of 16 hex digits for icon
.                                                            .
.                                                            .
000F F000 000F F000                                                                         16  lines of 16 hex digits 
for mask

                                                             Type ICN#
                                                             2                               icon and mask follow
                                                             00018000                 32 lines of 8 hex digits for icon
                                                             ...                              32 lines of 8 hex digits for mask

------------------------ Using CODE resources  from Linker output ------------------------------
Include TML1:T13      Type CODE            From Linker
                                                             Demo9L,0                  Use Demo9L.obj; start with CODE 
---------------------- Controls, such as scroll bars, push buttons, etc. ---------------------------
Type CNTL                                             Control
                                 ,401                     Resource ID
Vertical bar                                           Title; doesn't show on scroll bars
-1 416 273 432        top left bottom right (local coord)
Visible                                                   Can see it right away
16                                                         Scroll bar
0                                                           32-bit reference constant  = 0
0  70  35                                               minimum  maximum  current
                                                             0  35  70                   minimum  current      maximum
----------------------------------- Cursor definition -------------------------------------------------------
Type CURS = GNRL                                 Cursor
.H                                                          Hexadecimal data will follow
2000 ... 0000                                        64 hex digits for cursor data
FFFF ... FFFF              64 hex digits for mask data
0003 0003                                            top left (y x)

                                                             Type CURS
                                                             0003 0003
-------------------------------- Dialog and Alert boxes --------------------------------------------------
Type ALRT                Same                     Alert box
                                 ,503                     Resource ID
70 131 190 381                                    top left bottom right (global)
603                                                       Use DITL number 603
F432                         Stages list  (stages 4321)

Type DLOG                                             Dialog window
                                 ,401                     ID
About T13               Dialog window title
30 12 326 500                                      top left bottom right (global)
Visible  NoGoAway                                 or Invisible, or GoAway
1                                                           Dialog window type
0                                                           Dialog window reference constant
501                                                       Use DITL 501

                                                             Type DLOG
                                                             30 12 326 500
                                                             Visible 1 NoGoAway 01 = window type; 0 = ref constant
                                                             501                           Use DITL 501
                                                             About Demo9            Title

Type DITL                  Same                    Dialog Item List
                                 ,501                     (Optional) name, ID
9                                                           Number of items in list

BtnItem                     BtnItem Enabled     Push button, enabled
85 382 155 465                                    top left bottom right (local)
Put Away                  words to go in button

ChkItem Disabled       ChkItem Disabled    Check box, disabled
185 260 205 420                                  Includes check box and words
Some words              Put to right of check box

EditText Disabled       EditText Disabled  Editable text, with frame
185 10 205 245
Modify these words   Up to 240 characters

IconItem                    IconItem Enabled    Icon, but no mask
12 14 76 78                                          Icon scaled to fit this rectangle
257                                                       Use ICON   ID = 257

PicItem                     PicItem Enabled      QuickDraw Picture (PICT)
35 25 90 110                                        Picture scaled to fit this rectangle
128                                                       Use PICT ID = 128

RadioItem                  RadioItem Enabled  Radio button
245 260 265 420                                  Button and words inside rectangle
1200 Baud                                             Words to right of radio button

ResCItem                   ResCItem Enabled  Scroll bar
0 400 260 415                                      Fit in this rectangle
512                                                       Use CNTL ID = 512

StatText                   StatText Enabled    Static text
210 10 230 245                                    Word-wrapped inside rectangle
Cannot fix this                                       Up to 240 characters

UserItem                   UserItem Enabled   User-defined
------------------------ Icons for menu, dialog box, or in your program ------------------------
Type ICON = GNRL                                  Icon, with no mask
                                 ,257                     Use IDs from 256 to 511
.H                                                          --------                    No .H for Lisa
00FFAA11                                             32 lines of 8 hex digits
----------------------------- Menu titles and items -----------------------------------------------------
Type MENU                Same                     Menu
                                 ,401                     (Optional) name, ID
\14                                                       Hex 14 = ACSII 20 =  
                                 About T13 ^1                                                    Use ICON (256 + 1) = 257 
on the left
                                 (-                         Disabled dotted line
--------------------------- Procedures as resources ----------------------------------------------------
Type PROC                --------------------                             Procedure, such as CDEF, MDEF
                                 ,128                     Resource ID
MyProcedure                                         filename for procedure (from Linker)
-------------------------- A single string (use GetString ROM call) ----------------------------------
Type STR_                Type STR               Use blank after STR for Mac version
This is a message      Up to 255 characters
----------------------------- A list of strings (use GetIndString) ----------------------------------------
Type STR#                List of strings
2                                                           Number so strings in the list
This is the first string                                                                         Item 1
Here is another string                            Item 2
                                                             Type STR#
                                                             This is the first string
                                                             Here is another string
------------------------------------- Window template ----------------------------------------------------
Type WIND                 Same                    Window template
                                 ,401                     Resource ID 
Untitled                     Title
40 64 327 495                                      top left bottom right (global)
Visible  GoAway        or Invisible, or NoGoAway
4                                                           Window type
0                    Reference constant

Community Search:
MacTech Search:

Software Updates via MacUpdate

Capo 3.2 - Slow down and learn to play y...
Capo lets you slow down your favorite songs so you can hear the notes and learn how they are played. With Capo, you can quickly tab out your songs atop a highly-detailed OpenCL-powered spectrogram... Read more
OmniOutliner 4.2.3 - Organize your ideas...
OmniOutliner is a flexible program for creating, collecting, and organizing information. Give your creativity a kick start by using an application that's actually designed to help you think. It's... Read more
pwSafe 4.0.1 - Secure password managemen...
pwSafe provides simple and secure password management across devices and computers. pwSafe uses iCloud to keep your password databases backed-up and synced between Macs and iOS devices. It is... Read more
WALTR 1.5.4 - Drag-and-drop any media fi...
WALTR is designed to make it easy to upload and convert any music or video file to an iPad or iPhone format for native playback. It supports a huge variety of media file types, including MP3, MP4,... Read more
Audio Hijack 3.1 - Record and enhance au...
Audio Hijack (was Audio Hijack Pro) drastically changes the way you use audio on your computer, giving you the freedom to listen to audio when you want and how you want. Record and enhance any audio... Read more
PopChar 7.1 - Floating window shows avai...
We're also selling a 5-license family pack for only $25.99! PopChar helps you get the most out of your font collection. With its crystal-clear interface, PopChar X provides a frustration-free way to... Read more
BBEdit 11.1.1 - Powerful text and HTML e...
BBEdit is the leading professional HTML and text editor for the Mac. Specifically crafted in response to the needs of Web authors and software developers, this award-winning product provides a... Read more
Picasa 3.9.139 - Organize, edit, and sha...
Picasa and Picasa Web Albums allows you to organize, edit, and upload your photos to the Web from your computer in quick, simple steps. Arrange your photos into folders and albums and erase their... Read more
Mac DVDRipper Pro 5.0.5 - Copy, backup,...
Mac DVDRipper Pro is the DVD backup solution that lets you protect your DVDs from scratches, save your batteries by reading your movies from your hard disk, manage your collection with just a few... Read more
NetShade 6.2 - Browse privately using an...
This promotion is for NetShade and 1 year of Proxy and VPN services NetShade is an anonymous proxy and VPN app+service for Mac. Unblock your Internet through NetShade's high-speed proxy and VPN... Read more

Block Fortress has a Big New Update for...
Block Fortress is a survival-style game that's as fun as it is blocky. It's also just gotten a rather sizeable update that adds a lot more cool stuff. [Read more] | Read more »
Simple and Surreal Star Base Sim rymdkap...
I really like rymdkapsel. Not just because I'm a sucker for games that are cleverly simple or highly stylisitc, but because it's fun and challenging. Actually it's extremely challenging, which is why I was excited to learn that it's getting a couple... | Read more »
Check out the anticipated Angel Stone in...
Fincon has finally revealed Angel Stone in action in the first ever official gameplay trailer for the anticipated hack and slasher. Angel Stone is set in a post-apocalyptic world in which humanity is in danger of being wiped out by the demonic... | Read more »
Moleskine Timepage is an All-New Calenda...
Moleskine Timepage is a bit of a departure for the notebook manufacturer (since it has little to do with notebooks), but it certainly carries their simple and elegant style quite well. [Read more] | Read more »
Jog on Over and Check Out the New Runtas...
Runtastic has put out a fair number of apps to help you sleep, track excercise, and train various parts of your body. Now it's time for your legs to have their own time in the spotlight with Runtastic Leg Trainer. [Read more] | Read more »
It's Lights Out in the Upcoming Pla...
Ember’s Journey is a stark puzzle platformer with a twist: the entire game is played in darkness. The only light you can see by is the one emanating from your own character. [Read more] | Read more »
MooVee - Your Movies Guru (Entertainmen...
MooVee - Your Movies Guru 1.0 Device: iOS iPhone Category: Entertainment Price: $1.99, Version: 1.0 (iTunes) Description: MooVee helps you effortlessly manage your movies, on your iPhone. | Read more »
Geometry Wars 3: Dimensions (Games)
Geometry Wars 3: Dimensions 1.0.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0.0 (iTunes) Description: Enjoy the next chapter in the award-winning Geometry Wars franchise and enjoy stunning, console-quality... | Read more »
CHAOS RINGS Ⅲ 1.0.0 Device: iOS Universal Category: Games Price: $19.99, Version: 1.0.0 (iTunes) Description: The newest addition to the popular smartphone RPG series is finally here! ・CHAOS RINGS Overview | Read more »
The Popular Insight Series of Travel Gui...
Getting around in a country when you can't understand the primary language can be tough. Fortunately there are several options available to help wold travellers with the important stuff like giving directions to a cab driver or asking where the... | Read more »

Price Scanner via

Apple restocks refurbished Mac minis for up t...
The Apple Store has restocked Apple Certified Refurbished 2014 Mac minis, with models available starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: - 1.4GHz... Read more
13-inch 2.4GHz Retina MacBook Pro (refurbishe...
The Apple Store has 2013 Apple Certified Refurbished 13″ 2.4GHz/128GB Retina MacBook Pros available for $879–$320 off original MSRP. Apple’s one-year warranty is standard, and shipping is free: - 13... Read more
Apple refurbished iPad Air 2s now available f...
The Apple Store is now offering Apple Certified Refurbished iPad Air 2s for up to $140 off the price of new models. Apple’s one-year warranty is included with each model, and shipping is free: -... Read more
MacBook Airs on sale for up to $80 off MSRP
Save up to $80 on the purchase of a new 2015 13″ or 11″ 1.6GHz MacBook Air at the following resellers. Shipping is free with each model: 11" 128GB MSRP $899 11" 256GB... Read more
Free Glide Live Video Messaging App Brings Ne...
Glide, an Israeli startup whose popular live video messenger has attracted more than 15 million users, has released significant updates to its free iOS app. Glide for iOS now gives users more control... Read more
Top Markets Saturation To Slow Global Smartph...
According to a new mobile phone forecast from the International Data Corporation (IDC) Worldwide Quarterly Mobile Phone Tracker, smartphone shipments are expected to grow 11.3% in 2015 — down from 27... Read more
Apple’s Education discount saves up to $300 o...
Purchase a new Mac or iPad at The Apple Store for Education and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free,... 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
Apple refurbished 2014 13-inch Retina MacBook...
The Apple Store has Apple Certified Refurbished 2014 13″ Retina MacBook Pros available for up to $400 off original MSRP, starting at $979. An Apple one-year warranty is included with each model, and... Read more
What Would the ideal Apple Productivity Platf...
For the past four years I’ve kept a foot in both the Mac and iPad camps respectively. my daily computing hours divided about 50/50 between the two devices with remarkable consistency. However, there’... Read more

Jobs Board

*Apple* Retail - Multiple Positions (US) - A...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Program Manager, *Apple* Community Support...
**Job Summary** Apple Support Communities ( discussions. apple .com) helps customers get the most from their Apple products and services by providing access to Read more
Senior Data Scientist, *Apple* Retail - Onl...
**Job Summary** Apple Retail - Online sells Apple products to customers around the world. In addition to selling Apple products with unique services such as iPad Read more
*Apple* Solutions Consultant - Retail Sales...
**Job Summary** As an Apple Solutions Consultant (ASC) you are the link between our customers and our products. Your role is to drive the Apple business in a retail Read more
*Apple* Watch SW Application Project Manager...
**Job Summary** The Apple Watch software team is looking for an Application Engineering Project Manager to work on new projects for Apple . The successful candidate Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.