Synchronet v3.21e-Win32 (install) has been released (Mar-2026).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
util:ans2asc [2020/07/15 17:48] – Fix copy past errors reported by alterego (ALTERANT) digital manutil:ans2asc [2026/01/27 18:43] (current) – Updated with all the current options and details on SAUCE usage digital man
Line 70: Line 70:
 ANS2ASC has the following command-line options: ANS2ASC has the following command-line options:
  
-| -clear | Insert a clear-screen code at the beginning of the output file |  +| -ice            | treat blink as bright-background (iCE colors) | 
-| -pause | Append a pause (hit a key) code to the end of the output file |  +| -<columns>      | insert conditional-newlines to force wrap (e.g. -80) | 
-| -delay <value> | Interval (in bytes) to insert a 1/10th second delay code - lower numbers equal "slower" files, delay value must be a positive non-zero integer |+| -normal         | use 'save/normal/restore' attributes for conditional new-lines | 
 +| -newline        | append a newline (CRLF) sequence to output file | 
 +| -clear          | insert a clear screen code at beginning of output file | 
 +| -pause          | append a pause (hit a key) code to end of output file | 
 +| -space          | use space characters for cursor-right movement/alignment | 
 +| -esc            | use C-style string literal escaping of control and CP437 chars | 
 +| -delay <int>    | insert a 1/10th second delay code at output byte interval (lower interval values result in more delays, slower display) | 
 + 
 +==== SAUCE ==== 
 + 
 +The ''-ice'' and ''-<columns>'' option values will be automatically read from the SAUCE metadata appended to the ANSI file, if present.
  
 ===== Animation ===== ===== Animation =====
Line 78: Line 88:
 In general, animated ANSI files cannot be converted to equivalent Ctrl-A files. Only cursor positioning ANSI sequences which can be converted to non-ANSI equivalents (e.g. cursor-right or cursor-down positioning) may be converted to Ctrl-A codes. If you see the following warning message from ANS2ASC, that indicates that you most likely are trying to convert an ANSI file with unsupported animation sequences: In general, animated ANSI files cannot be converted to equivalent Ctrl-A files. Only cursor positioning ANSI sequences which can be converted to non-ANSI equivalents (e.g. cursor-right or cursor-down positioning) may be converted to Ctrl-A codes. If you see the following warning message from ANS2ASC, that indicates that you most likely are trying to convert an ANSI file with unsupported animation sequences:
   Unsupported ANSI code 'x' (0xYY)"   Unsupported ANSI code 'x' (0xYY)"
 +  
 +However, unsupported color codes aren't usually an issue:
 +  Unsupported ANSI code 't' (0x74)
  
 Some ANSI editing programs will save ANSI files with unsupported cursor positioning sequences by default. To avoid saving unsupported cursor positioning sequences when using the **TheDraw**, for example, use the Block-Save feature. Some ANSI editing programs will save ANSI files with unsupported cursor positioning sequences by default. To avoid saving unsupported cursor positioning sequences when using the **TheDraw**, for example, use the Block-Save feature.

Trace: