TweetFollow Us on Twitter

FutureBASIC
Volume Number:9
Issue Number:5
Column Tag:Tools of the Trade

Z z z FutureBASIC

An industrial strength BASIC built for Macintosh

By Dave Kelly, MacTech Magazine Regular Contributing Author

Look! Up in the sky! It’s a bird, it’s a plane, no it’s FutureBASIC. Never before seen on this planet, FutureBASIC goes where no other BASIC has gone before. FutureBASIC (version 1.01) is not simply an upgrade of ZBasic. Although ZBasic programs can still be run with FutureBASIC, there are plenty of enhancements to interest any programmer, with any level of experience. I’ll refer to FutureBASIC as FB for the remainder of this article.

If you’re new to programming the Macintosh, FB now provides the easiest and quickest way to produce real Macintosh applications. Zedcor has put a lot of work into producing a set of manuals that not only provides documentation for the FB language, but also teaches structured programming methods. When getting started with FB you’ll want to start with the “Getting Started” manual. In this manual, you take a walk through three sample programs. You won’t even have to open any of the other manuals to start seeing results.

The “Getting Started” section emphasizes the importance of organizing and structuring your programs. Structure is something that doesn’t come natural to BASIC, but the FB manuals show you a consistent way to structure your programs. Programs are divided into sections split by remarks (see the example at the end of this article). A typical structured program will have a Constants section, Global variables section, Functions section and Main section. Zedcor, who has always promoted these programming practices, has done a great job in maintaining these structured practices.

After you go though the “Getting Started” manual, you’ll want to look at the FB “Handbook”. The Handbook will help you learn how to program the Macintosh. This manual isn’t just for beginners; there is information here that applies to all programmers. In particular, there are sections on writing INITs, cdevs, and Desk Accessories (yes, you can now create INIT, CDEV, DRVR and CODE resources), HyperCard XCMDs and XFCNs, how memory is organized, and Debugging (using FB’s Debugger and MacsBug). Beginners probably won’t start out writing INITs, but the manual includes everything you need to do it. The strength of the handbook is that it ties together the information that is in Inside Macintosh with the FB Reference manual. The Handbook is organized by subject (Windows, Menus, File Handling, Resources, QuickDraw, Etc.).

The “Reference” manual covers each FB command similar to the old ZBasic manual, but completely rewritten. It’s not like the Microsoft manuals that spend the first half of the manual explaining the programming environments (how the editor works, how to compile a program). Only the first 28 pages are dedicated to explaining the FB application, the remaining 375+ pages (plus appendixes) are strictly for reference. Each command is presented with a short example.

If you’re a Pascal, C, or Assembly language programmer (or any other language for that matter), FB will interest you too. First and foremost, FB is fast! It’s nearly as fast as Pascal and C. In benchmark tests that I performed, I was pleased with its performance in every test case I tried. The tests that I ran were derived from tests that I’ve run in the past. I’m not including those results here since there isn’t any close competition with FB anyway.

Experienced programmers will like the professional look and feel of the FB compiler. Some examples of this:

Resources are included in an FB program by including a one line statement such as:

RESOURCES “Resource File.rsrc”

The resource file can include any resources that you’re used to using in C or Pascal.

CALLs to assembled CODE resources - you can include any assembled code in your program.

In-line assembly language code: FB allows you to enter assembly language mnemonics directly into your program (THINK Pascal won’t let you do that!). Standard M68000 family statements and functions are fully supported.

APPL, INIT, cdev, DRVR, WDEF, CDEF, MDEF, CODE resource types can be created. This is what really makes FB a big league player. There are two different runtime packages that can get included at compile time when creating applications. You can choose the Standard-runtime package that takes up over 40K of space or the Mini-runtime version that is less than 5K. The difference is that the Mini-runtime must use Macintosh Toolbox routines for handling events. The reference manual distinguishes between the commands that are supported by the Mini vs. the Standard runtimes by putting a lower case m next to the command name. The extra memory saved may be worth it in some situations, but the expanded command set makes life much easier. Most of you will still want to compile with the Standard-runtime package. The RESOURCES statement at the beginning of the program tells the compiler which type of resource to compile.

