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 / Documentation

Author
Message
Mike Johnson
TGC Developer
22
Years of Service
User Offline
Joined: 13th Sep 2002
Location: United Kingdom
Posted: 15th Aug 2011 11:42
Link
All of the documentation for AppGameKit is now available to view online:

http://www.appgamekit.com/documentation/home.html
Back to top
Profile PM Email Website
MobileCreator
13
Years of Service
User Offline
Joined: 1st Jun 2011
Location: Ottawa - Canada
Posted: 16th Aug 2011 18:32
Link
Awesome! Thanks!

Paulo

Paulo
Back to top
Profile PM Website
darzon
14
Years of Service
User Offline
Joined: 23rd Oct 2010
Location: Italy
Posted: 16th Aug 2011 18:34
Link
Hi Mike,

in example SnakeSnaker there is a test:

if GetMultiTouchExists()=1
touch=1
endif


but in documentation "GetMultiTouchExists" command don't exists.
Back to top
Profile PM
jbarberoj
13
Years of Service
User Offline
Joined: 15th Aug 2011
Location: Madrid - Spain
Posted: 16th Aug 2011 19:00
Link
Same happens with the command:

GetOrientation ( )

that appears in the example "General - Core" and it doesn't appear in the documentation.

Back to top
Profile PM Email
bjadams
AGK Backer
16
Years of Service
User Offline
Joined: 29th Mar 2008
Location:
Posted: 16th Aug 2011 20:18
Link
and what about vsync? Does it exist in Tier 2?
Back to top
Profile PM Email
Paul Johnston
TGC Developer
22
Years of Service
User Offline
Joined: 16th Nov 2002
Location: United Kingdom
Posted: 16th Aug 2011 21:49
Link
Quote: "and what about vsync? Does it exist in Tier 2? "


Nope, it got replaced with SetSyncRate() since vsync produced a horrible frame skipping effect.
Back to top
Profile PM Email
Rampage
16
Years of Service
User Offline
Joined: 4th Feb 2008
Location: New Zealand
Posted: 17th Aug 2011 07:32
Link
I got Tier 2 running fine.
But I can see where a guide might be handy to help set up the development environment.

Regards,

Max
Back to top
Profile PM Email Website
Rich Dersheimer
AGK Developer
15
Years of Service
User Offline
Joined: 1st Jul 2009
Location: Inside the box
Posted: 21st Aug 2011 14:01
Link
Would it be possible to change the help file code so that the HOME/BACK/PRINT button group is always in the same place? I use the BACK button a lot and it's inconvenient to have that button group jumping around depending on if there's a LANGUAGE/BASIC/C++ button showing. Maybe just put an invisible spacer if there's no LANGUAGE/BASIC/C++ button?

Back to top
Profile PM Email
MobileCreator
13
Years of Service
User Offline
Joined: 1st Jun 2011
Location: Ottawa - Canada
Posted: 21st Aug 2011 17:21
Link
It would be great if you could make a PDF version of the documentation. It's better to read on tablet, and in sequence.

Talking about sequence, for the Guide section, having a Next button would be great, too.

Thanks

Paulo
Back to top
Profile PM Website
dijster
13
Years of Service
User Offline
Joined: 16th Aug 2011
Location: Sheffield, UK
Posted: 22nd Aug 2011 14:00
Link
There do seem to be a lot of commands missing from the documents.
Global, Select, Case, Function, End, Dim are just a few
I know most of these will be basic commands, but they would still help a new person to programming.
Is there anywhere I can get a full list of all the keywords AGP understands?

Very funny Scotty, Now beam my clothes up!
Back to top
Profile PM
Rich Dersheimer
AGK Developer
15
Years of Service
User Offline
Joined: 1st Jul 2009
Location: Inside the box
Posted: 22nd Aug 2011 14:56 Edited at: 22nd Aug 2011 14:58
Link
Dijster - http://www.appgamekit.com/documentation/language.html has those commands, except for GLOBAL, which is covered elsewhere.

Back to top
Profile PM Email
dijster
13
Years of Service
User Offline
Joined: 16th Aug 2011
Location: Sheffield, UK
Posted: 22nd Aug 2011 16:48
Link
Sorry.
I was looking at the page http://www.appgamekit.com/documentation/Reference/Index.htm
I thought that included all commands, my mistake.
Cheers

