TweetFollow Us on Twitter

Resource Utility
Volume Number:1
Issue Number:12
Column Tag:A Resource Utility DA with TML Pascal

A Resource Utility DA with TML Pascal

By Alan Wootton, President , Top-Notch Productions, MacTutor Contributing Editor

The subject this month is a sample Desk Accessory, but the real news of note is the emergance of a Pascal compiler for the Mac. The Desk Accessory (DA) presented here will be compiled with TML Pascal and is installed using Apples Font/DA Mover program. The DA is called ShowRes and is used to view the resources that are open on the heap. Between the compiler, the desk accessory, and the subject of resources there is more than can be presented in one month. The strategy will be to discuss the overall structure of DAs, how to compile, and details on resources. We'll put off until later the complete exposition of desk accessories. In order to show the overall structure of a DA I have a MacPascal program that will emulate the systems treatment of DAs. I will present this program next month.

How to Compile

The compiler is not a simple, one-application system, like MacPascal is. The TML Pascal compiler works with what I call the MDS system. This means it is compatable with the Assembler, Linker, and Editor sold by Apple. As such, there are several applications you run before a completed program is produced. First there is the editor. The editor is the application EDIT that edits files of type TEXT. This same editor is provided with several other programs, and you can also use any editor that will create TEXT type files. MacWrite for instance. With the editor you create the Pascal source code, and the Rmaker source (if needed). In figure 1 I have provided a diagram of what steps you might use in two different situations.

The next stage is the compiler. The compiler will produce assembly language, if desired, but for convenience you may skip the assembly phase and make .rel files directly (.rel is the assemblers normal output). The compiler comes with everything except the assembler, so, if you want to assemble you must get the assembler from Apple. The Consulair C compiler can also be used as an assembler in this system (Consulair also has a more professional linker that you can use). After you have converted your code to .rel files you invoke the linker. The linkers normal output is a file with CODE type resources in it. Other resources may be copied in from another file if desired. Depending upon your situation, you may be done. If not, Rmaker is used to create resources for use by the program (there are other ways also). If you are writing a DA you use Rmaker to create your DLOG and other resources, and also to copy the CODE 1 resource from the linker output file and convert it into a DRVR resource.

Figure 1, Compilation Steps

With six programs involved I can't very well describe the detailed operation of each individually. So, I will make it brief. Compiling ShowRes consists of following the sequence illustrated in figure 1 for DAs. Use the files ShowRes.pas, and ShowRes.R. Both are listed below. There is an option on one of the compiler menus that you choose if you are making a DA and not an application. Don't forget it, or you will end up with the wrong kind of code. Figure 2 shows all the files involved in creating ShowRes.

Figure 2, files used in the creation of ShowRes

When you invoke the DA option of the compiler it causes your program to be linked with a header that is in assembly language. The structure of this header matches what is described in Inside Mac for the structure of DAs in assembly language (Inside Mac does not even hint that DAs can be done in Pascal). This DA header is shown below:

;---------------------------------------
;---File AccHead.asm
;---------------------------------------
;---This is a generic Desk Accessory
;---interface for Pascal.
;---------------------------------------
;---It is linked with a .rel module 
;---containing the three xdefs  
;---Open, Ctl, and Close.  These must 
;---take two pointers on the stack.
;---------------------------------------
;---written 9/85 by Alan Wootton.
;---------------------------------------
 INCLUDE  MDS:SysEquX.D
 INCLUDE  MDS:ToolEquX.D
 INCLUDEMDS:QuickEquX.D
 INCLUDEMDS:FSEqu.D
 INCLUDEMDS:MacTraps.D

; declare the three Pascal procedures
; that are used for a Desk Accessory
 
 xref open
 xref close
 xref ctl

; Driver flags and information
; those below should fit most needs
;---------------------------------------
;Flags are: 
; 1- dNeedTime: recieve periodic service
; 2- dCtlEnable: can take control calls
;All other flags are not set.
;
; service rate is one call every second.
; menuID is filled by open if used

 dc.w $2400 ; Flags 
 dc.w $003C ; service rate
 dc.w $FFFF ; event mask
 dc.w $0000 ; MenuID goes here
  
; Entry point offset table

 dc.w   OrnOpen  ; open routine
 dc.w   OrnDone  ; prime
 dc.w   OrnCtl   ; control
 dc.w   OrnDone  ; status
 dc.w   OrnClose ; close

OrnOpen 
 moveM.la0/a1,-(sp);save regs
 move.l a1,-(sp) ;stack Device
 move.l a0,-(sp) ;stack Param 
 jsr    Open;visit Pascal land
 bra.s  orndone

OrnClose
 moveM.la0/a1,-(sp);save regs
 move.l a1,-(sp) ;stack Device
 move.l a0,-(sp) ;stack Param 
 jsr    Close    ;visit Pascal land
 ;bra.s orndone

Orndone
 moveM.l(sp)+,a0/a1;restore regs
 clr.l  d0
 rts

OrnCtl  
 moveM.la0/a1,-(sp);save regs
 move.l a1,-(sp) ;stack Device
 move.l a0,-(sp) ;stack Param 
 jsr    Ctl ;visit Pascal land
 
 moveM.l(sp)+,a0/a1;restore regs
 move.l jIODone,-(sp)
 rts

    end ;of assembly
;---------------------------------------
;-end of file
;---------------------------------------

Don't be put off by the many steps described to make a program. If all you want is a "plain vanilla" Pascal program, then there is a compiler option that will open a window, initialize the system for you, and allow regular readln and writeln in that window. You may also draw in the plain vanilla window if you wish. The whole bit with Rmaker is just for those who wish to make a Mac-style program with menus and windows and everything. Most simple MacPascal programs can be compiled with very little modification this plain vanilla way.

What a Desk Accesssory is

If you have a Mac and you are reading this publication you undoubtedly know what a DA looks like. You may not be aware of what its structure as a program is. The main difference between a DA and an application, from a programming standpoint, is that a DA has no main procedure. There is no main loop that obtains events, and there are no global variables. It is easiest if you imagine that you have written a standard program shell that does some of the parts of a program and that your task is to complete three routines to do the rest. The three routines are Open, Close and Ctl (short for Control). The system will call Open whenever the DA is selected from the Apple menu, and it will call Close when the close box on the window is clicked, or when someone calls CloseDeskAcc (see desk manager chapter of Inside Mac). Between these two the system will call Ctl to enable your DA to handle certian occasions.

Two records are passed to DA routines by the system. They are the Parameter Block Record and the Device Control Entry (DCE). The Parameter Block is the same record used in file manager calls and device manager calls (a DA is a type of driver). A new parameter block is formed, by the system, for each call the DA recieves. Its main use is the csCode field, which indicates the purpose of the control calls. Some values of csCode are predefined (and are declared in the program), others are available for your use (if you wanted to communicate between DAs, for instance). The Device Control Entry is created by the system for it to use to keep track of your DA. Certain of the fields are available for your use. DctlStorage, dctlWindow, dcltEmask, and dctlMenu are safe to modify. The others are for use by the system. I have redeclared the DCE record in ShowRes because it is convient for dctlStorage to be defined as a handle to my data and not simply as a handle to a byte.

Besides the issue of control, there is the problem of data. A DA has no global data. You cannot simply say VAR and then list the variables you are going to use, they would get destroyed at the end of that procedure. The system does, however, provide a facility for you. The Device Control Entry. You use this table as your only source of permanent storage. It is manditory to put your window pointer into dctlWindow and you may use dctlStorage as a handle to additional data. Once you get the idea of what's going on you will realise that there are a great many pathological conditions to be dealt with. How much is done by the system, and how much is left for the DA? For instance, do you need to ever call DragWindow? If you look at the code below you will see many strange things. Why is the windowKind field set? I could cover some of these here. If I did then this article would be twice the length it is, so, I'm going to try to list everything there is to know next month. You should be able to make simple DAs by following the example given, at least for a while.

One issue won't wait. A DA is installed in the system file, and after it is installed it no longer has a file or an icon. So, where are it's resources? A DAs resources are transferred along with it into the system file it resides in. In order to prevent collisions among the various DAs Apple has come up with a funky scheme for numbering the resources owned by DAs. "All DAs will have 32 resource IDs allotted to them. The IDs for DAs will begin at $C000 and number upwards." This means that if you are DRVR 16 then your resource numbers will begin at $C000+32*16. All resources outside this range will not be transferred by the Font/DA Mover! Note that if the font/DA Mover decides to change the number of your DA it will also change the numbers of all your resources. So, you must calculate the ID of your resources at run time. This calculation is performed in the open routine of ShowRes and the result stored in the dctlMenu field of the DCE. Note that the dctlRefNum is not exactly the ID of the driver, to convert use the formula ID:=-1*(1+dctlRefNum).

The font/DA Mover tries hard, but does an imperfect job of keeping your resources in correct reference to each other. It changes the part of a DLOG resource that refers to a DITL but when renumbering MENU types it does not change the menuID field of the menu record. This is the purpose of the patch you see in the Activate procedure of ShowRes. Apple claims that DLOG and ALRT references to DITLs are renumbered correctly, and that DITL references to ICON, PICT, and CTRL are right. References by MENUs to MDEFs are supposed to work, but you can bet all other cross references are left incorrect. Your average DA will get by just fine using only dialogs and menus, so lets leave these problems to advanced users.

Resource Rundown

Cruising through Inside Macintosh one is likely to get the impression that resource files are some mysterious place that window and menu definitions go. The thing to remember is that resource files are files. It is helpful to imagine what you would do if you were writing a program that maintained 100 or 200 pieces of information of all different sizes. What would you do? You could write the data into a file with length words and then traverse the data like a list of strings. In addition to the length, you might include some identifying information. Another way would be to have an array of offsets into the file, and to use this to find individual items. Eventually, you will find the need to read and write single pieces of the data without traversing, or loading, the whole file. In general you would want a complete and bullet proof collection of routines to handle these functions. Fortunately, Apple has provided a set of traps to handle these kind of things for us.

What Apple has done is to arrange references to the pieces of data into a "map" at the end of the file. The map contains information relating to the file manager access path for the file being used, as well as a complete list of the data pieces, or resources, contained in the file. As an added bonus, the data is broken into broad categories called "types" and sub-categories refered to by using an "ID". It is as if Apple created a whole filing system contained within a file (just as the file manager maintains files in a volume). The pieces of data can be recalled by the order they were put in, ie. "give me the 5th resource". Use GetIndResource for this. Or, the data items have IDs so you can recall them by ID match, "give me the resource with ID #1234". Use GetResource for this. As an example, when you open a dialog with ID #257, the dialog manager makes the call GetResource('DLOG',257) to get the information it needs.

When the file manager creates a file it initializes two lists of disk space for that file. Either of these lists can be empty (or both! it is possible to have files that occupy 0 K of disk space). The nomenclature "Data fork" and "Resource fork" are used to refer to these two lists. When the resource fork of a file is opened (by calling OpenResFile) the map is read into memory. A field in the map known as the "resource file reference number " is set to the ioRefNum of the open file. The maps of all open resource files are arranged in a list in memory. New files opened are added to the head of the list. One may call GetResource or GetNamedResource to retrieve the individual resources. Beware of the fact that since all open maps are in the list, the resource manager will return the first resource it finds that fits the description of what it is looking for. It is possible to avoid searching some of the maps at the head of the list, but in general it is difficult to search only one map. In order to survey all the resources in all the maps a function named GetIndResource is provided. A count of the total number of resources in all the maps may be obtained by using CountTypes, and CountResources. There are also routines for adding resources and modifying their status. The function of the ShowRes desk accessory is to display the contents of the maps.

