The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Types::PGPLOT - Type::Tiny compatible types for the PGPLOT library

VERSION

version 0.02

SYNOPSIS

 use Types::PGPLOT -types;
 use Type::Params qw( validate );

 my ( $lstyle ) = validate( [ 'full' ], LineStyle );

DESCRIPTION

Types::PGPLOT provides Type::Tiny types for constants used by the PGPLOT library.

TYPES

Angle

A real number in [-360,360].

ArrowHeadFillStyle

An integer in [1,2].

Coercions are provided for Str types with one of the following values:

  filled solid outline

CharacterHeight

A positive real number.

Color

An integer in [0,255].

Coercions are provided for Str types with one of the following values:

    background foreground
    black      magenta         blue-magenta
    white      yellow          red-magenta
    red        orange          dark-gray
    green      green-yellow    light-gray
    blue       green-cyan      darkgray
    cyan       blue-cyan       lightgray

FillAreaStyle

An integer in [1,4].

Coercions are provided for Str types with one of the following values:

  solid filled outline hatched cross-hatched

Font

An integer in [1,4].

Coercions are provided for Str types with one of the following values:

  normal roman italic script

LineStyle

An integer in [1,5].

Coercions are provided for Str types with one of the following values:

  full dashed dot-dash-dot-dash dotted dash-dot-dot-dot

LineWidth

An integer in [1,201].

PlotUnits

An integer in [0,4].

Coercions are provided for Str types with one of the following values:

  ndc normalized-device-coordinates
  in inches
  mm millimeters
  pixels
  wc world-coordinates

Symbol

An integer in [-31,255]

Coercions are provided for string or references to strings with one of the following values:

    doicosagon              dodecagon               triangle
    henicosagon             hendecagon              dot0
    icosagon                decagon                 dot1
    enneadecagon            nonagon                 opensquare
    octadecagon             enneagon                dot
    heptadecagon            octagon                 plus
    hexadecagon             heptagon                asterisk
    pentaadecagon           hexagon                 opencircle
    tetradecagon            pentagon                cross
    tridecagon              diamond                 x
    opensquare1             stardavid               opencirc4
    opentriangle            square                  opencirc5
    earth                   circle                  opencirc6
    sun                     star                    opencirc7
    curvesquare             bigosquare              backarrow
    opendiamond             opencirc0               fwdarrow
    openstar                opencirc1               uparrow
    triangle1               opencirc2               downarrow
    openplus                opencirc3

as well as characters with unicode/ascii codes in [32, 127].

Because Perl well treat digits stored as strings as numbers rather than strings, the characters 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 will get treated as integers, not characters, so the resultant symbols will not be the expected characters. To ensure that a character is treated as a character, pass a reference to it. This will bypass the automatic conversion to integer.

XAxisOptions

A string containing any of the characters in ABCGILNPMTS12, where no character repeats.

YAxisOptions

A string containing any of the characters in ABCGILNPMTSV12, where no character repeats.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Types-PGPLOT or by email to bug-Types-PGPLOT@rt.cpan.org.

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

SOURCE

The development version is on github at https://github.com/djerius/types-pgplot and may be cloned from git://github.com/djerius/types-pgplot.git

AUTHOR

Diab Jerius <djerius@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2018 by Smithsonian Astrophysical Observatory.

This is free software, licensed under:

  The GNU General Public License, Version 3, June 2007