Acorn Graphics Extension ROM (GXR) User Guide

These forums are for community collaboration on archiving, magazine scanning etc. to avoid work duplication and agree conventions / define standards
Post Reply
User avatar
dv8
Posts: 261
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Acorn Graphics Extension ROM (GXR) User Guide

Post by dv8 » Mon Apr 01, 2019 9:29 pm

Attached is a remastered PDF of the Acorn Graphics Extension ROM user guide.

In the zip file is the GXR ROM and an SSD disc image containing the listings from the manual and extra programs from a cassette originally supplied with the ROM.

EDIT: Added Reference Card and keystrip.

Graphics_Extension_ROM.pdf
(266.73 KiB) Downloaded 150 times
Graphics_Extension_ROM_Reference.pdf
(46.54 KiB) Downloaded 76 times
Graphics_Extension_ROM_KeyStrip.pdf
(14.67 KiB) Downloaded 62 times
Graphics_Extension_ROM.zip
(26.95 KiB) Downloaded 64 times

Other remastered user guides you may be interested in:

Computer Concepts Graphics ROM User Guide
BBC Micro User Guide (Model B and B+ editions)
Advanced User Guide
New Advanced User Guide
Last edited by dv8 on Wed Jan 29, 2020 9:44 am, edited 5 times in total.

User avatar
jms2
Posts: 2359
Joined: Mon Jan 08, 2007 6:38 am
Location: Derby, UK
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by jms2 » Mon Apr 01, 2019 10:11 pm

That looks terrific! It must have taken ages to get it that good!

I may have the card.

User avatar
lurkio
Posts: 2362
Joined: Tue Apr 09, 2013 11:30 pm
Location: Doomawangara
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by lurkio » Mon Apr 01, 2019 10:37 pm

dv8 wrote:
Mon Apr 01, 2019 9:29 pm
Attached is a remastered PDF of the Acorn Graphics Extension ROM user guide.
Superb! This has prompted me to do a quick rewrite of the circles/interference program using the GXR ROM:
:idea:
Last edited by lurkio on Mon Apr 01, 2019 10:49 pm, edited 2 times in total.

User avatar
Lardo Boffin
Posts: 1779
Joined: Thu Aug 06, 2015 6:47 am
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by Lardo Boffin » Tue Apr 02, 2019 6:22 am

I have the reference card and will take some photos later on when it is a bit lighter.

You may need to pm me an email address to send the photos to otherwise they will be compressed if put as attachments on here.
Atom, issue 5
BBC model B 32k issue 4, 16k sideways RAM, Watford 12 ROM board, Acorn 6502 coproc
BBC model B 32k issue 7, turboMMC, Opus Challenger 3 512k, Pi 3 coproc
USA Model B
BBC Master, Datacentre + HDD, pi co-proc, econet, NULA

User avatar
tricky
Posts: 3904
Joined: Tue Jun 21, 2011 8:25 am
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by tricky » Tue Apr 02, 2019 7:32 am

Thanks for these, does it happen to mention any differences between this and the built in version on the master?

User avatar
Lardo Boffin
Posts: 1779
Joined: Thu Aug 06, 2015 6:47 am
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by Lardo Boffin » Tue Apr 02, 2019 8:07 am

The card is 13MB scanned at 250DPI.
Atom, issue 5
BBC model B 32k issue 4, 16k sideways RAM, Watford 12 ROM board, Acorn 6502 coproc
BBC model B 32k issue 7, turboMMC, Opus Challenger 3 512k, Pi 3 coproc
USA Model B
BBC Master, Datacentre + HDD, pi co-proc, econet, NULA

User avatar
dv8
Posts: 261
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by dv8 » Tue Apr 02, 2019 9:22 am

jms2 wrote:
Mon Apr 01, 2019 10:11 pm
That looks terrific! It must have taken ages to get it that good!
Thanks. Short books like this really don't take too long, especially when they have a bunch of listings that can just be copy+pasted.
tricky wrote:
Tue Apr 02, 2019 7:32 am
Thanks for these, does it happen to mention any differences between this and the built in version on the master?
It predates the Master so no mention of it. As far as I know the Master MOS contains everything except the sprite routines and editor. These are available as a separate file on the Welcome disc that needs to be loaded into sideways RAM.
Lardo Boffin wrote:
Tue Apr 02, 2019 8:07 am
The card is 13MB scanned at 250DPI.
The file size can often be reduced dramatically by scanning in black+white or even better in 1-bit monochrome (often called 'text' or 'line-art' mode in scanner software) and saving to a lossless format such as PNG.

I usually scan text documents at 600 DPI mono and they come out at a few hundred K per page.

