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
#             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:

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
Labels & Addresses 1.7 - Powerful la...
Labels & Addresses is a home and office tool for printing all sorts of labels, envelopes, inventory labels, and price tags. Merge-printing capability makes the program a great tool for holiday... Read more

## Latest Forum Discussions

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 »
Lost Within - Tips, Tricks, and Strategi...
Have you just downloaded Lost Within and are you in need of a guiding hand? While it’s not the toughest of games out there you might still want some helpful tips to get you started. [Read more] | Read more »

## Price Scanner via MacPrices.net

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
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
Mac Notebooks: Avoiding MagSafe Power Adapter...
Apple Support says proper usage, care, and maintenance of Your Mac notebook’s MagSafe power adapter can substantially increase the the adapter’s service life. Of course, MagSafe itself is an Apple... Read more
12″ Retina MacBook In Shootout With Air And P...
BareFeats’ rob-ART morgan has posted another comparison of the 12″ MacBook with other Mac laptops, noting that the general goodness of all Mac laptops can make which one to purchase a tough decision... Read more
FileMaker Go for iPad and iPhone: Over 1.5 Mi...
FileMaker has announced that its FileMaker Go for iPad and iPhone app has surpassed 1.5 million downloads from the iTunes App Store. The milestone confirms the continued popularity of the FileMaker... Read more
Sale! 13-inch 2.7GHz Retina MacBook Pro for \$...
Best Buy has the new 2015 13″ 2.7GHz/128GB Retina MacBook Pro on sale for \$1099 – \$200 off MSRP. Choose free shipping or free local store pickup (if available). Price for online orders only, in-... Read more
Minimalist MacBook Confirms Death of Steve Jo...
ReadWrite’s Adriana Lee has posted a eulogy for the “Digital Hub” concept Steve Jobs first proposed back in 2001, declaring the new 12-inch MacBook with its single, over-subscribed USB-C port to be... Read more

## Jobs Board

*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
*Apple* Software Support - Casper (Can work...
…experience . Full knowledge of Mac OS X and prior . Mac OSX / Server . Apple Remote Desktop . Process Documentation . Ability to prioritize multiple tasks in a fast pace Read more