# 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` (String) 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` (String) 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)

## --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.opencutlist.org/features/parts/formulas/data-types.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.