Failing that the scans could always be uploaded to a file sharing site like DropBox.

User avatar
flaxcottage
Posts: 3844
Joined: Thu Dec 13, 2012 8:46 pm
Location: Derbyshire
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by flaxcottage » Tue Apr 02, 2019 9:38 am

That is brilliant quality. =D> =D>
- John

Image

User avatar
Lardo Boffin
Posts: 1779
Joined: Thu Aug 06, 2015 6:47 am
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by Lardo Boffin » Tue Apr 02, 2019 11:03 am

dv8 wrote:
Tue Apr 02, 2019 9:22 am
Lardo Boffin wrote:
Tue Apr 02, 2019 8:07 am
The card is 13MB scanned at 250DPI.
The file size can often be reduced dramatically by scanning in black+white or even better in 1-bit monochrome (often called 'text' or 'line-art' mode in scanner software) and saving to a lossless format such as PNG.

I usually scan text documents at 600 DPI mono and they come out at a few hundred K per page.

Failing that the scans could always be uploaded to a file sharing site like DropBox.
I only have a cheap and cheerful scanner but here goes. If these are not good enough I can re-do and put them on Dropbox or similar.
Attachments
GXR02.zip
Inside
(265.48 KiB) Downloaded 28 times
GXR_01.zip
Front and back cover
(144.29 KiB) Downloaded 27 times
Atom, issue 5
BBC model B 32k issue 4, 16k sideways RAM, Watford 12 ROM board, Acorn 6502 coproc
BBC model B 32k issue 7, turboMMC, Opus Challenger 3 512k, Pi 3 coproc
USA Model B
BBC Master, Datacentre + HDD, pi co-proc, econet, NULA

User avatar
dv8
Posts: 261
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by dv8 » Tue Apr 02, 2019 11:15 am

Lardo Boffin wrote:
Tue Apr 02, 2019 11:03 am
I only have a cheap and cheerful scanner but here goes.
Perfect, thanks.
I should be able to get the PDF done later today.

User avatar
Lardo Boffin
Posts: 1779
Joined: Thu Aug 06, 2015 6:47 am
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by Lardo Boffin » Tue Apr 02, 2019 1:30 pm

For completeness here is the key strip.
Attachments
KeyStrip.zip
(57.14 KiB) Downloaded 32 times
Atom, issue 5
BBC model B 32k issue 4, 16k sideways RAM, Watford 12 ROM board, Acorn 6502 coproc
BBC model B 32k issue 7, turboMMC, Opus Challenger 3 512k, Pi 3 coproc
USA Model B
BBC Master, Datacentre + HDD, pi co-proc, econet, NULA

User avatar
dv8
Posts: 261
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by dv8 » Tue Apr 02, 2019 3:44 pm

I've now added PDFs for the Reference Card and keystrip to the opening post. Thanks to Lardo for the scans.

Lurkio has also found an error on page 16 of the main guide. I'll leave it a day or two to see if any other errors are discovered and then reissue a corrected PDF.

User avatar
Lardo Boffin
Posts: 1779
Joined: Thu Aug 06, 2015 6:47 am
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by Lardo Boffin » Tue Apr 02, 2019 7:27 pm

Nice PDFs! Top stuff. =D>
Atom, issue 5
BBC model B 32k issue 4, 16k sideways RAM, Watford 12 ROM board, Acorn 6502 coproc
BBC model B 32k issue 7, turboMMC, Opus Challenger 3 512k, Pi 3 coproc
USA Model B
BBC Master, Datacentre + HDD, pi co-proc, econet, NULA

User avatar
dv8
Posts: 261
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by dv8 » Fri Apr 05, 2019 11:41 am

A corrected version of the main user guide has now been added to the opening post.

User avatar
pixelblip
Posts: 1473
Joined: Wed Feb 04, 2015 7:19 pm
Location: London
Contact:

Re: Acorn Graphics Extension ROM User Guide

Post by pixelblip » Thu Apr 11, 2019 11:56 am

Thank you all of you for your brilliant effort. Much easier to read than the txt version.
This rom is so awesome with so many shades and colours. A lot of life left in it yet!
Last edited by pixelblip on Thu Apr 11, 2019 11:57 am, edited 1 time in total.

elkrepair
Posts: 12
Joined: Tue Nov 13, 2018 1:53 pm
Contact:

Re: Acorn Graphics Extension ROM (GXR) User Guide

Post by elkrepair » Thu Jan 23, 2020 9:35 pm

Hi.

I have a Graphics ROM, but when I type *HELP it doesn't appear. Also, when I type *GXR the Beeb just hangs.

