**The Pufferfish is one of few animals which is capable of changing its shape.**

This plugin is a set of components which focuses on Tweens, Blends, Morphs, Averages, & Interpolations - essentially shape changing. These components are accompanied by support components which are useful methods for the preparation of tween/blend operations such as making polylines compatible and matching surface structures. In addition, there are a few extra components which simplify some common grasshopper operations such as testing for equality with the option of tolerance and reparameterizing numbers. This is the first version of Pufferfish and many more components are currently in the works for shape changing.

**Join the grasshopper forum group here: **www.grasshopper3d.com/group/pufferfish

Pufferfish has been tested but it may contain bugs. It will be appreciated greatly if you could report any problem you might find in function as well as things like grammar. Please feel free to make functionality / new component suggestions as well (this is not a guarentee that they will be incorporated). I build this plugin for the community on my very limited free time so please give credit where credit is due.

I would like to make a special thanks to **David Stasiuk** and **Mateusz Zwierzycki** for their continual support and input on my plugins and letting me constantly bother them. Check out their plugins: Conduit, Cocoon, Tree Sloth, Owl, Anemone, Starling, & Squid.

-Michael Pryor

**General notes**

- Grasshoppers native "Interpolate Data" component can "Tween" simple data types such as numbers, colors, vectors and points already. Pufferfish's Tweens of these types differ in 2 ways. The first being that Pufferfish has 3 types of tweens for each: Tween Two, Tween Consecutive, and Tween Through which perform the tweens in different ways with the input lists. The second difference is that Pufferfish uses interpolation types which match nurbs interpolation for simple data types. Those types are Linear, Chord, Square Root, and Uniform. Grasshopper's "Interpolate Data" component uses Block, Linear, Cubic, and Catmull. Pufferfish also adds the ability to tween Planes, Surfaces, and Meshes as well as average them.
- Grasshopper already has a native "Tween Curve" component however, it gets odd results sometimes, specifically when tweening polylines. Pufferfish corrects this with automatic internal polyline and curve compatibilization so that the results are more similar to Rhino's tweens.
- Meshes must have the same topology to tween. Unlike surfaces, meshes which come from two different sources with different topologies are almost always impossible to rebuild (automatically) to have the same topology and point order for a meaningful looking tween. Please do not ask for this feature unless you can provide some information / documentation about how to do so. As recommended by Autodesk Maya for blending meshes "A common blend shape technique is to create duplicates of a base, deform the duplicates, then use them as targets. For example, you might make several copies of a face, and then alter the copies to create a smiling face, frowning face, a crying face, and so on."
- A few minor components may exist elseware in other plugins (it's impossible to check them all). If they are in Pufferfish it is because I felt they are necessary to the workflow and I cannot ensure the user has other plugins installed. For example, Pufferfish has a type of "Rebuild Surface" which varies slightly from but exists also in Lunchbox.

**Pufferfish Changelog**

Nov 08, 2017 - Pufferfish V1.4

*Update to improve algorithm for all "On Curve" components and all components with an "Interpolation Type" input.*

Nov 01, 2017 - Pufferfish V1.3

*Update to fix a minor bug in all tween plane components with Quaternion rotation that would result in null planes when input planes X axis's aligned. Added many new examples.*

Oct 28, 2017 - Pufferfish V1.2

*Update to add 9 new components. 3 for tweening planes on curves with Quaternion rotation, 3 for tweening planes on surfaces with Quaternion rotation, 3 for tweening points on curves (like Grasshopper's evaluate curve component except you can interpolate between user defined points on the curve rather than interpolating the entire curve) . Added tolerance input to "Is Arc/Circle/Ellipse" component.*

Oct 22, 2017 - Pufferfish V1.1

*Update to add Quaternion rotation option to the Tween Planes components for smoother tween rotations and prevention of Gimbal lock. Suggested by Andrew Heumann, based on a grasshopper definition by Daniel Piker.*

Oct 17, 2017 - Pufferfish V1.0

*First release*

**Pufferfish Component List - 74 components**

01_Number

*Tween Consecutive Numbers**Tween Through Numbers**Tween Two Numbers**Last Index Range**List Length Range**Reparameterized Range**Equality Within Tolerance**Last Index**Partition Number**Reparameterize Numbers**Round To Nearest**Default Angle Tolerance**Document Angle Tolerance**Document Distance Tolerance**Zero Distance Tolerance*

02_Color

*Tween Consecutive Colors**Tween Through Colors**Tween Two Colors*

03_Vector

*Tween Consecutive Vectors**Tween Through Vectors**Tween Two Vectors*

04_Point

*Tween Consecutive Points**Tween Through Points**Tween Two Points**Tween Consecutive Points On Curve*- Tween Through Points On
*Curve* - Tween Two Points On
*Curve* *Tween Consecutive Points On Surface*- Tween Through Points On Surface
- Tween Two Points On Surface
*Move 2Pt**Pinch'n'Spread**Are Points Collinear**Are Points Coplanar*

05_Plane

*Average Plane**Weighted Average Plane**Tween Consecutive Planes**Tween Through Planes**Tween Two Planes**Tween Consecutive Planes On Curve**Tween Through Planes On Curve**Tween Two Planes On Curve**Tween Consecutive Planes On Surface**Tween Through Planes On Surface**Tween Two Planes On Surface*

06_Curve

*Average Curve**Weighted Average Curve**Tween Consecutive Curves**Tween Through Curves**Tween Two Curves**Net On Surface**Tween Consecutive Curves On Surface**Tween Through Curves On Surface**Tween Two Curves On Surface**Close Curve**Compatibilize Polylines**Superimpose Curve**Is Arc/Circle/Ellipse**Is Curve Linear*

07_Surface

*Average Surface**Weighted Average Surface**Tween Consecutive Surfaces**Tween Through Surfaces**Tween Two Surfaces**Fit Surface**Rebuild Surface**Superimpose Surface**Is Surface Closed**Is Surface Singular*

08_Mesh

*Average Mesh**Weighted Average Mesh**Tween Consecutive Meshes**Tween Through Meshes**Tween Two Meshes*

- Category: