Perspective Nodes
Character Perspectives: read and replace one character's view of a message.
2 nodes.
| Node | Registry path |
|---|---|
| Get Message View | scene/perspective/GetMessageView |
| Set Message View | scene/perspective/SetMessageView |
Get Message View
scene/perspective/GetMessageView
One character's view of a message in a Character Perspectives scene:
the account of the passage that character's memories and history use.
Outside Character Perspectives the status is unavailable.
Status values: ready, omitted (the character perceives nothing of it), pending, failed, unavailable, running (analysis runs now), deferred (an unkept version is shown), unsupported (the message type has no views), not_present.
Inputs
| Input | Type | Description |
|---|---|---|
message |
message_object |
(optional) the message (or give message_id) |
message_id |
int |
(optional) the message id (or give message) |
character |
str,character |
character name or character |
Outputs
| Output | Type | Description |
|---|---|---|
message_id |
int |
the message id |
character |
str |
the character name |
status |
str |
the view status |
text |
str |
the view text, or None |
editable |
bool |
True when Set Message View can replace it now |
reason |
str |
why the view cannot be edited, or None |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
message_id |
int |
0 |
message_id |
Set Message View
scene/perspective/SetMessageView
Replace one character's view of a message by hand, as the perspective panel does. Empty text means the character perceives nothing of it. Later views built on this one stay valid. Only in Character Perspectives scenes, and only while the view is editable (see Get Message View).
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
graph state (passthrough) |
message |
message_object |
(optional) the message (or give message_id) |
message_id |
int |
(optional) the message id (or give message) |
character |
str,character |
character name or character |
text |
str |
(optional) the new view text |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
graph state |
changed |
bool |
True when the stored view changed |
status |
str |
the view status after the change |
text |
str |
the view text after the change |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
message_id |
int |
0 |
message_id |
text |
text |
"" |
The new view text; empty omits the message for the character |