Hi !
Featured games (87)
games approved by the League of Dukes
Games in Showcase (670)
Games in Android Showcase (194)
games submitted by our members
Games in WIP (727)
games currently in development
News: Read the Java Gaming Resources, or peek at the official Java tutorials
    Home     Help   Search   Login   Register   
Pages: [1]
  ignore  |  Print  
  A lot of these methods aren't implemented...  (Read 1545 times)
0 Members and 1 Guest are viewing this topic.
Offline victorwang

Senior Newbie

i will be uberjavaman

« Posted 2004-08-21 20:53:04 »

Looking through the source, I notice a lot of the methods everywhere (in GeomContainer for example) are completely empty and some just throw an unsupported function error.  I checked to see if any of these dummy methods are implemented in subclasses of GeomContainer but from what I can see, that's all they are -- dummy methods.  I don't see how this is supposed to be beneficial.  Wouldn't it be better just to delete those lines so that the error would show up as a compile error (method isn't there)?  That would be a lot better than having a bunch of useless methods taking up space in the API and confusing newbies like me.  At one point I was trying to use one of these dummy methods for about and hour or two before checking the Xith source to realize the method was completely empty.  It's hard to figure out which method to use because there are so many versions of similarly named methods, and yet many of them have absolutely no use whatsoever, except to confuse.  They should simply be added in when they are implemented.  Or is there some fundamental API design issue I have overlooked...?

Oh yea, and personally I think the most important thing to improve on in Xith right now is the Javadoc.  It's practically non-existant right now..

Another oh yea... Does anybody know of any good Xith guides besides the one on the offical site?  Didn't find any with Google..

Offline William Denniss

JGO Coder

Projects: 2

Fire at will

« Reply #1 - Posted 2004-08-21 22:25:42 »

Idealy the dummy methods should:  Throw and exception _or_ log an error message, and should be marked with a special @unimplemented tag in the docs.  They are place holder methods, present for Java3D compatability I think.  Perhaps we need to review them and remove ones which won't ever be implemented (I'm sure there are some).

Regarding Javadoc, I had a poll and topic on the subject recently asking for volunteers but only had 5 people stand up which is not really enough.

It is a long and boring task.  Maybe we need to do something similar to the LWJGL Mac donation drive and get a donation pool going?


Offline victorwang

Senior Newbie

i will be uberjavaman

« Reply #2 - Posted 2004-08-22 05:32:52 »

 Maybe we need to do something similar to the LWJGL Mac donation drive and get a donation pool going?

Heh, yeah let's see if Xith gets a grand.  Tongue

Pages: [1]
  ignore  |  Print  
You cannot reply to this message, because it is very, very old.

IanParcs (36 views)
2016-04-18 14:18:53

KaiHH (36 views)
2016-04-18 08:35:41

KaiHH (67 views)
2016-04-15 12:43:58

theagentd (67 views)
2016-04-14 02:16:17

theagentd (74 views)
2016-04-14 02:15:43

IanParcs (67 views)
2016-04-12 03:51:16

IanParcs (37 views)
2016-04-12 03:50:03

IanParcs (33 views)
2016-04-12 03:49:54

IanParcs (30 views)
2016-04-12 03:49:52

IanParcs (39 views)
2016-04-12 03:49:52
Website offering 3D Models specifically for games for free
by vusman
2016-04-29 12:56:17

List of Learning Resources
by SilverTiger
2016-02-05 09:39:47

List of Learning Resources
by SilverTiger
2016-02-05 09:38:38

List of Learning Resources
by SilverTiger
2016-02-05 09:35:50

Rendering resources
by Roquen
2015-11-13 14:37:59

Rendering resources
by Roquen
2015-11-13 14:36:58

Math: Resources
by Roquen
2015-10-22 07:46:10

Networking Resources
by Roquen
2015-10-16 07:12:30 is not responsible for the content posted by its members, including references to external websites, and other references that may or may not have a relation with our primarily gaming and game production oriented community. inquiries and complaints can be sent via email to the info‑account of the company managing the website of java‑
Powered by MySQL Powered by PHP Powered by SMF 1.1.18 | SMF © 2013, Simple Machines | Managed by Enhanced Four Valid XHTML 1.0! Valid CSS!