NarraLeaf

テキスト

接続された nl.text 要素の内容・タイポグラフィ・エフェクトの読み書きと、接続された nl.textInput の値

nl.text と nl.textInput は別々のウィジェットですが、3つのノード名を共有しています。この衝突が一目でわかるように、両方のファミリーをこのページにまとめています。すべての Element ノードに共通する規則は Element にあります。

Text

Text ノードは element:nl.text ピンを持つため、グラフが nl.text 要素をバインドしたときにのみパレットに提供されます。Get Text は画面に表示されている文字を読み取ります。Set Text、Append Text、Clear Text、Set All Properties が書き込んだ文字は、ページを開き直すまですべての言語で書き込んだとおりに表示され、Translation key(翻訳キー)や Blueprint Value より優先されます。規則は Self 形態と同じです。Self 形態は Text にあります。

パレットを一覧するとき、Get Font から Get Effects までの 9 つのスタイル取得ノードは Get Text Style(文字のスタイルを取得)、対応する設定ノードは Set Text Style(文字のスタイルを設定)として、紐づけられた要素ごとに 1 行で表示されます。配置したカードは、タイトルの横の ▾ で同じ種類の別のノードに切り替えられます。同じ種類のノードを参照してください。

Get Text

blueprint.element.text.getText · Pure

画面に表示されている文字を、プレイヤーの現在の言語で読み取ります。

ピン方向型備考
elementin · dataelement:nl.text
textout · datastring

Set Text

blueprint.element.text.setText · Latent

テキスト内容を置き換えます。

ピン方向型備考
inin · exec—
nextout · exec—
elementin · dataelement:nl.text
textin · datastringカード上のリテラルを受け付けます。

Append Text

blueprint.element.text.appendText · Latent

画面に表示されている文字の末尾に追加連結します。

ピン方向型備考
inin · exec—
nextout · exec—
elementin · dataelement:nl.text
textin · datastringカード上のリテラルを受け付けます。

Clear Text

blueprint.element.text.clearText · Latent

テキストを空文字列にします。

ピン方向型備考
inin · exec—
nextout · exec—
elementin · dataelement:nl.text

Get Font

blueprint.element.text.getFont · Pure

使用中のフォントアセット ID を読み取ります。

ピン方向型備考
elementin · dataelement:nl.text
fontAssetIdout · datastring

Set Font

blueprint.element.text.setFont · Latent

フォントアセット ID を設定します。空文字列を渡すとフォントがデフォルトに戻ります。

ピン方向型備考
inin · exec—
nextout · exec—
elementin · dataelement:nl.text
fontAssetIdin · datastringカード上のリテラルを受け付けます。

Get Font Size

blueprint.element.text.getFontSize · Pure

フォントサイズを読み取ります。

ピン方向型備考
elementin · dataelement:nl.text
fontSizeout · datafloat

Set Font Size

blueprint.element.text.setFontSize · Latent

フォントサイズを設定します。1 未満の値は 1 に引き上げられます。

ピン方向型備考
inin · exec—
nextout · exec—
elementin · dataelement:nl.text
fontSizein · datafloatカード上のリテラルを受け付けます。

Get Font Weight

blueprint.element.text.getFontWeight · Pure

フォントウェイトを読み取ります。

ピン方向型備考
elementin · dataelement:nl.text
fontWeightout · datastring

Set Font Weight

blueprint.element.text.setFontWeight · Latent

フォントウェイトを設定します:normal、600、bold のいずれか。それ以外の値はすべて normal にフォールバックします。

ピン方向型備考
inin · exec—
nextout · exec—
elementin · dataelement:nl.text
fontWeightin · datastringカード上のリテラルを受け付けます。

Get Text Color

blueprint.element.text.getTextColor · Pure

文字色を読み取ります。

ピン方向型備考
elementin · dataelement:nl.text
colorout · dataRGBAColor

Set Text Color

blueprint.element.text.setTextColor · Latent

文字色を設定します。

ピン方向型備考
inin · exec—
nextout · exec—
elementin · dataelement:nl.text
colorin · dataRGBAColor

Get Text Align

blueprint.element.text.getTextAlign · Pure

横方向の揃えを読み取ります。

ピン方向型備考
elementin · dataelement:nl.text
textAlignout · datastring

Set Text Align

blueprint.element.text.setTextAlign · Latent

横方向の揃えを設定します:left、center、right のいずれか。

ピン方向型備考
inin · exec—
nextout · exec—
elementin · dataelement:nl.text
textAlignin · datastringカード上のリテラルを受け付けます。

Get Text Vertical Align

