@vib3code/sdk 2.0.1

package/types/render/RenderState.d.ts

@@ -0,0 +1,279 @@
+/**
+ * RenderState TypeScript Definitions
+ * VIB3+ SDK - Render Abstraction Layer
+ */
+
+/** Blend modes for color mixing */
+export const enum BlendMode {
+    NONE = 'none',
+    ALPHA = 'alpha',
+    ADDITIVE = 'additive',
+    MULTIPLY = 'multiply',
+    SCREEN = 'screen',
+    PREMULTIPLIED = 'premultiplied'
+}
+
+/** Depth comparison functions */
+export const enum DepthFunc {
+    NEVER = 'never',
+    LESS = 'less',
+    EQUAL = 'equal',
+    LEQUAL = 'lequal',
+    GREATER = 'greater',
+    NOTEQUAL = 'notequal',
+    GEQUAL = 'gequal',
+    ALWAYS = 'always'
+}
+
+/** Face culling modes */
+export const enum CullFace {
+    NONE = 'none',
+    FRONT = 'front',
+    BACK = 'back',
+    FRONT_AND_BACK = 'front_and_back'
+}
+
+/** Polygon fill modes */
+export const enum PolygonMode {
+    FILL = 'fill',
+    LINE = 'line',
+    POINT = 'point'
+}
+
+/** Stencil operations */
+export const enum StencilOp {
+    KEEP = 'keep',
+    ZERO = 'zero',
+    REPLACE = 'replace',
+    INCR = 'incr',
+    INCR_WRAP = 'incr_wrap',
+    DECR = 'decr',
+    DECR_WRAP = 'decr_wrap',
+    INVERT = 'invert'
+}
+
+/** Blend factor names */
+export type BlendFactor =
+    | 'zero'
+    | 'one'
+    | 'src_color'
+    | 'one_minus_src_color'
+    | 'dst_color'
+    | 'one_minus_dst_color'
+    | 'src_alpha'
+    | 'one_minus_src_alpha'
+    | 'dst_alpha'
+    | 'one_minus_dst_alpha'
+    | 'constant_color'
+    | 'one_minus_constant_color'
+    | 'constant_alpha'
+    | 'one_minus_constant_alpha'
+    | 'src_alpha_saturate';
+
+/** RGBA color tuple */
+export type Color4 = [number, number, number, number];
+
+/** Boolean mask for color channels */
+export type ColorMask = [boolean, boolean, boolean, boolean];
+
+/** Scissor/viewport rectangle */
+export type Rect = [number, number, number, number];
+
+/**
+ * Blend state configuration
+ */
+export declare class BlendState {
+    enabled: boolean;
+    mode: BlendMode;
+    srcRGB: BlendFactor;
+    dstRGB: BlendFactor;
+    srcAlpha: BlendFactor;
+    dstAlpha: BlendFactor;
+    color: Color4;
+
+    constructor();
+
+    /**
+     * Set blend mode preset
+     */
+    setMode(mode: BlendMode): void;
+
+    /**
+     * Set custom blend factors
+     */
+    setCustom(
+        srcRGB: BlendFactor,
+        dstRGB: BlendFactor,
+        srcAlpha?: BlendFactor,
+        dstAlpha?: BlendFactor
+    ): void;
+
+    /**
+     * Clone this state
+     */
+    clone(): BlendState;
+
+    /**
+     * Check equality with another state
+     */
+    equals(other: BlendState): boolean;
+}
+
+/**
+ * Depth test state configuration
+ */
+export declare class DepthState {
+    testEnabled: boolean;
+    writeEnabled: boolean;
+    func: DepthFunc;
+    near: number;
+    far: number;
+
+    constructor();
+
+    /**
+     * Clone this state
+     */
+    clone(): DepthState;
+
+    /**
+     * Check equality with another state
+     */
+    equals(other: DepthState): boolean;
+}
+
+/**
+ * Stencil test state configuration
+ */
+export declare class StencilState {
+    enabled: boolean;
+    func: string;
+    ref: number;
+    mask: number;
+    failOp: StencilOp;
+    depthFailOp: StencilOp;
+    passOp: StencilOp;
+
+    constructor();
+
+    /**
+     * Clone this state
+     */
+    clone(): StencilState;
+
+    /**
+     * Check equality with another state
+     */
+    equals(other: StencilState): boolean;
+}
+
+/**
+ * Rasterizer state configuration
+ */
+export declare class RasterizerState {
+    cullFace: CullFace;
+    frontFaceCCW: boolean;
+    polygonMode: PolygonMode;
+    scissorEnabled: boolean;
+    scissorRect: Rect;
+    lineWidth: number;
+    depthBiasEnabled: boolean;
+    depthBiasFactor: number;
+    depthBiasUnits: number;
+
+    constructor();
+
+    /**
+     * Clone this state
+     */
+    clone(): RasterizerState;
+
+    /**
+     * Check equality with another state
+     */
+    equals(other: RasterizerState): boolean;
+}
+
+/**
+ * Viewport configuration
+ */
+export declare class Viewport {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+
+    constructor(x?: number, y?: number, width?: number, height?: number);
+
+    /**
+     * Get aspect ratio (width / height)
+     */
+    readonly aspectRatio: number;
+
+    /**
+     * Clone this viewport
+     */
+    clone(): Viewport;
+
+    /**
+     * Check equality with another viewport
+     */
+    equals(other: Viewport): boolean;
+
+    /**
+     * Set all values at once
+     */
+    set(x: number, y: number, width: number, height: number): void;
+}
+
+/**
+ * Complete render state configuration
+ */
+export declare class RenderState {
+    blend: BlendState;
+    depth: DepthState;
+    stencil: StencilState;
+    rasterizer: RasterizerState;
+    viewport: Viewport;
+    colorMask: ColorMask;
+    clearColor: Color4;
+    clearDepth: number;
+    clearStencil: number;
+
+    constructor();
+
+    /**
+     * Create opaque render state preset
+     */
+    static opaque(): RenderState;
+
+    /**
+     * Create transparent render state preset
+     */
+    static transparent(): RenderState;
+
+    /**
+     * Create additive blend render state preset
+     */
+    static additive(): RenderState;
+
+    /**
+     * Create wireframe render state preset
+     */
+    static wireframe(): RenderState;
+
+    /**
+     * Clone this state
+     */
+    clone(): RenderState;
+
+    /**
+     * Get state difference
+     */
+    diff(other: RenderState): Partial<RenderState>;
+
+    /**
+     * Get sort key for state-based batching
+     */
+    getSortKey(): number;
+}

