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

Garmin Express 4.0.18.0 - Manage your Ga...
Garmin Express is your essential tool for managing your Garmin devices. Update maps, golf courses and device software. You can even register your device. Update maps Update software Register your... Read more
jAlbum Pro 12.6.4 - Organize your digita...
jAlbum Pro has all the features you love in jAlbum, but comes with a commercial license. With jAlbum, you can create gorgeous custom photo galleries for the Web without writing a line of code!... Read more
jAlbum 12.6.4 - Create custom photo gall...
With jAlbum, you can create gorgeous custom photo galleries for the Web without writing a line of code! Beginner-friendly, with pro results Simply drag and drop photos into groups, choose a design... Read more
Microsoft Remote Desktop 8.0.16 - Connec...
With Microsoft Remote Desktop, you can connect to a remote PC and your work resources from almost anywhere. Experience the power of Windows with RemoteFX in a Remote Desktop client designed to help... Read more
Spotify 1.0.4.90. - Stream music, create...
Spotify is a streaming music service that gives you on-demand access to millions of songs. Whether you like driving rock, silky R&B, or grandiose classical music, Spotify's massive catalogue puts... Read more
djay Pro 1.1 - Transform your Mac into a...
djay Pro provides a complete toolkit for performing DJs. Its unique modern interface is built around a sophisticated integration with iTunes and Spotify, giving you instant access to millions of... Read more
Vivaldi 1.0.118.19 - Lightweight browser...
Vivaldi browser. In 1994, two programmers started working on a web browser. Our idea was to make a really fast browser, capable of running on limited hardware, keeping in mind that users are... Read more
Stacks 2.6.11 - New way to create pages...
Stacks is a new way to create pages in RapidWeaver. It's a plugin designed to combine drag-and-drop simplicity with the power of fluid layout. Features: Fluid Layout: Stacks lets you build pages... Read more
xScope 4.1.3 - Onscreen graphic measurem...
xScope is powerful set of tools that are ideal for measuring, inspecting, and testing on-screen graphics and layouts. Its tools float above your desktop windows and can be accessed via a toolbar,... Read more
Cyberduck 4.7 - FTP and SFTP browser. (F...
Cyberduck is a robust FTP/FTP-TLS/SFTP browser for the Mac whose lack of visual clutter and cleverly intuitive features make it easy to use. Support for external editors and system technologies such... Read more

This Week at 148Apps: April 20-24, 2015
The Apps of April 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 above the many... | Read more »
Discover Your Reflexes With Minimalist G...
Discover O, BYOF Studios, may look simple at first with its' color matching premise and swipe controls, but as you speed up the task becomes more daunting. [Read more] | Read more »
Here's Another Roundup of Notable A...
Now that the Apple Watch is publically available (kind of), even more apps and games have been popping up for it. Some of them are updates to existing software, others are brand new. The main thing is that they're all for the Apple Watch, and if you... | Read more »
Use Batting Average and the Apple Watch...
Batting Average, by Pixolini, is designed to help you manage your statistics. Every time you go to bat, you can use your Apple Watch to track  your swings, strikes, and hits. [Read more] | Read more »
Celebrate Studio Pango's 3rd Annive...
It is time to party, Pangoland pals! Studio Pango is celebrating their 3rd birthday and their gift to you is a new update to Pangoland. [Read more] | Read more »
Become the World's Most Important D...
Must Deliver, by cherrypick games, is a top-down endless-runner witha healthy dose of the living dead. [Read more] | Read more »
SoundHound + LiveLyrics is Making its De...
SoundHound Inc. has announced that SoundHound + LiveLyrics, will be one of the first third-party apps to hit the Apple Watch. With  SoundHound you'll be able to tap on your watch and have the app recognize the music you are listening to, then have... | Read more »
Adobe Joins the Apple Watch Lineup With...
A whole tidal wave of apps are headed for the Apple Watch, and Adobe has joined in with 3 new ways to enhance your creativity and collaborate with others. The watch apps pair with iPad/iPhone apps to give you total control over your Adobe projects... | Read more »
Z Steel Soldiers, Sequel to Kavcom'...
Kavcom has released Z Steel Soldiers, which continues the story of the comedic RTS originally created by the Bitmap Brothers. [Read more] | Read more »
Seene Lets You Create 3D Images With You...
Seene, by Obvious Engineering, is a 3D capture app that's meant to allow you to create visually stunning 3D images with a tap of your finger, and then share them as a 3D photo, video or gif. [Read more] | Read more »

Price Scanner via MacPrices.net

Final day for Best Buy’s 4 Day Sale: Up to $3...
Best Buy has the new 2015 13″ 1.6GHz/128GB MacBook Air on sale for $799.99 through April 27th. That’s $200 off MSRP, and it’s the lowest price available for this new model from any reseller. Choose... Read more
College Student Deals: Additional $50 off Mac...
Take an additional $50 off all MacBooks and iMacs at Best Buy Online with their College Students Deals Savings, valid through May 9, 2015. Anyone with a valid .EDU email address can take advantage of... Read more
Save up to $300 on a new Mac, $30 on an iPad,...
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
Zoho Business Apps for Apple Watch Put Select...
Pleasanton, California based Zoho has launched Zoho Business Apps for Apple Watch, a line of apps that extends Zoho business applications to let users perform select functions from an Apple Watch.... Read more
Universal Stylus Initiative Launched to Creat...
OEMs, stylus and touch controller manufacturers have announced the launch of Universal Stylus Initiative (USI), a new organization formed to develop and promote an industry specification for an... Read more
Amazon Shopping App for Apple Watch
With the new Amazon shopping app for Apple Watch, Amazon customers with one of the wearable devices can simply tap the app on the watch to purchase items in seconds, or save an idea for later. The... Read more
Mac Pros on sale for up to $260 off MSRP
B&H Photo has Mac Pros on sale for up to $260 off MSRP. Shipping is free, and B&H charges sales tax in NY only: - 3.7GHz 4-core Mac Pro: $2799, $200 off MSRP - 3.5GHz 6-core Mac Pro: $3719.99... Read more
Apple refurbished Time Capsules available for...
The Apple Store has certified refurbished Time Capsules available for $100 off MSRP. Apple’s one-year warranty is included with each Time Capsule, and shipping is free: - 2TB Time Capsule: $199, $100... Read more
Intel Compute Stick: A New Mini-Computing For...
The Intel Compute Stick, a new pocket-sized computer based on a quad-core Intel Atom processor running Windows 8.1 with Bing, is available now through Intel Authorized Dealers across much of the... Read more
Heal to Launch First One-Touch House Call Doc...
Santa Monica, California based Heal, a pioneer in on-demand personal health care services — will offer the first one-touch, on-demand house call doctor app for the Apple Watch. Heal’s Watch app,... Read more

Jobs Board

*Apple* iOS Specialist - TCML (United States...
AppleiOS Specialist Senior Apple /iOS Administrator/Engineer responsible for configuration and distribution of desktop, laptop and mobile devices to State Employees Read more
*Apple* Client Systems Solution Specialist -...
…drive revenue and profit in assigned sales segment and/or region specific to the Apple brand and product sets. This person will work directly with CDW Account Managers 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* Support Technician IV - Jack Henry a...
Job Description Jack Henry & Associates is seeking an Apple Support Technician. This position while acting independently, ensures the proper day-to-day control of Read more
*Apple* Client Systems Solution Specialist -...
…drive revenue and profit in assigned sales segment and/or region specific to the Apple brand and product sets. This person will work directly with CDW Account Managers Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.