TextureMapping

TextureMapping class

Represents a texture mapping.

Inheritence: Rhino.Runtime.CommonObjectRhino.DocObjects.ModelComponentTextureMapping
Derived Classes:

Namespace: Rhino.Render
TextureMapping: references

Constructors (2)

CommonObject()

Allows construction from inheriting classes.

CommonObject(SerializationInfo info, StreamingContext context)

Protected constructor for internal use.

Properties (34)

ComponentStatus

Gets or sets the component status of the model component.

ComponentType

Returns <b>ModelComponentType.TextureMapping</b> .

ComponentType

Gets the <b>ModelComponentType</b> for this object. Useful in switch statements.

DeletedName

Gets the name of a component that is deleted.

Disposed

Indicates if this object has been disposed or the document it originally belonged to has been disposed.

HasId

Returns a value indicating whether the component has an ID.

HasIndex

Returns a value indicating whether the component has an Index.

HasName

Returns a value indicating whether the component has a Name.

HasUserData

Gets True if this class has any custom information attached to it through UserData.

The unique Id for this texture mapping object.

Gets or sets the ID of the current instance.

IdIsLocked

Returns a value indicating whether the component ID is already locked.

Index

Gets or sets the model component index attribute.

IndexIsLocked

Returns a value indicating whether the component Index is already locked.

InstanceDefinitionModelSerialNumber

When a component is in a model as part of the information required for a linked instance definition, this value identifies the linked instance definition reference model.

IsComponentStatusLocked

The component status itself can be locked. This returns an indication.

IsDeleted

True if the component is deleted. Deleted components are kept by the document for undo purposes.

IsDocumentControlled

If True this object may not be modified. Any properties or functions that attempt to modify this object when it is set to "IsReadOnly" will throw a NotSupportedException.

IsReference

Gets a value indicting whether this component is a referenced component. Referenced components are part of referenced documents.

IsSystemComponent

True if this model component is a system constant.
An incomplete list of system constant model components is below:
<ul><li>ON_ModelComponent::Unset</li><li>ON_InstanceDefinition::Empty</li><li>ON_Linetype::Unset</li><li>ON_Linetype::Continuous</li><li>ON_Linetype::ByLayer</li><li>ON_Linetype::ByParent</li><li>ON_Layer::Unset</li><li>ON_Layer::Default</li><li>ON_TextStyle::Unset</li><li>ON_TextStyle::Default</li><li>ON_TextStyle::ByLayer</li><li>ON_TextStyle::ByParent</li><li>ON_DimStyle::Unset</li><li>ON_DimStyle::Default</li><li>ON_DimStyle::DefaultInchDecimal</li><li>ON_DimStyle::DefaultInchFractional</li><li>ON_DimStyle::DefaultFootInchArchitecture</li><li>ON_DimStyle::DefaultMillimeterSmall</li><li>ON_DimStyle::DefaultMillimeterLarge</li><li>ON_DimStyle::DefaultMillimeterArchitecture</li></ul>

IsValid

Tests an object to see if it is valid.

MappingType

Texture mapping type associated with this Mapping object.

ModelSerialNumber

A value identifying the model that manages this component.

Name

Gets or sets the name

NameIsLocked

Returns a value indicating whether the component Name is already locked.

NamePathSeparator

Returns the string "::". This is the string Rhino uses in layer full path names to separate the names of individual layers.

NormalTransform

For primitive based mappings, these transformations are used to map the world coordinate (x,y,z) point P and surface normal N before it is projected to the normalized mapping primitive. The surface normal transformation, m_Nxyz, is always calculated from m_Pxyz. It is a runtime setting that is not saved in 3dm files. If m_type is srfp_mapping, then m_Pxyz and m_Nxyz are ignored.

PerformCorruptionTesting

Used to test ON_Object* pointers to see if they are a brep or mesh that is corrupt enough to crash Rhino.

PrimativeTransform

PrimitiveTransform

ReferenceModelSerialNumber

When a component is in a model for reference, this value identifies the reference model.

UserData

List of custom information that is attached to this class.

UserDictionary

Dictionary of custom information attached to this class. The dictionary is actually user data provided as an easy to use shareable set of information.

UvwTransform

Transform applied to mapping coordinate (u,v,w) to convert it into a texture coordinate.

Methods (42)

ClearId()

Resets the HasId property of the model component to false, if possible.

ClearIndex()

Resets the HasIndex property of the model component to false, if possible.

ClearName()

Resets the HasName property of the model component to false, if possible.

ConstructConstObject(object parentObject, int subobjectIndex)

Assigns a parent object and a sub-object index to this.

