SystemEX  Lacking
Additional generic collection types missing in .net
SystemEx.Drawing.ISubCanvas< T > Interface Template Reference

Represents a mathematical sub‑canvas that participates as a layer within a layered canvas system. A sub‑canvas does not perform graphical drawing; instead, it defines deterministic transformation rules, visibility states, and optional masking that influence the final composed pixel buffer when requested through ICanvasList<T>.GetPixels or ICanvasList<T>.SwapIn. More...

Inheritance diagram for SystemEx.Drawing.ISubCanvas< T >:
Collaboration diagram for SystemEx.Drawing.ISubCanvas< T >:

Properties

bool Enable [get, set]
 Gets or sets whether this sub‑canvas is enabled. Disabled sub‑canvases do not participate in mathematical composition and behave as if they were absent from the layer stack.
bool Showing [get, set]
 Gets or sets whether this sub‑canvas is visible. A hidden sub‑canvas remains present in the layer structure but does not contribute to the composed pixel buffer.
bool IsDirty [get, set]
 Gets or sets whether the sub‑canvas is marked as dirty. A dirty state indicates that its mathematical content has changed and that dependent compositions may need to be recalculated.
string Name [get, set]
 Gets or sets the name of the sub‑canvas. This is a user‑defined identifier useful for organizing, labeling, or referencing layers within a canvas list.
byte Visible [get, set]
 Gets or sets the visibility weight of the sub‑canvas. This value represents a mathematical transparency factor used during layer blending. Higher values increase the influence of the sub‑canvas on the final composition.
bool HasMask [get, set]
 Gets or sets a value indicating whether the sub‑canvas uses a mask. When enabled, the mask determines which regions of the sub‑canvas contribute to the mathematical composition.
ICanvas< ColorGrayMask [get, set]
 Gets or sets the grayscale mask applied to this sub‑canvas. The mask defines per‑pixel visibility weights, allowing selective inclusion or exclusion of regions during composition. A mask does not draw pixels; it modifies how the sub‑canvas mathematically interacts with underlying layers.
Properties inherited from SystemEx.Drawing.ICanvas< T >
int Height [get]
 Gets the height of the canvas in mathematical units (rows).
int Width [get]
 Gets the width of the canvas in mathematical units (columns).
IEnumerable< T > Buffer [get]
 Gets an enumerable view of the underlying buffer. The buffer contains the raw mathematical color values in row‑major order. No rendering or transformation occurs when accessing this property.

Additional Inherited Members

Public Member Functions inherited from SystemEx.Drawing.ICanvas< T >
GetPixel (int x, int y)
 Returns the color value at the specified coordinates. This method provides direct access to the underlying mathematical buffer without performing any rendering.
bool Resize (int size)
 Resizes the canvas to the specified total size (Width × Height). Existing values may be truncated or expanded depending on the implementation. This operation modifies only the mathematical buffer.
ICanvas< T > CopyRegion (int x, int y, int width, int height)
 Creates a new canvas containing a rectangular region of this canvas. The region is copied mathematically; no rendering or blending occurs.
ICanvas< T > Clone ()
 Creates a full mathematical clone of this canvas, duplicating all stored values.
void Fill (T objcolor)
 Fills the entire canvas with the specified color value. This operation replaces all stored data deterministically and does not perform any graphical drawing.
void FillRect (int x1, int y1, int x2, int y2)
 Fills a rectangular region of the canvas with the specified color value. This modifies only the mathematical buffer and does not perform rendering.
void Clear ()
 Clears the canvas by resetting all stored values to their default state. This operation affects only the mathematical buffer.
Pair< int, int > Find (T color)
 Searches the canvas for the first occurrence of the specified color value. Returns the coordinates of the match or (-1, -1) if no match is found.
int FindLast (T color)
 Searches the canvas for the last occurrence of the specified color value. Returns the index in the underlying buffer or -1 if no match is found.

Detailed Description

Represents a mathematical sub‑canvas that participates as a layer within a layered canvas system. A sub‑canvas does not perform graphical drawing; instead, it defines deterministic transformation rules, visibility states, and optional masking that influence the final composed pixel buffer when requested through ICanvasList<T>.GetPixels or ICanvasList<T>.SwapIn.

Sub‑canvases act as structural components in a purely mathematical model: they contribute color values, transformations, or blend interactions, but no pixels are rendered until the composition pipeline is evaluated.

Template Parameters
TThe color type used by the canvas.

The documentation for this interface was generated from the following file:
  • ICanvasList.cs