ITypeAssistant<T>

References
public interface ITypeAssistant<T> : ITypeAssistant
Base interface for type assistants. Do not implement this interface from scratch, instead inherit from TypeAssistant<T>.
Type parameters:
TActual type to assist.

Properties

Constructors

IEnumerable<string> Constructors { get; }
Enumerate all defined constructors for this type.
inherited fromITypeAssistant

Icon

IIcon Icon { get; }
Gets the icon associated with this type, if any.
inherited fromITypeAssistant

IsReimplementation

bool IsReimplementation { get; }
Gets whether or not this assistant is a type-safe re-implementation of a more generic assistant.
inherited fromITypeAssistant

Name

string Name { get; }
Gets the (singular) name of this type as meant for human consumption. I.e. "point", "number", "boolean", etc.
inherited fromITypeAssistant

ReimplementationBase

ITypeAssistant ReimplementationBase { get; }
Gets the base assistant (if any) this assistant is a re-implementation of.
inherited fromITypeAssistant

Type

Type Type { get; }
Gets the type associated with this assistant.
inherited fromITypeAssistant

ZupportsArea

bool ZupportsArea { get; }
Gets whether this type assistant has support for Area metrics.
inherited fromITypeAssistant

ZupportsAreaCentroid

bool ZupportsAreaCentroid { get; }
Gets whether this type assistant has support for Area centroid metrics.
inherited fromITypeAssistant

ZupportsBake

bool ZupportsBake { get; }
Gets whether this type assistant supports conversion to Rhino compliant shapes.
inherited fromITypeAssistant

ZupportsBoundingBox

bool ZupportsBoundingBox { get; }
Gets whether this type assistant has support for bounding boxes.
inherited fromITypeAssistant

ZupportsClosestPoint

bool ZupportsClosestPoint { get; }
Gets whether this type assistant has support for closest point resolution.
inherited fromITypeAssistant

ZupportsDeform

bool ZupportsDeform { get; }
Gets whether this type assistant has support for non-linear deformations.
inherited fromITypeAssistant

ZupportsDraw

bool ZupportsDraw { get; }
Gets whether this type assistant has support for geometry displays.
inherited fromITypeAssistant

ZupportsFurthestPoint

bool ZupportsFurthestPoint { get; }
Gets whether this type assistant has support for furthest point resolution.
inherited fromITypeAssistant

ZupportsLength

bool ZupportsLength { get; }
Gets whether this type assistant has support for Length metrics.
inherited fromITypeAssistant

ZupportsPick

bool ZupportsPick { get; }
Gets whether the assistants supports UI for specifying new values.
inherited fromITypeAssistant

ZupportsReadWrite

bool ZupportsReadWrite { get; }
Gets whether this assistant supports (de)serializing instances of T.
inherited fromITypeAssistant

ZupportsRoundTripping

bool ZupportsRoundTripping { get; }
Gets whether this assistant supports round-tripping from T to string to T. For this to be true, both ITypeAssistant.Format(object) and ITypeAssistant.Parse(string, string, IPear) must be implemented.
inherited fromITypeAssistant

ZupportsTransform

bool ZupportsTransform { get; }
Gets whether this type assistant has support for linear transformations.
inherited fromITypeAssistant

ZupportsTransformBox

bool ZupportsTransformBox { get; }
Gets whether this type assistant has support for transform aligned bounding boxes.
inherited fromITypeAssistant

ZupportsVolume

bool ZupportsVolume { get; }
Gets whether this type assistant has support for Volume metrics.
inherited fromITypeAssistant

ZupportsVolumeCentroid

bool ZupportsVolumeCentroid { get; }
Gets whether this type assistant has support for Volume centroid metrics.
inherited fromITypeAssistant

Methods

Area

bool Area(object instance, out double area)
Measure the area of an instance.
inherited fromITypeAssistant
Parameters:
instance (object)Instance to measure.
area (out double)Measured area.
Returns: Success or failure.

Area

#
bool Area(T instance, out double area)
Measure the area of an instance.
Parameters:
instance (T)Instance to measure.
area (out double)Measured area.
Returns: Success or failure.

AreaCentroid

bool AreaCentroid(object instance, out double area, out Point3d centroid)
Measure the area of an instance.
inherited fromITypeAssistant
Parameters:
instance (object)Instance to measure.
area (out double)Measured area.
centroid (out Point3d)Area centroid.
Returns: Success or failure.

AreaCentroid

#
bool AreaCentroid(T instance, out double area, out Point3d centroid)
Measure the area of an instance.
Parameters:
instance (T)Instance to measure.
area (out double)Measured area.
centroid (out Point3d)Area centroid.
Returns: Success or failure.

BoundingBox

