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
MikeHart
AGK Bronze Backer
20
Years of Service
User Offline
Joined: 9th Jun 2003
Location:
Posted: 20th Jan 2017 21:01
Orvillian wrote: " It's difficult to know whether to show everything or just try and give some kind of brief overview, with the intention of offering more information as the user makes more progress. Not entirely sure what the best approach is."

It all depends who is the target of your tutorial. And what you want to achieve.
Running Windows 7 Home, 64 bit, 8 GB ram, Athlon II X2 255, ATI Radeon HD 4200. Using AGK2 Tier 1.
Orvillian
TGC Developer
8
Years of Service
User Offline
Joined: 8th Feb 2016
Location:
Posted: 23rd Jan 2017 15:27
Orvillian
TGC Developer
8
Years of Service
User Offline
Joined: 8th Feb 2016
Location:
Posted: 24th Jan 2017 14:41
Here's a new guide. This one covers loops - https://www.appgamekit.com/documentation/guides/loops.htm
Scraggle
Moderator
20
Years of Service
User Offline
Joined: 10th Jul 2003
Location: Yorkshire
Posted: 24th Jan 2017 14:55
I think the difference between REPEAT-UNTIL and WHILE-ENDWHILE should be emphasised a lot more.

In that a REPEAT-UNTIL will always execute the code at least one because the conditional check is at the end of the loop but a WHILE-ENDWHILE checks the condition before the loop, so it might not execute at all.
It is mentioned if you read into the descriptions and when you understand what they do, but to a beginner it should have "flashing lights" around it because the difference is the fundamental reason why you would choose one loop over the other.

AGK V2 user - Tier 1 (mostly)
Orvillian
TGC Developer
8
Years of Service
User Offline
Joined: 8th Feb 2016
Location:
Posted: 25th Jan 2017 14:53
A new guide has been uploaded today. This one is about functions, variable scope and branching. You can find it here - https://www.appgamekit.com/documentation/guides/functions_and_branching.htm

Thanks for the feedback about the previous guides. Will get changes made and new versions uploaded.
george++
AGK Tool Maker
16
Years of Service
User Offline
Joined: 13th May 2007
Location: Thessaloniki, Hellas
Posted: 26th Jan 2017 14:48
@Orvillian: Keep up the good work.
Blendman
10
Years of Service
User Offline
Joined: 17th Feb 2014
Location: Arkeos
Posted: 26th Jan 2017 17:17 Edited at: 26th Jan 2017 17:20
Thank you Orvillian, for your guides

About functions, how much parameters can we use ?

Example :
MyFunction(0,1,2,3,4,5,6,7.....,100) ?
AGK2 tier1 - http://www.dracaena-studio.com
Orvillian
TGC Developer
8
Years of Service
User Offline
Joined: 8th Feb 2016
Location:
Posted: 27th Jan 2017 07:50 Edited at: 27th Jan 2017 07:50
Blendman wrote: "About functions, how much parameters can we use ?"

A maximum of 32 parameters are supported.
Orvillian
TGC Developer
8
Years of Service
User Offline
Joined: 8th Feb 2016
Location:
Posted: 30th Jan 2017 14:48
A new guide is available. This one covers arrays - https://www.appgamekit.com/documentation/guides/arrays.htm

It covers most of the functionality for them. In the future another document will explain about things that are not covered in this guide.

The idea is to eventually remove the Principles section of the documentation and replace it with these new guides that are being made.

Any feedback is welcome.
george++
AGK Tool Maker
16
Years of Service
User Offline
Joined: 13th May 2007
Location: Thessaloniki, Hellas
Posted: 30th Jan 2017 16:31
I would like to see how the "insertsorted" method behaves in case where the elements of the array are types.
Scraggle
Moderator
20
Years of Service
User Offline
Joined: 10th Jul 2003
Location: Yorkshire
Posted: 30th Jan 2017 17:31

