TweetFollow Us on Twitter

4D Graphics
Volume Number:7
Issue Number:2
Column Tag:Database Corner

Related Info: Quickdraw

4th Dimension Graphics

By Haven C. Sweet, Orlando, FL

Note: Source code files accompanying article are located on MacTech CD-ROM or source code disks.

Graphics Output in Fourth Dimension.

Haven Sweet is a Professor of Biology at the University of Central Florida. He has been interested in using the Macintosh for a variety of educational purposes, and has tried to incorporate the computer into an academic laboratory setting. He has developed several classroom exercises using 4th Dimension.

Introduction

Although Fourth Dimension (4D) is not a programming language, I prefer to use it for most of my projects since it vastly simplifies programming and managing complex data. However, I recently discovered a very unfortunate limitation of Fourth Dimension; it is unable to draw on the screen using tool box calls.

The Problem

After creating a large data base of organisms with 4D, I added calculations for a cluster analysis to elucidate their possible relationships. When I wanted to present the final results in a dendrogram (Figure 1), I discovered there was no simple mechanism for drawing on the screen or printing text at variable locations.

Figure 1. A sample clustering output, showing the similarity of four different records in the data base. The figure was drawn on an output layout which only contained the buttons.

I would have to write the entire graphics routine in Pascal, compile it as an external procedure, and create external areas within my program. Not being proficient with MPW, I was hesitant to attempt writing anything which would require debugging by switching from MPW to Ext. Mover to 4D to MPW etc. Hoping version 2 would provide direct toolbox routines such as MoveTo(xStart,yStart), LineTo(xEnd,yEnd) and Writeln(Message), I found that Acius had no such plans.

The Solution

Facing the tedium of learning MPW and Pascal, I hit upon a much simpler solution; I created four external units which provide equivalent procedures for moving the pen, drawing a line, writing text at any location on the screen, and defining both pen and text characteristics. Then, using a blank layout screen, I wrote the graphics routines in the layout procedure and invoked these procedures. Although the graphics output is quite slow, it is more than adequate for the occasional presentation of simple data.

The “pseudo toolbox” routines can be as short or long as needed, but each must be compiled separately and given a name different from the toolbox routine. While I toyed with putting a “4D” before the name of every toolbox call, I decided to combine several I need into a single procedure. So, when text must appear at variable locations on the screen, instead of using MoveTo(xStart;yStart); Writeln(message), the new procedure is WriteAt(xStart;yStart;Message). Likewise, when a line must be drawn, instead of using MoveTo and LineTo, they were combined into DrawLine(xStart;yStart;xEnd;yEnd) which defines the start and end of the line. To alter the text or pen’s characteristics, I adopted the syntax used in ZBasic to produce Pen(xSize;ySize;visible;PenMode) and Text(font;point size;mode). Because variables are used, the procedures can use data either stored in the database or generated from it to draw appropriate lines.

These procedures were written in Pascal and compiled as units which can be moved using 4D External Mover into either the resource of a 4D program or the Proc.Ext. The units are quite small, taking under 600 bytes for all four routines. Once installed, the procedures can be called from within the program in the same manner as any global procedure.

The Output Screen

The next problem was to provide a blank screen on which the results could be written, as well as to find the best way to call the function. My solution was to create a dummy data file with all the drawing done in the output layout procedure. However, there must be exactly one record in the file; if the file is empty, the layout screen never appears, while if there are more than one record in the selection, the drawing procedure is executed for each record. Although it is possible to create a set with only one record in it, it is simpler to create a file named “Blank” which contains only one field, “Dummy”. Then, with the User mode, add one record to the file. An empty layout screen must be created for each different graphics screen.

The layout forms in the file “Blank” should have the three markers Header, Detail, and Break positioned at the very top of the page. If no buttons are to appear in the form, the Footer should also should be placed at the top; otherwise, it should be just far enough down to accomidate the buttons (Figure 2).