Project Manager tool: FB’s Project Manager automatically keeps track of source code files used in a project. A project consists of all the files in a particular folder. The Project Manager makes it easy to open source code files and mark the files that need to be compiled. You can compile and run all related files in a project. So, if you have separated your various routines into separate files, then you can run the main program by selecting it in the Project Manager window and any files that are included (using the INCLUDE statement).

Cross Reference tool: The Cross Reference tool displays an alphabetical list of functions, labels, variables, or constants that are used in the current Editor window. You can search for an item by clicking on it.

Editing is completely new for this version of FB. The ZBasic editor was never as stable as this one. Most notable is that keywords are recognized and indentation is applied to the source code automatically. You can adjust the spacing for indented lines using the preferences dialog. Full Search and Replace capability can search in both directions. When an error occurs in your program, the cursor points to the line where the error occurred.

The Help system provides a ready reference to all FB commands. An additional bonus is that sample source code is included with the information in the Help file that you can paste into your program. You can even add your own stuff to the Help file.

Page Layout can be customized to print source code with header, footer, date, Program Name, page numbers, boldface keywords, and automatic indentation.

LOCAL FN is a new statement that lets you pass a list of parameters to a subroutine that will only be used locally. That means that variables used in LOCAL FN routines are only defined within the subroutine. You can now use libraries of LOCAL FN routines and not have to worry if there is a conflict between your program’s variables and the subroutine’s variables. LOCAL FN is a very powerful statement that can also be used recursively. LOCAL FN virtually makes using GOSUB and LONG FN obsolete (GOTO was obsolete along time ago). FB still supports GOSUB, GOTO, and LONG FN, but you are strongly advised against their use because of the great benefits of LOCAL FN.

Constants are now presented in a consistent manner. In older versions of BASIC only numbers could be used for constants. In FB you can assign integer and long integer constants a name to make them easier to remember and more understandable. You can tell a constant because it always starts with an underline character. Besides the fact that you can define your own constants, FB comes with hundreds of predefined named constants. Many of them correspond to constants in Inside Macintosh.

Record types are defined using the DIM RECORD statement. Any record type in Inside Macintosh can be defined with this statement. Records can be passed between functions by passing the record’s address.

QuickTime™ movie calls are included for playing QuickTime movies.

Balloon and Apple Event calls are part of the extensive Macintosh Toolbox support. However, the manuals show you how to create your own calls just in case Apple adds a new one.

Word Solution Engine™ functions are build in to FB as USR functions. Word Solution Engine is NOT included with FB. You can use these routines to access Word Solution Engine (if you have it) to create a professional looking word processor.

Debugger: FB’s own debugger is great. If you like the debugger in THINK Pascal, you’ll like this one too. You can set break points and step through a program. You can follow variable changes as they happen.

There are simply thousands of features packed into FB. I’d love to be able to show you a sample of each, but Zedcor has done a great job of that on the example files included with FB. I will include one here that can give you a sense of what FB can do. In particular, the ability to create cdevs is one of FB’s new features. The following code is an example of a cdev (from Zedcor).

‘CDEV example     7/07/92
RESOURCES “FB CDEV.rsrc”,”cdevhack”,”cdev”,-4064,”FutureBasic™ CDEV”,_resPurgeable%
OUTPUT FILE “myCDEV”

‘--------------- Globals ------------------
BYEBYE = _false
END GLOBALS

