# Data types ## String A text value. {% hint style="success" %} Extends Ruby [String](https://ruby-doc.org/core-2.5.1/String.html) class. {% endhint %} ## Integer An integer numeric value. {% hint style="success" %} Extends Ruby [Integer](https://ruby-doc.org/core-2.5.1/Integer.html) class. {% endhint %} ## Float A decimal value. {% hint style="success" %} Extends Ruby [Float](https://ruby-doc.org/core-2.5.1/Float.html) class. {% endhint %} ## Array A list of objects. {% hint style="success" %} Extends Ruby [Array](https://ruby-doc.org/core-2.5.1/Array.html) class. {% endhint %} ## Color An object that represent a color. {% hint style="success" %} Extends SketchUp [Color](https://ruby.sketchup.com/Sketchup/Color.html) class. *⚠️ Setter functions are disabled.* {% endhint %} ## ComponentDefinition An object that represents a SketchUp component definition. {% hint style="success" %} Extends SketchUp [ComponentDefinition](https://ruby.sketchup.com/Sketchup/ComponentDefinition.html) class. *⚠️ Setter functions are disabled.* {% endhint %}

Function	Description
`get_dc_attribute(key)`	Return the custom Dynamic Component attribute referenced by the `key` name

## ComponentInstance An object that represents a SketchUp component instance. {% hint style="success" %} Extends SketchUp [ComponentInstance](https://ruby.sketchup.com/Sketchup/ComponentInstance.html) class. *⚠️ Setter functions are disabled.* {% endhint %}

Function	Description
`get_dc_attribute(key)`	Return the custom Dynamic Component attribute referenced by the `key` name
`local_x`	Return the x coordinate relative to parent origin (Length)
`local_y`	Return the y coordinate relative to parent origin (Length)
`local_z`	Return the z coordinate relative to parent origin (Length)
`world_x`	Return the x coordinate relative to world origin (Length)
`world_y`	Return the y coordinate relative to world origin (Length)
`world_z`	Return the z coordinate relative to world origin (Length)

## Length A numeric value that represents a length. {% hint style="success" %} Extends SketchUp [Length](https://ruby.sketchup.com/Length.html) class. {% endhint %}

Operator	Description
`+`	`Length + Length` → (Length)
`*`	`Length * Length` → (Area) `Length * Area` → (Volume)

## Area A numeric value that represents an area. {% hint style="success" %} Extends all [Float](#float) properties and functions. {% endhint %}

Operator	Description
`+`	`Area + Area` → (Area)
`*`	`Area * Length` → (Volume)

Function	Description
`to_mm2`	Return area as float value in mm²
`to_cm2`	Return area as float value in cm²
`to_m2`	Return area as float value in mm²
`to_km2`	Return area as float value in km²
`to_inch2`	Return area as float value in inch²
`to_feet2`	Return area as float value in feet²
`to_mile2`	Return area as float value in mile²
`to_yard2`	Return area as float value in yard²

## Volume A numeric value that represents a volume. {% hint style="success" %} Extends all [Float](#float) properties and functions. {% endhint %}

Operator	Description
`+`	`Volume + Volume` → (Volume)

Function	Description
`to_mm3`	Return volume as float value in mm³
`to_cm3`	Return volume as float value in cm³
`to_m3`	Return volume as float value in mm³
`to_km3`	Return volume as float value in km³
`to_inch3`	Return volume as float value in inch³
`to_feet3`	Return volume as float value in feet³
`to_mile3`	Return volume as float value in mile³
`to_yard3`	Return volume as float value in yard³
`to_fbm`	Return volume as float value in FBM

## MaterialType An object that represents a material type.

Function	Description
`is_solid_wood?`	Return `true` if material type is Solid Wood
`is_sheet_good?`	Return `true` if material type is Sheet Good
`is_dimensional?`	Return `true` if material type is Dimensional
`is_hardware?`	Return `true` if material type is Hardware
`is_edge?`	Return `true` if material type is Edge
`is_veneer?`	Return `true` if material type is Veneer
`to_i`	Return material type as numeric value (Integer)

## Material An object that represents a material.

Property	Description
`name`	Return the name of the material (String)
`color`	Return the color of the material (Color)
`type`	Return the type of the material (MaterialType)
`description`	Return the description of the material (String)
`url`	Return the url of the material (String)
`std_dimension`	Return the standard dimension of the material (String)
`std_thickness`	Return the standard thickness of the material (Length)
`std_width`	Return the width of the material (Length)

Function	Description
`any?`	Return `true` if a material is applied
`empty?`	Return `true` if material is "no material"
`grained?`	Return `true` if material is grained

## Edge An object that represents an edge. {% hint style="success" %} Extends all [Material](#material) properties and functions. {% endhint %}

Property	Description
`material_name`	Alias to `name`
`material_color`	Alias to `color`

## Veneer An object that represent a veneer. {% hint style="success" %} Extends all [Material](#material) properties and functions. {% endhint %}

Property	Description
`material_name`	Alias to `name`
`material_color`	Alias to `color`

## Path An array of instance names. {% hint style="success" %} Extends all [Array](#array) properties and functions. {% endhint %} ## Batch

Properties	Description
`position`	(Integer)
`count`	(Integer)