# Differences

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

Both sides previous revision Previous revision | |||

cfl_function_-_calculatelayoutonroll [2019/07/15 19:31] admin |
cfl_function_-_calculatelayoutonroll [2019/07/15 19:31] admin |
||
---|---|---|---|

Line 1: | Line 1: | ||

- | | + | **The CalculateLayoutOnRoll** function is used to determine how to layout prints, signs, or other dimensional items on a Roll (of indefinite length). This is commonly used to determine the amount of roll material that will actually be required to produce the item. |

- | | + | \\ \\ |

- | **The CalculateLayoutOnRoll** function is used determine how to layout prints, signs, or other dimensional items on a Roll (of indefinite length). This is commonly used to determine the amount of roll material that will actually be required to produce the item. | + | |

While it is possible to calculate these manually, doing so was complex. The need for this calculation occurred often enough to warrant this specialized function. | While it is possible to calculate these manually, doing so was complex. The need for this calculation occurred often enough to warrant this specialized function. | ||

+ | \\ \\ | ||

See Also [[:cfl_function_-_calculatelayoutonsheet|]] and [[:how-to_use_the_calculatelayoutonroll_function_for_layout_calculations|]]. | See Also [[:cfl_function_-_calculatelayoutonsheet|]] and [[:how-to_use_the_calculatelayoutonroll_function_for_layout_calculations|]]. | ||

+ | \\ \\ | ||

===== Function Usage ===== | ===== Function Usage ===== | ||

Line 13: | Line 11: | ||

These are complex functions that perform many calculations and can return many different values from the calculation. If the calculation perform without any errors, the function returns True. If there are any errors (such as division by zero), the function returns False and the error message is returned as one of the variable properties. | These are complex functions that perform many calculations and can return many different values from the calculation. If the calculation perform without any errors, the function returns True. If there are any errors (such as division by zero), the function returns False and the error message is returned as one of the variable properties. | ||

+ | \\ \\ | ||

- | ===== ===== | ||

===== Function Parameters ===== | ===== Function Parameters ===== | ||

Line 43: | Line 41: | ||

The values calculated by the layout function will be written into the "property bag" for the variable specified as the first function parameter. These values can then be accessed by name using the GetVariablePropertyValue() or GetVariablePropertyText() function. | The values calculated by the layout function will be written into the "property bag" for the variable specified as the first function parameter. These values can then be accessed by name using the GetVariablePropertyValue() or GetVariablePropertyText() function. | ||

- | ==== ==== | + | \\ \\ |

==== Variable Properties Set ==== | ==== Variable Properties Set ==== | ||

Line 65: | Line 63: | ||

|ErrorMessage||If an error occurs during the calculation, the formula will sets the Variable Property to False and the error message will be returned here. When there is no error in the calculation, this will set the Variable Property to an empty (blank) string.|| | |ErrorMessage||If an error occurs during the calculation, the formula will sets the Variable Property to False and the error message will be returned here. When there is no error in the calculation, this will set the Variable Property to an empty (blank) string.|| | ||

- | \\ | ||