xith.org updates

This thread should be used to announce updates on http://www.xith.org/ (FAQ, tutorials and maybe more).

There are new chapters in the Getting Started Guide:

[] Mouse Events
[
] Geometry Loaders

Grab the source and try them out. :slight_smile:

we definitally do need a mod in here to sticky up some of these topics :slight_smile:

Add your +1’s here: http://www.java-gaming.org/cgi-bin/JGNetForums/YaBB.cgi?board=announcements;action=display;num=1063639628;start=0#1

The getting started guide is coming along nicely I think. Good work on the “static” url’s for the chapters I wounder if the same can be done for the sections (ie. instead of #SECTION00042000000000000000)?

Will.

I have added a few new sections to xith.org today.

These are a dedicated Docs section: http://xith.org/docs.php This is for non-javadoc, documents of a less teaching nature (like the tutes).

In that section I have also added a list of all current Xith3D demos from the com.xith3d.test.* package - so that people can get a visual guide of some of the stuff that is currently implemented.

New community build will be created when the new RenderOptions code is “stable”.

Will.

[quote]Good work on the “static” url’s for the chapters I wounder if the same can be done for the sections (ie. instead of #SECTION00042000000000000000)?
[/quote]
I don’t think it’s easy to do this. I looked around a while, but didn’t find a simple way to achieve it, because these anchors are internal stuff. I think the authors wanted to avoid problems with duplicate subsection names. It’s not that critical, because the subsections are usually not very large.

fair enough, pity they didn’t just make it #s001 to look better. Regardless everyone should be downloading the PDF and printing it as it is really well formatted. IMHO paper is always nicer to work off anyway for documentation and stuff good if you have access to a printer at work too ;). HTML links are just nice to point people however.

Will.timer

I’m still looking if I can find a way to make the inner-section links safe for updates, but I don’t expect any success.

In the meantime I made a lot of layout changes, which mostly affect the html version.

I just finished a section about simple geometry.

good work on that one :slight_smile: When I started using geometry arrays with Xith3D I used the CubeTest.java and compared it to my Java3D book (the API jump start one). The good news is that Xith3D is very similar to Java3D in this department which I guess is expected since it is quite an integral part of most J3D apps, and one where differences are not needed.

Perhaps you could mention at the end of the article that Java3D tutorials are relevent in this area. Comparing a J3D tute to that one, it becomes pretty clear just how similar they are which makes our job easier ;D Xith3D still has some IndexedGeometry issues however.

Also I think that this line:


        QuadArray g = new QuadArray(coords.length, GeometryArray.COORDINATES
                                                 | GeometryArray.COLOR_3);

should be explained as at first the whole OR-ing thing could be a puzzle to some. Also to note - if one forgets to specify COLOR_3 and then tries to add a colour to it - you get a unhelpfull exception (issue #18 )

J3D does however have a different way of generating normals to Xith3D, they had “Helper” geometry which was probably better O-O design but Xith3D is much easier to use (one method call). It could be worth a mention but I guess it is only applicable to lights (and you have to be carefull to specify GeometryArray.NORMALS).

supurb work on the updated HTML version by the way, it looks very sleek!

Cheers,

Will.

[quote]Comparing a J3D tute to that one, it becomes pretty clear just how similar they are which makes our job easier ;D Xith3D still has some IndexedGeometry issues however.
[/quote]
GeometryStripArray and IndexedGeometryArray still need to be covered once they are working.

[quote]Also I think that this line:


        QuadArray g = new QuadArray(coords.length, GeometryArray.COORDINATES
                                                 | GeometryArray.COLOR_3);

should be explained as at first the whole OR-ing thing could be a puzzle to some. Also to note - if one forgets to specify COLOR_3 and then tries to add a colour to it - you get a unhelpfull exception (issue #18 )
[/quote]
I added a line to the tutorial about the bitwise OR. Can issue #18 be resolved?

Thanks. ;D

NEWS

Will.

  • the javadocs are back - nobody seemed to miss it, but I had some problems with my ftp client (it crashed while uploading…) so it was missing for a few days.
  • some other minor rearrangements including the Docs section.

Will.

Good work on cleaning up the site a bit. :smiley:

The picking tutorial is now finished. It shows the use of the Switch node, too.

Excellent! The tutorial is great.

Xith3D is really looking like something I’d like to use.

Kev

added a handy hotlink to the list of all currently open issues to xith.org on Jens’ suggestion (it’s on the link bar, to the right the “list” hyperlink.

Use it to keep track of current Xith3D issues ;D

Cheers,

Will.

EDIT: typo

[quote]added a handy hotlink to the list of all currently open tutorials to xith.org on Jens’ suggestion
[/quote]
I think you are talking about “open issues” not “open tutorials”. ;D Just nitpicking. ::slight_smile:

:stuck_out_tongue: edited - thanks it was a bit confusing I must agree.

very useful that link, I found an issue of mine which needed resolving and another one which needed fixing quite obviously ;D good idea Jens.

back in a few hours :slight_smile:

Cheers,

Will.

There is now a section about contributing to the Getting Started Guide for those of you who want to add another section to the guide.

Mentioned this in another thread, but maybe its worth asking here too. Have you considered some bespoke forums on the Xith3D site.

There are quite alot of new users coming through here each day and having it all in one forum is going to get tricky. It would also give you control to organise and moderate as you see fit (i.e. Have a moderator with stick topic permissions). Since Xith seems to be going places it might be a good corner stone to put in place before the user base gets really big.

I suppose you could use the forums at java.net but their pretty hideous.

Just an idea,

Kev

5 or 6 weeks ago I said it would be good to have a dedicated forum for Xith3D (we only had a single thread in the Jogl forum at this point of time). This forum has become really active (is it actually the most active here?). Nevertheless I think one forum is currently sufficient. If the traffic continues to increase we should think about opening a forum on xith.org (which is finally Will’s decision) and splitting it into “Xith3D users”, “Xith3D developement”, “Xith3D applications” and “Xith3D documentation” for instance.

I don’t really like the way LWJGL handles it. Looking at their forums I think they could fit in one forum. I would prefer to have one place for discussions over having to look at two places. If we make the move to xith.org we should give up the java-gaming.org forum in my opinion.

Finally, I hope this forum gets a moderator in the very near future. It can’t be that difficult.