IGridMeshService (net.jueb:util4j 4.3.12 API)

```
public interface IGridMeshService
```
格子网格服务实现基于左下角直角坐标系以宽度为X轴,高度为Y轴注意：格子的ID是由格子X轴和Y轴的数量索引拼接而成,且数量值从0开始

方法概要

所有方法静态方法实例方法抽象方法默认方法
限定符和类型	方法和说明
`static IGridMeshService`	`build(float worldW, float worldH, float gridW, float gridH)` 以格子尺寸构建一个默认规则的网格服务
`default Set<Integer>`	`getCrossGridIds(int grid, IGridMeshService otherGridMesh)` 根据当前网格的格子ID取此格子范围在另外一层网格所交叉的格子id集合 (取格子范围在下层网格所在格子的集合)
`default Set<Integer>`	`getCrossGridIdsByLine(float ox, float oy, float tx, float ty)` 计算线通过了哪些当前网格的格子id
`default Set<Grid>`	`getCrossGrids(int grid, IGridMeshService otherGridMesh)` 根据当前网格的格子ID取此格子范围在另外一层网格所交叉的格子id集合 (取格子范围在下层网格所在格子的集合)
`default Set<Grid>`	`getCrossGridsByLeftDownIndexId(int indexId, IGridMeshService otherGridMesh)` 根据当前网格的格子ID取此格子范围在另外一层网格所交叉的格子id集合 (取格子范围在下层网格所在格子的集合)
`default Set<Grid>`	`getCrossGridsByLine(float ox, float oy, float tx, float ty)` 计算线通过了哪些当前网格的格子
`default Grid`	`getGrid(float x, float y)` 获取坐标所在格子
`default Grid`	`getGridById(int gridId)` 根据格子id格子
`default Grid`	`getGridByLeftDownIndexId(int indexId)` 根据左下角开始的求余索引ID拿格子
`default Grid`	`getGridByLeftUpIndexId(int indexId)` 根据左上角开始的求余索引ID拿格子
`float`	`getGridHeightLength()` 单个格子的高度
`default int`	`getGridId(float x, float y)` 获取坐标所在格子id
`default List<Integer>`	`getGridIdList(float x, float y, float xRange, float yRange)`
`default Set<Integer>`	`getGridIds(float x, float y, float range)` 根据绝对坐标和以坐标为中心点的范围取覆盖格子id (比如一个圆或所占用的格子)
`default Set<Integer>`	`getGridIds(float x, float y, float xRange, float yRange)` 根据绝对坐标为中心点的范围取覆盖格子id (比如一个圆或者一个矩形所占用的格子)
`default Set<Integer>`	`getGridIds(float x, float y, int gridNumRange)` 根据绝对坐标和以坐标为中心点的范围取覆盖格子id
`default Set<Integer>`	`getGridIds(float x, float y, int xNumRange, int yNumRange)` 根据绝对坐标和以坐标为中心点的范围取覆盖格子id
`default Set<Integer>`	`getGridIds(int gridId, int numRange)` 根据格子id和格子数范围取周围格子id 如果numRange=1,则取格子id相邻的9宫格
`default Set<Integer>`	`getGridIds(int gridId, int xNumRange, int yNumRange)` 根据格子id和格子数范围取周围格子如果numRange=1,则取格子id相邻的9宫格
`default int`	`getGridNumWithHeight()` 取纵向(Y轴)格子数量
`default int`	`getGridNumWithWidth()` 取横向(X轴)格子数量
`default Set<Grid>`	`getGrids(float x, float y, float range)` 根据坐标和像素范围获取格子
`default Set<Grid>`	`getGrids(float x, float y, float xRange, float yRange)` 根据坐标和像素范围获取格子
`default Set<Grid>`	`getGrids(float x, float y, int gridNumRange)` 根据坐标和格子数量范围获取格子
`default Set<Grid>`	`getGrids(float x, float y, int xNumRange, int yNumRange)` 根据坐标和格子数量范围获取格子
`default Set<Grid>`	`getGrids(int gridId, int numRange)` 根据格子id和格子数范围取周围格子id 如果numRange=1,则取格子id相邻的9宫格
`default Set<Grid>`	`getGrids(int gridId, int xNumRange, int yNumRange)` 根据格子id和格子数范围取周围格子如果numRange=1,则取格子id相邻的9宫格
`float`	`getGridWidthLength()` 单个格子的宽度
`float`	`getWorldHeightLength()` 世界高
`float`	`getWorldWidthLength()` 世界宽
`default boolean`	`inWorld(float x, float y)` 坐标是否在世界
`static boolean`	`isLineIntersectRectangle(float linePointX1, float linePointY1, float linePointX2, float linePointY2, float rectangleLeftTopX, float rectangleLeftTopY, float rectangleRightBottomX, float rectangleRightBottomY)` 判断线段是否在矩形内先看线段所在直线是否与矩形相交，如果不相交则返回false，如果相交，则看线段的两个点是否在矩形的同一边（即两点的x(y)坐标都比矩形的小x(y)坐标小，或者大）, 若在同一边则返回false，否则就是相交的情况。
`default boolean`	`isNearBy(int gridId1, int range1, int gridId2, int range2)` 比较两个网格是否相邻
`default boolean`	`isNearByWithLeftDownIndexId(int indexId1, int range1, int indexId2, int range2)` 根据左下角索引id 比较两个网格是否相邻

