File: set-window.html

package info (click to toggle)
anyremote 6.7.3-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 6,524 kB
  • sloc: ansic: 16,504; sh: 4,469; python: 111; makefile: 56
file content (295 lines) | stat: -rw-r--r-- 13,571 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">

<head>

	<title>anyRemote &middot; Control your computer with your phone</title>

	<meta http-equiv="Content-type" content="text/html; charset=utf-8" />
	<meta name="description" content="anyRemote project page - Bluetooth remote control tool" />

	<link rel="stylesheet" href="data/master.css" type="text/css" media="all" title="Default Style" charset="utf-8" />
	<script src="data/effects.js" type="text/javascript" charset="utf-8"></script>

	<link rel="alternate" title="Feed" href="data/feed.xml" type="application/rss+xml" />

	<link rel="icon" href="data/logo-favicon.png" type="image/png" />
	<link rel="shortcut icon" href="data/logo-favicon.png" type="image/png" />

</head>

<body id="docs">

	<a class="skip" name="top">&nbsp;</a>
	<a class="skip" href="#content">Skip to content</a>

	<div id="head">
		<div id="logo">
			<h1><a href="index.html"><img src="data/logo-head.png" alt="logo" /> anyRemote</a></h1>
		</div>
		<div id="navigation"><div class="padding">
			<a href="index.html"><span>About</span></a>
			<a href="frontend.html"><span>Screenshots</span></a>
			<a href="dload.html"><span>Download</span></a>
			<a href="docs.html" class="active"><span>Documentation</span></a>
			<a href="faq.html"><span>FAQ</span></a>
			<a href="contacts.html"><span>Contact</span></a>
			<a href="thanks.html"><span>Special Thanks</span></a>
		</div></div>
	</div>

	<div id="sidebar"><div class="padding">
		<dl class="info">
			<dt>Information</dt>
			<dd>
				<p>Please use the two sidebar boxes below to browse through the anyRemote Documentation!</p>
			</dd>
		</dl>
		<dl class="docs">
			<dt>Documentation</dt>
			<dd>
				<ul>
					<li><a href="pre-setup.html">Before install</a></li>
					<li><a href="pre.html">Software prerequisites</a></li>
					<li><a href="install.html">Compilation and installation</a></li>
					<li><a href="mode.html">Which mode to choose ?</a></li>
					<li><strong>Setup</strong>
						<ul>
							<li><a href="setup-at.html">Setup: AT mode</a>
								<ul>
									<li><a href="event.html">Event reporting</a></li>
									<li><a href="ckpd-emulation.html">Keypad emulation events</a></li>
								</ul>
							</li>
							<li><a href="setup-server.html">Setup: Server mode</a></li>
						</ul>
					</li>
					<li><a href="use.html">How to use anyRemote</a>
						<ul>
							<li><a href="android-client.html">Android Client</a></li>
							<li><a href="use-jc.html">J2ME Client</a></li>
							<li><a href="web.html">Web Interface</a></li>
							<li><a href="cm-xml.html">XML Services Interface</a></li>
							<li><a href="cfg-howto.html">How to create simple configuration file</a></li>
							<li><a href="bemused.html">Bemused Support</a></li>
							<li><a href="iviewer.html">Command Fusion iViewer support</a></li>
						</ul>
					</li>
					<li><a href="devices.html">Tested devices</a></li>
					<li><a href="phones.html">Phone specific details</a></li>
					<li><a href="tips-tricks.html">Tips &amp; tricks</a></li>
					<li><a href="man.html">Man page</a></li>
				</ul>
			</dd>
		</dl>
		<dl class="docs-advanced">
			<dt>Advanced</dt>
			<dd>
				<ul>
					<li><a href="http://elpraga.bshellz.net/HOWTOstartanyRemoteatboottime.html">miniHOWTO: start anyRemote at boot time and create a multimedia computer</a> (externally maintained)</li>
					<li><strong>Format of configuration files</strong>
						<ul>
							<li><strong>Server mode</strong>
								<ul>
									<li><a href="conf-server.html">Configuration file format</a></li>
									<li><a href="conf-server-ex.html">Configuration file examples</a></li>

									<li><a href="set.html">Set(...) / ExecAndSet(...) commands</a></li>
									<li><a href="set-fm.html">Set(filemanager ... ) command</a></li>
									<li><a href="set-icons.html">Set(icons ...) command and available icon set</a></li>
									<li><a href="set-list.html">Set(list ... ) and Set(iconlist ... ) commands</a></li>
									<li><a href="set-menu.html">Set(menu ... ) command</a></li>
									<li><a href="set-parameter.html">Set(parameter, ... ) commands</a></li>
									<li><a href="set-text.html">Set(text ... ) command</a></li>
									<li><a href="set-window.html">Set(image ... ) command</a></li>
								</ul>
							</li>
							<li><strong>AT mode</strong>
								<ul>
									<li><a href="conf-at.html">Configurational file format</a></li>
									<li><a href="conf-at-ex.html">Configurational file examples</a></li>
								</ul>
							</li>
							<li><strong>Common</strong>
								<ul>
									<li><a href="make.html">Make(...) command</a></li>
									<li><a href="emulate.html">Emulate(...) command</a></li>
									<li><a href="dbus.html">Dbus(...) command</a></li>
									<li><a href="vars.html">Variable substitution</a></li>
									<li><a href="ev-handlers.html">Event handlers</a></li>
									<li><a href="icon-themes.html">Icon themes for J2ME client</a></li>
								</ul>
							</li>
						</ul>
					</li>
				        <li><a href="ir.html">anyRemote and InfraRed</a></li>
				</ul>
			</dd>
		</dl>
		<dl class="contact">
			<dt>Contact</dt>
			<dd>
				<p>We will be pleased for any questions, suggestions, patches and examples of configuration files!</p>
				<ul>
					<li>Post in the <a href="http://sourceforge.net/forum/?group_id=162923">Forum</a></li>
					<li>Please, send e-mails to  <a href="mailto:anyremote&#64;mail&#46;ru">anyremote&#64;mail&#46;ru</a></li>
				</ul>
			</dd>
		</dl>
		<!--HOSTINGLOGO-->
	</div></div> <!-- sidebar -->

	<div id="content"><div class="padding">

		<a class="skip" name="content">&nbsp;</a>

		<h1>Set(image ... ) command</h1>

		<p><img class="float-right" alt="Image view screen" src="data/view-screen.jpg" />
		This command used to show images on screen of cell phone or upload icons and covers to the phone internal memory.</p>

		<h2>Format</h2>
		
		<p><strong>Set(image,window,_image_file_name)</strong> or</p>
		<p><strong>ExecAndSet(image,window, ... command to determine image file name ...)</strong> or</p>
		<br>
		<p><strong>Set(image,show|close|cursor|nocursor|dynamic_cursor|set_cursor)</strong> or</p>
		<br>
        <p><strong>Set(image,icon,_icon_name_,_image_file_name_)</strong> or</p>
		<p><strong>ExecAndSet(image,icon,_icon_name_, ... command to determine image file name ...)</strong> or</p>
		<br>
		<p><strong>Set(image,cover,_cover_name_,_image_file_name_)</strong> or</p>
		<p><strong>ExecAndSet(image,cover,_cover_name_, ... command to determine image file name ...)</strong> or</p>
		<br>
		<p><strong>Set(image,remove,all|icons|covers)</strong></p>
		<p><strong>Set(image,clear_cache)</strong></p>

		<h2>Usage</h2>

		<h3>Set(image,window ...)</h3>

		<p>Command <strong>Set(image,window,_image_file_name)</strong> used to show image on screen of cell phone. 
        Of cource in most cases this should be <a href="set.html">ExecAndSet(...)</a> variant of command. 
        See cfg-example/Server-mode/winManager.cfg for details.</p>
		
		<pre>1=ExecAndSet(image,window,echo "$IMAGE_DIR/image.png")</pre>

		<h3>Set(image,show)</h3>

		<p>Command <strong>Set(image,show)</strong> used to show previously uploaded image.</p>
		
		<pre>2=Set(image,show)</pre>

		<h3>Set(image,close)</h3>

		<p>Command <strong>Set(image,close)</strong> used to close screen with image and return back to main screen.</p>
		
		<pre>3=Set(image,close)</pre>

		<h3>Set(image,cursor|nocursor)</h3>

		<p>Note: Supported in <a href="use-jc.html">J2ME client</a> only</p>
		<p>Command <strong>Set(image,cursor|nocursor)</strong> used to specify should or should not the cursor cross 
        will be drawn over the image. If this option is set to "cursor" then it will be possible to move cursor cross with 
        the joystick keys and if user pushes the joystick key, then two replies <strong>PressedX(x_coord,)</strong> and <strong>PressedY(y_coord,)</strong> 
        will be sent. <strong>PressedX()</strong> event will be first one.</p>

		<pre>4=Set(image,nocursor)</pre>

		<h3>Set(image,dynamic_cursor)</h3>

		<p>Note: Supported in <a href="use-jc.html">J2ME client</a> only</p>
		<p>Command <strong>Set(image,dynamic_cursor)</strong> Is similar to <strong>Set(image,cursor)</strong>, 
        but each time user press joystrick key two replies <strong>PosX(x_coord,)</strong> and <strong>PosY(y_coord,)</strong> will be sent. 
        <strong>PosX()</strong> event will be first one.</p>

		<pre>5=Set(image,dynamic_cursor)</pre>

		
        <h3>Set(image,set_cursor ...)</h3>

		<p>Note: Supported in <a href="use-jc.html">J2ME client</a> only</p>
		<p>Command <strong>Set(image,set_cursor, x_coord, y_coord)</strong> used to set cursor position on screen of cell phone.</p>
		
		<pre>6=Set(image,set_cursor,0,0)</pre>

        <p>To retrieve current cursor position use <a href="conf-server.html">Get(cursor)</a> command.</p>
		
        <h3><a name="image-icon">Set(image,icon ...)</a></h3>

		<p>Command <strong>Set(image,icon,_icon_name_,_image_file_name)</strong> used to upload 16x16, 32x32, 48x48, 64x64, 96x96 or 128x128 icons, 
		which could be used in <a href="set-icons.html">Set(icons,...)</a> command. Of cource in most cases this should be 
        <a href="set.html">ExecAndSet(...)</a> variant of command. 
		See cfg-example/Server-mode/iconUpload.cfg for details.</p>
                
		<pre>7=ExecAndSet(image,icon,echo "$IMAGE_NAME,$IMAGE_DIR/image.png")</pre>
		
		<p>Only 16x16, 32x32, 48x48, 64x64, 96x96 or 128x128 PNG icons could be uploaded. There is no way to show the list of uploaded icons.</p>
	    <p>All uploaded icons could be removed by <strong>Set(image,remove,icons)</strong> command.</p>
	    <p>All icons used by J2ME client cached in phone's memory. 
        It is possible to cleanup that cache by <strong>Set(image,clear_cache)</strong> command.</p>

		<h3>Icon auto-uploading</h3>
                
		<p>anyRemote Android/J2ME clients supports icon auto-uploading. So, if there is a command</p>
		<pre>1=Set(icons,TheTitle,1,my-new-icon);</pre>
		<p> and <strong>my-new-icon.png</strong> is absent in Android/J2ME client, then anyRemote will search it in 
		<strong>$HOME/.anyRemote/Icons/_icon_size_</strong> and <strong><a href="vars.html">$(CfgDir)</a>/Icons/_icon_size_</strong>
        directories and automatially upload it to the phone if found (_icon_size_ can be 16, 32, 48, 64, 96 or 128).</p>
		
        <p>It is not recommended to use this feature with J2ME client on Samsung phones because of <a href="phones.html#G600">terrible upload speed</a>.</p> 		

        <h3><a name="image-icon">Set(image,cover ...)</a></h3>

		<p>Command <strong>Set(image,cover,_cover_name_,_image_file_name)</strong> used to upload cover images, 
		which could be used in <a href="set.html#sec-cover">Set(cover,by_name,...)</a> command. Of cource in most cases this should be 
        <a href="set.html">ExecAndSet(...)</a> variant of command.</p>
                
		<pre>7=ExecAndSet(image,cover,echo "my_cover,/tmp/cover_art.png")</pre>
		
		<p>For each connected client anyRemote will automatically scale cover to the appropriate size. 
        It is possible to use command <a href="conf-server.html#sec-cover-size">Get(cover_size)</a> to determine 
        appropriate size of cover image, but in general there are no needs to run this command explicitly because 
        anyRemote executes it by itself upon connection to/from client.</p>
        <p>There is no way to show the list of uploaded covers.</p>
	    <p>All uploaded covers could be removed by <strong>Set(image,remove,covers)</strong> command.</p>

		<h3>Cover auto-uploading</h3>
                
		<p>anyRemote Android/J2ME clients supports cover images auto-uploading. So, if there is a command</p>
		<pre>1=Set(cover,by_name,my-cover-art);</pre>
		<p> and <strong>my-cover-art.png</strong> cover image is absent in Android/J2ME client, then anyRemote will search it in 
		<strong>$HOME/.anyRemote/Covers</strong> and <strong><a href="vars.html">$(CfgDir)</a>/Icons/common</strong> 
        directories and automatially upload it to the phone if found. anyRemote will scale cover image to appropriate size by itself.
        To work properly this feature needs to have <a href="http://www.imagemagick.org">ImageMagick</a> installed.</p>
		
        <p>It is not recommended to use this feature with J2ME client on Samsung phones because of <a href="phones.html#G600">terrible upload speed</a>.</p> 		
        <p>Also, it needs to use this feature with care if using Bluetooth connection.</p> 		

		<h3>Set(image,remove,all|icons|covers)</h3>

		<p>Command <strong>Set(image,remove,...)</strong> used to remove all previously uploaded icons or covers.</p>
		
		<pre>0=Set(image,remove,all)
1=Set(image,remove,icons)</pre>

		<h3>Set(image,clear_cache)</h3>

		<p>Note: Supported in <a href="use-jc.html">J2ME client</a> only</p>
		<p>Command <strong>Set(image,clear_cache)</strong> used to cleanup cache of used icons on J2ME client.</p>
		
		<pre>1=Set(image,clear_cache)</pre>

		<h2>Retrieving size of the screen</h2>

		<p>To retrive size of the screen of the cellphone it is possible to use <a href="conf-server.html#sec-get">Get(screen_size)</a> command.</p>

	</div></div> <!-- content -->

	<div id="foot">
		<p>Maintained by <a href="mailto:anyremote&#64;mail&#46;ru">anyRemote</a>. Website by <a href="http://www.martinlettner.info">m.lettner</a>.</p>
	</div>

</body>
</html>