Wrapping my head around the palette

Discuss game and other programming topics not specifically covered in another forum

Moderator: Programming Moderators

User avatar
varmfskii
Posts: 287
Joined: Fri Jun 23, 2017 1:13 pm
Location: Stone Mountain, GA USA

Re: Wrapping my head around the palette

Postby varmfskii » Mon May 11, 2020 7:23 pm

I keep personal notes that are updated as the git docs are updated.
Backer #2741 - TS2068, Byte, ZX Evolution

Ped7g
Posts: 256
Joined: Mon Jul 16, 2018 7:11 pm

Re: Wrapping my head around the palette

Postby Ped7g » Mon May 11, 2020 7:50 pm

the wiki is only as good as people make it.
I did quite some updates to the nextreg pages https://wiki.specnext.dev/Board_feature_control where the current state should be in sync with 3.1.5 (and if you find any difference, fix it or let me know), but the long articles (like "Layer2") are more work to update, so I rarely touch them (only when I believe I have enough original info like in case of DMA article, where nobody else could provide that).

Also I feel I'm taking probably some time off the wiki, too much juicy stuff elsewhere and less friction.

User avatar
varmfskii
Posts: 287
Joined: Fri Jun 23, 2017 1:13 pm
Location: Stone Mountain, GA USA

Re: Wrapping my head around the palette

Postby varmfskii » Mon May 11, 2020 8:19 pm

Ped7g, I'm sorry, but my notes have been a wip longer than the wiki has been useful. Looking at and revising the wiki is, unfortunately for me, less important than maintaining my notes. Please understand.
Backer #2741 - TS2068, Byte, ZX Evolution

User avatar
sol_hsa
Posts: 273
Joined: Fri Jun 02, 2017 10:10 am
Location: Finland
Contact:

Re: Wrapping my head around the palette

Postby sol_hsa » Mon May 11, 2020 8:25 pm

Sorry if I stepped on something ;)

The registers are described in the wiki, I simply had not actually gone through all of the relevant ones as I thought.

User avatar
varmfskii
Posts: 287
Joined: Fri Jun 23, 2017 1:13 pm
Location: Stone Mountain, GA USA

Re: Wrapping my head around the palette

Postby varmfskii » Mon May 11, 2020 8:43 pm

There is so much out there.
I have been through a lot of it very thoroughly and there are things I'm not at all familiar with.
I've been playing with this on hardware since the board only stuff was shipped and in emulator before that.
Backer #2741 - TS2068, Byte, ZX Evolution

seedy1812
Posts: 91
Joined: Tue May 30, 2017 11:31 am

Re: Wrapping my head around the palette

Postby seedy1812 » Mon May 11, 2020 9:18 pm

Those documents on Git hub might be up to date but unless changes are not announce to people they are useless. The manual has no mention of the registers. The main port page https://www.specnext.com/tbblue-io-port-system/ does not mention them. Even the git hub changelog does not mention them https://gitlab.com/SpectrumNext/ZX_Spec ... angelog.md

Sorry if you are going to add new features please let people know about them.

On facebook this 320x256 layer 2 mode has only talked about in the past week or so I guess it would have been introduced in 3.1.5. Yet looking on the changelog of https://gitlab.com/SpectrumNext/ZX_Spec ... extreg.txt
they were added 3 months ago.

User avatar
SevenFFF
Posts: 565
Joined: Mon Jun 05, 2017 5:30 pm
Location: USA

Re: Wrapping my head around the palette

Postby SevenFFF » Mon May 11, 2020 9:34 pm

The manual was correct and up to date at the point the manual was printed. Everything is backwards compatible with that.

If you want to “announce” some features then you can keep a watch for future changes and make posts about them. Other than that, I’m not sure it’s anybody’s job to be the announcer to prevent things being perceived as useless to you. Volunteers are working hard enough as it without living up to your idea of what they should do.
Robin Verhagen-Guest
SevenFFF / Threetwosevensixseven / colonel32
NXtel NXTP ESP Update ESP Reset CSpect Plugins

