lsynth: Extract description and usage from source.

This commit is contained in:
Laurens Valk 2020-09-20 16:45:00 +02:00
parent bb14499ee3
commit 0c7da3c165
No known key found for this signature in database
GPG Key ID: C5FCCBB5E9FB117A
1 changed files with 43 additions and 0 deletions

View File

@ -0,0 +1,43 @@
# LSynth
LDraw CAD system compatible flexible part synthesizer. This program
reads your LDraw file, searching for unofficial META commands (structured
comments), that specify things you want synthesized.
### What does it do?
LSynth has two primary forms of synthesis. The first kind of synthesis
creates hose like things including:
rubbed, rubber, pneumatic, and flex system hoses, as well as electric
and fiber optic cables, flex system cables, flexible axles, string, and
minifig chain.
It also creates things that travel around circular lego parts. Things
like:
rubber band, rubber belt, technic chain, technic plastic tread, technic
rubber tread.
The files tube.c, tube.h, curve.c and curve.h perform hose synthesis.
The files band.c and band.h perform band synthesis.
This file (main.c) contains the main entry/exit points for the program.
It opens and scans the LDraw file provided, identifies synthesis
synthesis specifications and hands them off to the appropriate synthesis
methodology.
### Usage
`lsynthcp [-v] [-h] [-m] [-l] [-p] <src> <dst>`
- -v: prints lsynthcp version
- -h: prints this help message
- -m: prints out the LSynth portion of the MLcad.ini for using this program
- -l: format the output as an official ldraw part
- -p: prints out the full path name of the this executable
The easiest way to use LSynth is from within MLcad. You need to
make additions to MLCad.ini. Please see [Willy Tscager's tutorial
page](http://www.holly-wood.it/lsynth-en.html).
To create a flexible part, you put specifications for the part
directly into your LDraw file, where the part is needed.