In the maps, besides the descriptive information of a resources type, ID, name, and attributes, is a handle to the resource data. Many of the resource routines use the handle to refer, unambiguously, to the resource in question. You must use GetResource, GetNamedResource, or GetIndResource to obtain the handle. The resource map contains a space to store the handle, and this space can be in one of three possible conditions. First, when the map is first opened the space is zeroed out, ie. there is no handle. Later, if the resource is referred to, a handle is obtained from the memory manager. The handle may simply be allocated out of the memory managers list of master pointers without actually loading the data from the file. At this point the the map, and anyone else who asks, has a handle which points to a master pointer. However, unless the data is actually loaded, the master pointer is zero and there is no space allocated on the heap. If the data is then loaded, heap space is allocated, and the master pointer is set to point to the data on the heap. As you can see, the memory manager and the resource manager enjoy a very symbiotic relationship. We don't have time to discuss the memory manager in full here, but let me note that the resource manager uses some of the advanced features of both the memory manager, and also the file manager. Note that you may refer to a resource using it's handle, even if it occupies no space on the heap.

the Desk Accessory ShowRes

I created ShowRes to be an example DA. Rather than just do a 'shell' I decided to give it a useful function. The function is to peek at the resources that are available while an application is running. Many times I want to just see if a resource exists that is supposed to. Or, I need to find the length of a particular resource, or find where a piece of code begins on the heap. It is a hassle to return to the finder for such simple tasks. It also a hassle to read the maps in memory, in hex, with a debugger. Hence, ShowRes. The way ShowRes works is that it maintains variables for; a resource type: TheType; for an ID:TheID; and for a resource handle:TheRes. If all these variables are empty (set to 0) then a list of all the types is drawn in the window. If TheType is set then a list of all the id's of that type are drawn. If TheType, and TheRes are set then the information for that resource is drawn. Clicks in the information drawn are interpreted as a selection of that type (or ID) and the information about 'what is known' is updated accordingly. To reselect a type or ID you use a button that will reduce 'what is known' (ie. if just TheType is known, clear it, if TheType and TheRes are known, just clear TheRes). The worst part of the code is the calculation of which type or ID a click has landed on. Since the information is drawn in a grid in the window, all it takes is some div's and mod's to find where in the grid the click occured. Once you know which cell in the grid was clicked on, you can find which type or ID it was. It can be hard to get this kind of stuff right the first time so I worked with it in MacPascal until I had it right (it would have been better to use a box with scroll bars for this, but that would have taken a lot more code). To see the overall structure of ShowRes see figure 4.

MiniEdit

How would you like to have the source code to a complete Macintosh application? An application with multiple windows, a full menu bar, desk accessory support, the works. It would be a good place to start on your project wouldn't it? How about if this code were in Pascal and you could modify and recompile it at will? Further, imagine that this code is very modularly written and fully commented. Interested? Now, what if in addition to the comments in the code there were an excellently written, and comprehensive, document that described the detailed function of every procedure? I'm not talking about twenty or fifty pages of programmers notes. I'm talking about eleven hundred pages of carefully prepared and cross referenced material. In addition to the program description, you get a description of every toolbox routine used (and perhaps some that aren't).

Well, you can have it! It's called Macintosh Revealed by Stephen Chernicoff. You buy both volumes. The first one is basic toolbox calls, and the second volume is more advanced toolbox stuff and a description of the program MiniEdit. You then order the source code from Hayden Books for $19.95. That's it. Watch this column for my adventures while compiling MiniEdit with TML Pascal (it is actually written in Lisa Pascal, but that should be no problem).

The nice thing about Pascal is that there are examples like this. TML Pascal will also compile the many program examples provided to developers by Apple (with slight modification).

MacPascal and inlines

If you have been following my column you may have noticed that it is difficult to do very many Mac-like things in MacPascal without resorting to one of the inline statements (inlineP for procedures, BinlineF for functions returning booleans, WinlineF for those returning integers, and LinlineF for those returning 32 bit results). On the one hand, this is a blessing, since it enables one to hack around with the toolbox from within a very friendly environment. On the other hand I have come to the conclusion that unless you have a machine language dubugger and know how to use it, inline will eventually give you a great deal of trouble. With this in mind, it becomes very difficult to describe how inline works. If I lapse into 68000 terminology then it is easy, but trivial. If I stick to to Pascal then all I can say is that inline will invoke a toolbox trap in the place of a procedure or function. This is not strictly accurate though. What really happens is that the first word of the inline statement is actually executed by the processor, and the rest is put on the stack. If the first word is $Axxx, where xxx is any three hex digits, then an A-trap is executed. All the A-traps are toolbox routines. If the first word is something else then anything could happen. For instance theStack:=LinlineF($2E8F) will return the position of the hardware stack, no toolbox traps are involved. The reason for this is that $2E8F is the code for move.l sp,(sp) in assembly language. With this capability it is possible to do all sorts of weird things. For instance, this is how I call the routine "access" I have used in previous articles. I am not particulary proud of this. It looks real ugly in the code. Most languages have the capability for this sort of hacking, but usually it is hidden inside some interface files and you don't have to know how it works. The better way to use MacPascal would be to make declarations like:

Function GetNewWindow ( windowID: INTEGER; wStorage:Ptr;             
                                                behind:WindowPtr ):WindowPtr;
      begin
 GetNewWindow := Pointer( LinlineF( $A9BD , 
 WindowID , wStorage  , behind ) );
 end;