Alcoholics Anonymous
Posts: 775
Joined: Mon May 29, 2017 7:00 pm

Re: Wrapping my head around the palette

Postby Alcoholics Anonymous » Mon May 11, 2020 10:42 pm

The hardware documentation is maintained at the fpga repository:

I/O Ports:
https://gitlab.com/SpectrumNext/ZX_Spec ... /ports.txt

Nextreg:
https://gitlab.com/SpectrumNext/ZX_Spec ... extreg.txt

It's terse but everything is there including the layer 2 resolutions:
https://gitlab.com/SpectrumNext/ZX_Spec ... g.txt#L656

and as you've noted it's been there since Dec 17 of last year in 3.00.05 so it was included in the day zero update (3.01.00) which everyone should have installed when they got their machines. The emulators have only recently put it in. I think cspect did 320x256 a month ago and official zesarux is getting it put in now. The ped fork of zesarux got it some time ago.

The changelog is only being maintained from the date the core was made public and from the version available on that date which was the day zero update. There are some older notes for versions from 2.00.00 (Victor's last core given to the team) through 2.00.27. But 2.00.28 and 3.00.00 were substantial rewrites which fixed up a lot of issues; that was too long to document. The fpga repository begins at 3.00.00 and shows the commit history from there.

Although the documentation is terse, those two files on io ports and nextreg do list everything. Maybe not in a way that is explained, as it's not a manual, but enough that what is there should be apparent.

The nextzxos documentation is found in the tbblue repository:
https://gitlab.com/thesmog358/tbblue/-/ ... s/nextzxos

And its changelog:
https://gitlab.com/thesmog358/tbblue/-/ ... ngelog.txt

seedy1812
Posts: 91
Joined: Tue May 30, 2017 11:31 am

Re: Wrapping my head around the palette

Postby seedy1812 » Tue May 12, 2020 8:07 am

I understand that the manual is a snapshot in time of what is available. Yet if people are looking on the website they will be presented with out of date information. When a new release is presented to the public then https://www.specnext.com/tbblue-io-port-system/ should be updated to reflect the changes. Else you might as well remove the webpage and point it to the GitLab ones.

Ped7g
Posts: 256
Joined: Mon Jul 16, 2018 7:11 pm

Re: Wrapping my head around the palette

Postby Ped7g » Tue May 12, 2020 8:24 am

varmfskii wrote:
Mon May 11, 2020 8:19 pm
Ped7g, I'm sorry
I have no issue with you and your ways, my comment was meant more as fact than accusation (and it just happened to pop after your comment, it wasn't a reply on it). (although I guess it is also sort of accusation, of all wiki users in general, but... that's how it is?)

sol_hsa: "stepping on something" - but you are correct, that layer 2 article is not up to date.

I'm just saying the wiki in my eyes is something what users produce. So this approach has its limits (and advantages as well).

Phoebus is technically "officially" responsible for wiki content, but he has more important things to do. And if I try to imagine world where Phoebus actually has time to edit wiki and makes it up to date, it's not wiki if it's coming from single person. That's manual. The spirit+point of wiki is precisely in bringing the community effort and point of view on the things, complementing the official manual.

The wiki is the only channel which can be easily affected (on content level) by active users, so you should also consume it with grain of salt, and cross-checking with more official resources. But one can contribute also just by filling up issue reports, or helping to confirm reports of others, etc... if one doesn't want to edit wiki. (varmfskii: even your personal notes can be seen as non-trivial contribution).

The whole Next project is only what people make it to be, and it may be not obvious how certain activity will contribute in the end, but usually any activity contributes more than passive approach (although I have seen in life cases, where certain person just sitting and doing nothing did contribute to certain projects lot more, than when they were trying to do something :))) hehe).

-------------------------------------------
Else you might as well remove the webpage and point it to the GitLab ones.
Yep, that one particular web page, with it's prominent position (for somebody who is just starting with Next SW development and is collecting initial info) .. is a bit like a landmine.


Who is online

Users browsing this forum: No registered users and 6 guests