Sorry your browser is not supported!

You are using an outdated browser that does not support modern web technologies, in order to use this site please update to a new browser.

Browsers supported include Chrome, FireFox, Safari, Opera, Internet Explorer 10+ or Microsoft Edge.

AppGameKit Classic Chat / Typos found in "The Official App Game Kit Tutorial Guide"

Author
Message
Jerry McGuire
7
Years of Service
User Offline
Joined: 25th Mar 2017
Location:
Posted: 3rd Apr 2017 23:19 Edited at: 4th Apr 2017 00:29
Link
Hi everyone,
I have been going through the "Official Guide" and found one or two typos in the Solutions for the Activities. Since these kind of typos can create a lot of confusion for readers/beginners (like myself!), I've started this thread. I am sure the author will appreciate any typos that are pointed out in a polite manner. I hope others find typos or possible typos to post them here and let both the new readers and the author know about them.
Back to top
Profile PM
Jerry McGuire
7
Years of Service
User Offline
Joined: 25th Mar 2017
Location:
Posted: 3rd Apr 2017 23:22 Edited at: 4th Apr 2017 00:20
Link
OK, here is the first typo I am posting:

In the Solutions for Chapter 2 you will find the following answer for Activity 2.10:

Activity 2.10
a) 2358

The actual answer should read

Activity 2.10
a) 2338
Back to top
Profile PM
Jerry McGuire
7
Years of Service
User Offline
Joined: 25th Mar 2017
Location:
Posted: 4th Apr 2017 00:16 Edited at: 4th Apr 2017 00:24
Link
Here is another (small) one. I have inserted lower hyphens "_" instead of spaces " ".
In the Solutions for Chapter 2 you will find the following first line in the answer to the Activity 2.16:


Activity 2.16
a)
0.00872 10 = 0_01111000_10001110110111100101010
etc.


It should read

Activity 2.16
a)
0.00872 10 = 0_01111000_00011101101111001010100
etc.
Back to top
Profile PM
nz0
AGK Developer
17
Years of Service
User Offline
Joined: 13th Jun 2007
Location: Cheshire,UK
Posted: 4th Apr 2017 00:33
Link
Good luck with that.

Have you looked at the main documentation?

It's very annoying to see there's no actual reference to measurement units, so you don't actually know what the values mean.
My Robotron remake
My I,Robot remake WIP
My Defender remake
Back to top
Profile PM Email Website
Jerry McGuire
7
Years of Service
User Offline
Joined: 25th Mar 2017
Location:
Posted: 4th Apr 2017 03:14 Edited at: 4th Apr 2017 03:16
Link
I know it's wishful thinking, but it may work if the moderators pin the thread. (I have to ask if that's possible!)

Do you mean the documentation at https://www.appgamekit.com/documentation/home.html ?
So far, I've seen that all the commands therein specify the type of arguments they take. For example: "SetVirtualResolution(w,h) where w and h are integers". However, the explanations are not elaborated. For example, they may not tell you that w and h are the number of pixels for width and height. Is that what you mean? Maybe we could try to propose these more elaborated explanations for that online documentation.

BTW, I see that you are an AppGameKit Developer. Any idea of how to pin threads?
Back to top
Profile PM
Alistair
17
Years of Service
User Offline
Joined: 4th Oct 2006
Location: Scotland
Posted: 5th Apr 2017 11:26
Link
@Jerry. Thanks for taking the trouble to point any typos, mistakes, oromissions to the book. Of course, I've tried to reduce the errors to a minimum, but without the help of
the readers it will be impossible to elimate them altogether.

Any reported errors are always greatfully received and will be corrected for the next free release (probably sometime in the summer).

Alistair
Back to top
Profile PM Website
Jack
19
Years of Service
User Offline
Joined: 4th Oct 2004
Location: [Germany]
Posted: 6th Apr 2017 11:20
Link
I add the typo inside the image to memblock command example code.

[/url]
Back to top
Profile PM Email Website
nz0
AGK Developer
17
Years of Service
User Offline
Joined: 13th Jun 2007
Location: Cheshire,UK
Posted: 9th Apr 2017 13:04
Link
Quote: "BTW, I see that you are an AppGameKit Developer. Any idea of how to pin threads?"


A forum moderator would be able to pin posts.
AppGameKit Developer means I made a published product with AGK.