‘--------------- Functions -----------------
LOCAL FN doKeys (theEvent&)
  ‘first, get the character
  message&   = [theEvent&+_evtMessage]  
  ‘then see if the command key was down
  modifiers% = {theEvent&+_evtMeta}     
  tempChar$  = CHR$(message& AND &FF)  ‘mask for character
  LONG IF modifiers% AND 256           ‘test for command key
    %theEvent&,_nullEvt
    SELECT tempChar$         ‘set appropriate message
      CASE “X”,”x”             ‘cut?
        message% = _cutDev     ‘pass menu event back to cdev
      CASE “C”,”c”             ‘copy?
        message% = _copyDev    ‘pass menu event back to cdev
      CASE “V”,”v”             ‘paste?
        message% = _pasteDev   ‘pass menu event back to cdev
      CASE “Z”,”z”             ‘undo?
        message% = _undoDev    ‘pass menu event back to cdev
      CASE “W”,”w”             ‘close window?
        BYEBYE = _true         ‘pass menu event back to cdev
    END SELECT                  
  END IF
END FN

‘is it time to go bye bye?
LOCAL FN checkBYEBYE(cdevStorage&)
  LONG IF BYEBYE                       
    LONG IF cdevStorage&             ‘valid handle?
      mErr= FN DISPOSHANDLE (cdevStorage&) ’dump it
      IF mErr THEN BEEP:BEEP:BEEP
    END IF
    END
  END IF   
END FN          

LOCAL
DIM rect;0, T,L,B,R
LOCAL FN showMsg (msg$)
  CALL SETRECT (rect,110,110,220,160)
  CALL ERASERECT(rect)              ‘erase last message
  PRINT%(L+(R-L)/2-24,T+(B-T)/2+4);
  PRINT msg$;                       
END FN                    

‘---------------- Main ------------------
ENTERPROC%(message%,item%,numItems%,CPanelID%,
  theEvent&,cdevStorage&,CPDialog&)
  ‘softmask =&0000 and hardmask = &FFFF
  LONG IF message% = _macDev  
    returnVal& = 1               ‘works on every machine
    lastPass& = cdevStorage&
  XELSE
    LONG IF cdevStorage& <> lastPass&   ‘
      SELECT cdevStorage&  ‘check for errors when the 
        CASE _cdevGenErr   ‘Control Panel sends them to you.
        CASE _cdevMemErr
          ‘do an error message
        CASE _cdevResErr
          ‘do an error message
        CASE _cdevUnset
          ‘ignore this
      END SELECT
    END IF
    LONG IF cdevStorage&       ‘inialize storage for cdev
      lastPass& = cdevStorage&
      SELECT message%
        CASE _initDev          ‘initialize cdev
          ’create private storage
          cdevStorage& = FN NEWHANDLE(2)
          ‘we work on every machine
          returnVal& = cdevStorage&  
        CASE _hitDev          ‘button or text field clicked
          ’subtract Control Pan items
          msg$= “_hitDev item=”+STR$(item%-numItems%) 
          FN showMsg (msg$)
        CASE _closeDev        ‘close down the cdev now
          BYEBYE = _true                  
          FN showMsg (“BYE!”)
          BEEP :DELAY 1000
        CASE _nulDev                 ‘do null events here
        CASE _updateDev              ‘update your stuff
          FN showMsg (“_updateDev”)
        CASE _activDev               ‘activate controls 
                                     ‘deactivated below
          FN showMsg (“_activDev”)
        CASE _deActivDev             ‘deactivate controls
          FN showMsg (“_deActivDev”)
        CASE _keyEvtDev              ‘respond to key down
          FN doKeys (theEvent&)
          FN showMsg (“_keyEvtDev”)
        CASE _undoDev,_cutDev,_copyDev,_pasteDev,_clearDev
          FN showMsg (“__someEditDev??”)
        CASE _cursorDev              ‘cursor over cdev area
      END SELECT
    END IF
  END IF
EXITPROC% = returnVal&
FN checkBYEBYE(cdevStorage&)
RETURN

For More information

Contact Zedcor, 4500 E. Speedway, Suite 22, Tucson, AZ 85712. Voice: 602/881-8101, Fax: 602/881-1841, Applelink: ZEDCOR.

 
AAPL
$98.91
Apple Inc.
+1.24
MSFT
$44.22
Microsoft Corpora
-0.29
GOOG
$591.51
Google Inc.
+2.49

