% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/shared-docs.R
\name{grid_generation}
\alias{grid_generation}
\title{Grid generation}
\description{
Parameters defining the geometry, resolution, and orientation of a regular grid
of surface tiles, as used by various ggcube layer functions including
\code{\link[=geom_smooth_3d]{geom_smooth_3d()}}, \code{\link[=geom_function_3d]{geom_function_3d()}}, \code{\link[=geom_density_3d]{geom_density_3d()}}, and
\code{\link[=geom_surface_3d]{geom_surface_3d()}}.
}
\section{Arguments}{

\describe{
\item{\code{grid}}{Character specifying tile geometry. Options:
\describe{
\item{\code{"rectangle"}}{Rectangular grid (the default).}
\item{\code{"right1"}}{Rectangular grid with each quad split into two right triangles
along the bottom-left to top-right diagonal.}
\item{\code{"right2"}}{Like \code{"right1"} but split along the bottom-right to top-left
diagonal.}
\item{\code{"equilateral"}}{Equilateral triangular lattice (tessellated via Delaunay
triangulation). Can prevent lighting artifacts where a surface curves past
parallel with the sight line.}
}
}
\item{\code{n}}{Either a single integer specifying grid resolution in both dimensions,
or a vector of length 2 specifying \code{c(nx, ny)} for separate x and y resolutions.
Default is \code{40}. Higher values create smoother surfaces but slower rendering.}
\item{\code{direction}}{Either \code{"x"} (the default) or \code{"y"}, specifying the orientation
of tile rows. Ignored for rectangular grids.}
\item{\code{trim}}{Logical. Only relevant for \code{grid = "equilateral"}. If \code{TRUE}
(default), trims edge vertices so that grid boundaries are straight lines. If
\code{FALSE}, preserves the full lattice, resulting in a grid with irregular edges.}
}
}

