Package icyllis.arc3d.granite

Class Clip_old

java.lang.Object
icyllis.arc3d.granite.Clip_old
@Deprecated public abstract class Clip_old extends Object
Deprecated.
Clip_old is an abstract base class for producing a clip. It constructs a clip mask if necessary, and fills out a ClipResult_old instructing the caller on how to set up the draw state.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    CLIPPED
    Deprecated.
     
    static final int
    CLIPPED_OUT
    Deprecated.
     
    static final float
    kBoundsTolerance
    Deprecated.
    This is the maximum distance that a draw may extend beyond a clip's boundary and still count count as "on the other side".
    static final float
    kHalfPixelRoundingTolerance
    Deprecated.
    This is the slack around a half-pixel vertex coordinate where we don't trust the GPU's rasterizer to round consistently.
    static final int
    NOT_CLIPPED
    Deprecated.
     

  • Constructor Summary

    Constructors
    Constructor
    Description
    Clip_old()
    Deprecated.
     

  • Method Summary

    Modifier and Type
    Method
    Description
    abstract int
    apply(SurfaceDrawContext sdc, boolean aa, ClipResult_old out, Rect2f bounds)
    Deprecated.
     
    abstract void
    getConservativeBounds(Rect2i out)
    Deprecated.
    Compute a conservative pixel bounds restricted to the given render target dimensions.
    static void
    getPixelBounds(Rect2fc bounds, boolean aa, boolean exterior, Rect2i out)
    Deprecated.
    Convert the analytic bounds of a shape into an integer pixel bounds, where the given aa type is used when the shape is rendered.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • CLIPPED

      public static final int CLIPPED
      Deprecated.
      See Also:

    • NOT_CLIPPED

      public static final int NOT_CLIPPED
      Deprecated.
      See Also:

    • CLIPPED_OUT

      public static final int CLIPPED_OUT
      Deprecated.
      See Also:

    • kBoundsTolerance

      public static final float kBoundsTolerance
      Deprecated.
      This is the maximum distance that a draw may extend beyond a clip's boundary and still count count as "on the other side". We leave some slack because floating point rounding error is likely to blame. The rationale for 1e-3 is that in the coverage case (and barring unexpected rounding), as long as coverage stays within 0.5 * 1/256 of its intended value it shouldn't have any effect on the final pixel values.
      See Also:

    • kHalfPixelRoundingTolerance

      public static final float kHalfPixelRoundingTolerance
      Deprecated.
      This is the slack around a half-pixel vertex coordinate where we don't trust the GPU's rasterizer to round consistently. The rounding method is not defined in GPU specs, and rasterizer precision frequently introduces errors where a fraction invalid input: '<' 1/2 still rounds up.

      For non-AA bounds edges, an edge value between 0.45 and 0.55 will round in or round out depending on what side its on. Outside of this range, the non-AA edge will snap using round()

      See Also:

  • Constructor Details

    • Clip_old

      public Clip_old()
      Deprecated.

  • Method Details

    • apply

      public abstract int apply(SurfaceDrawContext sdc, boolean aa, ClipResult_old out, Rect2f bounds)
      Deprecated.

    • getConservativeBounds

      public abstract void getConservativeBounds(Rect2i out)
      Deprecated.
      Compute a conservative pixel bounds restricted to the given render target dimensions. The returned bounds represent the limits of pixels that can be drawn; anything outside the bounds will be entirely clipped out.

    • getPixelBounds

      public static void getPixelBounds(Rect2fc bounds, boolean aa, boolean exterior, Rect2i out)
      Deprecated.
      Convert the analytic bounds of a shape into an integer pixel bounds, where the given aa type is used when the shape is rendered. The bounds mode can be used to query exterior or interior pixel boundaries. Interior bounds only make sense when its know that the analytic bounds are filled completely.

      NOTE: When using kExterior_Bounds, some coverage-AA rendering methods may still touch a pixel center outside of these bounds but will evaluate to 0 coverage. This is visually acceptable, but an additional outset of 1px should be used for dst proxy access.