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.

  -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:

  -cut clip -exit 

  -command all -exit