TweetFollow Us on Twitter

McFace
Volume Number:3
Issue Number:7
Column Tag:Fortran's World

McFace Fixes MS Fortran

By Chuck Bouldin, Gaithersburg, MD

Fortran Toolbox Access with McFace

Most programmers who use Fortran on the Macintosh do so because:(1) they already know Fortran, (2) they have a lot of existing code that they want to run on the Mac, or (3) they want to add Macintosh features to existing programs. So far, the articles on MacFortran have dealt mainly with adding toolbox and Mac-specific features to Fortran programs. From earlier articles, it is clear that adding Mac-style features to existing Fortran code is not easy to do. In this article I discuss the use of McFace, a large, high level, “glue” subroutine that greatly simplifies adding Mac features to Fortran programs.

McFace is particularly useful for porting existing Fortran applications, adding to the existing code the Mac “look and feel”. Apple is now pushing “desktop engineering” and 68020 upgrades are becoming commonplace, so it is important to find an easy means to port the large body of existing Fortran engineering and scientific code, while adding the user interface features required in a good Macintosh application.

McFace is a single, large (134K, whew!) subroutine that allows easy access to much of the Mac toolbox. The user interface is reduced to a single subroutine call with arguments that are used to pick out the various functions supplied by McFace. By making very small additions to existing Fortran source, it is easy to add support for the standard Apple, File and Edit menus, text editing of input and output streams, desk accessory support, and a graphics window. Graphics can be written to the screen and saved as Bitmaps or quickdraw pictures, allowing automatic handling of update events in the graphics window. With slightly more effort, existing Fortran can have dialogue boxes, alerts, and custom menus added. Conversion of existing programs to the event orientation of the Mac world is simplified. McFace also takes care of a lot of memory management automatically.

McFace is an external subroutine that, when called, is automatically linked in by Fortran’s runtime linking system. Thus, McFace need not be explicitly linked to a Fortran program that is under development, but can be “hard” linked after the final compilation. The use of runtime linking allows multiple applications to share one copy of McFace. McFace also has the Fortran Toolbx subroutine linked to it and contains resources. Because of this, the McFace subroutine must reside in the System folder of an HFS system.

In order to show how McFace works, it is best to do an example. Starting with the generic Fortran code for the famous Sieve of Eratosthenes benchmark, we will convert it to a Mac interface using McFace. This is done in two stages in order to show the hierarchy of McFace additions that can be made to generic Fortran code. Unfortunately, even if you have Fortran, you aren’t going to be able to run any of this code unless you also get McFace. Therefore, I intend to show the listings in order to illustrate how simple the code is in structure, while still letting you have a Mac interface on your Fortran programs. The three versions of the Sieve presented here are all functionally the same; they differ only in the user interface. To illustrate how the user interface changes as McFace additions are made, I have included copies of the output screens for each version of the program.

How it Works

Before diving in an a specific example, it is worthwhile to say a few general things about how McFace works. The main feature that makes the concept of McFace possible is the ability of Fortran to do input and output to “internal” files. That is, reads and writes can take place from a variable rather than from an i/o channel such as unit 5. McFace is able to intercept Fortran i/o by reassigning i/o to a specified internal file, in this case a character variable called MAC. McFace then acts as an intermediary that sits between the generic Fortran code and the new user interface possibilities of the Macintosh. McFace also adds a Common block to your applications so that communication between McFace and your code can be maintained through a few variables in Common.

A generic call to McFace has the form: Call McFace( 11 integer arguments). The first argument controls whether any character I/O is done, and, if so, to what window. The contents of the character variable “MAC” are used to shuttle character information between your Fortran code and McFace. The next 10 arguments are organized into 5 pairs. Each pair of numbers selects one of McFace’s high-level functions, or macros, for execution. This structure can be terse and a little cryptic, but it lets you pack a lot of power into a single call to McFace.

For example, the McFace call:

Call McFace(0, 4, 2, 3, 2, 2, -6, 0, 0, 0, 0)

will (1) Specify no I/O because of the initial 0, (2) the 4,2 specifies bringing a text edit window to the front, (3) the 3,2 moves the text insertion bar to the end of the text in the window, (4) finally the 2,-6 causes a return to the user’s code without updating the contents of MAC. The trailing zeroes are present since McFace can have up to 5 macro calls at one time. McFace must be called, like all Fortran subroutines, with a fixed number of arguments, so the last 2 unused macro slots must be zero-filled.

Without repeating the McFace documentation this gives some of the flavor of how McFace is used. The calls to McFace look more obscure than they really are, since about 6-8 different combinations of macros suffice to start out converting generic Fortan to a Mac interface.

