// This Source Code is in the Public Domain per: http://unlicense.org
package org.litesoft.render;

public abstract class AbstracNativeRenderHelper extends AbstractRenderHelper
{
    protected AbstracNativeRenderHelper( Object pRectangularRenderableObject, //
                                         RenderAccessor pRenderAccessor, //
                                         RenderParticipatingAdapter pParticipatingAdapter, //
                                         RenderDimensionAdapter pDimensionAdapter )
    {
        super( pRectangularRenderableObject, pRenderAccessor, RenderSizingApproach.None, pParticipatingAdapter, pDimensionAdapter );
    }

    protected final RenderHelperProcess requestFloodSetSize( int pRequestedSize )
    {
        throw exceptionOnSizeChange();
    }

    protected RenderHelperProcess requestFloodAdjustSizeBy( int pRequestedSizeChange )
    {
        throw exceptionOnSizeChange();
    }

    protected final RenderHelperProcess requestSetSize( int pRequestedSize )
    {
        throw exceptionOnSizeChange();
    }

    protected final RenderHelperProcess requestAdjustSizeBy( int pRequestedSizeChange )
    {
        throw exceptionOnSizeChange();
    }

    /**
     * Get the "Natural" Size - the size something was when it first was Rendered.
     *
     * @return null means that is not "yet" available.
     */
    public final Integer getNaturalSize()
    {
        return getRectSizeNow();
    }

    /**
     * Get the "Natural" Size RHP.
     * <p/>
     * Note: RHPs are Instance Equality Managed, so for the same underlying dependency the same RHP must be returned!
     *
     * @return !null RHP, where its callbacks will be notified when it is complete.
     */
    public final RenderHelperProcess unavailableNaturalSizeRHP()
    {
        return queue( mDetermineRectSizeNow );
    }

    /**
     * Get the "Minimum" Size.
     * <p/>
     * Renderable Objects that are not Sizable will return their "Natural" Size.
     *
     * @return null means that is not "yet" available.
     */
    public final Integer getMinimumSize()
    {
        return getNaturalSize();
    }

    /**
     * Get the "Minimum" Size RHP.
     * <p/>
     * Note: RHPs are Instance Equality Managed, so for the same underlying dependency the same RHP must be returned!
     *
     * @return !null RHP, where its callbacks will be notified when it is complete.
     */
    public final RenderHelperProcess unavailableMinimumSizeRHP()
    {
        return unavailableNaturalSizeRHP();
    }

    /**
     * Get the "Current" Size.
     * <p/>
     * Renderable Objects that are not Sizable will return their "Natural" Size.
     *
     * @return null means that is not "yet" available.
     */
    public final Integer getCurrentSize()
    {
        return getNaturalSize();
    }

    /**
     * Get the "Current" Size RHP.
     * <p/>
     * Note: RHPs are Instance Equality Managed, so for the same underlying dependency the same RHP must be returned!
     *
     * @return !null RHP, where its callbacks will be notified when it is complete.
     */
    public final RenderHelperProcess unavailableCurrentSizeRHP()
    {
        return unavailableNaturalSizeRHP();
    }

    /**
     * Request "this" RederableRect and its' children be layed out.
     * <p/>
     * Note: RHPs are Instance Equality Managed, so for the same underlying dependency the same RHP must be returned!
     *
     * @return null if no layout process is needed,
     *         otherwise the returned RHP's callbacks will be notified when it is complete.
     */
    public RenderHelperProcess layoutFromHereDown()
    {
        if ( getNaturalSize() == null )
        {
            return unavailableNaturalSizeRHP();
        }
        setLayedOut();
        return null;
    }

    public String toString()
    {
        return toString( "Native" );
    }
}