raster_context Derived Type

type, public, extends(plot_context) :: raster_context


Components

Type Visibility Attributes Name Initial
integer, public :: width
integer, public :: height
real(kind=wp), public :: x_min
real(kind=wp), public :: x_max
real(kind=wp), public :: y_min
real(kind=wp), public :: y_max
real(kind=wp), public :: view_azim = -1.0471975511965976_wp
real(kind=wp), public :: view_elev = 0.5235987755982988_wp
real(kind=wp), public :: view_dist = 10.0_wp
logical, public :: has_rendered_arrows = .false.
logical, public :: uses_vector_arrows = .false.
logical, public :: has_triangular_arrows = .false.
type(raster_image_t), public :: raster
type(plot_margins_t), public :: margins
type(plot_area_t), public :: plot_area
character(len=16), public :: last_xscale = 'linear'
character(len=16), public :: last_yscale = 'linear'
real(kind=wp), public :: last_symlog_threshold = 1.0_wp

Type-Bound Procedures

procedure, public :: clear_text_background => context_clear_text_background

Draw text as a fixed-position overlay. Raster/vector backends reuse their normal text path; the ASCII backend overrides this to place the glyphs at the exact cell without the auto-shift its buffered text path applies, so stacked legend rows never blend together.

  • private subroutine context_clear_text_background(this, x, y, width)

    Default no-op: backends that composite text over graphics need no explicit background clearing.

    Arguments

    Type IntentOptional Attributes Name
    class(plot_context), intent(inout) :: this
    real(kind=wp), intent(in) :: x
    real(kind=wp), intent(in) :: y
    integer, intent(in) :: width

procedure, public :: draw_text_overlay => context_draw_text_overlay

Select the text-backend charset ('ascii' or 'braille'). Only the text backend carries subpixel dots; raster/vector backends ignore it.

  • private subroutine context_draw_text_overlay(this, x, y, text)

    Default overlay: reuse the backend's normal text path.

    Arguments

    Type IntentOptional Attributes Name
    class(plot_context), intent(inout) :: this
    real(kind=wp), intent(in) :: x
    real(kind=wp), intent(in) :: y
    character(len=*), intent(in) :: text

procedure, public :: set_text_charset => context_set_text_charset