- 方法详细资料
  - getWorldWidthLength
```
float getWorldWidthLength()
```
    世界宽
    
    返回:
  - getWorldHeightLength
```
float getWorldHeightLength()
```
    世界高
    
    返回:
  - getGridWidthLength
```
float getGridWidthLength()
```
    单个格子的宽度
    
    返回:
  - getGridHeightLength
```
float getGridHeightLength()
```
    单个格子的高度
    
    返回:
  - getGridNumWithWidth
```
default int getGridNumWithWidth()
```
    取横向(X轴)格子数量
    
    返回:
  - getGridNumWithHeight
```
default int getGridNumWithHeight()
```
    取纵向(Y轴)格子数量
    
    返回:
  - getGridId
```
default int getGridId(float x,
                      float y)
```
    获取坐标所在格子id
    
    参数:
    
    x -
    
    y -
    
    返回:
  - getGrid
```
default Grid getGrid(float x,
                     float y)
```
    获取坐标所在格子
    
    参数:
    
    x -
    
    y -
    
    返回:
  - getGridById
```
default Grid getGridById(int gridId)
```
    根据格子id格子
    
    参数:
    
    gridId -
    
    返回:
  - getGridByLeftDownIndexId
```
default Grid getGridByLeftDownIndexId(int indexId)
```
    根据左下角开始的求余索引ID拿格子
    
    参数:
    
    indexId -
    
    返回:
  - getGridByLeftUpIndexId
```
default Grid getGridByLeftUpIndexId(int indexId)
```
    根据左上角开始的求余索引ID拿格子
    
    参数:
    
    indexId -
    
    返回:
  - getGrids
```
default Set<Grid> getGrids(float x,
                           float y,
                           float range)
```
    根据坐标和像素范围获取格子
    
    参数:
    
    x -
    
    y -
    
    range -
    
    返回:
  - getGrids
```
default Set<Grid> getGrids(float x,
                           float y,
                           int gridNumRange)
```
    根据坐标和格子数量范围获取格子
    
    参数:
    
    x -
    
    y -
    
    gridNumRange - 如果numRange=1,则取格子id相邻的9宫格
    
    返回:
  - getGrids
```
default Set<Grid> getGrids(float x,
                           float y,
                           int xNumRange,
                           int yNumRange)
```
    根据坐标和格子数量范围获取格子
    
    参数:
    
    x -
    
    y -
    
    xNumRange - x轴格子数量范围
    
    yNumRange - y轴格子数量范围
    
    返回:
  - getGrids
```
default Set<Grid> getGrids(float x,
                           float y,
                           float xRange,
                           float yRange)
```
    根据坐标和像素范围获取格子
    
    参数:
    
    x -
    
    y -
    
    xRange -
    
    yRange -
    
    返回:
  - getGridIds