Very funny Scotty, Now beam my clothes up!
Back to top
Profile PM
DMXtra
22
Years of Service
User Offline
Joined: 28th Aug 2002
Location: United States
Posted: 23rd Aug 2011 01:39
Link
Elseif is missing from the documentation for sure.

App Game Kit (A.G.K.) - Want to be creative on many platforms at once? This is the tool you need.
Back to top
Profile PM
Rich Dersheimer
AGK Developer
15
Years of Service
User Offline
Joined: 1st Jul 2009
Location: Inside the box
Posted: 23rd Aug 2011 11:01
Link
@DMXtra - http://www.appgamekit.com/documentation/principles/3_common.htm towards the bottom of the page.

Agreed that the help is kind of scattered here and there and sometimes you have to dig around to find what you are looking for.

Back to top
Profile PM Email
DMXtra
22
Years of Service
User Offline
Joined: 28th Aug 2002
Location: United States
Posted: 23rd Aug 2011 13:15
Link
Thanks Rich. When I was looking at the IF statements there was a list and it wasn't in that list. At least from I remember.

But there it is here. hmmm

App Game Kit (A.G.K.) - Want to be creative on many platforms at once? This is the tool you need.
Back to top
Profile PM
Bursar
16
Years of Service
User Offline
Joined: 17th Sep 2008
Location:
Posted: 24th Aug 2011 17:43
Link
There's an error on the page relating to Custom Text: http://www.appgamekit.com/documentation/examples/text/1_custom.htm

It says:
Quote: "
Here's an extract showing how this file should be laid out:
•76:126:25:42

This line matches the ASCII code for the letter A, which is 65 to coordinates 76, 126 on the image and tells us that the letter A is 25 pixels wide and 42 pixels high.
"

The ASCII code for the letter A is missing. The extract should read:
• 65:76:126:25:42
Back to top
Profile PM
Rich Dersheimer
AGK Developer
15
Years of Service
User Offline
Joined: 1st Jul 2009
Location: Inside the box
Posted: 2nd Sep 2011 23:51
Link
Bumpity Bump Bump

Back to top
Profile PM Email
LeeBamber
TGC Lead Developer
24
Years of Service
User Offline
Joined: 21st Jan 2000
Location: England
Posted: 5th Sep 2011 05:11
Link
Hi Guys,

If you find an error in the documentation, we consider this a bug. If you find one, we would be very grateful if you could post it as a bug report in our new issues board here:

http://code.google.com/p/agk/issues/list

The bug report should be detailed enough to show Mike exactly where the error is, and what remedy you feel is required to fix it.

I drink tea, and in my spare time I write software.
Back to top
Profile PM Email Website
Rich Dersheimer
AGK Developer
15
Years of Service
User Offline
Joined: 1st Jul 2009
Location: Inside the box
Posted: 5th Sep 2011 06:25
Link
Lee, do you want each documentation error in a seperate bug report? Or is it okay to put a bunch of them in one report?

Back to top
Profile PM Email
LeeBamber
TGC Lead Developer
24
Years of Service
User Offline
Joined: 21st Jan 2000
Location: England
Posted: 6th Sep 2011 03:50
Link
You can bunch them up in the case of documentation errors, as Mike is pretty quick off the mark when it comes to fixing them in batches

I drink tea, and in my spare time I write software.
Back to top
Profile PM Email Website
synbios128
13
Years of Service
User Offline
Joined: 21st Sep 2011
Location:
Posted: 22nd Sep 2011 00:36
Link
I don't mean to be rude but the examples that come with AppGameKit and the documentation are different in many annoyingly bad ways. If you compare the code in the examples (sprites for example) with the documentation there are countless errors and frankly I don't have time to document them all for correction. I suggest someone sit down for a few hours and make sure the documentation reflects the example code. There is even an instance where a semi colon is used at the end of a line. Seriously. Thanks for your time.
Back to top
Profile PM
Rich Dersheimer
AGK Developer
15
Years of Service
User Offline
Joined: 1st Jul 2009
Location: Inside the box
Posted: 27th Sep 2011 11:14
Link
This should be stickied.