CreateBoxMapping(Plane plane, Interval dx, Interval dy, Interval dz, bool capped)

Create a box projection texture mapping.

CreateCustomMeshMapping(Mesh mesh)

Create custom mesh mapping

CreateCylinderMapping(Cylinder cylinder, bool capped)

Create a cylindrical projection texture mapping.

CreateOcsMapping(Plane plane)

Create a Ocs texture mapping. Note that OCS mappings must be placed on mapping channel ON_ObjectRenderingAttributes::OCSMappingChannelId() otherwise they will not work.

CreatePlaneMapping(Plane plane, Interval dx, Interval dy, Interval dz, bool capped)

Create a planar projection texture mapping

CreatePlaneMapping(Plane plane, Interval dx, Interval dy, Interval dz)

Create a planar UV projection texture mapping

CreateSphereMapping(Sphere sphere)

Create a spherical projection texture mapping.

CreateSurfaceParameterMapping()

Create a mapping that will convert surface parameters into normalized(0,1)x(0,1) texture coordinates.

DataCRC(uint currentRemainder)

Increments the Cyclic Redundancy Check value by this instance.

Dispose()

Actively reclaims unmanaged resources that this instance uses.

Dispose(bool disposing)

For derived class implementers.
This method is called with argument True when class user calls Dispose(), while with argument False when the Garbage Collector invokes the finalizer, or Finalize() method.
You must reclaim all used unmanaged resources in both cases, and can use this chance to call Dispose on disposable fields if the argument is true.
Also, you must call the base virtual method within your overriding method.

EnsurePrivateCopy()

If you want to keep a copy of this class around by holding onto it in a variable after a command completes, call EnsurePrivateCopy to make sure that this class is not tied to the document. You can call this function as many times as you want.

Evaluate(Point3d p, Vector3d n, out Point3d t, Transform pXform, Transform nXform)

Evaluate the mapping to get a texture coordinate

Evaluate(Point3d p, Vector3d n, out Point3d t)

Evaluate the mapping to get a texture coordinate

FromBase64String(int archive3dm, int opennurbs, string base64Data)

Create a CommonObject instance from a Base64 encoded string. This is typically the values used when passing common objects around as JSON data

FromJSON(Dictionary<string, string> jsonDictionary)

Create a CommonObject instance from a JSON dictionary

FromJSON(string json)

Create a CommonObject instance from a JSON string

GetObjectData(SerializationInfo info,StreamingContext context)

Populates a System.Runtime.Serialization.SerializationInfo with the data needed to serialize the target object.

IsValidComponentName(string name)

Tests for a valid model component name.

IsValidWithLog(out string log)

Determines if an object is valid. Also provides a report on errors if this object happens not to be valid.

LockId()

Locks the component Id property.

LockIndex()

Locks the component Index property.

LockName()

Locks the component Name property.

ModelComponentTypeIgnoresCase(ModelComponentType type)

Informs the developer if a particular model component type will require case-ignoring searching within a document. This is currently True with groups; False otherwise.

ModelComponentTypeIncludesParent(ModelComponentType type)

Informs the developer if a particular model component type will include the hash of the parent.

ModelComponentTypeRequiresUniqueName(ModelComponentType type)

Informs the developer if a particular model component type will require uniqueness within a document. This is currently True with render materials and model geometry; False otherwise.

NonConstOperation()

For derived classes implementers.
Defines the necessary implementation to free the instance from being constant.

OnSwitchToNonConst()

Is called when a non-constant operation first occurs.

ToJSON(SerializationOptions options)

Create a JSON string representation of this object

ToString()

Returns the name of the model component type, and then its name and index.

TryGetMappingBox(out Plane plane, out Interval dx, out Interval dy, out Interval dz, out bool capped)

Get a box projection from the texture mapping, including capped information

TryGetMappingBox(out Plane plane, out Interval dx, out Interval dy, out Interval dz)

Get a box projection from the texture mapping.

TryGetMappingCylinder(out Cylinder cylinder, out bool capped)

Get a cylindrical projection parameters from this texture mapping.

TryGetMappingCylinder(out Cylinder cylinder)

Get a cylindrical projection parameters from this texture mapping.

TryGetMappingMesh(out Mesh mesh)

Get custom mapping mesh from this texture mapping.

TryGetMappingPlane(out Plane plane, out Interval dx, out Interval dy, out Interval dz, out bool capped)

Get plane mapping parameters from this texture mapping, including capping information

TryGetMappingPlane(out Plane plane, out Interval dx, out Interval dy, out Interval dz)

Get plane mapping parameters from this texture mapping.

TryGetMappingSphere(out Sphere sphere)

Get a spherical projection parameters from this texture mapping.

Nothing found