When you wanted a window you would just say GetNewWindow, with no inline to mess with. This also makes conversion to TML Pascal a snap. Unfortunately, if you did this there would be little room left for any program! After you pass 16K of text in MacPascal things get very slow, eventually it will die altogether. This is not my last word on this issue. Next time I'm using inline I'll bring it up again.

MacPascal Books

There are now five books about learning Pascal using MacPascal. Some seem better that others. All have many interesting, short, Pascal examples. I don't know what to say. There are too many of them!

MacPascal books I have heard of

Pascal for the Macintosh by Andrew Singer and Henry Legard, Addison Wesley

Macintosh Pascal by Lowell A. Carmony and Robert L. Holliday, Computer Science Press

MacPascal Programming by Drew Berentes, Tab Books

The MacPascal Book by Paul Goodman and Alan Zeldin, Brady Communications Company, Inc. A Prentice-Hall Publishing Company

Macintosh Pascal by Robert Moll and Rachel Folsom, with Mary Elting, Houghton-Mifflin

Other Books with Pascal examples

Macintosh Revealed Volume One and Two, by Stephen Chernicoff, Hayden Book Company

One Flew Over the Quickdraws Nest by Greg A. Lewis, Valuable Information Press

(Also available from the MacTutor Mail Order Store)

Pascal Compiler

MacLanguage Series Pascal: $99

TML Systems

582 North Wickham Rd., Suite 93

Melbourne Fla. 32935

(305) 242-1873

(Also available from the MacTutor Mail Order Store)

TML Pascal program for ShowRes Desk Accessory
program ShowResource;{ file ShowRes.pas }

{                                         
  ShowRes is a desk accessory that displays  
  the resources that are on the heap. 
  Written 9/85 by Alan Wootton. Compile
  with TML Pascal using make DA option.
  Resource compile ShowRes.R to add menu and 
  dialog stuff and to convert CODE to DRVR.           
                                         }

{  $I=Include these interface files }
(*$I MemTypes.ipas  *)
(*$I QuickDraw.ipas *)
(*$I OSIntf.ipas    *)
(*$I ToolIntf.ipas  *)

(*$A+ Write source code to .ASM file *)
(*$B+ set bundle bit*)
(*$T  ???? ????  type and creator *)

{   The values of the ParamBlock CSCode 
     field will have the following values. 
    These constants are not found in any 
    of the Macintosh interface files.        }

CONST accEvent   = 64;
               accRun= 65;
         accCursor = 66;
         accMenu = 67;
         accUndo = 68;
         accCut  = 70;
           accCopy = 71;
           accPaste= 72;
           accClear= 73;

 TYPE
    Lptr = ^longint;
    chBlock= packed array [0..15,0..15] of char;
    chBlockPtr=^chBlock;
  
{  This is our data.  A handle to it will be stored 
    in the dctlStorage field of the DCtlEntry record }
    
    mainDataP = ^maindata;
    mainDataH = ^mainDataP;
    mainData  = record     { our personal Data }
 TheType : ResType;{ type of subject }
 TheRes : Handle;   { to subject }
 TheID : integer;    { ID of subject resource }
 ViewR : Rect;       { lower portion of box }
 InfoR : Rect;         { upper left }
 MaxR : Rect;         { giant Rect }
 click : point;       { where a mdown was }
     end;
  
{ All drivers have one of these.  It is used to store
    system information about the state of the driver. 
    It will also be passed to us on all calls from 
    system.  Note that this record IS defined in 
    the interface files above (as DCtlEntry) so it is 
    NOT strictly necessary to redefine it here.  I am
    doing it because I wish to use dctlStorage^^ to refer
    to MainData without coercing types. }
  
    DeviceControlRec = record
 dCltDriver : Handle;
 DcltFlags : integer;
 dctlQueue : integer;
 DctlQHead : Lptr;
 DctlQtail : Lptr;
 DctlPosition : longint;
 DctlStorage : maindataH;
 dCtlRefNum : integer;
 dCtlCurTicks : longint;
 dCtlWindow : GrafPtr;
 dCtlDelay : integer;
 dCtlEmask : integer;
 dCtlMenu : integer;
     end;


{ var  variables for main program; not used }    

{                                         
     This first section is some data drawing procs.  
                                         }

{ Draw one hex character in current port}
{ at current pen position. }

 procedure PlotHex (c : char);
 begin
    if ord(c) < 10 then
       DrawChar(chr(ord(c) + ord('0')))
    else
       DrawChar(chr(ord(c) + ord('A') - 10));
 end;

{ Draw one Hex byte. }

 procedure PlotByte (c : char);
  begin
     PlotHex(chr(ord(c) div 16));
     PlotHex(chr(ord(c) mod 16));
  end;

 { Draw 256 Hex bytes, and 256 ASCII chars. }
 
 procedure PlotHexBlock ( chptr: chBlockPtr );
   var
      i, j : integer;
      xy : point;
      ch : char;
 begin
    TextMode(srcOr);
    GetPen(xy);
       for i := 0 to 15 do
   for j := 0 to 15 do
      begin
         ch:=chptr^[i,j];
 MoveTo(xy.h+j*16, xy.v+i*12);
 PlotByte(ch);
 MoveTo(xy.h+j*8+256, xy.v+i*12);
 DrawChar(ch);
      end;
    TextMode(srcCopy);
 end;

