SetMath - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


DocumentTools[Canvas][Script]

  

SetMath

  

set the contents of a math canvas element

 

Calling Sequence

Parameters

Description

Examples

Compatibility

Calling Sequence

SetMath(script,ex,options)

Parameters

script

-

DocumentTools:-Canvas:-Script object

ex

-

any math expression

keepannotation

-

(optional) truefalse; default is true

insert

-

(optional) truefalse; default is false

where

-

"below", "right", or "newgroup"

Description

• 

The SetMath command sets the contents of a math canvas element.  By default it will set the contents of the active container, or, when the where option is specified, a container relative to the active container.  

• 

When the where option is set to "below", and the current active position is a group, the math will be set at the next position within the group.  If something already occupies the next spot, it will be overwritten, unless the insert option is set to true, in which case the group contents will be bumped down to make room for the new expression.  If the active position is at the end of a group, a new area will be added to the group regardless of the insert option setting.  When the current position is a text area, a new group will be created below before inserting the math.

• 

When the where option is set to "right", a new group will be created to the right of the active element, into which the given expression, ex will be inserted.

• 

The where="newgroup" option is similar to where="below" except the math will always be inserted into a new group created below the current group or text area.

• 

The keepannotation option controls whether or not an existing annotation in the current active component should be cleared when the math expression is set.

• 

The insert setting is described above and only applies to the situation where math is being set "below" the active position of a group, and content already exists in the same group after that position.  When insert = true, room will be made to insert the new expression, as opposed to insert = false, where the behavior is to overwrite the expression that follows.

  

Note: insert=true is not currently supported for script actions within a Maple worksheet, but does apply to Maple Learn deployed scripts.

• 

A "canvas" is an interactive section of a Maple document created by the NewCanvas command, or a shared web-based Maple Learn document.  See the Script command for a more complete description.

  

Note: The initial canvas in a Maple worksheet is created with a fixed size.  Inserting math may exceed that size, which will result in an error.  The ShowCanvas command has a size option that will let you create a size that will better fit your example.

Examples

One Command at a Time

• 

In this example, we will insert a canvas and manually add math

withDocumentTools:-Canvas:

cvNewCanvasBlank Canvas:

ShowCanvascv

scScript:

• 

make the title the active element

SetActivesc,0:0

• 

create a new group below

SetMathsc,1,where=below

• 

change the math in the active area

SetMathsc,11

• 

create a new group to the right

SetMathsc,2,where=right

• 

create a new row in the current group

SetMathsc,3,where=below

• 

create a new group below

SetMathsc,4,where=newgroup

• 

create a blank entry

SetMathsc,,where=below

SetMathsc,6,where=below

• 

recreate the whole example with all of the script steps attached so that it can be played back in Maple Learn

cv2NewCanvasSetMath Example,sc:

ShareCanvascv2

Loop Example

• 

In this example, we will display the Fibonacci sequence up to the value specified in the canvas.   This will be done using only 9 display areas, wrapping around to the beginning when the 9th box has been displayed.

withDocumentTools:-Canvas:

cvNewCanvasFibonacci Sequence to: ,5000:

ShowCanvascv

scScript:

dataGetMath:

• 

the starting point is the title text

SetActivesc,0:0

foriwhilefibcombinat:-fibonaccii<data1:-mathdoifi<10thenSetMathsc&comma;fib&comma;where=belowelseSetActivesc&comma;2&comma;imod9;SetMathsc&comma;fibendif;Annotatesc&comma;ienddo

• 

recreate the whole example with all of the script steps attached so that it can be played back in Maple Learn

cv2NewCanvasFibonacci Sequence to &comma;5000&comma;sc&colon;

ShareCanvascv2

Compatibility

• 

The DocumentTools[Canvas][Script][SetMath] command was introduced in Maple 2021.

• 

For more information on Maple 2021 changes, see Updates in Maple 2021.

See Also

Math

NewCanvas

Script

SetActive

SetText