package/types/render/RenderTarget.d.ts

@@ -0,0 +1,254 @@
+/**
+ * RenderTarget TypeScript Definitions
+ * VIB3+ SDK - Framebuffer Abstraction
+ */
+
+/** Texture format identifiers */
+export const enum TextureFormat {
+    // Color formats
+    RGBA8 = 'rgba8',
+    RGBA16F = 'rgba16f',
+    RGBA32F = 'rgba32f',
+    RGB8 = 'rgb8',
+    RG8 = 'rg8',
+    R8 = 'r8',
+    // Depth formats
+    DEPTH16 = 'depth16',
+    DEPTH24 = 'depth24',
+    DEPTH32F = 'depth32f',
+    // Depth-stencil formats
+    DEPTH24_STENCIL8 = 'depth24_stencil8',
+    DEPTH32F_STENCIL8 = 'depth32f_stencil8'
+}
+
+/** Attachment type identifiers */
+export const enum AttachmentType {
+    COLOR = 'color',
+    DEPTH = 'depth',
+    STENCIL = 'stencil',
+    DEPTH_STENCIL = 'depth_stencil'
+}
+
+/** Texture filter modes */
+export const enum FilterMode {
+    NEAREST = 'nearest',
+    LINEAR = 'linear',
+    NEAREST_MIPMAP_NEAREST = 'nearest_mipmap_nearest',
+    LINEAR_MIPMAP_NEAREST = 'linear_mipmap_nearest',
+    NEAREST_MIPMAP_LINEAR = 'nearest_mipmap_linear',
+    LINEAR_MIPMAP_LINEAR = 'linear_mipmap_linear'
+}
+
+/** Texture wrap modes */
+export const enum WrapMode {
+    REPEAT = 'repeat',
+    CLAMP_TO_EDGE = 'clamp_to_edge',
+    MIRRORED_REPEAT = 'mirrored_repeat'
+}
+
+/** Attachment descriptor options */
+export interface AttachmentOptions {
+    type?: AttachmentType;
+    format?: TextureFormat;
+    index?: number;
+    useTexture?: boolean;
+    minFilter?: FilterMode;
+    magFilter?: FilterMode;
+    wrapS?: WrapMode;
+    wrapT?: WrapMode;
+    generateMipmaps?: boolean;
+    samples?: number;
+}
+
+/**
+ * Framebuffer attachment descriptor
+ */
+export declare class AttachmentDescriptor {
+    type: AttachmentType;
+    format: TextureFormat;
+    index: number;
+    useTexture: boolean;
+    minFilter: FilterMode;
+    magFilter: FilterMode;
+    wrapS: WrapMode;
+    wrapT: WrapMode;
+    generateMipmaps: boolean;
+    samples: number;
+
+    constructor(options?: AttachmentOptions);
+
+    /**
+     * Create color attachment descriptor
+     */
+    static color(options?: Partial<AttachmentOptions>): AttachmentDescriptor;
+
+    /**
+     * Create depth attachment descriptor
+     */
+    static depth(options?: Partial<AttachmentOptions>): AttachmentDescriptor;
+
+    /**
+     * Create depth-stencil attachment descriptor
+     */
+    static depthStencil(options?: Partial<AttachmentOptions>): AttachmentDescriptor;
+
+    /**
+     * Check if this is a depth format
+     */
+    isDepthFormat(): boolean;
+}
+
+/** Render target options */
+export interface RenderTargetOptions {
+    colorAttachments?: AttachmentDescriptor[];
+    depthAttachment?: AttachmentDescriptor | null;
+    label?: string;
+}
+
+/** Simple render target options */
+export interface SimpleRenderTargetOptions {
+    format?: TextureFormat;
+    depth?: boolean;
+    samples?: number;
+}
+
+/**
+ * Framebuffer / render target abstraction
+ */
+export declare class RenderTarget {
+    readonly id: number;
+    width: number;
+    height: number;
+    colorAttachments: AttachmentDescriptor[];
+    depthAttachment: AttachmentDescriptor | null;
+    label: string;
+
+    constructor(width: number, height: number, options?: RenderTargetOptions);
+
+    /**
+     * Get aspect ratio
+     */
+    readonly aspectRatio: number;
+
+    /**
+     * Check if target has depth attachment
+     */
+    readonly hasDepth: boolean;
+
+    /**
+     * Get number of color attachments
+     */
+    readonly colorAttachmentCount: number;
+
+    /**
+     * Resize the render target
+     */
+    resize(width: number, height: number): void;
+
+    /**
+     * Get the native handle
+     */
+    getHandle(): any;
+
+    /**
+     * Set the native handle
+     */
+    setHandle(handle: any): void;
+
+    /**
+     * Get color texture at index
+     */
+    getColorTexture(index?: number): any;
+
+    /**
+     * Get depth texture
+     */
+    getDepthTexture(): any;
+
+    /**
+     * Dispose resources
+     */
+    dispose(): void;
+
+    /**
+     * Create simple render target
+     */
+    static create(
+        width: number,
+        height: number,
+        options?: SimpleRenderTargetOptions
+    ): RenderTarget;
+
+    /**
+     * Create HDR render target
+     */
+    static createHDR(
+        width: number,
+        height: number,
+        options?: SimpleRenderTargetOptions
+    ): RenderTarget;
+
+    /**
+     * Create G-buffer for deferred rendering
+     */
+    static createGBuffer(width: number, height: number): RenderTarget;
+
+    /**
+     * Create shadow map
+     */
+    static createShadowMap(size: number, format?: TextureFormat): RenderTarget;
+
+    /**
+     * Create MSAA render target
+     */
+    static createMSAA(
+        width: number,
+        height: number,
+        samples?: number,
+        format?: TextureFormat
+    ): RenderTarget;
+}
+
+/** Render target pool statistics */
+export interface RenderTargetPoolStats {
+    pooled: number;
+    inUse: number;
+    poolCount: number;
+}
+
+/**
+ * Pool for reusing render targets
+ */
+export declare class RenderTargetPool {
+    constructor();
+
+    /**
+     * Acquire a render target from the pool
+     */
+    acquire(
+        width: number,
+        height: number,
+        format?: TextureFormat,
+        hasDepth?: boolean
+    ): RenderTarget;
+
+    /**
+     * Release a render target back to the pool
+     */
+    release(target: RenderTarget): void;
+
+    /**
+     * Clear and dispose all pooled targets
+     */
+    clear(): void;
+
+    /**
+     * Get pool statistics
+     */
+    getStats(): RenderTargetPoolStats;
+}
+
+/**
+ * Global render target pool instance
+ */
+export declare const renderTargetPool: RenderTargetPool;