{ This recursive little beast draws longints without
  leading zeros. But it won't draw zero. }

 procedure DrawLong (i : longint);
 begin
    if i < 0 then
       begin
   i := -i;
   DrawChar('-');
       end;
    if i <> 0 then
       begin
   DrawLong(i div 10);
   DrawChar(chr((i mod 10) + ord('0')));
       end;
 end;

{ Draw an integer, or '0' if none. }

procedure DrawInteger (i : integer);
 begin
    if i = 0 then
       DrawChar('0')
    else
       DrawLong(i);
 end;
 
{ This works just like DrawLong above 
    but draws the number in binary }

 procedure DrawBinary (i : integer);
 begin
    if (i <> 0) and (i <> -1) then
       begin
   DrawBinary(i div 2);
   DrawChar(chr((i mod 2) + ord('0')));
      end;
 end;

{ convert a ResType into a str255 }

 procedure TypetoStr (var thetype : Restype;
                                         var str : str255);
begin
    str := '1234';{ so str has right length }
    BlockMove(@thetype, @str[1], 4);
 end;


{                                         
     Here are the procs that draw data into the
    window and calculate where in the data a 
    click occured.                                              
                                         }

{ Given a click in the list of IDs, 
   calculate which Resource it was.  }

 procedure ClickID (var MainVars : MainData );
   var
      i : integer;
 begin
 with MainVars do
    begin
     { first we find the x part ( mod 4 ) then we 
        add the y part ( * 4 ), then we have an index }
      i := ((click.h - ViewR.left) div 72) mod 4;
      i := i + (((click.v - ViewR.top) div 12) * 4);
      if i > CountResources(TheType)  then   
  i := 0;
      if i > 0 then
  begin
     SetResLoad(False);
     TheRes := GetIndResource(TheType,i);
     SetResLoad(true);
  end
      else
  TheRes := nil;
    end;
 end;

{ Given a click in the list of types, calculate which type it was. }

 procedure ClickType (var MainVars : MainData );
  var
     i : integer;
 begin
 with MainVars do 
   begin
      { this works the same as above except there 
         are 8 items per line, not 4 }
      i := ((click.h - viewR.left) div 36) mod 8;
      i := i + (((click.v - viewR.top) div 12) * 8);
      if i > countTypes then 
   i := 0;
      if i > 0 then
   GetIndType(TheType,i)
      else
  TheType:=ResType(pointer(0));
   end;
 end;

{ Draw list of types in ViewR. }

 procedure DrawTypes (var MainVars : MainData);
  var
     i : integer;
     tmpType : ResType;
     str : str255;
 begin
 with MainVars do
   begin
      moveto(infoR.left, infoR.top + 12);
      DrawString('Click on one of the types below');
      for i:=1 to countTypes do  
  begin
     moveto(viewR.left, viewR.top + 12);
     move((i mod 8) * 36, (i div 8) * 12);
     GetIndType(tmpType,i) ;
     TypeToStr(tmpType, Str);
     DrawString(str);
  end;
    end;
 end;

{ Draw list of ID's in ViewR. }

 procedure DrawIDs ( var MainVars : MainData );
  var
     tmpID, i : integer;
     tmpName, str : str255;
     H : Handle;
     tempType : ResType;
 begin
 with MainVars do
   begin
     moveto(infoR.left, infoR.top + 12);
     TypeToStr(TheType, str);
     DrawString('These are the resources of type ');
     DrawString(str);
   
     for i:= 1 to CountResources(TheType) do 
 begin
    moveto(viewR.left, viewR.top + 12);
    move((i mod 4) * 72, (i div 4) * 12);
       
    SetResLoad(False);
    H:=GetIndResource(TheType,i);
    SetResLoad(true);
    GetResInfo(H,tmpID,tempType,tmpName);
       
    DrawChar(' ');
    DrawInteger(tmpID);
    DrawChar(':');
    DrawString(tmpName);
 end;
  end;
 end;

{ Draw Info about the Resource. }

 procedure DrawResInfo (var MainVars : MainData );
  var
     tmpID : integer;
     tmpName, str : str255;
     H : Handle;
     tempType : ResType;
 begin
  with MainVars do
   begin
     if TheRes <> nil then
 begin
    tmpName := '';
    GetResInfo
         (TheRes,tmpID,TempType,tmpName);
    TypeToStr(tempType, str);
       
    moveto(infoR.left, infoR.top +8);
    DrawString('TYPE:');
    DrawString(str);
    DrawString(' Name:');
    DrawString(tmpName);
       
    moveto(infoR.left, infoR.top + 18 );
    DrawString('ID:');
    DrawInteger(tmpID);
    DrawString('  attributes:');
    DrawBinary(GetResAttrs(TheRes));  
    DrawString('  Size:');
    DrawLong(SizeResource(TheRes));
       
    MoveTo(infoR.left, infoR.top+ 28 );
    DrawString('  Handle is:');
    DrawLong(ord(TheRes));
    DrawString('  belongs to map#:');
    DrawInteger(HomeResFile(TheRes));
       
    MoveTo(viewR.left, viewR.top + 12);
    if TheRes^ <> nil then
       PlotHexBlock(pointer(ord(TheRes^)));
 end;
    end;
 end;


{                                         
     Following are procs to service the window.
     Windows need updating, and activation, etc
                                         }

{ a window activation function. We take this }
{ opportunity to put our menu in the menu bar }

 procedure activate (var device : deviceControlRec);
   var
     menH : menuHandle;
 begin
    with device do
       begin
   menH:= GetMenu(dctlMenu);
   
          {   the Font/DA mover does not correct the
   ID of menus when it renumbers them. 
   So, we must do it here  }
   menH^^.menuID:=dctlMenu;
   
   InsertMenu(MenH,0);
   DrawMenuBar; 
       end;
 end;

{ A window deactivation function.  We must remove }
{ our menu from the bar at this time }

 procedure deactivate(var device:deviceControlRec);
 begin
    with device do 
      begin 
  deleteMenu(dctlMenu);
  DrawMenuBar;
      end;
 end;

{ Redraw the window.  Draw type list, or ID list, or
  resource information depending upon what is set. }

 procedure updateself (var device:deviceControlRec);
  var
     max : integer;
 begin
  with device do
     begin
 beginupdate(dctlWindow);
 drawdialog(dctlWindow);
 with dctlStorage^^ do { with MainData }
    begin
       if  Longint(TheType)=0  then
  DrawTypes(dctlStorage^^)
       else 
  if TheRes = nil then
      DrawIDs(dctlStorage^^)
  else
      DrawResInfo(dctlStorage^^);
    end;
 endupdate(dctlWindow);
     end;
 end;

{                                        
     Finally we have the three main procs.
    Open, Ctl, and Close.  All calls from the
   'outside' will be handled by one of these three.  
    Note that Ctl has the event case split out
    for easier readability.
                                         }

{ Open:The first call from the system.  Make a 
  window and setup our private storage.
  Note that we could get an open call even after we
  are already open.   }

 procedure open (var device : deviceControlRec;
                            var block : ParamBlockRec);
  var
     Wpk : WindowPeek;
     Dtyp, ID : integer;
     Dhan : Handle;
     tmptr : ptr;
     dummy:MainData;
 begin
  ID := $C000 - 32 * (1 + device.dctlRefNum);
{ use this ID for all resource access }
  device.dctlMenu:=ID;

  with device do
     if dctlWindow = nil then
        begin
    dctlstorage := pointer(NewHandle( SizeOf(dummy)));
    { This is a handle to our private data }
      
    { It is good voodo to keep window records }
    { off of the bottom of the applications heap }
    tmptr:=NewPtr($1000); { 4K on bottom of heap}
      
    dctlWindow:=GetNewDialog(ID,nil,nil);  

           { Must set windowKind field.  Never forget this !}
    wpk := pointer(ord(dctlWindow));
    wpk^.windowKind := dctlRefNum;

    setport(dctlWindow);
    textMode(srcCopy);
    textfont(3);
    textsize(9);
      
    disposptr(tmptr);
 { leaving 4K hole under window record} 
      
    Hlock(Handle(DctlStorage));
    with DctlStorage^^ do
      begin                   { initialize  our  storage  }
             GetDitem(dctlWindow,2,Dtyp,Dhan,viewR);    
 GetDitem(dctlWindow,3,Dtyp,Dhan,InfoR);  
 TheType:=ResType(pointer(0));
 TheRes := nil;  
 SetRect(MaxR, -999, -999, 999, 999);
      end;{ of with storage }
           Hunlock(Handle(DctlStorage));
        end;{ of with }
 end;{ of open }

{ This is the end and there is no way to say no.
  The last call we will ever get. 
  We must clean up our act completely. }

 procedure close (var device : deviceControlRec;
                             var block : ParamBlockRec  );
 begin
    deactivate(device);{ remove menu }
    with device do
       begin
   disposHandle(Handle(dctlstorage));{ kill data }
   disposDialog(dctlWindow);{ erase window }
   dctlWindow := nil;
       end;{ of with }
 end;{ of close }

{ We are here because there has been an event 
  concerning our window. 
  Block.csParam[0] and [1]  point at the event record   }

 procedure Event (var device : deviceControlRec;
                              var block : ParamBlockRec  );
  var
     item, part : integer;
     tmpDptr:DialogPtr;
     evP:^EventRecord;
 begin
   blockMove(@block.csParam[0],@evP,4);
   { above is the best way I could think of to 
      convert 2 integers into a pointer }
      
   with evP^ do        { with eventRecord }
   with device.dctlStorage^^ do  { with MainData }
     begin
  case what of
    MouseDown :{1}
      begin
 click:= where;
 globaltolocal(click);
 if dialogselect(evP^,tmpDptr,item) then
     { normally one would compare tmpDptr 
       with ones own window, but a DA won't 
       get an event unless it's in his window  }
    begin
       case item of
        1 :               { close }
   if TheRes = nil then
     TheType := ResType(pointer(0))
   else
      TheRes := nil;
        2 :              {viewRect }
   begin
      if Longint(TheType) = 0 then
        ClickType(device.dctlStorage^^)
      else
        if TheRes = nil then
   ClickID(device.dctlStorage^^);
   end;
        otherwise
 ;
       end; { of item case }
   InvalRect(MaxR); { force update }
  end; { if DialogSelect }
      end; { Mdown case }
   UpdateEvt : {6} 
      updateself(device);
   ActivateEvt : {8}
 if odd(modifiers) then
    activate(device)
 else
    deactivate(device);
   otherwise
    ;{ ignore all other events }
       end;{ case of what }
    end;{ with eventRecord}
 end;{ procedure event }


{ Here is the main entry point for system calls. 
  The parameter block tells us what the nature of 
  this call is.  Note that in a more complex program
  the menu case could be made into a separate proc
  like the event case.   }

 procedure ctl (var device : deviceControlRec;
                          var block : ParamBlockRec  );
  var
      poi : point;
      cHan : cursHandle;
      wpnt : Grafptr;
      item : integer;
 begin
    setport(device.dctlWindow);
    Hlock(Handle(device.dctlStorage));
    with device.dctlStorage^^ do
     with block do
 begin
    case csCode of
       accEvent: 
             Event(device, block);
       accCursor:
  begin
     GetMouse(poi); 
     if ptInRect(poi, ViewR) then
        begin
           cHan:=GetCursor(CrossCursor);  
           SetCursor(cHan^^); 
        end
     else
        initcursor;
  end;
       accMenu: 
   begin        { case out menu item number }
      case  csParam[1]  of
 1 :                               { about... }
   begin
                  Wpnt:=GetNewDialog(
              device.dctlMenu+1,nil, pointer(-1));
      ModalDialog(nil,item);
      DisposDialog(wpnt);
   end; 
 3 :                            { LoadResource }
    if TheRes <> nil then
       LoadResource(TheRes)
    else
       sysbeep(10);
 4 :                   { ReleaseResource }
    if TheRes^ <> nil then
        begin
           ReleaseResource(TheRes);
                                            TheRes := nil;
        end
    else
        sysbeep(10);
 otherwise
    sysbeep(10);
        end;{ of case of menu }
    InvalRect(MaxR);{ force update }
    HiliteMenu(0);
 end;{ menu case of code }
       otherwise
        ;
    end;{ case of code }
 end;{ of with block }
     Hunlock(Handle(device.dctlStorage));
 end;{ of control  }

{                                         
    Observe the poor main procedure.  Since we
     will link with another module that will call
     Open, Ctl,and Close directly; there will 
    never be any use for a main proc.  
    Furthermore, there can be no global data for 
    a main proc to use.
                                         }
BEGIN
   (* No main program allowed *)
END.

Rmaker input file for ShowRes Desk Accessory
;;                                     
;;  file ShowRes.R
;; 
;;  Feeding this to Rmaker is the last
;;  step when compiling ShowRes.
;; 
;;  The CODE 1 resource is read from 
;;  ShowResL, the link output
;; 
;;  A Font/DA Mover data file is made.
;;                                     
;;   All Resources must be be between
;;  -15872 and -15841 inclusive if they
;;  are to travel with DRVR number 16
;;                                     
ShowRes.acc;;;  destination file name 
DFILDMOV;;  type and creator 
;;                                     

type DRVR = PROC
ShowRes,16;; name, DRVR number 16
ShowRes

;;                                     
;;  This DLOG is the main window. 
;;  The StatText items are used only
;;  for their rectangles.
;;                                     
type DLOG
ShRsDLOG,-15872;;id owned by #16
Show Resource;;;;window title
53 55 260 469  ;;global bounds
Visible GoAway
4       ;;wind. type 4
0              ;;refcon 0
-15872         ;;id of DITL

type DITL
ShRsDITL,-15872
3

BtnItem Enabled
5 320 25 411 
Close

StatText Enabled
25 5 206 410 
;;; View, clicks taken in here

StatText Enabled
0 5 26 225 
;;; Info, title to data drawn here

;;                                     
;;  This is the menu used by the DA. 
;;                                     
type MENU
ShRsMENU,-15872
ShowRes;;        menu title
about..;;        menu1
(-;;             dotted line
LoadResource;;   menu3
ReleaseResource;;menu4

;;                                     
;;  This second DLOG is for the 
;;  'about..' menu item.  The button
;;  and icons do nothing. They are 
;;  only for decoration.
;;                                     
type DLOG
ShRsDLOG2,-15871
About ShowRes;;    title
60 50 300 455;;    size
Visible NoGoAway
4
0
-15871

type DITL
ShRsDITL2,-15871
10

StatText enabled
5 5 91 400 
ShowRes -  an accessory to view ++
resources on the heap. Created ++
by Alan Wootton 9/85. ++
Written using Macintosh Pascal ++
and MacLanguage Pascal ++
from TML systems, Melbourne Fla.  ++
Published in MacTutor, The Macintosh ++
Programming Journal.;;

BtnItem enabled
95 5 102 395 
{|||||||||||||};;;used as separator

StatText enabled
105 5 191 400 
To select Resources click on the ++
list displayed. Use the button to ++
return to a previous list.  ++
Resources loaded will show the ++
first 256 bytes.  ++
Load resources with "LoadResource" ++
menu item. Use "ReleaseResource"++
carefully!!!;;

IconItem Disabled;; Icons along bottom
195 20 227 52    ;; for fun. 
0
IconItem Disabled
195 75 227 107 
1
IconItem Disabled
195 130 227 162 
2
IconItem Disabled
195 185 227 217 
1
IconItem Disabled
195 240 227 272 
2
IconItem Disabled
195 295 227 327 
1
IconItem Disabled
195 350 227 382 
0

;;                                     
;;  end of file ShowRes.R
;;                                     
 
AAPL
$102.50
Apple Inc.
+0.25
MSFT
$45.43
Microsoft Corpora
+0.55
GOOG
$571.60
Google Inc.
+2.40

MacTech Search:
Community Search:

Software Updates via MacUpdate

Skype 6.19.0.450 - Voice-over-internet p...
Skype allows you to talk to friends, family and co-workers across the Internet without the inconvenience of long distance telephone charges. Using peer-to-peer data transmission technology, Skype... Read more
VueScan 9.4.41 - 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
Cloud 3.0.0 - File sharing from your men...
Cloud is simple file sharing for the Mac. Drag a file from your Mac to the CloudApp icon in the menubar and we take care of the rest. A link to the file will automatically be copied to your clipboard... Read more
LibreOffice 4.3.1.2 - Free Open Source o...
LibreOffice is an office suite (word processor, spreadsheet, presentations, drawing tool) compatible with other major office suites. The Document Foundation is coordinating development and... Read more
SlingPlayer Plugin 3.3.20.505 - Browser...
SlingPlayer is the screen interface software that works hand-in-hand with the hardware inside the Slingbox to make your TV viewing experience just like that at home. It features an array of... Read more
Get Lyrical 3.8 - Auto-magically adds ly...
Get Lyrical auto-magically add lyrics to songs in iTunes. You can choose either a selection of tracks, or the current track. Or turn on "Active Tagging" to get lyrics for songs as you play them.... Read more
Viber 4.2.2 - Send messages and make cal...
Viber lets you send free messages and make free calls to other Viber users, on any device and network, in any country! Viber syncs your contacts, messages and call history with your mobile device,... Read more
Cocktail 7.6 - General maintenance and o...
Cocktail is a general purpose utility for OS X that lets you clean, repair and optimize your Mac. It is a powerful digital toolset that helps hundreds of thousands of Mac users around the world get... Read more
LaunchBar 6.1 - Powerful file/URL/email...
LaunchBar is an award-winning productivity utility that offers an amazingly intuitive and efficient way to search and access any kind of information stored on your computer or on the Web. It provides... Read more
Maya 2015 - Professional 3D modeling and...
Maya is an award-winning software and powerful, integrated 3D modeling, animation, visual effects, and rendering solution. Because Maya is based on an open architecture, all your work can be scripted... Read more

Latest Forum Discussions

See All

Rhonna Designs Magic (Photography)
Rhonna Designs Magic 1.0 Device: iOS Universal Category: Photography Price: $1.99, Version: 1.0 (iTunes) Description: Want to sprinkle *magic* on your photos? With RD Magic, you can add colors, filters, light leaks, bokeh, edges,... | Read more »
This Week at 148Apps: August 25-29, 2014
Shiny Happy App Reviews   | Read more »
Qube Kingdom – Tips, Tricks, Strategies,...
Qube Kingdom is a tower defense game from DeNA. You rally your troops – magicians, archers, knights, barbarians, and others – and fight against an evil menace looking to dominate your kingdom of tiny squares. Planning a war isn’t easy, so here are a... | Read more »
Qube Kingdom Review
Qube Kingdom Review By Nadia Oxford on August 29th, 2014 Our Rating: :: KIND OF A SQUARE KINGDOMUniversal App - Designed for iPhone and iPad Qube Kingdom has cute visuals, but it’s a pretty basic tower defense game at heart.   | Read more »
Fire in the Hole Review
Fire in the Hole Review By Rob Thomas on August 29th, 2014 Our Rating: :: WALK THE PLANKUniversal App - Designed for iPhone and iPad Seafoam’s Fire in the Hole looks like a bright, 8-bit throwback, but there’s not enough booty to... | Read more »
Alien Creeps TD is Now Available Worldwi...
Alien Creeps TD is Now Available Worldwide Posted by Ellis Spice on August 29th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Dodo Master Review
Dodo Master Review By Jordan Minor on August 29th, 2014 Our Rating: :: NEST EGGiPad Only App - Designed for the iPad Dodo Master is tough but fair, and that’s what makes it a joy to play.   | Read more »
Motorsport Manager Review
Motorsport Manager Review By Lee Hamlet on August 29th, 2014 Our Rating: :: MARVELOUS MANAGEMENTUniversal App - Designed for iPhone and iPad Despite its depth and sense of tactical freedom, Motorsport Manager is one of the most... | Read more »
Motorsport Manager – Beginner Tips, Tric...
The world of Motorsport management can be an unforgiving and merciless one, so to help with some of the stress that comes with running a successful race team, here are a few hints and tips to leave your opponents in the dust. | Read more »
CalPal Update Brings the App to 2.0, Add...
CalPal Update Brings the App to 2.0, Adds Lots of New Stuff Posted by Ellis Spice on August 29th, 2014 [ permalink ] | Read more »

Price Scanner via MacPrices.net

Apple now offering refurbished 21-inch 1.4GHz...
The Apple Store is now offering Apple Certified Refurbished 21″ 1.4GHz iMacs for $929 including free shipping plus Apple’s standard one-year warranty. Their price is $170 off the cost of new models,... Read more
Save $50 on the 2.5GHz Mac mini, on sale for...
B&H Photo has the 2.5GHz Mac mini on sale for $549.99 including free shipping. That’s $50 off MSRP, and B&H will also include a free copy of Parallels Desktop software. NY sales tax only. Read more
Save up to $300 on an iMac with Apple refurbi...
The Apple Store has Apple Certified Refurbished iMacs available for up to $300 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free. These are the best prices on... Read more
The Rise of Phablets
Carlisle & Gallagher Consulting Group, a businesses and technology consulting firm focused solely on the financial services industry, has released an infographic depicting the convergence of... Read more
Bad Driver Database App Allows Good Drivers t...
Bad Driver Database 1.4 by Facile Group is a new iOS and Android app that lets users instantly input and see how many times a careless, reckless or just plain stupid driver has been added to the... Read more
Eddy – Cloud Music Player for iPhone/iPad Fre...
Ukraine based CapableBits announces the release of Eddy, its tiny, but smart and powerful cloud music player for iPhone and iPad that allows users to stream or download music directly from cloud... Read more
A&D Medical Launches Its WellnessConnecte...
For consumers and the healthcare providers and loved ones who care for them, A&D Medical, a leader in connected health and biometric measurement devices and services, has launched its... Read more
Anand Lal Shimpi Retires From AnandTech
Anand Lal Shimpi, whose AnandTech Website is famous for its meticulously detailed and thoroughgoing reviews and analysis, is packing it in. Lal Shimpi, who founded the tech site at age 14 in 1997,... Read more
2.5GHz Mac mini, Apple refurbished, in stock...
The Apple Store has Apple Certified Refurbished 2.5GHz Mac minis available for $509, $90 off MSRP. Apple’s one-year warranty is included, and shipping is free. Read more
13-inch 2.5GHz MacBook Pro on sale for $999,...
B&H Photo has the 13″ 2.5GHz MacBook Pro on sale for $999.99 including free shipping plus NY sales tax only. Their price is $100 off MSRP. Read more

Jobs Board

*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
*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
*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
*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
Senior Event Manager, *Apple* Retail Market...
…This senior level position is responsible for leading and imagining the Apple Retail Team's global event strategy. Delivering an overarching brand story; in-store, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.