Figure 2. The appearance of the layout screen on which the drawing or text placement will be done. Note that the markers for Header, Detail and Break are all at the top of the page.

Although other line positions may work (including using the default positioning of the lines), having them at the top is more reliable since unusual things may occur with some positions. For example, if Break or Header are below the window’s margin, nothing will be drawn; if the Detail line is below the window, then the image is drawn and immediately erased; if space remains between the Header and Detail, clicking on the area permits the user to double click the region and jump to the data input mode. Thus, since the user may resize the window, it is safest to prevent anomalies by placing the lines at the top.

The Procedures’ Syntax

The drawing procedures should only be executed in the BEFORE phase, and should use the following formats:

Pen([xSize] [; [YSize]; [Visible]; [Pen Mode]] )

XSize is the horizontal width of the line in pixels.

YSize is the vertical width of the line in pixels. If omitted or set to zero, the xSize value is used for ySize.

Visible is set to one if the line is to be seen or zero if it is invisible.

Pen Mode uses the following;

0 or 8 Pattern COPY

1 or 9 Pattern OR

2 or 10 Pattern XOR

3 or 11 Pattern BIC

4 or 12 Not pattern COPY

5 or 13 Not pattern OR

6 or 14 Not pattern XOR

7 or 15 Not Pattern BIC

All values are optional. A call to Pen with no parameters resets the normal pen (1 by 1 pixel, visible in the copy mode). Partial parameters may also be used. For example, Pen(3;3;1;8) would produce the same effect as Pen(3) or Pen(3;3)-- that is, a visible pen, 3 by 3 pixels in the copy mode. Although ZBasic also includes the possibility of altering the pen pattern, I did not include it in these routines.

Text( [Font] [; [Point size] ; [Face] ; [Mode]] )

Font codes include;

0 System font

1 Application font

2 New York 20 Times

3 Geneva 21 Helvetica

4 Monaco 22 Courier

5 Venice 23 Symbol

11 Cairo 24 Taliesin

Point size can range from 1 through 127

Face codes are; Mode uses the following;

0 Plain 0 or 8 Pattern COPY

1 Bold 1 or 9 Pattern OR

2 Italic 3 or 11 Pattern BIC

4 Underlined 2 or 10 Pattern XOR

8 Outlined 4 or 12 Not pattern COPY

16 Shadow 5 or 13 Not pattern OR

32 Condensed 6 or 14 Not pattern XOR

64 Extended 7 or 15 Not Pattern BIC

Combinations would be the sum of each face; i.e., bold italic text would have a code of 3.

All values are optional; if omitted, the result is 12 point, plain system font in the copy mode. Both Text(22;10;3;0) and Text(22;10;3) define text as 10 point Courier, italic and bold, which is in the COPY mode.

DrawLine( xStart; yStart; xEnd; yEnd)

This procedure draws a line, with the characteristics defined in the Pen procedure, which begins at a point xStart, yStart, and extends to the point xEnd, yEnd. For example DrawLine(1;1;200;1) would draw a line across the top of the screen.

WriteAt( xStart; yStart; Message)

This procedure writes any text stored in Message beginning at a point xStart, yStart. For example, WriteAt(10;YPos;”The results follow”) would print the text 10 pixels from the left edge and YPos pixels from the top.

Example

The following procedures are designed to draw a line on the screen and to place text near its origin. In this example, the coordinates of the line are entered by the user in a dialog box, but they could have been derived from data in the file.

‘ global procedure Draw a line
DEFAULT FILE([Blank])
ALL RECORDS([Blank]) ‘ this file has one record
 ‘ ask for characteristics of line and text
DIALOG(“Dialog box”)
If (OK=1)|(b1=1)
     INPUT LAYOUT(“Blank-line”)
     OUTPUT LAYOUT(“Blank-line”)
     DISPLAY SELECTION(*)