MacTech Search:
Community Search:

Software Updates via MacUpdate

Bartender 1.2.20 - Organize your menu ba...
Bartender lets you organize your menu bar apps. Features: Lets you tidy your menu bar apps how you want. See your menu bar apps when you want. Hide the apps you need to run, but do not need to... Read more
TotalFinder 1.6.2 - Adds tabs, hotkeys,...
TotalFinder is a universally acclaimed navigational companion for your Mac. Enhance your Mac's Finder with features so smart and convenient, you won't believe you ever lived without them. Tab-based... Read more
Vienna 3.0.0 RC 2 :be5265e: - RSS and At...
Vienna is a freeware and Open-Source RSS/Atom newsreader with article storage and management via a SQLite database, written in Objective-C and Cocoa, for the OS X operating system. It provides... Read more
VLC Media Player 2.1.5 - Popular multime...
VLC Media Player is a highly portable multimedia player for various audio and video formats (MPEG-1, MPEG-2, MPEG-4, DivX, MP3, OGG, ...) as well as DVDs, VCDs, and various streaming protocols. It... Read more
Default Folder X 4.6.7 - Enhances Open a...
Default Folder X attaches a toolbar to the right side of the Open and Save dialogs in any OS X-native application. The toolbar gives you fast access to various folders and commands. You just click... Read more
TinkerTool 5.3 - 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
Audio Hijack Pro 2.11.0 - Record and enh...
Audio Hijack Pro drastically changes the way you use audio on your computer, giving you the freedom to listen to audio when you want and how you want. Record and enhance any audio with Audio Hijack... Read more
Intermission 1.1.1 - Pause and rewind li...
Intermission allows you to pause and rewind live audio from any application on your Mac. Intermission will buffer up to 3 hours of audio, allowing users to skip through any assortment of audio... Read more
Autopano Giga 3.6 - Stitch multiple imag...
Autopano Giga allows you to stitch 2, 20, or 2,000 images. Version 3.0 integrates impressive new features that will definitely make you adopt Autopano Pro or Autopano Giga: Choose between 9... Read more
Airfoil 4.8.7 - Send audio from any app...
Airfoil allows you to send any audio to AirPort Express units, Apple TVs, and even other Macs and PCs, all in sync! It's your audio - everywhere. With Airfoil you can take audio from any... Read more

Latest Forum Discussions

See All