BoundingBox BoundingBox(object instance)
Gets the world aligned boundingbox for an instance.
inherited fromITypeAssistant
Parameters:
instance (object)Instance to measure.
Returns: BoundingBox.

BoundingBox

#
BoundingBox BoundingBox(T instance)
Gets the world aligned boundingbox for an instance.
Parameters:
instance (T)Instance to measure.
Returns: BoundingBox.

ClosestPoint

bool ClosestPoint(object instance, Point3d locus, out Point3d site)
Gets the point on an instance closest to a locus point.
inherited fromITypeAssistant
Parameters:
instance (object)Instance to examine.
locus (Point3d)Locus (search) point.
site (out Point3d)Point on instance closest to locus.
Returns: Success or failure.

ClosestPoint

#
bool ClosestPoint(T instance, Point3d locus, out Point3d site)
Gets the point on an instance closest to a locus point.
Parameters:
instance (T)Instance to examine.
locus (Point3d)Locus (search) point.
site (out Point3d)Point on instance closest to locus.
Returns: Success or failure.

Copy

object Copy(object instance)
Create an exact duplicate of an instance.
inherited fromITypeAssistant
Parameters:
instance (object)Instance to duplicate.
Returns: Duplicate.

Copy

#
T Copy(T instance)
Create an exact duplicate of an instance.
Parameters:
instance (T)Instance to duplicate.
Returns: Duplicate.

Deform

object Deform(object instance, SpaceMorph morph)
Morph an instance of T.
inherited fromITypeAssistant
Parameters:
instance (object)Instance to morph.
morph (SpaceMorph)Morping class.
Returns: Morphed object.

Deform

#
object Deform(T instance, SpaceMorph morph)
Morph an instance of T.
Parameters:
instance (T)Instance to morph.
morph (SpaceMorph)Morping class.
Returns: Morphed object.

DescribePrimary

string DescribePrimary(IPear pear)
Give the primary description of a value. This does not need to yield a parsable string, the results are meant only for human consumption.
inherited fromITypeAssistant
Parameters:
pear (IPear)Pear to describe.

DescribePrimary

#
string DescribePrimary(Pear<T> pear)
Give the primary description of a value. This does not need to yield a parsable string, the results are meant only for human consumption.
Parameters:
pear (Pear<T>)Pear to describe.

DescribeSecondary

string DescribeSecondary(IPear pear)
Give the secondary description of a value. The secondary description may elaborate on the value. This method may always return null.
inherited fromITypeAssistant
Parameters:
pear (IPear)Pear th describe.

DescribeSecondary

#
string DescribeSecondary(Pear<T> pear)
Give the secondary description of a value. The secondary description may elaborate on the value. This method may always return null.
Parameters:
pear (Pear<T>)Pear th describe.

Draw

void Draw(IPear pear, DisplayBag bag)
Add a shape to a display bag.
inherited fromITypeAssistant
Parameters:
pear (IPear)(value, meta) pear to display.
bag (DisplayBag)Bag to populate.

Draw

#
void Draw(Pear<T> pear, DisplayBag bag)
Add a shape to a display bag.
Parameters:
pear (Pear<T>)(value, meta) pear to display.
bag (DisplayBag)Bag to populate.

Format

string Format(object instance)
Format an instance so that it yields parsable text.
inherited fromITypeAssistant
Parameters:
instance (object)Instance to format.

Format

#
string Format(T instance)
Format an instance so that it yields parsable text.
Parameters:
instance (T)Instance to format.

FurthestPoint

bool FurthestPoint(object instance, Point3d locus, out Point3d site)
Gets the point on an instance furthest away from a locus point.
inherited fromITypeAssistant
Parameters:
instance (object)Instance to examine.
locus (Point3d)Locus (search) point.
site (out Point3d)Point on instance furthest from locus.
Returns: Success or failure.

FurthestPoint

#
bool FurthestPoint(T instance, Point3d locus, out Point3d site)
Gets the point on an instance furthest away from a locus point.
Parameters:
instance (T)Instance to examine.
locus (Point3d)Locus (search) point.
site (out Point3d)Point on instance furthest from locus.
Returns: Success or failure.

Hash

int Hash(object instance)
Hash an instance of the object. The default implementation calls GetHash() on the instance.
inherited fromITypeAssistant
Parameters:
instance (object)

Hash

#
int Hash(T instance)
Hash an instance.
Parameters:
instance (T)

Length

bool Length(object instance, out double length)
Measure the length of an instance.
inherited fromITypeAssistant
Parameters:
instance (object)Instance to measure.
length (out double)Measured length.
Returns: Success or failure.

Length

#
bool Length(T instance, out double length)
Measure the length of an instance.
Parameters:
instance (T)Instance to measure.
length (out double)Measured length.
Returns: Success or failure.

