Moduprint/API/Methods: Difference between revisions

From Resonite Wiki
< Moduprint‎ | API
DeleteTab, DuplicateTab
ConfirmPackHandler, GetRegistry
Line 1: Line 1:
All methods listed here are accessible through slot [[Component:DynamicReferenceVariable|Dynamic Reference Variables]] named <code>Manager/Method.<i>name</i></code>.
All methods listed here are accessible through slot [[Component:DynamicReferenceVariable|Dynamic Reference Variables]] named <code>Manager/Method.<i>name</i></code>.
=== ConfirmPackHandler ===
Confirms that the selected pack handler is capable of packing the active tab on the print.
{| class="wikitable"
|+Context
|-
! Name !! Type !! !! Purpose
|-
| <code>PackHandler</code> || {{Template:TypeColorCard|Slot}} || Required || Pack handler.
|-
| <code>Print</code> || {{Template:TypeColorCard|Slot}} || Required || Print to pack.
|}
{| class="wikitable"
|+Result
|-
! Name !! Type !! Purpose
|-
| <code>Manager/Local.Result</code> || {{Template:TypeColorCard|bool}} || If the provided handler can pack the print.
|}


=== DeleteTab ===
=== DeleteTab ===
Line 39: Line 61:
|-
|-
| <code>Manager/Local.Result</code> || {{Template:TypeColorCard|Slot}} || Duplicated tab.
| <code>Manager/Local.Result</code> || {{Template:TypeColorCard|Slot}} || Duplicated tab.
|}
=== GetRegistry ===
Get a list of all registry entries. The result's slot children each have the slot Dynamic Variable <code>Entry</code>. Entries are ordered by priority from high to low. <b>The returned registry is read-only, use <code>Register</code> for adding entries.</b>
{| class="wikitable"
|+Context
|-
! Name !! Type !! !! Purpose
|-
| <code>Name</code> || {{Template:TypeColorCard|String}} || Required || Name of the registry.
|}
{| class="wikitable"
|+Result
|-
! Name !! Type !! Purpose
|-
| <code>Manager/Local.Result</code> || {{Template:TypeColorCard|Slot}} || Registry entries.
|}
|}



Revision as of 16:39, 4 August 2025

All methods listed here are accessible through slot Dynamic Reference Variables named Manager/Method.name.

ConfirmPackHandler

Confirms that the selected pack handler is capable of packing the active tab on the print.

Context
Name Type Purpose
PackHandler Slot Required Pack handler.
Print Slot Required Print to pack.
Result
Name Type Purpose
Manager/Local.Result bool If the provided handler can pack the print.

DeleteTab

Context
Name Type Purpose
Tab Slot Required Tab to be deleted.

DispatchEvent, DispatchAsyncEvent

The event data must have the name of the event. If it is defined on a module, the event name is automatically prefixed by the module ID as ID.event.

Context
Name Type Purpose
Event Slot Required Event data.

DuplicateTab

Context
Name Type Purpose
Tab Slot Required Tab to be duplicated.
Result
Name Type Purpose
Manager/Local.Result Slot Duplicated tab.


GetRegistry

Get a list of all registry entries. The result's slot children each have the slot Dynamic Variable Entry. Entries are ordered by priority from high to low. The returned registry is read-only, use Register for adding entries.

Context
Name Type Purpose
Name String Required Name of the registry.
Result
Name Type Purpose
Manager/Local.Result Slot Registry entries.

HideTabContent

Hides the tab's content. To set a tab active, use SetTabActive instead. This method is only useful for unpacking flux into multiple tabs.

Context
Name Type Purpose
Tab Slot Required Tab whose content should be hidden.

NewPrint

Creates a new print under the local user's space. Use NewPrintTab if you need the print to be created at a specific location.

Result
Name Type Purpose
Manager/Local.Result Slot The created print.

NewPrintAt

Creates a new print.

Context
Name Type Purpose
Parent Slot Optional The parent of the print, defaults to local user space.
Position float3 Optional Global Position.
Rotation floatQ Optional Global Rotation.
Scale float3 Optional Global Scale, defaults to 1.
Result
Name Type Purpose
Manager/Local.Result Slot The created print.

NewTab, NewActiveTab

Context
Name Type Purpose
Print Slot Required The print to create a new tab on.
Result
Name Type Purpose
Manager/Local.Result Slot The created tab.

NewTabWithContent

The tab content holder is created directly under the provided pack target slot.

Context
Name Type Purpose
Print Slot Required The print to create a new tab on.
Content Slot Required The content slot of the tab.
PackTarget Slot Optional Where the tab is parented to.
Result
Name Type Purpose
Manager/Local.Result Slot The created tab.

Register

Adds an entry to a registry. Prefer using Module/Lifecycle.Register for adding entries to a registry. This is only useful if you need to register something after the module was already installed. See Moduprint/API#Registries for more information.

Context
Name Type Purpose
Entry Slot Required Slot that should be registered.
Registry String Required Name of the registry this entry belongs to.
Priority String Optional Entry priority in the registry, see below.

SetTabActive

Context
Name Type Purpose
Tab/Print Slot Required The tab to set active or the print itself to set no tab active.

ShowTabContent

Shows the tab's content. To set a tab active, use SetTabActive instead. This method is only useful for unpacking flux into multiple tabs.

Context
Name Type Purpose
Tab Slot Required Tab whose content should be shown.

Snap

Context
Name Type Purpose
Print Slot Required The print to snap to.
Target Slot Required Object to snap to the print.
Result
Name Type Purpose
Manager/Local.Result String Default, Drop, Handled.

UnregisterAllByModule

Removes all entries from all registries that were created by a module. Prefer using Module/Lifecycle.Register for adding entries to a registry. This is automatically called when a module is uninstalled. You should not need to call this manually.

Context
Name Type Purpose
ID String Required Module ID.