ruby-gr 0.0.23 → 0.58.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 25cf22ddd78bcfc66e0feb206821fe40d193b972ee7ed0512ae29b7ed3feaf57
-  data.tar.gz: 273b62f5cd998231148923f09749b8aed2117da8bc2dae1773b6e6cb537b151d
+  metadata.gz: f620965108eafb5f65fc8b1c946db5abea180708db175b88246a2ecd97a66b53
+  data.tar.gz: 8ff0c1b787c4b3e70a29ace39eb2fb39abaf60d71afc05b4b382edfcb6f570fa
 SHA512:
-  metadata.gz: d1d8c8f88277e83cdde72bee429fc9b1a8bc4b2b2d976f4dfea4d423465d5e4da0b8b948fb00fc6ed44b518b6658077f1596c2763b514bf51ab60973a9ffddbe
-  data.tar.gz: a1fe8ab99fc491ae99c9e4245bb0226518898f2655c0dff9b616ce98ce0ddd7a322778b3e2bd48d38144676947823f5390d6ce9e8d18efe175b5920d218802f5
+  metadata.gz: cb816d775831c8e05f43e0ded3d15a22328ff0b7e5810c484782393b4fe06ee5aa03fbf431b3cbbe6c8bac2763b07ef377e42dd5d9024da1aec819251b264951
+  data.tar.gz: 9e12f1fa434d64b1f202a3198afa30be70ee1b4961493cde92d308134b146703ff21e2e1915cd01ed286f476f7e6900425aaa5ebdc8f1b33fd550a3d3567a14f

data/LICENSE.txt

@@ -1,7 +1,7 @@
 The MIT License (MIT)
 
-Copyright (c) 2019 kojix2
-Copyright (c) 2019 Red Data Tools
+Copyright (c) 2019 - present kojix2
+Copyright (c) 2019 - present Red Data Tools
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,8 +1,7 @@
 # GR.rb
 
