Difference between revisions of "ImprovingPythonEffectsAPI"
|Line 1:||Line 1:|
Latest revision as of 15:21, 11 January 2007
* Although this proposal has not been accepted amongst the Summer of Code applicants, my efforts in home-brew graphics scripting continue, and may one day see the light of day *
I was particularly interested in creating mandala-like patterns with my code, so I needed an easy way to convert polar co-ordinates to cartesian ones. I looked for a simple 2D geometry library in python but found nothing which suited the task, so I created one for the purpose of representing points as objects that could be manipulated by different algorithms and formulas.
Over the last year my imagination has discovered a richness of geometric/design problems to solve. In my proposal, I have listed a number of features/algorithms that I have already implemented in my stand-alone SVG applications. I have marked these with a "*#*".
I have added some screen shots of the SVG IMAGENERATION on my new Flickr account (silly to rasterize SVG, but I haven't found good SVG gallery service/software, hope openclipart.org get ccHost working soon). Keep in mind that this gallery is only the tip of the iceberg when it comes to the functionality of the libraries.
My goals in working on the python extensions would be to improve the Python plugin API
Mathematical libraries for plotting points
- Cartesian and Polar points with conversion to and from each other. Operations such as addition, subtraction, dot product, scalar multiplication *#*
- Midpoint of two points *#*
- Point at a fraction of a distance from point A to point B *#*
- pointsBetween - given A and B, returns n equidistant points along the line *#*
- extendBend - given two points A and B, a distance and an angle, returns a point C which results from extending distance out from AB and then bending BC about B by the given angle *#*
- reflection - given a line AB and point C, returns the reflection of C in AB #*
Functions for manipulating paths
- abstractions for each path command and random access to the list of commands (so you can look backward and see what point the inspected command is starting from) *#*
- path distance calculation *#*
- convert a quadradic bezier into a cubic bezier *#* figured out this one purely by experimentation
- each Command object (i.e. one of class CubicBezierCommand) stores control points and nodes as Point objects *#*
- return an array of references to all Points in the path (which could then be operated on by some function or other operation) *#*
- create a closed symetrical path out of an open path that is one side of the shape by appending it's mirror (along the start-end line) to itself
- develop new ways of constructing and representing bezier curves relative to their start and end points i.e. where the control points are represented as a vector relative to the base line of the curve *#*
- functions to return points a certain distance along a path, or a certain percentage of the distance of the path
- functions to do complex path slicing/merging where the number of commands is increasing or decreasing
- obtain a point a certain distance along a path
- add texture to curves
- similar to Kochify but that only applies 1 copy in between nodes wheras this would apply a pattern many times along one line or bezier command
- an example application: given a leaf outline, give a jagged texture of it
Each AutoShape would generate a different figures given particular parameters from a GUI (like the star tool, but not being objects in Inkscape). Unlike AutoShapes in most drawing programs, which can only be scaled, many parameters of these AutoShapes could be configured (like the Lindenmayer). To implement some of these, I might need to improve how the GUI interfaces with the effects (i.e. to collect a list of numbers of varying size as in unit subdivision).
- circle unit subdivision algorithm (see an example here) *#*
- Cartesian and Poler graph with unit subdivision
- Ruler dashes with unit subdivision
- "star polygon" creation (only "proper" poygon stars) (see this page: http://mathworld.wolfram.com/StarPolygon.html on Stars Polygons) *#*
- hexagon grid *#*
- flower-like radial shapes *#* done some, but there's many possibilities
- series of circles forming a Cartoid *#*
- generation of phi spiral and phi spiral lattice (think dreamcatcher pattern) *#* (but after much contemplation/experimentation I haven't figured out how to get my spiral curves smoother)
- zig zag and loop-de-loop line generation *#*
Selling Self and Proposal
I'm a fourth year Computer Science student at Carleton University. I've yet to have a paid job as a programmer, but I've done a bunch technology-related volunteering and a lot of self-education to suppliment my university education. I believe I'm an excellent candidate for this position because I:
- use Inkscape regularly and am familiar with all its features
- have the (electronic) book Learn SVG as a reference
- have a bunch of code already written which could be applied to the project
- will pour a lot of my energies into this project during the summer, during which I do not have other labour commitments
- enjoy writing and will provide good documentation for both developers and end users
- will continue to improve Inkscape beyond the term of my work
- am aligned with the values of the Free Software movement and its offshoots like Creative Commons and Free Culture community (this year I started organizing Free Culture Carleton)
My proposal will be a significant improvement to Inkscape because:
- effects are a strong driving force between many different media applications (i.e. raster graphics, audio, video, 3D) and extend the capabilities of them greatly
- there are many unimplimented effects that could be easily developed, as there's a lot of publications about computer graphics geometry describing the theoretical process
- despite this, there has not been a strong community of development around effects in Inkscape
- improving the ease of development and documentation around effects will encourage developers to create new effects
- python is an extremely accessible language that proves itself ideal for effects scripting (i.e. Blender scripting)
- improving python effects libraries would expand functionality of Inkscape without introducing any bugs to the core C++ code
- improving python effects may offer ideas/sketches to improve path data structures internally
This timeline has been written with a estimation-time-doubling heuristic in mind:
- 2 weeks - make all design decisions, working with mentor to prevent overlap and ensure proper integration. Questions to answer:
- What is the full list of features to be implemented over the summer ? What is the priority of each feature ?
- How will Python access a DOM ? Should the DOM be abstracted into a Document object that is passed/instantiated in each effect ?
- Will the project incorporate live scripting from a command line ? If so, how can the archetecture be designed to meet those needs ?
- Should external geometry functions be used, or should all geometric operations be natively implemented?
- Should the .inx specification remain the same ?
- How will changes to the API affect existing effects ?
- 2 weeks - make existing code that will be encorporated into the API more robust by using PyUnit test cases for QA and improve documentation, possibly using Doxygen for documentation generation
- 2 weeks - integrate existing libraries into the Inkscape API
- 4 weeks - develop effects using the API
- 2 weeks - play with the API ! Write example scripts to generate art to be posted to various web sites (i.e. openclipart.org, deviantart), w/ advertisements for the new Inkscape features attached to them.
Any feedback on this proposal would be greatly appreciated