Home » Adobe Manuals » Computer Software » Adobe 65036570 » Manual Viewer

Adobe 65036570 Scripting Guide - Page 987

quality (3D

UPC - 883919173603

Add to My Manuals
Save this manual to your list of manuals

Page 987 highlights

ADOBE DIRECTOR 11.0 950 Scripting Dictionary • #autoHigh-Director starts by rendering the sprite with anti-aliasing. If the actual frame rate falls below the movie's specified frame rate, Director turns off anti-aliasing. This setting gives precedence to playback speed over visual quality. • #autoLow-Director starts by rendering the movie without anti-aliasing. If the Flash player determines that the computer processor can handle it, anti-aliasing is turned on. This setting gives precedence to visual quality whenever possible. • #high (default)-The movie always plays with anti-aliasing. • #low-The movie always plays without anti-aliasing. The quality property can be tested and set. Example The following sprite script checks the color depth of the computer on which the movie is playing. If the color depth is set to 8 bits or less (256 colors), the script sets the quality of the sprite in channel 5 to #low. -- Lingo syntax on beginSprite me if _system.colorDepth

Section	Page
Contents	4
Chapter 1: Introduction	38
Intended audience	38
What’s new with Director scripting	38
What’s new in this documentation	39
Finding information about scripting in Director	40
Chapter 2: Director Scripting Essentials	41
Types of scripts	41
Scripting terminology	42
Scripting syntax	44
Data types	47
Literal values	49
Variables	51
Operators	55
Conditional constructs	58
Events, messages, and handlers	63
Linear lists and property lists	68
JavaScript syntax arrays	74
Chapter 3: Writing Scripts in Director	78
Choosing between Lingo and JavaScript syntax	78
Scripting in dot syntax format	79
Introducing the Director objects	80
Object model diagrams	81
Top-level functions and properties	82
Introduction to object-oriented programming in Director	83
Object-oriented programming with Lingo syntax	84
Object-oriented programming with JavaScript syntax	93
Writing scripts in the Script window	101
Chapter 4: Debugging Scripts in Director	113
Good scripting habits	113
Basic debugging	114
Debugging in the Script window	116
Debugging in the Message window	117
Debugging in the Object inspector	120
Debugging in the Debugger window	123
Debugging projectors and Shockwave movies	127
Advanced debugging	128
Chapter 5: Director Core Objects	130
Cast Library	130
Global	131
Key	132
Member	133
Mouse	134
Movie	135
Player	137
Sound	139
Sound Channel	140
Sprite	141
Sprite Channel	143
System	144
Window	145
Chapter 6: Media Types	147
Animated GIF	147
Bitmap	148
Button	148
Color Palette	149
Cursor	150
DVD	150
Field	152
Film Loop	153
Flash Component	153
Flash Movie	154
Font	156
Linked Movie	156
QuickTime	157
RealMedia	158
Shockwave 3D	159
Shockwave Audio	159
Sound	161
Text	161
Vector Shape	162
Windows Media	163
Chapter 7: Scripting Objects	165
Fileio	165
MUI Xtra	166
NetLingo	166
SpeechXtra	167
XML Parser	168
Chapter 8: 3D Objects	169
Camera	169
Group	170
Light	171
Member	172
Model	174
Model Resource	175
Motion	175
Renderer Services	176
Shader	176
Sprite	177
Texture	178
Chapter 9: Constants	179
\	179
BACKSPACE	179
EMPTY	180
ENTER	180
FALSE	181
PI	181
QUOTE	182
RETURN (constant)	182
SPACE	183
TAB	183
TRUE	184
VOID	185
Chapter 10: Events and Messages	186
on activateApplication	186
on activateWindow	187
on beginSprite	187
on closeWindow	188
on cuePassed	189
on deactivateApplication	190
on deactivateWindow	191
on DVDeventNotification	191
on endSprite	194
on enterFrame	195
on EvalScript	196
on exitFrame	198
on getBehaviorDescription	199
on getBehaviorTooltip	199
on getPropertyDescriptionList	200
on hyperlinkClicked	201
on idle	202
on isOKToAttach	203
on keyDown	204
on keyUp	205
on mouseDown (event handler)	206
on mouseEnter	208
on mouseLeave	209
on mouseUp (event handler)	210
on mouseUpOutside	211
on mouseWithin	211
on moveWindow	212
on openWindow	213
on prepareFrame	213
on prepareMovie	214
on resizeWindow	215
on rightMouseDown (event handler)	216
on rightMouseUp (event handler)	216
on runPropertyDialog	217
on savedLocal	218
on sendXML	218
on startMovie	219
on stepFrame	220
on stopMovie	221
on streamStatus	222
on timeOut	223
trayIconMouseDoubleClick	223
trayIconMouseDown	224
trayIconRightMouseDown	225
on zoomWindow	225
Chapter 11: Keywords	227
\\ (continuation)	227
case	227
char...of	228
end	229
end case	229
exit	230
exit repeat	230
field	231
global	231
if	232
INF	234
item...of	234
line...of	235
loop (keyword)	236
me	236
menu	237
NAN	238
next	239
next repeat	239
on	240
otherwise	240
property	241
put...after	242
put...before	242
put...into	243
repeat while	244
repeat with	244
repeat with...down to	245
repeat with...in list	246
return (keyword)	247
set...to, set...=	248
sprite...intersects	248
sprite...within	249
version	250
word...of	250
Chapter 12: Methods	252
abort	252
abs()	252
activateAtLoc()	253
activateButton()	254
add	254
add (3D texture)	255
addAt	256
addBackdrop	256
addCamera	257
addChild	258
addModifier	259
addOverlay	259
addProp	260
addToWorld	261
addVertex()	262
alert()	263
Alert()	263
append	264
appMinimize()	265
atan()	266
beep()	267
beginRecording()	267
bitAnd()	268
bitNot()	269
bitOr()	270
bitXor()	271
breakLoop()	272
browserName()	272
build()	273
cacheDocVerify()	274
cacheSize()	275
call	276
callAncestor	277
callFrame()	279
camera()	279
cameraCount()	280
cancelIdleLoad()	280
castLib()	281
channel() (Top level)	282
channel() (Sound)	282
chapterCount()	283
charPosToLoc()	283
chars()	284
charToNum()	285
clearAsObjects()	286
clearCache	286
clearError()	287
clearFrame()	288
clearGlobals()	289
clone	289
cloneDeep	290
cloneModelFromCastmember	291
cloneMotionFromCastmember	291
close()	292
closeFile()	293
closeXlib	293
color()	294
constrainH()	295
constrainV()	296
copyPixels()	297
copyToClipBoard()	299
cos()	299
count()	300
createFile()	301
createMask()	301
createMatte()	302
crop() (Image)	302
crop() (Bitmap)	303
cross	303
crossProduct()	304
cursor()	304
date() (formats)	308
date() (System)	310
delay()	311
delete()	312
deleteFile()	312
deleteAt	312
deleteCamera	313
deleteFrame()	314
deleteGroup	315
deleteLight	315
deleteModel	316
deleteModelResource	316
deleteMotion	317
deleteOne	317
deleteProp	318
deleteShader	318
deleteTexture	319
deleteVertex()	320
displayOpen()	320
displaySave()	321
do	321
doneParsing()	322
dot()	322
dotProduct()	323
downloadNetThing	323
draw()	324
duplicate() (Image)	325
duplicate() (list function)	326
duplicate() (Member)	327
duplicateFrame()	327
enableHotSpot()	328
endRecording()	329
erase()	330
error()	330
externalEvent()	331
extrude3D	332
externalParamName()	333
externalParamValue()	335
extractAlpha()	336
fadeIn()	337
fadeOut()	337
fadeTo()	338
fileName()	339
fileOpen()	339
fileSave()	340
fill()	341
filter()	342
findLabel()	342
findEmpty()	343
findPos	344
findPosNear	344
finishIdleLoad()	345
flashToStage()	346
float()	346
floatP()	347
flushInputEvents()	348
forget() (Window)	348
forget() (Timeout)	349
framesToHMS()	350
frameReady() (Movie)	350
frameStep()	351
freeBlock()	352
freeBytes()	353
generateNormals()	353
getaProp	354
getAt	355
getError() (Flash, SWA)	356
getError() (XML)	358
getErrorString()	359
getFinderInfo()	360
getFlashProperty()	360
getFrameLabel()	361
getHardwareInfo()	362
getHotSpotRect()	363
GetItemPropList	363
getLast()	364
getLatestNetID	364
getLength()	365
getNetText()	365
getNormalized	367
getNthFileNameInFolder()	367
getOne()	369
getOSDirectory()	370
getPixel()	370
getPlayList()	371
getPosition()	372
getPref()	373
getPos()	374
getPref()	375
getProp()	375
getPropAt()	376
getRendererServices()	376
getStreamStatus()	377
getURL()	378
getVal()	379
getVariable()	380
GetWidgetList()	381
GetWindowPropList	381
getWorldTransform()	382
go()	383
goLoop()	384
goNext()	385
goPrevious()	386
goToFrame()	386
gotoNetMovie	387
gotoNetPage	388
group()	388
halt()	389
handler()	390
handlers()	390
hilite (command)	391
hitTest()	391
HMStoFrames()	392
hold()	393
identity()	394
idleLoadDone()	395
ignoreWhiteSpace()	395
ilk()	396
ilk (3D)	398
image()	399
importFileInto()	400
Initialize	402
insertBackdrop	402
insertFrame()	403
insertOverlay	404
inside()	405
installMenu	405
integer()	406
integerP()	406
Interface()	407
interpolate()	407
interpolateTo()	408
intersect()	409
inverse()	409
invert()	410
isBusy()	410
isInWorld()	411
isPastCuePoint()	412
ItemUpdate()	413
keyPressed()	414
label()	415
last()	416
lastClick()	417
lastEvent()	417
length()	417
light()	418
lineHeight()	419
linePosToLocV()	419
linkAs()	420
list()	420
listP()	421
loadFile()	421
locToCharPos()	422
locVToLinePos()	423
log()	423
makeList()	424
makeScriptedSprite()	425
makeSubList()	425
map()	426
map (3D)	427
mapMemberToStage()	427
mapStageToMember()	428
marker()	428
matrixAddition()	429
matrixMultiply()	430
matrixMultiplyScalar()	431
matrixTranspose()	431
max()	432
maximize()	432
mci	433
member()	434
mergeDisplayTemplate()	435
mergeProps()	435
mesh (property)	436
meshDeform (modifier)	437
min	438
minimize()	439
model	439
modelResource	440
modelsUnderLoc	441
modelsUnderRay	442
modelUnderLoc	444
motion()	444
move()	445
moveToBack()	446
moveToFront()	446
moveVertex()	447
moveVertexHandle()	448
multiply()	449
neighbor	449
netAbort	449
netDone()	450
netError()	451
netLastModDate()	453
netMIME()	454
netStatus	455
netTextResult()	456
new()	457
newCamera	459
newColorRatio	460
newCurve()	461
newGroup	461
newLight	462
newMatrix()	462
newMember()	463
newMesh	464
newModel	465
newModelResource	466
newMotion()	467
newObject()	467
newShader	468
newTexture	469
normalize	470
nothing	471
nudge()	472
numColumns()	473
numRows()	473
numToChar()	474
objectP()	475
offset() (string function)	476
offset() (rectangle function)	477
open() (Player)	477
open() (Window)	478
openFile()	479
openXlib	480
param()	480
paramCount()	481
parseString()	482
parseURL()	482
pass	484
pasteClipBoardInto()	485
pause() (DVD)	486
pause() (Sound Channel)	486
pause() (3D)	487
pause() (RealMedia, SWA, Windows Media)	488
perlinNoise()	488
perpendicularTo	490
pictureP()	490
play() (3D)	491
play() (DVD)	492
play() (Sound Channel)	494
play() (RealMedia, SWA, Windows Media)	495
playFile()	496

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
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1,000
1,001
1,002
1,003
1,004
1,005
1,006
1,007
1,008
1,009
1,010
1,011
1,012
1,013
1,014
1,015
1,016
1,017
1,018
1,019
1,020
1,021
1,022
1,023
1,024
1,025
1,026
1,027
1,028
1,029
1,030
1,031
1,032
1,033
1,034
1,035
1,036
1,037
1,038
1,039
1,040
1,041
1,042
1,043
1,044
1,045
1,046
1,047
1,048
1,049
1,050
1,051
1,052
1,053
1,054
1,055
1,056
1,057
1,058
1,059
1,060
1,061
1,062
1,063
1,064
1,065
1,066
1,067
1,068
1,069
1,070
1,071
1,072
1,073
1,074
1,075
1,076
1,077
1,078
1,079
1,080
1,081
1,082
1,083
1,084
1,085
1,086
1,087
1,088
1,089
1,090
1,091
1,092
1,093
1,094
1,095
1,096
1,097
1,098
1,099
1,100
1,101
1,102
1,103
1,104
1,105
1,106
1,107
1,108
1,109
1,110
1,111
1,112
1,113
1,114
1,115
1,116
1,117
1,118
1,119
1,120
1,121
1,122
1,123
1,124
1,125
1,126
1,127
1,128
1,129
1,130
1,131
1,132
1,133
1,134
1,135
1,136
1,137
1,138
1,139
1,140
1,141
1,142
1,143
1,144
1,145
1,146
1,147
1,148
1,149
1,150
1,151
1,152
1,153
1,154
1,155
1,156
1,157
1,158
1,159
1,160
1,161
1,162
1,163
1,164
1,165
1,166
1,167
1,168
1,169
1,170
1,171
1,172
1,173
1,174
1,175
1,176
1,177
1,178
1,179
1,180
1,181
1,182
1,183
1,184
1,185
1,186
1,187
1,188
1,189
1,190
1,191
1,192
1,193
1,194
1,195
1,196
1,197
1,198
1,199
1,200
1,201
1,202
1,203
1,204
1,205
1,206
1,207
1,208
1,209
1,210
1,211
1,212
1,213
1,214
1,215
1,216
1,217
1,218
1,219
1,220
1,221
1,222
1,223
1,224
1,225
1,226
1,227
1,228
1,229
1,230
1,231
1,232
1,233
1,234
1,235
1,236
1,237
1,238
1,239
1,240
1,241
1,242
1,243
1,244
1,245

Match case Limit results 1 per page

ADOBE DIRECTOR 11.0

Scripting Dictionary

950

•

#autoHigh

—Director starts by rendering the sprite with anti-aliasing. If the actual frame rate falls below the

movie’s specified frame rate, Director turns off anti-aliasing. This setting gives precedence to playback speed over

visual quality.

•

#autoLow

—Director starts by rendering the movie without anti-aliasing. If the Flash player determines that the

computer processor can handle it, anti-aliasing is turned on. This setting gives precedence to visual quality whenever

possible.

•

#high

(default)—The movie always plays with anti-aliasing.

•

#low

—The movie always plays without anti-aliasing.

The

quality

property can be tested and set.

Example

The following sprite script checks the color depth of the computer on which the movie is playing. If the color depth

is set to 8 bits or less (256 colors), the script sets the quality of the sprite in channel 5 to

#low

-- Lingo syntax

on beginSprite me

if _system.colorDepth <= 8 then

sprite(1).quality = #low

end if

end

// JavaScript syntax

function beginSprite() {

var clrDp = _system.colorDepth;

if (clrDp <= 8) {

sprite(1).quality = symbol("low");

}

quality (3D)

Usage

member(whichCastmember).texture(whichTexture).quality

member(whichCastmember).shader(whichShader).texture(whichTexture).quality

member(whichCastmember).model(whichModel).shader.texture(whichTexture).quality

member( whichCastmember ).model( whichModel ).shader.texturelist[TextureListIndex].quality

member(whichCastmember).model(whichModel).shaderList[shaderListIndex].

texture(whichTexture).quality

member( whichCastmember ).model( whichModel ).shaderList[ shaderListIndex ]. texturelist[

TextureListIndex ].quality

Description

3D texture property; lets you get or set the image quality of a texture by controlling the level of mipmapping applied

to the texture. Mipmapping is a process by which additional versions of the texture image are created in several sizes

that are smaller than the original image. The 3D Xtra extension then uses whichever version of the image is most

appropriate to the current size of the model on the screen and changes the version of the image that is being used

when needed. Trilinear mipmapping is higher in quality and uses more memory than bilinear mipmapping.

Mipmapping is not the same as filtering, although both improve texture appearance. Filtering spreads errors out

across the texture’s area so that errors are less concentrated. Mipmapping resamples the image to make it the appro-

priate size.