Converting the Sieve

Listing 1 shows the “generic” Sieve of Eratosthenes, as supplied with the compiler by Absoft. Running this program brings up the “glass teletype” window that is defined by the Fortran runtime library. The user interface is nonexistent; what the user sees is unchanged from that of a conventional computer. The totally un-Mac-like output is shown in Screen 1.

Listing 2 shows the same code with the modifications needed to attach McFace to the existing code. The modifications are minimal: (1) There is some initialization code (2) I/O is trapped and routed through McFace by using a Fortran “internal file”, as described above. Characters are written to variable MAC rather than to an assigned I/O channel. Support for the standard Apple, File and Edit menus is automatically handled by McFace. The part of the code that is used to add McFace is in boldface, while the old “generic” Sieve code is in plain text. Screen 2 shows the user interface presented by the code of listing 2. For a very small amount of work, the user has essentially the full Mac interface! Much larger Fortan code can be adapted along the general lines shown here. The only disadvantage to this approach, as can be seen from the listing, is that McFace related code gets sprinkled throughout the old ANSI Fortran code.

Listing 3 shows a more complete adaptation of the Sieve for use with McFace. Here, McFace calls are not distributed throughout the existing Fortran code. Instead, the Sieve program has been converted to a subroutine that does no I/O. Communication with the main routine (a McFace shell) is done by passing an argument. This is a clean general solution to porting existing Fortran code to the Mac. The routines that do the real work are kept to simple ANSI Fortran, while McFace serves as the interface between the Fortran code and the Macintosh environment. Again, McFace related code is in boldface. Screen 3 shows the output of this code, which is almost identical to that of listing 2, except for the addition of an “About Sieve” alert. The advantage of using a McFace shell with standard Fortran subroutines for each menu entry is that every application has essentially the same structure, except for the application specific menu entries and resources. Writing new applications becomes quite trivial, since the standard shell is providing all the Mac-specific support features.

Notice that the use of a McFace shell allows the Sieve to be converted to a Menu driven system which incorporates the event orientation that all Mac programs should have. Events are actually trapped by McFace, which in turn reports Menu events back to the Fortran program so that the appropriate part of the user’s code is run. McFace takes care of handling Activate, Update, Scrolling, Auto-scrolling, Text Edit and SystemClick events, so that the work that is done by the application Fortran code is greatly reduced.

The menus, windows and alerts in McFace are all resources. Therefore, further customization of the McFace environment can be achieved by using ResEdit on McFace’s resources. This is nice for adjusting size, position and title of the McFace windows. One can also include new resources to be used for your own alerts, as shown in Listing 3 and Screen 3.

Critique

Like any other programming tool, McFace has both strengths and weaknesses. Here are some of each:

The ease of use of McFace is easily its biggest strength. To make the minimal modifications to the Sieve, which was the first thing I did with McFace, took about 20 minutes from the time that I first opened the documentation.

McFace provides enough built in functionality that writing new applications with McFace really takes less work than using the glass teletype environment supplied with Fortran. Once one application has been written with McFace, the subsequent ones are very easy.

At 134K, McFace is not small. McFace provides a tremendous gain in functionality over plain MacFortran, but it costs a lot of memory. This is a trade-off that was made deliberately, since the use of a single subroutine is what makes using McFace so simple. Under switcher or with a ram cache or ram disc you need to leave at least 256K of memory for any application that uses McFace. Big programs will require more. The space that McFace takes up on disc can be reduced by allowing more than one program to use McFace via Fortran’s link-at-runtime capability.

The macro commands bundle a lot of functionality into a single subroutine call. So much, in fact, that it is sometimes unclear to a naive user what all the effects of the call will be. However, the macro calls are well thought out, so the best way to learn McFace is to just dive in and try running and modifying the sample programs that are included. When I did not understand all the effects of a call to McFace, I got unexpected behavior, but no crashes.

Text output is limited to <32K because of the use of Text Edit Records in the text output windows. Some operations, such as Text Output, are slower with McFace than with a straight Fortran program. Speed is still acceptable, however.

I think the “macro” commands in McFace should not accessed by number. Instead, I think there should be a parameter file which uses the Fortran PARAMETER statement to define symbolic equivalents to the macro numbers. This is exactly what is done in all the Fortran include files for Toolbox access. In early revisions of McFace there have already been inconsistent changes in the macro numbers between versions, which caused me to recode some of my programs. Use of a PARAMETER file would have made converting between revisions completely transparent. Use of parameters would also make McFace calls more self documenting. A PARAMETER file should at least be included as an option for the user.

