Documentation

Discuss the development of software, tools, libraries and anything else that helps make ps2dev happen.

Moderators: cheriff, Herben

Post Reply
Spectre
Posts: 6
Joined: Fri Aug 07, 2009 12:03 pm
Location: The third dimension with two-dimensional thoughts

Documentation

Post by Spectre »

Hello, ps2dev community!

So.... I've researched various source code, all of which successfully compiled & ran on my PS2. I've searched the net (forums included) for some sort of API/SDK documentation for further study, yet to no avail. Even on the main page, "http://docs.ps2dev.org/" seems to be broken.

Is there -- or are there plans for -- any documentation for any part of the sdk? I'm particularly interested in becoming more familiar with libgs. Based off of the samples, I've successfully developed an application which displays a 16bpp fullscreen background in 640x448, but I'm worried about pushing my luck without some form of organized reference. Such as, further understanding of the arguments for the gs_set* functions. The hard-coded integers found in the samples hardly serve as a proper learning curve, IMHO.

My goal is to eventually port a 2d tile scrolling engine, which I've originally developed for the iphone.
TIA, and happy coding!
Spectre
Posts: 6
Joined: Fri Aug 07, 2009 12:03 pm
Location: The third dimension with two-dimensional thoughts

Post by Spectre »

*doh!*
As it turns out, I forgot to check the sdk headers for more info. It's all practically spelled out, there.
J.F.
Posts: 2906
Joined: Sun Feb 22, 2004 11:41 am

Post by J.F. »

Yeah, like most homebrew SDKs, you look at the SDK source (particularly headers) and examples and existing apps using the SDK in lieu of actual docs.
methos3
Posts: 89
Joined: Fri Feb 01, 2008 3:21 am

Post by methos3 »

yes, the samples are greater than any doccumentation : )
and the headers too.
Another great source to look in is the one of uLaunchelf.
J.F.
Posts: 2906
Joined: Sun Feb 22, 2004 11:41 am

Post by J.F. »

And SMS... LOADS of good code there.
Spectre
Posts: 6
Joined: Fri Aug 07, 2009 12:03 pm
Location: The third dimension with two-dimensional thoughts

Post by Spectre »

Several thanks for the info!

Is SMS an open source project? If so, would anyone be so kind to toss me a link to the latest sms source? I've seen what it can do, and would have to agree that it could teach me plenty. My guess is that uLaunchElf's source probably won't be all that useful to me until I gain more interest in the IOP. For now, my main focus is with simple 2D graphics (image layers, sprites, alphablending, doublebuffering, etc). After that, I intend to get into more advanced 2D (such as video playback), and then some simple 3D graphics.

Heheh, it's kinda crazy how many times a developer has to go through the same stages of development each time there's a new target platform and/or language. This is like, my seventh time relearning the basics. That's a lot of tetris games... =P
J.F.
Posts: 2906
Joined: Sun Feb 22, 2004 11:41 am

Post by J.F. »

Yes, SMS is open source. It's in the ps2dev repos. Check out the ps2ware directory.

http://svn.ps2dev.org
yownas
Posts: 4
Joined: Wed Aug 12, 2009 7:13 pm

Post by yownas »

The source for SMS in the ps2dev-repo seems to be quite old. Is it possible to find a more up-to-date source somewhere?
parkerlindsey
Posts: 2
Joined: Mon Aug 31, 2009 4:49 pm

Post by parkerlindsey »

Hi Yownas

Yes, It is possible that you can find out it.
Google is best way for new version of SMS so it is very useful to you.
dlanor
Posts: 258
Joined: Thu Oct 28, 2004 6:28 pm
Location: Stockholm, Sweden

Post by dlanor »

yownas wrote:The source for SMS in the ps2dev-repo seems to be quite old. Is it possible to find a more up-to-date source somewhere?
No. The current versions of SMS are not open-source.

Eugene Plotnikov decided not to release his sources anymore after some commercial company tried to exploit his work for their own gain, without even acknowledging his work and instead claiming it as their own.

Since then source has only been shared on special request, and usually only as code 'snippets' to aid another homebrew programmer with similar needs.

So you won't find open sources of modern SMS versions anywhere.

Best regards: dlanor
dlanor
Posts: 258
Joined: Thu Oct 28, 2004 6:28 pm
Location: Stockholm, Sweden

Post by dlanor »

parkerlindsey wrote:Hi Yownas

Yes, It is possible that you can find out it.
Google is best way for new version of SMS so it is very useful to you.
No. If what you want is the latest version, then the best way is to visit Eugene Plotnikov's SMS home site, since that is where he makes the initial releases.

The link is "http://members.casema.nl/eugene_plotnikov/".

Best regards: dlanor
yownas
Posts: 4
Joined: Wed Aug 12, 2009 7:13 pm

Post by yownas »

dlanor wrote:Eugene Plotnikov decided not to release his sources anymore after some commercial company tried to exploit his work for their own gain, without even acknowledging his work and instead claiming it as their own.
Thats sad. :( Someone tries to make money on someone elses expense and everyone loses.

I guess it is kind of off-topic, but did he contact EFF about it?
dlanor
Posts: 258
Joined: Thu Oct 28, 2004 6:28 pm
Location: Stockholm, Sweden

Post by dlanor »

yownas wrote:Thats sad. :( Someone tries to make money on someone elses expense and everyone loses.
Yep, and it wasn't the first time, nor the last one either I think.
I guess it is kind of off-topic, but did he contact EFF about it?
I really don't know, but I doubt it. In most countries it is impossible to get any real action for cases like this, unless a huge amount of money is involved.

Best regards: dlanor
Post Reply