Class NoesisPanel
NoesisGUI integration panel.
Inheritance
Implements
Inherited Members
Namespace: Evergine.NoesisGUI
Assembly: Evergine.NoesisGUI.dll
Syntax
public abstract class NoesisPanel : Behavior, IDependencyObject
Constructors
NoesisPanel()
Initializes a new instance of the NoesisPanel class.
Declaration
public NoesisPanel()
Fields
backgroundColor
Background color.
Declaration
protected Color backgroundColor
Field Value
Type | Description |
---|---|
Color |
clearFlags
Clear flags.
Declaration
protected ClearFlags clearFlags
Field Value
Type | Description |
---|---|
ClearFlags |
definedKeys
Defined keys.
Declaration
protected Array definedKeys
Field Value
Type | Description |
---|---|
Array |
flipY
Flip at Y axis.
Declaration
protected bool flipY
Field Value
Type | Description |
---|---|
bool |
frameworkElement
Xaml content.
Declaration
protected FrameworkElement frameworkElement
Field Value
Type | Description |
---|---|
FrameworkElement |
graphicsContext
The graphics context.
Declaration
[BindService(true)]
protected GraphicsContext graphicsContext
Field Value
Type | Description |
---|---|
GraphicsContext |
graphicsPresenter
The graphics presenter.
Declaration
[BindService(true)]
protected GraphicsPresenter graphicsPresenter
Field Value
Type | Description |
---|---|
GraphicsPresenter |
height
Panel height.
Declaration
protected uint height
Field Value
Type | Description |
---|---|
uint |
lastMouse
Last mouse position.
Declaration
protected Point lastMouse
Field Value
Type | Description |
---|---|
Point |
lastStyle
Last style name.
Declaration
protected string lastStyle
Field Value
Type | Description |
---|---|
string |
noesisService
The Noesis service.
Declaration
[BindService(false)]
protected NoesisService noesisService
Field Value
Type | Description |
---|---|
NoesisService |
ppaaEnabled
PPAA filter enabled.
Declaration
protected bool ppaaEnabled
Field Value
Type | Description |
---|---|
bool |
renderFlags
Render Flags.
Declaration
protected RenderFlags renderFlags
Field Value
Type | Description |
---|---|
RenderFlags |
renderer
Noesis renderer.
Declaration
protected Renderer renderer
Field Value
Type | Description |
---|---|
Renderer |
screenViewports
Screen viewports array.
Declaration
protected Viewport[] screenViewports
Field Value
Type | Description |
---|---|
Viewport[] |
tessellationQuality
Noesis panel tesselation quality.
Declaration
protected TessellationMaxPixelError tessellationQuality
Field Value
Type | Description |
---|---|
TessellationMaxPixelError |
view
The Noesis View.
Declaration
protected View view
Field Value
Type | Description |
---|---|
View |
viewSettingsDirty
Sets when settings view is dirty.
Declaration
protected bool viewSettingsDirty
Field Value
Type | Description |
---|---|
bool |
width
Panel width.
Declaration
protected uint width
Field Value
Type | Description |
---|---|
uint |
xaml
Xaml content.
Declaration
protected string xaml
Field Value
Type | Description |
---|---|
string |
Properties
BackgroundColor
Gets or sets the color of the background.
Declaration
[RenderProperty(CustomPropertyName = "Background Color", Tooltip = "The background color for the transparent areas in the XAML design.")]
public Color BackgroundColor { get; set; }
Property Value
Type | Description |
---|---|
Color |
ClearFlags
Gets or sets the clear flags used for cleaning the frameBuffer in rendertarget mode.
Declaration
[RenderProperty(CustomPropertyName = "Clear Flags", Tooltip = "The clear flags for the panel.")]
public ClearFlags ClearFlags { get; set; }
Property Value
Type | Description |
---|---|
ClearFlags |
Content
Gets the root of the loaded Xaml.
Declaration
public FrameworkElement Content { get; }
Property Value
Type | Description |
---|---|
FrameworkElement |
DataContext
Gets or sets the panel DataContext.
Declaration
public object DataContext { get; set; }
Property Value
Type | Description |
---|---|
object |
Display
Gets the display to obtains the inputs.
Declaration
protected Display Display { get; }
Property Value
Type | Description |
---|---|
Display |
EnableKeyboard
Gets or sets a value indicating whether keyboard input management is enabled.
Declaration
[RenderProperty(CustomPropertyName = "Enable Keyboard", Tooltip = "Indicates whether the panel will receive keyboard events.")]
public bool EnableKeyboard { get; set; }
Property Value
Type | Description |
---|---|
bool |
EnableMouse
Gets or sets a value indicating whether mouse input management is enabled.
Declaration
[RenderProperty(CustomPropertyName = "Enable Mouse", Tooltip = "Indicates whether the panel will receive mouse events.")]
public bool EnableMouse { get; set; }
Property Value
Type | Description |
---|---|
bool |
EnableTouch
Gets or sets a value indicating whether touch input management is enabled.
Declaration
[RenderProperty(CustomPropertyName = "Enable Touch", Tooltip = "Indicates whether the panel will receive touch events.")]
public bool EnableTouch { get; set; }
Property Value
Type | Description |
---|---|
bool |
FlipY
Gets or sets a value indicating whether to flip the Y axis in the UI.
Declaration
[RenderProperty(CustomPropertyName = "Flip Y", Tooltip = "Indicates whether to flip the Y axis in the UI.")]
public bool FlipY { get; set; }
Property Value
Type | Description |
---|---|
bool |
FrameworkElement
Gets or sets FrameworkElement that will be used when this component is enabled.
Declaration
public FrameworkElement FrameworkElement { get; set; }
Property Value
Type | Description |
---|---|
FrameworkElement |
Height
Gets or sets the render height.
Declaration
[RenderProperty(CustomPropertyName = "Height", Tooltip = "The panel render height.")]
public uint Height { get; set; }
Property Value
Type | Description |
---|---|
uint |
PPAAEnabled
Gets or sets a value indicating whether if PPAA anti-aliasing mode is enabled.
Declaration
[RenderProperty(CustomPropertyName = "PPAA Anti-aliasing Mode", Tooltip = "The PPAA anti-aliasing mode that the panel will use when rendering vector graphics.")]
public bool PPAAEnabled { get; set; }
Property Value
Type | Description |
---|---|
bool |
RenderFlags
Gets or sets the flags used for rendering debug purposes.
Declaration
[RenderProperty(CustomPropertyName = "Render Flags", Tooltip = "Flags used for rendering debug purposes.")]
public RenderFlags RenderFlags { get; set; }
Property Value
Type | Description |
---|---|
RenderFlags |
TessellationQuality
Gets or sets the tessellation quality, which determines the quantity of triangles generated for vector shapes.
Declaration
[RenderProperty(CustomPropertyName = "Tessellation Quality", Tooltip = "The tessellation quality that the panel will apply when rendering vector graphics.")]
public TessellationMaxPixelError TessellationQuality { get; set; }
Property Value
Type | Description |
---|---|
TessellationMaxPixelError |
TouchDeadzoneRadius
Gets or sets the deadzone radius for touch events.
Declaration
[RenderProperty(Tooltip = "The radius of the deadzone for touch events. Dragging interactions will not be sent to the panel until the touch reaches this distance from the initial touch point.")]
public float TouchDeadzoneRadius { get; set; }
Property Value
Type | Description |
---|---|
float |
Width
Gets or sets the render width.
Declaration
[RenderProperty(CustomPropertyName = "Width", Tooltip = "The panel render width.")]
public uint Width { get; set; }
Property Value
Type | Description |
---|---|
uint |
Xaml
Gets or sets the path to the XAML that will be loaded when this component is enabled.
Declaration
public string Xaml { get; set; }
Property Value
Type | Description |
---|---|
string |
Methods
NoesisBegin(bool)
Begins the Noesis Drawing.
Declaration
protected virtual void NoesisBegin(bool restore)
Parameters
Type | Name | Description |
---|---|---|
bool | restore | True to restore previous Noesis state. |
NoesisEnd()
Ends the Noesis drawing.
Declaration
protected virtual void NoesisEnd()
ObtainsDisplay()
Gets the current display.
Declaration
protected abstract Display ObtainsDisplay()
Returns
Type | Description |
---|---|
Display | The current display. |
ObtainsViewSize(out uint, out uint)
Obtains the size of the view.
Declaration
protected abstract void ObtainsViewSize(out uint width, out uint height)
Parameters
Type | Name | Description |
---|---|---|
uint | width | The width. |
uint | height | The height. |
OnAttached()
Invoked when the object is attached to the system.
Declaration
protected override bool OnAttached()
Returns
Type | Description |
---|---|
bool | True if all is OK. |
Overrides
OnDestroy()
Invoked when the object is going to be disposed.
Declaration
protected override void OnDestroy()
Overrides
OnDetach()
Invoked when the object is detached.
Declaration
protected override void OnDetach()
Overrides
ProjectPointer(Point, out Point)
Get the projected position of a mouse or touch input.
Declaration
public abstract bool ProjectPointer(Point screen, out Point projected)
Parameters
Type | Name | Description |
---|---|---|
Point | screen | Input x. |
Point | projected | Projected x. |
Returns
Type | Description |
---|---|
bool | Whether the pointer intersected the plane. |
RebuildPanel()
Rebuild the panel in the next update cycle.
Declaration
public void RebuildPanel()
RegisterRenderEvents()
Register to the necessary events to perform the render cycle.
Declaration
protected abstract void RegisterRenderEvents()
UnregisterRenderEvents()
Unregister to the necessary events to perform the render cycle.
Declaration
protected abstract void UnregisterRenderEvents()
Update(TimeSpan)
Update all methods required for this instance.
Declaration
protected override void Update(TimeSpan gameTime)
Parameters
Type | Name | Description |
---|---|---|
TimeSpan | gameTime | The current game time. |
Overrides
UpdateCharEvent(KeyCharEventArgs)
Notifies that a key was translated to the corresponding character.
Declaration
public void UpdateCharEvent(KeyCharEventArgs e)
Parameters
Type | Name | Description |
---|---|---|
KeyCharEventArgs | e | The key character event arguments. |
UpdateKeyDownEvent(Keys)
Raises KeyDown event for a key enumeration.
Declaration
public void UpdateKeyDownEvent(Keys key)
Parameters
Type | Name | Description |
---|---|---|
Keys | key | The key enumeration. |
UpdateKeyUpEvent(Keys)
Raises KeyUp event for a key enumeration.
Declaration
public void UpdateKeyUpEvent(Keys key)
Parameters
Type | Name | Description |
---|---|---|
Keys | key | The key enumeration. |
UpdateMouseButtonEvent(ref Point, ButtonState, MouseButtons)
Update the mouse button state.
Declaration
public void UpdateMouseButtonEvent(ref Point mousePos, ButtonState state, MouseButtons button)
Parameters
Type | Name | Description |
---|---|---|
Point | mousePos | The mouse position. |
ButtonState | state | The current button state. |
MouseButtons | button | The specific button. |
UpdateMousePosition(ref Point)
Update the mouse position.
Declaration
public void UpdateMousePosition(ref Point mousePos)
Parameters
Type | Name | Description |
---|---|---|
Point | mousePos | The mouse position. |
UpdateMouseScrollEvent(ref Point, int)
Update the scroll wheel of the mouse.
Declaration
public void UpdateMouseScrollEvent(ref Point mousePos, int scrollWheel)
Parameters
Type | Name | Description |
---|---|---|
Point | mousePos | The mouse position. |
int | scrollWheel | The mouse scroll wheel value. |
UpdateTouchEvent(ref Point, ButtonState, long)
Updates the panel by point coordinates.
Declaration
public void UpdateTouchEvent(ref Point positionInNoesisPanel, ButtonState touchState, long touchId)
Parameters
Type | Name | Description |
---|---|---|
Point | positionInNoesisPanel | Position in Noesis panel. |
ButtonState | touchState | Current touch state. |
long | touchId | Current touch id. |
ViewTouchMove(ref Point, ulong)
Calls panel touch move methos if view attribute is set.
Declaration
public void ViewTouchMove(ref Point touchPosition, ulong touchId)
Parameters
Type | Name | Description |
---|---|---|
Point | touchPosition | Current touch position. |
ulong | touchId | Touch id. |
ViewTouchUp(ref Point, ulong)
Calls panel touch up methos if view attribute is set.
Declaration
public void ViewTouchUp(ref Point touchPosition, ulong touchId)
Parameters
Type | Name | Description |
---|---|---|
Point | touchPosition | Current touch position. |
ulong | touchId | Touch id. |
Events
OnViewCreated
Event raised when the Noesis view is created
Declaration
public event EventHandler<View> OnViewCreated
Event Type
Type | Description |
---|---|
EventHandler<View> |