RSX Code Reference
    Preparing search index...

    Class CarbonMaterialKeyWindow

    The CarbonMaterialKeyWindow implements a CarbonGraphKeyWindow to view and edit CarbonMaterialGraph resources.

    Hierarchy (View Summary)

    Index
    beginTutorial center clearUndoRedoHistory close createDefaultLayout createEditorWindow createTutorialFactory determineContentReadOnly didRedo didUndo dockDockableEditorWindow dockEditorWindow ensureMaterialPreviewData freezeDockableEditorWindow freezeEditorWindow getDockableEditorWindow getDockableLayout getScriptEditorWindow initializeInternal invalidateWindowTitle isUserListControlSupported isUsingMainToolBarStyle loadGraphResource loadState lockKeyWindow onActionTriggeredLockComments onActionTriggeredPlay onActionTriggeredRedo onActionTriggeredRevert onActionTriggeredSave onActionTriggeredUndo onActiveChanged onCloseRequested onDestroy onEditorUpdate onEditorUpdateLate onGraphRelease onGraphResourceChanged onInitialize onPlaybackToggled onPreviewMaterialCompileStateChanged onRedoCommand onUndoCommand onUndoOrRedoCommand onViewportSettingsModified onWindowDPIChanged onWindowFocusChanged onWindowResized openDockableEditorWindow openEditorWindow raise recompile recompilePreviewMaterial recreateOnModuleReload redo renderMaterialPreviewsAsync resetLayout resourceDidChangeDirtyState saveCarbonGraph saveGraphResource saveState screenToWindowPosition setDirtyState setDockableLayout setMaximumSize setMinimumSize setPosition setPositionInPixels setSize setSizeInPixels toggleToolbarItem undo unlockKeyWindow updateToolbarItemState updateToolbarItemStates willRedo willUndo windowToScreenPosition openTypeScriptInternal openWindow openWithGraph openWithGraphUUID openWithMaterial openWithMaterialUUID
    _animationPreviewWindow: CarbonAnimationGraphMeshPreviewWindow

    The window that inspects the loaded graph.

    _canvasWindow: GraphCanvasWindow

    The window that manages the preview of the loaded graph.

    _discussionWindow: ResourceDiscussionWindow

    The window that provides a discussion for the graph.

    The graph that is currently being edited.

    _inspectorWindow: GraphInspectorWindow

    The window that inspects the loaded graph.

    _isDirty: boolean
    _resourceHandle: ResourceHandle<Resource>

    The resource handle that is currently being edited.

    It is not required that the handle is a Graph. However, the load and save functions need to handle retrieving and stroing the graph instance in the resource. The example case that implements this is the CarbonMaterialKeyWindow which loads a CarbonMaterial that stores an CarbonMaterialGraph inside it.

    onLibraryEntryRemove: (entry: LibraryEntry) => void

    Called by the project library whenever a library entry is removed.

    Type Declaration

    onResourceDirtyChanged: (resource: Resource, isDirty: boolean) => void

    Invoked when a resource changed its dirty state.

    onResourceHandleChanged: (resourceHandle: ResourceHandle) => void

    Called by the resource manager whenever a resource is modified. If the active resource is modified, will rebuild the canvas.

    Type Declaration

      • (resourceHandle: ResourceHandle): void
      • Parameters

        • resourceHandle: ResourceHandle

          The handle to the resource that was modified.

        Returns void

    onSceneViewportRedrawRequested: (request: SceneViewportRedrawRequest) => void

    Invoked when a scene redraw request was received.

    • get dpiScale(): number

      Returns the DPI scale factor.

      Returns number

      The DPI scale is in relation to a 1x base resolution of 75 DPI.

    • get graph(): Graph

      The currently edited graph.

      Returns Graph

    • get graphCanvas(): UIGraphCanvas

      Active graph canvas exposed to editor integrations.

      Returns UIGraphCanvas

    • get height(): number

      Sets the height of the window in points.

      Returns number

    • set height(value: number): void

      Parameters

      • value: number

      Returns void

    • get heightInPixels(): number

      Sets the height of the window in pixels.

      Returns number

    • set heightInPixels(value: number): void

      Parameters

      • value: number

      Returns void

    • get icon(): Image

      Gets the icon for the window.

      Returns Image

    • set icon(value: Image): void

      Gets the icon for the window.

      Parameters

      Returns void

    • get isActive(): boolean

      Determines if the key window's tab is visible.

      Returns boolean

    • set isActive(value: boolean): void

      Parameters

      • value: boolean

      Returns void

    • get isDestroyed(): boolean

      Determines whether the window has been destroyed or not.

      Returns boolean

    • get isFocused(): boolean

      Checks whether the window currently has keyboard focus.

      Returns boolean

    • set isFocused(value: boolean): void

      Parameters

      • value: boolean

      Returns void

    • get isGraphDirty(): boolean

      Determines if the graph is dirty.

      Returns boolean

    • get isGraphModifiable(): boolean

      Determines whether the currently edited graph can be modified.

      Returns boolean

    • get isPlaybackActive(): boolean

      Determines if the graph is currently in play state.

      Returns boolean

    • get isPlaybackSupported(): boolean

      Determines if the current graph supports playback.

      Returns boolean

    • get keyWindow(): KeyWindowBase

      Gets the key window which owns this window.

      Returns KeyWindowBase

    • get left(): number

      Returns the X position of the window in screen coordinates in points.

      Returns number

    • get localShortcutContext(): ShortcutContext

      Specifies the local shortcut context. This context will be automatically disabled whenever the user switches focus from the context.

      Returns ShortcutContext

    • get owningContainerWindow(): EditorWindow

      Gets the window of the owning container. The owning container is window that serves as the host for one or multiple key windows.

      Returns EditorWindow

    • get position(): Immutable<rsx.UIPoint>

      Determines the position in which the key window is, in screen coordinates.

      Returns Immutable<rsx.UIPoint>

    • get renderWindow(): RenderWindow

      Gets the RenderWindow associated with this EditorWindow.

      Returns RenderWindow

    • get shortcutContext(): ShortcutContext

      Specifies the global shortcut context. This context will be always enabled as long as the window is active.

      Returns ShortcutContext

    • get styleSheet(): StyleSheet

      Sets the stylesheet for this window's UI surface.

      Returns StyleSheet

    • set styleSheet(value: StyleSheet): void

      Sets the stylesheet for this window's UI surface.

      Parameters

      Returns void

    • get toolBar(): UIToolBar

      Gets the primary tool bar element.

      Returns UIToolBar

    • get top(): number

      Returns the X position of the window in screen coordinates in points.

      Returns number

    • get ui(): UIPanel

      Returns UIPanel

    • get undoRedo(): UndoRedo

      Get the local undo redo of the key window.

      Returns UndoRedo

    • get width(): number

      Sets the width of the window in points.

      Returns number

    • set width(value: number): void

      Parameters

      • value: number

      Returns void

    • get widthInPixels(): number

      Sets the width of the window in pixels.

      Returns number

    • set widthInPixels(value: number): void

      Parameters

      • value: number

      Returns void

    • get windowTitle(): I18N

      Determines the human name to display on the window title or it's tab.

      Returns I18N

      A string that contains a human readable name for the key window.

    • set windowTitle(value: I18N): void

      Parameters

      Returns void

    • get current(): KeyWindow

      The currently active key window. Usually this value is null, but can be set to the current window inside an Update call or when calling an event callback for menu or toolbar items.

      Returns KeyWindow

    • Virtual

      A method called internally after the last action is redone.

      Returns void

    • Virtual

      A method called internally after the last action is undone.

      Returns void

    • Ensures that the material preview data is available.

      Returns boolean

      True if the material preview data was created, false if it already exists.

    • Virtual

      Loads the key window state to the one represented by state.

      Parameters

      • stateObject: any

      Returns void

    • Executes the last command on the redo stack (last command we called undo on), re-applying its operation.

      Returns void

    • Virtual

      Method to override to implement destruction of custom windows. Called by the engine before the window is destroyed.

      Returns void

    • Virtual

      Method to override to implement custom behavior of a window, called by the engine once per frame.

      Returns void

    • Virtual

      Method to override to implement custom behavior of a window, called by the engine once per frame, once all the windows had their onEditorUpdate() method called.

      Returns void

    • Virtual

      Method to override to implement initialization of custom windows. Called by the engine after window creation.

      Parameters

      Returns void

    • Invoked when the preview material compilation state changed.

      Parameters

      Returns void

    • Invoked when an undo or redo command was executed.

      Returns void

    • Virtual

      Triggered whenever the window gains or loses focus.

      Parameters

      • inFocus: boolean

        True if focus was gained, false otherwise.

      Returns void

    • Virtual

      Triggered whenever the window size changes.

      Parameters

      • width: number

        New width of the window in pixels.

      • height: number

        New height of the window in pixels.

      Returns void

    • Recompiles the graph and optionally updates the preview images.

      Parameters

      • compileMaterial: boolean
      • compilePreviewMaterial: boolean
      • Optionalforce: boolean

      Returns void

    • Recompiles the carbon preview material based on the current graph state.

      Parameters

      • OptionalisNewPreviewMaterial: boolean
      • OptionalisForced: boolean

      Returns void

    • Virtual

      Determines if the key window must be recreated when the specified module is being reloaded. This is an important task to do if the key window edits classes from the module that is being reloaded. In that case, the key window must be recreated - otherwise, it references outdated classes which results in undefined behavior that can destabilize the application.

      The following are possible modules:

      • rsx - rsx.Editor - rsx.Project - rsx.Project.Editor

      Parameters

      • moduleName: string

        The fully qualified name of the module to be reloaded.

      Returns boolean

    • Executes the last command on the redo stack (last command we called undo on), re-applying its operation.

      Returns void

    • Triggers a render of the material previews. If no previews are available, will compile and render.

      Returns Promise<any>

    • Invoked when the dirty state of the resource changed.

      Parameters

      • isDirty: boolean

        True if the resource is dirty.

      Returns void

      The dirty state represents whether any change happened on the resource that has not yet been persisted to disk.

    • Saves the graph to its resource location.

      Parameters

      • isUserConfirmationRequired: boolean

        Determines if the user has to confirm the save operation.

      • OptionalonSuccess: () => void

        Action called when the operation succeeds.

      • OptionalonFailure: () => void

        Action called when saving the scene failed, or the user declined to save.

      Returns void

    • Virtual

      Saves the current key window state. This state can be persisted to disk or saved in memory and later restored by calling LoadState().

      Returns any

      An object that represents the KeyWindow saved state.

    • Changes the dirty state of the resource.

      Parameters

      • isDirty: boolean

        True if the resource is dirty.

      Returns void

      The dirty state represents whether any change happened on the resource that has not yet been persisted to disk.

    • Defines the window maximum width and height in points.

      Parameters

      • maxWidth: number
      • maxHeight: number

      Returns void

    • Defines the window minimum width and height in points.

      Parameters

      • minWidth: number

        The minimum width of the window in points.

      • minHeight: number

        The minimum height of the window in points.

      Returns void

    • Moves the window on the desktop. Coordinates are in screen space using points.

      Parameters

      • x: number
      • y: number

      Returns void

    • Moves the window on the desktop. Coordinates are in screen space using pixels.

      Parameters

      • x: number
      • y: number

      Returns void

    • Resizes the window using a width and height in points.

      Parameters

      • width: number
      • height: number

      Returns void

    • Resizes the window using a width and height in pixels.

      Parameters

      • width: number
      • height: number

      Returns void

    • Toggles an existing toolbar button into an on or off state which changes the visuals of the button.

      Parameters

      • name: string

        Name of the existing button to toggle.

      • isToggled: boolean

        True to toggle on, false to toggle off.

      Returns void

    • Executes the last command on the undo stack, undoing its operations.

      Returns void

    • Toggles an existing toolbar button into an on or off state which changes the visuals of the button.

      Parameters

      • name: string

        Name of the existing button to toggle.

      Returns void

    • Virtual

      A method called internally before the last action is redone.

      Returns void

    • Virtual

      A method called internally before the last action is undone.

      Returns void

    • Opens and creates a new KeyWindow of the specified type. If state is not null, loadState is also called with the given value for state.

      Type Parameters

      Parameters

      • type: ClassOf<T>
      • Optionalstate: any

        An optional initial state for the key window.

      Returns T

      An instance to the newly created key window.

    onMaterialPreviewsRendered: Event<[RenderTexture], void>

    Invoked when the material previews were updated.

    onToolbarBuild: Event<[]>

    Event triggered when the toolbar is being built.

    onResize: Event<[]>

    Event triggered once the window is resized.

    onMove: Event<[]>

    Event triggered once the window is moved.

    onClose: Event<[]>

    Event triggered when the window is closed.

    onFocusChangedInternal: Event<[isFocused: boolean]>