Back to top
Profile PM Email
LeeBamber
TGC Lead Developer
24
Years of Service
User Offline
Joined: 21st Jan 2000
Location: England
Posted: 9th Oct 2011 03:18
Link
I have emailed Mike to see if he can find the issues you refer to, as ideally we want consistency between the published documentation and our examples (which have changed slightly to solve small functional errors). Mike might require some specific examples of typical errors.

I drink tea, and in my spare time I write software.
Back to top
Profile PM Email Website
Mike Johnson
TGC Developer
22
Years of Service
User Offline
Joined: 13th Sep 2002
Location: United Kingdom
Posted: 10th Oct 2011 10:25
Link
synbios128, corrections have been made to several listings. If you come across anything specific that needs fixing please email me: mike@thegamecreators.com.
Back to top
Profile PM Email Website
fifi
18
Years of Service
User Offline
Joined: 9th May 2006
Location: Czech
Posted: 15th Oct 2011 18:52
Link
as anyone already made a pdf of it ?
Back to top
Profile PM
LeeBamber
TGC Lead Developer
24
Years of Service
User Offline
Joined: 21st Jan 2000
Location: England
Posted: 18th Oct 2011 01:59
Link
The AppGameKit documentation is organised as an HTML style help system and there is no DOC/PDF style manual available. Is this something you want to see, and are you looking to print it out, e.t.c? Why a PDF?

I drink tea, and in my spare time I write software.
Back to top
Profile PM Email Website
BatVink
Moderator
21
Years of Service
User Offline
Joined: 4th Apr 2003
Location: Gods own County, UK
Posted: 18th Oct 2011 22:37
Link
A couple of suggestions/requests whilst this thread is still alive.

1. Add a link to the Commands subsection at the end of each page, just like DBPro. This makes it infinitely easier to put a command in context alongside its siblings, if you have clicked through from your code.

2. I've forgotten already, it's been a long day.

Back to top
Profile PM Email
MobileCreator
13
Years of Service
User Offline
Joined: 1st Jun 2011
Location: Ottawa - Canada
Posted: 18th Oct 2011 23:24
Link
Quote: "2. I've forgotten already, it's been a long day."


You made me laugh!

----------
Paulo
http://www.mobilecreators.com
Back to top
Profile PM Website
XanthorXIII
AGK Gold Backer
13
Years of Service
User Offline
Joined: 13th May 2011
Location:
Posted: 18th Oct 2011 23:44
Link
To be honest I'd like to see the document split for Tier 1 and Tier 2 or if possible, make the buttons work so that when I hit Tier 2, only the documentation for Tier 2 shows. I know it's suppose to be fancy but if I have to keep clicking on C++ when switching between commands, it kinda gets annoying.
Back to top
Profile PM
md10bldr2
13
Years of Service
User Offline
Joined: 29th Sep 2011
Location:
Posted: 19th Oct 2011 23:16
Link
One more hand up for a printable version of the documentation. PDF is fine, but a Word version would be even better, because most of the utilities out there for converting HTML files to PDFs do a really poor job of formatting.

Why? Electronics files are good, when you know what you are looking for. They just aren't that conducive to browsing. I normally print out my SW docs, take them down to the FedEx Kinkos, and get them coil bound for $5. They're much easier to thumb through while I'm sitting at the park watching my kids, or otherwise away from the computer.

Thanks
Paul G.
Back to top
Profile PM
XanthorXIII
AGK Gold Backer
13
Years of Service
User Offline
Joined: 13th May 2011
Location:
Posted: 20th Oct 2011 15:41
Link
A kindle version would be cool.
Back to top
Profile PM
MobileCreator
13
Years of Service
User Offline
Joined: 1st Jun 2011
Location: Ottawa - Canada
Posted: 20th Oct 2011 17:00
Link
Hey TGC, based on the requests here, why no provide an alternate HTML with the whole documentation on one page? Maybe one for Basic and another for C++. Of course, if the tool you used to create the documentation allows you to do so with one click....

That way, who wants a PDF can print as PDF, who wants epub or kindle whateverformat could use Calibre or other tool to create it.


Cheers

----------
Paulo
http://www.mobilecreators.com
Back to top
Profile PM Website
Back to top

Login to post a reply

Server time is: 2024-11-22 03:13:59
Your offset time is: 2024-11-22 03:13:59