161 lines
2.7 KiB
Markdown
161 lines
2.7 KiB
Markdown
# NMSlib
|
|
|
|
NMSlib is a GoLang package for dealing with converting Galactic coordinates to Portal codes and vice versa.
|
|
|
|
NMSlib also translates in game languages to english.
|
|
|
|
## Installation
|
|
|
|
To install this module use `go get`
|
|
|
|
|
|
```bash
|
|
go get -u gitlab.com/bradley.richins/nmslib
|
|
```
|
|
|
|
## Usage
|
|
|
|
**Example:**
|
|
|
|
```golang
|
|
package main
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"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)
|
|
|
|
fmt.Println(Translate{"KIHTYOMOLES"}.Kor2Eng())
|
|
korvax := Translate{"Contraband"}
|
|
fmt.Println(korvax.Eng2Kor())
|
|
}
|
|
|
|
```
|
|
|
|
### 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)
|
|
```
|
|
|
|
|
|
|
|
### Converting Portal code to Galactic address with P2gc()
|
|
|
|
This function only takes 1 parameter and returns a string and error
|
|
|
|
* 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 and error
|
|
|
|
* galacticaddress: 16 char 4 block hex address
|
|
|
|
**Example:**
|
|
|
|
```golang
|
|
pc, _ := nmslib.P3gc("042F:0079:0D55:006A")
|
|
fmt.Println(pc)
|
|
```
|
|
|
|
Output:
|
|
|
|
``006AFA556C30``
|
|
|
|
## Translate Words
|
|
|
|
Supported languages
|
|
|
|
- Korvax
|
|
- Gek
|
|
- Vy'keen
|
|
- Atlas
|
|
|
|
### Translate Atlas to English with Atl2Eng()
|
|
|
|
This function takes only 1 parameter and returns a string
|
|
|
|
* Word: Any known Atlas word (ex. Paka)
|
|
|
|
**Example:**
|
|
|
|
```golang
|
|
fmt.Println(Translate{"Paka"}.Atl2Eng())
|
|
```
|
|
|
|
Output:
|
|
|
|
``Awake``
|
|
|
|
### Translate English to Korvax with Eng2Korvax()
|
|
|
|
This function takes only 1 parameter and returns a string
|
|
|
|
* engword: English word to attempt conversion
|
|
|
|
**Example:**
|
|
|
|
```golang
|
|
korvax := Translate{"Contraband"}
|
|
fmt.Println(korvax.Eng2Kor())
|
|
```
|
|
|
|
Output:
|
|
|
|
``Zelidovoso``
|
|
|
|
|
|
### Language commands
|
|
|
|
Gek:
|
|
- ``Translate{word}.Gek2Eng()``
|
|
- ``Translate{word}.Eng2Gek()``
|
|
|
|
Korvax:
|
|
- ``Translate{word}.Kor2Eng()``
|
|
- ``Translate{word}.Eng2Kor()``
|
|
|
|
Vy'keen:
|
|
- ``Translate{word}.Vyk2Eng()``
|
|
- ``Translate{word}.Eng2Vyk()``
|
|
|
|
Atlas:
|
|
- ``Translate{word}.Atl2Eng()``
|
|
- ``Translate{word}.Eng2Atl()``
|
|
|
|
## License
|
|
[MIT](COPYING)
|