Re: [sc-dev] GUI Introduction draft finished

[jostM <sc3@xxxxxxxx>]

OK, I made all these changes myself. If you or anyone wants to make additions or corrections now, everything is checked in.

jost



Scott Wilson wrote:

On 14 Dec 2008, at 05:37, jostM wrote:

OK, I've committed my draft of the new GUI intro. GUI.html is now a
regular class help file. GUI-Overview.html is where you start, and
GUI-Classes gives you a complete table of GUI-class and redirecters.

Comments, additions and suggestions welcome.

GUI:

"With the ViewRedirecter subclasses, you can write this even more concisely. This is now the preferred method:"

I would say don't even bother demonstrating the GUI.widget syntax. It's not deprecated, but it's now 'private'. I'm not sure there's any reason users need to be aware of this. Maybe for subclassing, but then it should be clear that it's under the hood.

GUI-Classes:

This is great, but it would be nice if the class names didn't wrap at the standard window size. Would be better to resize the table so that this doesn't happen. Alternatively, just remove the GUI column. Again I think this is just confusing for users and not something they really need to know. A brief note like 'For implementation details see ViewRedirector and GUI' should be sufficient.

Again I think maybe SCQuartzComposerView should not have a redirect class since it will almost certainly never be cross-platform.

I the Mouse UGens and KeyState are indeed now working on all platforms, it should probably be noted here that they are the preferred way of working, and their JEquivalents just backwards compatibility at this point.

GUI-Overview:

"The default gui kit is CocoaGUI." That's only true in SC.app.

"Instead, there are basically two techniques for writing kit-independent code: using GUI and using the subclasses of ViewRedirecter." Again I'd say lose the GUI one here. ViewRedirecter is the official way, and presenting another one is just confusing and has no advantage.

Broken link for SCUserView Subclassing. 

______

One more thing which I almost hate to mention: Shouldn't ViewRedirecter be ViewRedirector? This would be easy to fix though with search and replace, which I am happy to do. I'd just need Jost to tell me when his latest corrections are checked in.

S.