Truly introductory, self-contained tutorials

What it says on the tin: a place to discuss proposed new features.
Locked
rulatir
Gnoblar
Posts: 3
Joined: Thu Aug 28, 2008 12:41 pm

Truly introductory, self-contained tutorials

Post by rulatir » Sat Nov 21, 2009 5:51 am

I would like to request a rather huge "feature" - another set of tutorialis, but this time without any "example frameworks". When I learn a new API, it is absolutely necessary for me to understand what each and every single line of code does. I just can't work with gaps in my understanding, as in "don't bother, the initialization is done for you by our example framework, and if you ever want to modify the initialization sequence... look, an Ogre!".

My preferred kind of tutorial is one that starts with a very minimal, self-contained program that Actually Does Something (e.g. displays a cube), and then adds functionality in minimal compilable-to-compilable steps, explaining things as necessary.
0 x

User avatar
xavier
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 9481
Joined: Fri Feb 18, 2005 2:03 am
Location: Dublin, CA, US

Re: Truly introductory, self-contained tutorials

Post by xavier » Sat Nov 21, 2009 8:42 am

Practical Application should be a decent start. I should update it to render something meaningful...

http://www.ogre3d.org/wiki/index.php/Pr ... pplication

[edit: I should also update my mini-bio too...I'm not 36 anymore ;)]
0 x
Do you need help? What have you tried?

Image

Angels can fly because they take themselves lightly.

ERSmith
Kobold
Posts: 28
Joined: Wed Feb 25, 2009 3:58 pm

Re: Truly introductory, self-contained tutorials

Post by ERSmith » Fri Mar 12, 2010 4:26 pm

You could write your own... but then if you could do that you'd have to understand the material to such a degree that you didn't need a tutorial anyway. I digress, that was an argument I saw toward a request for info on a particular feature.

I understand your desire to be rid of the "example framework". I went through all the old tutorials and when I started to write my own stuff, I immediately tossed the example framework.

I'll have a look at the practical applications tutorials as well.

What I'd really like to know is when did it become kosher to "read the source" in place of good documentation? Not so much directed at the Ogre team but more toward other programmers who will remain nameless.

I do think, at the least, the tutorials need updating. They work even in 1.7 but there are great number of features I only stumble across otherwise that could be covered. When I say stumbled, I don't mean that I mastered them or even know how to use them right now, so I can't write my own.
Last edited by ERSmith on Mon Mar 15, 2010 2:27 pm, edited 1 time in total.
0 x

mirlix
Goblin
Posts: 225
Joined: Mon May 01, 2006 12:03 am
Location: Germany

Re: Truly introductory, self-contained tutorials

Post by mirlix » Fri Mar 12, 2010 5:06 pm

Personally I think using a Framework for the first tutorials is rather good, it saves the beginner from a lot of little details they dont need to know yet. You can get right to the interesting stuff and later when the beginner has a feeling for the framework and how things work on the surface you can show him all the details.
0 x

User avatar
Zonder
Ogre Magi
Posts: 1133
Joined: Mon Aug 04, 2008 7:51 pm
Location: Manchester - England
x 22

Re: Truly introductory, self-contained tutorials

Post by Zonder » Mon Jul 12, 2010 10:27 am

0 x
There are 10 types of people in the world: Those who understand binary, and those who don't...

User avatar
zarfius
Gnome
Posts: 367
Joined: Wed Jan 03, 2007 12:44 pm
Location: Brisbane, Australia
Contact:

Re: Truly introductory, self-contained tutorials

Post by zarfius » Mon Jul 12, 2010 12:41 pm

I see no reason why we can't have both kinds of tutorials. The ones with the example framework are a great way to get things going fast while a set of more low level tutorials would be good to solidify the understanding of the engine.
0 x
Craftwork Games - hand crafted entertainment.
http://www.craftworkgames.com/

User avatar
xavier
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 9481
Joined: Fri Feb 18, 2005 2:03 am
Location: Dublin, CA, US

Re: Truly introductory, self-contained tutorials

Post by xavier » Mon Jul 12, 2010 5:22 pm

Guys -- pay attention to

a) the post dates
b) the new colors we have for deactivated accounts (suspected spammers)

You're essentially replying to no one here...
0 x
Do you need help? What have you tried?

Image

Angels can fly because they take themselves lightly.

User avatar
gameengineer
Kobold
Posts: 35
Joined: Sat Oct 09, 2010 8:04 pm
Location: San Diego, CA, USA
Contact:

Re: Truly introductory, self-contained tutorials

Post by gameengineer » Mon Jan 17, 2011 10:45 pm

xavier wrote:Guys -- pay attention to

a) the post dates
b) the new colors we have for deactivated accounts (suspected spammers)

You're essentially replying to no one here...
You're assuming nobody else will benefit from the topic. I had the same desire when I first started learning Ogre. I wanted very simple, start with a main() function and build from there, type of tutorial when I first started. The tutorial framework was fine and eventually I just ended up diving into Ogre source files themselves but it would have been great to have the extremely simple and small start. I'm sort of similar to the original poster. If I was an ant and was placed on one end of a peg board where my goal was to get to the other side, I'd venture down every dang hole just to see what's there. :) Its a fault actually. :roll:

Anyway, I have no time to write said tuts but the idea did cross my mind.

Steve
0 x

User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
Contact:

Re: Truly introductory, self-contained tutorials

Post by jacmoe » Tue Jan 18, 2011 1:27 am

Don't press your luck. :wink:
Start a new topic *if* that's a big issue for you.

/* locked */
0 x
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.

User avatar
xavier
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 9481
Joined: Fri Feb 18, 2005 2:03 am
Location: Dublin, CA, US

Re: Truly introductory, self-contained tutorials

Post by xavier » Tue Jan 18, 2011 3:40 am

gameengineer wrote: Anyway, I have no time to write said tuts but the idea did cross my mind.
Having written one, I can confirm it's not a 10-minute job (and this is part of the reason I didn't continue it -- it really is a ton of work to do it right). Not to mention keeping it current and relevant through all subsequent versions of Ogre...

Regardless, to Jacmoe's point, you're not really addressing anything I said in the quoted text (which is less than clear now since obviously the spammer's account and all their posts have been deleted in the interim).
0 x
Do you need help? What have you tried?

Image

Angels can fly because they take themselves lightly.

User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
Contact:

Re: Truly introductory, self-contained tutorials

Post by jacmoe » Tue Jan 18, 2011 7:50 am

Tutorials?
Look in our wiki. :)
And - in addition - look at this topic:
http://www.ogre3d.org/forums/viewtopic. ... 93&start=0
Will be migrated to our wiki RSN. :wink:
0 x
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.

Locked