| TOUCH |
[Features] The position and
state of touch panel where it was touched are returned.
[Format] TOUCH(n)
[Explanation]
The position and state of touch panel
where it was touched are returned.
n=0 The number of the present touches. on=1 or more. off=0.
n=1 Movement of flick X. (No.1)
n=2 Movement of flick Y. (No.1)
n=3 Touch No.1 ID.
n=4 No.1 X coordinate.
n=5 No.1 Y coordinate.
Below, each 3 are increasing with the
number of the multi-touch.
n=6 Touch
No.2 ID.
n=7 No.2 X coordinate.
n=8 No.2 Y coordinate.
Normal single
touch can be got with this.
touchOn:
touch(0)>0
Coordinate:
x=touch(4) y=touch(5)
[Movement
of flick] support only for No.1.
'n' correspondence table was changed
from version275.
The table by the old
version are as follows.
n: 0.X
1.Y 2.Number of touches 3.X-Movement 4.Y-Movement
Multi-touch
support.
Since each touch is assigned
ID number, by getting 'touch(3+tn*3)',
please write the program which each
touch is distinguished by those ID.
The correspondence between touch-ID and 'n',
when multiple on/off touching are
repeated, it change at any time.
For
example of using multi-touch, please refer to the included sample program.
[e.g.] Sample program.
'smp_touch2.bas'
2 points multiple touch that distinguish
by left and right separation.(ID unused)
'smp_touch4.bas'
4 points more multiple touch that
distinguish by touch-ID.
| TAP |
[Features] It will be in a
waiting state until be inputted by a tap.
[Format] TAP [n]
[Explanation]
If 'n' is specified, it will become the waiting for input for n seconds.
If omitted, waiting time will become
infinite.
[e.g.] It wait
for input for two minutes, and display a tapped coordinate.
10 tap 120
20 print touch(0);touch(1)
| INP |
[Features] The input state of
Hardware keyboard of a 'keycode' is read.
[Format] INP(keycode)
[Explanation]
Return value. on:-1 off:0
[e.g.]
| STICK |
[Features] To read the
direction of the virtual pad.
[Format] STICK(n)
[Explanation]
n=0 Horizontal direction.
n=1
Vertical direction.
Return(-1,0,1)
Virtual pad can be selected by
menu[Softkey].
In Virtual pad,
by command [ init"kb:n" ], change is possible [n=3 8way-input] [n=4
4way-input].
The sensitivity of
a touch may differ depending on the model.
Bluetooth, NVIDIA-Shield,
Xperia-Play, the controllers are supported. (c.f. item-Operation)
It corresponds also to the arrow key of
a hardware keyboard.
[e.g.]
x = stick(0)
| STRIG |
[Features] To read the state
of the button on the virtual pad.
[Format] STRIG(n)
[Explanation]
n:
Button number.
Return(off:0,on:1orMore)
When pressed
in the state of the first, '2' returns.
Once '2' is read, it will be set to '1',
and subsequent 'on-state' will
return '1'.
And Bluetooth,
NVIDIA-Shield, Xperia-Play, the controllers are supported. (c.f.
item-Operation)
It corresponds also
to the [X],[Z] key of a hardware keyboard.
[e.g.]
bt =
strig(0)
| UI_INPUT$ |
[Features] With input from the
UI.dialog, and returns the input string.
[Format] UI_INPUT$("Message","Default-text")
[Explanation]
The peculiar character of each country
can be inputted.
Determined by the
input and [OK].
Because when back
button is pushed, dialog disappears,
it is necessary to push and cancel by back button once again then.
[e.g.]
a$=ui_input$("Name","")
| UI_SELECT |
[Features] A selection number
is returned by the item selection from UI dialog.
[Format] UI_SELECT("One-dimensional character array
name","Message")
[Explanation]
It have to declare 'One-dimensional character array' beforehand.
And it substitutes the item name in
order from number '0'.
To specify the
declared array name and the message,
and call then, List-style dialog will appear.
The list is displayed until it hits
empty data.
Touch and select then the
number will be returned.
When Cancel is
pushed, -1 is returned.
[e.g.]
[smp_uisel.bas]
100 dim item$(6)
110 item$(0)="Red"
120 item$(1)="Blue"
130 item$(2)="Yellow"
140 item$(3)="Green"
150 num=ui_select("item$","Color")
160 print num,item$(num)
| UI_MSG |
[Features] Arbitrary message
sentence are displayed several seconds by UI(toast).
[Format] UI_MSG "message"
[Explanation]
[e.g.]
ui_msg"Completed."
| UI_TEXT |
[Features] Arbitrary sentence
are displayed by dialog.
[Format] UI_TEXT "String|TextFilename" [,TextColor]
[,BackColor] [,FontSize]
[Explanation]
When string is specified, directly display it,
when the end of the string is
extension".txt", it is distinguished from a text file,
and the text file is loaded and
displayed.
It can be display a
long sentence by scrolling.
The text
display is affected by encoding specified by [init"enc:"].
It can specify TextColor, BackColor
and FontSize.
[e.g.]
ui_text st$,col(13),,24
ui_text "help.txt"
| HALT |
[Features] It make program
stopping completely, and wait for screen touch interrupt.
[Format] HALT
[Explanation]
It stop completely, so there isn't
consumption of battery like 'pause' command.
When screen is touched and interrupt is
occured,
the execution is
resumed from next command of 'HALT' command.
It can't use inside of user function
'FUNC'.
And button touch selection
become possible in combination with 'UI_BUTTON'.
[e.g.]
halt
| UI_BUTTON |
[Features] It set coordinate
and display buttons, and wait for the button to be selected.
[Format] UI_BUTTON
ButtonNo,Type,"Text",x1,y1,x2,y2,TextColor
[Explanation]
It is used 'HALT' command for selection waiting after display.
By 'UI_BUTTON()' function, selected
button number is acquired.
Button setting format.
ui_button
ButtonNo,Type,"DisplayText",x1,y1,x2,y2,TextColor
-Button No.
It can specify from 1 to 64.
When Button is touched, this number
is returned.
Also, No.0 is used
to display 'menu title'.
-Type
The Button type is specified from 1
to 18.
No.1~No.6 are color
variations of standard Button.
(Blue,Red,Gray,Green,Cyan,Yellow)
When the case of [specified No.0,
Type are omitted]
the Type will
be number 7.(seat type)
-"Text"
The text string that displayed on the
Button.
-Button coordinates
x1,y1,x2,y2
(x1,y1) Upper left of
Button
(x2,y2) Lower right of
Button
These are specified.
By concomitant use of 'LAY()' function,
the resolution difference
between the models are absorbed, easy specification is possible.
-Text Color
To specify the color of "Text".
Button initialize format.
ui_button -1
When only '-1' is described, all
set Buttons are initialized.
Button display format.
ui_button
With parameterless description, all the
set Buttons are displayed.
Since
Buttons are displayed on the text screen,
it is applied with display
priority of Text screen.
After
display complete, please make it waiting of touch selection
with writing 'HALT' command
immediately after.
When the
selection is made, it's possible to acquire
the button number touched by
'UI_BUTTON()' function.
[e.g.] A long sample "smp_button.bas" is also
prepared.
10 ui_button
0,,"Title",250,100,450,200,col(15)
20
ui_button 1,4,"Yes",100,400,300,500,col(15)
30 ui_button 2,4,"No
",400,400,600,500,col(15)
40
ui_button
50 halt
60 print ui_button(0)
| UI_BUTTON (Function) |
[Features] To return the
button number touched. The buttons were set by 'button' command.
[Format] UI_BUTTON(n)
[Explanation]
'n' is a provisional parameter that have
no meaning.
[e.g.]
"smp_button.bas"
| UI_CLIP |
[Features] Copies the
specified string to the clipboard.
[Format] UI_CLIP string
[Explanation]
Strings can also be specified using character variables or character
expressions.
Clipboard data can also
be exchanged with external applications.
[e.g.]
ui_clip
"Data-2000"
| UI_CLIP (Function) |
[Features] Gets and returns
string data from the clipboard.
[Format] UI_CLIP()
[Explanation]
Clipboard data can also be exchanged with external applications.
[e.g.]
a$=ui_clip()
print a$