```
default Set<Integer> getGridIds(float x,
                                float y,
                                float range)
```
    根据绝对坐标和以坐标为中心点的范围取覆盖格子id (比如一个圆或所占用的格子)
    
    参数:
    
    x -
    
    y -
    
    range - 以x,y为中心点的半径长度
    
    返回:
  - getGridIds
```
default Set<Integer> getGridIds(float x,
                                float y,
                                int gridNumRange)
```
    根据绝对坐标和以坐标为中心点的范围取覆盖格子id
    
    参数:
    
    x -
    
    y -
    
    gridNumRange - 如果numRange=1,则取格子id相邻的9宫格
    
    返回:
  - getGridIds
```
default Set<Integer> getGridIds(float x,
                                float y,
                                int xNumRange,
                                int yNumRange)
```
    根据绝对坐标和以坐标为中心点的范围取覆盖格子id
    
    参数:
    
    x -
    
    y -
    
    xNumRange - x轴格子数量范围
    
    yNumRange - y轴格子数量范围
    
    返回:
  - getGridIds
```
default Set<Integer> getGridIds(float x,
                                float y,
                                float xRange,
                                float yRange)
```
    根据绝对坐标为中心点的范围取覆盖格子id (比如一个圆或者一个矩形所占用的格子)
    
    参数:
    
    x -
    
    y -
    
    xRange - 以x,y为中心点的朝向x轴的范围
    
    yRange - 以x,y为中心点的朝向y轴的范围
    
    返回:
  - getGridIdList
```
default List<Integer> getGridIdList(float x,
                                    float y,
                                    float xRange,
                                    float yRange)
```
  - getGrids
```
default Set<Grid> getGrids(int gridId,
                           int numRange)
```
    根据格子id和格子数范围取周围格子id 如果numRange=1,则取格子id相邻的9宫格
    
    参数:
    
    gridId -
    
    numRange - 格子数量范围
    
    返回:
  - getGrids
```
default Set<Grid> getGrids(int gridId,
                           int xNumRange,
                           int yNumRange)
```
    根据格子id和格子数范围取周围格子如果numRange=1,则取格子id相邻的9宫格
    
    参数:
    
    gridId -
    
    xNumRange - x轴格子数量范围
    
    yNumRange - y轴格子数量范围
    
    返回:
  - getGridIds
```
default Set<Integer> getGridIds(int gridId,
                                int numRange)
```
    根据格子id和格子数范围取周围格子id 如果numRange=1,则取格子id相邻的9宫格
    
    参数:
    
    gridId -
    
    numRange - 格子数量范围
    
    返回:
  - getGridIds
```
default Set<Integer> getGridIds(int gridId,
                                int xNumRange,
                                int yNumRange)
```
    根据格子id和格子数范围取周围格子如果numRange=1,则取格子id相邻的9宫格
    
    参数:
    
    gridId -
    
    xNumRange - x轴格子数量范围
    
    yNumRange - y轴格子数量范围
    
    返回:
  - isNearBy
```
default boolean isNearBy(int gridId1,
                         int range1,
                         int gridId2,
                         int range2)
```
    比较两个网格是否相邻
    
    参数:
    
    gridId1 - 网格1
    
    range1 - 网格1的范围
    
    gridId2 - 网格2
    
    range2 - 网格2的范围
    
    返回:
  - isNearByWithLeftDownIndexId
```
default boolean isNearByWithLeftDownIndexId(int indexId1,
                                            int range1,
                                            int indexId2,
                                            int range2)
```
    根据左下角索引id 比较两个网格是否相邻
    
    参数:
    
    indexId1 -
    
    range1 -
    
    indexId2 -
    
    range2 -
    
    返回:
  - getCrossGrids
```
default Set<Grid> getCrossGrids(int grid,
                                IGridMeshService otherGridMesh)
```
    根据当前网格的格子ID取此格子范围在另外一层网格所交叉的格子id集合 (取格子范围在下层网格所在格子的集合)
    
    参数:
    
    grid - 当前网格的格子
    
    otherGridMesh - 其它网格
    
    返回:
    
    返回other中交叉的格子
  - getCrossGridsByLeftDownIndexId