End if 
‘Layout procedure Blank-line
If (Before)
  visible:=1
  PenMode:=8   ‘Pattern copy  
 ‘ pen size entered by user
  Pen (xSize;Ysize;visible;PenMode)
 ‘ start and end positions entered by user
  DrawLine (h1;v1;h2;v2)
 ‘ Face entered by user
  Text (0;12;Face;0) ‘ font,point size,style,mode
  WriteAt ((h1+20);(v1+20);”This is where the line begins.”)
End if 

The Units

The Pascal versions of the four procedures are followed by one annoted example of the MPW commands needed to compile each into a unit. This method of directly creating units was devised by Jud Spencer of After Hours Software, and was distributed by Acius as Technical Note #150, March, 1989.

Unit Pen;
INTERFACE
 USES 
 Memtypes,Quickdraw,OSIntf,Toolintf,packintf;
 Procedure  PenSet(var Xsize,Ysize,visible, Mode: Integer);
IMPLEMENTATION
Procedure PenSet(var Xsize,Ysize,visible, Mode: Integer);
 begin
 PenNormal;
 if (Xsize>0) then
 {its OK}
 else
 Xsize:=1;
 if (Ysize>0) then
 {its OK}
 else
 Ysize:=Xsize;
 PenSize(Xsize,Ysize);
 if (visible=0) then
 HidePen
 else
 ShowPen;
 if (Mode>=0) and (Mode<8) then
 Mode:=Mode+8; {correct if wrong mode range used}
 if (Mode>7) and (Mode<16) then
 PenMode(Mode);
 end;
END.
____________________________________________
Unit DrawLine;
INTERFACE
 USES 
 Memtypes,Quickdraw,OSIntf,Toolintf,packintf;
 
 Procedure DrawALine(var h1,v1,h2,v2: Integer);
 
IMPLEMENTATION
 Procedure DrawALine(var h1,v1,h2,v2: Integer);
 begin
 MoveTo(h1,v1);
 LineTo(h2,v2);
 end;
END.
____________________________________________
Unit Text;
INTERFACE
 USES 
  Memtypes,Quickdraw,OSIntf,Toolintf,packintf;
 Procedure TextSet(var font,point,StyleNum,mode: Integer);
IMPLEMENTATION
 Procedure TextSet(var font,point,StyleNum,mode: Integer);
 begin
 if (font>0) then
 TextFont(font)
 else
 TextFont(0);
 if (point>0) and (point<128) then
 TextSize(point)
 else
 TextSize(12);
 if (mode>7) and (mode<16) then
 mode:=mode-8; {correct if wrong mode range used}
 if (mode>=0) and (mode<8) then
 TextMode(mode) 
 else
 TextMode(0);
 if (StyleNum>0) and (StyleNum<128) then
 TextFace(Style(StyleNum))
 else
 TextFace([]);
 end; {procedure}
END.
____________________________________________
Unit WriteAt;
INTERFACE
 USES 
 Memtypes,Quickdraw,OSIntf,Toolintf,packintf;
 Procedure WriteItAt(var h1,v1:Integer;var s: Str255);   IMPLEMENTATION
 Procedure WriteItAt(var h1,v1:Integer;var s: Str255);
 begin
 MoveTo(h1,v1);
 DrawString(s);
 end;
END.

Workshop Commands

MPW worksheet commands for the WriteAt procedure are described below. Set the correct directory, then replace or correct all the items noted below as each different unit is compiled and linked.

Pascal WriteAt.p
#      Fix ^     Use unit’s name
Link -w -p WriteAt.p.o 
#             Fix ^    Use unit’s name
“{Libraries}”Runtime.o 
“{Libraries}”Interface.o 
“{PLibraries}”PasLib.o 
-m WRITEITAT 
#    Fix ^    use ALL CAPS with the procedure’s name (not the Unit’s)
-rt 4DEX=16114 
#Fix ^ be sure 4D is name of 4th Dimension, or change it here
-sg Main2 
-sn “Main2=WriteAt(&I;&I;&S)” 
#      Fix ^         Fix ^  with proper variable list, where I=integer, 
S=String
-o Proc.Ext(WriteAt)
#          Fix ^      with proper unit name

