R/options.R

Defines functions dump_option_info distort_types compress_types decoration_types style_types morphology_types orientation_types gravity_types noise_types kernel_types image_types channel_types colorspace_types compose_types dispose_types metric_types filter_types option_types magick_fonts magick_options

Documented in channel_types colorspace_types compose_types compress_types decoration_types dispose_types distort_types dump_option_info filter_types gravity_types image_types kernel_types magick_fonts magick_options metric_types morphology_types noise_types option_types orientation_types style_types

#' Magick Options
#'
#' List option types and values supported in your version of ImageMagick. For
#' descriptions see
#' [ImageMagick Enumerations](https://www.imagemagick.org/Magick++/Enumerations.html).
#'
#' The [dump_option_info] function is equivalent to calling `convert -list [option]` on
#' the command line. It does not return anything, it only makes ImageMagick print
#' stuff to the console, use only for debugging.
#'
#' @rdname options
#' @family image
#' @name options
#' @export
#' @references ImageMagick Manual: [Enumerations](https://www.imagemagick.org/Magick++/Enumerations.html)
magick_options <- function(){
  types <- option_types()
  types <- types[types != "Undefined"]
  types <- types[types != "Command"]
  Filter(length, sapply(types, list_options))
}

#' @export
#' @rdname options
magick_fonts <- function(){
  list_font_info()
}

#' @export
#' @rdname options
option_types <- function(){
  list_options("List")
}

#' @export
#' @rdname options
filter_types <- function(){
  list_options('filter')
}

#' @export
#' @rdname options
metric_types <- function(){
  list_options('metric')
}

#' @export
#' @rdname options
dispose_types <- function(){
  list_options('dispose')
}

#' @export
#' @rdname options
compose_types <- function(){
  list_options('compose')
}

#' @export
#' @rdname options
colorspace_types <- function(){
  list_options('colorspace')
}

#' @export
#' @rdname options
channel_types <- function(){
  list_options('channel')
}

#' @export
#' @rdname options
image_types <- function(){
  list_options('type')
}

#' @export
#' @rdname options
kernel_types <- function(){
  list_options('kernel')
}

#' @export
#' @rdname options
noise_types <- function(){
  list_options('noise')
}

#' @export
#' @rdname options
gravity_types <- function(){
  list_options('gravity')
}

#' @export
#' @rdname options
orientation_types <- function(){
  list_options('orientation')
}

#' @export
#' @rdname options
morphology_types <- function(){
  list_options('morphology')
}

#' @export
#' @rdname options
style_types <- function(){
  list_options('style')
}

#' @export
#' @rdname options
decoration_types <- function(){
  list_options('decoration')
}

#' @export
#' @rdname options
compress_types <- function(){
  list_options('compress')
}

#' @export
#' @rdname options
distort_types <- function(){
  list_options('distort')
}

#' @export
#' @rdname options
#' @param option one of the [option_types]
dump_option_info <- function(option = 'font'){
  option <- as.character(option)
  dump_option_list(c("-list", option))
}
jeroenooms/magick documentation built on March 9, 2024, 12:42 a.m.