ModifyBakeAttributes

ObjectAttributes ModifyBakeAttributes(IPear pear, File3dm file, ObjectAttributes initial)
By overriding this method, the type implementor may add modifications to the attributes of objects baked to Rhino files. For example, vectors when baked require an arrowhead to be set at the curve end, and this must be specified via the object attributes.
inherited fromITypeAssistant
Parameters:
pear (IPear)The pear associated with the attributes.
file (File3dm)The Rhino 3dm file into which the geometry will be baked.
initial (ObjectAttributes)The attributes to be used.
Returns: Modified attributes.

ModifyBakeAttributes

ObjectAttributes ModifyBakeAttributes(IPear pear, RhinoDoc document, ObjectAttributes initial)
By overriding this method, the type implementor may add modifications to the attributes of objects baked to Rhino documents. For example, vectors when baked require an arrowhead to be set at the curve end, and this must be specified via the object attributes.
inherited fromITypeAssistant
Parameters:
pear (IPear)The pear associated with the attributes.
document (RhinoDoc)The Rhino document into which the geometry will be baked.
initial (ObjectAttributes)The attributes to be used.
Returns: Modified attributes.

ModifyBakeAttributes

#
ObjectAttributes ModifyBakeAttributes(Pear<T> pear, RhinoDoc document, ObjectAttributes initial)
By overriding this method the type implementor may add modifications to the attributes of objects baked via the ToGeometry(Pear<T>) implementation. For example, vectors when baked require an arrowhead to be set at the curve end, and this must be specified via the object attributes.
Parameters:
pear (Pear<T>)The pear associated with the attributes.
document (RhinoDoc)The Rhino document into which the geometry will be baked.
initial (ObjectAttributes)The attributes to be used.
Returns: Modified attributes.

Parse

IResult Parse(string constructor, string text, IPear existing)
Parse a text representation with an optional pre-existing value.
inherited fromITypeAssistant
Parameters:
constructor (string)Constructor code. Will be null if the source text was not part of constructor notation.
text (string)Text to parse.
existing (IPear)Pre-existing instance, or null if no such instance exists yet.
Returns: Result of parsing attempt.

Parse

#
Result<T> Parse(string constructor, string text, Pear<T> existing)
Parse a text representation with an optional pre-existing value.
Parameters:
constructor (string)Constructor code. Will be null if the source text was not part of constructor notation.
text (string)Text to parse.
existing (Pear<T>)Pre-existing instance, or null if no such instance exists yet.
Returns: True on success, false on failure.

Pick

bool Pick(IPear existing, out IPear pear)
Ask the user to specify (or pick) a new value. When this method is invoked, it is assumed that it will start a RhinoGet operation or otherwise pop some kind of UI on the screen.
inherited fromITypeAssistant
Parameters:
existing (IPear)Existing pear to overwrite.
pear (out IPear)Pear which was picked.
Returns: True if a value was picked.

Pick

#
bool Pick(Pear<T> existing, out Pear<T> pear)
Ask the user to specify (or pick) a new value. When this method is invoked, it is assumed that it will start a RhinoGet operation or otherwise pop some kind of modal UI onto the screen.
Parameters:
existing (Pear<T>)Existing pear to be replaced, if any.
pear (out Pear<T>)Pear which was picked.
Returns: True if a value was picked.

Read

bool Read(IReader reader, Name location, out object instance)
Read an instance from a GrasshopperIO archive.
inherited fromITypeAssistant
Parameters:
reader (IReader)Deserialization reader.
location (Name)Location of data. Whether the location points to an item or child node is up to the implementer to decide.
instance (out object)Deserialized instance.
Returns: Success or failure.

Read

#
bool Read(IReader reader, Name location, out T instance)
Read an instance from a GrasshopperIO archive.
Parameters:
reader (IReader)Deserialization reader.
location (Name)Location of data. Whether the location points to an item or child node is up to the implementer to decide.
instance (out T)Deserialized instance.
Returns: Success or failure.

Same

bool Same(object a, object b)
Compare two instances for equality.
inherited fromITypeAssistant
Parameters:
a (object)
b (object)

Same

#
bool Same(T a, T b)
Compare two values for equality.
Parameters:
a (T)
b (T)

Show

IValueDisplay Show(IPear pear)
Create a Grasshopper display proxy.
inherited fromITypeAssistant
Parameters:
pear (IPear)(value, meta) pear to display.
Returns: Display proxy.

Show

#
IValueDisplay Show(Pear<T> pear)
Create a Grasshopper display proxy.
Parameters:
pear (Pear<T>)(value, meta) pear to display.
Returns: Display proxy.

Sort

