Panel: Advanced Setup

The Advanced setup panel offers several sub sections of customisation options.

Warning

Use these parameters with care.

../_images/mapper_panel_m_m_adv_closed.jpg

The Advanced panel.

Subpanel: Object Names

../_images/mapper_panel_m_m_adv_objnames.jpg

The Object Names panel.

Button: Rename Objects

Rename all country objects in the M_Countries collection to the values found in the Socket Field Dropdown.

Note

  • Renaming will not affect socket values.

  • Renaming will not affect labels.

  • Renaming will change the name for three items only:

    1. The Object Name in the outliner.

    2. The Mesh Data Name for the Object.

    3. The Geometry Nodes Modifier Name.

    For this addon to funtion correctly these three items need to always have the same name.

  • By default Country names are in the ISO_A3 standard. i.e. United States of America = USA.

    • Choosing for example, the Long_Name Field will rename USA to United States of America.

  • If duplicates are found, for example when renaming by Continent (Africa) then country objects will be named Africa.001, Africa.002, etc.

Subpanel: Set Attributes

Here Key attribes needed for SMS Mapper to function correctly are set up.

../_images/mapper_panel_m_m_adv_attr.jpg

The Set Attributes panel.

Dropdown Menu: Socket Field

Select a Socket Field that contains the Attribute Values.

Button: Main Value

Assign the selected Socket Field as the Main Value.

Only accepts Integer or Float type values.

Note

This will update the following components:

  1. The value label assigned to each country object.

  2. The Min/Max Range needed for extrude by value.

  3. Connect the selected Socket Field to the Main_Value Input Socket of the M_Objects Geometry Node.

  4. Integer number types are automatically converted to float, but this might not always work. Socket types may be changed using the Change Socket Type button in the Input Sockets Setup Panel.

Button: Name Label

Assign the selected Socket Field as the Name Label.

Only accepts String type values.

Note

This will update the following components:

  1. The name label assigned to each country object.

  2. Connect the selected Socket Field to the Name_Label Input Socket of the M_Objects Geometry Node.

Button: Longitude

Assign the selected Socket Field as the Longitude coordinate.

Only accepts float type values.

Note

This will update the following components:

  1. The Longitude_X coordinate assigned to each country object.

  2. Placement of Name and Value labels

  3. Connect the selected Socket Field to the Longitude_X Input Socket of the M_Objects Geometry Node.

Button: Lattitude

Assign the selected Socket Field as the Lattitude coordinate.

Only accepts float type values.

Note

This will update the following components:

  1. The Lattitude_Y coordinate assigned to each country object.

  2. Placement of Name and Value labels

  3. Connect the selected Socket Field to the Lattitude_Y Input Socket of the M_Objects Geometry Node.

Key Frame

Add Keyframe (+): Add a keyframe on the selected Socket Field.

Recommended to only use with the Main Value, but other socket fields may be animated as per your use case.

Note

This will update the following components:

  1. Insert a keyframe on the selected Socket Field for each country object.

  2. Insert a keyframe on Value_Min and Value_Max.

Clear All Keyframes (×): Remove all keyframes.

Removes all keyframes on all Country objects for all frames.

Subpanel: Input Socket Setup

Here Key attribes needed for SMS Mapper to function correctly are set up.

../_images/mapper_panel_m_m_adv_inputs.jpg

The Set Attributes panel.

Dropdown Menu: Socket Field

Select a Socket Field that contains the Attribute Values.

Delete Inputs

Selected: Remove input socket from M_Master node.

Note

This will remove and disconnect the selected Input Socket for all Country Objects:

All: Remove input socket from M_Master node.

Note

This will remove and disconnect all Input Sockets for all Country Objects:

Change Socket Type

Warning

This might clear Socket Values:

Integer: Change selected socket type to integer (1, 2, -3).

Float: Change selected socket type to float (1.1, 2.8, -3.15).

String: Change selected socket type to string (Asia, Africa, Europe).

Reset Socket Values

Warning

This will clear Socket Values:

Zero Socket Values: Clear all Values for selected Socket Field.

Calculate Main Value Range

Note

Socket type must be float or integer:

Set Main Value Range: Recalculate Min/Max based on selected Socket Field.

Value_Main_Min: The main value minimum as calculated above.

Value_Main_Max: The main value maximum as calculated above.

Value_Main_Scale_Min: Scales the Main Value miminimum range.

Value_Main_Scale_Max: Scales the Main Value maximum range

Note

Use these scale values to set extrusion and translation limits on country objects.

Subpanel: Modifier Setup

Settings related to Geometry Node Modifiers on Country Objects.

../_images/mapper_panel_m_m_adv_mods.jpg

Remove Modifier: Removes the Mapper Geometry Nodes Modifier from each object in the collection M_Countries.

Remove All Modifiers: Removes all Modifiers from each object in the collection M_Countries.

Create Master Tree: Creates a new Mapper Modifier on each object in the collection M_Countries and assigns the M_Master node tree.

Remove Master Tree: Unlinks the the M_Master node tree from the Mapper Modifier on each object in the collection M_Countries.

Get Attributes Tree: Inserts the the M_Objects node tree into the M_Master Node tree.