Epson TM-m50II ePOS-Print XML Users Manual - Page 146

<registerdownloadimage>, Attribute, Supplementary explanation

Page 146 highlights

Chapter 4 XML Reference - XML for Controlling Customer Display Specifies the raster format image data. (Data format xs:base64Binary) The specified image data can be registered in the download graphics area of customer display, and can be called by . Attribute key1 Attribute value "48" to "57", "65" to "90", "97" to "122" key2 Specifies keycode 1. Description Attribute value "48" to "57", "65" to "90", "97" to "122" Specifies keycode 2. Description Supplementary explanation ❏ Attribute key 1 and key 2 are attributes that must be set. ❏ This element cannot be used simultaneously with other elements. After executing this element, do not execute any other elements until the callback is returned. ❏ Execute this element one time only for each , and register images one at a time. ❏ If success is not returned in by the execution results, including the results of this element, restart the printer. Depending on the system environment, it may take some time for the recovery process. ❏ If the power supply to the customer display is cut off, the registered image is erased. ❏ As the data size of the image to be registered increases, the processing time becomes longer. (Max. 320 seconds) ❏ If the data size of the image to be registered is large, and the communication environment is poor, the image may not be registered in this element. If the image cannot be registered in this element, use dedicated Utility software. For details on the dedicated Utility software, refer to the Technical Reference Guide of each customer display. ❏ If an image is registered in the specified keycode, it is overwritten and registered. ❏ Image data expressed in the pixel format of YCbCr422 or YCbCr420 can be used. ❏ The image size should be about 100 KB although the upper limit of the image size is 1.5 MB. ❏ Total size of images that can be registered is 1.5 MB. This element converts the image format and pixel count so that the customer displays can process the images and then register them. The conversion processing may increase the size of images, so ensure that there is sufficient free space in the download graphics area to accommodate the total size of the images to be registered. No error is returned when registration was not successful due to insufficient free space in the download graphics area. 146

  • 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
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418
  • 419
  • 420
  • 421
  • 422
  • 423
  • 424
  • 425
  • 426
  • 427
  • 428
  • 429
  • 430
  • 431
  • 432
  • 433
  • 434
  • 435
  • 436
  • 437
  • 438
  • 439

146
Chapter 4
XML Reference - XML for Controlling Customer Display
<registerdownloadimage>
Specifies the raster for
m
at i
m
age data. (Data for
m
at xs:base64Binar
y
)
The specified i
m
age data can be registered in the download graphics area of custo
m
er displa
y
, and can be called
b
y
<downloadi
m
age>
.
Attribute
key1
key2
Supplementary explanation
Attribute ke
y
1 and ke
y
2 are attributes that
m
ust be set.
This ele
m
ent cannot be used si
m
ultaneousl
y
with other ele
m
ents.
After executing this ele
m
ent, do not execute an
y
other ele
m
ents until the callback is returned.
Execute this ele
m
ent one ti
m
e onl
y
for each
<epos-displa
y
>
, and register i
m
ages one at a ti
m
e.
If success is not returned in
<epos-displa
y
>
b
y
the
<response>
execution results, including the results of
this ele
m
ent, restart the printer.
Depending on the s
y
ste
m
environ
m
ent, it
m
a
y
take so
m
e ti
m
e for the recover
y
process.
If the power suppl
y
to the custo
m
er displa
y
is cut off, the registered i
m
age is erased.
As the data size of the i
m
age to be registered increases, the processing ti
m
e beco
m
es longer. (Max. 320
seconds)
If the data size of the i
m
age to be registered is large, and the co
mm
unication environ
m
ent is poor, the
i
m
age
m
a
y
not be registered in this ele
m
ent.
If the i
m
age cannot be registered in this ele
m
ent, use dedicated Utilit
y
software.
For details on the dedicated Utilit
y
software, refer to the Technical Reference Guide of each custo
m
er dis-
pla
y
.
If an i
m
age is registered in the specified ke
y
code, it is overwritten and registered.
I
m
age data expressed in the pixel for
m
at of YCbCr422 or YCbCr420 can be used.
The i
m
age size should be about 100 KB although the upper li
m
it of the i
m
age size is 1.5 MB.
Total size of i
m
ages that can be registered is 1.5 MB.
This ele
m
ent converts the i
m
age for
m
at and pixel count so that the custo
m
er displa
y
s can process the
i
m
ages and then register the
m
. The conversion processing
m
a
y
increase the size of i
m
ages, so ensure
that there is sufficient free space in the download graphics area to acco
mm
odate the total size of the
i
m
ages to be registered.
No error is returned when registration was not successful due to insufficient free space in the download
graphics area.
Attribute value
Description
"48" to "57", "65" to "90", "97" to "122"
Specifies ke
y
code 1.
Attribute value
Description
"48" to "57", "65" to "90", "97" to "122"
Specifies ke
y
code 2.