code: @Nonnegative
    public static float getOpacityToUse (final float fOpacity)
    {
      return fOpacity < OPACITY_MIN ? OPACITY_MIN : fOpacity > OPACITY_MAX ? OPACITY_MAX : fOpacity;
    }
docs: Ensure that the passed opacity value is in the range {@link #OPACITY_MIN}
  and {@link #OPACITY_MAX}.
  
  @param fOpacity
  The original opacity
  @return The opacity in the correct range between 0 and 1.