https://github.com/thunderpoot/pointy

Interactive IEEE 754 floating point calculator/visualiser written in Perl
https://github.com/thunderpoot/pointy

calculator color colours command-line command-line-interface command-line-tool command-line-tools educational float32 floating-point ieee754 interactive interactive-visualizations mathematics perl terminal tui

Last synced: 6 months ago
JSON representation

Interactive IEEE 754 floating point calculator/visualiser written in Perl

• Host: GitHub
• URL: https://github.com/thunderpoot/pointy
• Owner: thunderpoot
• Created: 2023-02-12T00:11:54.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2023-05-10T10:19:27.000Z (over 2 years ago)
• Last Synced: 2025-03-29T11:12:40.722Z (6 months ago)
• Topics: calculator, color, colours, command-line, command-line-interface, command-line-tool, command-line-tools, educational, float32, floating-point, ieee754, interactive, interactive-visualizations, mathematics, perl, terminal, tui
• Language: Perl
• Homepage:
• Size: 1.6 MB
• Stars: 8
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

          
![Pointy Hero Image](./hero.png)

![Perl](https://img.shields.io/badge/perl-%2339457E.svg?style=for-the-badge&logo=perl&logoColor=white)

## pointy

**`pointy`** is a command-line tool for visualising IEEE 754 floating point values, written in Perl.

![Pointy](./demo.gif)

### Installation

```

git clone https://github.com/thunderpoot/pointy.git /tmp/pointy  && \

cd /tmp/pointy                                                   && \

curl -L https://cpanmin.us | /usr/bin/env perl - --installdeps . && \

cp /tmp/pointy/pointy /usr/local/bin && cd                       && \

rm -rf /tmp/pointy                                               && \

echo "All done"

```

### Readme

```

NAME

        pointy - Present IEEE 754 floating point values

SYNOPSIS

        # Run with no options for interactive mode

        pointy

DESCRIPTION

    Provides a visual representation of IEEE 754 floating point

    numbers.  In interactive mode the following keys are available:

        - Left / right arrow-keys to navigate bit array

        - Up / down arrow-keys to flip bits on or off

        - 1 / 0 keys to input bits manually

        - + / - keys to adjust colour index

        - Delete / backspace to set current bit to 0

        - Tab key / ^I (Control-I) to switch fields for direct input

        - ? / H key to show this help document

    Options

        [-\? | -help ]

            Show this help document and quit

        [-decimal] 

            Present decimal  and quit

        [-hexadecimal] 

            Present hexadecimal  and quit

        [-nocolour]

            Do not use colours (colours are 16-bit)

        [-colour] 

            Adjust colour index (range: -80 to 175)

        [-unicode]

            Use Unicode characters (default is DEC Special Graphics)

        [-ascii]

            Use ASCII characters only

        [-version]

            Print current version and quit

    Examples

        # Display hex value with no colour

        pointy -n -hex deadbeef

        # Display decimal value

        pointy -d 123

BUGS

    * None known

SOURCE AVAILABILITY

    Source code is available on GitHub (https://github.com/thunderpoot/pointy/)

CREDITS

    Devon (https://github.com/telnet23) for help with Perl syntax

    and mathematics

    Bartosz Ciechanowski (https://ciechanow.ski/exposing-floating-point/)

    and (https://float.exposed/)

AUTHOR

    Underwood, ""

COPYRIGHT

    Copyright (c) 2023, All Rights Reserved.

    You may modify and redistribute this software only if this documentation

    remains intact.

SEE ALSO

    float(3), math(3), complex(3)

    RFC 6340 (https://www.rfc-editor.org/rfc/rfc6340.html)

STANDARDS

    Floating-point arithmetic conforms to the ISO/IEC 9899:2011 standard.

```