Geello

Geello (GeO_Vello) try to render geo data through GEO and VELLO

[!WARNING] Geello is a testing project in an alpha state.

v0.2.0 ~ v0.3.0 Work

• Finish and Clean up the current code
• Modify RenderedGeometry to split project and render
• Exchange Geom order and Renderer order
• Render Rect should stick to render
• Multi Layers
• Calc image size with x/y resolution or WMTS zoom
• Handle web geojson
• Make web map example more flexible
• Server: add layers styles memory cache with expire time
• More Renderer, such as graph renderer and animation renderer
• Support read render value from props
• Provide docker package
• More README
• More docs

As a library

Geello can be used as a library to render geo data into a texture.

1. Use RenderedGeometry::new() to create new geometry.

2. Read file or Create a RenderOption.

3. Set some options, like RenderRegion or Transform.

4. Get Vello values just like Vello.

5. Run one of functions below, or with _with_new_texture.

6. Use return value to draw on canvas or encode to file.

geello::render_to_texture(
    geoms: &mut Vec<RenderedGeometry>,
    device: &Device,
    queue: &Queue,
    renderer: &mut Renderer,
    texture: &Texture,
    transform: Affine,
    option: &RenderOption,
)

geello::render_to_buffer(
    geoms: &mut Vec<RenderedGeometry>,
    device: &Device,
    queue: &Queue,
    renderer: &mut Renderer,
    texture: &Texture,
    transform: Affine,
    option: &RenderOption,
)

As a server

Geello can be used as a server to provide map render (real-time/cache) services like WMTS/WMS.

cargo r --release --features server

WMTS LIKE

// real-time
http://addr:port/wmts/real-time

// cache
http://addr:port/wmts/cache

//params
layers=${/path/to/json} // use `,` split multi layer, render as order
styles=${/path/to/render_option} // render_option to filter rendered geometry
x=${x}
y=${y}
z=${z}
format=${format} // like image/png or png

WMS LIKE

http://addr:port/wms

// params
layers=${/path/to/json} // use `,` split multi layer, render as order
styles=${/path/to/render_option} // render_option to filter rendered geometry
format=${format} // like image/png or png
width=${width}
height=${height}
bbox=${bbox}

What's More -> Animation Or Dynamic Data

Geello use web socket to handle real-time animation or dynamic data.

Such as a point that grows from small to large for representing importance.

Or a real-time route of a car.

ws://addr:port/ws/anim

// params
layers=${/path/to/json} // use `,` split multi layer, render as order
styles=${/path/to/render_option} // render_option to filter rendered geometry
format=${format} // like image/png or png
width=${width}
height=${height}
bbox=${bbox}

Web Map example

When run as server, Geello provides a web map example by open http://addr:port/map in browser.

Contributing

Please!

License

The code is available under the MIT license.