```
default Set<Grid> getCrossGridsByLeftDownIndexId(int indexId,
                                                 IGridMeshService otherGridMesh)
```
    根据当前网格的格子ID取此格子范围在另外一层网格所交叉的格子id集合 (取格子范围在下层网格所在格子的集合)
    
    参数:
    
    indexId - 当前网格的格子左下角求余索引
    
    otherGridMesh - 其它网格
    
    返回:
    
    返回other中交叉的格子
  - getCrossGridIds
```
default Set<Integer> getCrossGridIds(int grid,
                                     IGridMeshService otherGridMesh)
```
    根据当前网格的格子ID取此格子范围在另外一层网格所交叉的格子id集合 (取格子范围在下层网格所在格子的集合)
    
    参数:
    
    grid - 当前网格的格子
    
    otherGridMesh - 其它网格
    
    返回:
    
    返回other中交叉的格子
  - getCrossGridsByLine
```
default Set<Grid> getCrossGridsByLine(float ox,
                                      float oy,
                                      float tx,
                                      float ty)
```
    计算线通过了哪些当前网格的格子
    
    参数:
    
    ox - 线起始点
    
    oy -
    
    tx - 线结束点
    
    ty -
    
    返回:
  - getCrossGridIdsByLine
```
default Set<Integer> getCrossGridIdsByLine(float ox,
                                           float oy,
                                           float tx,
                                           float ty)
```
    计算线通过了哪些当前网格的格子id
    
    参数:
    
    ox - 线起始点
    
    oy -
    
    tx - 线结束点
    
    ty -
    
    返回:
  - inWorld
```
default boolean inWorld(float x,
                        float y)
```
    坐标是否在世界
    
    参数:
    
    x -
    
    y -
    
    返回:
  - isLineIntersectRectangle
```
static boolean isLineIntersectRectangle(float linePointX1,
                                        float linePointY1,
                                        float linePointX2,
                                        float linePointY2,
                                        float rectangleLeftTopX,
                                        float rectangleLeftTopY,
                                        float rectangleRightBottomX,
                                        float rectangleRightBottomY)
```
    判断线段是否在矩形内
    先看线段所在直线是否与矩形相交，如果不相交则返回false，如果相交，则看线段的两个点是否在矩形的同一边（即两点的x(y)坐标都比矩形的小x(y)坐标小，或者大）, 若在同一边则返回false，否则就是相交的情况。
    
    参数:
    
    linePointX1 - 线段起始点x坐标
    
    linePointY1 - 线段起始点y坐标
    
    linePointX2 - 线段结束点x坐标
    
    linePointY2 - 线段结束点y坐标
    
    rectangleLeftTopX - 矩形左上点x坐标
    
    rectangleLeftTopY - 矩形左上点y坐标
    
    rectangleRightBottomX - 矩形右下点x坐标
    
    rectangleRightBottomY - 矩形右下点y坐标
    
    返回:
    
    是否相交
  - build
```
static IGridMeshService build(float worldW,
                              float worldH,
                              float gridW,
                              float gridH)
```
    以格子尺寸构建一个默认规则的网格服务
    
    参数:
    
    worldW -
    
    worldH -
    
    gridW -
    
    gridH -
    
    返回:

接口 IGridMeshService

方法概要

方法详细资料

getWorldWidthLength

getWorldHeightLength

getGridWidthLength

getGridHeightLength

getGridNumWithWidth

getGridNumWithHeight

getGridId

getGrid

getGridById

getGridByLeftDownIndexId

getGridByLeftUpIndexId

getGrids

getGrids

getGrids

getGrids

getGridIds

getGridIds

getGridIds

getGridIds

getGridIdList

getGrids

getGrids

getGridIds

getGridIds

isNearBy

isNearByWithLeftDownIndexId

getCrossGrids

getCrossGridsByLeftDownIndexId

getCrossGridIds

getCrossGridsByLine

getCrossGridIdsByLine

inWorld

isLineIntersectRectangle

build