From the current documentation:
Quote: "When sorting types the first variable of the type will be used to compare elements."
AGK V2 user - Tier 1 (mostly)
Orvillian
TGC Developer
8
Years of Service
User Offline
Joined: 8th Feb 2016
Location:
Posted: 31st Jan 2017 13:58
A new guide is available. This one covers types - https://www.appgamekit.com/documentation/guides/types.htm
Orvillian
TGC Developer
8
Years of Service
User Offline
Joined: 8th Feb 2016
Location:
Posted: 1st Feb 2017 12:44
A few updates have been made today.

The document on if statements now includes how to use select and case - https://www.appgamekit.com/documentation/guides/if_statements.htm

The comments guide shows all the ways of dealing with comments - https://www.appgamekit.com/documentation/guides/comments.htm

An extra section has been added into arrays to show how multidimensional arrays are used and also how to pass them into functions - https://www.appgamekit.com/documentation/guides/arrays.htm
Blendman
10
Years of Service
User Offline
Joined: 17th Feb 2014
Location: Arkeos
Posted: 1st Feb 2017 13:01
Great ! Thanks Orvillian.
AGK2 tier1 - http://www.dracaena-studio.com
Blendman
10
Years of Service
User Offline
Joined: 17th Feb 2014
Location: Arkeos
Posted: 4th Feb 2017 13:31
@Orvillian : do you think you will add a skeleton example or guide to knwo how :
- to use this lib : create a skeleton and some bones, attach a sprite to a bone, do transformation animation... ?
- how to import a spriter file ?
AGK2 tier1 - http://www.dracaena-studio.com
Scraggle
Moderator
20
Years of Service
User Offline
Joined: 10th Jul 2003
Location: Yorkshire
Posted: 4th Feb 2017 13:57
^^^ What he said!

Tutorials for new users that introduces them to the basics are, of course, essential but tutorials for more advanced topics like that would be very welcome for more advanced users. And also give the new user something to aim for.
AGK V2 user - Tier 1 (mostly)
Orvillian
TGC Developer
8
Years of Service
User Offline
Joined: 8th Feb 2016
Location:
Posted: 6th Feb 2017 08:04
I feel as though the Getting Started section is now quite reasonable, at least for Tier 1. At some point I need to create more documentation about using Tier 2. I also need to cover the export process for both Tiers. Before doing that I'm going to try writing a few intermediate / advanced tutorials. Please let me know if you have any suggestions.

Blendman wrote: "@Orvillian : do you think you will add a skeleton example or guide to knwo how :
- to use this lib : create a skeleton and some bones, attach a sprite to a bone, do transformation animation... ?
- how to import a spriter file ?"


This would make for a good tutorial. I have added it to my list.
Blendman
10
Years of Service
User Offline
Joined: 17th Feb 2014
Location: Arkeos
Posted: 6th Feb 2017 15:02
@Orvillian : Thanks

Some ideas for tutorials :
- Physics : how to use joint
- sprites (& physics for some) : movement (move to an object/mouse, follow a path, avoid obstacle, slide again obstacle)
- sprite shader (with some examples)
- screenshaders
- 3D : third person, physics & character, raycast...
- Lan/internet : how to use a php webpage, for a server/client connexion
- how to use : advert,iap,admob, google gamecenter...
AGK2 tier1 - http://www.dracaena-studio.com
SpecTre
Developer
21
Years of Service
User Offline
Joined: 24th Feb 2003
Location: UK
Posted: 6th Feb 2017 15:07
Looks like a good list, think it will keep you busy for a while Mike
The Amiga and Amos were great!
george++
AGK Tool Maker
16
Years of Service
User Offline
Joined: 13th May 2007
Location: Thessaloniki, Hellas
Posted: 7th Feb 2017 05:28
Quote: "- Lan/internet : how to use a php webpage, for a server/client connexion"

+1
Blendman
10
Years of Service
User Offline
Joined: 17th Feb 2014
Location: Arkeos
Posted: 7th Feb 2017 07:20
Hi Orvillian.

Yesterday, I have tested an amazing feature with AppGameKit, which seems not to be documented :
- create an application for macOs, directly with Windows.

I think you could add this in the documentation, because it's really interesting for those who are on windows (I think it's the same for mac users to create windows App, and it should be work for linux too I guess). I know it's not the way we should create an app for MAc, but for those who want to distribute their game for mac event if they haven't a mac, it could be a solution .

Here is the process :
- copy the AppGameKit Player 2.app (agk\player\mac\AGK Player 2.app.zip)
- rename it as you want (example : MyGame.app).
- Open the *.app and paste the media folder of your window game (with bytecode.byc)
- copy and paste the application MyGame.app to the mac
- On the mac, you can now execute the app and it works !



I guess It probably works for linux too.
AGK2 tier1 - http://www.dracaena-studio.com
Orvillian
TGC Developer
8
Years of Service
User Offline
Joined: 8th Feb 2016
Location:
Posted: 7th Feb 2017 10:34
Blendman wrote: "Some ideas for tutorials :
- Physics : how to use joint
- sprites (& physics for some) : movement (move to an object/mouse, follow a path, avoid obstacle, slide again obstacle)
- sprite shader (with some examples)
- screenshaders
- 3D : third person, physics & character, raycast...
- Lan/internet : how to use a php webpage, for a server/client connexion
- how to use : advert,iap,admob, google gamecenter..."


Lots of good ideas here.

There are some old examples showing joints here - https://www.appgamekit.com/documentation/examples.html. Do you think these need to be expanded upon with more detail?

For the sprite movement I could show something like a sprite following a spline. Would that be interesting?

With the sprite shader maybe I could show some simple usage of a shader, for example, simple recolouring or some kind of blending.

I will write guides showing adverts, in app purchase and GameCenter as I feel like these areas are lacking. If there's at least a working example it gives someone something to experiment with.

Today I have written a Facebook guide that can be found here - https://www.appgamekit.com/documentation/guides/facebook.htm.

Blendman wrote: "Yesterday, I have tested an amazing feature with AppGameKit, which seems not to be documented :
- create an application for macOs, directly with Windows."