-[![The MIT License](https://img.shields.io/badge/license-MIT-orange.svg)](LICENSE.txt)
-[![Build Status](https://travis-ci.org/red-data-tools/GR.rb.svg?branch=master)](https://travis-ci.org/red-data-tools/GR.rb)
-[![Gem Version](https://badge.fury.io/rb/ruby-gr.svg)](https://badge.fury.io/rb/ruby-gr)
+[![Gem Version](https://img.shields.io/gem/v/ruby-gr?color=brightgreen)](https://rubygems.org/gems/ruby-gr)
+[![CI](https://github.com/red-data-tools/GR.rb/workflows/CI/badge.svg)](https://github.com/red-data-tools/GR.rb/actions)
 [![Gitter Chat](https://badges.gitter.im/red-data-tools/en.svg)](https://gitter.im/red-data-tools/en)
 [![Docs Latest](https://img.shields.io/badge/docs-latest-blue.svg)](https://rubydoc.info/gems/ruby-gr)
 
@@ -33,16 +32,15 @@ First, [install GR](#gr-installation). Then install `ruby-gr` gem.
 ```sh
 gem install ruby-gr
 ```
+Note: If you are using [RubyInstaller](https://rubyinstaller.org/) (Windows), pacman will automatically install [mingw-w64-gr](https://packages.msys2.org/base/mingw-w64-gr).
 
-Note: If you are using Rubyinstaller(Windows), pacman will automatically install [mingw-w64-gr](https://packages.msys2.org/base/mingw-w64-gr).
-
-Set environment variable `GRDIR`. 
+Set environment variable `GRDIR`.
 
 ```sh
 export GRDIR="/your/path/to/gr"
 ```
 
-Note: If you use package managers to install GR, [pkg-config](https://github.com/ruby-gnome/pkg-config) may automatically detect the shared library location without specifying the `GRDIR` environment variable. 
+If you use package managers to install GR, [pkg-config](https://github.com/ruby-gnome/pkg-config) may automatically detect the shared library location without specifying the `GRDIR` environment variable.
 
 ## Quick Start
 
@@ -81,7 +79,7 @@ GR.plot(
 )
 ```
 
-Save in PNG format.
+Save the figure in PNG format.
 
 ```ruby
 GR.savefig("figure.png")
@@ -89,16 +87,17 @@ GR.savefig("figure.png")
 
 ## API Overview
 
-There are two different approaches to plotting with GR.rb. One way is to call Matlab-like APIs. The other is to call GR/GR3 native functions. We are planning to prepare a [more object-oriented interface](https://github.com/kojix2/GRUtils.rb) based on [GRUtils.jl](https://github.com/heliosdrm/GRUtils.jl) in the future.
+There are two different approaches when plotting with GR.rb. One is to call Matlab-like APIs. The other is to call GR/GR3 native functions.
 
-#### GR::Plot - A simple, matlab-style API. 
+#### GR::Plot - A simple, matlab-style API.
 
 ```ruby
 require 'gr/plot'
 GR.plot(x, y)
 ```
 
-List of vailable functions. See [GR.rb Wiki](https://github.com/red-data-tools/GR.rb/wiki) for details.
+Below are a list of available functions. See [GR.rb Wiki](https://github.com/red-data-tools/GR.rb/wiki) for details.
+Some GR module methods are overwritten.
 
 [`plot`](../../wiki/Plotting-functions#plot)
 [`step`](../../wiki/Plotting-functions#step)
@@ -147,12 +146,24 @@ require 'gr3'
 GR3.cameralookat(-3, 2, -2, 0, 0, 0, 0, 0, -1)
 ```
 
+### Using GR.rb non-interactively
+
+Both APIs will by default start a Qt based window to show the result of the last call.
+This behavior is caused by GR itself as it will [implicitly generate output to a file or application](https://gr-framework.org/workstations.html#no-output).
+If you want to use GR.rb non-interactively, eg., as part of a static site build, you can do this by setting the environment variable `GKS_WSTYPE`to `100`.
+
+```sh
+export GKS_WSTYPE=100
+```
+
 ## Documentation
 
 - [GR.rb Wiki](https://github.com/red-data-tools/GR.rb/wiki)
 - [GR Framework](https://gr-framework.org/)
 - [GR.rb API Documentation](https://rubydoc.info/gems/ruby-gr)
 
+Although GR.rb adds methods dynamically, we try our best to provide a complete yard document. If you want to see more up-to-date information, we recommend using the official GR reference.
+
 ## GR Installation
 
 ### Installing an official release (recommended)
@@ -165,34 +176,54 @@ Set environment variable GRDIR.
 export GRDIR="your/path/to/gr"
 ```
 
-* macOS Catalina and macOS Mojave: See the "How to open an app that hasn’t been notarized or is from an unidentified developer" section of [Safely open apps on your Mac](https://support.apple.com/en-us/HT202491) in the Apple documentation.
+macOS : Please  the section "How to open apps from un-notarized or unidentified developers" in the Apple documentation ["Safely open apps on your Mac"](https://support.apple.com/en-us/HT202491).
 
 ### Using package managers
 
 * The third party GR packages for Mac, Linux and Windows are available (for advanced users).
 * If you find any problem, please report the issue [here](https://github.com/red-data-tools/GR.rb/issues).
-* Note: These packages may not have some features, for example, video output.
+* Note: These packages may not have some features such as video output.
 
 #### Mac - Homebrew
 
 ```sh
 brew install libgr
+export GKS_WSTYPE=411 # gksqt (recommended)
 ```
 
-#### Linux - APT Yum
+#### Linux - APT
 
 [packages.red-data-tools.org](https://github.com/red-data-tools/packages.red-data-tools.org) provides `libgr-dev`, `libgr3-dev` and `libgrm-dev`
 
-### Windows - MSYS2
+Debian GNU/Linux and Ubuntu 
 
-If you are using Rubyinstaller, pacman will automatically install [mingw-w64-gr](https://packages.msys2.org/base/mingw-w64-gr) when the gem is installed.
+```sh
+sudo apt install -y -V ca-certificates lsb-release wget
+wget https://packages.red-data-tools.org/$(lsb_release --id --short | tr 'A-Z' 'a-z'\
+  )/red-data-tools-apt-source-latest-$(lsb_release --codename --short).deb
+sudo apt install -y -V ./red-data-tools-apt-source-latest-$(lsb_release --codename --short).deb
+sudo apt update
+sudo apt install libgrm-dev
+```
 
-## Backend for Charty
+#### Linux - Yum
 
-GR.rb will be the default backend for [Charty](https://github.com/red-data-tools/charty).
+CentOS
+
+```sh
+(. /etc/os-release && sudo dnf install -y https://packages.red-data-tools.org/centos/${VERSION_ID}/red-data-tools-release-latest.noarch.rpm)
+sudo dnf install -y gr-devel
+```
+
+#### Windows - MSYS2
+
+If you are using Rubyinstaller, pacman will automatically install [mingw-w64-gr](https://packages.msys2.org/base/mingw-w64-gr) when the gem is installed.
 
 ## Contributing
 
+GR.rb is a library under development, so even small improvements like fixing typos are welcome!
+Please feel free to send us your PR.
+
 * [Report bugs](https://github.com/red-data-tools/GR.rb/issues)
 * Fix bugs and [submit pull requests](https://github.com/red-data-tools/GR.rb/pulls)
 * Write, clarify, or fix documentation
@@ -200,7 +231,22 @@ GR.rb will be the default backend for [Charty](https://github.com/red-data-tools
 * Update GR packages ( Homebrew, MinGW, red-data-tools )
 * Create visualization tools based on GR.rb
 
+To get started with development:
+
+```sh
+git clone https://github.com/red-data-tools/GR.rb
+cd GR.rb
+bundle install
+bundle exec rake test
+```
+
+* [I'm new to Ruby](https://github.com/red-data-tools/GR.rb/wiki/I%27m-new-to-Ruby)
+
+## Future plans
+
+* GR.rb will be the default backend for [Charty](https://github.com/red-data-tools/charty).
+* [Object-oriented interface](https://github.com/kojix2/GRUtils.rb) based on [GRUtils.jl](https://github.com/heliosdrm/GRUtils.jl). 
+
 ## Acknowledgements
 
 We would like to thank Josef Heinen, the creator of [GR](https://github.com/sciapp/gr) and [GR.jl](https://github.com/jheinen/GR.jl), Florian Rhiem, the creator of [python-gr](https://github.com/sciapp/python-gr), and all [GR](https://github.com/sciapp/gr) developers.
-

data/lib/gr.rb

@@ -36,7 +36,7 @@
 #               | +--------------+ |
 #               +------------------+
 #
-# (You can edit the above AA diagram with http://asciiflow.com/))
+# (You can edit the above AA diagram with http://asciiflow.com/)
 #
 # Fiddley is Ruby-FFI compatible API layer for Fiddle.
 #
@@ -48,23 +48,36 @@
 module GR
   class Error < StandardError; end
 
+  class NotFoundError < Error; end
+
   class << self
     attr_accessor :ffi_lib
   end
 
   require_relative 'gr_commons/gr_commons'
-  extend GRCommons::SearchSharedLibrary
 
   # Platforms |  path
   # Windows   |  bin/libgr.dll
-  # MacOSX    |  lib/libGR.so (NOT .dylib)
+  # MacOSX    |  lib/libGR.dylib ( <= v0.53.0 .so)
   # Ubuntu    |  lib/libGR.so
-  self.ffi_lib = case RbConfig::CONFIG['host_os']
-                 when /mswin|msys|mingw|cygwin|bccwin|wince|emc/
-                   search_shared_library('libgr.dll', 'gr')
-                 else
-                   search_shared_library('libGR.so', 'gr')
-                 end
+  platform = RbConfig::CONFIG['host_os']
+  lib_names, pkg_name = \
+    case platform
+    when /mswin|msys|mingw|cygwin|bccwin|wince|emc/
+      [['libGR.dll'], 'gr']
+    when /darwin|mac os/
+      [['libGR.dylib', 'libGR.so'], 'gr']
+    else
+      [['libGR.so'], 'gr']
+    end
+
+  # On Windows + RubyInstaller,
+  # the environment variable GKS_FONTPATH will be set.
+  lib_path = GRCommons::GRLib.search(lib_names, pkg_name)
+
+  raise NotFoundError, "#{lib_names} not found" if lib_path.nil?
+
+  self.ffi_lib = lib_path
 
   require_relative 'gr/version'
   require_relative 'gr/ffi'
@@ -81,26 +94,20 @@ module GR
   # a Fiddley::MemoryPointer in the GRBase class.
   extend GRBase
 
-  # Now you can see a lot of methods just calling super here.
-  # They are written to help the yard generate the documentation.
   class << self
-    def initgr(*)
-      super
-    end
+    # @!method initgr
 
-    def opengks(*)
-      super
-    end
+    # @!method opengks
 
-    def closegks(*)
-      super
-    end
+    # @!method closegks
 
     # Get the current display size.
+    #
     # Depending on the current workstation type, the current display might be
     # the primary screen (e.g. when using gksqt or GKSTerm) or a purely virtual
     # display (e.g. when using Cairo). When a high DPI screen is used as the
     # current display, width and height will be in logical pixels.
+    #
     # @return [Array] meter_width, meter_height, width, height
     def inqdspsize
       inquiry %i[double double int int] do |*pts|
@@ -109,6 +116,7 @@ module GR
     end
 
     # Open a graphical workstation.
+    #
     # @param workstation_id [Integer] A workstation identifier.
     # @param connection [String] A connection identifier.
     # @param workstation_type [Integer] The desired workstation type.
@@ -134,70 +142,130 @@ module GR
     #  * 410       : Socket driver
     #  * 415       : 0MQ driver
     #  * 420       : OpenGL
-    def openws(*)
-      super
-    end
+    #
+    # @!method openws
 
     # Close the specified workstation.
+    #
     # @param workstation_id [Integer] A workstation identifier.
-    def closews(*)
-      super
-    end
+    #
+    # @!method closews
 
     # Activate the specified workstation.
+    #
     # @param workstation_id [Integer] A workstation identifier.
-    def activatews(*)
-      super
-    end
+    #
+    # @!method activatews
 
     # Deactivate the specified workstation.
+    #
     # @param workstation_id [Integer] A workstation identifier.
-    def deactivatews(*)
-      super
-    end
+    #
+    # @!method deactivatews
 
     # Configure the specified workstation.
-    def configurews(*)
-      super
-    end
+    #
+    # @!method configurews
 
-    def clearws(*)
-      super
-    end
+    # Clear the specified workstation.
+    #
+    # @!method clearws
 
-    def updatews(*)
-      super
-    end
+    # Update the specified workstation.
+    #
+    # @!method updatews
 
     # Draw a polyline using the current line attributes,
     # starting from the first data point and ending at the last data point.
-    # @param x [Array, NArray] A list containing the X coordinates
-    # @param y [Array, NArray] A list containing the Y coordinates
-    def polyline(x, y)
+    #
+    # @param x         [Array, NArray]          A list containing the X coordinates
+    # @param y         [Array, NArray]          A list containing the Y coordinates
+    # @param linewidth [Array, NArray, Numeric] A list containing the line widths
+    # @param line_z    [Array, NArray, Numeric] A list to be converted to colors
+    #
+    # The values for x and y are in world coordinates.
+    # The attributes that control the appearance of a polyline are linetype,
+    # linewidth and color index.
+    #
+    def polyline(x, y, linewidth = nil, line_z = nil)
+      # GR.jl - Multiple dispatch
       n = equal_length(x, y)
-      super(n, x, y)
+      if linewidth.nil? && line_z.nil?
+        super(n, x, y)
+      else
+        linewidth ||= GR.inqlinewidth
+        linewidth = if linewidth.is_a?(Numeric)
+                      Array.new(n, linewidth * 100)
+                    else
+                      raise ArgumentError if n != linewidth.length
+
+                      linewidth.map { |i| (100 * i).round }
+                    end
+        line_z ||= GR.inqcolor(989) # FIXME
+        color = if line_z.is_a?(Numeric)
+                  Array.new(n, line_z)
+                else
+                  raise ArgumentError if n != line_z.length
+
+                  to_rgb_color(line_z)
+                end
+        z = linewidth.to_a.zip(color).flatten # to_a : NArray
+        gdp(x, y, GDP_DRAW_LINES, z)
+      end
     end
 
     # Draw marker symbols centered at the given data points.
-    # @param x [Array, NArray] A list containing the X coordinates
-    # @param y [Array, NArray] A list containing the Y coordinates
-    def polymarker(x, y)
+    #
+    # @param x          [Array, NArray]          A list containing the X coordinates
+    # @param y          [Array, NArray]          A list containing the Y coordinates
+    # @param markersize [Array, NArray, Numeric] A list containing the marker sizes
+    # @param marker_z   [Array, NArray, Numeric] A list to be converted to colors
+    #
+    # The values for x and y are in world coordinates.
+    # The attributes that control the appearance of a polymarker are marker type,
+    # marker size scale factor and color index.
+    #
+    def polymarker(x, y, markersize = nil, marker_z = nil)
+      # GR.jl - Multiple dispatch
       n = equal_length(x, y)
-      super(n, x, y)
+      if markersize.nil? && marker_z.nil?
+        super(n, x, y)
+      else
+        markersize ||= GR.inqmarkersize
+        markersize = if markersize.is_a?(Numeric)
+                       Array.new(n, markersize * 100)
+                     else
+                       raise ArgumentError if n != markersize.length
+
+                       markersize.map { |i| (100 * i).round }
+                     end
+        marker_z ||= GR.inqcolor(989) # FIXME
+        color = if marker_z.is_a?(Numeric)
+                  Array.new(n, marker_z)
+                else
+                  raise ArgumentError if n != marker_z.length
+
+                  to_rgb_color(marker_z)
+                end
+        z = markersize.to_a.zip(color).flatten # to_a : NArray
+        gdp(x, y, GDP_DRAW_MARKERS, z)
+      end
     end
 
     # Draw a text at position `x`, `y` using the current text attributes.
-    # @param x [Numeric] The X coordinate of starting position of the text string
-    # @param y [Numeric] The Y coordinate of starting position of the text string
-    # @param string [String] The text to be drawn
+    #
+    # @param x      [Numeric] The X coordinate of starting position of the text
+    #                         string
+    # @param y      [Numeric] The Y coordinate of starting position of the text
+    #                         string
+    # @param string [String]  The text to be drawn
     #
     # The values for `x` and `y` are in normalized device coordinates.
-    # The attributes that control the appearance of text are text font and precision,
-    # character expansion factor, character spacing, text color index, character
-    # height, character up vector, text path and text alignment.
-    def text(*)
-      super
-    end
+    # The attributes that control the appearance of text are text font and
+    # precision, character expansion factor, character spacing, text color index,
+    # character height, character up vector, text path and text alignment.
+    #
+    # @!method text
 
     def inqtext(x, y, string)
       inquiry [{ double: 4 }, { double: 4 }] do |tbx, tby|
@@ -206,11 +274,13 @@ module GR
     end
 
     # Allows you to specify a polygonal shape of an area to be filled.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
     #
-    # The attributes that control the appearance of fill areas are fill area interior
-    # style, fill area style index and fill area color index.
+    # The attributes that control the appearance of fill areas are fill area
+    # interior style, fill area style index and fill area color index.
+    #
     def fillarea(x, y)
       n = equal_length(x, y)
       super(n, x, y)
@@ -220,85 +290,154 @@ module GR
     # function partitions a rectangle given by two corner points into DIMX X DIMY
     # cells, each of them colored individually by the corresponding color index
     # of the given cell array.
-    # @param xmin [Numeric] Lower left point of the rectangle
-    # @param ymin [Numeric] Lower left point of the rectangle
-    # @param xmax [Numeric] Upper right point of the rectangle
-    # @param ymax [Numeric] Upper right point of the rectangle
-    # @param dimx [Integer] X dimension of the color index array
-    # @param dimy [Integer] Y dimension of the color index array
+    #
+    # @param xmin  [Numeric]       Lower left point of the rectangle
+    # @param ymin  [Numeric]       Lower left point of the rectangle
+    # @param xmax  [Numeric]       Upper right point of the rectangle
+    # @param ymax  [Numeric]       Upper right point of the rectangle
+    # @param dimx  [Integer]       X dimension of the color index array
+    # @param dimy  [Integer]       Y dimension of the color index array
     # @param color [Array, NArray] Color index array
     #
     # The values for `xmin`, `xmax`, `ymin` and `ymax` are in world coordinates.
+    #
     def cellarray(xmin, xmax, ymin, ymax, dimx, dimy, color)
       super(xmin, xmax, ymin, ymax, dimx, dimy, 1, 1, dimx, dimy, int(color))
     end
 
     # Display a two dimensional color index array with nonuniform cell sizes.
-    # @param x [Array, NArray] X coordinates of the cell edges
-    # @param y [Array, NArray] Y coordinates of the cell edges
-    # @param dimx [Integer] X dimension of the color index array
-    # @param dimy [Integer] Y dimension of the color index array
+    #
+    # @param x    [Array, NArray] X coordinates of the cell edges
+    # @param y    [Array, NArray] Y coordinates of the cell edges
+    # @param dimx [Integer]       X dimension of the color index array
+    # @param dimy [Integer]       Y dimension of the color index array
     # @param color [Array, NArray] Color index array
+    #
     # The values for `x` and `y` are in world coordinates. `x` must contain
     # `dimx` + 1 elements and `y` must contain `dimy` + 1 elements. The elements
     # i and i+1 are respectively the edges of the i-th cell in X and Y direction.
+    #
     def nonuniformcellarray(x, y, dimx, dimy, color)
       raise ArgumentError unless x.length == dimx + 1 && y.length == dimy + 1
 
-      super(x, y, dimx, dimy, 1, 1, dimx, dimy, int(color))
+      nx = dimx == x.length ? -dimx : dimx
+      ny = dimy == y.length ? -dimy : dimy
+      super(x, y, nx, ny, 1, 1, dimx, dimy, int(color))
     end
 
     # Display a two dimensional color index array mapped to a disk using polar
     # coordinates.
-    # @param xorg [Numeric] X coordinate of the disk center in world coordinates
-    # @param yorg [Numeric] Y coordinate of the disk center in world coordinates
-    # @param phimin [Numeric] start angle of the disk sector in degrees
-    # @param phimax [Numeric] end angle of the disk sector in degrees
-    # @param rmin [Numeric] inner radius of the punctured disk in world coordinates
-    # @param rmax [Numeric] outer radius of the punctured disk in world coordinates
-    # @param dimiphi [Integer] Phi (X) dimension of the color index array
-    # @param dimr [Integer] iR (Y) dimension of the color index array
-    # @param color [Array, NArray] Color index array
     #
     # The two dimensional color index array is mapped to the resulting image by
-    # interpreting the X-axis of the array as the angle and the Y-axis as the raidus.
-    # The center point of the resulting disk is located at `xorg`, `yorg` and the
-    # radius of the disk is `rmax`.
+    # interpreting the X-axis of the array as the angle and the Y-axis as the
+    # raidus. The center point of the resulting disk is located at `xorg`, `yorg`
+    # and the radius of the disk is `rmax`.
+    #
+    # @param x_org   [Numeric]       X coordinate of the disk center in world
+    #                                coordinates
+    # @param y_org   [Numeric]       Y coordinate of the disk center in world
+    #                                coordinates
+    # @param phimin  [Numeric]       start angle of the disk sector in degrees
+    # @param phimax  [Numeric]       end angle of the disk sector in degrees
+    # @param rmin    [Numeric]       inner radius of the punctured disk in world
+    #                                coordinates
+    # @param rmax    [Numeric]       outer radius of the punctured disk in world
+    #                                coordinates
+    # @param dimphi  [Integer]       Phi (X) dimension of the color index array
+    # @param dimr    [Integer]       iR (Y) dimension of the color index array
+    # @param color   [Array, NArray] Color index array
+    #
+    # The additional parameters to the function can be used to further control
+    # the mapping from polar to cartesian coordinates.
+    #
+    # If `rmin` is greater than 0 the input data is mapped to a punctured disk
+    # (or annulus) with an inner radius of `rmin` and an outer radius `rmax`. If
+    # `rmin` is greater than `rmax` the Y-axis of the array is reversed.
+    #
+    # The parameter `phimin` and `phimax` can be used to map the data to a
+    # sector of the (punctured) disk starting at `phimin` and ending at `phimax`.
+    # If `phimin` is greater than `phimax` the X-axis is reversed. The visible
+    # sector is the one starting in mathematically positive direction
+    # (counterclockwise) at the smaller angle and ending at the larger angle.
+    # An example of the four possible options can be found below:
+    #
+    # * phimin 	phimax 	Result
+    # * 90 	    270 	  Left half visible, mapped counterclockwise
+    # * 270 	  90 	    Left half visible, mapped clockwise
+    # * -90 	  90 	    Right half visible, mapped counterclockwise
+    # * 90 	    -90 	  Right half visible, mapped clockwise
+    #
     def polarcellarray(x_org, y_org, phimin, phimax, rmin, rmax, dimphi, dimr, color)
       super(x_org, y_org, phimin, phimax, rmin, rmax, dimphi, dimr, 1, 1, dimphi, dimr, int(color))
     end
 
+    # Display a two dimensional color index array mapped to a disk using polar
+    # coordinates with nonuniform cell sizes.
+    #
+    # @param phi   [Array, NArray] array with the angles of the disk sector in degrees
+    # @param r     [Array, NArray] array with the radii of the disk in world coordinates
+    # @param ncol  [Integer] total number of columns in the color index array and the angle array
+    # @param nrow  [Integer] total number of rows in the color index array and the radii array
+    # @param color [Integer] color index array
+    #
+    # The mapping of the polar coordinates and the drawing is performed simialr
+    # to `gr_polarcellarray` with the difference that the individual cell sizes
+    # are specified allowing nonuniform sized cells.
+    #
+    def nonuniformpolarcellarray(phi, r, ncol, nrow, color)
+      raise ArgumentError unless (ncol..(ncol + 1)).include?(phi.length) && (nrow..(nrow + 1)).include?(r.length)
+
+      dimphi = ncol == phi.length ? -ncol : ncol
+      dimr = nrow == r.length ? -nrow : nrow
+      super(0, 0, phi, r, dimphi, dimr, 1, 1, ncol, nrow, int(color))
+    end
+
     # Generates a generalized drawing primitive (GDP) of the type you specify,
     # using specified points and any additional information contained in a data
     # record.
-    # @param x [Array, NArray] A list containing the X coordinates
-    # @param y [Array, NArray] A list containing the Y coordinates
-    # @param primid [Integer] Primitive identifier
+    #
+    # @param x      [Array, NArray] A list containing the X coordinates
+    # @param y      [Array, NArray] A list containing the Y coordinates
+    # @param primid [Integer]       Primitive identifier
     # @param datrec [Array, NArray] Primitive data record
+    #
     def gdp(x, y, primid, datrec)
       n = equal_length(x, y)
       ldr = datrec.length
-      super(n, x, y, primid, ldr, datrec)
+      super(n, x, y, primid, ldr, int(datrec))
     end
 
     # Generate a cubic spline-fit,
     # starting from the first data point and ending at the last data point.
-    # @param x [Array, NArray] A list containing the X coordinates
-    # @param y [Array, NArray] A list containing the Y coordinates
-    # @param m [Integer] The number of points in the polygon to be drawn (`m` > len(`x`))
-    # @param method [Integer] The smoothing method
+    #
+    # @param x      [Array, NArray] A list containing the X coordinates
+    # @param y      [Array, NArray] A list containing the Y coordinates
+    # @param m      [Integer]       The number of points in the polygon to be
+    #                               drawn (`m` > len(`x`))
+    # @param method [Integer]       The smoothing method
     #  * If `method` is > 0, then a generalized cross-validated smoothing spline is calculated.
     #  * If `method` is 0, then an interpolating natural cubic spline is calculated.
     #  * If `method` is < -1, then a cubic B-spline is calculated.
+    #
     # The values for `x` and `y` are in world coordinates. The attributes that
     # control the appearance of a spline-fit are linetype, linewidth and color
     # index.
+    #
     def spline(x, y, m, method)
       n = equal_length(x, y)
       super(n, x, y, m, method)
     end
 
     # Interpolate data from arbitrary points at points on a rectangular grid.
+    #
+    # @param xd [Array, NArray] X coordinates of the input points
+    # @param yd [Array, NArray] Y coordinates of the input points
+    # @param zd [Array, NArray] values of the points
+    # @param nx [Array, NArray] The number of points in X direction for the
+    #                           output grid
+    # @param ny [Array, NArray] The number of points in Y direction for the
+    #                           output grid
+    #
     def gridit(xd, yd, zd, nx, ny)
       nd = equal_length(xd, yd, zd)
       inquiry [{ double: nx }, { double: ny }, { double: nx * ny }] do |px, py, pz|
@@ -307,172 +446,130 @@ module GR
     end
 
     # Specify the line style for polylines.
+    #
     # @param style [Integer] The polyline line style
-    #  * 1  : LINETYPE_SOLID
-    #    *    Solid line
-    #  * 2  : LINETYPE_DASHED
-    #    *    Dashed line
-    #  * 3  : LINETYPE_DOTTED
-    #    *    Dotted line
-    #  * 4  : LINETYPE_DASHED_DOTTED
-    #    *    Dashed-dotted line
-    #  * -1 : LINETYPE_DASH_2_DOT
-    #    *    Sequence of one dash followed by two dots
-    #  * -2 : LINETYPE_DASH_3_DOT
-    #    *    Sequence of one dash followed by three dots
-    #  * -3 : LINETYPE_LONG_DASH
-    #    *    Sequence of long dashes
-    #  * -4 : LINETYPE_LONG_SHORT_DASH
-    #    *    Sequence of a long dash followed by a short dash
-    #  * -5 : LINETYPE_SPACED_DASH
-    #    *    Sequence of dashes double spaced
-    #  * -6 : LINETYPE_SPACED_DOT
-    #    *    Sequence of dots double spaced
-    #  * -7 : LINETYPE_DOUBLE_DOT
-    #    *    Sequence of pairs of dots
-    #  * -8 : LINETYPE_TRIPLE_DOT
-    #    *    Sequence of groups of three dots
-    def setlinetype(*)
-      super
-    end
+    #  * 1  : LINETYPE_SOLID           - Solid line
+    #  * 2  : LINETYPE_DASHED          - Dashed line
+    #  * 3  : LINETYPE_DOTTED          - Dotted line
+    #  * 4  : LINETYPE_DASHED_DOTTED   - Dashed-dotted line
+    #  * -1 : LINETYPE_DASH_2_DOT      - Sequence of one dash followed by two dots
+    #  * -2 : LINETYPE_DASH_3_DOT      - Sequence of one dash followed by three dots
+    #  * -3 : LINETYPE_LONG_DASH       - Sequence of long dashes
+    #  * -4 : LINETYPE_LONG_SHORT_DASH - Sequence of a long dash followed by a short dash
+    #  * -5 : LINETYPE_SPACED_DASH     - Sequence of dashes double spaced
+    #  * -6 : LINETYPE_SPACED_DOT      - Sequence of dots double spaced
+    #  * -7 : LINETYPE_DOUBLE_DOT      - Sequence of pairs of dots
+    #  * -8 : LINETYPE_TRIPLE_DOT      - Sequence of groups of three dots
+    #
+    # @!method setlinetype
 
     def inqlinetype
       inquiry_int { |pt| super(pt) }
     end
 
     # Define the line width of subsequent polyline output primitives.
+    #
+    # The line width is calculated as the nominal line width generated on the
+    # workstation multiplied by the line width scale factor. This value is mapped
+    # by the workstation to the nearest available line width. The default line
+    # width is 1.0, or 1 times the line width generated on the graphics device.
+    #
     # @param width [Numeric] The polyline line width scale factor
-    # The line width is calculated as the nominal line width generated
-    # on the workstation multiplied by the line width scale factor.
-    # This value is mapped by the workstation to the nearest available line width.
-    # The default line width is 1.0, or 1 times the line width generated on the graphics device.
-    def setlinewidth(*)
-      super
-    end
+    #
+    # @!method setlinewidth
 
     def inqlinewidth
       inquiry_double { |pt| super(pt) }
     end
 
     # Define the color of subsequent polyline output primitives.
+    #
     # @param color [Integer] The polyline color index (COLOR < 1256)
-    def setlinecolorind(*)
-      super
-    end
+    #
+    # @!method setlinecolorind
 
     def inqlinecolorind
       inquiry_int { |pt| super(pt) }
     end
 
     # Specifiy the marker type for polymarkers.
+    #
     # @param style [Integer] The polymarker marker type
-    #  * 1   : MARKERTYPE_DOT
-    #    *     Smallest displayable dot
-    #  * 2   : MARKERTYPE_PLUS
-    #    *     Plus sign
-    #  * 3   : MARKERTYPE_ASTERISK
-    #    *     Asterisk
-    #  * 4   : MARKERTYPE_CIRCLE
-    #    *     Hollow circle
-    #  * 5   : MARKERTYPE_DIAGONAL_CROSS
-    #    *     Diagonal cross
-    #  * -1  : MARKERTYPE_SOLID_CIRCLE
-    #    *     Filled circle
-    #  * -2  : MARKERTYPE_TRIANGLE_UP
-    #    *     Hollow triangle pointing upward
-    #  * -3  : MARKERTYPE_SOLID_TRI_UP
-    #    *     Filled triangle pointing upward
-    #  * -4  : MARKERTYPE_TRIANGLE_DOWN
-    #    *     Hollow triangle pointing downward
-    #  * -5  : MARKERTYPE_SOLID_TRI_DOWN
-    #    *     Filled triangle pointing downward
-    #  * -6  : MARKERTYPE_SQUARE
-    #    *     Hollow square
-    #  * -7  : MARKERTYPE_SOLID_SQUARE
-    #    *     Filled square
-    #  * -8  : MARKERTYPE_BOWTIE
-    #    *     Hollow bowtie
-    #  * -9  : MARKERTYPE_SOLID_BOWTIE
-    #    *     Filled bowtie
-    #  * -10 : MARKERTYPE_HGLASS
-    #    *     Hollow hourglass
-    #  * -11 : MARKERTYPE_SOLID_HGLASS
-    #    *     Filled hourglass
-    #  * -12 : MARKERTYPE_DIAMOND
-    #    *     Hollow diamond
-    #  * -13 : MARKERTYPE_SOLID_DIAMOND
-    #    *     Filled Diamond
-    #  * -14 : MARKERTYPE_STAR
-    #    *     Hollow star
-    #  * -15 : MARKERTYPE_SOLID_STAR
-    #    *     Filled Star
-    #  * -16 : MARKERTYPE_TRI_UP_DOWN
-    #    *     Hollow triangles pointing up and down overlaid
-    #  * -17 : MARKERTYPE_SOLID_TRI_RIGHT
-    #    *     Filled triangle point right
-    #  * -18 : MARKERTYPE_SOLID_TRI_LEFT
-    #    *     Filled triangle pointing left
-    #  * -19 : MARKERTYPE_HOLLOW PLUS
-    #    *     Hollow plus sign
-    #  * -20 : MARKERTYPE_SOLID PLUS
-    #    *     Solid plus sign
-    #  * -21 : MARKERTYPE_PENTAGON
-    #    *     Pentagon
-    #  * -22 : MARKERTYPE_HEXAGON
-    #    *     Hexagon
-    #  * -23 : MARKERTYPE_HEPTAGON
-    #    *     Heptagon
-    #  * -24 : MARKERTYPE_OCTAGON
-    #    *     Octagon
-    #  * -25 : MARKERTYPE_STAR_4
-    #    *     4-pointed star
-    #  * -26 : MARKERTYPE_STAR_5
-    #    *     5-pointed star (pentagram)
-    #  * -27 : MARKERTYPE_STAR_6
-    #    *     6-pointed star (hexagram)
-    #  * -28 : MARKERTYPE_STAR_7
-    #    *     7-pointed star (heptagram)
-    #  * -29 : MARKERTYPE_STAR_8
-    #    *     8-pointed star (octagram)
-    #  * -30 : MARKERTYPE_VLINE
-    #    *     verical line
-    #  * -31 : MARKERTYPE_HLINE
-    #    *     horizontal line
-    #  * -32 : MARKERTYPE_OMARK
-    #    *     o-mark
+    #  * 1   : MARKERTYPE_DOT             - Smallest displayable dot
+    #  * 2   : MARKERTYPE_PLUS            - Plus sign
+    #  * 3   : MARKERTYPE_ASTERISK        - Asterisk
+    #  * 4   : MARKERTYPE_CIRCLE          - Hollow circle
+    #  * 5   : MARKERTYPE_DIAGONAL_CROSS  - Diagonal cross
+    #  * -1  : MARKERTYPE_SOLID_CIRCLE    - Filled circle
+    #  * -2  : MARKERTYPE_TRIANGLE_UP     - Hollow triangle pointing upward
+    #  * -3  : MARKERTYPE_SOLID_TRI_UP    - Filled triangle pointing upward
+    #  * -4  : MARKERTYPE_TRIANGLE_DOWN   - Hollow triangle pointing downward
+    #  * -5  : MARKERTYPE_SOLID_TRI_DOWN  - Filled triangle pointing downward
+    #  * -6  : MARKERTYPE_SQUARE          - Hollow square
+    #  * -7  : MARKERTYPE_SOLID_SQUARE    - Filled square
+    #  * -8  : MARKERTYPE_BOWTIE          - Hollow bowtie
+    #  * -9  : MARKERTYPE_SOLID_BOWTIE    - Filled bowtie
+    #  * -10 : MARKERTYPE_HGLASS          - Hollow hourglass
+    #  * -11 : MARKERTYPE_SOLID_HGLASS    - Filled hourglass
+    #  * -12 : MARKERTYPE_DIAMOND         - Hollow diamond
+    #  * -13 : MARKERTYPE_SOLID_DIAMOND   - Filled Diamond
+    #  * -14 : MARKERTYPE_STAR            - Hollow star
+    #  * -15 : MARKERTYPE_SOLID_STAR      - Filled Star
+    #  * -16 : MARKERTYPE_TRI_UP_DOWN     - Hollow triangles pointing up and down overlaid
+    #  * -17 : MARKERTYPE_SOLID_TRI_RIGHT - Filled triangle point right
+    #  * -18 : MARKERTYPE_SOLID_TRI_LEFT  - Filled triangle pointing left
+    #  * -19 : MARKERTYPE_HOLLOW PLUS     -  Hollow plus sign
+    #  * -20 : MARKERTYPE_SOLID PLUS      - Solid plus sign
+    #  * -21 : MARKERTYPE_PENTAGON        - Pentagon
+    #  * -22 : MARKERTYPE_HEXAGON         - Hexagon
+    #  * -23 : MARKERTYPE_HEPTAGON        - Heptagon
+    #  * -24 : MARKERTYPE_OCTAGON         - Octagon
+    #  * -25 : MARKERTYPE_STAR_4          - 4-pointed star
+    #  * -26 : MARKERTYPE_STAR_5          - 5-pointed star (pentagram)
+    #  * -27 : MARKERTYPE_STAR_6          - 6-pointed star (hexagram)
+    #  * -28 : MARKERTYPE_STAR_7          - 7-pointed star (heptagram)
+    #  * -29 : MARKERTYPE_STAR_8          - 8-pointed star (octagram)
+    #  * -30 : MARKERTYPE_VLINE           - verical line
+    #  * -31 : MARKERTYPE_HLINE           - horizontal line
+    #  * -32 : MARKERTYPE_OMARK           - o-mark
+    #
     # Polymarkers appear centered over their specified coordinates.
-    def setmarkertype(*)
-      super
-    end
+    #
+    # @!method setmarkertype
 
     def inqmarkertype
       inquiry_int { |pt| super(pt) }
     end
 
     # Specify the marker size for polymarkers.
+    #
+    # The polymarker size is calculated as the nominal size generated on the
+    # graphics device multiplied by the marker size scale factor.
+    #
     # @param size [Numeric] Scale factor applied to the nominal marker size
-    # The polymarker size is calculated as the nominal size generated on the graphics device
-    # multiplied by the marker size scale factor.
-    def setmarkersize(*)
-      super
-    end
+    #
+    # @!method setmarkersize
 
     # Inquire the marker size for polymarkers.
+    #
+    # @return [Numeric] Scale factor applied to the nominal marker size
+    #
     def inqmarkersize
       inquiry_double { |pt| super(pt) }
     end
 
     # Define the color of subsequent polymarker output primitives.
+    #
     # @param color [Integer] The polymarker color index (COLOR < 1256)
-    def setmarkercolorind(*)
-      super
-    end
+    #
+    # @!method setmarkercolorind
 
     def inqmarkercolorind
       inquiry_int { |pt| super(pt) }
     end
 
     # Specify the text font and precision for subsequent text output primitives.
+    #
     # @param font [Integer] Text font
     #  * 101 : FONT_TIMES_ROMAN
     #  * 102 : FONT_TIMES_ITALIC
@@ -507,201 +604,215 @@ module GR
     #  * 131 : FONT_ZAPFDINGBATS
     #  * 232 : FONT_COMPUTERMODERN
     #  * 233 : FONT_DEJAVUSANS
+    #
     # @param precision [Integer] Text precision
-    #  * 0 : TEXT_PRECISION_STRING
-    #    *   String precision (higher quality)
-    #  * 1 : TEXT_PRECISION_CHAR
-    #    *   Character precision (medium quality)
-    #  * 2 : TEXT_PRECISION_STROKE
-    #    *   Stroke precision (lower quality)
-    #  * 3 : TEXT_PRECISION_OUTLINE
-    #    *   Outline precision (highest quality)
+    #  * 0 : TEXT_PRECISION_STRING  - String precision (higher quality)
+    #  * 1 : TEXT_PRECISION_CHAR    - Character precision (medium quality)
+    #  * 2 : TEXT_PRECISION_STROKE  - Stroke precision (lower quality)
+    #  * 3 : TEXT_PRECISION_OUTLINE - Outline precision (highest quality)
+    #
     # The appearance of a font depends on the text precision value specified.
     # STRING, CHARACTER or STROKE precision allows for a greater or lesser
     # realization of the text primitives, for efficiency. STRING is the default
     # precision for GR and produces the highest quality output using either
     # native font rendering or FreeType. OUTLINE uses the GR path rendering
     # functions to draw individual glyphs and produces the highest quality output.
-    def settextfontprec(*)
-      super
-    end
+    #
+    # @!method settextfontprec
 
     # Set the current character expansion factor (width to height ratio).
-    # @param factor [Numeric] Text expansion factor applied to the nominal text width-to-height ratio
-    # `setcharexpan` defines the width of subsequent text output primitives. The expansion
-    # factor alters the width of the generated characters, but not their height. The default
-    # text expansion factor is 1, or one times the normal width-to-height ratio of the text.
-    def setcharexpan(*)
-      super
-    end
+    #
+    # `setcharexpan` defines the width of subsequent text output primitives.
+    # The expansion factor alters the width of the generated characters, but not
+    # their height. The default text expansion factor is 1, or one times the
+    # normal width-to-height ratio of the text.
+    #
+    # @param factor [Numeric] Text expansion factor applied to the nominal text
+    #                         width-to-height ratio
+    #
+    # @!method setcharexpan
 
-    def setcharspace(*)
-      super
-    end
+    # @!method setcharspace
 
     # Sets the current text color index.
-    # @param color [Integer] The text color index (COLOR < 1256)
+    #
     # `settextcolorind` defines the color of subsequent text output primitives.
-    # GR uses the default foreground color (black=1) for the default text color index.
-    def settextcolorind(*)
-      super
-    end
+    # GR uses the default foreground color (black=1) for the default text color
+    # index.
+    #
+    # @param color [Integer] The text color index (COLOR < 1256)
+    #
+    # @!method settextcolorind
 
     # Gets the current text color index.
+    #
     # This function gets the color of text output primitives.
+    #
     # @return [Integer] color The text color index (COLOR < 1256)
     def inqtextcolorind
       inquiry_int { |pt| super(pt) }
     end
 
     # Set the current character height.
+    #
+    # `setcharheight` defines the height of subsequent text output primitives.
+    # Text height is defined as a percentage of the default window. GR uses the
+    # default text height of 0.027 (2.7% of the height of the default window).
+    #
     # @param height [Numeric] Text height value
-    # `setcharheight` defines the height of subsequent text output primitives. Text height
-    # is defined as a percentage of the default window. GR uses the default text height of
-    # 0.027 (2.7% of the height of the default window).
-    def setcharheight(*)
-      super
-    end
+    #
+    # @!method setcharheight
 
     # Gets the current character height.
+    #
     # This function gets the height of text output primitives. Text height is
     # defined as a percentage of the default window. GR uses the default text
     # height of 0.027 (2.7% of the height of the default window).
+    #
+    # @return [Numeric] Text height value
     def inqcharheight
       inquiry_double { |pt| super(pt) }
     end
 
     # Set the current character text angle up vector.
-    # @param ux [Numeric] Text up vector
-    # @param uy [Numeric] Text up vector
-    # `setcharup` defines the vertical rotation of subsequent text output primitives.
-    # The text up vector is initially set to (0, 1), horizontal to the baseline.
-    def setcharup(*)
-      super
-    end
+    #
+    # `setcharup` defines the vertical rotation of subsequent text output
+    # primitives. The text up vector is initially set to (0, 1), horizontal to
+    # the baseline.
+    #
+    # @param ux [Numeric] X coordinate of the text up vector
+    # @param uy [Numeric] Y coordinate of the text up vector
+    #
+    # @!method setcharup
 
     # Define the current direction in which subsequent text will be drawn.
+    #
     # @param path [Integer] Text path
-    #  * 0 : TEXT_PATH_RIGHT
-    #    *   left-to-right
-    #  * 1 : TEXT_PATH_LEFT
-    #    *   right-to-left
-    #  * 2 : TEXT_PATH_UP
-    #    *   downside-up
-    #  * 3 : TEXT_PATH_DOWN
-    #    *   upside-down
-    def settextpath(*)
-      super
-    end
+    #  * 0 : TEXT_PATH_RIGHT - left-to-right
+    #  * 1 : TEXT_PATH_LEFT  - right-to-left
+    #  * 2 : TEXT_PATH_UP    - downside-up
+    #  * 3 : TEXT_PATH_DOWN  - upside-down
+    #
+    # @!method settextpath
 
     # Set the current horizontal and vertical alignment for text.
+    #
     # @param horizontal [Integer] Horizontal text alignment
-    #  * 0 : TEXT_HALIGN_NORMAL
-    #  * 1 : TEXT_HALIGN_LEFT
-    #    *   Left justify
-    #  * 2 : TEXT_HALIGN_CENTER
-    #    *   Center justify
-    #  * 3 : TEXT_HALIGN_RIGHT
-    #    *   Right justify
+    #  * 0 : TEXT_HALIGN_NORMALlygon using the fill color index
+
+    #  * 1 : TEXT_HALIGN_LEFT   - Left justify
+    #  * 2 : TEXT_HALIGN_CENTER - Center justify
+    #  * 3 : TEXT_HALIGN_RIGHT  - Right justify
+    #
     # @param vertical [Integer] Vertical text alignment
     #  * 0 : TEXT_VALIGN_NORMAL   
-    #  * 1 : TEXT_VALIGN_TOP
-    #    *   Align with the top of the characters
-    #  * 2 : TEXT_VALIGN_CAP
-    #    *   Aligned with the cap of the characters
-    #  * 3 : TEXT_VALIGN_HALF
-    #    *   Aligned with the half line of the characters
-    #  * 4 : TEXT_VALIGN_BASE
-    #    *   Aligned with the base line of the characters
-    #  * 5 : TEXT_VALIGN_BOTTOM
-    #    *   Aligned with the bottom line of the characters
-    # `settextalign` specifies how the characters in a text primitive will be aligned
-    # in horizontal and vertical space. The default text alignment indicates horizontal left
-    # alignment and vertical baseline alignment.
-    def settextalign(*)
-      super
-    end
+    #  * 1 : TEXT_VALIGN_TOP    - Align with the top of the characters
+    #  * 2 : TEXT_VALIGN_CAP    - Aligned with the cap of the characters
+    #  * 3 : TEXT_VALIGN_HALF   - Aligned with the half line of the characters
+    #  * 4 : TEXT_VALIGN_BASE   - Aligned with the base line of the characters
+    #  * 5 : TEXT_VALIGN_BOTTOM - Aligned with the bottom line of the characters
+    #
+    # `settextalign` specifies how the characters in a text primitive will be
+    # aligned in horizontal and vertical space. The default text alignment
+    # indicates horizontal left alignment and vertical baseline alignment.
+    #
+    # @!method settextalign
 
     # Set the fill area interior style to be used for fill areas.
+    #
     # @param style [Integer] The style of fill to be used
-    #  * 0 : HOLLOW
-    #    *   No filling. Just draw the bounding polyline
-    #  * 1 : SOLID
-    #    *   Fill the interior of the polygon using the fill color index
-    #  * 2 : PATTERN
-    #    *   Fill the interior of the polygon using the style index as a pattern index
-    #  * 3 : HATCH
-    #    *   Fill the interior of the polygon using the style index as a cross-hatched style
-    #  * 4 : SOLID_WITH_BORDER
-    #    *   Fill the interior of the polygon using the fill color index and draw the bounding polyline
+    #  * 0 : HOLLOW  - No filling. Just draw the bounding polyline
+    #  * 1 : SOLID   - Fill the interior of the polygon using the fill color index
+    #  * 2 : PATTERN - Fill the interior of the polygon using the style index as a pattern index
+    #  * 3 : HATCH   - Fill the interior of the polygon using the style index as a cross-hatched style
+    #  * 4 : SOLID_WITH_BORDER - Fill the interior of the polygon using the fill color index and draw the bounding polyline
+    #
     # `setfillintstyle` defines the interior style  for subsequent fill area output
     # primitives. The default interior style is HOLLOW.
-    def setfillintstyle(*)
-      super
-    end
+    #
+    # @!method setfillintstyle
 
     # Returns the fill area interior style to be used for fill areas.
+    #
+    # This function gets the currently set fill style.
+    #
+    # @return [Integer] The currently set fill style
     def inqfillintstyle
       inquiry_int { |pt| super(pt) }
     end
 
     # Sets the fill style to be used for subsequent fill areas.
+    #
+    # `setfillstyle` specifies an index when PATTERN fill or HATCH fill is
+    # requested by the`setfillintstyle` function. If the interior style is set
+    # to PATTERN, the fill style index points to a device-independent pattern
+    # table. If interior style is set to HATCH the fill style index indicates
+    # different hatch styles. If HOLLOW or SOLID is specified for the interior
+    # style, the fill style index is unused.
+    #
     # @param index [Integer] The fill style index to be used
-    # `setfillstyle` specifies an index when PATTERN fill or HATCH fill is requested by the
-    # `setfillintstyle` function. If the interior style is set to PATTERN, the fill style
-    # index points to a device-independent pattern table. If interior style is set to HATCH
-    # the fill style index indicates different hatch styles. If HOLLOW or SOLID is specified
-    # for the interior style, the fill style index is unused.
-    def setfillstyle(*)
-      super
-    end
+    #
+    # @!method setfillstyle
 
     # Returns the current fill area color index.
+    #
     # This function gets the color index for PATTERN and HATCH fills.
+    #
+    # @return [Integer] The currently set fill style color index
     def inqfillstyle
       inquiry_int { |pt| super(pt) }
     end
 
     # Sets the current fill area color index.
+    #
+    # `setfillcolorind` defines the color of subsequent fill area output
+    # primitives. GR uses the default foreground color (black=1) for the default
+    # fill area color index.
+    #
     # @param color [Integer] The text color index (COLOR < 1256)
-    # `setfillcolorind` defines the color of subsequent fill area output primitives.
-    # GR uses the default foreground color (black=1) for the default fill area color index.
-    def setfillcolorind(*)
-      super
-    end
+    #
+    # @!method setfillcolorind
 
     # Returns the current fill area color index.
+    #
     # This function gets the color of fill area output primitives.
+    #
+    # @return [Integer] The text color index (COLOR < 1256)
     def inqfillcolorind
       inquiry_int { |pt| super(pt) }
     end
 
-    # `setcolorrep` allows to redefine an existing color index representation by specifying
-    # an RGB color triplet.
+    # Redefine an existing color index representation by specifying an RGB color
+    # triplet.
+    #
     # @param index [Integer] Color index in the range 0 to 1256
-    # @param red [Numeric] Red intensity in the range 0.0 to 1.0
+    # @param red   [Numeric] Red intensity in the range 0.0 to 1.0
     # @param green [Numeric] Green intensity in the range 0.0 to 1.0
-    # @param blue [Numeric] Blue intensity in the range 0.0 to 1.0
-    def setcolorrep(*)
-      super
-    end
+    # @param blue  [Numeric] Blue intensity in the range 0.0 to 1.0
+    #
+    # @!method setcolorrep
 
-    # `setwindow` establishes a window, or rectangular subspace, of world coordinates to be
-    # plotted. If you desire log scaling or mirror-imaging of axes, use the SETSCALE function.
-    # @param xmin [Numeric] The left horizontal coordinate of the window (`xmin` < `xmax`).
+    # `setwindow` establishes a window, or rectangular subspace, of world
+    # coordinates to be plotted. If you desire log scaling or mirror-imaging of
+    # axes, use the SETSCALE function.
+    #
+    # `setwindow` defines the rectangular portion of the World Coordinate space
+    # (WC) to be associated with the specified normalization transformation. The
+    # WC window and the Normalized Device Coordinates (NDC) viewport define the
+    # normalization transformation through which all output primitives are
+    # mapped. The WC window is mapped onto the rectangular NDC viewport which is,
+    # in turn, mapped onto the display surface of the open and active workstation,
+    # in device coordinates. By default, GR uses the range [0,1] x [0,1], in
+    # world coordinates, as the normalization transformation window.
+    #
+    # @param xmin [Numeric] The left horizontal coordinate of the window
+    #                       (`xmin` < `xmax`).
     # @param xmax [Numeric] The right horizontal coordinate of the window.
-    # @param ymin [Numeric] The bottom vertical coordinate of the window (`ymin` < `ymax`).
+    # @param ymin [Numeric] The bottom vertical coordinate of the window
+    #                       (`ymin` < `ymax`).
     # @param ymax [Numeric] The top vertical coordinate of the window.
-    # `setwindow` defines the rectangular portion of the World Coordinate space (WC) to be
-    # associated with the specified normalization transformation. The WC window and the
-    # Normalized Device Coordinates (NDC) viewport define the normalization transformation
-    # through which all output primitives are mapped. The WC window is mapped onto the
-    # rectangular NDC viewport which is, in turn, mapped onto the display surface of the
-    # open and active workstation, in device coordinates. By default, GR uses the range
-    # \[0,1] x [0,1], in world coordinates, as the normalization transformation window.
-    def setwindow(*)
-      super
-    end
+    #
+    # @!method setwindow
 
     # inqwindow
     def inqwindow
@@ -710,20 +821,25 @@ module GR
       end
     end
 
-    # `setviewport` establishes a rectangular subspace of normalized device coordinates.
+    # `setviewport` establishes a rectangular subspace of normalized device
+    # coordinates.
+    #
+    # `setviewport` defines the rectangular portion of the Normalized Device
+    # Coordinate (NDC) space to be associated with the specified normalization
+    # transformation. The NDC viewport and World Coordinate (WC) window define
+    # the normalization transformation through which all output primitives pass.
+    # The WC window is mapped onto the rectangular NDC viewport which is, in
+    # turn, mapped onto the display surface of the open and active workstation,
+    # in device coordinates.
+    #
     # @param xmin [Numeric] The left horizontal coordinate of the viewport.
-    # @param xmax [Numeric] The right horizontal coordinate of the viewport (0 <= `xmin` < `xmax` <= 1).
+    # @param xmax [Numeric] The right horizontal coordinate of the viewport
+    #                       (0 <= `xmin` < `xmax` <= 1).
     # @param ymin [Numeric] The bottom vertical coordinate of the viewport.
-    # @param ymax [Numeric] The top vertical coordinate of the viewport (0 <= `ymin` < `ymax` <= 1).
-    # `setviewport` defines the rectangular portion of the Normalized Device Coordinate
-    # (NDC) space to be associated with the specified normalization transformation. The
-    # NDC viewport and World Coordinate (WC) window define the normalization transformation
-    # through which all output primitives pass. The WC window is mapped onto the rectangular
-    # NDC viewport which is, in turn, mapped onto the display surface of the open and active
-    # workstation, in device coordinates.
-    def setviewport(*)
-      super
-    end
+    # @param ymax [Numeric] The top vertical coordinate of the viewport
+    #                       (0 <= `ymin` < `ymax` <= 1).
+    #
+    # @!method setviewport
 
     # inqviewport
     def inqviewport
@@ -732,99 +848,103 @@ module GR
       end
     end
 
-    # `selntran` selects a predefined transformation from world coordinates to normalized
-    # device coordinates.
+    # `selntran` selects a predefined transformation from world coordinates to
+    # normalized device coordinates.
+    #
     # @param transform [Integer] A normalization transformation number.
-    #  * 0    : Selects the identity transformation in which both the window and viewport have the range of 0 to 1
-    #  * >= 1 : Selects a normalization transformation as defined by `setwindow` and `setviewport`
-    def selntran(*)
-      super
-    end
+    #  * 0    : Selects the identity transformation in which both the window and
+    #           viewport have the range of 0 to 1
+    #  * >= 1 : Selects a normalization transformation as defined by `setwindow`
+    #           and `setviewport`
+    #
+    # @!method selntran
 
     # Set the clipping indicator.
-    # @params indicator [Integer] An indicator specifying whether clipping is on or off.
+    #
+    # @param indicator [Integer] An indicator specifying whether clipping is on
+    #                             or off.
     # * 0 : Clipping is off. Data outside of the window will be drawn.
     # * 1 : Clipping is on. Data outside of the window will not be drawn.
-    # `setclip` enables or disables clipping of the image drawn in the current window.
-    # Clipping is defined as the removal of those portions of the graph that lie outside of
-    # the defined viewport. If clipping is on, GR does not draw generated output primitives
-    # past the viewport boundaries. If clipping is off, primitives may exceed the viewport
-    # boundaries, and they will be drawn to the edge of the workstation window.
-    # By default, clipping is on.
-    def setclip(*)
-      super
-    end
-
-    # Set the area of the NDC viewport that is to be drawn in the workstation window.
-    # @param xmin [Numeric] The left horizontal coordinate of the workstation window.
-    # @param xmax [Numeric] The right horizontal coordinate of the workstation window (0 <= `xmin` < `xmax` <= 1).
-    # @param ymin [Numeric] The bottom vertical coordinate of the workstation window.
-    # @param ymax [Numeric] The top vertical coordinate of the workstation window (0 <= `ymin` < `ymax` <= 1).
-    # `setwswindow` defines the rectangular area of the Normalized Device Coordinate space
-    # to be output to the device. By default, the workstation transformation will map the
-    # range [0,1] x [0,1] in NDC onto the largest square on the workstation’s display
-    # surface. The aspect ratio of the workstation window is maintained at 1 to 1.
-    def setwswindow(*)
-      super
-    end
+    #
+    # `setclip` enables or disables clipping of the image drawn in the current
+    # window. Clipping is defined as the removal of those portions of the graph
+    # that lie outside of the defined viewport. If clipping is on, GR does not
+    # draw generated output primitives past the viewport boundaries. If clipping
+    # is off, primitives may exceed the viewport boundaries, and they will be
+    # drawn to the edge of the workstation window. By default, clipping is on.
+    #
+    # @!method setclip
+
+    # Set the area of the NDC viewport that is to be drawn in the workstation
+    # window.
+    #
+    # `setwswindow` defines the rectangular area of the Normalized Device
+    # Coordinate space to be output to the device. By default, the workstation
+    # transformation will map the range [0,1] x [0,1] in NDC onto the largest
+    # square on the workstation’s display surface. The aspect ratio of the
+    # workstation window is maintained at 1 to 1.
+    #
+    # @param xmin [Numeric] The left horizontal coordinate of the workstation
+    #                       window.
+    # @param xmax [Numeric] The right horizontal coordinate of the workstation
+    #                       window (0 <= `xmin` < `xmax` <= 1).
+    # @param ymin [Numeric] The bottom vertical coordinate of the workstation
+    #                       window.
+    # @param ymax [Numeric] The top vertical coordinate of the workstation
+    #                       window (0 <= `ymin` < `ymax` <= 1).
+    #
+    # @!method setwswindow
 
     # Define the size of the workstation graphics window in meters.
-    # @param xmin [Numeric] The left horizontal coordinate of the workstation viewport.
-    # @param xmax [Numeric] The right horizontal coordinate of the workstation viewport.
-    # @param ymin [Numeric] The bottom vertical coordinate of the workstation viewport.
-    # @param ymax [Numeric] The top vertical coordinate of the workstation viewport.
-    # `setwsviewport` places a workstation window on the display of the specified size in
-    # meters. This command allows the workstation window to be accurately sized for a
-    # display or hardcopy device, and is often useful for sizing graphs for desktop
-    # publishing applications.
-    def setwsviewport(*)
-      super
-    end
+    #
+    # `setwsviewport` places a workstation window on the display of the
+    # specified size in meters. This command allows the workstation window to be
+    # accurately sized for a display or hardcopy device, and is often useful for
+    # sizing graphs for desktop publishing applications.
+    #
+    # @param xmin [Numeric] The left horizontal coordinate of the workstation
+    #                       viewport.
+    # @param xmax [Numeric] The right horizontal coordinate of the workstation
+    #                       viewport.
+    # @param ymin [Numeric] The bottom vertical coordinate of the workstation
+    #                       viewport.
+    # @param ymax [Numeric] The top vertical coordinate of the workstation
+    #                       viewport.
+    #
+    # @!method setwsviewport
 
-    def createseg(*)
-      super
-    end
+    # @!method createseg
 
-    def copysegws(*)
-      super
-    end
+    # @!method copysegws
 
-    def redrawsegws(*)
-      super
-    end
+    # @!method redrawsegws
 
-    def setsegtran(*)
-      super
-    end
+    # @!method setsegtran
 
-    def closeseg(*)
-      super
-    end
+    # @!method closeseg
 
-    def emergencyclosegks(*)
-      super
-    end
+    # @!method emergencyclosegks
 
-    def updategks(*)
-      super
-    end
+    # @!method updategks
 
-    # Set the abstract Z-space used for mapping three-dimensional output primitives into
-    # the current world coordinate space.
-    # @param zmin [Numeric] Minimum value for the Z-axis.
-    # @param zmax [Numeric] Maximum value for the Z-axis.
+    # Set the abstract Z-space used for mapping three-dimensional output
+    # primitives into the current world coordinate space.
+    #
+    # `setspace` establishes the limits of an abstract Z-axis and defines the
+    # angles for rotation and for the viewing angle (tilt) of a simulated
+    # three-dimensional graph, used for mapping corresponding output primitives
+    # into the current window. These settings are used for all subsequent
+    # three-dimensional output primitives until other values are specified.
+    # Angles of rotation and viewing angle must be specified between 0° and 90°.
+    #
+    # @param zmin     [Numeric] Minimum value for the Z-axis.
+    # @param zmax     [Numeric] Maximum value for the Z-axis.
     # @param rotation [Integer] Angle for the rotation of the X axis, in degrees.
-    # @param tilt [integer] Viewing angle of the Z axis in degrees.
-    # @return [Integer]
-    # `setspace` establishes the limits of an abstract Z-axis and defines the angles for
-    # rotation and for the viewing angle (tilt) of a simulated three-dimensional graph,
-    # used for mapping corresponding output primitives into the current window.
-    # These settings are used for all subsequent three-dimensional output primitives until
-    # other values are specified. Angles of rotation and viewing angle must be specified
-    # between 0° and 90°.
-    def setspace(*)
-      super
-    end
+    # @param tilt     [integer] Viewing angle of the Z axis in degrees.
+    #
+    # @return         [Integer]
+    #
+    # @!method setspace
 
     def inqspace
       inquiry %i[double double int int] do |*pts|
@@ -832,64 +952,63 @@ module GR
       end
     end
 
-    # `setscale` sets the type of transformation to be used for subsequent GR output
-    # primitives.
+    # `setscale` sets the type of transformation to be used for subsequent GR
+    # output primitives.
+    #
     # @param options [Integer] Scale specification
-    #  * 1 :  OPTION_X_LOG
-    #    *    Logarithmic X-axis
-    #  * 2 :  OPTION_Y_LOG
-    #    *    Logarithmic Y-axis
-    #  * 4 :  OPTION_Z_LOG
-    #    *    Logarithmic Z-axis
-    #  * 8 :  OPTION_FLIP_X
-    #    *    Flip X-axis
-    #  * 16 : OPTION_FLIP_Y
-    #    *    Flip Y-axis
-    #  * 32 : OPTION_FLIP_Z
-    #    *    Flip Z-axis
+    #  * 1 :  OPTION_X_LOG - Logarithmic X-axis
+    #  * 2 :  OPTION_Y_LOG - Logarithmic Y-axis
+    #  * 4 :  OPTION_Z_LOG - Logarithmic Z-axis
+    #  * 8 :  OPTION_FLIP_X - Flip X-axis
+    #  * 16 : OPTION_FLIP_Y - Flip Y-axis
+    #  * 32 : OPTION_FLIP_Z - Flip Z-axis
+    #
     # @return [Integer]
+    #
     # `setscale` defines the current transformation according to the given scale
-    # specification which may be or'ed together using any of the above options. GR uses
-    # these options for all subsequent output primitives until another value is provided.
-    # The scale options are used to transform points from an abstract logarithmic or
-    # semi-logarithmic coordinate system, which may be flipped along each axis, into the
-    # world coordinate system.
-    # Note: When applying a logarithmic transformation to a specific axis, the system
-    # assumes that the axes limits are greater than zero.
-    def setscale(*)
-      super
-    end
+    # specification which may be or'ed together using any of the above options.
+    # GR uses these options for all subsequent output primitives until another
+    # value is provided. The scale options are used to transform points from an
+    # abstract logarithmic or semi-logarithmic coordinate system, which may be
+    # flipped along each axis, into the world coordinate system.
+    #
+    # Note: When applying a logarithmic transformation to a specific axis, the
+    # system assumes that the axes limits are greater than zero.
+    #
+    # @!method setscale
 
     # inqscale
     def inqscale
       inquiry_int { |pt| super(pt) }
     end
 
-    # Draw a text at position `x`, `y` using the current text attributes. Strings can be
-    # defined to create basic mathematical expressions and Greek letters.
+    # Draw a text at position `x`, `y` using the current text attributes.
+    # Strings can be defined to create basic mathematical expressions and Greek
+    # letters.
+    #
+    # The values for X and Y are in normalized device coordinates.
+    # The attributes that control the appearance of text are text font and
+    # precision, character expansion factor, character spacing, text color index,
+    # character height, character up vector, text path and text alignment.
+    #
     # @param x [Numeric] The X coordinate of starting position of the text string
     # @param y [Numeric] The Y coordinate of starting position of the text string
-    # @param string [String] The text to be drawn
+    # @param string [String]  The text to be drawn
     # @return [Integer]
     #
-    # The values for X and Y are in normalized device coordinates.
-    # The attributes that control the appearance of text are text font and precision,
-    # character expansion factor, character spacing, text color index, character
-    # height, character up vector, text path and text alignment.
-    #
     # The character string is interpreted to be a simple mathematical formula.
     # The following notations apply:
     #
-    # Subscripts and superscripts: These are indicated by carets ('^') and underscores
-    # \('_'). If the sub/superscript contains more than one character, it must be enclosed
-    # in curly braces ('{}').
+    # Subscripts and superscripts: These are indicated by carets ('^') and
+    # underscores \('_'). If the sub/superscript contains more than one character,
+    # it must be enclosed in curly braces ('{}').
     #
-    # Fractions are typeset with A '/' B, where A stands for the numerator and B for the
-    # denominator.
+    # Fractions are typeset with A '/' B, where A stands for the numerator and B
+    # for the denominator.
     #
     # To include a Greek letter you must specify the corresponding keyword after a
-    # backslash ('\') character. The text translator produces uppercase or lowercase
-    # Greek letters depending on the case of the keyword.
+    # backslash ('\') character. The text translator produces uppercase or
+    # lowercase Greek letters depending on the case of the keyword.
     #  * Α α - alpha
     #  * Β β - beta
     #  * Γ γ - gamma
@@ -915,11 +1034,10 @@ module GR
     #  * Ψ ψ - psi
     #  * Ω ω - omega
     # Note: `\v` is a replacement for `\nu` which would conflict with `\n` (newline)
-    # For more sophisticated mathematical formulas, you should use the `gr.mathtex`
+    # For more sophisticated mathematical formulas, you should use the `mathtex`
     # function.
-    def textext(*)
-      super
-    end
+    #
+    # @!method textext
 
     # inqtextext
     def inqtextext(x, y, string)
@@ -928,11 +1046,17 @@ module GR
       end
     end
 
-    # Draw X and Y coordinate axes with linearly and/or logarithmically spaced tick marks.
-    # @param x_tick [Numeric] The interval between minor tick marks on the X axis.
-    # @param y_tick [Numeric] The interval between minor tick marks on the Y axis.
-    # @param x_org [Numeric] The world coordinates of the origin (point of intersection) of the X axis.
-    # @param y_org [Numeric] The world coordinates of the origin (point of intersection) of the Y axis.
+    # Draw X and Y coordinate axes with linearly and/or logarithmically spaced
+    # tick marks.
+    #
+    # @param x_tick [Numeric]
+    #   The interval between minor tick marks on the X axis.
+    # @param y_tick [Numeric]
+    #   The interval between minor tick marks on the Y axis.
+    # @param x_org  [Numeric]
+    #   The world coordinates of the origin (point of intersection) of the X axis.
+    # @param y_org  [Numeric]
+    #   The world coordinates of the origin (point of intersection) of the Y axis.
     # @param major_x [Integer]
     #   Unitless integer values specifying the number of minor tick intervals
     #   between major tick marks. Values of 0 or 1 imply no minor ticks.
@@ -946,6 +1070,7 @@ module GR
     #   coordinate unit. Major tick marks are twice as long as minor tick marks.
     #   A negative value reverses the tick marks on the axes from inward facing
     #   to outward facing (or vice versa).
+    #
     # Tick marks are positioned along each axis so that major tick marks fall on
     # the axes origin (whether visible or not). Major tick marks are labeled
     # with the corresponding data values. Axes are drawn according to the scale
@@ -953,95 +1078,134 @@ module GR
     # and width can be modified using the gr_setlinetype and gr_setlinewidth
     # functions. Axes are drawn according to the linear or logarithmic
     # transformation established by the gr_setscale function.
-    def axes(*)
-      super
-    end
+    #
+    # @!method axes
 
     alias axes2d axes
 
     # Create axes in the current workspace and supply a custom function for
     # changing the behaviour of the tick labels.
-    # @param x_tick [Numeric] The interval between minor tick marks on the X axis.
-    # @param y_tick [Numeric] The interval between minor tick marks on the Y axis.
-    # @param x_org [Numeric] The world coordinate of the origin (point of intersection) of the X axis.
-    # @param y_org [Numeric] The world coordinate of the origin (point of intersection) of the Y axis.
-    # @param major_x [Integer] Unitless integer value specifying the number of minor tick intervals between major tick marks on the X axis. Values of 0 or 1 imply no minor ticks. Negative values specify no labels will be drawn for the associated axis.
-    # @param major_y [Integer] Unitless integer value specifying the number of minor tick intervals between major tick marks on the Y axis. Values of 0 or 1 imply no minor ticks. Negative values specify no labels will be drawn for the associated axis.
-    # @param tick_size [Numeric] The length of minor tick marks specified in a normalized device coordinate unit. Major tick marks are twice as long as minor tick marks. A negative value reverses the tick marks on the axes from inward facing to outward facing (or vice versa).
-    # @param fpx [Pointer] Function pointer to a function that returns a label for a given tick on the X axis. The callback function should have the following arguments [Numeric]
-    # @param fpy [Pointer] Exactly same as the fpx above, but for the the Y axis.
+    #
+    # @note This method uses GRCommons::Fiddley::Function as a callback function.
+    #       Please read the source code If you have to use it. There are some
+    #       examples of the use of this function in the Plot class..
+    #
     # Similar to gr_axes() but allows more fine-grained control over tick labels
     # and text positioning by supplying callback functions. Within the callback
     # function you can use normal GR text primitives for performing any
     # manipulations on the label text.
     # See gr_axes() for more details on drawing axes.
+    #
+    # @param x_tick [Numeric]
+    #   The interval between minor tick marks on the X axis.
+    # @param y_tick  [Numeric]
+    #   The interval between minor tick marks on the Y axis.
+    # @param x_org   [Numeric]
+    #   The world coordinate of the origin (point of intersection) of the X axis.
+    # @param y_org   [Numeric]
+    #   The world coordinate of the origin (point of intersection) of the Y axis.
+    # @param major_x [Integer]
+    #   Unitless integer value specifying the number of minor tick intervals
+    #   between major tick marks on the X axis. Values of 0 or 1 imply no minor
+    #   ticks. Negative values specify no labels will be drawn for the associated
+    #   axis.
+    # @param major_y [Integer]
+    #   Unitless integer value specifying the number of minor tick intervals
+    #   between major tick marks on the Y axis. Values of 0 or 1 imply no minor
+    #   ticks. Negative values specify no labels will be drawn for the associated
+    #   axis.
+    # @param tick_size [Numeric]
+    #   The length of minor tick marks specified in a normalized device
+    #   coordinate unit. Major tick marks are twice as long as minor tick marks.
+    #   A negative value reverses the tick marks on the axes from inward facing
+    #   to outward facing (or vice versa).
+    # @param fpx [Pointer]
+    #   Function pointer to a function that returns a label for a given tick on
+    #   the X axis. The callback function should have the following arguments.
+    # @param fpy [Pointer] Exactly same as the fpx above, but for the the Y axis.
+    #
     # * fpx/fpy
     #   * param x [Numeric] NDC of the label in X direction.
     #   * param y [Numeric] NDC of the label in Y direction.
     #   * param svalue [String] Internal string representation of the text drawn by GR at (x,y).
     #   * param value [Numeric] Floating point representation of the label drawn at (x,y).
-    def axeslbl(*)
-      super
-    end
+    #
+    # @!method axeslbl
 
     # Draw a linear and/or logarithmic grid.
-    # @param x_tick [Numeric] The length in world coordinates of the interval between minor grid lines.
-    # @param y_tick [Numeric] The length in world coordinates of the interval between minor grid lines.
-    # @param x_org [Numeric] The world coordinates of the origin (point of intersection) of the grid.
-    # @param y_org [Numeric] The world coordinates of the origin (point of intersection) of the grid.
-    # @param major_x [Integer]
-    #   Unitless integer values specifying the number of minor grid lines
-    #   between major grid lines. Values of 0 or 1 imply no grid lines.
-    # @param major_y [Integer]
-    #   Unitless integer values specifying the number of minor grid lines
-    #   between major grid lines. Values of 0 or 1 imply no grid lines.
     #
-    # Major grid lines correspond to the axes origin and major tick marks whether visible
-    # or not. Minor grid lines are drawn at points equal to minor tick marks. Major grid
-    # lines are drawn using black lines and minor grid lines are drawn using gray lines.
-    def grid(*)
-      super
-    end
+    # Major grid lines correspond to the axes origin and major tick marks whether
+    # visible or not. Minor grid lines are drawn at points equal to minor tick
+    # marks. Major grid lines are drawn using black lines and minor grid lines
+    # are drawn using gray lines.
+    #
+    # @param x_tick  [Numeric] The length in world coordinates of the interval
+    #                          between minor grid lines.
+    # @param y_tick  [Numeric] The length in world coordinates of the interval
+    #                          between minor grid lines.
+    # @param x_org   [Numeric] The world coordinates of the origin (point of
+    #                          intersection) of the grid.
+    # @param y_org   [Numeric] The world coordinates of the origin (point of
+    #                          intersection) of the grid.
+    # @param major_x [Integer] Unitless integer values specifying the number of
+    #                          minor grid lines between major grid lines.
+    #                          Values of 0 or 1 imply no grid lines.
+    # @param major_y [Integer] Unitless integer values specifying the number of
+    #                          minor grid lines between major grid lines.
+    #                          Values of 0 or 1 imply no grid lines.
+    #
+    # @!method grid
 
     # Draw a linear and/or logarithmic grid.
-    # @param x_tick [Numeric] The length in world coordinates of the interval between minor grid lines.
-    # @param y_tick [Numeric] The length in world coordinates of the interval between minor grid lines.
-    # @param z_tick [Numeric] The length in world coordinates of the interval between minor grid lines.
-    # @param x_org [Numeric] The world coordinates of the origin (point of intersection) of the grid.
-    # @param y_org [Numeric] The world coordinates of the origin (point of intersection) of the grid.
-    # @param z_org [Numeric] The world coordinates of the origin (point of intersection) of the grid.
-    # @param major_x [Integer]
-    #   Unitless integer values specifying the number of minor grid lines
-    #   between major grid lines. Values of 0 or 1 imply no grid lines.
-    # @param major_y [Integer]
-    #   Unitless integer values specifying the number of minor grid lines
-    #   between major grid lines. Values of 0 or 1 imply no grid lines.
-    # @param major_z [Integer]
-    #   Unitless integer values specifying the number of minor grid lines
-    #   between major grid lines. Values of 0 or 1 imply no grid lines.
     #
-    # Major grid lines correspond to the axes origin and major tick marks whether visible
-    # or not. Minor grid lines are drawn at points equal to minor tick marks. Major grid
-    # lines are drawn using black lines and minor grid lines are drawn using gray lines.
-    def grid3d(*)
-      super
-    end
+    # Major grid lines correspond to the axes origin and major tick marks whether
+    # visible or not. Minor grid lines are drawn at points equal to minor tick
+    # marks. Major grid lines are drawn using black lines and minor grid lines
+    # are drawn using gray lines.
+    #
+    # @param x_tick  [Numeric] The length in world coordinates of the interval
+    #                          between minor grid lines.
+    # @param y_tick  [Numeric] The length in world coordinates of the interval
+    #                          between minor grid lines.
+    # @param z_tick  [Numeric] The length in world coordinates of the interval
+    #                          between minor grid lines.
+    # @param x_org   [Numeric] The world coordinates of the origin (point of
+    #                          intersection) of the grid.
+    # @param y_org   [Numeric] The world coordinates of the origin (point of
+    #                          intersection) of the grid.
+    # @param z_org   [Numeric] The world coordinates of the origin (point of
+    #                          intersection) of the grid.
+    # @param major_x [Integer] Unitless integer values specifying the number
+    #                          of minor grid lines between major grid lines.
+    #                          Values of 0 or 1 imply no grid lines.
+    # @param major_y [Integer] Unitless integer values specifying the number
+    #                          of minor grid lines between major grid lines.
+    #                          Values of 0 or 1 imply no grid lines.
+    # @param major_z [Integer] Unitless integer values specifying the number of
+    #                          minor grid lines between major grid lines.
+    #                          Values of 0 or 1 imply no grid lines.
+    #
+    # @!method grid3d
 
     # Draw a standard vertical error bar graph.
-    # @param x [Array, NArray] A list of length N containing the X coordinates
-    # @param y [Array, NArray] A list of length N containing the Y coordinates
+    #
+    # @param x  [Array, NArray] A list of length N containing the X coordinates
+    # @param y  [Array, NArray] A list of length N containing the Y coordinates
     # @param e1 [Array, NArray] The absolute values of the lower error bar data
     # @param e2 [Array, NArray] The absolute values of the lower error bar data
+    #
     def verrorbars(x, y, e1, e2)
       n = equal_length(x, y, e1, e2)
       super(n, x, y, e1, e2)
     end
 
     # Draw a standard horizontal error bar graph.
+    #
     # @param x [Array, NArray] A list of length N containing the X coordinates
     # @param y [Array, NArray] A list of length N containing the Y coordinates
     # @param e1 [Array, NArray] The absolute values of the lower error bar data
     # @param e2 [Array, NArray] The absolute values of the lower error bar data
+    #
     def herrorbars(x, y, e1, e2)
       n = equal_length(x, y, e1, e2)
       super(n, x, y, e1, e2)
@@ -1049,24 +1213,30 @@ module GR
 
     # Draw a 3D curve using the current line attributes,
     # starting from the first data point and ending at the last data point.
-    # @param x [Array, NArray] A list of length N containing the X coordinates
-    # @param y [Array, NArray] A list of length N containing the Y coordinates
-    # @param z [Array, NArray] A list of length N containing the Z coordinates
+    #
     # The values for `x`, `y` and `z` are in world coordinates. The attributes that
     # control the appearance of a polyline are linetype, linewidth and color
     # index.
+    #
+    # @param x [Array, NArray] A list of length N containing the X coordinates
+    # @param y [Array, NArray] A list of length N containing the Y coordinates
+    # @param z [Array, NArray] A list of length N containing the Z coordinates
+    #
     def polyline3d(x, y, z)
       n = equal_length(x, y, z)
       super(n, x, y, z)
     end
 
     # Draw marker symbols centered at the given 3D data points.
-    # @param x [Array, NArray] A list of length N containing the X coordinates
-    # @param y [Array, NArray] A list of length N containing the Y coordinates
-    # @param z [Array, NArray] A list of length N containing the Z coordinates
+    #
     # The values for `x`, `y` and `z` are in world coordinates. The attributes
     # that control the appearance of a polymarker are marker type, marker size
     # scale factor and color index.
+    #
+    # @param x [Array, NArray] A list of length N containing the X coordinates
+    # @param y [Array, NArray] A list of length N containing the Y coordinates
+    # @param z [Array, NArray] A list of length N containing the Z coordinates
+    #
     def polymarker3d(x, y, z)
       n = equal_length(x, y, z)
       super(n, x, y, z)
@@ -1074,12 +1244,24 @@ module GR
 
     # Draw X, Y and Z coordinate axes with linearly and/or logarithmically
     # spaced tick marks.
+    #
+    # Tick marks are positioned along each axis so that major tick marks fall on
+    # the axes origin (whether visible or not). Major tick marks are labeled with
+    # the corresponding data values. Axes are drawn according to the scale of the
+    # window. Axes and tick marks are drawn using solid lines; line color and
+    # width can be modified using the `setlinetype` and `setlinewidth` functions.
+    # Axes are drawn according to the linear or logarithmic transformation
+    # established by the `setscale` function.
+    #
     # @param x_tick [Numeric] The interval between minor tick marks on the X axis.
     # @param y_tick [Numeric] The interval between minor tick marks on the Y axis.
     # @param z_tick [Numeric] The interval between minor tick marks on the Z axis.
-    # @param x_org [Numeric] The world coordinates of the origin (point of intersection) of the X axes.
-    # @param y_org [Numeric] The world coordinates of the origin (point of intersection) of the Y axes.
-    # @param z_org [Numeric] The world coordinates of the origin (point of intersection) of the Z axes.
+    # @param x_org  [Numeric]
+    #   The world coordinates of the origin (point of intersection) of the X axes.
+    # @param y_org  [Numeric]
+    #   The world coordinates of the origin (point of intersection) of the Y axes.
+    # @param z_org  [Numeric]
+    #   The world coordinates of the origin (point of intersection) of the Z axes.
     # @param major_x [Integer]
     #   Unitless integer values specifying the number of minor tick intervals
     #   between major tick marks. Values of 0 or 1 imply no minor ticks.
@@ -1097,48 +1279,41 @@ module GR
     #   coordinate unit. Major tick marks are twice as long as minor tick marks.
     #   A negative value reverses the tick marks on the axes from inward facing
     #   to outward facing (or vice versa).
-    # Tick marks are positioned along each axis so that major tick marks fall on the axes
-    # origin (whether visible or not). Major tick marks are labeled with the corresponding
-    # data values. Axes are drawn according to the scale of the window. Axes and tick marks
-    # are drawn using solid lines; line color and width can be modified using the
-    # `setlinetype` and `setlinewidth` functions. Axes are drawn according to
-    # the linear or logarithmic transformation established by the `setscale` function.
-    def axes3d(*)
-      super
-    end
+    #
+    # @!method axes3d
 
     # Display axis titles just outside of their respective axes.
+    #
     # @param x_title [String] The text to be displayed on the X axis
     # @param x_title [String] The text to be displayed on the Y axis
     # @param x_title [String] The text to be displayed on the Z axis
-    def titles3d(*)
-      super
-    end
+    #
+    # @!method titles3d
 
     # Draw a three-dimensional surface plot for the given data points.
+    #
+    # `x` and `y` define a grid. `z` is a singly dimensioned array containing at
+    # least `nx` * `ny` data points. Z describes the surface height at each point
+    # on the grid. Data is ordered as shown in the table:
+    #
+    # @note `surface` is overwritten by `require gr/plot`.
+    #       The original method is moved to the underscored name.
+    #       The yard document will show the method name after evacuation.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
     # @param z [Array, NArray]
     #   A list of length `len(x)` * `len(y)` or an appropriately dimensioned
     #   array containing the Z coordinates
     # @param option [Integer] Surface display option
-    #  * 0 LINES
-    #    * Use X Y polylines to denote the surface
-    #  * 1 MESH
-    #    * Use a wire grid to denote the surface
-    #  * 2 FILLED_MESH
-    #    * Applies an opaque grid to the surface
-    #  * 3 Z_SHADED_MESH
-    #    * Applies Z-value shading to the surface
-    #  * 4 COLORED_MESH
-    #    * Applies a colored grid to the surface
-    #  * 5 CELL_ARRAY
-    #    * Applies a grid of individually-colored cells to the surface
-    #  * 6 SHADED_MESH
-    #    * Applies light source shading to the 3-D surface
-    # `x` and `y` define a grid. `z` is a singly dimensioned array containing at least
-    # `nx` * `ny` data points. Z describes the surface height at each point on the grid.
-    # Data is ordered as shown in the table:
+    #  * 0 LINES         - Use X Y polylines to denote the surface
+    #  * 1 MESH          - Use a wire grid to denote the surface
+    #  * 2 FILLED_MESH   - Applies an opaque grid to the surface
+    #  * 3 Z_SHADED_MESH - Applies Z-value shading to the surface
+    #  * 4 COLORED_MESH  - Applies a colored grid to the surface
+    #  * 5 CELL_ARRAY    - Applies a grid of individually-colored cells to the surface
+    #  * 6 SHADED_MESH   - Applies light source shading to the 3-D surface
+    #
     def surface(x, y, z, option)
       # TODO: check: Arrays have incorrect length or dimension.
       nx = x.length
@@ -1146,12 +1321,17 @@ module GR
       super(nx, ny, x, y, z, option)
     end
 
-    # Draw contours of a three-dimensional data set
-    # whose values are specified over a rectangular mesh.
-    # Contour lines may optionally be labeled.
+    # Draw contours of a three-dimensional data set whose values are specified
+    # over a rectangular mesh. Contour lines may optionally be labeled.
+    #
+    # @note `contour` is overwritten by `require gr/plot`.
+    #       The original method is moved to the underscored name.
+    #       The yard document will show the method name after evacuation.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
-    # @param h [Array, NArray] A list containing the Z coordinate for the height values
+    # @param h [Array, NArray]
+    #   A list containing the Z coordinate for the height values
     # @param z [Array, NArray]
     #   A list containing the Z coordinate for the height values
     #   A list of length `len(x)` * `len(y)` or an appropriately dimensioned
@@ -1161,6 +1341,7 @@ module GR
     #   every third line. A value of 1 will label every line. A value of 0
     #   produces no labels. To produce colored contour lines, add an offset
     #   of 1000 to `major_h`.
+    #
     def contour(x, y, h, z, major_h)
       # TODO: check: Arrays have incorrect length or dimension.
       nx = x.length
@@ -1169,8 +1350,13 @@ module GR
       super(nx, ny, nh, x, y, h, z, major_h)
     end
 
-    # Draw filled contours of a three-dimensional data set
-    # whose values are specified over a rectangular mesh.
+    # Draw filled contours of a three-dimensional data set whose values are
+    # specified over a rectangular mesh.
+    #
+    # @note `contourf` is overwritten by `require gr/plot`.
+    #       The original method is moved to the underscored name.
+    #       The yard document will show the method name after evacuation.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
     # @param h [Array, NArray]
@@ -1180,6 +1366,7 @@ module GR
     # @param z [Array, NArray]
     #   A list of length `len(x)` * `len(y)` or an appropriately dimensioned
     #   array containing the Z coordinates
+    #
     def contourf(x, y, h, z, major_h)
       # TODO: check: Arrays have incorrect length or dimension.
       nx = x.length
@@ -1189,28 +1376,59 @@ module GR
     end
 
     # Draw a contour plot for the given triangle mesh.
+    #
+    # @param x      [Array, NArray] A list containing the X coordinates
+    # @param y      [Array, NArray] A list containing the Y coordinates
+    # @param z      [Array, NArray] A list containing the Z coordinates
+    # @param levels [Array, NArray] A list of contour levels
+    #
     def tricontour(x, y, z, levels)
       npoints = x.length # equal_length ?
       nlevels = levels.length
       super(npoints, x, y, z, nlevels, levels)
     end
 
+    # @note `hexbin` is overwritten by `require gr/plot`.
+    #       The original method is moved to the underscored name.
+    #       The yard document will show the method name after evacuation.
+    #
     # @return [Integer]
     def hexbin(x, y, nbins)
       n = x.length
       super(n, x, y, nbins)
     end
 
-    def setcolormap(*)
-      super
-    end
+    # Set the currently used colormap.
+    #
+    # * A list of colormaps can be found at: https://gr-framework.org/colormaps.html
+    # Using a negative index will use the reverse of the selected colormap.
+    #
+    # @param index [Integer] Colormap index
+    #
+    # @!method setcolormap
 
     # inqcolormap
     def inqcolormap
       inquiry_int { |pt| super(pt) }
     end
 
-    # TODO: GR.jl python-gr different API
+    # Define a colormap by a list of RGB colors.
+    # @note GR.jl and python-gr have different APIsI
+    #
+    # This function defines a colormap using the n given color intensities.
+    # If less than 256 colors are provided the colors intensities are linear
+    # interpolated. If x is NULL the given color values are evenly distributed
+    # in the colormap. Otherwise the normalized value of x defines the position
+    # of the color in the colormap.
+    #
+    # @param r [Array, NArray] The red intensities in range 0.0 to 1.0
+    # @param g [Array, NArray] The green intensities in range 0.0 to 1.0
+    # @param b [Array, NArray] The blue intensities in range 0.0 to 1.0
+    # @param positions [Array, NArray]
+    #   The positions of the corresponding color in the resulting colormap or nil.
+    #   The values of positions must increase monotonically from 0.0 to 1.0.
+    #   If positions is nil the given colors are evenly distributed in the colormap.
+    #
     def setcolormapfromrgb(r, g, b, positions: nil)
       n = equal_length(r, g, b)
       if positions.nil?
@@ -1221,10 +1439,18 @@ module GR
       super(n, r, g, b, positions)
     end
 
-    def colorbar(*)
-      super
+    # Inquire the color index range of the current colormap.
+    #
+    # @return [Array] first_color_ind The color index of the first color,
+    #                 last_color_ind The color index of the last color
+    def inqcolormapinds
+      inquiry %i[int int] do |first_color_ind, last_color_ind|
+        super(first_color_ind, last_color_ind)
+      end
     end
 
+    # @!method colorbar
+
     def inqcolor(color)
       inquiry_int do |rgb|
         super(color, rgb)
@@ -1232,9 +1458,7 @@ module GR
     end
 
     # @return [Integer]
-    def inqcolorfromrgb(*)
-      super
-    end
+    # @!method inqcolorfromrgb
 
     def hsvtorgb(h, s, v)
       inquiry %i[double double double] do |r, g, b|
@@ -1243,14 +1467,10 @@ module GR
     end
 
     # @return [Numeric]
-    def tick(*)
-      super
-    end
+    # @!method tick
 
     # @return [Integer]
-    def validaterange(*)
-      super
-    end
+    # @!method validaterange
 
     def adjustlimits(amin, amax)
       inquiry %i[double double] do |pamin, pamax|
@@ -1269,24 +1489,36 @@ module GR
     end
 
     # Open and activate a print device.
+    #
+    # `beginprint` opens an additional graphics output device. The device type is obtained
+    # from the given file extension
+    #
     # @param pathname [String] Filename for the print device.
     #  The following file types are supported:
-    #  * .ps, .eps : PostScript
-    #  * .pdf : Portable Document Format
-    #  * .bmp : Windows Bitmap (BMP)
+    #  * .ps, .eps   : PostScript
+    #  * .pdf        : Portable Document Format
+    #  * .bmp        : Windows Bitmap (BMP)
     #  * .jpeg, .jpg : JPEG image file
-    #  * .png : Portable Network Graphics file (PNG)
+    #  * .png        : Portable Network Graphics file (PNG)
     #  * .tiff, .tif : Tagged Image File Format (TIFF)
-    #  * .fig : Xfig vector graphics file
-    #  * .svg : Scalable Vector Graphics
-    #  * .wmf : Windows Metafile
-    # `beginprint` opens an additional graphics output device. The device type is obtained
-    # from the given file extension.
-    def beginprint(*)
-      super
+    #  * .svg        : Scalable Vector Graphics
+    #  * .wmf        : Windows Metafile
+    #  * .mp4        : MPEG-4 video file
+    #  * .webm 	     : WebM video file
+    #  * .ogg 	     : Ogg video file
+    #
+    # @note Ruby feature - you can use block to call endprint automatically.
+
+    def beginprint(file_path)
+      super(file_path)
+      if block_given?
+        yield
+        endprint
+      end
     end
 
     # Open and activate a print device with the given layout attributes.
+    #
     # @param pathname [String] Filename for the print device.
     # @param mode [String] Output mode (Color, GrayScale)
     # @param fmt [String] Output format
@@ -1322,13 +1554,10 @@ module GR
     #  * Ledger : 0.432 x 0.279
     #  * Tabloid : 0.279 x 0.432
     # @param orientation [String] Page orientation (Landscape, Portait)
-    def beginprintext(*)
-      super
-    end
+    #
+    # @!method beginprintext
 
-    def endprint(*)
-      super
-    end
+    # @!method endprint
 
     def ndctowc(x, y)
       inquiry %i[double double] do |px, py|
@@ -1356,67 +1585,74 @@ module GR
     end
 
     # Draw a rectangle using the current line attributes.
+    #
     # @param xmin [Numeric] Lower left edge of the rectangle
     # @param xmax [Numeric] Lower right edge of the rectangle
     # @param ymin [Numeric] Upper left edge of the rectangle
     # @param ymax [Numeric] Upper right edge of the rectangle
-    def drawrect(*)
-      super
-    end
+    #
+    # @!method drawrect
 
     # Draw a filled rectangle using the current fill attributes.
+    #
     # @param xmin [Numeric] Lower left edge of the rectangle
     # @param xmax [Numeric] Lower right edge of the rectangle
     # @param ymin [Numeric] Upper left edge of the rectangle
     # @param ymax [Numeric] Upper right edge of the rectangle
-    def fillrect(*)
-      super
-    end
+    #
+    # @!method fillrect
 
     # Draw a circular or elliptical arc covering the specified rectangle.
+    #
+    # The resulting arc begins at `a1` and ends at `a2` degrees. Angles are
+    # interpreted such that 0 degrees is at the 3 o'clock position. The center
+    # of the arc is the center of the given rectangle.
+    #
     # @param xmin [Numeric] Lower left edge of the rectangle
     # @param xmax [Numeric] Lower right edge of the rectangle
     # @param ymin [Numeric] Upper left edge of the rectangle
     # @param ymax [Numeric] Upper right edge of the rectangle
-    # @param a1 [Numeric] The start angle
-    # @param a2 [Numeric] The end angle
-    # The resulting arc begins at `a1` and ends at `a2` degrees. Angles are interpreted
-    # such that 0 degrees is at the 3 o'clock position. The center of the arc is the center
-    # of the given rectangle.
-    def drawarc(*)
-      super
-    end
+    # @param a1   [Numeric] The start angle
+    # @param a2   [Numeric] The end angle
+    #
+    # @!method drawarc
 
     # Fill a circular or elliptical arc covering the specified rectangle.
+    #
+    # The resulting arc begins at `a1` and ends at `a2` degrees. Angles are
+    # interpreted such that 0 degrees is at the 3 o'clock position. The center
+    # of the arc is the center of the given rectangle.
+    #
     # @param xmin [Numeric] Lower left edge of the rectangle
     # @param xmax [Numeric] Lower right edge of the rectangle
     # @param ymin [Numeric] Upper left edge of the rectangle
     # @param ymax [Numeric] Upper right edge of the rectangle
     # @param a1 [Numeric] The start angle
     # @param a2 [Numeric] The end angle
-    # The resulting arc begins at `a1` and ends at `a2` degrees. Angles are interpreted
-    # such that 0 degrees is at the 3 o'clock position. The center of the arc is the center
-    # of the given rectangle.
-    def fillarc(*)
-      super
-    end
+    #
+    # @!method fillarc
 
-    # Draw simple and compound outlines consisting of line segments and bezier curves.
+    # Draw simple and compound outlines consisting of line segments and bezier
+    # curves.
+    #
     # @param points [Array, NArray] (N, 2) array of (x, y) vertices
-    # @parm codes [Array, NArray] N-length array of path codes
-    #  *  STOP : end the entire path
-    #  *  MOVETO : move to the given vertex
-    #  *  LINETO : draw a line from the current position to the given vertex
-    #  *  CURVE3 : draw a quadratic Bézier curve
-    #  *  CURVE4 : draw a cubic Bézier curve
+    # @param codes [Array, NArray] N-length array of path codes
+    #  *  STOP      : end the entire path
+    #  *  MOVETO    : move to the given vertex
+    #  *  LINETO    : draw a line from the current position to the given vertex
+    #  *  CURVE3    : draw a quadratic Bézier curve
+    #  *  CURVE4    : draw a cubic Bézier curve
     #  *  CLOSEPOLY : draw a line segment to the start point of the current path
-    # @parm fill [Integer] A flag indication whether resulting path is to be filled or not
+    # @param fill [Integer]
+    #   A flag indication whether resulting path is to be filled or not
+    #
     def drawpath(points, codes, fill)
       len = codes.length
       super(len, points, uint8(codes), fill)
     end
 
     # Set the arrow style to be used for subsequent arrow commands.
+    #
     # @param style [Integer] The arrow style to be used
     #  The default arrow style is 1.
     #  * 1  : simple, single-ended
@@ -1438,29 +1674,30 @@ module GR
     #  * 17 : double line, single-ended
     #  * 18 : double line, double-ended
     # `setarrowstyle` defines the arrow style for subsequent arrow primitives.
-    def setarrowstyle(*)
-      super
-    end
+    #
+    # @!method setarrowstyle
 
     # Set the arrow size to be used for subsequent arrow commands.
-    # @param size [Numeric] The arrow size to be used
+    #
     # `setarrowsize` defines the arrow size for subsequent arrow primitives.
     # The default arrow size is 1.
-    def setarrowsize(*)
-      super
-    end
+    #
+    # @param size [Numeric] The arrow size to be used
+    #
+    # @!method setarrowsize
 
     # Draw an arrow between two points.
+    #
+    # Different arrow styles (angles between arrow tail and wing, optionally
+    # filled heads, double headed arrows) are available and can be set with the
+    # `setarrowstyle` function.
+    #
     # @param x1 [Numeric] Starting point of the arrow (tail)
     # @param y1 [Numeric] Starting point of the arrow (tail)
     # @param x2 [Numeric] Head of the arrow
     # @param y2 [Numeric] Head of the arrow
-    # Different arrow styles (angles between arrow tail and wing, optionally filled
-    # heads, double headed arrows) are available and can be set with the `setarrowstyle`
-    # function.
-    def drawarrow(*)
-      super
-    end
+    #
+    # @!method drawarrow
 
     # @return [Integer]
     def readimage(path)
@@ -1476,35 +1713,35 @@ module GR
     end
 
     # Draw an image into a given rectangular area.
-    # @param xmin [Numeric] First corner point of the rectangle
-    # @param ymin [Numeric] First corner point of the rectangle
-    # @param xmax [Numeric] Second corner point of the rectangle
-    # @param ymax [Numeric] Second corner point of the rectangle
-    # @param width [Integer] The width and the height of the image
+    #
+    # The points (`xmin`, `ymin`) and (`xmax`, `ymax`) are world coordinates
+    # defining diagonally opposite corner points of a rectangle. This rectangle
+    # is divided into `width` by `height` cells. The two-dimensional array `data`
+    # specifies colors for each cell.
+    #
+    # @param xmin   [Numeric] First corner point of the rectangle
+    # @param ymin   [Numeric] First corner point of the rectangle
+    # @param xmax   [Numeric] Second corner point of the rectangle
+    # @param ymax   [Numeric] Second corner point of the rectangle
+    # @param width  [Integer] The width and the height of the image
     # @param height [Integer] The width and the height of the image
-    # @param data [Array, NArray] An array of color values dimensioned `width` by `height`
-    # @param model [Integer] Color model ( default = 0 )
+    # @param data   [Array, NArray] An array of color values dimensioned `width` by `height`
+    # @param model  [Integer] Color model ( default = 0 )
     #  The available color models are:
-    #  * 0 : MODEL_RGB
-    #    *   AABBGGRR
-    #  * 1 : MODEL_HSV
-    #    *   AAVVSSHH
-    # The points (`xmin`, `ymin`) and (`xmax`, `ymax`) are world coordinates defining
-    # diagonally opposite corner points of a rectangle. This rectangle is divided into
-    # `width` by `height` cells. The two-dimensional array `data` specifies colors
-    # for each cell.
+    #  * 0 : MODEL_RGB - AABBGGRR
+    #  * 1 : MODEL_HSV - AAVVSSHH
+    #
     def drawimage(xmin, xmax, ymin, ymax, width, height, data, model = 0)
       super(xmin, xmax, ymin, ymax, width, height, uint(data), model)
     end
 
     # @return [Integer]
-    def importgraphics(*)
-      super
-    end
+    # @!method importgraphics
 
-    # `setshadow` allows drawing of shadows, realized by images painted underneath,
-    # and offset from, graphics objects such that the shadow mimics the effect of a light
-    # source cast on the graphics objects.
+    # `setshadow` allows drawing of shadows, realized by images painted
+    # underneath, and offset from, graphics objects such that the shadow mimics
+    # the effect of a light source cast on the graphics objects.
+    #
     # @param offsetx [Numeric]
     #   An x-offset, which specifies how far in the horizontal direction the
     #   shadow is offset from the object
@@ -1513,18 +1750,19 @@ module GR
     #   is offset from the object
     # @param blur [Numeric]
     #   A blur value, which specifies whether the object has a hard or a diffuse edge
-    def setshadow(*)
-      super
-    end
+    #
+    # @!method setshadow
 
     # Set the value of the alpha component associated with GR colors.
+    #
     # @param alpha [Numeric] An alpha value (0.0 - 1.0)
-    def settransparency(*)
-      super
-    end
+    #
+    # @!method settransparency
 
     # Change the coordinate transformation according to the given matrix.
+    #
     # @param mat [Array, NArray] 2D transformation matrix
+    #
     def setcoordxform(mat)
       raise if mat.size != 6
 
@@ -1532,17 +1770,15 @@ module GR
     end
 
     # Open a file for graphics output.
+    #
     # @param path [String] Filename for the graphics file.
-    # `begingraphics` allows to write all graphics output into a XML-formatted file until
-    # the `endgraphics` functions is called. The resulting file may later be imported with
-    # the `importgraphics` function.
-    def begingraphics(*)
-      super
-    end
+    # `begingraphics` allows to write all graphics output into a XML-formatted
+    # file until the `endgraphics` functions is called. The resulting file may
+    # later be imported with the `importgraphics` function.
+    #
+    # @!method begingraphics
 
-    def endgraphics(*)
-      super
-    end
+    # @!method endgraphics
 
     # @return [String]
     def getgraphics(*)
@@ -1550,18 +1786,16 @@ module GR
     end
 
     # @return [Integer]
-    def drawgraphics(*)
-      super
-    end
+    # @!method drawgraphics
 
-    # Generate a character string starting at the given location. Strings can be defined
-    # to create mathematical symbols and Greek letters using LaTeX syntax.
-    # @param x [Numeric] Position of the text string specified in world coordinates
-    # @param y [Numeric] Position of the text string specified in world coordinates
+    # Generate a character string starting at the given location. Strings can be
+    # defined to create mathematical symbols and Greek letters using LaTeX syntax.
+    #
+    # @param x [Numeric] X coordinate of the starting position of the text string
+    # @param y [Numeric] Y coordinate of the starting position of the text string
     # @param string [String] The text string to be drawn
-    def mathtex(*)
-      super
-    end
+    #
+    # @!method mathtex
 
     # inqmathtex
     def inqmathtex(x, y, string)
@@ -1570,21 +1804,13 @@ module GR
       end
     end
 
-    def beginselection(*)
-      super
-    end
+    # @!method beginselection
 
-    def endselection(*)
-      super
-    end
+    # @!method endselection
 
-    def moveselection(*)
-      super
-    end
+    # @!method moveselection
 
-    def resizeselection(*)
-      super
-    end
+    # @!method resizeselection
 
     def inqbbox
       inquiry %i[double double double double] do |*pts|
@@ -1593,39 +1819,23 @@ module GR
     end
 
     # @return [Numeric]
-    def precision(*)
-      super
-    end
+    # @!method precision
 
-    def setregenflags(*)
-      super
-    end
+    # @!method setregenflags
 
     # @return [Integer]
-    def inqregenflags(*)
-      super
-    end
+    # @!method inqregenflags
 
-    def savestate(*)
-      super
-    end
+    # @!method savestate
 
-    def restorestate(*)
-      super
-    end
+    # @!method restorestate
 
-    def selectcontext(*)
-      super
-    end
+    # @!method selectcontext
 
-    def destroycontext(*)
-      super
-    end
+    # @!method destroycontext
 
     # @return [Integer]
-    def uselinespec(*)
-      super
-    end
+    # @!method uselinespec
 
     def delaunay(x, y)
       # Feel free to make a pull request if you catch a mistake
@@ -1648,6 +1858,11 @@ module GR
     end
 
     # Reduces the number of points of the x and y array.
+    #
+    # @param n [Integer] The requested number of points
+    # @param x [Array, NArray] The x value array
+    # @param y [Array, NArray] The y value array
+    #
     def reducepoints(xd, yd, n)
       nd = equal_length(xd, yd)
       inquiry [{ double: n }, { double: n }] do |x, y|
@@ -1657,9 +1872,11 @@ module GR
     end
 
     # Draw a triangular surface plot for the given data points.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
     # @param z [Array, NArray] A list containing the Z coordinates
+    #
     def trisurface(x, y, z)
       n = [x, y, z].map(&:length).min
       super(n, x, y, z)
@@ -1676,6 +1893,7 @@ module GR
     end
 
     # Draw a quiver plot on a grid of nx*ny points.
+    #
     # @param nx [Integer] The number of points along the x-axis of the grid
     # @param ny [Integer] The number of points along the y-axis of the grid
     # @param x [Array, NArray] A list containing the X coordinates
@@ -1685,7 +1903,9 @@ module GR
     # @param color [Integer]
     #   A bool to indicate whether or not the arrows should be colored using
     #   the current colormap
+    #
     # The values for `x` and `y` are in world coordinates.
+    #
     def quiver(x, y, u, v, color)
       # TODO: check: Arrays have incorrect length or dimension.
       nx = x.length
@@ -1697,23 +1917,22 @@ module GR
     # input points are located on a grid, described by `x`, `y` and `z`.
     # The target grid ist described by `xq` and `yq`.
     # Returns an array containing the resulting z-values.
-    # @param x [Array, NArray] Array containing the input grid's x-values
-    # @param y [Array, NArray] Array containing the input grid's y-values
-    # @param z [Array, NArray] Array containing the input grid's z-values (number of values: nx * ny)
+    #
+    # @param x  [Array, NArray] Array containing the input grid's x-values
+    # @param y  [Array, NArray] Array containing the input grid's y-values
+    # @param z  [Array, NArray] Array containing the input grid's z-values (number of values: nx * ny)
     # @param xq [Array, NArray] Array containing the target grid's x-values
     # @param yq [Array, NArray] Array containing the target grid's y-values
     # @param method [Integer] Used method for interpolation
     #  The available methods for interpolation are the following:
-    #  * 0 : INTERP2_NEAREST
-    #    *   Nearest neighbour interpolation
-    #  * 1 : INTERP2_LINEAR
-    #    *   Linear interpolation
-    #  * 2 : INTERP_2_SPLINE
-    #    *   Interpolation using natural cubic splines
-    #  * 3 : INTERP2_CUBIC
-    #    *   Cubic interpolation
+    #  * 0 : INTERP2_NEAREST - Nearest neighbour interpolation
+    #  * 1 : INTERP2_LINEAR  - Linear interpolation
+    #  * 2 : INTERP_2_SPLINE - Interpolation using natural cubic splines
+    #  * 3 : INTERP2_CUBIC   - Cubic interpolation
     # @param extrapval [Numeric] The extrapolation value
-    def interp2(x, y, z, xq, yq, method, extrapval) # flatten
+    #
+    # flatten
+    def interp2(x, y, z, xq, yq, method, extrapval)
       nx = x.length
       ny = y.length
       # nz = z.length
@@ -1725,34 +1944,34 @@ module GR
     end
 
     # Returns the combined version strings of the GR runtime.
+    #
     # @return [String]
     def version
       super.to_s
     end
 
-    def shade(*)
-      super
-    end
+    # @note `hexbin` is overwritten by `require gr/plot`.
+    #       The original method is moved to the underscored name.
+    #       The yard document will show the method name after evacuation.
+    #
+    # @!method shade
 
     # Display a point set as a aggregated and rasterized image.
-    # @param x [Array, NArray] A pointer to the X coordinates
-    # @param y [Array, NArray] A pointer to the Y coordinates
-    # @param dims [Array, NArray] The size of the grid used for rasterization
-    # @param xform [Integer] The transformation type used for color mapping
-    #  The available transformation types are:
-    #  * 0 : XFORM_BOOLEAN
-    #    *   boolean
-    #  * 1 : XFORM_LINEAR
-    #    *   linear
-    #  * 2 : XFORM_LOG
-    #    *   logarithmic
-    #  * 3 : XFORM_LOGLOG
-    #    *   double logarithmic
-    #  * 4 : XFORM_CUBIC
-    #    *   cubic
-    #  * 5 : XFORM_EQUALIZED
-    #    *   histogram equalized
+    #
     # The values for `x` and `y` are in world coordinates.
+    #
+    # @param x     [Array, NArray] A pointer to the X coordinates
+    # @param y     [Array, NArray] A pointer to the Y coordinates
+    # @param dims  [Array, NArray] The size of the grid used for rasterization
+    # @param xform [Integer]       The transformation type used for color mapping
+    #  The available transformation types are:
+    #  * 0 : XFORM_BOOLEAN   - boolean
+    #  * 1 : XFORM_LINEAR    - linear
+    #  * 2 : XFORM_LOG       - logarithmic
+    #  * 3 : XFORM_LOGLOG    - double logarithmic
+    #  * 4 : XFORM_CUBIC     - cubic
+    #  * 5 : XFORM_EQUALIZED - histogram equalized
+    #
     def shadepoints(x, y, dims: [1200, 1200], xform: 1)
       n = x.length
       w, h = dims
@@ -1760,31 +1979,34 @@ module GR
     end
 
     # Display a line set as an aggregated and rasterized image.
-    # @param x [Array, NArray] A pointer to the X coordinates
-    # @param y [Array, NArray] A pointer to the Y coordinates
-    # @param dims [Array, NArray] The size of the grid used for rasterization
-    # @param xform [Integer] The transformation type used for color mapping
-    #  The available transformation types are:
-    #  * 0 : XFORM_BOOLEAN
-    #    *   boolean
-    #  * 1 : XFORM_LINEAR
-    #    *   linear
-    #  * 2 : XFORM_LOG
-    #    *   logarithmic
-    #  * 3 : XFORM_LOGLOG
-    #    *   double logarithmic
-    #  * 4 : XFORM_CUBIC
-    #    *   cubic
-    #  * 5 : XFORM_EQUALIZED
-    #    *   histogram equalized
+    #
     # The values for `x` and `y` are in world coordinates.
     # NaN values can be used to separate the point set into line segments.
+    #
+    # @param x     [Array, NArray] A pointer to the X coordinates
+    # @param y     [Array, NArray] A pointer to the Y coordinates
+    # @param dims  [Array, NArray] The size of the grid used for rasterization
+    # @param xform [Integer] The transformation type used for color mapping
+    #  The available transformation types are:
+    #  * 0 : XFORM_BOOLEAN   - boolean
+    #  * 1 : XFORM_LINEAR    - linear
+    #  * 2 : XFORM_LOG       - logarithmic
+    #  * 3 : XFORM_LOGLOG    - double logarithmic
+    #  * 4 : XFORM_CUBIC     - cubic
+    #  * 5 : XFORM_EQUALIZED - histogram equalized
+    #
     def shadelines(x, y, dims: [1200, 1200], xform: 1)
       n = x.length
       w, h = dims
       super(n, x, y, xform, w, h)
     end
 
+    # @note This method uses GRCommons::Fiddley::Function as a callback function.
+    #       Please read the source code If you have to use it.
+    #       This method is not sure if it works properly.
+    #
+    # @!method findboundary
+
     # panzoom
     def panzoom(x, y, zoom)
       inquiry %i[double double double double] do |xmin, xmax, ymin, ymax|
@@ -1792,7 +2014,8 @@ module GR
       end
     end
 
-    # Set the resample method used for gr.drawimage().
+    # Set the resample method used for `drawimage`.
+    #
     # @param resample_method [Integer] the new resample method.
     #  The available options are:
     #  * 0x00000000 : RESAMPLE_DEFAULT
@@ -1803,7 +2026,8 @@ module GR
     #    *            linear
     #  * 0x03030303 : RESAMPLE_LANCZOS
     #    *            Lanczos
-    #  Alternatively, combinations of these methods can be selected for horizontal or vertical upsampling or downsampling:
+    #  Alternatively, combinations of these methods can be selected for
+    #  horizontal or vertical upsampling or downsampling:
     #  * 0x00000000 : UPSAMPLE_VERTICAL_DEFAULT
     #    *            default for vertical upsampling
     #  * 0x00000000 : UPSAMPLE_HORIZONTAL_DEFAULT
@@ -1836,11 +2060,12 @@ module GR
     #    *            lanczos for vertical downsampling
     #  * 0x03000000 : DOWNSAMPLE_HORIZONTAL_LANCZOS
     #    *            lanczos for horizontal downsampling
-    def setresamplemethod(*)
-      super
-    end
+    #
+    # @!method setresamplemethod
 
-    # Inquire the resample method used for gr.drawimage().
+    # Inquire the resample method used for `drawimage`
+    #
+    # @return [Integer] Resample flag
     def inqresamplemethod
       inquiry_uint do |resample_method|
         super(resample_method)
@@ -1848,6 +2073,7 @@ module GR
     end
 
     # Draw paths using the given vertices and path codes.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
     # @param codes [String] A list containing the path codes
@@ -1872,128 +2098,151 @@ module GR
     #    * close path and fill         -
     #  * F
     #    * close path, fill and stroke -
+    #
     # See https://gr-framework.org/python-gr.html#gr.path for more details.
+    #
     def path(x, y, codes)
       n = equal_length(x, y)
       super(n, x, y, codes)
     end
 
+    # @param z [Array, NArray]
+    # @return [Array, NArray]
+    def to_rgb_color(z)
+      zmin, zmax = z.minmax
+      return Array.new(z.length, 0) if zmax == zmin
+
+      z.map  do |i|
+        zi = (i - zmin) / (zmax - zmin).to_f
+        inqcolor(1000 + (zi * 255).round)
+      end
+    end
+
     # Define the border width of subsequent path output primitives.
+    #
     # @param width [Numeric] The border width scale factor
-    def setborderwidth(*)
-      super
-    end
+    #
+    # @!method setborderwidth
 
     def inqborderwidth
       inquiry_double { |pt| super(pt) }
     end
 
     # Define the color of subsequent path output primitives.
+    #
     # @param color [Integer] The border color index (COLOR < 1256)
-    def setbordercolorind(*)
-      super
-    end
+    #
+    # @!method setbordercolorind
 
     def inqbordercolorind
       inquiry_int { |pt| super(pt) }
     end
 
+    # @!method selectclipxform
+
+    def inqclipxform
+      inquiry_int { |pt| super(pt) }
+    end
+
     # Set the projection type with this flag.
+    #
     # @param flag [Integer] projection type
     #  The available options are:
-    #  * 0 : GR_PROJECTION_DEFAULT
-    #    * default
-    #  * 1 : GR_PROJECTION_ORTHOGRAPHIC
-    #    * orthographic
-    #  * 2 : GR_PROJECTION_PERSPECTIVE
-    #    * perspective
-    def setprojectiontype(*)
-      super
-    end
+    #  * 0 : GR_PROJECTION_DEFAULT      - default
+    #  * 1 : GR_PROJECTION_ORTHOGRAPHIC - orthographic
+    #  * 2 : GR_PROJECTION_PERSPECTIVE  - perspective
+    #
+    # @!method setprojectiontype
 
     # Return the projection type.
     def inqprojectiontype
       inquiry_int { |pt| super(pt) }
     end
 
+    # Set the far and near clipping plane for perspective projection and the
+    # vertical field ov view.
+    # Switches projection type to perspective.
+    #
+    # @param near_plane [Numeric] distance to near clipping plane
+    # @param far_plane  [Numeric] distance to far clipping plane
+    # @param fov        [Numeric] vertical field of view,
+    #                             input must be between 0 and 180 degrees
+    #
+    # @!method setperspectiveprojection
+
+    # Return the parameters for the perspective projection.
+    def inqperspectiveprojection
+      inquiry %i[double double double] do |*pts|
+        super(*pts)
+      end
+    end
+
     # Method to set the camera position, the upward facing direction and the
     # focus point of the shown volume.
-    # @param camera_pos_x [Numeric] x component of the cameraposition in world coordinates
-    # @param camera_pos_y [Numeric] y component of the cameraposition in world coordinates
-    # @param camera_pos_z [Numeric] z component of the cameraposition in world coordinates
-    # @param up_x [Numeric] x component of the up vector
-    # @param up_y [Numeric] y component of the up vector
-    # @param up_z [Numeric] z component of the up vector
+    #
+    # @param camera_pos_x  [Numeric] x component of the cameraposition in world coordinates
+    # @param camera_pos_y  [Numeric] y component of the cameraposition in world coordinates
+    # @param camera_pos_z  [Numeric] z component of the cameraposition in world coordinates
+    # @param up_x          [Numeric] x component of the up vector
+    # @param up_y          [Numeric] y component of the up vector
+    # @param up_z          [Numeric] z component of the up vector
     # @param focus_point_x [Numeric] x component of focus-point inside volume
     # @param focus_point_y [Numeric] y component of focus-point inside volume
     # @param focus_point_z [Numeric] z component of focus-point inside volume
-    def settransformationparameters(*)
-      super
-    end
+    #
+    # @!method settransformationparameters
 
     # Return the camera position, up vector and focus point.
+    #
     def inqtransformationparameters
       inquiry([:double] * 9) do |*pts|
         super(*pts)
       end
     end
 
-    # Set the far and near clipping plane for perspective projection and the
-    # vertical field ov view.
-    # Switches projection type to perspective.
-    # @param near_plane [Numeric] distance to near clipping plane
-    # @param far_plane [Numeric] distance to far clipping plane
-    # @param fov [Numeric] vertical field of view, input must be between 0 and 180 degrees
-    def setperspectiveprojection(*)
-      super
-    end
-
-    # Return the parameters for the perspective projection.
-    def inqperspectiveprojection
-      inquiry %i[double double double] do |*pts|
-        super(*pts)
-      end
-    end
-
     # Set parameters for orthographic transformation.
     # Switches projection type to orthographic.
-    # @param left [Numeric] xmin of the volume in worldcoordinates
-    # @param right [Numeric] xmax of volume in worldcoordinates
-    # @param bottom [Numeric] ymin of volume in worldcoordinates
-    # @param top [Numeric] ymax of volume in worldcoordinates
+    #
+    # @param left       [Numeric] xmin of the volume in worldcoordinates
+    # @param right      [Numeric] xmax of volume in worldcoordinates
+    # @param bottom     [Numeric] ymin of volume in worldcoordinates
+    # @param top        [Numeric] ymax of volume in worldcoordinates
     # @param near_plane [Numeric] distance to near clipping plane
-    # @param far_plane [Numeric] distance to far clipping plane
-    def setorthographicprojection(*)
-      super
-    end
+    # @param far_plane  [Numeric] distance to far clipping plane
+    #
+    # @!method setorthographicprojection
 
     # Return the camera position, up vector and focus point.
+    #
     def inqorthographicprojection
       inquiry([:double] * 6) do |*pts|
         super(*pts)
       end
     end
 
-    # Interface for interaction with the rotation of the model.
-    # For this a virtual Arcball is used.
+    # Rotate the current scene according to a virtual arcball.
+    #
+    # This function requires values between 0 (left side or bottom of the drawing
+    # area) and 1 (right side or top of the drawing area).
+    #
     # @param start_mouse_pos_x [Numeric] x component of the start mouse position
     # @param start_mouse_pos_y [Numeric] y component of the start mouse position
-    # @param end_mouse_pos_x [Numeric] x component of the end mouse position
-    # @param end_mouse_pos_y [Numeric] y component of the end mouse position
-    def camerainteraction(*)
-      super
-    end
+    # @param end_mouse_pos_x   [Numeric] x component of the end mouse position
+    # @param end_mouse_pos_y   [Numeric] y component of the end mouse position
+    #
+    # @!method camerainteraction
 
-    # Set the three dimensional window. Only used for perspective and orthographic projection.
+    # Set the three dimensional window.
+    # Only used for perspective and orthographic projection.
+    #
     # @param xmin [Numeric] min x-value
     # @param xmax [Numeric] max x-value
     # @param ymin [Numeric] min y-value
     # @param ymax [Numeric] max y-value
     # @param zmin [Numeric] min z-value
     # @param zmax [Numeric] max z-value
-    def setwindow3d(*)
-      super
-    end
+    #
+    # @!method setwindow3d
 
     # Return the three dimensional window.
     def inqwindow3d
@@ -2003,15 +2252,16 @@ module GR
     end
 
     # Set the scale factor for each axis. A one means no scale.
-    # All factor have to be != 0.
+    # The scaling factors must not be zero. .
+    #
     # @param x_axis_scale [Numeric] factor for scaling the x-axis
     # @param y_axis_scale [Numeric] factor for scaling the y-axis
     # @param z_axis_scale [Numeric] factor for scaling the z-axis
-    def setscalefactors3d(*)
-      super
-    end
+    #
+    # @!method setscalefactors3d
 
     # Returns the scale factors for each axis.
+    #
     def inqscalefactors3d
       inquiry %i[double double double] do |*opts|
         super(*opts)
@@ -2019,24 +2269,23 @@ module GR
     end
 
     # Set the camera for orthographic or perspective projection.
+    #
     # The center of the 3d window is used as the focus point and the camera is
     # positioned relative to it, using camera distance, rotation and tilt similar
-    # to gr_setspace. This function can be used if the user prefers spherical
+    # to `setspace`. This function can be used if the user prefers spherical
     # coordinates to setting the camera position directly, but has reduced
     # functionality in comparison to GR.settransformationparameters,
     # GR.setperspectiveprojection and GR.setorthographicprojection.
+    #
     # @param phi [Numeric] azimuthal angle of the spherical coordinates
     # @param theta [Numeric] polar angle of the spherical coordinates
     # @param fov [Numeric] vertical field of view (0 or NaN for orthographic projection)
     # @param camera_distance [Numeric] distance between the camera and the focus point
     #   (0 or NaN for the radius of the object's smallest bounding sphere)
-    def setspace3d(*)
-      super
-    end
+    #
+    # @!method setspace3d
 
-    def text3d(*)
-      super
-    end
+    # @!method text3d
 
     def inqtext3d(x, y, z, string, axis)
       inquiry [{ double: 16 }, { double: 16 }] do |tbx, tby|
@@ -2044,15 +2293,27 @@ module GR
       end
     end
 
-    def settextencoding(*)
-      super
-    end
+    # @!method settextencoding
 
     def inqtextencoding
       inquiry_int do |encoding|
         super(encoding)
       end
     end
+
+    # Load a font file from a given filename.
+    #
+    # This function loads a font from a given absolute filename and assigns a
+    # font index to it. To use the loaded font call `gr_settextfontprec` using
+    # the resulting font index and precision 3.
+    #
+    # @param filename [String] The absolute filename of the font
+    #
+    def loadfont(str)
+      inquiry_int do |font|
+        super(str, font)
+      end
+    end
   end
 
   ASF_BUNDLED    = 0
@@ -2261,6 +2522,10 @@ module GR
   PATH_CURVE4    = 0x04
   PATH_CLOSEPOLY = 0x4f
 
+  GDP_DRAW_PATH = 1
+  GDP_DRAW_LINES = 2
+  GDP_DRAW_MARKERS = 3
+
   MPL_SUPPRESS_CLEAR  = 1
   MPL_POSTPONE_UPDATE = 2