Conclusions

Although some labor is required to initially write and compile the graphics external procedures, it only needs to be done once. After being installed in the Proc.Ext, a 4th Dimension database can access the procedures with minimal effort. Unfortunately, describing the process makes it sound much more difficult than it actually is.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Dash 4.0.0 - Instant search and offline...
Dash is an API documentation browser and code snippet manager. Dash helps you store snippets of code, as well as instantly search and browse documentation for almost any API you might use (for a full... Read more
Bookends 12.7.9 - Reference management a...
Bookends is a full-featured bibliography/reference and information-management system for students and professionals. Bookends uses the cloud to sync reference libraries on all the Macs you use.... Read more
TrailRunner 3.8.834 - Route planning for...
TrailRunner is the perfect companion for runners, bikers, hikers, and all people wandering under the sky. Plan routes on a geographical map. Import GPS or workout recordings and journalize your... Read more
iFFmpeg 6.2.5 - Convert multimedia files...
iFFmpeg is a comprehensive media tool to convert movie, audio and media files between formats. The FFmpeg command line instructions can be very hard to master/understand, so iFFmpeg does all the hard... Read more
DaisyDisk 4.4 - $9.99
DaisyDisk allows you to visualize your disk usage and free up disk space by quickly finding and deleting big unused files. The program scans your disk and displays its content as a sector diagram... Read more
iFFmpeg 6.2.5 - Convert multimedia files...
iFFmpeg is a comprehensive media tool to convert movie, audio and media files between formats. The FFmpeg command line instructions can be very hard to master/understand, so iFFmpeg does all the hard... Read more
DaisyDisk 4.4 - $9.99
DaisyDisk allows you to visualize your disk usage and free up disk space by quickly finding and deleting big unused files. The program scans your disk and displays its content as a sector diagram... Read more
BetterTouchTool 2.07 - Customize Multi-T...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom... Read more
BetterTouchTool 2.071 - Customize Multi-...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom... Read more
BetterTouchTool 2.07 - Customize Multi-T...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom... Read more

RPG Djinn Caster (Games)
RPG Djinn Caster 1.0.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0.0 (iTunes) Description: SPECIAL PRICE 38% OFF(USD 7.99 -> USD 4.99)!!!A Fantasy Action RPG of far foreign lands! Summon the Djinns and rise to... | Read more »
Alto's Odyssey gets its first trail...
There's finally video evidence of Alto's Odyssey, the follow up to the 2015 App Store hit, Alto's Adventure. It looks just as soothing and atmospheric as Alto's last outing, but this time players will be journeying to the desert. Whereas Alto's... | Read more »
Last week on Pocket Gamer
What’s going on in the wider world of portable gaming? Each week we ask that question of our sister website Pocket Gamer. The PG team covers iOS gaming, just like 148Apps, but it also strays into the world of Android games and handheld consoles... | Read more »
Pokémon GO Generation 2 evolution guide
At long last, Niantic Labs finally unleashed the Generation 2 Pokémon into the wild. Pokémon GO trainers are scrambling to grab up this new set of 80 Pokémon. There are some special new tricks required to catch all of these new beasties, though.... | Read more »
The best new games we played this week
It feels as though the New Year got off to a creaking start as far as mobile games go, but that's changed over the past few weeks. The last few days alone have seen the debut of a number of wonderful games, so we thought we'd take the time to... | Read more »
Recruit more scallywags and discover new...
Get ready to show off your sea legs all over again in Oceans & Empires’ new grand update, which aims to make the act of rising to the role of seven seas ruler even more fresh and appealing, thanks to a richness of new content on both iOS and... | Read more »
Mage the Ascension: Refuge (Games)
Mage the Ascension: Refuge 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: The groundbreaking roleplaying game Mage: The Ascension manifests in our turbulent present with Refuge, an... | Read more »
Vampire: Prelude (Games)
Vampire: Prelude 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: The classic roleplaying game Vampire: The Masquerade returns to digital games with a Prelude of things to come. Experience a... | Read more »
Digby Forever Guide: How to dig to the d...
Digby Forever is a sparkling homage to arcade classics, and while you may be tiring of the number of arcade games being thrown at you, this endless digger finds many ways to stand out from the rest of the pack. The game manages to be challenging... | Read more »
The best sales on the App Store this wee...
It's been quite the week in mobile games, but if the latest releases(there were some pretty darn good ones, in case you missed out) aren't really doing the trick, perhaps some of these discounted games will. Many of these premium games had their... | Read more »

Price Scanner via MacPrices.net

13-inch 2.0GHz Space Gray MacBook Pro on sale...
Adorama has the non-Touch Bar 13″ 2.0GHz Space Gray MacBook Pro in stock today for $100 off MSRP. Shipping is free, and Adorama charges NY & NJ sales tax only: - 13″ 2.0GHz MacBook Pro Space Gray... Read more
13-inch Touch Bar MacBook Pros on sale for $1...
B&H Photo has select 2016 Apple 13″ Touch Bar MacBook Pros in stock today and up to $100 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 2.9GHz/512GB Touch Bar MacBook... Read more
KSI-1802R SX Disinfect-able Keyboard With Wav...
KSI has unveiled a new, innovative medical keyboard, the KSI-1802R SX, at HIMSS 2017, running February 19-22 in Orlando, Florida. KSI-1802R SX is the only keyboard that combines dual factor... Read more
15-inch Touch Bar MacBook Pros on sale for up...
Amazon has 15″ Touch Bar MacBook Pros in stock today and on sale for up to $150 off MSRP including free shipping: - 15″ 2.7GHz Touch Bar MacBook Pro Space Gray: $2720.38 $79 off MSRP - 15″ 2.7GHz... Read more
Apple’s Education discount saves up to $300 o...
Purchase a new Mac or iPad using Apple’s Education Store and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free: -... Read more
13-inch 1.6GHz/256GB MacBook Air on sale for...
Newegg has the 13″ 1.6GHz/256GB MacBook Air (MMGG2LL/A) on sale for $1029.99 including free shipping. Their price is $170 off MSRP, and it’s the lowest price available for this model. Choose Newegg... Read more
Save up to $600 with Apple refurbished Mac Pr...
Apple has Certified Refurbished Mac Pros available for up to $600 off the cost of new models. An Apple one-year warranty is included with each Mac Pro, and shipping is free. The following... Read more
12-inch 1.1GHz Retina MacBooks on sale for $1...
B&H has 12″ 1.1GHz Retina MacBooks on sale for $150 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 12″ 1.1GHz Space Gray Retina MacBook: $1149 $150 off MSRP - 12″ 1.1GHz... Read more
InTouch Health Expands iOS And Windows Produc...
Specialty telehealth enterprise provider InTouch Health has announced an expanded range of FDA Class I listed medical devices and software solutions for ambulatory, non-acute and non-emergent... Read more
iMobie Airs World’s 1st iCloud Manager with M...
iMobie Inc., an Apple-related software company, announced their newly-updated iPhone manager AnyTrans with exclusive feature to sync and manage contents across multiple iCloud accounts. With it,... Read more

Jobs Board

*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Manager *Apple* Systems Administration - Pu...
Req ID 3315BR Position Title Manager, Apple Systems Administration Job Description The Manager of Apple Systems Administration oversees the administration and Read more
*Apple* Technician - nfrastructure (United S...
Let’s Work Together Apple Technician This position is based in Portland, ME Life at nfrastructure At nfrastructure, we understand that our success results from our Read more
*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Manager *Apple* Systems Administration - Pu...
Req ID 3315BR Position Title Manager, Apple Systems Administration Job Description The Manager of Apple Systems Administration oversees the administration and Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.