Except for the size of McFace, and possibly, the use of parameters, these are only minor quibbles. The author, Dan Kampmeier is constantly improving McFace and adding features and functionality. He readily responds to input from users. Most of the deficencies of Fortran for Macintosh programming are eliminated by McFace. [Thank you Dan Kampmeier, for doing Microsoft’s job! Between McFace and the CLR Libraries, maybe Microsoft will learn how to they SHOULD have done their programming products! -Ed]

Summary

McFace is a single external subroutine that acts as a Fortran “extender”. With very little effort generic Fortran programs can be converted to run with a full Mac interface.

The outstanding feature of McFace is its simplicity of use. The major drawback is the 134K of size that it adds to an application. However, this subroutine handles almost all of the Toolbox programming that you will ever need to do from Fortran.

Conversion of existing Fortran code to a Mac interface can almost be reduced to a cookbook translation process, at least for a first iteration. Fine tuning and addition of features is simple and is added by McFace’s ability to work with user designed resources. In short, if you have been frustrated by the difficulty of writing true Mac applications in Fortran, then McFace will probably solve your problems.

McFace is available from Dan Kampmeier or Tensor labs. There is probably an advertisement for it in this issue of MacTutor.

{1}
Listing 1
*
*       Sieve of Eratosthenes
*
        logical*2 flags(8191)
        integer*2 i,j,k,count,iter,prime
        n = long(362)                   ! 60 Hz counter
        do 92 iter = 1,10
           count=0
           i=0
           do 10 i = 1,8191
10            flags(i) = .true.
           do 91 i = 1,8191
              if (.not. flags(i)) go to 91
              prime = i + i + 3
              count = count + 1
              k = i + prime
              if (k .gt. 8191) go to 91
              do 60 j = k, 8191, prime
60               flags(j) = .false.
91          continue
92      continue
        write (9,*) count,” primes in”,(long(362)-n)/60.0,” seconds”
        pause
        end

Screen 1

{2}
Listing 2
*       Sieve of Eratosthenes
*
        logical*2 flags(8191)
        integer*2 i,j,k,count,iter,prime
c
c McFace Initialization Code
    include HFS VOLUME:FORTRAN 2.2:INCLUDE FILES:McVariables
    storage(232) = 10240!at least 10K of memory for stack expansion
    storage(240) = 3        !up to 5 text editors
    MAC = “About Sieve...”   !”About Program”
    call McFace(0,2,-6,0,0,0,0,0,0,0,0)     !initialize variables
c
c bring up editor #1, move insertion bar to end,return without reading:
        call McFace(0,4,2,3,2,2,-6,0,0,0,0)
c
c The code that does the work
        n = long(362)                   ! 60 Hz counter
        do 92 iter = 1,10
           count=0
           i=0
           do 10 i = 1,8191
10            flags(i) = .true.
           do 91 i = 1,8191
              if (.not. flags(i)) go to 91
              prime = i + i + 3
              count = count + 1
              k = i + prime
              if (k .gt. 8191) go to 91
              do 60 j = k, 8191, prime
60               flags(j) = .false.
91          continue
92      continue
        write (MAC,198) count,(long(362)-n)/60.0
198     FORMAT(I6, ‘ primes in ‘, f4.2, ‘ seconds’)
        call McFace(-1,2,-6,0,0,0,0,0,0,0,0)
        pause
        end
c
c Include McFace Variables
        include HFS VOLUME:FORTRAN 2.2:INCLUDE FILES:McMemory

Screen 2

{3}
Listing 3
*   McFace Shell to run
*   Sieve of Eratosthenes example
       integer*2 nprimes
c
c  McFace Initialization Code
 include HFS VOLUME:FORTRAN 2.2:INCLUDE FILES:McVariables
 storage(232) = 20240 !at least 20K of memory for stack              
 
 storage(240) = 3  !up to 2 text editors
   MAC = “About Sieve...”  !”About Program” 
   call McFace(0,2,-6,0,0,0,0,0,0,0,0) !initialize variables
c
c  Add a custom menu for the Sieve
   file = ‘Sieve’
   MAC = ‘Do Sieve;Write Test’
   call McFace(0,-1,0,2,-6,0,0,0,0,0,0)
c
c  bring up editor #1, move insertion bar to end,
c  and return without reading:
   call McFace(0,4,2,3,2,2,-6,0,0,0,0)
