From 8fcbca9582f6cfc36c9f3a9cadc8362f41e1c041 Mon Sep 17 00:00:00 2001 From: drewcassidy Date: Mon, 2 Nov 2020 23:58:36 -0800 Subject: [PATCH] add Editor and Scripts readmes --- Editor/README.md | 52 +++++++++++++++++++++++++++++++++++++++++++++++ Scripts/README.md | 19 +++++++++++++++++ 2 files changed, 71 insertions(+) create mode 100644 Editor/README.md create mode 100644 Scripts/README.md diff --git a/Editor/README.md b/Editor/README.md new file mode 100644 index 0000000..8b32c79 --- /dev/null +++ b/Editor/README.md @@ -0,0 +1,52 @@ +# Editor + +Files for using the Unity editor + +## Installation + +Place the "Editor" folder anywhere in your project Assets folder. + +## Usage + +### MeshPostProcessor + +Used to perform various operations to models on import to unity + +###### Add Colliders + +To convert objects to colliders on import, add the following strings to the object's name: + +* `_COLLIDER`: Converts to a mesh collider + +* `_SPHERECOLLIDER`: Converts to a sphere collider + +* `_CAPSULECOLLIDER`: Converts to a capsule collider, with the axis along the object's longest axis + +* `_BOXCOLLIDER`: Converts to a box collider. The box will be aligned to the object's local coordinates + +###### Merge Meshes + +Add `_MERGE` to an object's name, and all its child objects meshes will be automatically merged into one. Does not work for skinned meshes + +###### Delete Objects + +Add `_DEL` to an object's name to delete it on import + +###### Trim animations + +Automatically removes any animations with only 2 keyframes to make them easier to edit manually + + +### TexturePostProcessor + +Used to perform various operations on textures on import to Unity. Configured with constants in the top of the file. + +Only works on files with the extension `EXTENSION` (default ".png"). + +###### Specular maps + +If `SPEC_ENABLE` is enabled (default true), textures with the suffix `SPEC_TAG` (default "-spec") will be copied into the alpha channel of the texture without that suffix. For example, the file `foo-spec.png` will be copied into the alpha channel of the imported texture `foo.png`. + +###### Normal maps + +If `NORMAL_ENABLE` is enabled (default true), textures with the suffix `NORMAL_TAG` (default "-spec") will be marked as normal maps on import and when KSP PartTools exports the texture. if `NORMAL_GENERATE` is enabled (default true), then the texture will automatically be converted from a hightmap using Unity's normal map generation tool. diff --git a/Scripts/README.md b/Scripts/README.md new file mode 100644 index 0000000..cd814d4 --- /dev/null +++ b/Scripts/README.md @@ -0,0 +1,19 @@ +# Scripts + +Bash scripts for interacting with files + +## Installation + +All files require bash to be installed (default location of `/bin/bash`). + +`convert2dds` and `dds2png` require [ImageMagick](https://imagemagick.org/index.php) and [Nvidia Texture Tools](https://github.com/HeliumProject/NvidiaTextureTools) to be installed and available in your `$PATH`. + +## Usage + +### convert2dds + +converts any number of files to `.dds` format, automatically choosing dxt1 or dxt5 depending on if the source image has anything in its alpha channel. Designed to be used with a glob, e.g: `convert2dds *.png` + +### dds2png + +converts any number of files to `.png` from `.dds`. Designed to be used with a glob, e.g: `dds2png *.dds` \ No newline at end of file