Text Menu Text MenuArtWonk modules can handle text as well as numbers. While most modules process numeric values, many - such as the switches - can process either numeric values or text strings. The String modules process text strings.
FileName ParseFName FilePath TxOpen TxSave TxNote TxClone TxParse
TxLine TxInsert TxDelete TxReplace TxSort TxFind
StrFind StrMerge StrInsert StrDelete StrTrim StrSubstr StrCase
StrInfo StrChange StrRand StrNumber StrTime
Supply a valid complete Windows file name for use in any module that requires one. Can be used interactively in real time by triggering the Strobe input, which causes a standard Windows File Open or Save dialog; or it can be preset with a file name set by a file dialog called from the Properties box, available by clicking on the top right blue-letter button on the module.
Output:
Out: Complete Windows path and file name.
Input:
Strb: Strobe to trigger a Windows file name dialog. Set whether it will be an open or save dialot, and what the file filters should be with the Properties button. Optionally, this input can be hidden by un-clicking the Properties box option, "Allow Dialog to be opened with input strobe."
Parses a full Windows path and file name into its parts: Disk drive, path, name, and extension.
Outputs:
Drive: Disk or Netwonk Drive or UNC part of file name.
Path: Path part of file name.
Name: Name part of file name.
Ext: Extension part of file name.
Inputs:
Text: Full file name to be parse.
Strb: Strobe to parse the file name.
Returns a file path and name. Use for special path names, such as ArtWonk\Patches or My Documents, or you can enter an arbitary text name.
Output:
TxOut: Completed full file path name.
Inputs:
Path: Text of arbitary path name, or enter a number for special path name: 0=ArtWonk, 1=current, 2=Patch, 3=Macro, 4=Function, 5=Array, 6=My Documents, 7=Desktop, 8=Graphics.
Name: Text of arbitary file name or enter 0 for the current patch name.
Ext: Text of file extension.
Opens a text file and reads it into an array of text lines. This module becomes the source for many of the other String modules. A text file is read into the module's internal text array (which is saved with the module, so you don't need to open the file after the first time), one line per array element. Other string manipulation modules can access this text array by means of the Hand output.
Outputs:
TxOut: Selected Text Line (0 based).
Max: Last line read, maximum text array address.
Hand: Handle for other text modules to use, to access the text array.
Inputs:
Line: Line address to output (update on change or reset).
Path: Path and name of text file to be opened.
Strb: Strobe to read the file.
Saves a text file of the text array in another text source module (TxOpen, TxNote, TxClone or TxParse). Each element of the source text is saved as a line in the text file, which mirrors how the file is read with TxOpen, above.
Caution: This module overwrites any existing file of the same name, and the previous file contents will be lost.
Outputs:
Stat: Status - non zero if error saving; 0 if OK.
Inputs:
Path: Path and name of text file to be saved.
Hand: Handle of the text modules to use, to save the text array.
Strb: Strobe to save the file.
Creates a text array from a text note pad, which is available when you open the Property dialog. You can type text into the pad, or paste it from the clipboard. Each line will become a line in the module's internal text array (which is saved with the module), one line per array element. Other string manipulation modules can access this text array by means of the Hand output.
Outputs:
TxOut: Selected Text Line (0 based).
Max: Maximum text array address.
Hand: Handle for other text modules to use, to access the text array.
Input:
Line: Line address to output (update on change or reset).
Makes a copy of the text array from another text source module (TxOpen, TxNote, TxClone or TxParse). A text array is copied to the module's own internal text array (which is saved with the module), one line per array element. Other string manipulation modules can access this text array by means of the Hand output.
Outputs:
TxOut: Selected Text Line (0 based).
Max: Maximum text array address.
Hand: Handle for other text modules to use, to access the text array.
Inputs:
Line: Line address to output (update on change or reset).
Hand: Handle of module to clone.
Strb: Strobe to copy text array from target.
Parses a line of text into a word array of one word per element. The resulting text array is stored in the module's own internal text array (which is saved with the module), one line per array element. Other string manipulation modules can access this text array by means of the Hand output.
Outputs:
TxOut: Selected text array element (0 based).
Max: Maximum text array address.
Hand: Handle for other text modules to use, to access the text array.
Inputs:
Word: Line/word address to output (update on change or reset).
Text: Text string to be parsed.
Strb: Strobe to parse text line into a word array.
Fetch a text line from a text source module.
Outputs:
TxOut: Selected Text Line (0 based).
Inputs:
Line: Line address to output (update on change or reset).
Hand: Handle of text source module.
Insert a text line into a text source module.
Outputs: (none)
Inputs:
Text: Text to insert into source module.
Line: Line address to insert text line (inserts ahead of existing text line).
Hand: Handle of text source module.
Strb: Strobe to insert the text line.
Delete a text line from a text source module.
Outputs: (none)
Inputs:
Line: Line address to delete in text source module.
Hand: Handle of text source module.
Strb: Strobe to delete the text line.
Replace a text line in a text source module.
Outputs: (none)
Inputs:
Text: Text to replace in source module.
Line: Line address to replace with text line.
Hand: Handle of text source module.
Strb: Strobe to replace the text line.
Sort text lines in a text source module.
Outputs: (none)
Inputs:
Desc: 1 = descending sort direction, 0 = ascending.
Case: 1 = case sensitive, 0 = ingore case.
Hand: Handle of text source module.
Strb: Strobe to sort the text lines in the source module.
Find a sub string within a text source module.
Outputs:
Line: Line address of string if found.
Posn: 1 based character position within line, 0 if not found.
Inputs:
Patrn: String pattern to search for.
Start: Line number to start the search.
Case: 1 = case sensitive, 0 = ingore case.
Hand: Handle of text source module.
Chng: Any change causes module to run the search.
Reports position of a string within a string.
Output:
Posn: 1 based character position within line, 0 if not found.
Inputs:
Text: Text string to search in.
Patrn: String pattern to search for.
Start: 1 based start of search.
Case: 1 = case sensitive, 0 = ingore case.
Back: 1 = search backward from end of string, 0 = forward from begining
Chng: Any change causes module to run the search.
Merge (concatenate) two strings.
Output:
TxOut: Concatenated string from TxIn1 + TxIn2.
Inputs:
Text1: 1st string to be concatenated.
Text2: 2nd string to be concatenated.
Chng: Any change causes input strings to be concatenated and sent to output.
Inserts string at position given into target string.
Output:
TxOut: New string.
Inputs:
TxSrc: Source string to receive insertion.
TxIns: Sub string to insert.
Posn: 1 based position to insert.
Chng: Any change causes input at TxIns to be inserted into TxSrc at Posn.
Deletes characters at given position in target string.
Output:
TxOut: New string.
Clip: Clipped sub string.
Inputs:
Text: Source string.
Posn: 1 based position to start clipping.
Num: Number of characters to delete.
Chng: Any change causes deletion of Num characters starting at Posn.
Trim white space from string.
Output:
TxOut: New string.
Inputs:
Text: Source string to be trimmed.
Trim: 0=trim left, 1=trim right, 2 = trim left & right.
Chng: Any change to do the trim.
Extracts a sub string at given position in target string.
Outputs:
TxOut: New string, substring extracted.
Size: Size of substring extracted..
Inputs:
Text: Source string.
Posn: 1 based position of start of substring to extract.
Num: Number of characters to extract.
Chng: Any change to extract substring.
Change case of source string.
Output:
TxOut: New string.
Inputs:
Text: Source string.
Case: 0 = Upper, 1 = Lower, 2 = 1st char upper, others lower.
Chng: Any change produces specified case change.
Get information about a string.
Output:
Out: Specified string information.
Inputs:
Text: Source string.
Info: 0=length, 1=Xor checksum, 2=hashcode, 3=convert text number to numeric value.
0=length: returns the number of characters in the string.
1=Xor checksum: return the checksum derived by xoring each character.
Useful for testing if a string is unique. This is the technique used in many
MIDI SysEx checksums.
2=hashcode: returns a 16 bit hashcode. Useful for determining string
uniqueness.
3=convert text number to numerical value: This will test the input
string to determine if it can be converted to a decimal or hexadecimal number.
If it can, the numeric value of the string is sent to the output. If the string
cannot be converted to a number, the output is not changed. Use the StrNumber
module to convert the other way, from a number to a string.
4=ANSI code: return ANSI code for 1st char in string.
Chng: Any change returns the specified string information.
Produces strobe and change output whenever text input changes.
Outputs:
Strb: Strobe when there is a text or numerical change in Text input.
Chng: Increments when there is a text or numerical change in Text input.
Input:
Chng: Text (or number) input to test for change.
Returns a string containing random, pronouncable text.
Output:
TxOut: Random string.
Inputs:
Num: Number of characters to return, 2 minimum.
Chng: Any change returns a new random string.
Converts a numeric value to a text string. Use the StrInfo module to convert the other way, from a string to a numeric value.
Output:
TxOut: Converted numeric value.
Inputs:
Num: Numeric value to be converted to a text string.
Hex: Type of conversion: 0=Decimal, 1=Hex, 2=Padded Hex, 3=ANSI Character, 99.99 = Format Decimal
To format decimal, enter the format number into the Hex input, with a "9" for each number place. This will pad with 0's. You may omit any combination of 9's to the left or right of the decimal point, and you may omit the decimal point for integer-only pading.
Returns formatted time from seconds.
Output:
TxOut: New string.
Inputs:
Time: Time value in seconds.
Scale: Time scale: 1 for seconds, 1000 for milliseconds, etc.
Chng: Any change returns formatted time string.
ArtWonk is Copyright © 2003-2007 by John Dunn and Algorithmic Arts. All Rights Reserved.