Can Gideros API Auto-complete on ZeroBrane Studio?

sslivka · June 2013

Hi Guys.
Can Gideros API Auto-complete on ZeroBrane Studio?

ar2rsawseen · June 2013

If ZeroBrane could use this Gideros annotation:
http://docs.giderosmobile.com/reference/autocomplete.php

sslivka · June 2013

@ar2rsawseen, thanks, but how to connect it to the ZeroBrane Studio?

paulclinger · June 2013

@sslivka, yes, when you select Gideros as the interpreter in ZBS ("Project | Lua Interpreter | Gideros"), you should get autocomplete for Gideros API calls.

For example, typing "application." will give you a list of methods for the "application" object and if you then select one and type "(" you get a tooltip with method descriptions. Is it not working for you? What version of ZBS are you using?

sslivka · June 2013

@paulclinger, I using ZBS version 0.37, and it has autocomplete for Gideros API, but it does not support auto-completion for the methods of the parent classes, for example if I write:
local bm = Bitmap.new()
bm:
I do not get the Sprite class methods, but Bitmap class inherits Sprite class.
And how to make auto-completion of variable names?
Can you add stage global variables, an object of class Sprite?
Thank You.

paulclinger · June 2013

@sslivka, this fragments works for me:

local bm = Bitmap.new()
bm:

I do get 5 methods in auto-complete list (including setAnchorPoint and getAnchorPoint). The current implementation doesn't support inheritance between classes in the API; this has already been requested and may be included in the next version.

I did find a couple of issues with Gideros API; the auto-complete was not suggested until you type at least one "." or ":". I already fixed that and also updated the API description with the latest version available from the link that @ar2rsawseen referenced. It should be checked in later today.

> And how to make auto-completion of variable names?

Do you mean auto-complete for variable names you used elsewhere in your scripts (for example, you already typed "abcdef" and want it to be suggested after you type "ab") or do you mean auto-complete after "bm:" as in your example?

The former is enabled using "dynamic words" and the latter should already work.

> Can you add stage global variables, an object of class Sprite?

What do you mean by "stage global variables"?

As I said, inheritance is not supported, but what you can do though is to modify api/lua/gideros file to copy methods from Sprite class to Bitmap class before returning the auto-complete data.

Is there any information on what classes inherit what other classes in Gideros?

sslivka · June 2013

@paulclinger,
- What do you mean by "stage global variables"?
sorry, I mean global variable "stage" which is object of Sprite class.

In @ar2rsawseen link (http://docs.giderosmobile.com/reference/autocomplete.php) it does not describe the class inheritance. This can be seen here http://giderosmobile.com/docs/refmanual/reference_manual.html
For example Bitmap class inherits from Sprite class:

sslivka · June 2013

@ar2rsawseen , why in the http://docs.giderosmobile.com/reference/autocomplete.php does not describe the "Gyroscope.new()" method?
that's all there is:
Gyroscope
Gyroscope.isAvailable()
getRotationRate()
start()
stop()

ar2rsawseen · June 2013

@sslivka because Gyroscope does not have new method it can't create new instances, it has only one instance gyroscope, same for Application and lots of plugin classes.
At least I thought it was this way, let me check.

@paulclinger would it help if this automatically generated autocomplete.php would also list inherited methods?

sslivka · June 2013

@ar2rsawseen, but:
http://giderosmobile.com/docs/refmanual/reference_manual.html#Gyroscope
say:
local gyroscope = Gyroscope.new()
gyroscope:start()

ar2rsawseen · June 2013

Ok yes, there is new method, sorry let me fix that

ar2rsawseen · June 2013

Fixed, for Geolocation, Gyroscope and Accelerometer, thanks for the tip

sslivka · June 2013

@ar2rsawseen , Wow, quickly!
thank you

paulclinger · June 2013

@sslivka, thanks for the ref to the inheritance information.

@ar2rsawseen, thank you for the prompt update; no, I wouldn't want the methods to be copied from the inherited class and would prefer to mark the class as "inherited" in my API descriptions.

BTW, I have been processing the new description with my script and noticed several other issues with descriptions that didn't exist in the previous version of the documentation I have. I'm attaching the diff file; in most cases the old description (marked with -) is the correct one with two exceptions: "sprite's coordinates" has incorrect Unicode character (can you change it to '?) and "force" is used in stead of "torque" (I marked those instances). Can you fix these issues? Thank you.

ar2rsawseen · June 2013

@paulclinger thank you I think I've fixed them all

BTW, I can also try to provide rest API for Gideros docs, about objects, methods and inheritance, etc, just let me know what you need

paulclinger · June 2013

@ar2rsawseen: looks good; updated.

In terms of rest API: do you mean providing a way to query additional information using URLs like "http://giderosmobile.com/API/Accelerometer/getAcceleration"? It may be interesting, but I think it's an overkill for now

It would be useful to include inheritance information in a text form in your autocomplete file:

Bitmap > Sprite
TexturePack > TextureBase
and so on.

It would also be useful to have a list of global variables that are present in the environment (like "application", "stage", "world" and so on) as I could also add them to the auto-complete list). Are there any in addition to these three? What are the methods of the "stage" variable?

Also, does StoreKit have "new" method as well?

ar2rsawseen · June 2013

@paulclinger most plugins don't have .new method and thus have autoinstance. I've added them to auto complete.

And I've also added inheritance as you've specified

But all of that is in automated manner, so there may still be some errors

sslivka · June 2013

@paulclinger, Where to try it? On github.com?

@paulclinger, @ar2rsawseen, thank you guys!

paulclinger · June 2013

@sslivka, yes, pushed the changes to github: https://github.com/pkulchenko/ZeroBraneStudio (master branch). The current API should have all the recent updates from @ar2rsawseen as well as couple of fixes I made. Let me know if you run into any issues with it.

Thanks @ar2rsawseen; I'll take a look at handling inheritance in the auto-complete logic...

gmarinov · June 2013

wish someone would make the same for Sublime Text ..

paulclinger · June 2013

> local bm = Bitmap.new()
> bm:
> I do not get the Sprite class methods, but Bitmap class inherits Sprite class.

@sslivka, @ar2rsawseen, I pushed the changes that implement inheritance in auto-complete (https://github.com/pkulchenko/ZeroBraneStudio), so the fragment above should work now. Give it a try.

sslivka · June 2013

@paulclinger, Okay, class inheritance works, but

not good.

In my "gideros.lua" I just copy and paste the common methods of Bitmap and Sprite,
and methods for the point (Bitmap.new (texture)) determined the type "type =" function "", and for methods with a colon (Bitmap: setAnchorPoint (x, y) ) - "type =" method "".

But it is still better than it was before

paulclinger · June 2013

@sslivka, good point, I should eliminate the duplicates.

I didn't quite get your comment about "method". Do you mean that all the function (except "new") should really have "method" type? I think it's a good idea, I can update that...

sslivka · June 2013

@paulclinger
>I didn't quite get your comment about "method". Do you mean that all the function (except "new") should really have "method" type? I think it's a good idea, I can update that...

No, I think you not understand me. I mean that in Gideros API there are class methods that are called by a dot (.) and colon (:), for example:

--with colon:
Bitmap:getAnchorPoint()
Accelerometer:start()
 
--with dot:
Bitmap.new(texture)
Accelerometer.isAvailable()

and in my "ZeroBraneStudio\api\lua\gideros.lua" I write:

Accelerometer = {
  childs = {
   isAvailable = {
    type = "function"
   },
   start = {
    type = "method"
   }
  },
 },
Bitmap = {
  childs = {
   getAnchorPoint = {
    type = "method"
   },
   new = {
    type = "function"
   },
  },
},

paulclinger · June 2013

@sslivka, yes, this is how I understood it, so we are on the same page

.

The challenge is to figure out which functions are "functions" and which are "methods". It seems like "new" and "is*" should be "functions" and the rest are "methods", right?

sslivka · June 2013

not only, for example:

paulclinger · June 2013

Right, got it. So, looking at the auto-complete description for Event:

Event.new(type) Event - creates a new Event object
getTarget() Event - returns the element on which the event listener was registered
getType() Event - returns the type of Event
stopPropagation() Event - stops the propagation of the current event in the scene tree hierarchy

The first one would be "function", but the rest would be registered as "method" (so they are offered after "event:" is typed).

@ar2rsawseen, in general, everything that has Class.function is a "function", but functions that don't include class name are "methods", correct? I'm ignoring "values" for now as those are already handled...

ar2rsawseen · June 2013

@paulclinger if you are talking about autocomplete.php then yes, all class functions are passed as ClassName.function() while methods are passed as method() ClassName

But you may suggest other way to separate them

paulclinger · June 2013

@sslivka, both of the issues should be fixed: removed duplicates and separated functions from methods. Let me know if you notice anything else that may be wrong.

@ar2rsawseen, the way it is now in the docs is fine; it was a short update to the script to separate functions from methods.

paulclinger · June 2013

@sslivka, let me know if you had a chance to try the latest version that removed the duplicates and added proper handling of methods. I'm packaging a new release and want to make sure Gideros auto-complete API is working as expected. Thanks!

ianchia · June 2013

@paulclinger - if you're creating a new release, might I humbly suggest that the Mac release gets a more thorough check? Last time I looked it had a bunch of references to C:\Program Files and various samples were broken. I still can't work out how to do remote debugging on a device - I'm not interested in using ZBS for the Gideros local player as my builds rely heavily on Obj-C plugins that only function on a device or the Xcode simulator, hence triggering the Gideros Player for debugging is not useful.

I would like to offer some time to help you track down the Mac package issues if you don't have handy access to a Mac, but I would *love* to get the remote debugging working on a device.

Many thanks.

Best,

- Ian

Howdy, Stranger!

Categories

In this Discussion

Top Posters

Can Gideros API Auto-complete on ZeroBrane Studio?

Comments

Howdy, Stranger!

Quick Links

Categories

In this Discussion

Top Posters

Can Gideros API Auto-complete on ZeroBrane Studio?

Comments