diff --git a/CHANGELOG.md b/CHANGELOG.md index 06669ab..da932ff 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,7 @@ ## Unreleased +* **Added** switch data file exporter for Moho (formerly Anime Studio) and OpenToonz ([issue #69](https://github.com/DanielSWolf/rhubarb-lip-sync/issues/69)) * **Improved** animation rule for OW sound: animating it as E-F rather than F. ## Version 1.9.1 diff --git a/README.adoc b/README.adoc index 5ec1dbf..f166a1c 100644 --- a/README.adoc +++ b/README.adoc @@ -23,6 +23,7 @@ Rhubarb Lip Sync allows you to quickly create 2D mouth animation from voice reco Rhubarb Lip Sync integrates with the following applications: * *Adobe After Effects* (see <>) +* *Moho* and *OpenToonz* (see <>) * *Spine* by Esoteric Software (see <>) * *Vegas Pro* by Magix (see <>) * *Visionaire Studio* (see https://www.visionaire-studio.net/forum/thread/mouth-animation-using-rhubarb-lip-sync[external link]) @@ -44,6 +45,13 @@ You can use Rhubarb Lip Sync to animate dialog right from Adobe After Effects. F image:img/after-effects.png[] +[[moho]] +=== Moho and OpenToonz + +Rhubarb Lip Sync can create .dat switch data files, which are understood by Moho and OpenToonz. You can set the frame rate using the `--datFrameRate` option; to control the shape names, use the `--datUsePrestonBlair` flag. For more details, see <>. + +image:img/moho.png[] + [[spine]] === Spine by Esoteric Software @@ -123,7 +131,7 @@ Rhubarb Lip Sync is a command-line tool that is currently available for Windows The following command-line options are the most common: -[cols="2,5"] +[cols="2,5a"] |=== | Option | Description @@ -136,7 +144,7 @@ The following command-line options are the most common: _Default value: ``pocketSphinx``_ | `-f` __, `--exportFormat` __ -| The export format. Options: `tsv` (tab-separated values, see <>), `xml` (see <>), `json` (see <>). +| The export format. Options: `tsv` (tab-separated values, see <>), `xml` (see <>), `json` (see <>), `dat` (see <>). _Default value: ``tsv``_ @@ -161,6 +169,33 @@ _Default value: ``GHX``_ | `-h`, `--help` | Displays usage information and exits. + +| `--datFrameRate` _number_ +| Only valid when using the `dat` export format. Controls the frame rate for the output file. + +_Default value: 24_ + +| `--datUsePrestonBlair` +| Only valid when using the `dat` export format. Uses Preston Blair mouth shapes names instead of the default alphabetical ones. This applies the following mapping: + +!=== +! Alphabetic name ! Preston Blair name + +! A ! MBP +! B ! etc +! C ! E +! D ! AI +! E ! O +! F ! U +! G ! FV +! H ! L +! X ! rest +!=== + +CAUTION: This mapping is only applied when exporting, _after_ the recording has been animated. To control which mouth shapes to use, use the <> option _with the alphabetic names_. + +TIP: For optimal results, make sure your mouth drawings follow the guidelines in the <> section. This is easier if you stick to the alphabetic names instead of the Preston Blair names. The only situation where you _need_ to use the Preston Blair names is when you're using OpenToonz, because OpenToonz only supports the Preston Blair names. + |=== ==== Advanced command-line options ==== diff --git a/img/moho.png b/img/moho.png new file mode 100644 index 0000000..98d2404 Binary files /dev/null and b/img/moho.png differ