Revision: 76776
http://sourceforge.net/p/brlcad/code/76776
Author: brlcad
Date: 2020-08-15 12:27:33 +0000 (Sat, 15 Aug 2020)
Log Message:
-----------
bu_units_string is itself undocumented and appears to be used via the
undocumented 'units -t' switch for getting a listing of length units. needs
cleanup
Modified Paths:
--------------
brlcad/trunk/include/bu/units.h
Modified: brlcad/trunk/include/bu/units.h
===================================================================
--- brlcad/trunk/include/bu/units.h 2020-08-15 04:35:38 UTC (rev 76775)
+++ brlcad/trunk/include/bu/units.h 2020-08-15 12:27:33 UTC (rev 76776)
@@ -43,7 +43,7 @@
* (e.g., "cm^3", "cu yards"), or mass (e.g., "kg", "grain", or "oz")
* return the multiplier (aka conversion factor) that converts the
* unit into the default (millimeters for length, mm^3 for volume, and
- * grams for mass.) Values may be optionally specified with the unit
+ * grams for mass.) Values may be optionally specified with the unit
* (e.g., "5ft") to get the conversion factor for a particular
* quantity.
*
@@ -51,6 +51,7 @@
*/
BU_EXPORT extern double bu_units_conversion(const char *str);
+
/**
* Given a conversion factor to mm, search the table to find what unit
* this represents.
@@ -62,8 +63,12 @@
* NULL No known unit matches this conversion factor.
*/
BU_EXPORT extern const char *bu_units_string(const double mm);
+
+
+/** undocumented */
BU_EXPORT extern struct bu_vls *bu_units_strings_vls(void);
+
/**
* Given a conversion factor to mm, search the table to find the
* closest matching unit.
@@ -74,6 +79,7 @@
*/
BU_EXPORT extern const char *bu_nearest_units_string(const double mm);
+
/**
* Given a string of the form "25cm" or "5.2ft" returns the
* corresponding distance in mm.
@@ -84,6 +90,7 @@
*/
BU_EXPORT extern double bu_mm_value(const char *s);
+
/**
* Used primarily as a hooked function for bu_structparse tables to
* allow input of floating point values in other units.
@@ -106,6 +113,7 @@
#define BU_HN_GETSCALE 0x10
#define BU_HN_AUTOSCALE 0x20
+
/**
* Convert digital sizes to human readable form. Based off the
* BSD function humanize_number(3).
@@ -117,6 +125,7 @@
*/
BU_EXPORT extern int bu_humanize_number(char *buf, size_t len, int64_t
quotient, const char *suffix, size_t scale, int flags);
+
/*
* Converts the number given in 'str', which may be given in a humanized
* form (as described in BSD's humanize_number(3), but with some limitations),
This was sent by the SourceForge.net collaborative development platform, the
world's largest Open Source development site.
_______________________________________________
BRL-CAD Source Commits mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/brlcad-commits
