Skip to main content

Shuffle String Manipulator

Intro​

Rearrange the characters within text strings.

UI​

Mode - Determine which part of the string is shuffled:

  • All - Shuffle the entire string.
  • Regex - Shuffle strings that match a regular expression.

Regex - When Mode is set to Regex, enter a Regular Expression. The result of the expression will be returned by the String Manipulator. See Working with Regex for more information.

Capture Group Indices - When Mode is set to Regex, and where a Regular Expression includes capture groups, determine which groups are returned. Values should be comma , separated for lists or colon : separated for ranges. See Working with Regex for more information.

Grouping - Determine which part of the String is affected by the Percentage value:

  • Word - A Percentage value of 50 will result in half of each word being scrambled
  • Line - A Percentage value of 50 will result in half of each line being scrambled. Note that a line is defined by a 'line break' and not wrapping within a Text Box.
  • Paragraph - A Percentage value of 50 will result in half of each paragraph being scrambled.
  • Document - A Percentage value of 50 will result in half the document being scrambled.

Percentage - The percentage of the string that will be shuffled.

Time Offset - Offset any animation on a 'per group' basis. For example, connect a Behaviour like Stagger to create a word-by-word shuffle.

Direction Mode - Determine how a Group is scrambled:

  • Start - Shuffle from the beginning of the string. A Percentage of 50 will result in the first half of the word/line/paragraph/document being shuffled.
  • End - Shuffle from the end of the string. A Percentage of 50 will result in the second half of the word/line/paragraph/document being shuffled.
  • Random - Shuffle each Group's string randomly.

Shuffle Type - Determine the shuffle method:

  • Unicode Offset - Offset the letters by a unicode code point. For example, an offset of 1 will result in an a character being shuffled to b. This mode is useful for non-latin characters.
  • Random Alphanumeric - Shuffle using alphanumeric characters.
  • Custom String - Shuffle from the original string using only the characters entered into the Custom String attribute.

Unicode Offset - The number of code points to offset when Shuffle Type is set to Unicode Offset

Keep Punctuation - When checked, Space characters and/or any punctuation marks (.,- etc) will not be shuffled if the Shuffle Type is set to Unicode Offset.

Random Seed - Change the seed used to randomise the shuffle.

Custom String - When Shuffle Type is set to Custom String, use the characters from the string entered here instead.