📚 [Lib] - MyLib for Ankulua scripts

looks useful. I used another translator (much better than Google) to translate your text. it will be easy for those to read here if they find it interesting!

- Debug menu
log(msg)
print(msg)
toast(msg)
F_log(message)
F_Log(message)
F_print(message)
F_Print(message)
F_Debug(message,report_type) -- Debug function. F_Debug(message,nil|0nil|0|1|2|3|4) F_Debug("message",[assign if nil or 0 is all, 1 is to log, 2 is to print to the screen when the work is done, 3 is to alert the screen when the work is done, 4 is to log and print to the screen)]).


- Stopwatch function, writes to a log file a report on how much time has elapsed since the start of the script, all the time and how much elapsed between resets
F_Timer(report_type)
timer:set() -- to reset the timer, it is inserted in the main code in places where you want to reset the stopwatch, for example at the beginning of the loop


- The function of automatic screen size and position setting for script operation. Defines setCompareDimension and setScriptDimension as screen sizes or as application sizes if these parameters differ. For example, when there are on-screen buttons, the navigation bar, the screen size is slightly reduced. Returns screen, RegScreen, screenAppUsable, RegScreenAppUsable. screen and RegScreen are used in functions and can be used in scripts.
F_Screen() -- Automatically sets the screen size and position for the script.


- Battery charge detection function
F_Battery_status(AppName)
AppName = "application_name" -- in the main code, the variable section specifies the name of the application to be stopped if the battery is below 15% and the device is not connected to the charge.


- Control the brightness of the screen, reduce to a minimum
F_Brightness_0() -- Control the brightness of the screen, reduces to a minimum


- Unlock function from commonLib.lua library
F_Unlock(second, pinLock, pin)
--F_Unlock(delay time,[unlock by pin code true\false, pin code]).


- Picture search function with return picture or center coordinates image_Center = image_septag and coordinates with offset image_Center_new = image_center_new = image_center_offset.
F_Image(image,reg,NewX,NewY,CustomSumilar,CustomTimeToIdentify)
--F_Image(picture,[region], [offset X, offset Y], [ordered accuracy], [ordered time of determination of picture]).


- Picture search function with return:
- pictures
- define the region of the image reg_image, to accelerate further searches
- center coordinates image_Center = image_septag
- coordinates with offset image_Center_new = image_center_new = image_center_offset
F_RegImage(image,reg,NewX,NewY,CustomSumilar,CustomTimeToIdentify)
--F_RegImage(picture,[region], [offset by X, offset by Y], [ordered accuracy], [ordered time of definition of picture]).
reg_image_1 = reg_image


- Error reporting function
F_Error(msg,StopScript)
-- F_Error(error message,[true|1]) - script stop after


- Progress bar function, draws a strip of progress bar at the bottom of the screen, which is gradually filled in. You can also rotate the progress bar until the desired picture appears. You can specify the height of the progress bar, because the bar will be different on different resolutions of the screen.
F_ProgressBar_Down(waittime,wait_Optimal_Value,image,reg,ProgressBar_Size_H)
--ProgressBar_Down(waiting time(s), progress step(s),[search until image appears],[region of image],[height of progress bar]).


- The function for obtaining information about the device. For version 7.2.0: get the AnkuLua, DeviceID, IMEI, WiFiMAC, UserID, Language versions in a log file. For newer versions you can also get: Country (from 7.6.0), SIMSerial, IMSI
F_GetDeviceInfo()


- Start and end cycle report function
F_ReportStateCycle(state) -- Cycle start and end report 1 = start, 2 = end


- Spent time report function (similar to F_Timer())
F_Report() -- Time spent report
timer:set() -- to reset the timer, it is inserted in the main code in places where you want to reset the stopwatch, for example at the beginning of the loop


- Check for MyLibs.lua update function
F_Check_Update_MyLibs(update) -- Check for an updated version of MyLibs. true|1|nil = Check for version, 2 = Check for version (forced).


- Scripts update function
F_UpdateScript(currentVersion,latestVersion,downloadUrl) -- Update the script if there are differences in version.


- Functions to press Tab, Enter, Back, Home, Menu, Space
-- examples
F_PressTab() -- Press TAB and leave a message about it.
F_PressEnter() -- Press ENTER and leave a message about it
F_PressBack() -- Press BACK and leave a message about it.
F_PressHome() -- Press HOME and leave a message about it.
F_PressMenu() -- Presses MENU and leaves a message about it.
F_PressSpace() -- Press SPACE and leave a message.


- Message counter function, displays the specified message and number + 1
F_Counter(msg,ItemsCountIn) -- Message counter
F_Counter("message",Incoming_value) > Returned value
Global (local) variable = Output_counter -- Return function value is assigned back to global variable


- The function of setting the picture folder according to the screen resolution. The screen size is checked and the corresponding folder image_X_Y is set.
-- An example
F_SetImageFolder() -- setting up an image folder according to screen resolution

--------------------------------

To check how everything works, you can use the Example.lua file including updating the library
www.dropbox.com/s/rpqf8ybkzz5f22d/MyLibs_Example.zip?dl=1

MyLibs.lua Library
www.dropbox.com/s/91133nu8nerzonj/MyLibs.tar?dl=1
It's also on:
+ luaLib.lua
+ commonLib.lua
+ untar.lua
+ md5.lua
Found on the spaces of this forum and many thanks to their authors!

I hope this experience will be as useful to you as it is to me .
The library is updated from time to time, so always make a backup before updating it, in case something changes, and you will not like it.
There's no limit to perfection.

p.s. russian-speaking AnkuLua fans I invite to the chat club t.me/AnkuLua_Club_Ru
English speakers are welcome, but you know, not many people can communicate in English...