/infinite_source

Primary LanguageJulia

Infinite source

This repository holds some runnable code for use with Luxor.jl.

It explores a scriping style workflow for making developing sketches as opposed to pixel art. The idea is to work in a 2d 'model space' (in CAD terms) and output figures in 'paper space', with annotations and the like.

We don't know quite what to do with this, but it seems useful. It is perhaps contra-productive to keep the terminology consistent with Luxor.

LuxorLayout.jl

This file contains a module with the additional functionality that is 'strictly needed'. It might belong as a submodule in Luxor, or another package. Or act as a source for PRs to Luxor.

Interfaces

Public interface

  1. Margins and limiting width or height

    • margins_get
    • margins_set

  2. Inkextent

    • encompass
    • inkextent_user_with_margin
    • inkextent_reset
    • inkextent_user_get
    • point_device_get
    • point_user_get

  3. Overlay file

    Internal only

  4. Snap -> png and svg sequential files -> png in memory uses a second threadto add overlays.

    • snap
    • countimage_setvalue

  5. Utilities for user and debugging

    • mark_inkextent
    • rotation_device_get

All functions, structured

1. Margins and limiting width or height
  margins_get, margins_set, Margins, 
  scale_limiting_get,
  LIMITING_WIDTH[], LIMITING_HEIGHT[]

2. Inkextent
  encompass, inkextent_user_with_margin
  inkextent_reset, inkextent_user_get, 
  inkextent_set, inkextent_device_get, 
  point_device_get, point_user_get

3. Overlay file
  This is normally run in a second
  thread with a separate Cairo 
  instance.

  byte_description, overlay_file,
  assert_second_thread, assert_file_exists

4. Snap
   -> png and svg sequential files
   -> png in memory
   uses a second threadto add overlays.

  snap, countimage, countimage_setvalue,
  text_on_overlay

5. Utilities for user and debugging

   mark_inkextent, mark_cs, 
   rotation_device_get

Snowblind - whirl

About the limits for canvas size, what can be rendered as bitmap vs vector graphics, and a 'sprite' drawn in 'paper space' but matching coordinates from 'model space'.

Test_long_svg_paths

We like Santana too much perhaps.

Test_scale

This is mostly about margins in paper space.

Test snap

Testing the transformations between paper space and model space.

To download and test on your own

cd cd ~/.julia/environments/
git clone https://github.com/hustf/infinite_source
cd ininite source

You may want to delete `Manifest.toml' and 'Project.toml' before starting Julia. You don't need 'LightXML', 'EzXML', 'HTTP', 'Pango_jll', 'Revise', 'InlineStrings', 'Cairo', 'BenchmarkTools' to run these files.

Install what's asked for when running the files: Luxor, QuadGK, ThreadPools.

julia --project=. --threads=auto
# Windows only requirement:
julia> Pkg.pin(name = "Pango_jll", version = "v1.42.4")