[API] Mouse and graphic api V1.6.1 beta. Easy to use GUI API with full mouse support

billysback, on 24 November 2012 - 06:26 AM said:

No download, has no code.

ZudoHackz, on 28 November 2012 - 06:59 AM said:

Comeon and fix the popup glitch! THIS IS EPIC!

ArchAngel075, on 29 November 2012 - 11:06 AM said:

create a buffer table i guess, im not sure how to do this but to save onscreen data make it save the current data to a buffer and then popup, once popup is gone make it rerender the saved screen buffer?

Sorry i cant give advice, although i like this program and may use it for a minigame i plan on making :)/> (especially because of the waitforclick() )

Oct125, on 01 December 2012 - 06:50 AM said:

Epic! I will use it on my program! If possible, add a option to select the color of the button,i tested the non-beta.

if clears == 1 or true then --take your pick if you wish to use 1,0 or true,false for this..
term.clear()
end
if colorLine then
colorL = colorLine
else
colorL = colors.white
end
if color then
colorB = color
else
colorB = colors.black
end
table.insert(runButton, x)
table.insert(runButton, y)
table.insert(runButton, a)
table.insert(runButton, B)/>/>
table.insert(runButton, text)
table.insert(runButton, colorL)
table.insert(runButton, colorB)
table.insert(coordButton, x)
table.insert(coordButton, y)
table.insert(coordButton, a)
table.insert(coordButton, B)/>/>
end

ArchAngel075, on 09 December 2012 - 07:05 AM said:

Sorry for this double posting but :

Suggestions :
for
setButton(x, y, a, b, text, colorLine, color)
and
setButtonc(x, y, a, b, text, colorLine, color)

perhaps you can combine them into
setButton(clears,x, y, a, b, text, colorLine, color)

the function will then be :

if clears == 1 or true then --take your pick if you wish to use 1,0 or true,false for this..
term.clear()
end
if colorLine then
colorL = colorLine
else
colorL = colors.white
end
if color then
colorB = color
else
colorB = colors.black
end
table.insert(runButton, x)
table.insert(runButton, y)
table.insert(runButton, a)
table.insert(runButton, B)/>/>/>
table.insert(runButton, text)
table.insert(runButton, colorL)
table.insert(runButton, colorB)
table.insert(coordButton, x)
table.insert(coordButton, y)
table.insert(coordButton, a)
table.insert(coordButton, B)/>/>/>
end

—–
Also for clearing the buffer for
gui.render()
you can use
gui.render(s)
and check 's' for true or 1 or nil for whether it resets or not and do as needed…

ArchAngel075, on 09 December 2012 - 09:53 AM said:

Why not make the popup auto resize based on the options given? My API will lengthen its "box" size to stretch using the longest options string + 5. just track the "last greatest string length" for that popup?

bjornir90, on 13 December 2012 - 04:21 AM said:

Thanks you for testing it but I think I will remove this link because it is very buggy but I fixed most of them already :)/>

function popUp(title, text, colorLine, color)

Oct125, on 13 December 2012 - 05:09 AM said:

bjornir90, on 13 December 2012 - 04:21 AM said:

Thanks you for testing it but I think I will remove this link because it is very buggy but I fixed most of them already :)/>/>

Ok!
Now i'm using the non-beta (1.4, i think) and it's working fine! B)/>

bjornir90, on 13 December 2012 - 05:34 AM said:

Oct125, on 13 December 2012 - 05:09 AM said:

bjornir90, on 13 December 2012 - 04:21 AM said:

Thanks you for testing it but I think I will remove this link because it is very buggy but I fixed most of them already :)/>/>

Ok!
Now i'm using the non-beta (1.4, i think) and it's working fine! B)/>

Thanks you ! What are you doing with my API ? Just to know :P/>

term.setTextColor(colors.white)
gui.drawButton(2, 6, 32, 8, "1", colors.gray)
while true do
btn3 = gui.buttonClick(2, 6, 32, 8)
if btn3 == "true" then    -- Press the button
term.setCursorPos(1,19)
term.setTextColor(colors.lime)
print("Ok!")
sleep(2)
end
end

bjornir90, on 13 December 2012 - 07:05 AM said:

It's the good code but it will check only one time so if you don't click it the first time, it will not detect the click. I have created this to put it in a loop, you should use buttonWaitClick(coord) to wait until the user click this button :)/>.

