tgplot: Plot TextGrid

Description

Function for plotting TextGrids called by praatpicture. Instead of using this function directly, just use praatpicture('my_sound_file', frames='TextGrid').

Usage

tgplot(
  tg,
  t,
  sr,
  start,
  end,
  tiers = 1,
  tfrom0 = TRUE,
  tierNames = TRUE,
  alignment = "central",
  edgeLabels = "keep",
  specialChar = FALSE,
  color = "black",
  highlight = NULL
)

Value

No return values, called internally by praatpicture and sibling functions.

Arguments

tg: TextGrid object loaded using rPraat::tg.read
t: Numeric vector giving times corresponding to the signal.
sr: Integer giving the sampling rate of the signal.
start: Start time (in seconds) of desired plotted area.
end: End time (in seconds) of desired plotted area.
tiers: Vector of number or strings giving either numeric identifiers of TextGrid tiers to plot or the names of TextGrid tiers to plot. Default is 1, which plots just the first tier.
tfrom0: Logical; should time on the x-axis run from 0 or from the original time? Default is TRUE.
tierNames: Logical; should TextGrid tier names be printed along the y-axis? Default is TRUE.
alignment: String giving the desired alignment of text in the TextGrids. Default is central; other options are left and right. Alternatively, a vector of strings if different alignments are needed.
edgeLabels: String specifying how to handle TextGrid labels in interval tiers that fall partially before start or partially after end. Default is 'keep', where labels are kept at the center of the interval. Other options are 'center', where labels are recentered to the visible part of the interval, or 'discard', where such labels are ignored.
specialChar: Logical; should Praat typesetting for special font types such as italic, bold, and small caps be converted into corresponding R-readable special font types. Default is FALSE, since special characters can create unfortunate text alignment artefacts. See https://www.fon.hum.uva.nl/praat/manual/Text_styles.html.
color: String or vector of strings giving the name of the color(s) to be used for the text in TextGrids. Default is 'black'. If a vector is provided, different colors are used for different tiers.
highlight: Named list giving parameters for differential highlighting of TextGrid intervals. This list should contain information about which intervals to highlight, using the tier and label. Further contains the argument color, and background (a string specifying a background color).

Examples

Run this code

# Don't use directly
datapath <- system.file('extdata', package='praatpicture')
soundFile <- paste0(datapath, '/1.wav')
praatpicture(soundFile, frames='TextGrid')

Run the code above in your browser using DataLab