Select the text-backend ANSI color mode. Only the text backend emits escapes; raster/vector backends ignore it (#2062).

  • private subroutine context_set_text_charset(this, charset)

    Default no-op: only the text backend renders subpixel charsets.

    Arguments

    Type IntentOptional Attributes Name
    class(plot_context), intent(inout) :: this
    character(len=*), intent(in) :: charset

procedure, public :: set_text_color_mode => context_set_text_color_mode

  • private subroutine context_set_text_color_mode(this, mode)

    Default no-op: only the text backend emits ANSI color escapes.

    Arguments

    Type IntentOptional Attributes Name
    class(plot_context), intent(inout) :: this
    character(len=*), intent(in) :: mode

procedure, public :: line => raster_draw_line

  • interface

    private module subroutine raster_draw_line(this, x1, y1, x2, y2)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    real(kind=wp), intent(in) :: x1
    real(kind=wp), intent(in) :: y1
    real(kind=wp), intent(in) :: x2
    real(kind=wp), intent(in) :: y2

procedure, public :: color => raster_set_color_context

  • interface

    private module subroutine raster_set_color_context(this, r, g, b)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    real(kind=wp), intent(in) :: r
    real(kind=wp), intent(in) :: g
    real(kind=wp), intent(in) :: b

procedure, public :: text => raster_draw_text

  • interface

    private module subroutine raster_draw_text(this, x, y, text)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    real(kind=wp), intent(in) :: x
    real(kind=wp), intent(in) :: y
    character(len=*), intent(in) :: text

procedure, public :: draw_text_styled => raster_draw_text_styled

  • interface

    private module subroutine raster_draw_text_styled(this, x_px, y_px, text, pixel_height, rotation, ha, va, bbox, color)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    real(kind=wp), intent(in) :: x_px
    real(kind=wp), intent(in) :: y_px
    character(len=*), intent(in) :: text
    real(kind=wp), intent(in) :: pixel_height
    real(kind=wp), intent(in) :: rotation
    character(len=*), intent(in) :: ha
    character(len=*), intent(in) :: va
    logical, intent(in) :: bbox
    real(kind=wp), intent(in) :: color(3)

procedure, public :: set_line_width => raster_set_line_width

  • interface

    private module subroutine raster_set_line_width(this, width)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    real(kind=wp), intent(in) :: width

procedure, public :: set_line_style => raster_set_line_style_context

  • interface

    private module subroutine raster_set_line_style_context(this, style)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    character(len=*), intent(in) :: style

procedure, public :: save => raster_save_dummy

  • interface

    private module subroutine raster_save_dummy(this, filename)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    character(len=*), intent(in) :: filename

procedure, public :: draw_marker => raster_draw_marker

  • interface

    private module subroutine raster_draw_marker(this, x, y, style, size)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    real(kind=wp), intent(in) :: x
    real(kind=wp), intent(in) :: y
    character(len=*), intent(in) :: style
    real(kind=wp), intent(in), optional :: size

procedure, public :: set_marker_colors => raster_set_marker_colors

  • interface

    private module subroutine raster_set_marker_colors(this, edge_r, edge_g, edge_b, face_r, face_g, face_b)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    real(kind=wp), intent(in) :: edge_r
    real(kind=wp), intent(in) :: edge_g
    real(kind=wp), intent(in) :: edge_b
    real(kind=wp), intent(in) :: face_r
    real(kind=wp), intent(in) :: face_g
    real(kind=wp), intent(in) :: face_b

procedure, public :: set_marker_colors_with_alpha => raster_set_marker_colors_with_alpha

  • interface

    private module subroutine raster_set_marker_colors_with_alpha(this, edge_r, edge_g, edge_b, edge_alpha, face_r, face_g, face_b, face_alpha)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    real(kind=wp), intent(in) :: edge_r
    real(kind=wp), intent(in) :: edge_g
    real(kind=wp), intent(in) :: edge_b
    real(kind=wp), intent(in) :: edge_alpha
    real(kind=wp), intent(in) :: face_r
    real(kind=wp), intent(in) :: face_g
    real(kind=wp), intent(in) :: face_b
    real(kind=wp), intent(in) :: face_alpha

procedure, public :: fill_quad => raster_fill_quad_context

  • interface

    private module subroutine raster_fill_quad_context(this, x_quad, y_quad)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    real(kind=wp), intent(in) :: x_quad(4)
    real(kind=wp), intent(in) :: y_quad(4)

procedure, public :: draw_arrow => raster_draw_arrow

  • interface

    private module subroutine raster_draw_arrow(this, x, y, dx, dy, size, style)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    real(kind=wp), intent(in) :: x
    real(kind=wp), intent(in) :: y
    real(kind=wp), intent(in) :: dx
    real(kind=wp), intent(in) :: dy
    real(kind=wp), intent(in) :: size
    character(len=*), intent(in) :: style

procedure, public :: draw_arrowhead => raster_draw_arrowhead

  • interface

    private module subroutine raster_draw_arrowhead(this, x, y, dx, dy, size, style)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    real(kind=wp), intent(in) :: x
    real(kind=wp), intent(in) :: y
    real(kind=wp), intent(in) :: dx
    real(kind=wp), intent(in) :: dy
    real(kind=wp), intent(in) :: size
    character(len=*), intent(in) :: style

procedure, public :: get_ascii_output => raster_get_ascii_output

  • interface

    private module function raster_get_ascii_output(this) result(output)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(in) :: this

    Return Value character(len=:), allocatable

procedure, public :: get_width_scale => raster_get_width_scale

  • interface

    private module function raster_get_width_scale(this) result(scale)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(in) :: this

    Return Value real(kind=wp)

procedure, public :: get_height_scale => raster_get_height_scale

  • interface

    private module function raster_get_height_scale(this) result(scale)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(in) :: this

    Return Value real(kind=wp)

procedure, public :: fill_heatmap => raster_fill_heatmap_context

  • interface

    private module subroutine raster_fill_heatmap_context(this, x_grid, y_grid, z_grid, z_min, z_max, colormap_name)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    real(kind=wp), intent(in), contiguous :: x_grid(:)
    real(kind=wp), intent(in), contiguous :: y_grid(:)
    real(kind=wp), intent(in), contiguous :: z_grid(:,:)
    real(kind=wp), intent(in) :: z_min
    real(kind=wp), intent(in) :: z_max
    character(len=*), intent(in), optional :: colormap_name

procedure, public :: render_legend_specialized => raster_render_legend_specialized_context

  • interface

    private module subroutine raster_render_legend_specialized_context(this, legend, legend_x, legend_y)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    type(legend_t), intent(in) :: legend
    real(kind=wp), intent(in) :: legend_x
    real(kind=wp), intent(in) :: legend_y

procedure, public :: calculate_legend_dimensions => raster_calculate_legend_dimensions_context

  • interface

    private module subroutine raster_calculate_legend_dimensions_context(this, legend, legend_width, legend_height)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(in) :: this
    type(legend_t), intent(in) :: legend
    real(kind=wp), intent(out) :: legend_width
    real(kind=wp), intent(out) :: legend_height

procedure, public :: set_legend_border_width => raster_set_legend_border_width_context

  • interface

    private module subroutine raster_set_legend_border_width_context(this)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this

procedure, public :: calculate_legend_position_backend => raster_calculate_legend_position_context

  • interface

    private module subroutine raster_calculate_legend_position_context(this, legend, x, y)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(in) :: this
    type(legend_t), intent(in) :: legend
    real(kind=wp), intent(out) :: x
    real(kind=wp), intent(out) :: y

procedure, public :: extract_rgb_data => raster_extract_rgb_data_context

  • interface

    private module subroutine raster_extract_rgb_data_context(this, width, height, rgb_data)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(in) :: this
    integer, intent(in) :: width
    integer, intent(in) :: height
    real(kind=wp), intent(out) :: rgb_data(width,height,3)

procedure, public :: get_png_data_backend => raster_get_png_data_context

  • interface

    private module subroutine raster_get_png_data_context(this, width, height, png_data, status)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(in) :: this
    integer, intent(in) :: width
    integer, intent(in) :: height
    integer(kind=1), intent(out), allocatable :: png_data(:)
    integer, intent(out) :: status

procedure, public :: prepare_3d_data => raster_prepare_3d_data_context

  • interface

    private module subroutine raster_prepare_3d_data_context(this, plots)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    type(plot_data_t), intent(in) :: plots(:)

procedure, public :: render_ylabel => raster_render_ylabel_context

  • interface

    private module subroutine raster_render_ylabel_context(this, ylabel)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    character(len=*), intent(in) :: ylabel

procedure, public :: draw_axes_and_labels_backend => raster_draw_axes_and_labels_context

  • interface

    private module subroutine raster_draw_axes_and_labels_context(this, xscale, yscale, symlog_threshold, x_min, x_max, y_min, y_max, title, xlabel, ylabel, x_date_format, y_date_format, z_min, z_max, has_3d_plots)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    character(len=*), intent(in) :: xscale
    character(len=*), intent(in) :: yscale
    real(kind=wp), intent(in) :: symlog_threshold
    real(kind=wp), intent(in) :: x_min
    real(kind=wp), intent(in) :: x_max
    real(kind=wp), intent(in) :: y_min
    real(kind=wp), intent(in) :: y_max
    character(len=:), intent(in), optional, allocatable :: title
    character(len=:), intent(in), optional, allocatable :: xlabel
    character(len=:), intent(in), optional, allocatable :: ylabel
    character(len=*), intent(in), optional :: x_date_format
    character(len=*), intent(in), optional :: y_date_format
    real(kind=wp), intent(in), optional :: z_min
    real(kind=wp), intent(in), optional :: z_max
    logical, intent(in) :: has_3d_plots

procedure, public :: draw_axes_lines_and_ticks => raster_draw_axes_lines_and_ticks_context

  • interface

    private module subroutine raster_draw_axes_lines_and_ticks_context(this, xscale, yscale, symlog_threshold, x_min, x_max, y_min, y_max)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    character(len=*), intent(in) :: xscale
    character(len=*), intent(in) :: yscale
    real(kind=wp), intent(in) :: symlog_threshold
    real(kind=wp), intent(in) :: x_min
    real(kind=wp), intent(in) :: x_max
    real(kind=wp), intent(in) :: y_min
    real(kind=wp), intent(in) :: y_max

procedure, public :: draw_axis_labels_only => raster_draw_axis_labels_only_context

  • interface

    private module subroutine raster_draw_axis_labels_only_context(this, xscale, yscale, symlog_threshold, x_min, x_max, y_min, y_max, title, xlabel, ylabel, custom_xticks, custom_xtick_labels, custom_yticks, custom_ytick_labels, x_date_format, y_date_format)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    character(len=*), intent(in) :: xscale
    character(len=*), intent(in) :: yscale
    real(kind=wp), intent(in) :: symlog_threshold
    real(kind=wp), intent(in) :: x_min
    real(kind=wp), intent(in) :: x_max
    real(kind=wp), intent(in) :: y_min
    real(kind=wp), intent(in) :: y_max
    character(len=:), intent(in), optional, allocatable :: title
    character(len=:), intent(in), optional, allocatable :: xlabel
    character(len=:), intent(in), optional, allocatable :: ylabel
    real(kind=wp), intent(in), optional :: custom_xticks(:)
    character(len=*), intent(in), optional :: custom_xtick_labels(:)
    real(kind=wp), intent(in), optional :: custom_yticks(:)
    character(len=*), intent(in), optional :: custom_ytick_labels(:)
    character(len=*), intent(in), optional :: x_date_format
    character(len=*), intent(in), optional :: y_date_format

procedure, public :: save_coordinates => raster_save_coordinates

  • interface

    private module subroutine raster_save_coordinates(this, x_min, x_max, y_min, y_max)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(in) :: this
    real(kind=wp), intent(out) :: x_min
    real(kind=wp), intent(out) :: x_max
    real(kind=wp), intent(out) :: y_min
    real(kind=wp), intent(out) :: y_max

procedure, public :: set_coordinates => raster_set_coordinates

  • interface

    private module subroutine raster_set_coordinates(this, x_min, x_max, y_min, y_max)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    real(kind=wp), intent(in) :: x_min
    real(kind=wp), intent(in) :: x_max
    real(kind=wp), intent(in) :: y_min
    real(kind=wp), intent(in) :: y_max

procedure, public :: render_axes => raster_render_axes

  • interface

    private module subroutine raster_render_axes(this, title_text, xlabel_text, ylabel_text)

    Arguments

    Type IntentOptional Attributes Name
    class(raster_context), intent(inout) :: this
    character(len=*), intent(in), optional :: title_text
    character(len=*), intent(in), optional :: xlabel_text
    character(len=*), intent(in), optional :: ylabel_text