Oct125, on 13 December 2012 - 10:32 AM said:

Ok… But i have a problem… In the screen i have 3 buttons! And i have no idea to the program detect the button pressing!

ArchAngel075, on 14 December 2012 - 12:00 AM said:

also pls update the pastebin of the non-beta to return version 1.4.1, i was confused when 'gui.render(reset)' was nil even though both versions (in pastebin and my DL file) were same :)/>/>Noticed the beta is 1.4.1 if im correct, sorry about that derp

Working on the angelTV update to support pastebin for pastebin movie sharing atlast! your API really makes things more easier :P/>/>

ArchAngel075, on 14 December 2012 - 12:42 AM said:

New Suggestion :P/>/> :

I noticed buttons dont auto size based on text, thats ok for when you can choose how long the buttons text is but what ive the text is too long ? It just prints the text longer than the buttons length.

Perhaps have it check over the text length and button length and if text length > BLength then print the text that would be going over the button under the text
ie
'This button'

might become instead

"This Butt
on"

use
ButtonSplit[index] = string.sub(TEXT, buttonLength,string.len(TEXT))
index = index+1

its a table because we might have multiple-runovers, so keep checking the lengths till it wont run over then print text by

index = 1
for index = 1,table.maxn(ButtonSplit)
print(ButtonSplit[index])
index = index+1
end

you could also then expand the Y of the box by b = table.maxn(ButtonSplit)+1 – plus 1 is optional, its good for spacing inside buttons.

Summary of suggestion :
allow the text that is longer than a buttons length to print over to new lines within a button

-end-

ArchAngel075, on 14 December 2012 - 05:13 AM said:

co-dev lol, that be abit hard… it takes alot to get me typing in any program XD

The pages idea was an branch of how i could have done the previewer in my program(i instead whent for mouse scrolling) and i noticed its useful for some things such as displaying lists >

If you take AngelTV for example :
It is editor mode and you wish to select a file to edit, it outputs pages containing the files names as buttons(or with buttons attached) and vy clicking a file name or button you will open the file in an editor… if the file you need isnt on that page then you can "turn" the page and search that one, it might output say 10 files per page and you want file 22 etc

but this needs some indepth and as i will write this myself and give you the code if you want to use it in your API instead of my adding it to cpsAPI(which i am dropping)

bjornir90, on 13 December 2012 - 07:06 PM said:

Oct125, on 13 December 2012 - 10:32 AM said:

Ok… But i have a problem… In the screen i have 3 buttons! And i have no idea to the program detect the button pressing!

And here comes the getSelection() function ! With this powerful function, you can check every buttons actually drawn on the screen ! :)/> It will return the number of your button. Look at the OP for more informations about it :P/>

Oct125, on 14 December 2012 - 07:54 AM said:

bjornir90, on 13 December 2012 - 07:06 PM said:

Oct125, on 13 December 2012 - 10:32 AM said:

Ok… But i have a problem… In the screen i have 3 buttons! And i have no idea to the program detect the button pressing!

And here comes the getSelection() function ! With this powerful function, you can check every buttons actually drawn on the screen ! :)/> It will return the number of your button. Look at the OP for more informations about it :P/>

Hm ok! Thanks and sorry for not paying attention in the functions list :P/>

ArchAngel075, on 14 December 2012 - 08:16 AM said:

Oct125, on 14 December 2012 - 07:54 AM said:

bjornir90, on 13 December 2012 - 07:06 PM said:

Oct125, on 13 December 2012 - 10:32 AM said:

Ok… But i have a problem… In the screen i have 3 buttons! And i have no idea to the program detect the button pressing!

And here comes the getSelection() function ! With this powerful function, you can check every buttons actually drawn on the screen ! :)/> It will return the number of your button. Look at the OP for more informations about it :P/>

Hm ok! Thanks and sorry for not paying attention in the functions list :P/>

For future help i suggest adding this to the spoiler of the function :
gui.setButton(x,y,endx,endy,text,colorline,colorbackground)–button 1
gui.setButton(x,y,endx,endy,text,colorline,colorbackground)–button 2
gui.sRender()
gui.getSelection() –will return 1 if the button is clicked, 2 if the button 2 is clicked and so…


-end-