I guess the ROM has gone to the great silicon repository in the sky. :(
Elk rev 4 with Plus1
BBC B rev 7
BBC micro:bit
RaspberryPi B+ and 3B
Abit BP6

User avatar
dv8
Posts: 261
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: Acorn Graphics Extension ROM (GXR) User Guide

Post by dv8 » Thu Jan 23, 2020 11:06 pm

elkrepair wrote:
Thu Jan 23, 2020 9:35 pm
I have a Graphics ROM, but when I type *HELP it doesn't appear. Also, when I type *GXR the Beeb just hangs.
It might be the Computer Concepts Graphics ROM rather than the Acorn GXR.

Try entering *FX162 then *HELP. If it's the CC ROM it will be listed as GRAPHICS EXTENSION 2.09

*HELP GRAPHICS will then show a list of supported commands.

elkrepair
Posts: 12
Joined: Tue Nov 13, 2018 1:53 pm
Contact:

Re: Acorn Graphics Extension ROM (GXR) User Guide

Post by elkrepair » Sun Jan 26, 2020 11:49 pm

Yup, that did it, and that's exactly what appeared. Many thanks.

I can't find a manual for it though. Does anyone know of a link please?
Elk rev 4 with Plus1
BBC B rev 7
BBC micro:bit
RaspberryPi B+ and 3B
Abit BP6

User avatar
dv8
Posts: 261
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: Acorn Graphics Extension ROM (GXR) User Guide

Post by dv8 » Mon Jan 27, 2020 12:10 am

elkrepair wrote:
Sun Jan 26, 2020 11:49 pm
I can't find a manual for it though. Does anyone know of a link please?
I couldn't find one either so I've scanned my copy of it and am currently putting together a remastered PDF.

User avatar
jgharston
Posts: 3802
Joined: Thu Sep 24, 2009 11:22 am
Location: Whitby/Sheffield
Contact:

Re: Acorn Graphics Extension ROM (GXR) User Guide

Post by jgharston » Mon Jan 27, 2020 1:01 am

dv8 wrote:
Thu Jan 23, 2020 11:06 pm
elkrepair wrote:
Thu Jan 23, 2020 9:35 pm
I have a Graphics ROM, but when I type *HELP it doesn't appear. Also, when I type *GXR the Beeb just hangs.
It might be the Computer Concepts Graphics ROM rather than the Acorn GXR.

Try entering *FX162 then *HELP. If it's the CC ROM it will be listed as GRAPHICS EXTENSION 2.09

*HELP GRAPHICS will then show a list of supported commands.
Also, the graphics extension ROMs default to disabled or enabled depending on if the ROM slot they are in is odd or even. Try swapping the GXR ROM with the one adjacent to it.

Code: Select all

$ bbcbasic
PDP11 BBC BASIC IV Version 0.25
(C) Copyright J.G.Harston 1989,2005-2015
>_

User avatar
dv8
Posts: 261
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: Acorn Graphics Extension ROM (GXR) User Guide

Post by dv8 » Mon Jan 27, 2020 10:00 am

jgharston wrote:
Mon Jan 27, 2020 1:01 am
Also, the graphics extension ROMs default to disabled or enabled depending on if the ROM slot they are in is odd or even. Try swapping the GXR ROM with the one adjacent to it.
That's true for the Acorn GXR. For the CC Graphics ROM, versions 1.xx are enabled by default, versions 2.xx are disabled.

The telltale sign that elkrepair has the CC ROM is the fact there was no output from *HELP.
The Acorn GXR still responds to *HELP when disabled.

elkrepair
Posts: 12
Joined: Tue Nov 13, 2018 1:53 pm
Contact:

Re: Acorn Graphics Extension ROM (GXR) User Guide

Post by elkrepair » Mon Jan 27, 2020 7:14 pm

Yup, defo the CC Graphics ROM.

I did as DV8 explained and everything behaved as described.

Until I see a manual, the only way to use the commands within a program is to use OSCLI, which isn't great. I'm hoping the manual explains PLOT commands similar to the Acorn GXR.
Elk rev 4 with Plus1
BBC B rev 7
BBC micro:bit
RaspberryPi B+ and 3B
Abit BP6

User avatar
flaxcottage
Posts: 3844
Joined: Thu Dec 13, 2012 8:46 pm
Location: Derbyshire
Contact:

Re: Acorn Graphics Extension ROM (GXR) User Guide

Post by flaxcottage » Mon Feb 03, 2020 8:05 pm

There is a low quality scan here but the commands are visible - http://www.flaxcottage.com/gxr/AcornSoftGFX.zip

I found this somewhere on the internet and just hoarded it. I am a bit of a magpie that way. :lol:
- John

Image

Post Reply