Wintermute Engine Forum

Wintermute Engine => Community bulletin board => Topic started by: metamorphium on January 10, 2008, 02:30:53 PM

Title: WME BOOK is online
Post by: metamorphium on January 10, 2008, 02:30:53 PM
Hi muties,

as it didn't work quite as expected, I've made some corrections myself and thus opening the book for public usage. Note that it's a work in progress as mentioned in older threads.
Find the link here and enjoy. I expect your comments below the articles if any.  ::beer ::beer ::beer

http://res.dead-code.org/doku.php/wmebook:start
Title: Re: WME BOOK is online
Post by: SoundGuy on January 13, 2008, 11:02:23 PM
no replies yet ? huh !

I started reading though your book and it whatever is there already look wonderful, I'm certainly going to point new teammates towards it.

Thanks for taking the effort in making it and putting it up and available!

(anxiously waiting until you get to the 2.5D part)

Oded

Title: Re: WME BOOK is online
Post by: nuclear_winter on January 14, 2008, 08:35:27 PM
Thanks a lot meta, I'm waiting for the weekend to come to have some free time away from work to enjoy your work!
Quote
(anxiously waiting until you get to the 2.5D part)
me 2!!!
Title: Re: WME BOOK is online
Post by: Stucki on January 15, 2008, 12:11:12 AM
i havent had the time for reading much of it but what i have seen so far is really ambitious !
thank  for sharing all this with us !

you rock  O0 ::rock O0
Title: Re: WME BOOK is online
Post by: Darky on January 15, 2008, 12:12:59 AM
Just found this 20 minutes ago and started reading. Thank you very much, from what I have seen it is very useful for everyone that is serious on getting into Wintermute :)

Bookmarked it!
Title: Re: WME BOOK is online
Post by: lacosaweb on January 16, 2008, 09:55:22 AM
Good work!!! It's excellent!!!
Title: Re: WME BOOK is online
Post by: Jose on February 01, 2008, 09:20:41 AM
Hey meta great work! I'm going to start reading the book now and I'll send my comments later (I hope...)

One question, I would like to translate the online book to Spanish (slowly cause I haven't much time and I don't know how far I'll be able to go) ¿how can I do that?

Greetings.

Title: Re: WME BOOK is online
Post by: Mnemonic on February 01, 2008, 09:40:43 AM
One question, I would like to translate the online book to Spanish (slowly cause I haven't much time and I don't know how far I'll be able to go) ?how can I do that?
I added Spanish to the list of languages. To translate any page, click the "es" button in the upper-right corner. Then create new page and you can start editing it (perhaps copy the source of the original page as a starting point).
To login, use the same username/password you're using for this forum. Be sure to check the "Remember me" check-box, so that you're not logged out while editing an article.
Title: Re: WME BOOK is online
Post by: Jose on February 01, 2008, 11:05:45 AM
I've added the Preface spanish translation (by the way now the english appears as 'es' instead of 'en').

I'm not a perfect translator cause my english is not very good so if anyone finds a better translation please do the changes needed.

I'll try to translate 1 page each day (or two days) but I can't promise it.

Greetings.
Title: Re: WME BOOK is online
Post by: Jose on February 01, 2008, 08:47:42 PM
Hi, again I've translated to Spanish yet: Preface, Resource, and Getting to know what WME is.

One more question: when you select the 'es' version, the table of contents of the WME Book Online is hidden. Can anyone solve this matter? Is there any way that I can translate the Table Of Contents too?

Thanks in advance for all.
Title: Re: WME BOOK is online
Post by: perplexing on February 09, 2008, 08:31:50 AM
I'd like to translate the Book to Korean! Actually, I did it little in my personal/secret wiki already.

Could you add Korean to the list, Mnemonic? :)
Title: Re: WME BOOK is online
Post by: Mnemonic on February 09, 2008, 02:17:21 PM
Could you add Korean to the list, Mnemonic? :)
Sure thing! :)
Title: Re: WME BOOK is online
Post by: Mnemonic on February 09, 2008, 02:18:26 PM
One more question: when you select the 'es' version, the table of contents of the WME Book Online is hidden. Can anyone solve this matter? Is there any way that I can translate the Table Of Contents too?
Yes, you need to edit the following page: http://res.dead-code.org/doku.php/es:wmebook:sidebar
The original table of contents page is: http://res.dead-code.org/doku.php/wmebook:sidebar
Title: Re: WME BOOK is online
Post by: perplexing on February 10, 2008, 04:23:17 AM
Sure thing! :)
Thank you! :)

Title: Re: WME BOOK is online
Post by: Baron on February 23, 2008, 02:47:18 PM
Im reading through the book now. Thank you so much, its exactly what a programming afraid artisty type like me
needs. Usually the word script sends cold chills down my spine, now I feel a sense of calm settling in.
It is very accessable and easy to understand. Fantastic writing. 
God bless you!

