New Gideros Docs/Wiki...

oleg

For me as non-English, there is a traditional and understandable type name:

"examples and game templates"

in terms of SEO - better use the words: examples , templates, source code
the words 'sample, snippet ' are less popular in non-English speaking world

MoKaLux

ok new section added:
https://wiki.giderosmobile.com/index.php/Welcome!
Under Advanced: Examples (AKA Gideros Forum Gems)

feel free to add some gems!

Apollo14

@MoKaLux there's Github section "Awesome Gideros", probably there is some useful stuff:
https://github.com/stetso/awesome-gideros

MoKaLux

@Apollo14 ok, you win!

This is awesome stuff!

I don't know how I am going to handle all this?! Piece by piece I guess but this is HUGE, 10 years of awesome stuff condensed into the wiki!? Is this even possible?

Thank you very much for this, I am going to make it digestible for gideros newbies like me!

Have fun @Apollo14

MoKaLux

the wiki has some gems! check this one out: https://wiki.giderosmobile.com/index.php/Examples#CHECK_POINT_IN_POLYGON_.40atilim

and this one while we are at it: https://wiki.giderosmobile.com/index.php/Examples#CIRCULAR_PROGRESS_.40hgy29

Just create an empty project copy/paste the code and voilà.

Have fun!

Apollo14

wow this page with examples is pretty nice!

MoKaLux

I have found another gem:



But I have two problems:
1- I don't know how I can put it in the wiki because the class is 300+ lines of code, I don't think that it fits in the gideros gems section. So where do I put this gem then?

2- the class is perfect but one think is missing: scrolling with the mouse wheel. Do you have some hints of where I could add it?

GitHub project:
https://wiki.giderosmobile.com/index.php/UI_Scrollable_List

Thank you in advance for your help.

Apollo14

Wow the class you found is awesome Just what I need for my current project.

1- I don't know how I can put it in the wiki because the class is 300+ lines of code, I don't think that it fits in the gideros gems section. So where do I put this gem then?

Imo it would be good to at least leave a link to github project (btw it's more convenient if you keep raw lua files on github, without zip archive)

2- the class is perfect but one think is missing: scrolling with the mouse wheel. Do you have some hints of where I could add it?

There's 'Layout' class also, pretty powerful. Probably 'Layout' class supports mouse wheel scrolling (I've never tested).

MoKaLux

ok thanks, I will put the raw files on GitHub and then check the layout class.

MoKaLux

has anybody ever used the clipper plugin?

