search_cuts_media {act}R Documentation

Create cut lists for 'FFmpeg'

Description

This function creates FFmpeg commands to cut media files for each search results. If you want to execute the commands (and cut the media files) you need to have FFmpeg installed on you computer. To install FFmpeg you can follow the instructions given in the vignette 'installation-ffmpeg'. Show the vignette with vignette("installation-ffmpeg").

Usage

search_cuts_media(
  x,
  s,
  cutSpanBeforesec = NULL,
  cutSpanAftersec = NULL,
  outputFolder = NULL,
  filterMediaInclude = "",
  fastVideoPostioning = TRUE,
  videoCodecCopy = FALSE,
  audioCutsAsMP3 = FALSE,
  Panning = NULL,
  filename.append.medianame = FALSE,
  filename.append.separator = "__"
)

Arguments

x

Corpus object; Please note: all media paths for a transcript need to be given as a list in the corpus object in corpus@transcripts[[ ]]@media.path . You can use the respective media functions. .

s

Search object.

cutSpanBeforesec

Double; Start the cut some seconds before the hit to include some context; the default NULL will take the value as set in @cuts.span.beforesec of the search object.

cutSpanAftersec

Double; End the cut some seconds before the hit to include some context; the default NULL will take the value as set in @cuts.span.beforesec of the search object.

outputFolder

Character string; path to folder where files will be written.

filterMediaInclude

Character string; regular expression to match only some of the media files in corpus@transcripts[[ ]]@media.path.

fastVideoPostioning

Logical; If TRUE the FFmpeg command will be using the parameter fast video positioning as specified in options()$act.ffmpeg.command.fastVideoPostioning.

videoCodecCopy

Logical; if TRUE FFMPEG will use the option codec copy for videos.

audioCutsAsMP3

Logical; If TRUE audio cuts will be exported as '.mp3' files, using options()$act.ffmpeg.command.audioCutsAsMP3.

Panning

Integer; 0=leave audio as is (ch1&ch2) , 1=only channel 1 (ch1), 2=only channel 2 (ch2), 3=both channels separated (ch1&ch2), 4=all three versions (ch1&ch2, ch1, ch2). This setting will override the option made in 'act.ffmpeg.exportchannels.fromColumnName' .

filename.append.medianame

Logical; if TRUE the file name of the original media file will be appended to the snippet(s).

filename.append.separator

Character string; characters that separate the result id and the media file name.

Details

Cut lists
The commands are collected in cut lists. The cut lists will be stored in different ways:

Input media files
The function will use all files in corpus@transcripts[[ ]]@media.path. Therefore you will need to set the options filterMediaInclude filtering for which input media files you want to create the cuts. The filter is a regular expression, e.g. '\.(wav|aif)' for '.wav' and '.aif' audio files or '\.mp4' for '.mp4' video files.

Output format
The output format is predefined by in the options:

The default is to generate mp4 video cuts. You can also use the following commands to change the output format:

MP4 video cuts with original video quality:

MP4 video cuts with reduced video quality:

WAV audio cuts:

Advanced options
You can adjust the FFmpeg commands according to your needs. The following options define the FFmpeg command that will be used by the package. The command needs to contain place holders which will be replaced by the actual values in the package. If you want to define your own ffmpeg command, please make sure to use the following placeholders:

Value

Search object; cut lists will be stored in s@cuts.cutlist.mac and s@cuts.cutlist.win.

Examples

library(act)

# IMPORTANT: In the example corpus all transcripts are assigned media links.
# The actual media files are, however, not included in when installing the package 
# due to size limitations of CRAN.
# But you may download the media files separately.
# Please see the section 'examplecorpus' for instructions. 
# --> You will need the media files to execute the following example code.

## Not run: 
	# Search
	mysearch <- act::search_new(examplecorpus, pattern="yo")
	
	# Create cut lists 
	mysearch <- act::search_cuts_media (x=examplecorpus, s=mysearch)
	
	# Check results for Mac:
	# Get entire cut list for Mac and display on screen, 
	# so you can copy&paste this into the Terminal
	mycutlist <- mysearch@cuts.cutlist.mac 
	cat(mycutlist)
	# Cut list for first search result
	mycutlist <- mysearch@results$cuts.cutlist.mac[[1]]
	cat(mycutlist)
	
	# Check results for Windows:
	# Get entire cut list for Mac and display on screen, 
	# so you can copy&paste this into the CLI
	mycutlist <- mysearch@cuts.cutlist.win 
	cat(mycutlist)
	# Cut list for first search result
	mycutlist <- mysearch@results$cuts.cutlist.win[[1]]
	cat(mycutlist)
	
	# It is, however, more convenient to specify the argument 'outputFolder' in order to get
	# the cut list as a (executable) file/batch list.

## End(Not run)
[Package act version 1.3.1 Index]