# ggseg3d 2.1.1

## Bug fixes

- Cortical hemispheres are now rendered anatomically side-by-side (LH at
  negative x, RH at positive x, medial edges at the midline) regardless of
  the mesh source. Previously, both hemispheres overlapped at the origin
  because `ggseg.formats` inflated meshes and `ggseg.meshes` pial/white/etc.
  surfaces arrived in different axis conventions. `resolve_brain_mesh()`
  now normalises to the shared `x = LR`, `y = AP`, `z = SI` frame and
  separates hemispheres at `x = 0`.
- `set_positioning()` no longer wrongly shifts subcortical meshes whose
  region names happen to contain "Left"/"Right" (e.g. `Left-Thalamus`); it
  only repositions cortical meshes named `"<hemi> <surface>"`.
- `add_glassbrain()` warns and skips when the widget already contains a
  flat (2D) mesh such as a cerebellar flatmap, since flatmaps share no
  coordinate frame with anatomical 3D meshes.
- `add_glassbrain()` now defaults to `surface = "inflated"` so it works
  without `ggseg.meshes` installed (inflated ships with `ggseg.formats`).

## Documentation

- Replaced `\dontrun{}` wrappers in widget-construction examples with
  executable code so examples run under `R CMD check` and render inline
  in pkgdown. Examples that require `rgl` (Suggests) are now gated with
  `@examplesIf rlang::is_installed("rgl")`.
- Added `LICENSE.note` documenting the bundled Three.js and OrbitControls
  libraries and credited their authors in `Authors@R`.

## Internal

- Removed the `native_offset()` / `to_native_coords()` / `position_hemisphere()`
  helpers. They were workarounds for the previous axis-convention mismatch
  and are no longer needed now that all meshes share a single frame.

# ggseg3d 2.1.0

## Cerebellar atlas support

- New `cerebellar_atlas` class with `prepare_brain_meshes.cerebellar_atlas()`
  method for rendering SUIT cerebellar surfaces with vertex-based colouring.
- Mixed vertex+mesh rendering for deep cerebellar nuclei: the SUIT surface
  renders at 30% opacity with opaque per-region meshes for deep structures.
- `surface_opacity` parameter controls cerebellar surface transparency when
  deep nuclei are present.
- Cortical mesh data moved to the 'ggseg.meshes' package, removing bundled
  `sysdata.rda`.

# ggseg3d 2.0.0

## Major changes

- Complete rewrite using htmlwidgets with Three.js instead of plotly
- New pipe-friendly API with chainable addition functions
- Support for unified brain_atlas format from ggseg.formats package

## New features

- `set_background()` - set background colour
- `set_legend()` - control legend visibility
- `set_dimensions()` - set widget width and height
- `set_edges()` - add region boundary edges
- `set_flat_shading()` - disable lighting for exact colours
- `set_orthographic()` - use orthographic projection
- `pan_camera()` - position camera at standard anatomical views
- `add_glassbrain()` - add translucent brain surface overlay
- `snapshot_brain()` - save widget as PNG image
- `edge.by` parameter for edge grouping by data columns

## Breaking changes

- Removed plotly dependency
- ggseg3d_atlas objects are deprecated (still supported with warning)

# ggseg3d 1.6.3

- Prepare for CRAN
- Remove white surface from `dk_3d` to reduce size and pass CRAN checks
- Update github urls to new org

# ggseg3d 1.6.02

- Fix bug where installing with vignettes fails

# ggseg3d 1.6.01

- Added ellipsis `...` to plotly::add_trace for people to add more arguments

# ggseg3d 1.5.2

- Adapted to work with dplyr 0.8.1

# ggseg3d 1.5.1

- Changed ggseg_atlas-class to have nested columns for easier viewing and wrangling

# ggseg3d 1.5

- Changed atlas.info to function `atlas_info()`
- Changed brain.pal to function `brain_pal()`
- Reduced code necessary for `brain_pals_info`
- Simplified `display_brain_pal()`
- Moved palettes of ggseg.extra atlases to ggseg.extra package
- Added a `NEWS.md` file to track changes to the package
- Changes all `data` options to `.data` to decrease possibility of column naming overlap
- Added compatibility with `grouped` data.frames
- Reduced internal atlases, to improve CRAN compatibility
- Added function to install extra atlases from github easily
- Changes vignettes to comply with new functionality