int Sort(object a, object b)
Compare the sort order of two instances.
inherited fromITypeAssistant
Parameters:
a (object)
b (object)

Sort

#
int Sort(T a, T b)
Compare two values for sorting order.
Parameters:
a (T)
b (T)

Test

bool Test(object instance, out string invalidReason)
Determine the validity of an instance.
inherited fromITypeAssistant
Parameters:
instance (object)Instance.
invalidReason (out string)If the instance is not valid, the problem description will be returned here.
Returns: True if the instance is valid, false if otherwise.

Test

bool Test(object instance)
Determine the validity of an instance.
inherited fromITypeAssistant
Parameters:
instance (object)Instance.
Returns: True if the instance is valid, false if otherwise.

Test

#
bool Test(T instance, out string invalidReason)
Determine the validity of an instance.
Parameters:
instance (T)Instance.
invalidReason (out string)If the instance is not valid, the problem description will be returned here.
Returns: True if the instance is valid, false if otherwise.

Test

#
bool Test(T instance)
Determine the validity of an instance.
Parameters:
instance (T)Instance.
Returns: True if the instance is valid, false if otherwise.

Text

Prose.Text Text(object instance)
Create a Prose.Text which can function as a comparison stand-in for this value for the purposes of sorting. Particularly when it comes to sorting values of different types.
inherited fromITypeAssistant
Parameters:
instance (object)Instance.

Text

#
Prose.Text Text(T instance)
Create a string which can function as a sorting key for this value.
Parameters:
instance (T)Instance.
Returns: String to be used as a sorting key.

ToGeometry

IEnumerable<GeometryBase> ToGeometry(IPear pear)
Convert a pear into a collection of Rhino compliant geometries. This is used primarily for the standard baking of geometric data.
inherited fromITypeAssistant
Parameters:
pear (IPear)Pear to convert.
Returns: A collection of zero or more Rhino document compliant shapes.

ToGeometry

#
IEnumerable<GeometryBase> ToGeometry(Pear<T> pear)
Convert a pear into a collection of Rhino compliant geometries. This is used primarily for the standard baking of geometric data.
Parameters:
pear (Pear<T>)Pear to convert.
Returns: A collection of zero or more Rhino document compliant shapes.

Transform

object Transform(object instance, Transform matrix)
Transform an instance of T.
inherited fromITypeAssistant
Parameters:
instance (object)Instance to transform.
matrix (Transform)Transformation matrix.
Returns: Transformed object.

Transform

#
object Transform(T instance, Transform matrix)
Transform an instance of T.
Parameters:
instance (T)Instance to transform.
matrix (Transform)Transformation matrix.
Returns: Transformed object.

TransformBox

BoundingBox TransformBox(object instance, Transform transformation)
Gets the transformation aligned boundingbox for an instance.
inherited fromITypeAssistant
Parameters:
instance (object)
transformation (Transform)
Returns: BoundingBox.

TransformBox

#
BoundingBox TransformBox(T instance, Transform transformation)
Gets the transformation aligned boundingbox for an instance.
Parameters:
instance (T)
transformation (Transform)
Returns: BoundingBox.

Volume

bool Volume(object instance, out double volume)
Measure the volume of an instance.
inherited fromITypeAssistant
Parameters:
instance (object)Instance to measure.
volume (out double)Measured volume.
Returns: Success or failure.

Volume

#
bool Volume(T instance, out double volume)
Measure the volume of an instance.
Parameters:
instance (T)Instance to measure.
volume (out double)Measured volume.
Returns: Success or failure.

VolumeCentroid

bool VolumeCentroid(object instance, out double volume, out Point3d centroid)
Measure the volume of an instance.
inherited fromITypeAssistant
Parameters:
instance (object)Instance to measure.
volume (out double)Measured volume.
centroid (out Point3d)Volume centroid.
Returns: Success or failure.

VolumeCentroid

#
bool VolumeCentroid(T instance, out double volume, out Point3d centroid)
Measure the volume of an instance.
Parameters:
instance (T)Instance to measure.
volume (out double)Measured volume.
centroid (out Point3d)Volume centroid.
Returns: Success or failure.

Write

bool Write(IWriter writer, Name location, object instance)
Write an instance to a GrasshopperIO archive.
inherited fromITypeAssistant
Parameters:
writer (IWriter)Serialization writer.
location (Name)Location of data. Whether the location points to an item or child node is up to the implementer to decide.
instance (object)Instance to write.
Returns: Success or failure.

Write

#
bool Write(IWriter writer, Name location, T instance)
Write an instance to a GrasshopperIO archive.
Parameters:
writer (IWriter)Serialization writer.
location (Name)Location of data. Whether the location points to an item or child is up to the implementer to decide.
instance (T)Instance to write.
Returns: Success or failure.