Thanks for the information. I will test that out and add it to the documentation.
CJB
Valued Member
20
Years of Service
User Offline
Joined: 10th Feb 2004
Location: Essex, UK
Posted: 9th Feb 2017 13:35
Publishing for iOS guide would be extremely handy. I keep reading lots of conflicting information in an attempt to find some help on the subject (such as "AGK only needs one distribution profile"... then on the Apple dev site "Games that make use of Game Centre require their own profile")... a really comprehensive guide, possibly with video would be amazing (I'm not an Apple user, so even learning how to right click was a mission!). Cover the use of testflight and actually pushing a app live.



Orvillian
TGC Developer
8
Years of Service
User Offline
Joined: 8th Feb 2016
Location:
Posted: 13th Feb 2017 12:17
I have updated the iOS guide for Tier 1. You can find it here - https://www.appgamekit.com/documentation/guides/52_ios.htm. It goes into a little more detail about the steps needed to publish on iOS.
CJB
Valued Member
20
Years of Service
User Offline
Joined: 10th Feb 2004
Location: Essex, UK
Posted: 13th Feb 2017 16:44
Now we're talking! Great work Orvillian. Thanks for your work on these.
Orvillian
TGC Developer
8
Years of Service
User Offline
Joined: 8th Feb 2016
Location:
Posted: 13th Feb 2017 16:56
CJB, have you had found the guide has been able to clear up any questions you had on exporting to iOS? Do you feel as though it needs any additional information?
Orvillian
TGC Developer
8
Years of Service
User Offline
Joined: 8th Feb 2016
Location:
Posted: 20th Feb 2017 12:35
A new guide has been released today. This one covers the basics of in app purchases - https://www.appgamekit.com/documentation/guides/iap.htm
damothegreat
User Banned
Posted: 20th Feb 2017 12:58
Awesome...


Will be a really good read

Thanks

Scraggle
Moderator
20
Years of Service
User Offline
Joined: 10th Jul 2003
Location: Yorkshire
Posted: 20th Feb 2017 13:00
Very useful!
Thank you
AGK V2 user - Tier 1 (mostly)
Blendman
10
Years of Service
User Offline
Joined: 17th Feb 2014
Location: Arkeos
Posted: 20th Feb 2017 14:27
Great !
Thank you Orvillian
AGK2 tier1 - http://www.dracaena-studio.com
PSY
Developer
7
Years of Service
User Offline
Joined: 3rd Jul 2016
Location: Laniakea Supercluster
Posted: 20th Feb 2017 22:30
Awesome...thanks !!
PSY LABS Games
Coders don't die, they just gosub without return
Harlequin
14
Years of Service
User Offline
Joined: 22nd Mar 2010
Location: Melbourne (AU)
Posted: 21st Feb 2017 11:30
These guides are looking great (and have some nice clear information in them . Awesome job Orvillian!
It\'s late, I\'m tired, out of coffee and now I\'m wet.
PSY
Developer
7
Years of Service
User Offline
Joined: 3rd Jul 2016
Location: Laniakea Supercluster
Posted: 21st Feb 2017 23:13
There's a bug in the description for AddParticlesScaleKeyFrame

time - The time that particles should become this color.

Should say 'size' instead of 'color'


L8er,
PSY
PSY LABS Games
Coders don't die, they just gosub without return
Scraggle
Moderator
20
Years of Service
User Offline
Joined: 10th Jul 2003
Location: Yorkshire
Posted: 22nd Feb 2017 08:04
This page is very outdated and could definitely benefit from an overhaul:
https://www.appgamekit.com/documentation/guides/device_resolutions.htm
AGK V2 user - Tier 1 (mostly)
Increase
7
Years of Service
User Offline
Joined: 21st Feb 2017
Location:
Posted: 1st Mar 2017 09:26 Edited at: 1st Mar 2017 09:44
The syntax, structure and commands of a language have to be explained in a short, but still clear and complete manner.
Every command has to be covered. Small examples serve the perspicuity.

This seems to be the case at the AGK.

Actually the documentation, the explanation of the syntax, structure & commands on the AppGameKit page is one of the main reasons why i chose to purchase it.

So, from my Point of view - no Need to improve the way the language is explained - but being expanded with commands & Features.

I hope for many additional commands & features in the future.
Orvillian
TGC Developer
8
Years of Service
User Offline
Joined: 8th Feb 2016
Location:
Posted: 6th Mar 2017 09:54
A new guide is available. This one covers expansion files - https://www.appgamekit.com/documentation/guides/expansion_files.htm. This is only a short guide. Will hopefully help to clear up some questions about expansion files on Android.
Blendman
10
Years of Service
User Offline
Joined: 17th Feb 2014
Location: Arkeos
Posted: 6th Mar 2017 13:05
Great !
Thank a lot, it will be very usefull.
AGK2 tier1 - http://www.dracaena-studio.com
Quell Dieu
7
Years of Service
User Offline
Joined: 8th Feb 2017
Playing: Genres: Action, MOBA, FPS, Fighting, TBS, RTS, Puzzle.
Quell Dieu
7
Years of Service
User Offline
Joined: 8th Feb 2017
Playing: Genres: Action, MOBA, FPS, Fighting, TBS, RTS, Puzzle.
blink0k
Moderator
11
Years of Service
User Offline
Joined: 22nd Feb 2013
Location: the land of oz
Posted: 14th Mar 2017 22:14 Edited at: 14th Mar 2017 22:15
I'm not sure if this is the right place but GetDeviceHeight/Width does not mention that it returns the window's height/width rather than the device width/height on windows (and ios i imagine).
ps: is it possible to make the documentation wiki style where users could make changes and then approved/published by TGC
Eqqman
8
Years of Service
User Offline
Joined: 15th Jul 2015
Location:
Posted: 15th Mar 2017 09:45
Quote: "I feel as though the Getting Started section is now quite reasonable, at least for Tier 1. At some point I need to create more documentation about using Tier 2. I also need to cover the export process for both Tiers. Before doing that I'm going to try writing a few intermediate / advanced tutorials. Please let me know if you have any suggestions. "

Please create a page for getting Tier 2 development on Linux. The closest the website comes to is this link:

https://www.appgamekit.com/documentation/guides/25_android.htm

At the top it states "However, it can be used on Linux with some adjustments", but gives no explanation on how to do those, users are left to figure it out, and some users (like myself) don't have this knowledge.

Other Tier 2 pages are incomplete. For example, the Windows development page (now over 2 years old) ends with "Click on Debug > Start Debugging (or just press F5) to run your project!" I presume this just runs the app in the Windows environment itself. How then do you test on your mobile device? The guide doesn't say.
Goo Goo G\'Joob!
Jambo B
14
Years of Service
User Offline
Joined: 17th Sep 2009
Location: The Pit
Posted: 16th Apr 2017 17:18
These guides will be really useful for people just learning the language, and for 'old salts' like me, who may have missed something along the way!

Can I suggest an addition to the Variables guide? Information about the ranges of each type would be useful, e.g. what are the maximum and minimum values for an integer, and what happens if we +1 to an integer which is already at the max value? How long can a string be?

This information could be added to each type's section, or as a separate 'Ranges' section at the end.

Just a thought!

James
Jerry McGuire
7
Years of Service
User Offline
Joined: 25th Mar 2017
Location:
Posted: 24th May 2017 18:13
I suggest including the feasible range for inputs. For example, I had to figure out by myself that the maximum frequency for Particle Emitters is 500. It would be nice if this appeared on the documentation of the corresponding function.
Just a suggestion,
iMac Book Pro
MacOs 10.12.4
Xcode 8.3.2

iPhone 6, iOS 9.35
tigme
6
Years of Service
User Offline
Joined: 14th Jun 2017
Location: Kleinmond
Posted: 6th Jul 2017 13:45
Would be good if the documentation had some "see also" breadcrumbs at the bottom like you get on PHP.net for related commands. For a beginner, it would be helpful because sometimes there are relations that are not highlighted by the command index.
Increase
7
Years of Service
User Offline
Joined: 21st Feb 2017
Location:
Posted: 4th Aug 2017 21:13
I suggest removing the note from the documentation, that SetRawWritePath() is deprecated, because it's the only option to create a folder with Makefolder() outside of the default pathes, as Setfolder doesn't seem to work with "raw:".

I first dismissed the SetRawWritePath() command, because of the "deprecated" entry - then tried it out of lack of alternatives - and it works.
SirRolo
8
Years of Service
User Offline
Joined: 24th Mar 2016
Location:
Posted: 9th Aug 2017 22:47
I have downloaded the tutorial book and got the 2 big asset paks. They come with a lot of examples but a better explanation on where to find the media for the tutorials would be extremely helpful. Also, what the heck is a tween, I looked all over the help online and the programs and there is no description of what a tween actually is.
Mobiius
Valued Member
21
Years of Service
User Offline
Joined: 27th Feb 2003
Location: The Cold North
Posted: 10th Aug 2017 08:48
Tween.

Allows you to interpolate beTWEEN two different states.
Signature removed by mod because it's larger than 600x120... please resize and try again.

Login to post a reply

Server time is: 2024-04-20 13:56:04
Your offset time is: 2024-04-20 13:56:04