c
c  Loop that just waits for menu command
   do
 call McFace(0,0,0,0,0,0,0,0,0,0,0)
   select case (MAC)
 case(‘About’)    !open “About “ alert call McFace(0,10,4,0,0,0,0,0,0,0,0)
       case(‘Do Sieve’)
     n1 = long(362)  ! 60 Hz counter. Start
        call Sieve(nprimes)
     n2 = long(362)   ! 60 Hz counter. Stop
     deltat = (n2-n1)/60.0
        write (MAC,198) nprimes, deltat
198 FORMAT(I6, ‘ primes in ‘, f4.2, ‘ seconds’)
        call McFace(-1,4,2,2,-6,0,0,0,0,0,0)
 case default

    end select
   repeat
   end
c       Sieve of Eratosthenes subroutine
c       Just generic Fortran code, converted to a subroutine

        subroutine Sieve(count)
        logical*2 flags(8191)
        integer*2 i,j,k,count,iter,prime
        n = long(362)                   ! 60 Hz counter
        do 92 iter = 1,10
           count=0
           i=0
           do 10 i = 1,8191
10            flags(i) = .true.
           do 91 i = 1,8191
              if (.not. flags(i)) go to 91
              prime = i + i + 3
              count = count + 1
              k = i + prime
              if (k .gt. 8191) go to 91
              do 60 j = k, 8191, prime
60               flags(j) = .false.
91          continue
92      continue
 dt = (long(362)-n)/60.0
 return
        end
   include HFS VOLUME:FORTRAN 2.2:INCLUDE FILES:McMemory
 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Adobe Lightroom 6.1.1 - Import, develop,...
