jangko/nimagg

nimAGG is a Nim port of Anti Grain Geometry(AGG)

nimAGG

nimAGG is a Nim port of Anti Grain Geometry(AGG)

High Fidelity 2D Graphics. A High Quality Rendering Engine for Nim

---

This project relying on recent bugfixes of Nim compiler, so you should use devel branch on Github, or at least Nim ver 0.18.1 to compile this project.

Those bugfixes are:

• proc parameter shadowing inside template
• mixin inside generic proc generated by template
• inheriting generic object
• inheriting partial specialization generic object
• type alias via template
• call proc of partial/specialized/some generic object by subtype object
• generic proc forward declaration
• generic object with generic field(s) type obtained via template(WIP)
• system.ashr addition
• deprecated '.' import path handling

How to build demos?

build all demos:

cd examples
nim e build.nims

or if you want to build single demo:

cd example
nim c ex_aa_demo

How to build command line only demos without GUI?

build all demos:

cd examples
nim e -d:platform_null build.nims

build single demo:

cd example
nim c -d:platform_null ex_compositing

the above command will produce executables without gui, and you can call it with:

ex_compositing -v
or
./ex_compositing -v

it will produce screenshot with image format BMP

if you want to use SDL instead of native API, compile like this:

nim c -d:platform_sdl ex_lion

On Linux and macOS, font renderers are freetype and AGG font renderer. On Windows, you get additional native windows truetype renderer. If you want to use freetype instead of windows native truetype renderer on windows platform, please use use_freetype compiler switch:

nim c -d:use_freetype ex_trans_curve1_ft
nim c -d:use_freetype ex_trans_curve2_ft
nim c -d:use_freetype ex_freetype_test

Dependencies

• These are nimble packages needed to build nimAGG
  • nimBMP
  • polyBool(optional)
  • freetype(optional)
  • sdl2_nim(optional)
  • x11(if your platform is Linux with GUI)
  • opengl(Mac OS with GUI)
  • objc(Mac OS with GUI)
• And here are wrapped library locations:
  • libfreetype(optional)
  • libsdl(optional)

Installation

You can install this package via nimble

nimble install nimAGG

nimagg's Issues

implementing agg array

• this is high priority, affecting bug fixes and performance
• also check for agg_basics artefact

pathStorage::arrangeOrientation bug

both cw and ccw act weird

remove/relocate code

• agg-2.5
• aggdoc -> wiki
• polyBool -> appveyor, travis pull from its own repo
• freetype -> idem
• sdl2 -> idem

implement missing core feature

• font freetype
• font win32 true type
• font cache manager
• freetype test
• truetype test
• trans curve1
• trans curve 1 ft
• trans curve 2
• trans curve 2 ft
• path storage integer

reimplement rasterizer cell AA

• don't use ref object, use ordinary object
• don't use alloc, use seq
• don't use merge-sort, use quick sort

add platform support to examples

• ex_lion.nim
• ex_lion_lens.nim
• ex_lion_outline.nim
• ex_logo.nim
• ex_mol_view.nim
• ex_multi_clip.nim
• ex_particle_demo.nim
• ex_pattern_fill.nim
• ex_pattern_perspective.nim
• ex_pattern_resample.nim
• ex_perspective.nim
• ex_pixfmt.nim
• ex_pixfmt16.nim
• ex_polymorphic_renderer.nim
• ex_poly_bool.nim
• ex_pure_api.nim
• ex_rasterizers.nim
• ex_rasterizers2.nim
• ex_rasterizer_compound.nim
• ex_raster_text.nim
• ex_rounded_rect.nim
• ex_scanline_boolean.nim
• ex_scanline_boolean2.nim
• ex_simple_blur.nim
• ex_svg_circle.nim
• ex_svg_test.nim
• ex_test_poly_bool.nim
• ex_trans_curve1.nim
• ex_trans_curve2.nim
• ex_trans_polar.nim
• ex_truetype_test.nim

implement missing example

• greadients
• polybool animation
• many curves demo

weird bezier_arc

completely bizarre arc of PathStorage::arcTo

recursive blur problem

ex_recursive_blur does'nt produce correct result

reimplement vertex block storage in path_storage

yes, it should be reimplemented

nimble file should probably not use @#head

See c-blake/hldiff#1 (comment) and subsequent.

Seems you wanted some May 2017 version of sdl2_nim. The git hash you probably want is something like 213ee80f8fc4ec2d4dfedd02ee091dbfd336983f

init ... aux removal

init ... aux need to be removed after Nim's bug 5540 fixed

• renderer markers
• line image pattern
• LineImagePatternPow2
• LineInterpolatorImageAux
• renderer primitives
• renderer raster h text solid
• renderer raster v text solid
• renderer scanline aa solid
• span gradient image
• span image filter gray
• span image filter rgb
• span image filter rgba
• font cache manager

scanline boolean2 bug

ex_scanline_boolean2
settings:
scanline_p
AND / OR

implement additional feature

• clipper
• conv clipper
• clipper test
• pure api
• svg viewer
• nimAGG logo

implement platform support

• base platform support
• win32 bmp
• win32 platform support
• null platform support
• sdl platform support
• x11 platform support
• mac platform support
• mac pmap

true type test bug

look like the cache mechanism has problem

rasterizer compound width

• width ctrl adjusted crash
• sort order adaptor

platform sdl bizarre

• improve performance
• fix missing startup view
• fix transformation

perspective bug

• image perspective
• pattern perspective
• gradient contour -> auto contour

lion outline crash

renderer outline crash

gradient contour bug

• both contour
• and auto contour show unwanted artefact
• rotate 90 degree went invisible

true type kerning

type kerning not works

example from AGGPAS

• gradient contour
• particle demo