Adobe 65018518 User Guide - Page 375

Print or delete a print job, Printing frames independent of the PrintJob class

Page 375 highlights

USING FLASH CS4 PROFESSIONAL 370 ActionScript • 72 points = 1 inch • 567 twips = 1 cm • 1440 twips = 1 inch To scale a movie clip before printing, set its MovieClip.xscale and MovieClip.yscale properties before calling this method, and set them back to their original values afterward. If you scale a movie clip and also pass a value for the printArea property, the pixel values passed to printAreareflect the original size of the movie clip. That is, if you set a movie clip's scale to 50% and specify a print area of 500 x 500 pixels, the content that prints is identical to the content that would print if you didn't scale the movie clip; however, it prints at half the size. For more information, see the addPage (PrintJob.addPage method)method of the printjob class in the ActionScript 2.0 Language Reference. Specifying printing as a vector image or bitmap graphic The options parameter lets you specify whether to print as a vector graphic or bitmap image. When using this optional parameter, use the following syntax: {printAsBitmap:boolean} The default value is false, which represents a request for vector printing. Remember the following suggestions when determining which value to use: • If the content that you're printing includes a bitmap image, specify that the print job print as a bitmap to include any transparency and color effects. • Conversely, if the content does not include bitmap images, specify that the print job print as vector graphics to take advantage of the higher image quality. Specifying a frame to print The frameNum parameter lets you specify a frame to print. If you do not specify a frame number parameter, by default the current frame of the target or level that you specify as the first parameter when you add a page prints. Print or delete a print job 1 To send a print job to the printer after using the ActionScript 2.0 addPage() calls, use the PrintJob.send() method, which causes Flash Player to stop spooling the print job so that the printer starts printing. 2 To delete the print job after you send the print job to a printer, use the delete PrintJob() ActionScript function to delete the PrintJob object, which frees memory. Printing frames independent of the PrintJob class The ActionScript 2.0 PrintJob class, available for Flash Player 7 and later, offers many advantages over the print() and printAsBitmap() methods for printing. However, to print targeting Flash Player 6 and earlier versions, back to Flash Player 4.0.25 (Windows) and 4.0.20 (Macintosh), use print() and printAsBitmap() functions and frame labels. To set up printing from Flash Player independent of the PrintJob class, specify frames to print and set their print area. Specifying a print area when not using the PrintJob object By default, when frames are printed, the document file's Stage determines the print area. Any object that extends off the Stage is clipped and does not print. Loaded movies use their own Stage size for the print area, not the main SWF file's Stage size. Updated 5 March 2009

  • 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

370
USING FLASH CS4 PROFESSIONAL
ActionScript
72 points = 1 inch
567 twips = 1 cm
1440 twips = 1 inch
To scale a movie clip before printing, set its
MovieClip.xscale
and
MovieClip.yscale
properties before calling
this method, and set them back to their original values afterward. If you scale a movie clip and also pass a value for
the
printArea
property, the pixel values passed to
printArea
reflect the original size of the movie clip. That is, if
you set a movie clip’s scale to 50% and specify a print area of 500 x 500 pixels, the content that prints is identical to
the content that would print if you didn’t scale the movie clip; however, it prints at half the size. For more
information, see the addPage (PrintJob.addPage method)method of the
printjob
class in the
ActionScript 2.0
Language Reference
.
Specifying printing as a vector image or bitmap graphic
The
options
parameter lets you specify whether to print as a vector graphic or bitmap image. When using this
optional parameter, use the following syntax:
{printAsBitmap:boolean}
The default value is
false
, which represents a request for vector printing. Remember the following suggestions when
determining which value to use:
If the content that you’re printing includes a bitmap image, specify that the print job print as a bitmap to include
any transparency and color effects.
Conversely, if the content does not include bitmap images, specify that the print job print as vector graphics to take
advantage of the higher image quality.
Specifying a frame to print
The
frameNum
parameter lets you specify a frame to print. If you do not specify a frame number parameter, by default
the current frame of the target or level that you specify as the first parameter when you add a page prints.
Print or delete a print job
1
To send a print job to the printer after using the ActionScript 2.0
addPage()
calls, use the
PrintJob.send()
method, which causes Flash Player to stop spooling the print job so that the printer starts printing.
2
To delete the print job after you send the print job to a printer, use the
delete PrintJob()
ActionScript function
to delete the PrintJob object, which frees memory.
Printing frames independent of the PrintJob class
The ActionScript 2.0 PrintJob class, available for Flash Player 7 and later, offers many advantages over the
print()
and
printAsBitmap()
methods for printing. However, to print targeting Flash Player 6 and earlier versions, back to
Flash Player 4.0.25 (Windows) and 4.0.20 (Macintosh), use
print()
and
printAsBitmap()
functions and frame
labels.
To set up printing from Flash Player independent of the PrintJob class, specify frames to print and set their print area.
Specifying a print area when not using the PrintJob object
By default, when frames are printed, the document file’s Stage determines the print area. Any object that extends off
the Stage is clipped and does not print. Loaded movies use their own Stage size for the print area, not the main SWF
file’s Stage size.
Updated 5 March 2009