New Gideros Docs/Wiki...

keszegh

@MoKaLux , thanks, that's great, i will try to add these whenever i get the time.

MoKaLux

Where would be a good place to add new luau vector?
Under Gideros specific methods in the math section https://wiki.gideros.rocks/index.php/Math?

Please some advice

MoKaLux

I don't know the value for cull mode
https://wiki.gideros.rocks/index.php/Mesh:setCullMode
When looking in gideros GH I could see:
enum CullMode {
CULL_NONE,
CULL_FRONT,
CULL_BACK,
};
There is this CullMode thing so I thought I could write:

mesh = Mesh.new() mesh:setCullMode(CullMode.CULL_FRONT) -- doesn't work mesh:setCullMode(0) -- does work

So is it fair to say that 0 = CULL_NONE, 1 = CULL_FRONT, 2 = CULL_BACK?

Thank you
PS: does it work for 2d and 3d?

EDIT: see answer below from hgy29, wiki updated https://wiki.gideros.rocks/index.php/Mesh:setCullMode

hgy29

MoKaLux said:

I
So is it fair to say that 0 = CULL_NONE, 1 = CULL_FRONT, 2 = CULL_BACK?

Yes, enums in C start 0 so you are correct. I'll add constants in Mesh class to avoid confusions.They are defined in Sprite class (Sprite.CULL_NONE, etc). And yes it does work in 2D, but is there are point in using culling in 2D ?

MoKaLux

Is lua select function supposed to be in the wiki?
If so here https://wiki.gideros.rocks/index.php/(global) ?
Thank you

EDIT: added https://wiki.gideros.rocks/index.php/Select

rrraptor

Fixed & added some things
https://github.com/gideros/gideros/pull/543

hgy29

Great, merged!

MoKaLux

rrraptor wrong thread but great news

rrraptor

MoKaLux said:

rrraptor wrong thread but great news

Yeah

MoKaLux

https://wiki.gideros.rocks/index.php?title=Trigonometry_Conversion_Operators
__NOTOC__
!-- GIDEROSOBJ:Trigonometry Conversion Operators --
'''Supported platforms:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]]br/
'''Available since:''' Gideros 2017.10br/

=== Description ===
Operators to convert from one type of measurement to another.

Same here https://wiki.gideros.rocks/index.php?title=Better_and_easier_syntax_for_arrays
__NOTOC__
!-- GIDEROSOBJ:Better and easier syntax for arrays --
'''Supported platforms:'''...

and https://wiki.gideros.rocks/index.php?title=Bitwise_Operators
!-- GIDEROSOBJ:Bitwise Operators --...

and https://wiki.gideros.rocks/index.php?title=Integer_Divide_Operator
!-- GIDEROSOBJ:Integer Divide Operator --

and https://wiki.gideros.rocks/index.php?title=Larger_and_Smaller_Operators
!-- GIDEROSOBJ:Larger and Smaller Operators --...

...

I think I can get rid of !-- GIDEROSOBJ:...-- they have nothing to do here (aka not linked to Gideros Studio)!?

Downvote if you disagree, peace


EDIT: added https://wiki.gideros.rocks/index.php/Ternary_Operator

MoKaLux

updated strings wiki with missing luau functions (thus missing in Gideros Studio)
https://wiki.gideros.rocks/index.php/String

EDIT: I copied the docs from roblox which are copyrighted it is clearly forbiden in gideros wiki code of conduct
EDIT2: table WIP DONE https://wiki.gideros.rocks/index.php/Table (https://create.roblox.com/docs/reference/engine/libraries/table)

EDIT3, TODO: bit32 DONE, coroutine DONE, debug NO CHANGE NEEDED, utf8 DONE. I need to test a couple of them to make sure they work in Gideros!

EDIT4: should be ok , utf8 has some functions which seem not present in current Gideros Studio (graphemes, nfcnormalize, nfdnormalize) so I don't add them

Please tell me if I am missing something else

MoKaLux

added SoundChannel:setEffect: https://wiki.gideros.rocks/index.php/SoundChannel:setEffect but I have no clue if this is right at all

For me new balance for SoundChannel:setVolume has no effects (tested with a .wav file): https://wiki.gideros.rocks/index.php/SoundChannel:setVolume, also I don't know what the range should be? 0<>1, -1<>1, ... maybe I need a stereo file

pie

@MoKaLux I haven't investigated the new SoundChannel yet, but if I recall correctly the setVolume values were from 0 (mute) to 1 (max) - this was almost 10 yrs ago though..

The variables mentioned about the openal equalizer seems to be these:



taken from https://openal-soft.org/misc-downloads/Effects Extension Guide.pdf
page #69

maybe you can find something more there, or just add it as a reference

MoKaLux

pie said:

@MoKaLux I haven't investigated the new SoundChannel yet, but if I recall correctly the setVolume values were from 0 (mute) to 1 (max) - this was almost 10 yrs ago though..

The range for volume is 0<>1 but I was asking for the new balance parameter range . I tried different values but cannot hear any difference in the balance, it always sounds "centered".

pie said:

taken from https://openal-soft.org/misc-downloads/Effects Extension Guide.pdf
page #69

maybe you can find something more there, or just add it as a reference

This is indeed a VERY NICE REFERENCE, I am not too much into sound but that may come in very handy, thank you mr pie

PS: also I don't know for you guys but the default volume sounds WAY TO LOUD?!
PS2: oh I may know why balance isn't working for me!? I don't have a stereo file

pie

I post here because it's wiki related: since I just rediscovered Gideros Fiddle I thought it could be cool to embed it in the wiki.
I don't know if that requires a lot of work, but as of now I can't embed iframes nor open links in new browser tabs.
Here is the best I can do right now, I don't know if it's because I lack privileges, or for safety reasons (https://www.mediawiki.org/wiki/Manual:$wgExternalLinkTarget):
https://wiki.gideros.rocks/index.php/Your_first_code

The ideal thing would be that the wiki could embed the gideros editor window button in code snippets, or only some code snippet like it happens for example here: https://www.w3schools.com/python/python_dictionaries.asp
If that could happen automagically reading the css or templates we would save a lot of manual data entry and focus on developing new mini games

hgy29

You can also just display the code and embed a playable version (.GApp) on the same page, such as in https://wiki.gideros.rocks/index.php/2D_Space_Shooter_Part_5:_Firing

pie

hgy29 said:

You can also just display the code and embed a playable version (.GApp) on the same page, such as in https://wiki.gideros.rocks/index.php/2D_Space_Shooter_Part_5:_Firing

I didn't know that, I always wondered what was the purpose of Gapp export.. but I think that the option to fiddle directly with code is much more attractive and educational, even if you can rely only on existing assets (which might be expanded a bit though) and almost no plugins/libraries.
It basically recreates the good feeling of instant testing that I guess we all love and that no other framework that I've heard of has.
GApps could still be useful for more complex projects like that 2d shooter

MoKaLux

With the new addition in Gideros 2021.9 (please see post https://forum.gideros.rocks/discussion/8472/gideros-2021-9-released/p1) I am trying to document TexturePackFont

I don't know what to feed the "mappings" with
I created two pngs to simulate letter a and letter b and I tried the code below. It prints my pngs but something is wrong.

--TexturePackFont::TexturePackFont(Application *application, TexturePack *pack, std::map mappings, double scale, double anchory) : -- BMFontBase(application) { local tp = TexturePack.new({"fonts/ar_ba.png", "fonts/ar_ta.png", "fonts/ar_ta.png"}) -- 16*16 pngs local tpf = TexturePackFont.new(tp, {a="a", b="b", c="b"}, 2, 0) -- tp, mappings, scale, anchory --tpf:drawText("ab") -- crash print(tpf:getBounds("a")) -- 0 0 974849408 65526 print(tpf:getLineHeight()) -- 368 local tf = TextField.new(tpf, "a") -- prints all TexturePackFont letters! local tf2 = TextField.new(tpf, "b") -- same as above! local tf3 = TextField.new(tpf, "b a bc hello") -- same as above! local tf4 = TextField.new(tpf, "d") -- blank tf:setPosition(64*6, 64*1) tf2:setPosition(64*6, 64*2) tf3:setPosition(64*6, 64*3) tf4:setPosition(64*6, 64*4) stage:addChild(tf) stage:addChild(tf2) stage:addChild(tf3) stage:addChild(tf4)

for ref: https://github.com/search?q=repo:gideros/gideros TexturePackFont&amp;type=code

Is it suppose to work like Gideros Font Creator?

Do you guys have a better sample code , thank you!

hgy29

Hi @MoKaLux,
in TexturePackFont.new() mapping table associate characters to original file names, so in your case something like:

local tpf = TexturePackFont.new(tp, {a="fonts/ar_ba.png", b="fonts/ar_ta.png", c="fonts/ar_ta.png""}, 2, 0) -- tp, mappings, scale, anchory

You shouldn't add the same image twice in the pack.
Currently Gideros doesn't handle the case where your mapping table is incorrect, it will draw some random part of the texture pack if the mapped file name doesn't exist. I will fix that.

MoKaLux

Awesome, thank you hgy29. After adding the title in wiki Main_API, I noticed TexturePackFont was already existant (created by you ). Viva Gideros
https://wiki.gideros.rocks/index.php/Main_API

MoKaLux

thread(s) is it still a thing?
When I look at Makefile.gid I see:
PLUGINS_WIN+=threads
PLUGINS_ANDROID+=threads
PLUGINS_WIN32+=bitop threads

But in a Gideros project there is no such Thread(s) plugin anymore.

In Gideros Studio folder \All Plugins\threads:
threads.gplugin_deprecated

Tested on latest Gideros and I have this error:
Uploading finished.
Luau
[string "luabinding/compatibility.lua"]:79: Module Threads not found
stack traceback:
[string "luabinding/compatibility.lua"]:79: in function require


So I think I answered my question and will hide link to https://wiki.gideros.rocks/index.php/Thread in the wiki .

MoKaLux

What happened to the wiki , it looks like it's been updated
Example:
syntaxhighlight lang="lua"
Sprite.new()
syntaxhighlight
Hope this was automated

+ new section added by hgy29
GIDEROS SHORTS
https://wiki.gideros.rocks/index.php/Welcome!

Viva Gideros

MoKaLux

roblox documentation is now open source
https://devforum.roblox.com/t/open-sourcing-creator-docs/2569346

Licenses

The repository uses two open-source licenses:

Prose is available under the Creative Commons Attribution 4.0 International License, so you can remix and adapt it into your own work as long as you provide proper attribution.

Code samples are available under the MIT License so that you can freely incorporate them into your experiences.

https://create.roblox.com/docs/reference/engine/libraries/bit32
...