@Alistair "book?" Did you write a book for AppGameKit or are we talking about the official documentation (or both?)
My Robotron remake
My I,Robot remake WIP
My Defender remake
Back to top
Profile PM Email Website
Jerry McGuire
7
Years of Service
User Offline
Joined: 25th Mar 2017
Location:
Posted: 9th Apr 2017 16:09 Edited at: 9th Apr 2017 16:22
Link
@alistair: glad to help

Jack wrote: "I add the typo inside the image to memblock command example code.
"

@Jack: Thanks for contributing. I couldn't see any image though. How do I see it?

@nz0: thanks for explaining how to pin a thread
Back to top
Profile PM
Jerry McGuire
7
Years of Service
User Offline
Joined: 25th Mar 2017
Location:
Posted: 22nd Apr 2017 00:52 Edited at: 1st May 2017 23:36
Link
Page 407, SUMMARY has the following line:

[squared bullet] An array can be returned from an array by specifying the array name in the endfunction statement.

It should read:

[squared bullet] An array can be returned from an array by specifying the array name in the endfunction statement.

Right below that, you have:

[squared bullet] An array can have its contents modified within an array by adding the term ref after the array's name in the function heading.

It should read:

[squared bullet] An array can have its contents modified within an array by adding the term ref after the array's name in the function heading.
Back to top
Profile PM
Alistair
17
Years of Service
User Offline
Joined: 4th Oct 2006
Location: Scotland
Posted: 22nd Apr 2017 10:41
Link
Thanks Jerry
Back to top
Profile PM Website
Jerry McGuire
7
Years of Service
User Offline
Joined: 25th Mar 2017
Location:
Posted: 1st May 2017 23:29 Edited at: 2nd May 2017 17:22
Link
Page 548, FIG-16.2 has the following line:

I believe it should read

(The last "%" is not necessary, but I would suggest to put it for consistency)

On a related note, the same code in FIG-16.2 assumes that 'color' is an integer of the form 0x??????, where the first pair ?? stand for red, the second pair ?? for green, and the third pair ?? for blue. I have done some testing, and it seems that the code is not compiled in this order with some functions like DrawBox, so use rather the MakeColor function to be safe.

Pages 628 through 630: I suggest you replace every "CARDWIDTH" by "CARDHEIGHT". This would make the code consistent with the name of this declared constant.
Back to top
Profile PM
Jerry McGuire
7
Years of Service
User Offline
Joined: 25th Mar 2017
Location:
Posted: 2nd May 2017 16:52 Edited at: 2nd May 2017 16:52
Link
Page 645, code at the bottom:

I believe it should read:
Back to top
Profile PM
Alistair
17
Years of Service
User Offline
Joined: 4th Oct 2006
Location: Scotland
Posted: 3rd May 2017 07:40
Link
Thanks again Jerry. Maybe I should send you a free copy of the upcoming volume 2, so you can give it a quick once over?
Back to top
Profile PM Website
Jerry McGuire
7
Years of Service
User Offline
Joined: 25th Mar 2017
Location:
Posted: 3rd May 2017 23:53 Edited at: 4th May 2017 17:58
Link
I'll be happy to.
AppGameKit IDE 2017.04.24 (Steam)
Windows 7 Professional 64bit, Service Pack 1
Dell Precision T7400:
Intel Xeon CPU E5405 @ 2.00GHz (2 processors)
16GB RAM
Nvidia GeForce GTX 560 Ti
Samsung SSD 850 EVO 250GB and SanDisk SDSSDXPS960G
Back to top
Profile PM
tasmanian guy
14
Years of Service
User Offline
Joined: 29th Jun 2010
Location: Australia
Posted: 4th May 2017 13:24
Link
I assume then Alistair the second book isn't too far away

You do some great work!
DBPro is the new Amos (I hope)
Back to top
Profile PM Website
Alistair
17
Years of Service
User Offline
Joined: 4th Oct 2006
Location: Scotland
Posted: 5th May 2017 18:16
Link
It's taking a bit longer than I had hoped. But I'm trying to add a few chapters that are more than just going over the next set of AGK2 commands (although they are there too, of course).

Maybe after you come back from your summer (sorry, I mean winter) holidays!
Back to top
Profile PM Website
Back to top

Login to post a reply

Server time is: 2024-09-30 03:16:45
Your offset time is: 2024-09-30 03:16:45