From 59cc61105ae8ca530fb8a377eef1f48a507be6b8 Mon Sep 17 00:00:00 2001 From: "bradley.richins" Date: Mon, 19 Oct 2020 22:37:00 -0600 Subject: [PATCH] Updated README.md --- README.md | 112 ++++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 100 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index b9900db..bec64d8 100644 --- a/README.md +++ b/README.md @@ -16,28 +16,116 @@ go get -u gitlab.com/bradley.richins/nmslib ## Usage +**Example:** + ```golang package main import ( - "fmt" + "fmt" - "gitlab.com/bradley.richins/nmslib" + "gitlab.com/bradley.richins/nmslib" ) func main() { - portalcode := "006afa556c30" - tstvar, err := nmslib.P2gc(portalcode) - if err != nil { - panic(err) - } - fmt.Printf("Input: \t%s\nExpecting: \t042F:0079:0D55:006A\nHave: \t%s\n", portalcode, tstvar) - nmslib.CreateBanner(portalcode, "NewLennon.png", 0) + portalcode := "006afa556c30" + tstvar, err := nmslib.P2gc(portalcode) + if err != nil { + panic(err) + } + fmt.Printf("Input:\t%s\nExpecting:\t042F:0079:0D55:006A\nHave:\t%s\n", portalcode, tstvar) - fmt.Println(nmslib.Korvax2Eng("eapoluch")) - fmt.Println(nmslib.Eng2Korvax("emergency")) + nmslib.CreateBanner(portalcode, "NewLennon.png", 0) + + fmt.Println(nmslib.Korvax2Eng("eapoluch")) + fmt.Println(nmslib.Eng2Korvax("emergency")) } + ``` +### Creating a Glyph banner with CreateBanner() + +This function takes 3 parameters: + +* portalcode: 12 char hex string of portal location +* savename: Save location and name +* Horizontal/Vertical layout: 0 is horizontal, 1 is vertical + +**Example:** + +Horizontal Layout for Galactic Hub [HUB10-6A Icarus Sun](https://nomanssky.gamepedia.com/HUB10-6A_Icarus_Sun) Eniwa 68/L3 + +```golang +nmslib.CreateBanner("006afa556c30", "NewLennon.png", 0) +``` + +![](NewLennon.png) + +### Converting Portal code to Galactic address with P2gc() + +This function only takes 1 parameter and returns a string + +* portalcode: 12 char hex string of portal glyphs + +**Example:** + +```golang +ga, _ := nmslib.P3gc("006afa556c30") +fmt.Println(ga) +``` + +Output: + +``042F:0079:0D55:006A`` + +### Converting Galactic coordinates to Portal codes with Gc2p() + +This function only takes 1 parameter and returns a string + +* galacticaddress: 16 char 4 block hex address + +**Example:** + +```golang +pc, _ := nmslib.P3gc("042F:0079:0D55:006A") +fmt.Println(pc) +``` + +Output: + +``006AFA556C30`` + +### Translate Korvax to English with Korvax2Eng() + +This function takes only 1 parameter and returns a string + +* korvaxword: Any known Korvaxen word (ex. eapoluch) + +**Example:** + +```golang +fmt.Println(Korvax2Eng("eapoluch")) +``` + +Output: + +``emergency`` + +### Translate English to Korvax with Eng2Korvax() + +This function takes only 1 parameter and returns a string + +* engword: English word to attempt conversion + +**Example:** + +```golang +fmt.Println(Eng2Korvax("emergency")) +``` + +Output: + +``eapoluch`` + ## License -[MIT](https://choosealicense.com/licenses/mit/) \ No newline at end of file +[MIT](LICENSE) \ No newline at end of file