Name
CopyTextObject -- clone a text object (V4.0)
Synopsis
[id] = CopyTextObject(source, dest)
Function
This function clones the text object specified by source and creates a copy of it as text object dest. If you specify Nil in the dest argument, this function will choose a vacant identifier for the cloned text object automatically and return it to you. The new text object is independent from the old text object so you could free up the source text object after it has been cloned.

Inputs
source
source text object identifier
dest
identifier of the text object to be created or Nil for auto ID select
Results
id
optional: identifier of the text object; will only be returned when you pass Nil as argument 2 (see above)
Example
CopyTextObject(1, 10)
FreeTextObject(1)
The above code creates a new text object 10 which contains the same graphics data as text object 1. Then it frees text object 1 because it is no longer needed.

Show TOC