Pular para o conteúdo principal

raygeo.sketch.params

Named sketch parameters and expressions.

A parameter may be a number or a math expression. Expressions are resolved in multiple passes so they can reference parameters defined later, and unresolved expressions are reported through unresolved_errors(). The context serializes to the reference {'expressions': {...}} dictionary.

ParameterContext​

evaluate()​

evaluate(expression: Any) -> float

Evaluates an expression using the current parameters.

ParameterTypeDescription
expressionAny
Returnsfloat

evaluate_all()​

evaluate_all(initial_values: Optional[dict] = None) -> None

Resolves every expression, optionally seeded with initial values.

ParameterTypeDescription
initial_valuesOptional[dict] = None
ReturnsNone

from_dict()​

from_dict(dict: dict) -> ParameterContext

Deserializes a context from the reference dictionary shape.

ParameterTypeDescription
dictdict
ReturnsParameterContext

get()​

get(name: str, default: float = 0.0) -> float

Returns the evaluated value of a parameter.

ParameterTypeDescription
namestr
defaultfloat = 0.0
Returnsfloat

get_all_values()​

get_all_values() -> Any

Returns a copy of all evaluated parameter values.

ParameterTypeDescription
ReturnsAny

invalidate()​

invalidate() -> None

Clears cached values so the next access re-evaluates everything.

ParameterTypeDescription
ReturnsNone

set()​

set(name: str, value: Any) -> None

Sets a parameter from a number or an expression string.

ParameterTypeDescription
namestr
valueAny
ReturnsNone

to_dict()​

to_dict() -> dict

Serializes the context to the reference dictionary shape.

ParameterTypeDescription
Returnsdict

unresolved_errors()​

unresolved_errors() -> dict[str, str]

Expressions that remained unresolved during the last evaluation.

ParameterTypeDescription
Returnsdict[str, str]