Adobe Lightroom is available as part of Adobe Creative Cloud for as little as $9.99/month bundled with Photoshop CC as part of the photography package. Lightroom 6 is also available for purchase as a... Read more
File Juicer 4.41 - Extract images, video...
File Juicer is a drag-and-drop can opener and data archaeologist. Its specialty is to find and extract images, video, audio, or text from files which are hard to open in other ways. It finds and... Read more
A Better Finder Rename 9.52 - File, phot...
A Better Finder Rename is the most complete renaming solution available on the market today. That's why, since 1996, tens of thousands of hobbyists, professionals and businesses depend on A Better... Read more
OmniFocus 2.2.3 - GTD task manager with...
OmniFocus helps you manage your tasks the way that you want, freeing you to focus your attention on the things that matter to you most. Capturing tasks and ideas is always a keyboard shortcut away in... Read more
TinkerTool 5.4 - Expanded preference set...
TinkerTool is an application that gives you access to additional preference settings Apple has built into Mac OS X. This allows to activate hidden features in the operating system and in some of the... Read more
Tinderbox 6.3.1 - Store and organize you...
Tinderbox is a personal content management assistant. It stores your notes, ideas, and plans. It can help you organize and understand them. And Tinderbox helps you share ideas through Web journals... Read more
Parallels Desktop 10.2.2 - Run Windows a...
Parallels Desktop is simply the world's bestselling, top-rated, and most trusted solution for running Windows applications on your Mac. With Parallels Desktop for Mac, you can seamlessly run both... Read more
Adobe Premiere Pro CC 2015 9.0.1 - Digit...
Premiere Pro CC 2015 is available as part of Adobe Creative Cloud for as little as $19.99/month (or $9.99/month if you're a previous Premiere Pro customer). Premiere Pro CS6 is still available for... Read more
Adobe After Effects CC 2015 13.5.1 - Cre...
After Effects CC 2015 is available as part of Adobe Creative Cloud for as little as $19.99/month (or $9.99/month if you're a previous After Effects customer). After Effects CS6 is still available... Read more
Adobe Creative Cloud 2.2.0.129 - Access...
Adobe Creative Cloud costs $49.99/month (or less if you're a previous Creative Suite customer). Creative Suite 6 is still available for purchase (without a monthly plan) if you prefer. Introducing... Read more

Domino Drop (Games)
Domino Drop 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Domino Drop is a delightful new puzzle game with dominos and gravity!Learn how to play it in a minute, master it day by day.Your... | Read more »
OPERATION DRACULA (Games)
OPERATION DRACULA 1.0.1 Device: iOS Universal Category: Games Price: $5.99, Version: 1.0.1 (iTunes) Description: 25% off launch sale!!! 'Could prove to be one of the most accurate representations of the Japanese bullet hell shmup... | Read more »
Race The Sun (Games)
Race The Sun 1.01 Device: iOS iPhone Category: Games Price: $4.99, Version: 1.01 (iTunes) Description: You are a solar craft. The sun is your death timer. Hurtle towards the sunset at breakneck speed in a futile race against time.... | Read more »
Tap Delay (Music)
Tap Delay 1.0.0 Device: iOS Universal Category: Music Price: $4.99, Version: 1.0.0 (iTunes) Description: Back in the “old days”, producers and engineers created delay and echo effects using tape machines. Tap Delay combines the warm... | Read more »
This Week at 148Apps: July 20-24, 2015
July is Heating Up With 148Apps How do you know what apps are worth your time and money? Just look to the review team at 148Apps. We sort through the chaos and find the apps you're looking for. The ones we love become Editor’s Choice, standing out... | Read more »
Red Game Without A Great Name (Games)
Red Game Without A Great Name 1.0.3 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.3 (iTunes) Description: The mechanical bird is flying through an unfriendly, Steampunk world. Help it avoid obstacles and deadly... | Read more »
Warhammer: Arcane Magic (Games)
Warhammer: Arcane Magic 1.0.2 Device: iOS Universal Category: Games Price: $9.99, Version: 1.0.2 (iTunes) Description: Engage in epic battles and tactical gameplay that challenge both novice and veteran in Warhammer: Arcane Magic, a... | Read more »
Mazes of Karradash (Games)
Mazes of Karradash 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: The city of Karradash is under attack: the monsters of the Shadow Realms are emerging from the depths.No adventurer is... | Read more »
Battle Golf is the Newest Game from the...
Wrassling was a pretty weird - and equally great - little wressling game. Now the developers, Folmer Kelly and Colin Lane, have turned their attention to a different sport: golfing. This is gonna be weird. [Read more] | Read more »
Qbert Rebooted has the App Store Going...
The weird little orange... whatever... is back, mostly thanks to that movie which shall remain nameless (you know the one). But anyway it's been "rebooted" and now you can play the fancy-looking Qbert Rebooted on iOS devices. [Read more] | Read more »

Price Scanner via MacPrices.net

12-inch MacBooks in stock for $20 off, save o...
Adorama has 12″ Retina MacBooks in stock for $20 off MSRP including free shipping plus NY & NJ sales tax only. For a limited time, Adorama will include a free Apple USB-C to USB Adapter, free 4-... Read more
College Student Deals: Additional $100 off Ma...
Take an additional $100 off all MacBooks and iMacs at Best Buy Online with their College Students Deals Savings, valid through August 8, 2015. Anyone with a valid .EDU email address can take... Read more
2015 13-inch 2.7GHz Retina MacBook Pro on sal...
B&H Photo has the new 2015 13″ 2.7GHz/128GB Retina MacBook Pro on sale today for $1199 including free shipping plus NY sales tax only. Their price is $100 off MSRP. Read more
2.8GHz Mac mini available for $988, includes...
Adorama has the 2.8GHz Mac mini available for $988, $11 off MSRP, including a free copy of Apple’s 3-Year AppleCare Protection Plan. Shipping is free, and Adorama charges sales tax in NY & NJ... Read more
Updated Mac Price Trackers
We’ve updated our Mac Price Trackers with the latest information on prices, bundles, and availability on systems from Apple’s authorized internet/catalog resellers: - 15″ MacBook Pros - 13″ MacBook... Read more
High-Precision Battery Fuel Gauge IC Extends...
Renesas Electronics Corporation has announced its new lithium-ion (Li-ion) battery fuel gauge IC, the RAJ240500, designed to extend battery life for connected mobile devices such as tablets, notebook... Read more
27-inch 3.3GHz 5K iMac on sale for $1799, $20...
B&H Photo has the 27″ 3.3GHz 5K iMac on sale for $1799 including free shipping plus NY tax only. Their price is $200 off MSRP, and it’s the lowest price available for this model from any Apple... Read more
Twelve South Free Dual Screen Backgrounds Co...
Twelve South has posted a second collection of travel Desktop photos, noting: For the Twelve South team, a vacation is never just a vacation. It’s a time to try out new prototypes on the road, visit... Read more
Apple Refurbished iMacs available for up to $...
The Apple Store has Apple Certified Refurbished iMacs available for up to $380 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free: - 27″ 3.5GHz 5K iMac – $1949 $... Read more
Tablets: Why Microsoft’s Surface Is Soaring W...
In contrast to Apple’s record fiscal third quarter reported this week, Microsoft had a miserable latest quarter with its revenues falling by 5.1 percent, hammered by ongoing weak PC demand, and... 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
*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
*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
*Apple* Customer Experience (ACE) Leader - A...
…management to deliver on business objectives Training partner store staff on Apple products, services, and merchandising guidelines Coaching partner store staff on Read more
Project Manager - *Apple* Pay Security - Ap...
**Job Summary** The Apple Pay Security team is seeking a highly organized, results-driven Project Manager to drive the development of Apple Pay Security. If you are Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.