The Phantom PI Mission Apparition Review
The Phantom PI Mission Apparition Review By Jordan Minor on July 28th, 2014 Our Rating: :: GHOSTS BUSTEDUniversal App - Designed for iPhone and iPad The Phantom PI is an exceedingly clever and well-crafted adventure game.   | Read more »
More Stubies Are Coming Your Way in a Ne...
More Stubies Are Coming Your Way in a New Update Posted by Jessica Fisher on July 28th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
The Great Prank War Review
The Great Prank War Review By Nadia Oxford on July 28th, 2014 Our Rating: :: PRANKING IS SERIOUS BUSINESSUniversal App - Designed for iPhone and iPad Though short, The Great Prank War offers an interesting and fun mix of action and... | Read more »
Marvel Contest of Champions Announced at...
Marvel Contest of Champions Announced at Comic-Con Posted by Jennifer Allen on July 28th, 2014 [ permalink ] Announced over the weekend at San Diego Comic-Con was the fairly exciting looking Marvel Contest of Champions. | Read more »
Teenage Mutant Ninja Turtles Review
Teenage Mutant Ninja Turtles Review By Jennifer Allen on July 28th, 2014 Our Rating: :: DULL SWIPINGUniversal App - Designed for iPhone and iPad The pizza power is weak when it comes to this Teenage Mutant Ninja Turtles game.   | Read more »
Exploration Focused Puzzle Game Beatbudd...
Exploration Focused Puzzle Game Beatbuddy Set to Make Transition from PC to iOS this September Posted by Jennifer Allen on July 28th, 2014 [ permalink ] | Read more »
PlanetHD
PlanetHD By Nadia Oxford on July 28th, 2014 Our Rating: :: SPACE MADNESSUniversal App - Designed for iPhone and iPad PlanetHD will keep players busy for a while, though its unpredictable physics are a handful to deal with.   | Read more »
This Week at 148Apps: July 21-25, 2014
Another Week of Expert App Reviews   At 148Apps, we help you sort through the great ocean of apps to find the ones we think you’ll like and the ones you’ll need. Our top picks become Editor’s Choice, our stamp of approval for apps with that little... | Read more »
Reddme for iPhone - The Reddit Client (...
Reddme for iPhone - The Reddit Client 1.0 Device: iOS iPhone Category: News Price: $.99, Version: 1.0 (iTunes) Description: Reddme for iPhone is an iOS 7-optimized Reddit client that offers a refreshing new way to experience Reddit... | Read more »
Jacob Jones and the Bigfoot Mystery : Ep...
Jacob Jones and the Bigfoot Mystery : Episode 2 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Jacob Jones is back in Episode 2 of one of Apples 'Best of 2013' games and an App Store... | Read more »

Price Scanner via MacPrices.net

13-inch 2.5GHz MacBook Pro on sale for $1099,...
Best Buy has the 13″ 2.5GHz MacBook Pro available for $1099.99 on their online store. Choose free shipping or free instant local store pickup (if available). Their price is $100 off MSRP. Price is... Read more
Roundup of Apple refurbished MacBook Pros, th...
The Apple Store has Apple Certified Refurbished 13″ and 15″ MacBook Pros available for up to $400 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free. Their prices... Read more
Record Mac Shipments In Q2/14 Confound Analys...
A Seeking Alpha Trefis commentary notes that Apple’s fiscal Q3 2014 results released July 22, beat market predictions on earnings, although revenues were slightly lower than anticipated. Apple’s Mac’... Read more
Intel To Launch Core M Silicon For Use In Not...
Digitimes’ Monica Chen and Joseph Tsai, report that Intel will launch 14nm-based Core M series processors specifically for use in fanless notebook/tablet 2-in-1 models in Q4 2014, with many models to... Read more
Apple’s 2014 Back to School promotion: $100 g...
 Apple’s 2014 Back to School promotion includes a free $100 App Store Gift Card with the purchase of any new Mac (Mac mini excluded), or a $50 Gift Card with the purchase of an iPad or iPhone,... Read more
iMacs on sale for $150 off MSRP, $250 off for...
Best Buy has iMacs on sale for up to $160 off MSRP for a limited time. Choose free home shipping or free instant local store pickup (if available). Prices are valid for online orders only, in-store... Read more
Mac minis on sale for $100 off MSRP, starting...
Best Buy has Mac minis on sale for $100 off MSRP. Choose free shipping or free instant local store pickup. Prices are for online orders only, in-store prices may vary: 2.5GHz Mac mini: $499.99 2.3GHz... Read more
Global Tablet Market Grows 11% in Q2/14 Notwi...
Worldwide tablet sales grew 11.0 percent year over year in the second quarter of 2014, with shipments reaching 49.3 million units according to preliminary data from the International Data Corporation... Read more
New iPhone 6 Models to Have Staggered Release...
Digitimes’ Cage Chao and Steve Shen report that according to unnamed sources in Apple’s upstream iPhone supply chain, the new 5.5-inch iPhone will be released several months later than the new 4.7-... Read more
New iOS App Helps People Feel Good About thei...
Mobile shoppers looking for big savings at their favorite stores can turn to the Goodshop app, a new iOS app with the latest coupons and deals at more than 5,000 online stores. In addition to being a... Read more

Jobs Board

*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
Sr. Product Leader, *Apple* Store Apps - Ap...
**Job Summary** Imagine what you could do here. At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
WW Sales Program Manager, *Apple* Online St...
**Job Summary** Imagine what you could do here. At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.