Identifying clips
Many of the commands operate on a specified clip or clips. In the documentation this is written as:
-command CLIP_IDENTIFIER
Where the argument to the command identifies the clip(s) which can
be specified either by using the full path to the image sequence; the
clip name; the unique ID of the clip; the name of a scene, to apply
the command to all clips contained within that scene; the name of
sequence, to apply the command to all clips contained within that
sequence; or all
, to apply the command to all clips in the project.
There may be times where you would like to specifically control which
criteria is being used to identify clips, e.g. you would like to refer
to a specific individual clip, but its name happens to be all
. To do
this you can use:
-command name=all
So that only the clips with the name all
will match. Similarly,
use filename=
to only match against the full path to the image
sequence; id=
to only match against the clip's unique ID; scene=
to only match against the name of a scene; and sequence=
to only
match against the name of the sequence. There is one more, rscene=
,
which is the same as scene=
except that the command will be applied
to all clips in the matched scene and, recursively, all sub-scenes of
it.
Note that if you are using all
to specify that all clips should
be used then all
refers to the clips before any scene cut
detection take place, i.e.
"C:\Program Files\The Pixel Farm\PFClean\PFClean.exe" -cut clip -command all -exit
will not run command
on all sub-clips generated by the scene cut detection command. To achieve that result run PFClean twice:
"C:\Program Files\The Pixel Farm\PFClean\PFClean.exe" -cut clip -exit
"C:\Program Files\The Pixel Farm\PFClean\PFClean.exe" -command all -exit