Go back to the downloads page

TextMixer Help

Introduction

TextMixer enables you to mix text, or more pricesely lines of text, from many textboxes (the name source is used in the program). See the examples below to get more understanding of what the program does.

Concepts

  • A source is only a textbox where you enter lines of text. You can add or delete sources as you like but you have to have at least one source at any given time. In other words you can delete all sources until you only have one source left, that you won't be able to delete.
  • The format string is a textbox where you can type any text you want (including special sequence of characters that will be replaced by lines of text from the sources), the text in the format string textbox will be generated for every line of text in the sources (see the examples below to get more understanding)
  • You move between sources by using the '< Prev' and 'Next >' buttons.
  • The current source is the source whose number is shown in the sources pane (in the format Source x of y, where x is the current source), e.g. if you have 7 sources and the sources pane shows Source 2 of 7 then source 2 is the current source.
  • To add a new source click the Add button (the new source will always be added at the end. e.g. if you have 5 sources and the currently selected source is 3 a new source numbered 6 will be added, in other words the new source will not be added directly after or before the current source it always be added after all sources)
  • To delete a source click the Delete button, the current source will be deleted (take care as this will change the number of sources after the deleted sources, e.g. if you have 7 sources and you delete source number 5, source number 6 will be source number 5 and source number 7 will be source number 6, so you'll have to change the source numbers in the format string if those sources are used)

Special Sequences

  • #@@# always refers to the current source and will be replaced by the currently processed line in the current source.
  • #@SourceNumber@# (where SourceNumber is the number of the source from which you want to use lines of text) refers to that source and will be replaced by the currently processed line in that source (e.g. #@2@# refers to the second source)
  • #@# is the order of the current line being processed
  • #++@# or #@++# is the order of the current line being processed plus one
  • #--@# or #@--# is the order of the current line being processed minus one

Examples

Example 1:

Enter this text in the current source (source 1 of 1):
New York
Sydney
Los Angeles
Tokyo

Now enter this text in the Format String textbox:
#@@# is one of the big cities in the world.

Finally click the Mix Text button and see the results in the Generated Text textbox.

Example 2:

Add another source by clicking the Add button. Now enter this text in source 1:
John
Michael
Janet

And this text in source 2:
Australia
Canada
USA

In the Format String textbox enter:
Hi there, this is #@1@# from #@2@#

Now click the Mix Text button and see the results in the Generated Text textbox.

Notes

  • Using #@@# in the format string will always use the text in the current source.
  • If one of the sources used in the format string contains more lines than the other sources the generated text will contains as many lines as in this source and for those lines of text with no corresponding lines in the other sources an empty string will be used.
  • Clicking the Copy to Clipboard button will copy the text from the Generated Text textbox to the clipboard, so if you modify the text in the Generated Text textbox before clicking the Copy to Clipboard button the modified text will be copied to the clipboard.
  • You can use #@@# along with #@SourceNumber@# (e.g. #@1@#). #@@# will always be replaced with text from the current source and #@SourceNumber@# will always be replaced with text from the source referred to.
  • If you use #@SourceNumber@# for a source that doesn't exist (e.g. #@17@# where source 17 doesn't exist), the same sequence of characters will show in the generated text (e.g. #@17@# will show in the Generated Text)


Go back to the downloads page

This page was last updated on Dec 3, 2007