New Gideros Docs/Wiki...

oleg · November 2020

MoKaLux said:
what is this?
http://giderosmobile.com/profiles

Previously you could place your games on the Gideros website, http://giderosmobile.com/apps

Is a page of developers who posted their games http://giderosmobile.com/profiles

My page is there too

http://giderosmobile.com/profiles/cob-mobile-apps-indie-developer-Український-розробник

MoKaLux · November 2020

oleg this page has become something else than gideros developers page

ps: the link to your web is broken

oleg · November 2020

MoKaLux said:

ps: the link to your web is broken

Problem in your browser, everything works for me http://surl.li/hoet

keszegh · November 2020

yes, it seems to be polluted beyond recognition.

MoKaLux · December 2020

what is this new Event?

else if (type == GAPPLICATION_TEXT_INPUT_EVENT)

https://github.com/gideros/gideros/blob/master/luabinding/luaapplication.cpp
line 800

As far as I understand it seems to be linked to setClipboard and getClipboard but that's it

How would one use this new Event please?

PS: I have updated the wiki quite a bit, it's the last method missing in the application class (I think)

hgy29 · December 2020

It isn’t linked to clipboard, but to android text editing, used in conjunction with application:setTextInput() (https://github.com/gideros/gideros/blob/master/libgid/src/android/platform-android.cpp#L76) it allows to receive android text editor changes notifications.

MoKaLux · December 2020

Thank you hgy29.

But I don't get it

it's not an event then?

I can write:

application:setTextInput(1, "hello")

Have no clue what it does

~~Nevermind I leave those for now, will check another day.~~

EDIT: I think I get it

local textInputDialog = TextInputDialog.new("title", "message", "some text", "Cancel", "OK")
--textInputDialog:setText("hello")
--application:setTextInput(1, "hello")
 
local function onComplete(event)
	print(event.text, event.buttonIndex, event.buttonText)
	application:setTextInput(1, event.text) -- HERE IT IS
end
textInputDialog:addEventListener(Event.COMPLETE, onComplete)
textInputDialog:show()
 
local function testEvent(event)
	print(event.text) -- AND IT IS NOW IN THE CLIPBOARD
end
stage:addEventListener(Event.TEXT_INPUT, testEvent) -- IT'S A STAGE EVENT!

Correct?

Tested on android WORKS
Tested on desktop NOT WORKING so as stated above that's only for android devices.

MoKaLux · December 2020

Another test:

local textInputDialog = TextInputDialog.new("title", "message", "some text", "Cancel", "OK")
 
local function onComplete(event)
	print(event.text, event.buttonIndex, event.buttonText)
	application:setTextInput(2, event.text) -- I THINK I AM MISSING THE POINT HERE!
end
textInputDialog:addEventListener(Event.COMPLETE, onComplete)
textInputDialog:show()
 
local function testEvent(e)
	print(e.type, e.text, e.selectionStart, e.selectionEnd)
end
stage:addEventListener(Event.TEXT_INPUT, testEvent) -- Event attached to stage? is it supposed to be real time?

hgy29 · December 2020

It is intended to create editable text fields in Gideros: you show the keyboard with application:setKeyboardVisibility(), you register Event.TEXT_INPUT events, and you set up the IME with a call to application:setTextInput(mode,"Initial text",initial selection start,initial selection end).

mode is a bitfield indicating the kind of input expected (numerical, date, etc), android will select an appropriate keyboard depending on the mode. Accepted values are defined here: https://github.com/gideros/gideros/blob/master/luabinding/applicationbinder.cpp#L117, for example Application.TEXTINPUT_CLASS_PHONE if you want the user to enter a phone number.

The TEXT_INPUT event sends you the whole modified text instead of individual key presses. It handles input suggestions/completion as well as microphone input. I plan to add similar functionality for iOS at some point

MoKaLux · December 2020

thank you hgy29, I will need to test it on a device and then update the wiki.

MoKaLux · December 2020

wonderful I got it working thank you hgy29

application:setKeyboardVisibility(true)
application:setTextInput(application.TEXTINPUT_CLASS_NUMBER, "1234", 1, 4)
local function tiEvent(e)
	print(e.type, e.text, e.selectionStart, e.selectionEnd)
end
--application:addEventListener(Event.TEXT_INPUT, tiEvent)
--Application:addEventListener(Event.TEXT_INPUT, tiEvent)
stage:addEventListener(Event.TEXT_INPUT, tiEvent)

When I add the event listener to application or Application I get this error message:

wiki.lua.gideros_merged:571: attempt to call method 'addEventListener' (a nil value)
stack traceback:
	wiki.lua.gideros_merged:571: in main chunk

When I add the event listener to stage it works as advertised

PS: gideros 2020.11.1

Is this expected behavior?

+ is this correct?
CONSTANT(0x10,"TEXTINPUT_TVARIANT_URI");
CONSTANT(0x20,"TEXTINPUT_TVARIANT_EMAIL");
CONSTANT(0x10,"TEXTINPUT_DVARIANT_DATE");
CONSTANT(0x20,"TEXTINPUT_DVARIANT_TIME");
CONSTANT(0x10,"TEXTINPUT_NVARIANT_PASSWORD");

EDIT: wiki has been updated

MoKaLux · December 2020

I am trying to make the wiki as a pdf (can be epub, txt, openoffice, ms office, ...)
Here is a first test. Tell me what you think

Let's vote:
+1 for
-1 not for

MoKaLux · December 2020

second test (still a couple of things to fix like the examples code and the '''...
Votes are still open

PS: I have to trim the content because the full thing is 2700 kb.

antix · December 2020

@MoKaLux to have it all in one giant file s basically the same as I am doing in my Gideros Visual Studio Code integration experiment, except I'm generating a large HTML file. It contains anchors so that inside VSC you can click the "sow documentation" link and it opens the document to the appropriate function.

It seems that your experiment is doing pretty much the same thing as mine, which is fine, but it's just duplication I think.

How is ours generated? Do you have to manually export a lot of stuff and then convert? Or are you programmatically getting the API Reference and then converting it into PDF format also programmatically?

mines currently at http://cliffe.co.nz/apiref/gideros.html and I'm still working on the main Electron app that generates both it, and the lua docs required for VSC code completion stuff.

MoKaLux · December 2020

antix my goal was to be able to have an offline doc for gideros, that's all

It takes me 2 mins to do it, anytime I want.
Steps:
1-wiki all classes page: https://wiki.gideros.rocks/index.php/All_Classes_and_more
2-copy from top to bottom
3-wiki special export pages: https://wiki.gideros.rocks/index.php/Special:Export
4-paste
5-click export

Then I did a quick gideros app to transform the xml to html5. From it I can then export to anything txt, pdf, epub... either using libreoffice or ms office or ...
Here is the source wanna have a look?

antix · December 2020

@MoKaLux interesting. I wasn't aware you could just copy and paste that entire page into the other one

This being the case it could be done programmatically using AJAX requests but I don;t think URLLoader supports that kind of operation in Gideros. In JavaScript for sure though

MoKaLux · March 2021

shaders documentation in the wiki is a MESS

https://wiki.gideros.rocks/index.php/Lua_Shaders
Right at the top we are already directing to a new link: https://wiki.gideros.rocks/index.php/Writing_Shaders
Which then redirects to some more...

I have tried tidying this up but I am a bit lost here...

SinisterSoft · March 2021

Sorry for the mess (I added the shader stuff to help).

MoKaLux · March 2021

(at) SinisterSoft, I hate shaders like I hated lua

I am so noob with shaders that I am afraid to make the wiki no sense

The good thing (or not) with me not being good with shaders is that the wiki will then be beginner friendly? documented by a noob for the noobs

MoKaLux · March 2021

can I do this in the wiki?
In the description of a function, I would like to use the imgui way:
(number), (bool) = ImGui:dragFloat(label, value, [incStep=1, min=0, max=0, formatString="%.3f" ,ImGuiSliderFlags=0])

-brackets for optional parameters
-= with default values

This is very clever

This should be ok for the wiki description pages but on the hidden side (gideros method declaration) for gideros studio I am afraid this will break something (for example antix VS code addon, ...).
[[ImGui.Core:dragFloat|ImGui:dragFloat]] ''displays a ImGui drag float slider''
GIDEROSMTD:ImGui:dragFloat(label, value, [incStep=1, min=0, max=0, formatString="%.3f", ImGuiSliderFlags=0]) displays a ImGui drag float slider

So what do you think, can I do this? I am waiting for your feedback

Some examples: https://wiki.gideros.rocks/index.php/ImGui.Core:dragFloat
https://wiki.gideros.rocks/index.php/ImGui.Core:dragFloat4

rrraptor · March 2021

The string length is very long, so if you want to write the API this way, I think you need to format the string for something more readable.

MoKaLux · March 2021

you are right, something like this?

(number), (number), (number), (number), (bool) =
  ImGui:dragFloat3(label, value1, value2, value3, value4, [incStep=1, min=0, max=0, formatString="%.3f",
    ImGuiSliderFlags=0])

or better to keep it old way?

rrraptor · March 2021

Maybe like this?

(number), (number), (number), (number), (bool) =
  ImGui:dragFloat3(label, num1, num2, num3, num4, [inc=1, min=0, max=0, format="%.3f", ImGuiSliderFlags=0])

MoKaLux · March 2021

nope that's too long for the wiki, it cuts it at ""%.3f","
so I guess you like the imgui way

?

EDIT: Sorry I misread the answer, cutting names would decrease the meaning

John · October 2021

At the bottom of this (API reference tab) page http://docs.giderosmobile.com/interface/iab it says Event.RESTORE_COMPLETE twice. It should say Event.RESTORE_ERROR for second one.

Also unity ads is totally missing on this (Methods tab) page http://docs.giderosmobile.com/interface/ads If you look in IAB plugin property in gideros studio you can see unity being listed there and it does work with unity ads because I am using it.

MoKaLux · November 2021

John said:
At the bottom of this (API reference tab) page http://docs.giderosmobile.com/interface/iab it says Event.RESTORE_COMPLETE twice. It should say Event.RESTORE_ERROR for second one..

This is old docs, the wiki should be the place to go https://wiki.gideros.rocks/index.php/Iab

John said:
Also unity ads is totally missing on this (Methods tab) page http://docs.giderosmobile.com/interface/ads If you look in IAB plugin property in gideros studio you can see unity being listed there and it does work with unity ads because I am using it.

This one needs to be updated in the wiki https://wiki.gideros.rocks/index.php/Ads

John · November 2021

https://wiki.gideros.rocks/index.php/Iab

IAB:isAvailable() --check if IAB is available, raises event:
Event.AVAILABLE --iab is available

the following event is undocumented

Event.NOT_AVAILABLE -- fires when IAP is disabled

In iOS case, when you go into settings > general > restrictions and turn off IAP on iOS you get the NOT_AVAILABLE event firing when you call IAB:isAvailable()

MoKaLux · November 2021

(at) John updated as per your comment

MoKaLux · February 2022

compiling latest Gideros from GitHub (for windows 10 64 bit)

: https://wiki.gideros.rocks/index.php/Compiling_Gideros_Luau_Source

I cannot do it for Mac nor Linux.

MoKaLux · March 2022

@keszegh do you remember this https://forum.gideros.rocks/discussion/comment/66620/#Comment_66620?

Well I am happy to say it is almost done https://wiki.gideros.rocks/index.php/Lua_Midi

Could you please fill in the xxx when you have the time?

Howdy, Stranger!

Categories

In this Discussion

Top Posters

New Gideros Docs/Wiki...

Comments

Howdy, Stranger!

Quick Links

Categories

In this Discussion

Top Posters

New Gideros Docs/Wiki...

Comments