blueprint.element.text.getTextVerticalAlign · Pure

縦方向の揃えを読み取ります。

ピン方向型備考
elementin · dataelement:nl.text
textVerticalAlignout · datastring

Set Text Vertical Align

blueprint.element.text.setTextVerticalAlign · Latent

縦方向の揃えを設定します:start、center、end のいずれか。

ピン方向型備考
inin · exec—
nextout · exec—
elementin · dataelement:nl.text
textVerticalAlignin · datastringカード上のリテラルを受け付けます。

Get Line Height

blueprint.element.text.getLineHeight · Pure

行の高さを読み取ります。

ピン方向型備考
elementin · dataelement:nl.text
lineHeightout · datafloat

Set Line Height

blueprint.element.text.setLineHeight · Latent

行の高さを設定します。0.1 未満の値は 0.1 に引き上げられます。

ピン方向型備考
inin · exec—
nextout · exec—
elementin · dataelement:nl.text
lineHeightin · datafloatカード上のリテラルを受け付けます。

Get Wrap Mode

blueprint.element.text.getWrapMode · Pure

折り返しモードを読み取ります。

ピン方向型備考
elementin · dataelement:nl.text
textWrapModeout · datastring

Set Wrap Mode

blueprint.element.text.setWrapMode · Latent

折り返しモードを設定します:word、character、nowrap のいずれか。

ピン方向型備考
inin · exec—
nextout · exec—
elementin · dataelement:nl.text
textWrapModein · datastringカード上のリテラルを受け付けます。

Get Effects

blueprint.element.text.getEffects · Pure

静的なテキストエフェクトを json として読み取ります。

ピン方向型備考
elementin · dataelement:nl.text
effectsout · datajson

Set Effects

blueprint.element.text.setEffects · Latent

静的なテキストエフェクトを書き込みます。

ピン方向型備考
inin · exec—
nextout · exec—
elementin · dataelement:nl.text
effectsin · datajson

Get All Properties

blueprint.element.text.getAllProperties · Pure

1回の読み取りで10個の出力を得ます。10個のノードを並べずにテキストの状態全体が欲しいときに。

ピン方向型備考
elementin · dataelement:nl.text
textout · datastring
fontAssetIdout · datastring
fontSizeout · datafloat
fontWeightout · datastring
colorout · dataRGBAColor
textAlignout · datastring
textVerticalAlignout · datastring
lineHeightout · datafloat
textWrapModeout · datastring
effectsout · datajson

Set All Properties

blueprint.element.text.setAllProperties · Latent

1回の呼び出しで10個すべてを書き込みます。どの入力も、何も解決しないときは要素の現在値にフォールバックするため、気にする2つだけを駆動しても安全です。

ピン方向型備考
inin · exec—
nextout · exec—
elementin · dataelement:nl.text
textin · datastringカード上のリテラルを受け付けます。
fontAssetIdin · datastringカード上のリテラルを受け付けます。
fontSizein · datafloatカード上のリテラルを受け付けます。
fontWeightin · datastringカード上のリテラルを受け付けます。
colorin · dataRGBAColor
textAlignin · datastringカード上のリテラルを受け付けます。
textVerticalAlignin · datastringカード上のリテラルを受け付けます。
lineHeightin · datafloatカード上のリテラルを受け付けます。
textWrapModein · datastringカード上のリテラルを受け付けます。
effectsin · datajson

Text Input

これらは nl.text ではなく nl.textInput を対象とし、パレット名は上の Text ノードと真正面から衝突します——Get Text が2つ、Set Text が2つ、Clear Text が2つ。両者を見分けるのはピンです——Text Input ノードは element:nl.textInput 型の textInput を取り、Text ノードは element:nl.text 型の element を取ります——実際には、パレットはグラフがすでに持つバインディングに一致する方だけを提供するため、各ペアのうち一方しか目にすることはありません。Self 形態は Text Input にあります。

Get Text

blueprint.element.textInput.getValue · Pure

フィールドの現在の値と長さを読み取ります。length は integer ではなく float として宣言されています。

ピン方向型備考
textInputin · dataelement:nl.textInput
valueout · datastring
lengthout · datafloat

Set Text

blueprint.element.textInput.setValue · Latent

フィールドの値を置き換えます。

ピン方向型備考
inin · exec—
nextout · exec—
textInputin · dataelement:nl.textInput
valuein · datastringカード上のリテラルを受け付けます。

Clear Text

blueprint.element.textInput.clear · Latent

フィールドの値を空文字列にします。

ピン方向型備考
inin · exec—
nextout · exec—
textInputin · dataelement:nl.textInput

このページの目次