Sony XVS-7000 Users Guide - Page 536

Macro File Editing Rules, Macro File Syntax, Syntax of Event and Continue, Statements, File Name

Page 536 highlights

Macro File Editing Rules When editing a macro file, observe the following rules. Macro File Syntax The macro file syntax is as follows. File format The file is in CSV (comma-separated value) format. Newline code CR (ASCII code 0D), LF (ASCII code 0A), or CRLF may be used. Statement syntax There are four types of statement, each terminated by a newline code. File header: This must always appear as the first line of the file. It comprises 28 characters, as follows. Example: PNL (space) 0001PNL_rrrr.PMRnnnnnnnn rrrr: Macro register number (0001 to 0250) nnnnnnnn: In a file created on the switcher, this is a register name automatically set by the switcher. When creating a new file, it is recommended to set this to be the same as the file name (see page 536). The name is limited to eight characters. The following characters may not be used. space comma), . (period Comment: Begins with "#". The content of the line following the "#" up to the next newline has no effect on macro execution, and can be used as a comment. Note Comments can be used on the local drive or a removable drive only. When you load a macro file into a register, the comments are discarded. Event statement: Begins with "Event?", and defines the macro event content (see page 536). Continue statement: Begins with "Continue?", and defines the macro event content (see page 536). Some events cannot be used (see page 537). Syntax of Event and Continue Statements An event can be written with an Event statement only, or with an Event statement followed by any number of Continue statements. Event statements and Continue statements have the following syntax. Word separator character Use "," (comma). Ignored Spaces and tabs are ignored. There is no distinction between lowercase and uppercase. If two or more separator characters appear consecutively, later ones are ignored. Separator characters at the beginning of a line are also ignored. Content of line Must begin with "Event?" or "Continue?", followed by symbols and parameters. Event?,[symbol],[parameter],[parameter],... Continue?,[symbol],[parameter],[parameter],... symbol: Type of event (ASCII character string) (see page 537). parameter: Shows details of an event. Consists of parameter names and arguments, and these must appear in pairs. The number and type of parameters depends on the event (see page 539). If the same parameter appears two or more times, the rightmost occurrence is valid. How to use Continue statements When a single parameter has more than one argument, use a Continue statement. This section describes a snapshot event as an example. An event to recall a snapshot in region M/E-1 is written as: Event?,Snapshot,Region?,ME1,Register?,1, Attribute?,Off,Time?,Current In the Event statement, only one region can be specified. To specify both regions M/E-1 and DME1, use a Continue statement, thus: Event?,Snapshot,Region?,ME1,Register?,1, Attribute?,Off,Time?,Current Continue?,Snapshot,Region?,DME1,Register?,1, Attribute?,Off,Time?,Current To specify more than one argument for a region parameter, follow the Event statement by a Continue statement on the next line. File Name Set the file name as follows. Example: nnnnnnnn.PNL_rrrr.PMR nnnnnnnn: In a file created on the switcher, this is a register name automatically set by the switcher. The name for a new file is limited to eight characters. The following characters may not be used. space comma), . (period rrrr: macro register number (0001 to 0250) 536

  • 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
  • 440
  • 441
  • 442
  • 443
  • 444
  • 445
  • 446
  • 447
  • 448
  • 449
  • 450
  • 451
  • 452
  • 453
  • 454
  • 455
  • 456
  • 457
  • 458
  • 459
  • 460
  • 461
  • 462
  • 463
  • 464
  • 465
  • 466
  • 467
  • 468
  • 469
  • 470
  • 471
  • 472
  • 473
  • 474
  • 475
  • 476
  • 477
  • 478
  • 479
  • 480
  • 481
  • 482
  • 483
  • 484
  • 485
  • 486
  • 487
  • 488
  • 489
  • 490
  • 491
  • 492
  • 493
  • 494
  • 495
  • 496
  • 497
  • 498
  • 499
  • 500
  • 501
  • 502
  • 503
  • 504
  • 505
  • 506
  • 507
  • 508
  • 509
  • 510
  • 511
  • 512
  • 513
  • 514
  • 515
  • 516
  • 517
  • 518
  • 519
  • 520
  • 521
  • 522
  • 523
  • 524
  • 525
  • 526
  • 527
  • 528
  • 529
  • 530
  • 531
  • 532
  • 533
  • 534
  • 535
  • 536
  • 537
  • 538
  • 539
  • 540
  • 541
  • 542
  • 543
  • 544
  • 545
  • 546
  • 547
  • 548
  • 549
  • 550
  • 551
  • 552
  • 553
  • 554
  • 555
  • 556
  • 557
  • 558
  • 559
  • 560
  • 561
  • 562
  • 563
  • 564
  • 565
  • 566
  • 567

536
Macro File Editing Rules
When editing a macro file, observe the following rules.
Macro File Syntax
The macro file syntax is as follows.
File format
The file is in CSV (comma-separated value) format.
Newline code
CR (ASCII code 0D), LF (ASCII code 0A), or CRLF may
be used.
Statement syntax
There are four types of statement, each terminated by a
newline code.
File header:
This must always appear as the first line of
the file. It comprises 28 characters, as follows.
Example: PNL (space) 0001PNL_rrrr.PMRnnnnnnnn
rrrr: Macro register number (0001 to 0250)
nnnnnnnn: In a file created on the switcher, this is a
register name automatically set by the switcher.
When creating a new file, it is recommended to set this
to be the same as the file name
(see page 536)
.
The name is limited to eight characters.
The following characters may not be used.
space, \, /, :, ;, , (comma), . (period), <, >, *, ?, ", |
Comment:
Begins with “#”. The content of the line
following the “#” up to the next newline has no effect
on macro execution, and can be used as a comment.
Comments can be used on the local drive or a
removable drive only. When you load a macro file into
a register, the comments are discarded.
Event statement:
Begins with “Event?”, and defines the
macro event content
(see page 536)
.
Continue statement:
Begins with “Continue?”, and
defines the macro event content
(see page 536)
.
Some events cannot be used
(see page 537)
.
Syntax of Event and Continue
Statements
An event can be written with an Event statement only, or
with an Event statement followed by any number of
Continue statements. Event statements and Continue
statements have the following syntax.
Word separator character
Use “,” (comma).
Ignored
Spaces and tabs are ignored. There is no distinction
between lowercase and uppercase. If two or more
separator characters appear consecutively, later ones are
ignored. Separator characters at the beginning of a line are
also ignored.
Content of line
Must begin with “Event?” or “Continue?”, followed by
symbols and parameters.
Event?,[symbol],[parameter],[parameter],…
Continue?,[symbol],[parameter],[parameter],…
symbol:
Type of event (ASCII character string)
(see
page 537)
.
parameter:
Shows details of an event. Consists of
parameter names and arguments, and these must
appear in pairs. The number and type of parameters
depends on the event
(see page 539)
.
If the same parameter appears two or more times, the
rightmost occurrence is valid.
How to use Continue statements
When a single parameter has more than one argument, use
a Continue statement.
This section describes a snapshot event as an example.
An event to recall a snapshot in region M/E-1 is written as:
Event?,Snapshot,Region?,ME1,Register?,1,
Attribute?,Off,Time?,Current
In the Event statement, only one region can be specified.
To specify both regions M/E-1 and DME1, use a Continue
statement, thus:
Event?,Snapshot,Region?,ME1,Register?,1,
Attribute?,Off,Time?,Current
Continue?,Snapshot,Region?,DME1,Register?,1,
Attribute?,Off,Time?,Current
To specify more than one argument for a region parameter,
follow the Event statement by a Continue statement on the
next line.
File Name
Set the file name as follows.
Example: nnnnnnnn.PNL_rrrr.PMR
nnnnnnnn: In a file created on the switcher, this is a
register name automatically set by the switcher.
The name for a new file is limited to eight characters.
The following characters may not be used.
space, \, /, :, ;, , (comma), . (period), <, >, *, ?, ", |
rrrr: macro register number (0001 to 0250)
Note