@@ -58,7 +58,7 @@ parseInt(app.build); // 45
58
58
Provides access to Adobe Media Encoder (on the same system).
59
59
60
60
!!! warning
61
- ` app.encoder ` is broken on Premiere Pro 14.3.1 - 15 on Mac only. Fixed in 22 and up. [ See this discussion] ( https://community.adobe.com/t5/premiere-pro-discussions/missing-the-object-app-encoder-14-3-1-15-0-15-1-15-2/m-p/12544488 ) .
61
+ ` app.encoder ` is broken on Premiere Pro 14.3.1 - 15 on Mac only. Fixed in 22 and up. [ See this discussion] ( https://community.adobe.com/t5/premiere-pro-discussions/missing-the-object-app-encoder-14-3-1-15-0-15-1-15-2/m-p/12544488 ) .
62
62
63
63
#### Type
64
64
@@ -353,7 +353,7 @@ String; read-only.
353
353
354
354
#### Example
355
355
356
- Get a version of a current application _ (Adobe Premiere Pro version 14.3.1 (Build 45))_
356
+ Get a version of a current application * (Adobe Premiere Pro version 14.3.1 (Build 45))*
357
357
358
358
``` js
359
359
app .version ; // 14.3.1
@@ -448,7 +448,7 @@ Determines whether the file at path can be opened as a Premiere Pro [project](..
448
448
449
449
#### Parameters
450
450
451
- | Parameter | Type | Description |
451
+ | Parameter | Type | Description |
452
452
| --------- | ------ | ----------------- |
453
453
| ` path ` | String | A path to a file. |
454
454
@@ -461,10 +461,10 @@ Returns `true` if file can be opened as a Premiere Pro [project](../general/proj
461
461
Test for valid project files
462
462
463
463
``` js
464
- app .isDocument (" ~/Desktop/myProject.prproj" ); // true
465
- app .isDocument (" ~/Desktop/textFile.txt" ); // false
466
- app .isDocument (" ~/Desktop/footageFile.mov" ); // false
467
- app .isDocument (" ~/Desktop/imageFile.mov" ); // false
464
+ app .isDocument (' ~/Desktop/myProject.prproj' ); // true
465
+ app .isDocument (' ~/Desktop/textFile.txt' ); // false
466
+ app .isDocument (' ~/Desktop/footageFile.mov' ); // false
467
+ app .isDocument (' ~/Desktop/imageFile.mov' ); // false
468
468
```
469
469
470
470
---
@@ -497,9 +497,9 @@ Creates a new .prproj [Project object](../general/project.md), at the specified
497
497
498
498
#### Parameters
499
499
500
- | Parameter | Type | Description |
500
+ | Parameter | Type | Description |
501
501
| --------- | ------ | -------------------------------------------------------------------- |
502
- | ` path ` | String | A full path to new project; a .prproj extension will _ not _ be added. |
502
+ | ` path ` | String | A full path to new project; a .prproj extension will * not * be added. |
503
503
504
504
#### Returns
505
505
@@ -517,7 +517,7 @@ Opens the file at the specified path, as a Premiere Pro [Project object](../gene
517
517
518
518
#### Parameters
519
519
520
- | Parameter | Type | Description |
520
+ | Parameter | Type | Description |
521
521
| -------------------------- | ------- | --------------------------------------------------------------- |
522
522
| ` path ` | String | Full path to the document to be opened. |
523
523
| ` suppressConversionDialog ` | Boolean | Optional. Suppress project conversion dialog. |
@@ -541,7 +541,7 @@ Opens an FCP XML file as a Premiere Pro [Project object](../general/project.md)
541
541
542
542
#### Parameters
543
543
544
- | Parameter | Type | Description |
544
+ | Parameter | Type | Description |
545
545
| ---------- | ------ | ----------- |
546
546
| ` path ` | String | |
547
547
| ` projPath ` | String | |
@@ -580,7 +580,7 @@ Determines whether proxy usage is currently enabled.
580
580
581
581
#### Parameters
582
582
583
- | Parameter | Type | Description |
583
+ | Parameter | Type | Description |
584
584
| --------- | ------- | ----------------------------------------- |
585
585
| ` enabled ` | Integer | ` 1 ` turns proxies on, ` 0 ` turns them off. |
586
586
@@ -600,7 +600,7 @@ Whether extension with the given extensionID persists, within this session.
600
600
601
601
#### Parameters
602
602
603
- | Parameter | Type | Description |
603
+ | Parameter | Type | Description |
604
604
| ------------- | ------- | ------------------------------------------------------------- |
605
605
| ` extensionID ` | String | Which extension to modify. |
606
606
| ` persistent ` | Integer | Pass ` 1 ` to keep extension in memory, ` 0 ` to allow unloading. |
@@ -612,7 +612,7 @@ Returns `true` if successful.
612
612
#### Example
613
613
614
614
``` js
615
- var extensionID = " com.adobe.PProPanel" ;
615
+ var extensionID = ' com.adobe.PProPanel' ;
616
616
// 0 - while testing (to enable rapid reload);
617
617
// 1 - for "Never unload me, even when not visible."
618
618
var persistent = 0 ;
@@ -632,20 +632,21 @@ Specifies the path to be used for one of Premiere Pro's scratch disk paths.
632
632
633
633
#### Parameters
634
634
635
+
635
636
+-------------------+------------------------+-------------------------------------------------+
636
- | Parameter | Type | Description |
637
+ | Parameter | Type | Description |
637
638
+===================+========================+=================================================+
638
- | ` path ` | String | The new path to be used. |
639
+ | ` path ` | String | The new path to be used. |
639
640
+-------------------+------------------------+-------------------------------------------------+
640
641
| ` scratchDiskType ` | ` ScratchDiskType ` enum | Enumerated value, must be one of the following: |
641
- | | | |
642
- | | | - ` ScratchDiskType.FirstVideoCaptureFolder ` |
643
- | | | - ` ScratchDiskType.FirstAudioCaptureFolder ` |
644
- | | | - ` ScratchDiskType.FirstVideoPreviewFolder ` |
645
- | | | - ` ScratchDiskType.FirstAudioPreviewFolder ` |
646
- | | | - ` ScratchDiskType.FirstAutoSaveFolder ` |
647
- | | | - ` ScratchDiskType.FirstCCLibrariesFolder ` |
648
- | | | - ` ScratchDiskType.FirstCapsuleMediaFolder ` |
642
+ | | | |
643
+ | | | - ` ScratchDiskType.FirstVideoCaptureFolder ` |
644
+ | | | - ` ScratchDiskType.FirstAudioCaptureFolder ` |
645
+ | | | - ` ScratchDiskType.FirstVideoPreviewFolder ` |
646
+ | | | - ` ScratchDiskType.FirstAudioPreviewFolder ` |
647
+ | | | - ` ScratchDiskType.FirstAutoSaveFolder ` |
648
+ | | | - ` ScratchDiskType.FirstCCLibrariesFolder ` |
649
+ | | | - ` ScratchDiskType.FirstCapsuleMediaFolder ` |
649
650
+-------------------+------------------------+-------------------------------------------------+
650
651
651
652
#### Returns
@@ -655,12 +656,9 @@ Returns `true` if successful.
655
656
#### Example
656
657
657
658
``` js
658
- var scratchPath = Folder .selectDialog (" Choose new scratch disk folder" );
659
+ var scratchPath = Folder .selectDialog (' Choose new scratch disk folder' );
659
660
if (scratchPath && scratchPath .exists ) {
660
- app .setScratchDiskPath (
661
- scratchPath .fsName ,
662
- ScratchDiskType .FirstAutoSaveFolder
663
- );
661
+ app .setScratchDiskPath (scratchPath .fsName , ScratchDiskType .FirstAutoSaveFolder );
664
662
}
665
663
```
666
664
@@ -677,15 +675,15 @@ Writes a string to Premiere Pro's Events panel.
677
675
#### Parameters
678
676
679
677
+-------------+--------+-----------------------+
680
- | Parameter | Type | Description |
678
+ | Parameter | Type | Description |
681
679
+=============+========+=======================+
682
- | ` message ` | String | A message to display. |
680
+ | ` message ` | String | A message to display. |
683
681
+-------------+--------+-----------------------+
684
- | ` decorator ` | String | Decorator, one of: |
685
- | | | |
686
- | | | - ` info ` |
687
- | | | - ` warning ` |
688
- | | | - ` error ` |
682
+ | ` decorator ` | String | Decorator, one of: |
683
+ | | | |
684
+ | | | - ` info ` |
685
+ | | | - ` warning ` |
686
+ | | | - ` error ` |
689
687
+-------------+--------+-----------------------+
690
688
691
689
#### Returns
@@ -704,7 +702,7 @@ Set workspace as active. Use [app.getWorkspaces()](#appgetworkspaces) to get a l
704
702
705
703
#### Parameters
706
704
707
- | Parameter | Type | Description |
705
+ | Parameter | Type | Description |
708
706
| ----------- | ------ | -------------------------- |
709
707
| ` workspace ` | String | The name of the workspace. |
710
708
@@ -717,11 +715,11 @@ Boolean.
717
715
Activate "Editing" workspace.
718
716
719
717
``` js
720
- var workspace = " Editing" ;
718
+ var workspace = ' Editing' ;
721
719
if (app .setWorkspace (workspace)) {
722
- alert (' Workspace changed to "' + workspace + ' "' );
720
+ alert (' Workspace changed to "' + workspace + ' "' );
723
721
} else {
724
- alert (' Could not set "' + workspace + ' " workspace' );
722
+ alert (' Could not set "' + workspace + ' " workspace' );
725
723
}
726
724
```
727
725
@@ -765,10 +763,10 @@ An array of view IDs; can be null.
765
763
766
764
``` js
767
765
var allViewIDs = app .getProjectViewIDs ();
768
- if (allViewIDs) {
769
- var firstOne = allViewIDs[0 ];
766
+ if (allViewIDs){
767
+ var firstOne = allViewIDs[0 ];
770
768
} else {
771
- // No views open.
769
+ // No views open.
772
770
}
773
771
```
774
772
@@ -830,35 +828,9 @@ An array of [ProjectItems](../item/projectitem.md); can be null.
830
828
831
829
` ` ` js
832
830
var selectedItems = app .getCurrentProjectViewSelection ();
833
- if (selectedItems) {
834
- var firstOne = selectedItems[0 ];
831
+ if (selectedItems){
832
+ var firstOne = selectedItems[0 ];
835
833
} else {
836
- // No projectItems selected.
834
+ // No projectItems selected.
837
835
}
838
836
` ` `
839
-
840
- ---
841
-
842
- ### app.broadcastPrefsChanged()
843
-
844
- ` app .broadcastPrefsChanged ()`
845
-
846
- #### Description
847
-
848
- Notifies Application that preferences have changed.
849
-
850
- #### Parameters
851
-
852
- String ID of the preference that changed. (currently only listens to "BE::PreferencesScratchDisksChanged")
853
-
854
- #### Returns
855
-
856
- Returns ` true ` if update was successful.
857
-
858
- #### Example
859
-
860
- ` ` ` js
861
- app .broadcastPrefsChanged (" BE::PreferencesScratchDisksChanged" );
862
- ` ` `
863
-
864
- ---
0 commit comments