I cannot find any example (I would like to add it to the wiki). The only page I found is the html file in the gideros installation folder (or this GitHub page: https://github.com/gideros/gideros/blob/master/plugins/clipper/apireference.html)

An example would be nice so I can add it to the wiki plugin page. Thank you for your time.

+1 more: the map plugin is it still working for you? I have compiled the project that comes with gideros but a long list of errors popped out!

Apollo14

I've no idea what clipper is, some top secret stuff
It would be interesting to know! I guess we should ask @hgy29

oleg

/******************************************************************************* * * * Author : Angus Johnson * * Version : 5.1.6 * * Date : 23 May 2013 * * Website : <a href="http://www.angusj.com" rel="nofollow">http://www.angusj.com</a> * * Copyright : Angus Johnson 2010-2013 * * * * License: * * Use, modification & distribution is subject to Boost Software License Ver 1. * * <a href="http://www.boost.org/LICENSE_1_0.txt" rel="nofollow">http://www.boost.org/LICENSE_1_0.txt</a> * * * * Attributions: * * The code in this library is an extension of Bala Vatti's clipping algorithm: * * "A generic solution to polygon clipping" * * Communications of the ACM, Vol 35, Issue 7 (July 1992) pp 56-63. * * <a href="http://portal.acm.org/citation.cfm?id=129906" rel="nofollow">http://portal.acm.org/citation.cfm?id=129906</a> * * * * Computer graphics and geometric modeling: implementation and algorithms * * By Max K. Agoston * * Springer; 1 edition (January 4, 2005) * * <a href="http://books.google.com/books?q=vatti+clipping+agoston" rel="nofollow">http://books.google.com/books?q=vatti+clipping+agoston</a> * * * * See also: * * "Polygon Offsetting by Computing Winding Numbers" * * Paper no. DETC2005-85513 pp. 565-575 * * ASME 2005 International Design Engineering Technical Conferences * * and Computers and Information in Engineering Conference (IDETC/CIE2005) * * September 24-28, 2005 , Long Beach, California, USA * * <a href="http://www.me.berkeley.edu/~mcmains/pubs/DAC05OffsetPolygon.pdf" rel="nofollow">http://www.me.berkeley.edu/~mcmains/pubs/DAC05OffsetPolygon.pdf</a> * *

http://www.angusj.com/delphi/clipper/documentation/Docs/Overview/_Body.htm

MoKaLux

@oleg yes I have seen this page. Thank you. I'll try to figure out how it works in gideros.

MoKaLux

MoKaLux said:

I have found another gem:
But I have two problems:
1- I don't know how I can put it in the wiki because the class is 300+ lines of code, I don't think that it fits in the gideros gems section. So where do I put this gem then?

I have added a new gideros wiki category: Creating UI in Gideros

Feel free to add your own UI (especially buttons as I have read that some have better buttons class).

Viva Gideros.

PS1: @SinisterSoft I have also merged the stores category into a sub category (under exporting). As I have merged all the stores into one page, the old pages (which only contained 1 sentence) should be deleted but I don't have this permission yet!

Apollo14

uh, monkeycoding interfaces is such a pain in the butt...

I was curious if humanity invented something better, checked what they have in aaa industry, in ue4... nope, no silver bullets, it seems that interfaces will stay painful forever

Btw is Layout class 100% working now? Nothing got broke after series of Gideros updates?

MoKaLux

I have to look at layout class again, but last time I checked I read that you cannot use it with scenemanager.
I am going to have another look at it and see if I put it in the wiki.

SinisterSoft

@MoKaLux Great work with the docs. I planned to add pages for each of the stores to deal with some of the stuff like how to register, how to upload, etc... that's why they went to their own pages. I've made a slight edit to your version so that there is still a way to do that in the future - but also gives your nicer direct link too.

hgy29

Apollo14 said:

I was curious if humanity invented something better, checked what they have in aaa industry, in ue4... nope, no silver bullets, it seems that interfaces will stay painful forever

Actually I have been using a nice UI editor called JFormDesigner for years now for my Java projects. It makes it really easy to build UI for Swing. I still hope to be able to use it with gideros at some point, thanks to the grid layout system in core gideros.

MoKaLux

@SinisterSoft thank you.

I have added another category: CREATING A GAME IN GIDEROS where I put scenemanager and easing for now. I may add some more stuff to this later.

MoKaLux

added a new sub category to creating a game in gideros: Mobile Controls

https://wiki.giderosmobile.com/index.php/Special:MyLanguage/Mobile_Controls

Feel free to modify it.

rrraptor

Seems like Main_API page is mising CompositeFont.
TTFont.new() page says "filtering: (boolean, default = false)", but i can use numbers.

MoKaLux

can somebody please delete this page from the wiki?
https://wiki.giderosmobile.com/index.php/Accelerometer/Accelerometer.isAvailable
DONE
I did some tests to improve the wiki usability.

Thank you!

MoKaLux

@all I think I found a nice way to navigate through the wiki

using this command at the end of every wikitexts:
{{Special:PrefixIndex/Accelerometer}}
https://www.mediawiki.org/wiki/Help:Subpages

please have a look and tell me what you think: https://wiki.giderosmobile.com/index.php/AlertDialog.new

I only did the first two functions. More to come if you agree.
PS: please don't forget my previous post as well please! DONE thank you sinistersoft

rrraptor

MoKaLux said:

please have a look and tell me what you think: https://wiki.giderosmobile.com/index.php/AlertDialog.new

Better than it was before

Also:

Dublicated methods and empty "Constants"


P.S. Im using Dark reader extesion for chrome, so 95% of sites im using are dark

MoKaLux

@rrraptor duplicated methods because you are on the main function class.
I can remove it from the main function and leave it only on the methods.

+ empty constants means that it's not applicable for this function.

Some more feedback please

MoKaLux

let's be honest: we cannot handle translation, gideros is too huge!!!
shall I delete all the translate tag in the wiki?
One of many advantage would be that the message "some tags are not marked for translation"

GOOD DOCUMENTATION IS CRUCIAL! Let's do it

oleg

MoKaLux said:

let's be honest: we cannot handle translation, gideros is too huge!!!
shall I delete all the translate tag in the wiki?
One of many advantage would be that the message "some tags are not marked for translation"

GOOD DOCUMENTATION IS CRUCIAL! Let's do it

I can completely translate the gideros API into Ukrainian if the wiki has tools for it. This is not so much.

keszegh

translation of the api might be doable, but i doubt it is useful to anyone, only very basic english is needed to read it, which is anyhow needed to 'understand' lua/gideros programming.

oleg

keszegh said:

translation of the api might be doable, but i doubt it is useful to anyone, only very basic english is needed to read it, which is anyhow needed to 'understand' lua/gideros programming.

I do not use english, for reading api, i always use translation

Moreover, translation will help the site index the search engines for other countries

SinisterSoft

I think the translation is very useful - especially for younger coders who may not be fluent in English.