TweetFollow Us on Twitter

Blanking
Volume Number:2
Issue Number:2
Column Tag:Basic School

Asm Utility Speeds Screen Blanking

By Dave Kelly, Engineer, General Dynamics, MacTutor Editorial Board

For those that remember Professor Mac's Screen Pokes presented in the April 1985 issue of MacTutor, we discussed the Macintosh screen and how to poke the screen to all blank. The method presented there was very slow. Until such time as someone comes out with a MS BASIC compiler most routines will be slow. MacTutor now has a call out to anyone that has a complier for MS BASIC to step forward and become famous. Please contact us if you have any information to give us about compiled BASIC.

This month we will provide the alternative screen poke method using a library written in 68000 code. These routines were designed to work with the 512K or 128K versions of the Macintosh, however, the code may be modified to be used with other memory sizes.

If you are unfamiliar with BASIC libraries then we recommend that you refer to the BASIC School article in the November 1985 MacTutor on Building a Machine Language Library routine. (Back issues are available). The listings that follow are assembled in the same manner as discussed in that column.

There are three code routines that you need to be concerned with. The LIBinit.asm (Listing 1) routine may be found on page 44 of the Nov. 85 MacTutor. The second routine stores $FFFFFFFF in all screen locations, thus blacking out the entire screen. The third routine inverts all of the screen locations. We thank Serge Rostan of Pontoise, France for contributing the main code for the invert routine.[If you have some good ideas on Basic, please write Dave care of MacTutor and see them in print. -Ed]

