Ricoh InfoPrint Pro C900AFP InfoPrint Manager - Page 207

Understanding transform objects and the configurable transform subsystem, Transforms

Page 207 highlights

Chapter 16. Understanding transform objects and the configurable transform subsystem Transforms This chapter contains information about the following: v "Transforms" v "Defining a transform sequence" on page 194 v "Configuring transforms" on page 195 v "Examples of creating transform objects" on page 200 Transforms are InfoPrint objects (like queues and destinations) that you create and configure in InfoPrint Manager. Transforms receive data in a particular format or formats, process the data in some way, and output the changed data. When you create a transform, you have complete control over what data format or formats it operates on and what type of processing it does. The processing that the transform performs can be anything from simply copying the data to a different place on disk, to filtering the data stream that the transform receives (for example, to remove a particular PostScript order), to transforming the data to a completely different format (for example, converting PCL to AFP). When you create a transform, you specify several things, including: v Input data format The data stream that is sent to the transform. The input data format is what the transform uses to determine whether it has any work to do. If you send a PostScript job through a transform that has its input data stream set only to PCL, the job will bypass the transform without being changed at all. You can set the transform to accept multiple input data formats. v Transform options The program or command that actually does the work of the transform; what happens during the processing stage. The transform options can be system commands (such as copy), programs provided with InfoPrint Manager (such as ps2afp), or your own custom transform programs (for example, mypclfixup). When you create a transform, you specify the complete command line needed to invoke this program or command. Within this command line, you can also specify various substitution variables, place holders which InfoPrint Manager replaces with a value when InfoPrint Manager runs the transform. For example, if you include %i in the line, InfoPrint Manager will replace it with the name of the file that the transform receives; if you include %o, it will be replaced with the name of the file that the transform needs to put the changed data into. v Output data format The output data format is the data stream that results from the transform. You can only specify one output data format. In addition, you can specify whether you want the file that the transform produces to be printed. If the transform does not return the file to be printed (for example, if the transform completes its processing and saves the file to a different location), it is called a terminating transform. In addition to the terminating transform, you can © Copyright InfoPrint Solutions Company 1998, 2010 193

  • 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

Chapter 16. Understanding transform objects and the
configurable transform subsystem
This chapter contains information about the following:
v
“Transforms”
v
“Defining a transform sequence” on page 194
v
“Configuring transforms” on page 195
v
“Examples of creating transform objects” on page 200
Transforms
Transforms
are InfoPrint objects (like queues and destinations) that you create and
configure in InfoPrint Manager. Transforms receive data in a particular format or
formats, process the data in some way, and output the changed data. When you
create a transform, you have complete control over what data format or formats it
operates on and what type of processing it does. The processing that the transform
performs can be anything from simply copying the data to a different place on
disk, to filtering the data stream that the transform receives (for example, to
remove a particular PostScript order), to transforming the data to a completely
different format (for example, converting PCL to AFP).
When you create a transform, you specify several things, including:
v
Input data format
The data stream that is sent to the transform. The input data format is what the
transform uses to determine whether it has any work to do. If you send a
PostScript job through a transform that has its input data stream set only to
PCL
, the job will bypass the transform without being changed at all. You can set
the transform to accept multiple input data formats.
v
Transform options
The program or command that actually does the work of the transform; what
happens during the
processing
stage. The transform options can be system
commands (such as
copy
), programs provided with InfoPrint Manager (such as
ps2afp
), or your own custom transform programs (for example,
mypclfixup
).
When you create a transform, you specify the complete command line needed to
invoke this program or command. Within this command line, you can also
specify various
substitution variables
, place holders which InfoPrint Manager
replaces with a value when InfoPrint Manager runs the transform. For example,
if you include
%i
in the line, InfoPrint Manager will replace it with the name of
the file that the transform receives; if you include
%o
, it will be replaced with the
name of the file that the transform needs to put the changed data into.
v
Output data format
The output data format is the data stream that results from the transform. You
can only specify one output data format.
In addition, you can specify whether you want the file that the transform produces
to be printed. If the transform does not return the file to be printed (for example, if
the transform completes its processing and saves the file to a different location), it
is called a
terminating transform
. In addition to the
terminating transform
, you can
© Copyright InfoPrint Solutions Company 1998, 2010
193