All the Best
David
Title: Re: WME BOOK is online
Post by: Baron on February 29, 2008, 12:37:29 AM
Hi Metamorphium,
                     I would like to contribute graphics and proof reading to the Wme programming book effort.
I'm a complete beginner so I would like to ask a few questions the parts that I have found a little hard to understand,
then I could add that information into the manuscript, with your permission of course.
Here is a graphic I made for the "keypad" example in the scripting chapter.
I'm really excited, the book is helping me a lot.
Please Pm me if you are interested.

http://www.flickr.com/photos/12448574@N02/2296383782/sizes/o/ (http://www.flickr.com/photos/12448574@N02/2296383782/sizes/o/)

Thanks,
David "Baron" McDermott
Title: Re: WME BOOK is online
Post by: mylesblasonato on February 29, 2008, 02:37:31 AM
Thanks Meta your a legend man this is awsome i also can't wait for the 2.5D section. Keep up the good work.

Cheers ::beer
Myles Blasonato
Title: Re: WME BOOK is online
Post by: mylesblasonato on February 29, 2008, 02:41:45 AM
Forgot to ask how i edit a page or add a new one.

Cheers ::beer
Myles Blasonato
Title: Re: WME BOOK is online
Post by: Maxim on March 01, 2008, 04:54:31 PM
Mega respect for the book, Meta!!!
You're doing a great job! We won't forget it.
Title: Re: WME BOOK is online
Post by: alternati on July 20, 2008, 10:53:43 PM
Hi, I'm starting to read the book. I think I found a small error in the last script (exit.script) in Chapter 3.

#include "scripts\base.inc"
 
on "ActorEntry"
{
   var door = Scene.GetNode("Door");
   Game.Interactive = false;
   global doorClicked;
   if (doorClicked)
   {
      actor.Talk("I don't want to return to my flat before I am sure I can't enter the warehouse!");
   }   
   else
   {
      Scene.DetachScript("scenes\warehouse\scr\bomb.script");
      actor.Talk("Phew. That was close");
      Game.ChangeScene("scenes\room\room.scene");
   }
   Game.Interactive = true;
}


Line in red must be: if (!doorClicked)

Am I right? Greetings !!!
Title: Re: WME BOOK is online
Post by: metamorphium on July 21, 2008, 06:50:05 AM
You're right. Thanks for the bug catch, it's repaired now.
Title: Re: WME BOOK is online
Post by: dotajames on July 21, 2008, 05:33:19 PM
This is excellent!  I was worried that there weren't enough examples/documentation for Wintermute but then I found this :)

Tiny errors I noticed in Chapter 2:


And also I had a couple of questions:


Thanks!
Title: Re: WME BOOK is online
Post by: metamorphium on July 21, 2008, 06:54:17 PM
Thanks, fixed. Funny, nobody mentioned before the unrelated code (was from my original book).

Quote
So that's a bug with the Wintermute engine?  What about using }else if{ instead of a switch, wouldn't that be quicker than writing a function

It's a bug in wme engine. To If/Else imagine having 10 different states:

if (a=="blue")
{
  //do something
}
else
if (a="red")
{
  //do something
}
etc.. etc..

will always look worse than:

switch(a)
{
   case "red":
       // Do something
       break;
   case "blue":
       // Do something
       break;
  // etc...
}


But you can use both and sometimes you have to.

Quote
Is it a good idea to put your global variables in an include file (e.g. "global myVar;") so that you can get/set the value without having to remembering to write global before it the first time you reference it in each script?

I use it for variables I refer often to. For variables which need to be global but I use them only once or twice in the whole game (various game states) I use the normal inscript declaration.

The comment was to warn before having in base.inc for example:

global MyVariable = 0;

This would ALWAYS reset the variable to 0 every inclusion (so no chance to setting something reasonable).

Even worse is to have:

global MyObject = new Object("path to object"); which would create a new memory object everytime any script runs. This will very soon cause the game to eat all RAM and is sometimes a big problem of newcomer's games.
Title: Re: WME BOOK is online
Post by: Haste! on August 04, 2008, 02:51:34 PM
Do anyone took an effort to translate it to russian? Theoreticaly, i can help
Title: Re: WME BOOK is online
Post by: Maltese on August 28, 2008, 09:43:46 PM
Just posting here to show my appreciation for the book, I've just started a project o wintermute and it's being a huge help. Keep up the good work ( please do !!!)  ;D


Title: Re: WME BOOK is online
Post by: markpouncey on May 09, 2009, 12:22:55 AM
Howdy,
  Looks like good work and I want to read it through. Is there a link to download this complete ??
                                                                            kind regards, markpouncey
Title: Re: WME BOOK is online
Post by: Mnemonic on May 09, 2009, 06:20:37 PM
No, as far as I know, there's only the online version. You'd need to use some mass-downloader.
Title: Re: WME BOOK is online
Post by: aRno on October 06, 2009, 11:21:50 PM
Consider yourself loved!
Metaphorically at least...
 ;D
