% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/sync.R
\name{sync_gazepoint_biometrics_with_gaze}
\alias{sync_gazepoint_biometrics_with_gaze}
\title{Synchronise Gazepoint Biometrics with gaze data}
\usage{
sync_gazepoint_biometrics_with_gaze(
  biometrics,
  gaze,
  by,
  all_x = TRUE,
  suffixes = c(".gaze", ".bio")
)
}
\arguments{
\item{biometrics}{A Gazepoint Biometrics data frame.}

\item{gaze}{A gaze, fixation, AOI, or \code{gp3tools}-style summary data frame.}

\item{by}{Character vector of key columns used for joining.}

\item{all_x}{Logical. Should all rows from \code{gaze} be retained?}

\item{suffixes}{Character vector of length two used for duplicate non-key
column names.}
}
\value{
A data frame with gaze rows joined to biometric columns. The returned
object has class \code{"gazepoint_biometrics_sync"} and a \code{"sync_summary"}
attribute.
}
\description{
Joins Gazepoint Biometrics data to gaze or fixation data using exact key
columns. This function is intentionally conservative: it does not perform
interpolation, nearest-neighbour matching, or automatic time shifting. For a
first reproducible workflow, exact joins by participant, media, trial, sample
counter, or fixation identifier are preferred when those fields are available.
}
