Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rizalmart/gmeasures3

GTK+3 port of gmeasures
https://github.com/rizalmart/gmeasures3

app gmeasures gtk3 utilities

Last synced: 11 days ago
JSON representation

GTK+3 port of gmeasures

Awesome Lists containing this project

README 

        
gMeasures v3.0

(C)2024 Paul Schuurmans



Introduction

============

gMeasures is a simple utility to convert weights and measures.  It can also 

convert Celsius / Fahrenheit temperatures.



Installation

============

The configure script has been omitted from this package due to its size 

and the fact that it doesn't work on all systems.  Instead, you run an 

autogen script which creates the configure script.  If you need to pass 

any parameters to the configure script, you can do so on the autogen.sh 

line.  Other than that, installation is pretty much the same as usual:



  tar zxvf gmeasures-3.0.tar.gz

  cd gmeasures-3.0

  sh autogen.sh

  make

  make install



Using The Anjuta Project File

=============================

This package contains an Anjuta 1.2.2 project file.  Because of the missing 

configure script, "Build|Build" won't work initially; you'll need to select 

"Build|Auto generate..." first.



Using gMeasures

===============



To calculate weights and measures:

----------------------------------

1. Enter the amount in the first entry field (top left) and select the unit to 

convert in the first dropdown listbox.

2. In the second dropdown listbox, select the unit to convert to.



To edit an existing conversion:

-------------------------------

1. Use the dropdown listboxes to select the conversion.

2. Press the [Edit/Add] button.

3. Edit the "Equals" field.

4. Press the [OK] button.



To add a new conversion:

------------------------

1. Press the [Edit/Add] button.

2. Edit any or all of the fields as necessary.  Note: if you edit only the 

"Equals" field, it counts as an edit (i.e., no new conversion is added).

3. Press the [OK] button.



To delete a conversion:

-----------------------

Note: Read "The Edit/Add Dialog" below before doing this for the first time.

1. Use the dropdown listboxes to select the conversion.

2. Press the [Edit/Add] button.

3. Press the [Delete] button.



To calculate temperatures:

--------------------------

1. Enter the amount of degrees in either the Celsius or Fahrenheit entry field.



The Edit/Add Dialog

===================

When you press the [OK] or [Delete] button, gMeasures will automatically 

write the current configuration to a file named .gmeasures.cfg in your home 

directory.  Note that there is no confirmation after pressing either of these 

buttons.  You can revert back to the original 101 built-in conversions by 

deleting the .gmeasures.cfg file, but that won't restore any of your own 

conversions that you've added or edited.  So please be careful, especially 

before pressing the [Delete] button.



Locales

=======

By default, gMeasures uses the "C" locale.  If your locale uses a comma instead 

of a decimal point, and you want a localized version of this program, here are 

the steps to take:



1. In the main.c file, go to main() and uncomment the gtk_set_locale() line.

2. Also in the main.c file, go to AppReadWriteConfig() and replace the decimal 

points in the defs array with commas.

3. Recompile the program.



Known Quirks

============

- Limited accuracy.  Decimal fractions exceeding 5 digits may or may not be 

accurate.



Bug Reports

===========

Although some effort has been made to make this program as robust as possible, 

there may be bugs that I don't yet know about.  If you find any bugs, please 

let me know.  For information on how to contact me, see the README file on my 

website.