suggestion! : roundness, yes… i noticed we have rectangles but not round buttons, this can add a lot more, rendering out the button will be easy in my opinion, im not sure how to check its inside cords for the gui.getSelection() perhaps make it save the buttons radius as X (you can also in-depth for ovals if you save two radii X; Y…. I might write a temp of the render and the scan inside since circular buttons just climbed my priority more than pages :P/>

function bClear()
runButton = {}
runHeader = {}
coordButton = {}
end

Oct125, on 14 December 2012 - 09:25 AM said:

Thanks ArchAngel075!!
I'm programming in the right way now, but i'm having problems… And, one solution would be to create a function that clears the buffer without drawing it… So there is the suggestion :P/>/>

Oct125, on 14 December 2012 - 09:51 AM said:

Updating to the beta version and testing… :P/>/>/>

Well the bug has fixed :)/>/>/> But… Pleeease add a function to clear only the buffers!! I don't want to make this by my self, because, i will redistribute my program with my version of your API!! The function: gui.render(true) clears the screen, so don't serves me, and i need to clear the buffers! If you have any other idea, please, disconsider this and tell me!

ArchAngel075, on 14 December 2012 - 03:02 PM said:

Going to write that round button part, dont think it of a circle, think it of a set of squares in a shape that just *happens* to be circular :P/>/>

im going to try and add alot of functionality to it, including position on screen, inner color, outline color, the size, text of button

One problem will be storing the data, since i am used to string storage (ie SIZE.."#"..Color1.."#"..Color2 ….. etc) this may be problematic…

Also i need this round button for my program thus it was going to be written anyways :)/>/>

bjornir90, on 14 December 2012 - 07:01 PM said:

Oct125, on 14 December 2012 - 09:51 AM said:

Updating to the beta version and testing… :P/>/>/>

Well the bug has fixed :)/>/>/> But… Pleeease add a function to clear only the buffers!! I don't want to make this by my self, because, i will redistribute my program with my version of your API!! The function: gui.render(true) clears the screen, so don't serves me, and i need to clear the buffers! If you have any other idea, please, disconsider this and tell me!

Ok I will add, it's really easy :P/> I will do that tonight because now, I have school so you have to wait a bit but to start implement this function, his name will be clearBuffer() :)/> Never mind, added in the beta :)/>

ArchAngel075, on 15 December 2012 - 02:07 AM said:

i want to point out the circles are imposible, they need to be HUGE to actually look like circles and the smallest word like HELLO will require a large circle…the pixels are not cut out for this…

*depressed face*

On to the page thing….

Oct125, on 19 December 2012 - 12:58 PM said:

I found a problem in the Beta API: "gui: 48 : Attempt to get length of number"

ArchAngel075, on 19 December 2012 - 03:35 PM said:

Im looking into that error now, also ill now be testing every beta and n-beta every release.

Also im going to look into improvements i can make here and there…

One i noticed is those checks like

if tostring(clears) == true then
term.clear()
end

eg on line 35 -> 37

can be perhaps improved for others by making it instead

if tostring(clears) == nil then
clears == false
elseif tostring(clears) == true then
—
—
end

this can maybe add speed to programmers and clean up abit, since you can now use a nil (no argument given) and it will default to false.

im not sure if this is really needed though :)/>/>


please look into the non-betas render() and setButton() functions, for some reason if the render's argument is true or "true" then the buttons dont seem to work, my guess is some how they are clearing the buffer and thus loosing the buttons information… I have confirmed its only when the clearBuffer() function is called does this happen.

lines 126 –> 139 are the render() function
lines 147 –> 155 are the setButton() function

It must be noted that this seems to happen when a button settup in a program is put in a while loop, ie

1.| while true do
2.| setButton—
3.| setButton—
4.| setButton—
5.| render(true)
6.| selection = gui.getSelection()
7.| —whatever is executed ->
8.| —based on selection
9.| end

i have a working button setup above without a loop and it works fine.

ArchAngel075, on 19 December 2012 - 04:54 PM said:

Oct125, on 19 December 2012 - 12:58 PM said:

I found a problem in the Beta API: "gui: 48 : Attempt to get length of number"

fix for line 48 Beta version, changes are in red

local sizeText = #text

to –>

local sizeText = #tostring(text)

bjornir90, on 21 December 2012 - 06:59 PM said:

Oh sorry ! I forgot to upload the fix :(/>

bjornir90, on 22 December 2012 - 07:02 PM said:

Fixed AND uploaded ;)/> I removed the useless if statement. Oh and I almost forgot : now the buttons on the pop-up should work :)/>

bjornir90, on 23 December 2012 - 07:03 AM said:

yes I 'm testing it and it give me the same, I'm working on, don't worry :)/> And sorry for all of this issue, I didn't test the beta version since a long time… And thanks for your support and bugs report :)/>

bjornir90, on 23 December 2012 - 07:08 AM said:

I found the problem !! You need to change your code because now, the API needs only the top left corner of the button and auto resize the button to the text lenght :)/> I forgot it myself in my code XD And also expect the 1.5 to come out this week end ! :D/>

os.loadAPI("gui")
gui.popUp("title", "text", 9, 25, colors.gray, colors.white, "Yes", "No")

Oct125, on 28 December 2012 - 08:10 AM said:

Error in line 269: Unexpected symbol, it's a "çl" I fix that but the code keeps buggy in line 240 :/

ArchAngel075, on 05 January 2013 - 08:58 AM said:

I am now back in action aside from small driver issues, but anyhow :

I will play around with 1.5 ASAP, and I have two suggestions! :

TickBox
draws a 3x3 box where its centre is green or red, if ticked = green if not ticked = red,

setLists
i've no idea what to call them really.. but they are simply two boxes witha button between them, the boxes contain a list of things, like place names or what have you(user defined) and allow you to set if (for this example) placeA to true, placeB - D to false and then placeE to true again.. And one can quickly return what the value of a place is..
-Its like a multi-version of the tickbox, to change a places value you click its name in the box and click the button between the boxes(which in Windows can be two arrows going right/left)

ill elaborate more if needed…

Oct125, on 10 January 2013 - 05:35 AM said:

ArchAngel075, on 05 January 2013 - 08:58 AM said:

I am now back in action aside from small driver issues, but anyhow :

I will play around with 1.5 ASAP, and I have two suggestions! :

TickBox
draws a 3x3 box where its centre is green or red, if ticked = green if not ticked = red,

setLists
i've no idea what to call them really.. but they are simply two boxes witha button between them, the boxes contain a list of things, like place names or what have you(user defined) and allow you to set if (for this example) placeA to true, placeB - D to false and then placeE to true again.. And one can quickly return what the value of a place is..
-Its like a multi-version of the tickbox, to change a places value you click its name in the box and click the button between the boxes(which in Windows can be two arrows going right/left)

ill elaborate more if needed…

The tick box will be really useful!
And Bjornir, i've made a installer in my OS that copies the API from your pastebin ok?

ArchAngel075, on 11 January 2013 - 11:10 AM said:

using paintutils.loadImage(path) you can

first use
xyz = paintutils.loadImage(path) – where xyz can be any variable.

then use
paintutils.drawImage(image, x, y) – image being that xyz you specified above, and x,y is the topleft most point to start rendering it from afaik.

all info on the paintutils is found on paintutils

if this is not what you meant then please try to elaborate.

-end-

ArchAngel075, on 12 January 2013 - 07:08 AM said:

im browsing by often, awaiting any updates and suggestions to conceptualize.. BTW

yet another suggestion ill concept(i love conceptualizing ideas XD) :

drag panes, it will at first be a square or rectangular box drawn on screen with a title, if clicked upon it will "drag" the pane out and render a list of buttons. if the sqaure is again clicked it closes.
(the closest name would be drop down tabs)

-One can perhaps support too many buttons(making it render off screen) by catching the screen size, and then making an auto scroll bar to scroll within the panel…

id be happy to try my hand at the auto scroll bar system since it can come in handy?
,

the drag n Replace concept is priority atm.
-

ArchAngel075, on 12 January 2013 - 02:21 PM said:

OK!, a small question, will you use getSelection() for all selection-related events ? since then i might be able to use it to make conceptuals better…Also do you have any clue to how to prioritise buttons so that popup-related-buttons overlapping normal buttons will fire first since they overlap? or is this internally handled already?

I havent really looked at thelatest version of the API, i might be able to find some tweaks if possible… else ill look into linking my concepts into them for better compatibility…

bjornir90, on 22 May 2013 - 01:20 AM said:

Just to say that i'm back on it ! I will finish the tickbox soon. :)/>