Graphics.UI.Sifflet.Canvas

Documentation

atLeastSize :: Size -> VCanvas -> VCanvas

Return a canvas of at least the specified size and otherwise like the given canvas.

cfContext :: CanvFrame -> ToolContext

connect :: VCanvas -> Node -> WEdge -> Node -> WEdge -> IO VCanvas

Connect nodes. If parent and child are different, connect the i-th inlet of node parent to the o-th outlet of node child UNLESS doing so would create a cycle parent -> child -> ... -> parent AND UNLESS something is already connected to the ith inlet of the parent node.

defaultFileSaveClipBox :: VCanvas -> BBox

disconnect :: VCanvas -> Node -> WEdge -> Node -> WEdge -> IO VCanvas

Disconnect nodes. Disconnect wouldn't need to be in the IO monad, except that it needs the same type signature as connect.

drawCanvas :: VCanvas -> Rectangle -> IO ()

Draw the canvas in its window, on screen

editFunction :: VCanvas -> CanvFrame -> IO VCanvas

editFunction: reverse of defineFunction: replace the call frame by an edit frame; does not change the VPUI (global env.), just the canvas..

frameChanged :: VCanvas -> WGraph -> CanvFrame -> WGraph -> CanvFrame -> IO ()

nodeContainerFrame :: VCanvas -> WGraph -> Node -> CanvFrame

pointSelection :: WGraph -> CanvFrame -> Position -> Maybe Selection

What is selected (if anything) at a point

renderCanvas :: VCanvas -> BBox -> Bool -> Render ()

Render the canvas in Cairo (use with renderWith to provide an alternate surface, such as an SVG file).

vcAddFrame :: VCanvas -> Functoid -> Maybe [Value] -> FrameType -> Env -> Double -> Double -> Double -> Maybe Node -> IO VCanvas

Add a frame representing a functoid to the canvas.

Use mvalues = Nothing if you do not want the frame to be evaluated as a function call, otherwise mvalues = Just values.

prevEnv is *supposed* to be the previous environment, i.e., that of the "parent" frame or the canvas, not of the new frame, because vcAddFrame itself will extend the environment with the new (vars, values). But this is odd, because openNode calls vcAddFrame apparently with the *new* environment as prevEnv, and yet it works correctly.

Caution: I think it is necessary for the canvas to have been realized before calling this function!

vcClearSelection :: VCanvas -> IO VCanvas

Make nothing be selected

vcClearFrame :: VCanvas -> CanvFrame -> IO VCanvas

vcClearFrame - clear a frame in a canvas; not yet implemented What does this mean?

vcCloseFrame :: VCanvas -> CanvFrame -> IO VCanvas

Close a frame and any subframes of it

vcEvalDialog :: VCanvas -> CanvFrame -> IO VCanvas

vcFrameAddFunctoidNode :: VCanvas -> CanvFrame -> Functoid -> Double -> Double -> IO VCanvas

vcFrameAddNode :: VCanvas -> CanvFrame -> ExprNode -> [String] -> Double -> Double -> IO VCanvas

vcFrameDeleteNode :: VCanvas -> CanvFrame -> Node -> IO VCanvas

vcFrameDeleteTree :: VCanvas -> CanvFrame -> Node -> IO VCanvas

Remove the (sub)tree rooted at the given node. Removes it from the graph of the canvas and from the FunctoidParts of the frame.

vcFrameSubframes :: VCanvas -> CanvFrame -> [CanvFrame]

Find a frame's subframes, i.e., those that were expanded to trace the execution of a function call. Cannot be in an edit frame.

vcGetFrame :: VCanvas -> WGraph -> Node -> CanvFrame

vcInvalidateFrameWithParent :: VCanvas -> WGraph -> CanvFrame -> IO ()

vcInvalidateBox :: VCanvas -> BBox -> IO ()

vcUpdateFrameAndGraph :: VCanvas -> CanvFrame -> WGraph -> VCanvas

Ask the vcanvas to update the frame and install a new graph. Frames are identified by their frame nodes, so the new frame must have the same frame node as the old. It is an unreported error if there is not exactly one match.

vcanvasNew :: Style -> Double -> Double -> IO VCanvas

vcanvasNodeAt :: VCanvas -> Position -> Maybe Node

Find the node, if any, at a given position on the canvas.

vcanvasNodeRect :: VCanvas -> Node -> Rectangle

whichFrame :: VCanvas -> Double -> Double -> Maybe CanvFrame

callFrames :: VCanvas -> String -> [CanvFrame]

Find the frames that are calling the named function