mirror of
https://github.com/joe7575/tubelib2.git
synced 2024-08-20 05:24:05 +02:00
73 lines
2.5 KiB
Markdown
73 lines
2.5 KiB
Markdown
# Tube Library 2 [tubelib2]
|
|
|
|
A library for mods which need connecting tubes / pipes / cables or similar.
|
|
|
|
![tubelib2](https://github.com/joe7575/tubelib2/blob/master/screenshot.png)
|
|
|
|
|
|
This mod is not useful for its own. It does not even have any nodes.
|
|
It only comes with a few test nodes to play around with the tubing algorithm.
|
|
|
|
Browse on: ![GitHub](https://github.com/joe7575/tubelib2)
|
|
|
|
Download: ![GitHub](https://github.com/joe7575/tubelib2/archive/master.zip)
|
|
|
|
|
|
## Description
|
|
|
|
Tubelib2 distinguished two kinds of nodes:
|
|
- primary nodes are tube like nodes (pipes, cables, ...)
|
|
- secondary nodes are all kind of nodes, which can be connected by means of primary nodes
|
|
|
|
Tubelib2 specific 6D directions (1 = North, 2 = East, 3 = South, 4 = West, 5 = Down, 6 = Up)
|
|
|
|
All 6D dirs are the view from the node to the outer side
|
|
Tubes are based on two node types, "angled" and "straight" tubes.
|
|
|
|
|
|
+-------+
|
|
/ /| +-------+
|
|
/ / | / /|
|
|
/ / + / / |
|
|
/ / / +-------+ |
|
|
+-------+ / | | |
|
|
| | / | |/ |
|
|
| |/ +-------+| +
|
|
+-------+ | |/
|
|
+------+
|
|
|
|
|
|
All other nodes are build by means of axis/rotation variants based on param2
|
|
(paramtype2 == "facedir").
|
|
|
|
The 3 free MSB bits of param2 of tube nodes are used to store the number of connections (0..2).
|
|
|
|
The data of the peer head tube are stored in memory 'self.connCache'
|
|
|
|
Tubelib2 provides an update mechanism for connected "secondary" nodes. A callback function
|
|
func(node, pos, out_dir, peer_pos, peer_in_dir) will be called for every change on the connected tubes.
|
|
|
|
|
|
|
|
## Dependencies
|
|
default
|
|
optional: intllib
|
|
|
|
|
|
# License
|
|
Copyright (C) 2017-2019 Joachim Stolberg
|
|
Code: Licensed under the GNU LGPL version 2.1 or later.
|
|
See LICENSE.txt and http://www.gnu.org/licenses/lgpl-2.1.txt
|
|
Textures: CC0
|
|
|
|
|
|
## History
|
|
- 2018-10-20 v0.1 * Tested against hyperloop elevator.
|
|
- 2018-10-27 v0.2 * Tested against and enhanced for the hyperloop mod.
|
|
- 2018-10-27 v0.3 * Further improvements.
|
|
- 2018-11-09 v0.4 * on_update function for secondary nodes introduced
|
|
- 2018-12-16 v0.5 * meta data removed, memory cache added instead of
|
|
- 2018-12-20 v0.6 * intllib support added, max tube length bugfix
|
|
- 2019-01-06 v0.7 * API function replace_tube_line added, bug fixed
|
|
- 2019-01-11 v0.8 * dir_to_facedir bugfix
|
|
|