Title: Re: WME BOOK is online
Post by: rens on February 15, 2010, 10:35:12 AM
Hi,

I would like to make a translation of the book in French. I know that it is a bit old, but as far as i know, the next WME's major release, is not for now, so i think it can worth it.

Quote
To translate any page, click the "es" button in the upper-right corner. Then create new page and you can start editing it (perhaps copy the source of the original page as a starting point).
To login, use the same username/password you're using for this forum. Be sure to check the "Remember me" check-box, so that you're not logged out while editing an article.

How can i create a new page ?

Thank you  :)

PS : I reassure you, my French is really better than my English  :D
Title: Re: WME BOOK is online
Post by: Mnemonic on February 15, 2010, 10:53:21 AM
I added French to the list of languages. If you are logged in, there should be a "Create page" button when you arrive to a non-existent page (such as when you click the "fr" link in the top-right corner).

Be sure to edit the new page, not the original english page. The language selector is somewhat buggy, and sometimes it displays your language ("fr" in your case) twice, also instead of the "en" link.
Title: Re: WME BOOK is online
Post by: rens on February 15, 2010, 11:12:34 AM
Quote
Be sure to edit the new page, not the original english page. The language selector is somewhat buggy, and sometimes it displays your language ("fr" in your case) twice, also instead of the "en" link.

Indeed, there was no tab "en", it was "fr", now i can see an other tab "fr", so i can start  :)
Title: Re: WME BOOK is online
Post by: rens on February 16, 2010, 11:25:26 AM
Hello !

In the project manager, in the section "Savegame settings", there is two fields named : Thumbnail width, Thumbnail height.

I don't quite understand what they're doing.

Does someone knows ?

Thank you  :P
Title: Re: WME BOOK is online
Post by: odnorf on February 16, 2010, 11:32:21 AM
They specify the size of thumbnails for savegames in pixels (width & heigh = 2 dimensions).
Title: Re: WME BOOK is online
Post by: rens on February 16, 2010, 11:58:06 AM
Ok, now i understand, it's the size of a small screen shot of the game, that you can display in the load save screen.

Thank you for the explanation.
Title: Re: WME BOOK is online
Post by: anarchist on February 17, 2011, 03:30:08 PM
Excellent work metamorphium! I have advertised your book to other fellow wintermute noobs and use it regularly until I learn the engine. Please continue this excellent work. I am really looking forward to the Going 2.5D chapter. If you require any sort of help (the best I can give is greek translation and english proof reading) just pm me.
Title: Re: WME BOOK is online
Post by: Serious.Ray on March 14, 2011, 11:31:37 PM
Sadly the last topic in the WME Book is from 2008/01/10 14:25  :'( I'd really appreciate if you keep going. WME2 could still take some time from what I read, your work wouldn't be wasted!
Title: Re: WME BOOK is online
Post by: metamorphium on March 16, 2011, 09:24:41 PM
it's just a matter of time unfortunately. Maybe this summer I can finish a bit more.
Title: Re: WME BOOK is online
Post by: Serious.Ray on March 16, 2011, 10:25:51 PM
I really hope you'll be able to :o. It would be a big help. :D
Title: Re: WME BOOK is online
Post by: Anto0085 on October 13, 2011, 01:59:45 PM
Ok, now i understand, it's the size of a small screen shot of the game, that you can display in the load save screen.

Thank you for the explanation.

I, certainly, dug up an old topic... ;)

Hi Rens! I saw you've start to translate the WME book. Good idea, everybody know that french people are lazy  :P (I'm french too)
I've two questions for you:
-first, can you tell me if you continue the translation or not? Just to know if I should wait.
-second, Does the french translation of the string table and hints of ProjectMan could interest you? Because I've doing it.

Thank for the work still made by you and by Metamorphium (Original text)
Title: Re: WME BOOK is online
Post by: odnorf on October 13, 2011, 02:47:21 PM
...Does the french translation of the string table and hints of ProjectMan could interest you? Because I've doing it...

You can send the the translations to Mnemonic (wme developer) and he'll add them to the download page with the other languages.
Title: Re: WME BOOK is online
Post by: Anto0085 on November 07, 2011, 03:57:01 PM
I've send it, I hope it will help someone. ;)

Because I've got any answer from Rens ... I think he is too busy ... I've made a some of the french translation of the Book online. So French guy you've got no excuses to do a good work ;D If someone find some erreur of translation, tell me what. Thank.

Note : It was very interresting to translate it, because I've discovered and learned WME in the same time, and it seems very powerfull and not so difficult to use ::thumbup. Now I'll start my first little small minimal game to try it :)
Title: Re: WME BOOK is online
Post by: philabade on April 04, 2012, 09:29:42 PM
ok j'ai traduit en français "finetuning the game" je l'envoie en mode texte à mnemonic