The BlankScreen routine (Listing 2) is accessed by the statement: CALL BlankScreen (memory%) where memory% is the memory of your particular system (i. e. use memory%=512 or memory%=128). This routine works fine for 512K or 128K Macs, but you will have to change the equates for Screen512 and/or Screen128 (see listing 2) in order to accomodate other memory sizes. The equates 'GetNextLibArg', 'IntegerArg' and 'BasicError' are BASIC routines defined in BMLL (Microsoft's Building Machine Language Libraries) which library routines may call. The BlankScreen routine reads the memory% parameter and determines the screen location. Then each location is loaded with $FFFFFFFF and the screen is blank. The routine then returns back to the calling program.

The InvertScreen routine (Listing 3) works much the same as the BlankScreen routine. You may call the routine with the statement: CALL InvertScreen (memory%). The passed integer variable memory% is the same as in the BlankScreen routine. The only difference in this routine is that each memory location is exclusive-ored with the value $FFFFFFFF.

Listing 4 and 5 are the Linker and Resource complier files needed by the MDS system to create the library resource file. See Nov 1985 MacTutor for details on how to us these files.

The Screen Demo program in listing 6 demonstrates the use of the BlankScreen and InvertScreen routines. It is advisable but not mandatory that you hide the cursor using HIDECURSOR before blanking or inverting the screen. The cursor may be turned on again with the SHOWCURSOR statement. If the cursor is not disabled then the 16 X 16 cursor location will not be blanked or inverted properly. These libraries may be used to create special effects in your program such as flashing the screen.

Expanding BASIC using library routines greatly improves the capabilities of your programs. If you have a favorite library routine, please send it to us. We would like to share more libraries with other useful purposes.


LISTING 1
;LIBinit routine (See MacTutor Nov. 1985 pg. 44 for comments)
;save as LIBinit.asm

LIBVER_Result  EQU 6
LIBinit:
 CLR.W  LIBVER_Result(a0)
LIBinitExit:
 MOVEQ  #0,d0
 RTS


LISTING 2
; BASIC BlankScreen Library Source Code
; By Dave Kelly
; MacTutor 1985

;Synopsis:
;CALL BlankScreen (memory%)
;Output:

GetNextLibArg  EQU $2A
IntegerArgEQU  $32
BasicErrorEQU  $42
Screen512 EQU  ((512-128)*1024)+108288
Screen128 EQU  108288

 
 JSR  GetNextLibArg(a5) ;Get the next argument
 JSR  IntegerArg(a5) ;[d3:w] = integer error if arg
 ;can't be forced into an 
 ;integer.
 CMP.W  #128,d3
 BEQ  Do128 ;branch if 128K memory
 CMP.W  #512,d3
 BEQ  Do512 ;branch if 512K memory
Device_Unavailable:
 MOVEQ  #68,d2   ;Device Unavailable error
 JSR  BasicError(a5)
Do512:
 LEA  Screen512,A0
 BRA  Blank
Do128:
 LEA  Screen128,A0
Blank:
 MOVE.W #5472-1,d1 ;setup high screen address
 MOVE.L #$FFFFFFFF,d0;move to d0
Loop:
 MOVE.L d0,(A0)+ ;set screen address to d0
 DBRA d1,Loop
 RTS
GetIntegerVar:
 JSR  GetNextLibArg(a5) ;Get the next argument
 JSR  IntegerArg(a5) ;[d3:w] = integer error if arg
 ;can't be forced into an 
 ;integer
 RTS    
LISTING 3
; BASIC InvertScreen Library Source Code
; By Dave Kelly
; MacTutor 1985
;save InvertScreen.asm

;Synopsis:
;CALL InvertScreen ( memory%)
;Output:

GetNextLibArg  EQU $2A
IntegerArgEQU  $32
BasicErrorEQU  $42
Screen512 EQU  ((512-128)*1024)+108288
Screen128 EQU  108288

 
 BSR  GetIntegerVar;integer arg in [d3:w]
 CMP.W  #128,d3
 BEQ  Do128 ;branch if 128K memory
 CMP.W  #512,d3
 BEQ  Do512 ;branch if 512K memory
Device_Unavailable:
 MOVEQ  #68,d2   ;Device Unavailable error
 JSR  BasicError(a5)
Do512:
 LEA  Screen512,A0
 BRA  Invert
Do128:
 LEA  Screen128,A0
Invert:
 MOVE.W #5472-1,D1
 MOVE.L #$FFFFFFFF,D0
Loop:
 EOR.L  D0,(A0)+
 DBRA D1,Loop
 RTS
GetIntegerVar:
 JSR  GetNextLibArg(a5) ;Get the next argument
 JSR  IntegerArg(a5) ;[d3:w] = integer (error if arg
 ;can't be forced into an 
 ;integer
 RTS    
LISTING 4
;Screen Library Link
;MacTutor 1986

/OUTPUT ScreenLib
LIBinit.Rel
<
InvertScreen.Rel
<
BlankScreen.Rel
$

LISTING 5
ScreenLib.Rsrc
BLIB
TYPE CODE = GNRL
LIBinit,1
.R
ScreenLib CODE 1

TYPE CODE = GNRL
InvertScreen,2
.R
ScreenLib CODE 2

TYPE CODE = GNRL
BlankScreen,3
.R
ScreenLib CODE 3
LISTING 6
'Screen Demo
'By Dave Kelly
'©MacTutor 1986

LIBRARY "Screen Demo"
mem%=128:IF FRE(0)>75000! THEN mem%=512
GOSUB Setmenubar
MENU ON
ON MENU GOSUB menucheck
loop: GOTO loop
menucheck:
    menunumber=MENU(0):IF menunumber<>6 THEN RETURN
    menuitem=MENU(1):MENU
    ON menuitem GOSUB Blank,invert,Flash,Demo,Quit
    Setmenubar:
        MENU RESET  ' Re-do menu bar
        MENU 6,0,1,"Program Menu"
        MENU 6,1,1,"Blank Screen"
        MENU 6,2,1,"Invert Screen"
        MENU 6,3,1,"Flash Screen"
        MENU 6,4,1,"Demo"
        MENU 6,5,1,"Quit"
RETURN
Blank:
HIDECURSOR
CALL BlankScreen(mem%)
SHOWCURSOR
RETURN

invert:
HIDECURSOR
CALL invertScreen(mem%)
SHOWCURSOR
RETURN

Flash:
HIDECURSOR
FOR i=0 TO 100
CALL invertScreen(mem%)
NEXT
SHOWCURSOR
RETURN

Demo:
WINDOW CLOSE 1
GOSUB Blank
WINDOW 1,"",(42,90)-(475,300),3
PRINT "Click here"
WHILE MOUSE(0)<>1:WEND
GOSUB invert
WHILE MOUSE(0)<>1:WEND
GOSUB invert:CLS:GOSUB invert
WINDOW 2,"",(102,140)-(410,240),3
PRINT "Click here"
WHILE MOUSE(0)<>1:WEND
GOSUB invert
WHILE MOUSE(0)<>1:WEND
GOSUB invert:CLS:GOSUB invert
WINDOW 3,"",(152,165)-(360,215),3
PRINT "Click here"
WHILE MOUSE(0)<>1:WEND
GOSUB invert
WHILE MOUSE(0)<>1:WEND
GOSUB invert:CLS:GOSUB invert
GOSUB invert
PRINT SPC(4);"Please make selection":PRINT SPC(5);"from menus above!"
RETURN

Quit:
FOR i=1 TO 4
    WINDOW CLOSE i
NEXT i
MENU RESET:LIBRARY CLOSE
CLS:END
 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Dropbox 193.4.5594 - Cloud backup and sy...
Dropbox is a file hosting service that provides cloud storage, file synchronization, personal cloud, and client software. It is a modern workspace that allows you to get to all of your files, manage... Read more
Google Chrome 122.0.6261.57 - Modern and...
Google Chrome is a Web browser by Google, created to be a modern platform for Web pages and applications. It utilizes very fast loading of Web pages and has a V8 engine, which is a custom built... Read more
Skype 8.113.0.210 - Voice-over-internet...
Skype is a telecommunications app that provides HD video calls, instant messaging, calling to any phone number or landline, and Skype for Business for productive cooperation on the projects. This... Read more
Tor Browser 13.0.10 - Anonymize Web brow...
Using Tor Browser you can protect yourself against tracking, surveillance, and censorship. Tor was originally designed, implemented, and deployed as a third-generation onion-routing project of the U.... Read more
Deeper 3.0.4 - Enable hidden features in...
Deeper is a personalization utility for macOS which allows you to enable and disable the hidden functions of the Finder, Dock, QuickTime, Safari, iTunes, login window, Spotlight, and many of Apple's... Read more
OnyX 4.5.5 - Maintenance and optimizatio...
OnyX is a multifunction utility that you can use to verify the startup disk and the structure of its system files, to run miscellaneous maintenance and cleaning tasks, to configure parameters in the... Read more
Hopper Disassembler 5.14.1 - Binary disa...
Hopper Disassembler is a binary disassembler, decompiler, and debugger for 32- and 64-bit executables. It will let you disassemble any binary you want, and provide you all the information about its... Read more
WhatsApp 24.3.78 - Desktop client for Wh...
WhatsApp is the desktop client for WhatsApp Messenger, a cross-platform mobile messaging app which allows you to exchange messages without having to pay for SMS. WhatsApp Messenger is available for... Read more
War Thunder 2.33.0.135 - Multiplayer war...
In War Thunder, aircraft, attack helicopters, ground forces and naval ships collaborate in realistic competitive battles. You can choose from over 1,500 vehicles and an extensive variety of combat... Read more
Iridient Developer 4.2 - Powerful image-...
Iridient Developer (was RAW Developer) is a powerful image-conversion application designed specifically for OS X. Iridient Developer gives advanced photographers total control over every aspect of... Read more

Latest Forum Discussions

See All

A Legitimate Massage Parlor, I Swear – T...
In this week’s Episode of The TouchArcade Show we talk about some of the major new releases on mobile this week including Warframe, we go over all the major news that came out from the Nintendo Direct Partner Showcase on Wednesday, we read our one... | Read more »
TouchArcade Game of the Week: ‘Rainbow S...
I feel like I am in a fever dream right now. What is this game that I’m playing? It’s a Rainbow Six game? But it’s all cutesy, and cartoony, and also kind of psychedelic? How is this a real thing? Well, it’s no fever dream, it is indeed a real thing... | Read more »
SwitchArcade Round-Up: ‘Promenade’, ‘Cho...
Hello gentle readers, and welcome to the SwitchArcade Round-Up for February 23rd, 2024. It’s Friday, so we have to check out the remaining releases of the week. Not so many big ones today, but a healthy crop nonetheless. After summarizing all the... | Read more »
Steam Deck Weekly: Gundam Breaker 4 and...
Welcome to this week’s slightly shorter edition of the Steam Deck Weekly. I was a bit unwell this week so no reviews in this edition, but there is a lot of news and new Steam Deck Verified and Playable games to catch up on. I have something special... | Read more »
The 10 Best Run-And-Gun Games for Ninten...
The year 2024 is a rare one, because it is a year with a brand-new Contra game. Contra: Operation Galuga might be the freshest face on the block when it comes to Nintendo Switch run-and-gun action games, but it’s hardly fighting that war alone.... | Read more »
Version 1.4 of Reverse: 1999 will be lan...
Free up your diary for February 29th, as Bluepoch has announced the impending release of the award-winning Reverse: 1999s Version 1.4 update. The Prisoner in the Cave is an Ancient Greece-themed update with new recruits, gameplay modes, and plenty... | Read more »
Premium Mobile RPG ‘Ex Astris’ From ‘Ark...
Arknights developer Hypergryph’s premium RPG Ex Astris () recently had its release date confirmed, and we finally have an extended gameplay showcase. | Read more »
Apple Arcade Weekly Round-Up: Updates fo...
Following yesterday’s big Hello Kitty Island Adventure update, a few more notable game updates and events have gone live on Apple Arcade. Cypher 007 () has gotten its first content update in a few months taking you to Egypt for five new levels... | Read more »
‘Thunder Ray’ and ‘Hime’s Quest’ Are Now...
Crunchyroll has pushed two new games into the Crunchyroll Game Vault including Purple Tree Studio’s Thunder Ray which was already on iOS before as a premium release. Shaun even reviewed it last year. Read his review here. The second game is Poppy... | Read more »
Adorable Kitty-Collector Sequel ‘Neko At...
Ya’ll. This October will mark the ten-year anniversary of Hit Point launching Neko Atsume, the adorable kitty collecting sim that has become a runaway success and essentially created a sub-genre of cozy pet-collecting life sim games. Sure, the... | Read more »

Price Scanner via MacPrices.net

16-inch M3 Max MacBook Pro on sale for $300 o...
Amazon is offering a $300 instant discount on one of Apple’s 16″ M3 Max MacBook Pros today. Shipping is free: – 16″ M3 Max MacBook Pros (36GB/1TB/Space Black): $3199, $300 off MSRP Their price is the... Read more
Apple M2 Mac minis on sale for $100 off MSRP...
B&H Photo has Apple’s M2-powered Mac minis in stock and on sale for $100 off MSRP this weekend with prices available starting at $499. Free 1-2 day shipping is available to most US addresses: –... Read more
Apple Watch SE on sale for $50 off MSRP this...
Best Buy has all Apple Watch SE models on sale this weekend for $50 off MSRP on their online store. Sale prices available for online orders only, in-store prices may vary. Order online, and choose... Read more
Deal Alert! Apple 15-inch M2 MacBook Airs on...
Looking for the lowest sale price on a new 15″ M2 MacBook Air? Best Buy has Apple 15″ MacBook Airs with M2 CPUs in stock and on sale today for $300 off MSRP on their online store. Prices valid for... Read more
Amazon discounts iPad mini 6 models up to $12...
Amazon is offering Apple’s 8.3″ WiFi iPad minis for $100-$120 off MSRP, including free shipping, for a limited time. Prices start at $399. Amazon’s prices are among the lowest currently available for... Read more
Apple AirPods Pro with USB-C discounted to $1...
Walmart has Apple’s 2023 AirPods Pro with USB-C in stock and on sale for $199.99 on their online store. Their price is $50 off MSRP, and it’s currently one the lowest prices available for new AirPods... Read more
Apple has 14-inch M3 MacBook Pro with 16GB of...
Apple has 14″ M3 MacBook Pros with 16GB of RAM, Certified Refurbished, available for $270-$300 off MSRP. Each model features a new outer case, shipping is free, and an Apple 1-year warranty is... Read more
Save $318-$432 on 16-inch M3 Max MacBook Pros...
Apple retailer Expercom has 16″ M3 Max MacBook Pros on sale for $318-$432 off MSRP when bundled with a 3-year AppleCare+ Protection Plan. Discounts are available for Silver models as well a Space... Read more
New today at Apple: 16-inch M3 Pro/M3 Max Mac...
Apple is now offering 16″ M3 Pro and M3 Max MacBook Pros, Certified Refurbished, starting at $2119 and ranging up to $530 off MSRP. Each model features a new outer case, shipping is free, and an... Read more
Apple is now offering $300-$480 discounts on...
Apple is now offering 14″ M3 Pro and M3 Max MacBook Pros, Certified Refurbished, starting at $1699 and ranging up to $480 off MSRP. Each model features a new outer case, shipping is free, and an... Read more

Jobs Board

Part-time *Apple* and Peach Research Assist...
…and minimum qualifications: + Assist with planting, pruning, and harvesting of apple and peach trees + Conduct regular maintenance tasks to ensure optimal Read more
Housekeeper, *Apple* Valley Villa - Cassia...
Apple Valley Villa, part of a senior living community, is hiring entry-level Full-Time Housekeepers to join our team! We will train you for this position and offer a Read more
Sublease Associate Optometrist- *Apple* Val...
Sublease Associate Optometrist- Apple Valley, CA- Target Optical Date: Feb 22, 2024 Brand: Target Optical Location: Apple Valley, CA, US, 92307 **Requisition Read more
Sublease Associate Optometrist- *Apple* Val...
Sublease Associate Optometrist- Apple Valley, CA- Target Optical Date: Jan 24, 2024 Brand: Target Optical Location: Apple Valley, CA, US, 92307 **Requisition Read more
Housekeeper, *Apple* Valley Village - Cassi...
Apple Valley Village Health Care Center, a senior care campus, is hiring a Part-Time Housekeeper to join our team! We will train you for this position! In this role, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.